Whitepaper
Technical and economic specification for TopBit.io, a fully on-chain GambleFi protocol on Solana.
1. Overview
TopBit.io is a community-first casino built on Solana. Starting with thirteen games (9 Originals and 4 Table Games) that settle in under a second using Switchboard VRF (TEE-backed oracles). Neither the house nor the player can tamper with outcomes. Every result is verifiable on Solscan, permanently. Originals run at a flat 1% house edge with no exceptions.
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. All games share the same vault infrastructure, VRF pipeline, and fund accounting system.
2. $TLP Vaults
The bankroll lives in two independent vaults: TLP-SOL and TLP-USDC. Each issues its own $TLP token representing a proportional vault share. The price is simple: $TLP = Vault Balance / TLP Supply. No oracle, no $TOP price dependency, no cross-vault exposure. SOL bets go to TLP-SOL, USDC bets go to TLP-USDC. Either vault can operate independently if the other shuts down.
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) who pay 15% for the first 90 days from vault deploy. Stake and payout are capped separately: Max Bet is 10% of vault balance at bet placement (rejected on chain if exceeded), and Max Win is 25% of the same vault snapshot, applied at settlement so a winning bet is paid up to that ceiling and never beyond. Both ceilings are in the bytecode and governance cannot override them.
Cooldowns run from 3 days (Whale) to 14 days (Elite). 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. If 30 consecutive days pass with zero bets, all cooldowns are automatically waived for everyone. No admin can block it.
TLP holders bear the full downside of vault losses. There is no minimum guaranteed withdrawal amount. In extreme loss scenarios, vault balances can reach zero.
| Tier | TLP-SOL | TLP-USDC | LP Share | Cooldown |
|---|---|---|---|---|
| Elite | < 5 SOL | < $500 | 65% | 14 days |
| Premier | 5–25 SOL | $500–$2.5k | 70% | 10 days |
| Executive | 25–100 SOL | $2.5k–$10k | 75% | 7 days |
| Director | 100–500 SOL | $10k–$50k | 80% | 5 days |
| Whale | > 500 SOL | > $50k | 85% | 3 days |
3. Provably Fair
Every 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 game contract lets anyone check any historical bet, free of charge, at any time.
When a bet is placed, the stake locks in a PDA escrow before the VRF request goes out. The oracle typically responds in 1–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 equivalent per wallet per day. No admin can force-settle a pending bet.
4. Fund Accounting
Net gaming revenue (NGR) is player loss after affiliate commissions and VRF fees are deducted. 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, 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 waterfall: $8,775 to staking yield, $4,387.50 to vault compound, $1,462.50 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.
5. $TOP Token
$TOP has a fixed supply of 1,000,000,000 tokens, launched via Pump.fun on Solana. The bonding curve graduates to Raydium at roughly $65,600 market cap. No pre-sales, no VC allocations, no team vesting. The founder publicly buys 10% of supply at launch and announces each wallet and transaction hash before buying.
The only burn is 50% of the Protocol Reserve sent to the dead wallet (11111...). 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.
6. Staking
Staking $TOP earns a pro-rata share of weekly protocol yield proportional to your tier weight. Rewards split 70% liquid SOL and USDC (paid immediately) and 30% as $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. The house edge is flat 1% for all players regardless of tier — stakers earn more through yield weight and rakeback, not a reduced contract edge.
| Tier | $TOP Required | Earning Weight |
|---|---|---|
| Micro | 50,000 | 5% |
| Bronze | 250,000 | 15% |
| Silver | 750,000 | 30% |
| Gold | 2,500,000 | 50% |
| Platinum | 7,500,000 | 75% |
| Diamond | 15,000,000 | 90% |
| Sovereign | 20,000,000 | 100% + royalty |
$eTOP vests linearly over 180 days. Unstaking early burns unvested $eTOP according to a sliding forfeiture schedule: 100% burned if you exit within the first 30 days (day 0–30), dropping to 75%, 50%, and 25% over subsequent 30-day windows, and 0% after day 180. All burns go to the dead wallet (11111...) — 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.
7. Sovereign 21
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, taken from the Staking Yield bucket inside the weekly waterfall and split equally among all filled seats, paid in liquid SOL and USDC.
8. Roadmap
Six phases, each with a clear trigger. Phase 0 starts at the Pump.fun launch: all games run 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 vault, Founding Bankers deposit, and games go 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–85%), and the waterfall runs at normal cadence. Phase 5 is Expansion: the team applies for a gaming license and opens partner game integrations so third-party studios can plug into TopBit vaults.