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
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.
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%.
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.
[02] the_bell_—_ai_stock_selection
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.
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.
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.
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
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.
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.
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
holding $STONKERSBELL earns free ticket entries every draw, based on your share of total supply:
thresholds are checked at claim time, not at draw time. you have to show up and claim — free tickets are not airdropped automatically.
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
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.
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.
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.
The main lottery contract. Handles ticket purchases, commit-reveal draw, winner payouts, and fee splits.
Primary ticket payment token. Holding ≥0.1% of supply earns 1 free ticket per day.
Alternate ticket payment token. Accepted 1:1 with $STONKERSBELL for ticket purchases.
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
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.