Smoke Cartel Player Documentation

Back to Home

How the game works, step by step

This guide explains the real in-game flow used in Smoke Cartel today. Start here if you want to understand what to do first, where rewards come from, and why your balances, caps, and wallet session behave the way they do.

Quick Start

  1. Connect your wallet and sign the login message.
  2. Choose your starting vice during onboarding.
  3. Activate trial or buy additional devices (0.2 SOL).
  4. Upgrade devices with $SMOKE to increase daily output.
  5. Track caps, earn, then deposit or withdraw via vault.

Key Rules At A Glance

  • 3 device types: cigarette, cigar, vape.
  • Max devices owned per player: 3.
  • Level range: 0 to 10.
  • Reward split: 70% passive / 30% active.
  • Manual reward rate: 100 units per puff action.

Topic 1

Core game loop

Progress in Smoke Cartel comes from device power and smart balance decisions. You use wallet-authenticated identity to build devices, generate rewards, and cycle earnings back into growth or withdrawals.

Every player starts with one onboarding device (trial level), then expands into the full three-device setup. As levels go up, reward capacity goes up, and your available active and passive caps grow with it.

The highest-leverage behavior is usually consistent progression: activate devices, avoid idle caps, and upgrade when the output increase justifies the cost.

Topic 2

Wallet login and account identity

Your wallet is your account identity. Protected actions only work when wallet connection and signed session are both valid.

Login requires two steps: connect wallet, then sign the authentication message. After this, the app can read and mutate your player state through authenticated backend endpoints.

Wallet identity is strictly enforced. If you switch wallets after login, the current session is invalidated and you need to sign in again with the active wallet.

  • Connect wallet
  • Sign message
  • Complete onboarding
  • Re-authenticate after wallet switch

Security model: wallet session mismatch automatically logs out the session to prevent state access under the wrong identity.

Topic 3

Devices, ownership rules, and levels

There are exactly three device types: cigarette, cigar, and vape. You can own all three, with a hard maximum of 3 owned devices.

On first login, you select one vice and receive that device as an owned trial at Level 0. The two other device types can be purchased later and start activated at Level 1.

The trial device can be activated from Level 0 to Level 1. Activated devices can be upgraded up to Level 10.

  • Trial onboarding device: Level 0
  • Purchase price for additional device: 0.2 SOL
  • Trial activation price (L0 to L1): 0.2 SOL
  • Maximum level: 10

Topic 4

Economy model and upgrade costs

Upgrade economics are intentionally easy to reason about. For token upgrades, the cost to reach a level equals that target level's daily reward output.

Level 0 trial earns 1,000 $SMOKE/day. Activated Level 1 starts at 200,000 $SMOKE/day. Higher levels add fixed increments based on the economy table.

Because upgrade cost equals one day of target output, your decision is about expected play horizon and how quickly you can make use of increased caps.

  • L2: 250,000/day, cost 250,000
  • L3: 350,000/day, cost 350,000
  • L4: 450,000/day, cost 450,000
  • L5: 650,000/day, cost 650,000
  • L6: 850,000/day, cost 850,000
  • L7: 1,050,000/day, cost 1,050,000
  • L8: 1,350,000/day, cost 1,350,000
  • L9: 1,650,000/day, cost 1,650,000
  • L10: 2,150,000/day, cost 2,150,000

Topic 5

Rewards split, windows, and caps

Your total daily production is split into two controlled buckets: passive (70%) and active (30%). Hourly caps are derived from these daily caps.

Passive rewards accrue over time in the background. Active rewards are earned through gameplay/manual interactions and are constrained by both hourly and daily active limits.

Manual reward rate is currently 100 units per puff action, but granted value is clipped by remaining hourly and daily active room.

  • Passive split: 70%
  • Active split: 30%
  • Hourly cap = floor(daily cap / 24)
  • Manual actions cannot exceed remaining active windows

Topic 6

How to read the earnings dashboard

The earnings route is your operational control center. It shows balances, reward windows, device states, and all major actions in one place.

Earnings Balance is your off-chain reward balance. Total Withdrawable combines off-chain earnings with on-chain vault deposit balance.

The dashboard refreshes state periodically and also supports manual refresh. Purchase and activation actions require a valid SOL transfer signature where applicable.

  • Player earnings balance
  • Today earned (active + passive)
  • Hourly and daily caps
  • Device actions: buy, activate, upgrade
  • Vault actions: deposit, withdraw
  • Referral and leaderboard panels

Topic 7

Vault actions and withdrawals

Smoke Cartel includes a vault flow for token deposits and withdrawals with both on-chain and backend synchronization steps.

For deposits, you build and send a vault deposit transaction from your connected wallet, then confirm it on-chain.

For withdrawals, the app first requests a signed withdraw ticket from backend, executes the on-chain withdraw transaction, and finally syncs the result back to backend records.

If wallet is connected but app login has expired, you must sign message again before vault actions can complete.

Topic 8

Referrals and leaderboard

Beyond raw earnings, Smoke Cartel has social progression layers: referral codes and leaderboard standings.

Players can generate their own referral code, bind an incoming code, and track bound state in the dashboard.

Leaderboard views are pulled from backend snapshots and include daily ranking plus all-time ranking context.

Topic 9

Why backend authority matters

Client UI is intentionally not the final authority for economy state. State-changing actions are validated and applied server-side.

This model protects reward accounting and progression integrity. The frontend is a control surface, while backend responses define canonical state for devices, caps, windows, and balances.

For players, this means better consistency: what you see after refresh is the same state enforced by authenticated backend rules.