Whitepaper

topbit.io is a community-first casino built on Solana. The v1 launch opens with a library of partner games from Pragmatic Play, settled non-custodially against an on-chain USDC bankroll. TopBit Originals, our own provably-fair games built on Switchboard VRF at a flat 1% house edge, follow on the roadmap once live. The protocol is USDC-native end to end: every bet, payout, and bankroll balance is denominated in USDC, with a minimum bet of $10.

Two tokens power the protocol. $TOP is the loyalty and yield token. $TLP is your share of the house bankroll. LPs take the downside when players win and collect the upside when the house wins. Stakers earn a weekly cut of protocol revenue. Partner games and the native Originals that follow share the same USDC vault, settlement boundary, and fund accounting system.

The bankroll lives in a single USDC vault. It issues a $TLP token representing a proportional vault share. The price is simple: $TLP = Vault Balance / TLP Supply. No oracle, no $TOP price dependency. Liquidity is added and withdrawn in USDC, and only USDC ever sits in the vault. (The DFlow swap-to-USDC convenience, where you fund with SOL, USDT, or $TOP, is for topping up your gaming balance to play, not for providing liquidity here.)

Five LP tiers determine how much of the house edge you keep versus what flows to protocol. During Bootstrap phase, a flat 25% protocol share applies across all tiers regardless of deposit size, except Founding Bankers (21 seats only, a single $5,000 USDC deposit) who pay 15% for their first 90 days, measured from each banker's own seat-claim timestamp.

Cooldowns run from 3 days (Whale) to 14 days (Elite), counted from when you request a withdrawal. Pull more than 2.5% of the vault in any 7-day window and your own cooldown extends by 7 days, other LPs aren't affected. Cooldowns are waived in one situation only: if the vault enters its RED circuit breaker state (severe drawdown with the insurance fund exhausted) and no admin action is taken within 24 hours. During that window an admin can cancel the waiver or lock the vault while an incident is investigated, so treat the waiver as a safety valve rather than a guaranteed exit.

Provable fairness applies to TopBit Originals, our own games settled with Switchboard VRF. The partner games live at launch are run by the studio that built them. Their outcomes use that studio's independently certified RNG, and TopBit settles each session's net result on-chain in USDC. The VRF mechanics below describe the Originals, which arrive on the roadmap.

Every TopBit Originals bet uses Switchboard VRF running inside TEE hardware, a secure enclave that neither TopBit nor the oracle network can access. The VRF proof is published on-chain with every bet result. A public verify() function on every Originals contract lets anyone check any historical bet, free of charge, at any time.

When an Originals bet is placed, the stake locks in a PDA escrow before the VRF request goes out. The oracle typically responds in 1 to 3 seconds, after which the result is calculated, the proof is verified on-chain, and funds settle in the same transaction. No response within 10 seconds triggers a silent retry. At 90 seconds, the player can call claim_refund() and get their full stake back, the player pays gas, the house edge is zero on refunds. Refunds cap at $1,000 USDC per wallet per day. No admin can force-settle a pending bet.

Several costs come off gross player losses before the waterfall runs. The game provider takes a revenue share off the top: for v1 partner games (Pragmatic Play), that cut is settled directly with the studio. Player promotions (welcome bonuses, cashback, rakeback, and free spins) and affiliate commissions are netted next, so LPs and the protocol share their cost proportionally rather than LPs carrying it alone. VRF oracle fees apply to TopBit Originals only, deducted per bet when those games go live. What remains after these costs is net gaming revenue (NGR).

From NGR, a 2.5% Development fee goes to the ops wallet first. What remains is distributable, split between the LP vault and the Protocol Share waterfall based on the LP tier. Everything settles atomically in a single on-chain transaction using checked arithmetic throughout.

Protocol Share flows through a waterfall that shifts by phase. During Bootstrap (first 90 days), 70% goes to TLP Compound, 20% to Staking Yield, and 10% to Reserve. At Growth phase, that shifts to 60% yield, 30% compound, 10% reserve. The Reserve sub-splits into 50% burn and 50% ops/marketing/prize pool.

