WIKI & FAQ
How the scratch economy works, top to bottom. Quests, tiers, prestige, jackpot, on-chain redemption — all the rules in one place.
The $SCRATCH economy
$SCRATCH is the in-game points unit. You earn it by scratching winning tickets, claiming daily rewards, completing quests, and from referrals. It converts to the on-chain $SCRATCH SPL token at a fixed rate of 10,000 points = 1 $SCRATCH token.
Every pack and grid purchase splits the cost across three pools:
- Treasury — funds prize payouts and ongoing operations.
- Jackpot — feeds the rolling jackpot pool that big-win tickets pay from.
- Burn — removed from circulation, making the token deflationary.
Playing tickets, packs, and grids
Each ticket is a scratch grid. Match symbols to win — bigger symbol, bigger payout. Three knobs control the stake and shape of the bet:
- Tier (Basic → VIP, 1× to 22× multiplier) — higher tier = bigger cost & bigger swings.
- Grid size (3×3 to 5×5, up to 3.6× payout multiplier) — more cells per ticket.
- Pack size (1 to 10 tickets) — buy in bulk, scratch back-to-back, build combos.
Boosts modify outcomes: Lucky biases the symbol roll, ×2 applies a 1.25× post-win bonus,Jackpot forces a top-tier symbol roll, Refund returns ticket cost on a loss.
Shop & perks — combined pricing
Every perk in the shop costs both in-game points AND on-chain $SCRATCH tokens — you can't buy with just one side. The token portion is always half the points price, so the combined cost scales together.
- Lucky (10 charges) — 100,000 pts + 50,000 $SCRATCH
- Golden Foil (10 charges) — 150,000 pts + 75,000 $SCRATCH
- Magnet (8 charges) — 175,000 pts + 87,500 $SCRATCH
- ×2 Boost (5 charges) — 200,000 pts + 100,000 $SCRATCH
- Autoscratch (5 charges) — 250,000 pts + 125,000 $SCRATCH
- Refund (5 charges) — 300,000 pts + 150,000 $SCRATCH
- XP 2× (15 charges) — 350,000 pts + 175,000 $SCRATCH
- Combo Rush (5 charges) — 400,000 pts + 200,000 $SCRATCH
- Scratch Pack (5 consumable) — 500,000 pts + 250,000 $SCRATCH
- Prestige Boost (1 consumable) — 650,000 pts + 325,000 $SCRATCH
- Jackpot Ticket (1 consumable) — 1,000,000 pts + 500,000 $SCRATCH
- VIP unlock — 1,750,000 pts + 875,000 $SCRATCH
- Luxe unlock — 2,500,000 pts + 1,250,000 $SCRATCH
- Vault unlock — 3,000,000 pts + 1,500,000 $SCRATCH (reduces points-burn rate)
Where the $SCRATCH goes. Each on-chain transfer is split across three wallets in a single transaction: treasury (operations), jackpot (feeds the pool), and burn (permanently removed). The split ratios come from server-side odds config and are visible per-purchase on the audit log.
The server validates every purchase: it pulls the on-chain tx by signature, sums the treasury/jackpot/burn deltas against the catalog price, debits the points portion authoritatively, and only then grants the perk. Underpaid or mis-routed transfers are rejected — points are not debited on a failed validation.
Tiers, levels, and prestige
Three independent progression tracks run side-by-side:
- Player tier (Bronze → VIP Holo) — based on lifetime tickets played and total winnings. Each tier adds a permanent payout bonus (up to +30%).
- Level (1 → 50) — earned via XP from every play. XP is a slow grind by design — every level matters.
- Prestige (0 → 20) — hit level 50 to prestige. Resets level, but adds +4% permanent payout per rank. Stacks forever.
Final payout formula (in order): base × tier × grid × playerTier × x2 × fireBonus → sum → × prestige.
Daily quests & achievements
Every UTC day you get 3 randomized quests from the rotation — play X tickets, win Y total, land a Z-coin single hit, hit a streak, etc. Snapshot is taken at the first time you open quests that day; progress accrues from then on. Hit the target → click CLAIM to deposit the reward straight into your balance.
Achievements are permanent. They unlock automatically when you cross lifetime thresholds — first scratch, biggest jackpot, longest streak, daily streak, total winnings. Visit your profile to see the catalog.
Leaderboards
Five live boards on the leaderboard:
- All-Time Winnings — total $SCRATCH won, lifetime.
- This Week — winnings this calendar week. Resets weekly.
- Biggest Jackpot — largest single-ticket payout you've landed.
- Top Scratchers — most tickets played.
- Longest Streak — most consecutive winning lanes.
- Top Level — highest level/prestige (grinder respect).
Boards refresh live. Banned accounts are filtered out automatically.
Wallet Connect — deposits, purchases, redeems
The on-chain wallet card on your profile is non-custodial. You connect Phantom or Solflare with one click; we never hold your keys or seed phrase. Every on-chain action is signed by you and verified server-side against Solana mainnet before any in-game state changes.
Three flows use Wallet Connect:
- Deposit $SCRATCH → in-game points. You sign an SPL transfer of $SCRATCH to the treasury wallet. The server pulls the transaction by signature, confirms the mint matches and the treasury balance increased, then credits points at
10,000 pts = 1 $SCRATCH. Idempotent by signature — refreshing won't double-credit. - Shop purchases (perks & boosts) in $SCRATCH. Each perk has a fixed token price. You sign the transfer; the server verifies the signature, matches the deposited amount to the perk's expected price, and grants the boost charges or permanent unlock. Deduped by tx signature in
chain_perk_purchasesso a retry is safe. - Redeem / withdraw points → $SCRATCH on chain. You debit in-game points and queue a withdrawal request to your wallet. An admin reviews each request and sends the payout on chain. Status updates live on your On-chain history panel with the tx hash and a Solscan link.
Costs you should know: Solana network fees (~0.000005 SOL/tx) are paid by you, the signer. If the treasury's $SCRATCH token account doesn't exist yet, the first depositor pays ~0.002 SOL of rent to create it. Withdrawals are free to request — the treasury pays the network fee when sending.
Transaction status tracker
Every on-chain action shows up in the On-chain history panel on your profile, with a color-coded status pill, the amount, and a Solscan link once a tx hash exists. The four phases:
- Pending (gold, spinner) — your request is queued. Withdrawals & redeems sit here until an admin approves them.
- Confirmed (cyan) — admin approved; the treasury is preparing to send on-chain.
- Completed (neon green) — fully settled on-chain. Deposits and shop purchases jump straight here after the server verifies the signature.
- Failed / Cancelled (red) — the action was rejected or cancelled. Points are automatically refunded to your in-game balance.
Filter the panel by tab — Purchase, Deposit, Withdrawal, or Redeem — and tap any row's tx hash to inspect it on Solscan.
Purchase history & audit log
Every shop purchase is recorded immutably with the exact split. Visit the audit log to see your per-perk receipts: points spent, total $SCRATCH burned, and the breakdown into treasury / jackpot / burn wallets — each with a Solscan link to the on-chain transfer.
- Player history — your own purchases on the /history page and on your profile's purchase panel.
- Admin audit — admins see every purchase attempt across all players, including server validation results (accepted, underpaid, mis-routed) and the exact split per tx.
This makes the economy transparent — anyone can verify that the $SCRATCH you spent actually reached the jackpot and burn wallets in the ratios the odds config promises.
Live player counter
The header shows how many players are online right now, powered by a live presence channel. Each session is assigned a deterministic funny nickname (think "Funky Penguin" or "Sneaky Waffle") derived from your account so you keep the same alias across visits without revealing your real handle.
Fairness & anti-abuse
All payouts are server-validated against the canonical payout formula — the client can't lie about wins. Ticket history, achievements, and quest claims are recorded in the database with audit logs.
- Account age, lifetime caps and daily caps apply to redemptions.
- Only verified net-winnings are eligible for token redemption.
- Withdrawals require manual admin approval; suspicious activity is paused.