Return to Home
Raceverse
Raceverse Technical Specificationv1.0.5
Protocol Whitepaper & Architectural Specification

Raceverse: Sovereign Racehorse Fractionalization & Automated Wagering Engine

Authors: Core Protocol Engineering•Updated: September 2026•Status: Formal Standard
Section 01

Project Overview & Background

Real casino operations combined with Web3 racehorse vaults and certified provably fair mechanics.

Problems with Traditional Racing & Current Games

Owning a real racehorse is too expensive for most people. Buying a horse, paying trainers, and stable fees cost tens of thousands of dollars, so only wealthy groups can participate. Prize money takes months to clear through banks and racing clubs. At the same time, most online horse racing games run on private servers where players don't actually own their horses and outcomes can't be verified.

  • High Cost to Enter: Buying a fractional share of a real horse usually requires at least $10,000 and special investor checks.
  • Slow Payouts: It takes weeks or months to get your share of purse money through normal banking channels.
  • No Real Ownership in Web2: Online virtual horse games run behind closed doors without certified fairness or portable digital items.

What Raceverse Does Differently

We have spent over 20 years running real physical casinos, sportsbooks, and betting systems. Raceverse brings that real-world experience into Web3 using standard Solana programs and an automated casino API. Certified for provable fairness, Raceverse lets anyone own racehorse NFTs, stake them in gate vaults, and earn dividends directly from platform revenue whenever their horse wins.

  • Real Casino Background: Built by casino operators with more than 20 years in regulated gaming and sportsbooks.
  • Certified Fairness: Evaluated under industry interactive gaming and wagering fairness standards (GLI-19/33).
  • Equal Start for Everyone: All minted NFTs start at Level 1 with the exact same 1.0x baseline weight across all 12 gates.
Section 02

Genesis Blind Drop & Starting Gate Earning Traits

Fixed price mint at 0.35 SOL. Server-enforced blind drop across 12 starting gates (8.33% probability each). All NFTs are equal 1.0x Genesis shares, with the assigned gate serving as the earning trait for race dividends. 8,892 max supply hard cap.

Blind Drop Mechanics & Verifiable Gate Odds

Genesis minting operates strictly through a non-selectable blind drop mechanism. Users cannot pick or buy specific gates directly; each mint roll is probabilistically executed on-chain across 12 starting gates with equal 8.33% (1 in 12) odds. All NFTs are equal 1.0x fractional syndicate shares. The Genesis collection is strictly hard-capped at 8,892 Thoroughbred NFTs (741 per gate).

  • Single Fixed Price: 0.35 SOL per Thoroughbred mint.
  • Uniform Syndicate Share: Every Thoroughbred NFT holds identical 1.0x dividend weight. Zero artificial tier inflation.
  • Starting Gate Earning Trait: The blind roll assigns your runner to 1 of 12 starting gates. When your gate runner crosses the finish line in 1st place, your NFT earns from the Net GGR dividend pool.
  • Verifiable 1/12 Draw Probability: Each of the 12 starting gates has an exact 8.33% (1 in 12) draw chance.
  • 8,892 Hard Cap: 741 Thoroughbred NFTs per starting gate. Once 8,892 are minted, no additional tokens can ever be created.
Mathematical Specification
P(\text{Gate}_k) = \frac{1}{12} \approx 8.33\% \quad \forall k \in [1, 12], \quad W_i = 1.0

Gate-Based Parimutuel Dividend Distribution

When a race round settles, 8.0% Platform Take is retained from turnover (92.0% player RTP). From the Platform Take, 20.0% ($1.60 per $100 wagered) is routed directly into the Staker Reward Pool for active stakers holding NFTs assigned to the winning gate. The remaining 80.0% ($6.40 per $100 wagered) funds platform operations, liquidity, and $HORSE market buybacks. Bettor rewards (such as the 4-Hour Golden Lotto) are funded independently from platform reserves. In addition, 30% of $HORSE burned during same-number Tier upgrades is permanently recycled into staker rewards as a separate deflationary sink.

Mathematical Specification
D_{\text{per-share}} = \frac{0.20 \times \text{PlatformTake}}{\sum_{\text{staked}} W_{\text{winningGate}}}

P2P Marketplace & Platform Revenue Inflows