Worked example: $100,000 NGR (already net of provider fee, player promotions, affiliate commissions, and VRF fees), Growth phase, Whale LP (85%). Development fee takes $2,500, leaving $97,500 distributable. The Whale LP keeps $82,875 and $14,625 flows into the Protocol Share waterfall. A 5% sovereign royalty comes off the top first ($731.25), leaving $13,893.75: $8,336.25 to staking yield, $4,168.12 to vault compound, $1,389.38 to reserve.

The example above shows Growth phase behavior. During Bootstrap (the first 90 days from casino launch) every LP tier receives a flat 75% LP share regardless of deposit size, except Founding Bankers who keep their 85% rate during the same window. Reserve sub-splits stay consistent across phases.

$TOP has a fixed supply of 1,000,000,000 tokens, launched via Pump.fun on Solana. The founder publicly buys 10% of supply at launch, pre-announcing each wallet and publishing every transaction hash.

The only burn is 50% of the Protocol Reserve. That share is swapped from USDC into $TOP and burned against the $TOP mint, so circulating supply actually decreases and the burn is verifiable on Solscan. The remaining 50% funds ops, marketing, and the prize pool. Protocol benefits cap at 20,000,000 $TOP per wallet (2% of supply), holding more beyond that earns nothing extra in staking weight or voting power.

Staking $TOP earns a pro-rata share of weekly protocol yield proportional to your tier weight. Rewards are paid in USDC. Until the $TOP bonding curve graduates to Raydium, the full weekly reward is liquid USDC, paid immediately. After graduation, the split becomes 70% liquid USDC and 30% routed into $eTOP, a vesting token that unlocks linearly over 180 days. Staking any amount, even the minimum 50,000 $TOP, also applies a 1.5× loyalty multiplier across all bets. You don't need to bet with $TOP, just hold it staked.

Seven tiers determine your earning weight. TopBit Originals carry a flat 1% house edge for all players regardless of tier. Stakers earn more through yield weight and rakeback, not a reduced contract edge.

$eTOP vests linearly over 180 days. Unstaking early burns unvested $eTOP on a sliding forfeiture schedule: 100% is burned in the first 30 days (days 0 to 30), then 75% (days 31 to 60), 50% (days 61 to 90), and 25% (days 91 to 179), reaching 0% from day 180 onward. All burns go to the dead wallet (11111...), and no admin can recover them. The exact forfeiture amount is shown before you confirm.

Example using the fund accounting waterfall above: $100,000 NGR in Growth phase produces $8,775 in the weekly staking yield pool. The table below shows how a Gold staker earns from that pool.

Sovereign 21 is exactly 21 seats, hardcoded in the bytecode, no admin can add more. Each seat requires staking 20,000,000 $TOP (2% of total supply). If all 21 seats fill, 420,000,000 $TOP (42% of supply) is locked. The extra benefit aside from highest staking weight: a 5% royalty of Protocol Share, carved off the top before the weekly waterfall sub-splits and divided equally among all filled seats, paid in liquid USDC.

Six phases, each with a clear trigger. Phase 0 starts at the Pump.fun launch: the casino runs in demo mode with no real money at risk. The goal is graduating the bonding curve through community momentum. Founding Bankers commit here, pre-announcing their wallet before the vault opens.

Phase 1 triggers at graduation. Contracts deploy to mainnet paused by default, the founder seeds the USDC vault, Founding Bankers deposit, and the partner game library goes live. Phase 2 is the Bootstrap window, the first 90 days live. All LP deposits earn a flat 75% return regardless of size, except Founding Bankers who earn 85%. The protocol share splits 20% staking yield / 70% vault compound / 10% reserve.

Phase 3 opens staking and the first weekly yield distributes. Phase 4 is Growth: Bootstrap ends, LP rates revert to tier-based (65% to 85%), and the waterfall runs at normal cadence. Phase 5 is Expansion: the team applies for a gaming license and rolls out TopBit Originals, the provably-fair VRF games at a flat 1% edge.