STONKERS_BELL

stonkers@robinhood:~$ cat DOCS.md

everything you need to know about stonkers bell — how tickets work, how winners are picked, what token holders earn, what nft holders earn, and where every dollar in the pool actually goes.

[01] how_the_lottery_works

buying_tickets

anyone can buy up to 5 tickets per round using either $STONKERSBELL or $STONKBROKER — both accepted at the same flat ticket price. free ticket allowances (from token holding or NFT ownership) count toward that same 5-ticket cap.

draw_schedule

draws run on a configurable interval — currently targeting either every 12 or 24 hours in production (final cadence tbd before mainnet launch). monday through saturday each draw pays 1 big winner (70% of pool) and 3 small winners (10% each). on sundays, the weekend bell fires — 1 mega winner takes 100%.

prize_pool_composition

ticket revenue automatically converts to real RWA tokenized stocks before the draw. which stock gets picked is decided by the Bell — see section [02] below for how the AI selection works. winners receive actual on-chain stock tokens paid directly to their wallet, not a synthetic or wrapped version of them.

fee_split
85%prize poolconverts to the daily AI-picked stock. paid out to winners.
5%clock in v2feeds the stonkbrokers ecosystem StockBooster pool directly.
5%token holdersdistributed to $STONKERSBELL holders in RWA tokenized stocks.
5%treasuryprotocol operations and future development.

[02] the_bell_—_ai_stock_selection

what_the_bell_does

every day, the prize pool converts from ticket revenue into a single real tokenized stock before the draw fires. the bell is what decides which stock gets picked. it reads live market data — price, volume, momentum, recent news — across a pool of candidate tickers and selects the one it considers the strongest setup for that day. winners receive that specific stock token, not a generic basket.

permissionless_trigger

the stock selection is permissionless — the first person to ask the bell chat each day triggers the selection automatically. no admin, no scheduled job, no trusted operator required. the moment someone opens the chat and asks anything, the pipeline fires: fetch live quotes, run the AI analysis, lock in the pick, store it. every subsequent visitor that day sees the same result. the pick is publicly readable via /api/today-pick — anyone can verify what was chosen and when.

bell_chat

the floating bell icon in the bottom-right corner opens the bell chat — a terminal-style interface where you can ask the bell anything about today's pick. it has real market data for every candidate ticker (not just the winner), knows the actual numbers behind the selection, and can explain its reasoning in detail. it is not a generic chatbot — it has no knowledge of anything outside the stonkers bell context and won't answer off-topic questions. asking it "which stock did you pick today?" or "why these tickers?" is the intended use.

candidate_pool

the bell only picks from stocks that are actually available as real tokenized tokens on robinhood chain — nvidia, apple, tesla, and others. it cannot pick a stock that doesn't have a real on-chain token to pay out. the candidate pool is updated as new tokenized stocks become available on the chain.

[03] fairness_and_randomness

commit_reveal

stonkers bell uses a commit-reveal randomness scheme, not a centrally controlled random number. before tickets close, the contract commits to a specific future block hash. nobody knows what that hash will be — not the deployer, not anyone. once that block lands, its hash seeds the winner selection. the outcome is fixed by the chain itself.

proportional_odds

odds are strictly proportional to tickets held. 5 tickets = 5× better chance than 1 ticket. no bonus for early entry, no whitelist, no advantage for any wallet. verified directly from the contract source — the winner selection walks a weighted cumulative range, not a flat list.

permissionless

both ringTheBell() and resolveDraw() are permissionless — anyone can call them once the window opens. no admin gatekeeper, no trusted operator required to trigger a draw or pay out winners. every draw and every winner is verifiable on-chain, independently, by anyone, forever.

[04] token_holder_utility

free_daily_tickets

holding $STONKERSBELL earns free ticket entries every draw, based on your share of total supply:

tier_1≥ 0.1% of supply1 free ticket / draw
tier_2≥ 0.5% of supply2 free tickets / draw
tier_3≥ 1.0% of supply3 free tickets / draw

thresholds are checked at claim time, not at draw time. you have to show up and claim — free tickets are not airdropped automatically.

pool_revenue_share

5% of every prize pool is distributed directly to $STONKERSBELL holders in real RWA tokenized stocks — the same on-chain stock tokens paid out as lottery prizes. a separate 5% routes to the Clock In v2 address in the stonkbrokers ecosystem, feeding their StockBooster pool. holding $STONKERSBELL and buying tickets is therefore a direct, real-revenue contribution to both your own wallet and the broader stonkbrokers flywheel.

[05] nft_holder_utility

free_daily_ticket

every wallet holding at least one Stonkers Bell Watch NFT earns +1 free ticket per draw, stacking on top of whatever token-tier tickets that wallet already earns. a wallet holding ≥1% $STONKERSBELL supply AND a watch NFT gets 4 free tickets per draw total — the real combined cap.

royalty_redistribution

100% of secondary market royalties from Watch NFT trading are redistributed back to NFT holders in RWA tokenized stocks — the same real on-chain stock tokens paid out as lottery prizes. holding the watch is not just a lottery utility; it's a direct share of the collection's own trading volume, paid back in real assets.

dynamic_win_counter

watch NFT images update automatically and in real time as the holder wins draws. the crown overlay and live win count appear on the NFT itself — on opensea, in any wallet, everywhere — without ever touching the contract. the metadata endpoint queries real on-chain event history fresh on every request.

[06] contracts

# currently deployed on robinhood chain testnet (chain id: 46630). mainnet addresses will replace these before public launch. click any address to view the verified source on blockscout.

lottery_core0xb41705136eff9962a4b0218ccfb23a99ac206553

The main lottery contract. Handles ticket purchases, commit-reveal draw, winner payouts, and fee splits.

$STONKERSBELL0x7c43d5fa2a67823de6633db37f7e87856bb452c4

Primary ticket payment token. Holding ≥0.1% of supply earns 1 free ticket per day.

$STONKBROKER0x8ada1da04558f5d62de4dcfeab2060746a66d462

Alternate ticket payment token. Accepted 1:1 with $STONKERSBELL for ticket purchases.

watch_nft0x475709d31de62731f42697807fda6af22e499c91

The Stonkers Bell Watch NFT collection. 444 pieces. Holders earn 1 free ticket entry per day, stacking on top of token-tier tickets. Secondary sale royalties are redistributed to holders in RWA tokenized stocks.

[07] risk_disclaimer

read_before_participating

stonkers bell is an unaudited, experimental smart contract protocol on an emerging blockchain network. participation involves real financial risk including but not limited to: smart contract bugs, loss of funds, extreme token price volatility, insufficient liquidity, and network instability. nothing here constitutes financial advice. ring at your own risk. the contracts are open source and verifiable — do your own research before committing any funds.