Raceverse includes a secondary marketplace (/marketplace) where owners can buy and sell verified Thoroughbred NFTs directly with other players. All primary mint proceeds and secondary marketplace royalties support liquidity pools, underwriting bankrolls, and game operations.

  • Primary Mint Inflow: 100% of mint proceeds (0.35 SOL per mint) backs platform liquidity, seeded backup reserves, and staker yield pools.
  • Marketplace Fee (2.5%): On every trade between players, a 2.5% protocol fee is deducted and routed to the treasury.
  • Direct Settlement: The buyer's balance is debited, the seller receives 97.5%, and the Thoroughbred NFT transfers atomically in escrow.
  • Non-Custodial: Assets remain in smart contract escrow throughout the trade cycle.
Mathematical Specification
\text{SellerProceeds} = \text{Price} \times (1 - 0.025), \quad \text{TreasuryInflow} = \text{Price} \times 0.025
Section 03

Same-Horse Burn Mechanism & Upgrade Chamber

Burn duplicate copies of the same horse number + $HORSE tokens to increase your dividend multiplier up to 10.0x.

Strict Same-Number Burn Rule

To level up your horse and earn a bigger share of race winnings, you have to bring 2 identical copies of the same horse number (for example, two #3 horses). You keep one and burn the other permanently. You cannot mix different horse numbers. This keeps the total supply shrinking over time as players level up.

  • Base Runner (Level 1, Bronze): 1.0x Multiplier | 0 Burns | Baseline Mint (0.35 SOL).
  • Pacesetter (Level 2, Silver): 2.5x Multiplier | Burn 1 duplicate NFT of the same horse number + 100 $HORSE.
  • Stakes Victor (Level 3, Gold): 5.0x Multiplier | Burn 1 duplicate NFT of the same horse number + 250 $HORSE.
  • Grand Champion (Level 4, Platinum): 10.0x Multiplier | Burn 1 duplicate NFT of the same horse number + 500 $HORSE.

$HORSE Token Burn & Recycling

The native $HORSE token is used to upgrade horses in the Upgrade Chamber. When tokens are spent on an upgrade: 50% are burned forever, 30% go back into the staking pool, and 20% fund race purses and partner promotions.

Mathematical Specification
\text{Supply}_{\text{circulating}}(t) = \text{Supply}_0 - \sum_{u=1}^U \text{BurnedNFT}_u - \int_0^t \Phi_{\text{horse}}(\tau) \, d\tau

Multi-Operator Liquidity Pooling & Global Turnover Aggregation

Raceverse executes a centralized parimutuel model aggregating wagering volume across all integrated third-party casino operators and direct website bettors into a single pool. Turnover is not fragmented across individual operator books; rather, all bets feed the global parimutuel engine, ensuring massive pool depth and sovereign dividend distributions to Genesis Thoroughbred stakers.

  • Aggregated Turnover: Global wagering turnover T_global sums all direct bettors and K connected partner casinos.
  • Standard 92/8 Parimutuel Cut: 92.0% Player RTP returned to winning tickets; 8.0% Platform Take retained by the protocol.
  • Winning Gate Staker Routing: Exactly 20.0% of Platform Take (1.6% of gross turnover) is routed to the winning runner's staker pool.
  • Sovereign Yield Distribution: Staked Genesis Thoroughbred NFTs on the winning gate share the pool proportionally by tier weight (1.0x to 10.0x).
  • Zero Dilution: Additional casino partners expand aggregate turnover without expanding the 8,892 NFT hard cap.
Mathematical Specification
T_{\text{global}} = T_{\text{direct}} + \sum_{k=1}^K T_{\text{casino}, k}, \quad \text{StakerRewardPool} = 0.20 \times (0.08 \times T_{\text{global}}) = 0.016 \times T_{\text{global}}
Same-Horse Burn & Tier Upgrade Multiplier Schedule
LevelTier NamePool MultiplierSame-Horse Burn Required$HORSE Cost
1Base Runner (Bronze)1.0×None (Genesis Blind Drop: 70% odds)0 $HORSE
2Pacesetter (Silver)2.5×1 Duplicate Same-Gate NFT (or 20% drop)100 $HORSE
3Stakes Victor (Gold)5.0×1 Duplicate Same-Gate NFT (or 8% drop)250 $HORSE
4Grand Champion (Diamond)10.0×1 Duplicate Same-Gate NFT (or 2% drop)500 $HORSE
Section 04

Casino Gateway Protocol Integration

Fast API callbacks for betting deductions, win settlements, and double-spend protection.

API Callbacks & Request Tracking

Raceverse connects to the Royal Horse game engine using direct API callbacks. Every bet (/v1/api/send-betting) and win credit (/v1/api/send-result) has a unique transaction ID. If network lag causes a request to repeat, the server checks the ID in memory first so no player is ever debited twice.

  • POST /check-user: Fast balance check (under 15ms) before the race gates open.
  • POST /send-betting: Safe balance debit with retry protection against double charges.
  • POST /send-result: Fast win payout without delays or stuck balances.

Safe File-Backed Ledger

All account writes use atomic rename swaps on an append-only file journal. This prevents broken writes or negative balances even during heavy betting rounds.

Section 05

Game Mechanics: Platform Cut, Staking & Prize Distribution

Clear 8% platform cut: 15% Net GGR to winning gate stakers, 5% to 4-hour bettor lottery, 80% covers operations and buybacks. 92% returns to winning bettors.

8% Platform Cut & 20% Reward Waterfall

Raceverse uses a simple and clear cut from every race round: 92% of the betting pool is paid out to winning bettors (92% RTP). The platform takes the remaining 8% as its house hold. From this 8% house hold (Net GGR), exactly 20% goes straight into reward pools: 15% to stakers of the winning horse gate and 5% to the 4-Hour Golden Ticket Bettor Lottery Pool. The remaining 80% (6.4% of total pool) covers platform servers, maintenance, and $HORSE buybacks.

  • 8% Platform Cut: The platform keeps 8% from the total betting pool each race.
  • 15% to Winning Gate Stakers: Distributed directly to active stakers on the winning gate.
  • 5% to Bettor Lottery: Accumulated into the 4-Hour Golden Ticket jackpot for players who wager.
  • 80% of Cut to Operations: Pays for platform servers, maintenance, and $HORSE token buybacks.
  • 92% Returned to Bettors: 92% of all wagers are returned to winning bettors.
  • Seeded Backup Reserve: Guarantees baseline rewards per race to winning gate stakers on zero-volume rounds.
Mathematical Specification
\text{RewardPool} = 0.20 \times \text{NetGGR} \quad (15\% \text{ Stakers} + 5\% \text{ Lottery})

Web 2.5 Vault Escrow Staking & 24-Hour Epoch Lockup

Users stake their Thoroughbred NFTs directly into Vault Escrow to qualify for race dividends. Staking is restricted strictly to NFTs. To protect syndicate integrity and prevent flash-staking or front-running race results, staking enters a mandatory 24-hour epoch lockup. Once 24 hours elapse, owners can unstake their NFTs back to their connected wallet at any time.

  • Web 2.5 Vault Escrow: Staking applies strictly to Thoroughbred NFTs (not tokens).
  • 24-Hour Lockup: Enforced server- and contract-side to guarantee stable syndicates and block flash-staking.
  • Gate Alignment: Staked horses only earn when their matching gate number wins 1st place.
  • Effective Weight: Your weight in the vault equals your Tier Multiplier (Level 1: 1.0x, Level 2: 2.5x, Level 3: 5.0x, Level 4: 10.0x) times the number of shares you hold.
Mathematical Specification
W_i = M_i \times S_i \quad \text{where } M_i \in \{1.0, 2.5, 5.0, 10.0\}, \quad \text{Lock} \ge 24\text{h}

How Dividends Work: Proportional Share of the Pool

When a horse finishes 1st, the winning prize pool for that round is split among all active stakers of that horse. Your payout depends directly on what percentage of the winning gate's total weight you hold.

  • Proportional Split: Your payout is calculated by your share of the total active weight on the winning gate.
  • Higher Multiplier Means Bigger Cut: A Level 4 Grand Champion has a 10.0x multiplier, earning 10 times more per share than a Level 1 Base Runner.
  • Automatic Accounting: Winnings are calculated as soon as the race results are confirmed.
Mathematical Specification
D_i = \left( \frac{M_i \cdot S_i}{\sum_{k \in \text{Stakers}(W)} (M_k \cdot S_k)} \right) \times \text{WinningGatePool}

How Claiming Works: Cryptographic Claim Vouchers

Your race dividends accumulate automatically in your account without paying gas fees after every race. When you are ready to withdraw, the platform creates an Ed25519 cryptographic voucher, and you can claim your total balance directly to your wallet in a single transaction.

  • Save on Gas: Winnings collect across hundreds of races and can be cashed out all at once.
  • Cryptographic Proof: Signed by the platform oracle so only your wallet address can claim the funds.
  • Direct Payout: Funds transfer directly into your connected wallet in liquid currency.
Complete Game Mechanics Workflow (End-to-End)
8% Platform Cut • 15% Stakers / 5% Lotto
1Blind Drop Mint ($68.80 USD / 0.0374 ETH)

Blind drop gacha minting at fixed price ($68.80 USD / 0.0374 ETH or 50 $HORSE). 1/12 uniform starting gate draw with equal 8.33% odds across 12 gates.

2Upgrade Chamber

Burn 1 duplicate NFT of the exact same gate number + $HORSE to evolve tier multipliers: Silver (2.5x, 100 $HORSE), Gold (5.0x, 250 $HORSE), Diamond (10.0x, 500 $HORSE).

3Web 2.5 Vault Escrow Staking

Stake NFTs into Vault Escrow corresponding to your gate (Gates #1–#12) with a 24-hour epoch lockup. A 2.0 ETH Seeded Backup Reserve guarantees 0.0005 ETH per race payout to winning stakers on zero bets.

48% Cut & 15% Stakers / 5% Lotto

The platform retains 8% of the race betting pool as its house cut (92% returned to winning bettors). 15% Net GGR routes to winning gate stakers, while 5% Net GGR funds the 4-Hour Golden Ticket Bettor Lottery.

5Proportional Distribution

The winning horse prize pool is divided among all stakers of that winning runner strictly proportional to their percentage share of the winning gate's total staked weight.

6EIP-191 Voucher Claims

Dividends accumulate off-chain without per-race gas fees. Withdraw anytime by generating an oracle-signed EIP-191 voucher and settling on-chain in a single consolidated transaction.

Mathematical Worked Example: $10,000 Total Race Wagering Pool

Example breakdown assuming Gate #1 wins the race with 3 active stakers holding different tiers:

Metric / ParticipantTier & MultiplierNFT SharesEffective Stake Weight% of Gate PoolPayout USD
Total Round Wagering Pool$10,000.00
Winning Bettor Payouts (92% RTP)$9,200.00
Platform Cut / House Take (8% of Pool)$800.00
Platform Operations, Treasury & Buyback (80% of Cut = 6.4% of Pool)$640.00
Winning Horse NFT Staker Prize Pool (20% of Cut = 1.6% of Pool)$160.00
Staker A (Winning Gate #1)Level 4 (Grand Champion 10.0x)1 NFT10.0 Weight50.0%$80.00
Staker B (Winning Gate #1)Level 2 (Pacesetter 2.5x)2 NFTs5.0 Weight25.0%$40.00
Staker C (Winning Gate #1)Level 1 (Base Runner 1.0x)5 NFTs5.0 Weight25.0%$40.00
Stakers of Non-Winning Gates (#2 through #12)—0.0%$0.00
Section 06

Token Distribution & Stonk Launchpad Architecture

Fixed 1,000,000,000 (1B) $HORSE SPL token supply, zero presale or private rounds, direct fair launch via Stonk (stonkfun.xyz) on Solana, anti-sniper rules, and buybacks from platform revenue.

Token Allocation: Fair Launch on Stonk (stonkfun.xyz)

$HORSE is the platform SPL token with a fixed supply of 1,000,000,000 (1B) launching on Stonk (stonkfun.xyz) on Solana. There is strictly no presale, seed round, or private insider funding. Granular community distribution percentages, staking pool yields, and launchpad liquidity pairing are executed directly via the Stonk fair-launch bonding curve.

  • Fixed Total Supply: 1,000,000,000 (1B) $HORSE SPL tokens (zero inflation, deployed on Solana).
  • Zero Presale: No private seed or strategic rounds. No discounted insider pre-allocations.
  • Stonk (stonkfun.xyz) Fair Launch: 100% public fair launch on Solana bonding curve without private funding.
  • Cap Table Allocations: 100% fair launch bonding curve on Stonk.
  • Platform & Staking Rewards: Long-term emission for race staker yields and participation.
  • Deflationary Upgrade Sinks: 50% burned on tier upgrades, 30% to staking pool, 20% to race purses.

Stonk (stonkfun.xyz) Bonding Curve & Liquidity Bootstrapping

On launch day, initial trading liquidity is bootstrapped via the Stonk (stonkfun.xyz) fair-launch bonding curve on Solana. Zero team tax, zero presale. All bonding curve liquidity automates upon graduating into Raydium DEX pools.

Mathematical Specification
\text{BondingCurve} = \text{Stonk (stonkfun.xyz) Fair Launch on Solana}

Anti-Bot & Anti-Sniper Protection

To protect regular buyers from bot attacks during launch, contracts enforce safety limits: max transaction size of 0.5% of the pool during the first hour, max wallet holding of 1.0% for 24 hours, and block cooldowns between trades from the same address.

  • 0.5% Max Buy Limit: Caps single buy orders during the first hour to prevent automated bot front-running.
  • 1.0% Max Wallet Limit: Stops single wallets from hoarding tokens on day one.
  • Block Cooldown: Prevents same-block sandwich trades.
  • Locked LP: Liquidity cannot be pulled or removed.

Platform Revenue & Token Buybacks

From the platform's 8% cut on every race, 80% is used for running costs, servers, and automated buybacks of $HORSE tokens on DEXs. Bought tokens are permanently burned, reducing circulating tokens as gaming volume grows.

Mathematical Specification
\text{BuybackRate} = 0.80 \times \text{PlatformCut} \quad (\text{PlatformCut} = 0.08 \times \text{TotalBets})
Platform Token Economics ($HORSE)
Tokenomics Allocation: TBA

Zero Presale • Direct Stonk Fair Launch (stonkfun.xyz)

Raceverse is built without private venture presales, discounted insider seed tranches, or speculative fundraising metrics. The $HORSE token features a strictly fixed 1,000,000,000 supply deployed on Solana via Stonk (stonkfun.xyz). Granular community distribution percentages, staking pool yields, and launchpad liquidity pairing will be officially announced prior to the Stonk TGE.

Total Supply1,000,000,000 $HORSEFixed • Zero Unbacked Mint
Presale / VC RoundsNone ($0 Raised)Zero Discounted Insiders
Launch PlatformStonk (stonkfun.xyz)Solana Bonding Curve Launch
Cap Table & AllocationsTBA Prior to TGECommunity Staking Priority
Verified Token Mint (Solana Mainnet / Stonk):9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin
Stonk Launchpad Bootstrapping

Public distribution bootstrapped via Stonk (stonkfun.xyz) on Solana paired with SOL at market-calibrated bonding curve listing price at TGE.

24-Month Timelock Vault

100% of genesis LP tokens deposited into Unicrypt Network and Team Finance timelock contracts for 24 months.

80% Ops & Buyback Pool

From the 8% platform cut, 80% covers operations, servers, and automated $HORSE buybacks on DEXs to burn tokens permanently.

Section 07

Casino & Partner Integration

Easy iframe widgets and direct API connections for online casinos, sportsbooks, and betting shops.

Simple Setup for Online Casinos

Licensed online casinos and betting sites can embed Raceverse virtual races in under 48 hours. We offer lightweight iframes and WebGL widgets that plug straight into your casino balance and cashier.

  • Player Balances: Players bet using their normal casino account balance via direct server callbacks.
  • Fast Setup: Takes less than 2 days to embed into your current site.
  • Works on All Devices: Desktop browsers, mobile web, iOS/Android apps, and retail kiosk terminals.

Retail Kiosks for Land-Based Betting

Using our background in physical casino operations, Raceverse also provides kiosk software for physical betting shops. Bettors in physical venues can place bets using standard cash acceptors and TITO barcode tickets, while NFT vault stakers earn dividends from those wagers too.

Section 08

Provable Fairness & Security Audits

Independent RNG verification, game logic certification, and OpenZeppelin smart contract audits.

Independent RNG & Fairness Certification

The race simulation engine and game logic are evaluated against interactive gaming and wagering standards (GLI-19/33). Statistical randomness tests verify that race results are non-deterministic, tamper-proof, and provably fair across all 12 starting gates.

Smart Contract Security

All smart contracts use audited OpenZeppelin v5 standards with reentrancy protection and strict ownership checks. When you burn duplicate horses to level up, the burn is irreversible and verified on-chain.