Skip to documentation
Otherside Developers Back to casino

STONKS CASINO / TECHNICAL DOCUMENTATION

System design and launch status

Stonks Casino is designed to accept APE wagers on ApeChain and pay winning players in stock tokens on Robinhood Chain. This page contains the implementation details intentionally removed from the consumer experience.

CURRENT STATUS Free deterministic preview only. Real-money settlement, vault deposits, NFT claims, staking, and reward streaming remain disabled.

BUILD MORE GAMES

Use the exact model handoff.

The Game Factory handbook defines the concept brief, payout math, deterministic randomness, component lifecycle, test matrix, asset rules, metadata, submission transformation, and final report required for every future Stonks Casino game.

Open the game creation handbook
01

ARCHITECTURE

APE in on ApeChain. Stocks out on Robinhood Chain.

01APECHAINRound quote

Ape Church accepts the wager and locks the edge, liquidity limit, prices, and round randomness.

02GAMEDeterministic result

Equity Bros consumes the supplied randomness. No browser randomness can affect a payout.

03CROSS-CHAINAuthenticated message

The approved bridge transports an idempotent, nonce-protected settlement record.

04ROBINHOOD CHAINStock settlement

The selected stock token is paid to the player’s same EVM address.

The required Ape Church public records are RoundQuote, RoundSettlement, VaultState, StakeActivation, and RewardStream. Exact ABI names and callback semantics will follow the official protocol specification; this project does not invent a mainnet interface.

02

EQUITY BROS

Brutal Math v3

The house edge is locked at 5%, the first two quarters are mandatory, and the maximum multiplier is 25x. The high loss frequency comes from the multiplier ladders, not from hidden odds.

CONSERVATIVE31.7% reach Q2
1.8x → 3x → 5x → 8x → 12x → 18x → 22x → 25x
BASE CASE25.0% reach Q2
2.2x → 3.8x → 6.5x → 10x → 15x → 20x → 23x → 25x
COVENANT-LITE19.0% reach Q2
3x → 5x → 8x → 12x → 17x → 21x → 23.5x → 25x
P(reach first rung) = (1 − houseEdge) ÷ firstMultiplier
P(pass rung k | reached k−1) = previousMultiplier ÷ nextMultiplier
P(reach rung k) = (1 − houseEdge) ÷ rungMultiplier
Expected multiplier at any cash-out rung = 0.95

One Ape Church round seed deterministically resolves the final safe quarter. Domain-separated hashes derive the survival path, presentation events, and uniform stock selection. Presentation events never change odds. Manual exit, automatic exit, and the final exit always settle on a disclosed ladder rung.

03

PAYOUT SETTLEMENT

Uniform, value-neutral stock assignment

A winning round selects one ticker uniformly from NVDA, AAPL, GOOG, TSM, and AMZN. APE/USD and all five stock-token prices are locked when the wager is accepted.

stockTokenAmount =
wagerAPE × lockedAPEPriceUSD × payoutMultiplier ÷ lockedStockTokenPriceUSD

New rounds must pause if any marketed ticker is inactive, halted, stale, undergoing an unresolved corporate action, or lacks sufficient reserved liquidity. Maximum wager is constrained by the least-liquid possible random ticker.

04

STONKS HOUSE VAULT

Solvency before utilization

Required controls include fresh canonical oracles, explicit slippage limits, corporate-action multipliers, per-ticker reserves, free-liquidity accounting, replay protection, retries, message ordering, and finality rules.

05

NFT AND REWARDS

ApeChain eligibility, Robinhood Chain earnings

ELIGIBILITY10 / 3 / 1 weights

Dreamweavers token IDs 0–3 receive 10x weight. Future tokens from the same contract receive 3x. Staked Equity Bros NFTs receive 1x.

Only Dreamweavers from 0xe1df77bcaa64e0cbcd8fbd19ac7c228b03ae0552 qualify.

REWARD STREAM80% / 20%

80% of realized net creator revenue funds NFT rewards; 20% funds operations. Net excludes protocol fees, bridge and swap costs, and required reserves.

Each funded hour buys equal value of all five stock tokens and streams that basket over 60 minutes by active weight.

Equity Bros NFTs hard-stake in ApeChain escrow. Dreamweavers register non-custodially because their ERC-5192 tokens cannot transfer. Cross-chain activation and deactivation require authenticated acknowledgements. Accrued rewards remain claimable after deactivation.

06

CONFIGURATION

Addresses and current deployment state

ADMIN / REVENUE0x191f77208F6EaB1ab223EE402DC32863AC212ACE
DREAMWEAVERS ERC-51920xe1df77bcaa64e0cbcd8fbd19ac7c228b03ae0552
EQUITY BROS ERC-721Not deployed
APE CHURCH STONKS VAULTOfficial specification pending

Initial administration uses two-step ownership transfer so control can later move to a Safe or stronger signer. Submission contact: Telegram sixtheplug.

07

PRODUCTION GATES

No implicit mainnet switch

No mainnet vault, bridge adapter, staking escrow, or reward-streaming contract will be deployed until the missing protocol interfaces are approved.