TopBit.io

Skip to main content

Whitepaper

Technical and economic specification for TopBit.io, a fully on-chain GambleFi protocol on Solana.

v1.0.0|2026

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.

RISK DISCLOSURE

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.

TierTLP-SOLTLP-USDCLP ShareCooldown
Elite< 5 SOL< $50065%14 days
Premier5–25 SOL$500–$2.5k70%10 days
Executive25–100 SOL$2.5k–$10k75%7 days
Director100–500 SOL$10k–$50k80%5 days
Whale> 500 SOL> $50k85%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.

VRF SETTLEMENT TIMELINE
T+0sStake locked in PDA, VRF request submitted
T+1–3sOracle responds, proof verified on-chain, funds settled
T+10sNo response, silent auto-retry fires
T+90sRefund available, full stake returned, player pays gas

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.

WATERFALL SWEEP (PER $100K NET GAMING REVENUE)
1. Net gaming revenue$100,000.00
2. Development fee (2.5%) → ops wallet−$2,500.00
3. Distributable$97,500.00
4. Whale LP share (85%)+$82,875.00
5. Protocol Share (15%) → waterfall$14,625.00
↳ Staking yield (60%)$8,775.00
↳ Vault compound (30%)$4,387.50
↳ Reserve (10%)$1,462.50

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 RequiredEarning Weight
Micro50,0005%
Bronze250,00015%
Silver750,00030%
Gold2,500,00050%
Platinum7,500,00075%
Diamond15,000,00090%
Sovereign20,000,000100% + 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.

STAKING PAYOUT EXAMPLE — GOLD TIER
Weekly yield pool$8,775.00
Total $TOP staked (protocol)50,000,000
This staker — Gold, 2,500,000 $TOP
↳ Earning weight (50%)1,250,000
↳ Total protocol weight6,250,000
↳ Share (1,250,000 / 6,250,000)20%
Weekly reward+$1,755.00
↳ Liquid SOL / USDC (70%)$1,228.50
↳ $eTOP vesting 180 days (30%)$526.50

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.

Phase 0
Token Launch
Pump.fun launch, 13 demo games, Founding Banker pre-commits
Phase 1
Mainnet Deploy
Contracts deployed, Founding Banker vault opens, games go live
Phase 2
Bootstrap
First 90 days live. Any deposit size earns a flat 75% LP return, except Founding Bankers who earn 85%. Protocol share split: 20% staking yield / 70% vault compound / 10% reserve.
Phase 3
Staking Yield
Staking opens, first weekly yield distributes
Phase 4
Growth
Bootstrap ends, LP rates revert to tier-based (65–85%). Protocol share split: 20% staking yield / 70% vault compound / 10% reserve.
Phase 5
Expansion
Apply for gaming license, open partner game integrations — third-party studios can plug into TopBit vaults.