Docs

Guides, addresses, and license.

Documentation

Reference for StonkBrokers. Smart Launch V2, Stonk Launcher, Anvil AMM, and Stonk Exchange are live on Robinhood Chain.

Start

Overview

The 4,444 StonkBrokers collection is fully minted out on Robinhood Chain. Buy $STONKBROKER on OpenSea (marketplace Get tab), then swap or snipe a broker on the Anvil NFT AMM Trade desk. Activate for tier weighted distributions, Clock In to distribute stock, or borrow against a broker.

Live now: $STONKBROKER, Anvil NFT AMM (trade, activate, distributions, loans), Broker Box (Certificate Counter + Degen Mode), Smart Launch V2 (/launcher). The Special Projects roster (TickerYard, Card Wall, Oakmont Vault) is live and trading. The Stonk Exchange (vDEX, powered by up.) is live now — swap, pool, and stake on the trading floor. Leverage Machine, the STORMM powered options exchange, launches September 2026 — /options. Trading apps: see Developer integration or /launcher/developers. Burn to mint closed Thursday, July 16. 11:59 PM EST (historical).

Token

$STONKBROKER ERC-20 whitepaper

The canonical $STONKBROKER token whitepaper covers contract address, fixed supply, no team / no vesting allocation, fee-sink economics, access controls, and the HasLock audit (zero findings) performed by Admir Zlatic (0xSimpleFarmer), Hashlock SSCAC certified.

Network

Robinhood Chain mainnet

4663Chain ID
ETHCurrency
4,444 minted outCollection
L2 mainnetType

Reference

Contract addresses

Live mainnet deployment addresses on Robinhood Chain.

Anvil NFT AMMCollection, token, activation, Clock In, vaults
ContractAddress
NFT Collection0x539c…abf00x539cdd042c2f3d93ebc5be7dfff0c79f3b4fabf0
$STONKBROKER0xe934…bf500xe934e36a439c94017b64a3fece66af12099abf50
Activation Manager0xacd5…f6640xacd5ae3c060c1137fe2ee86b0ab2ef697456f664
Clock In v2 (Directed Booster)0x1f12…81c90x1f12fe622c11947f93f53d63f68f7f46b6d081c9
Stock Booster (Clock In v1, retired)0x038a…726b0x038a7f4e4e89448ad74e044337c9ac25c11e726b
Overtime Booster (retired)0xf9ca…259a0xf9ca5f6d8622c82758914681a12674e2d489259a
AMM Vault0xe302…32d20xe302733accf4800146e55fc45b46b4e4ffc032d2
Loan Vault0xa7b9…36640xa7b9ac696b252b79568a5a01b2fd02177ef23664
Escrow0x799a…cf620x799ae26fa515cef145e8bc8636f7fff87b05cf62
Safety Deposit BoxV3, V4, up. lockers, vesting, Clock In fee router
ContractAddress
V3 Liquidity Locker0xfc96…12230xfc96cf67ecc55be4adabc3aecbe6ad6349f11223
V3 Lock Ownership NFT0xe460…a3600xe460da1a77cae75eed8b355d05b6fcbfa4b2a360
V4 Liquidity Locker0x5a28…bda60x5a28ce098750f73bc9ec142d4bce464e1a0bbda6
V4 Lock Ownership NFT0xad95…aa980xad9535790b0f00ff3f932d482c0112273ec9aa98
UP CL locker0xc1af…a0760xc1afa59e2abc1c868c51a1f799a7578eacfea076
UP CL locker NFT0x3e45…422f0x3e45e90d83d87f961561968709d5ab844eb7422f
UP v2 locker0x2179…90170x21797736c25851a6102d196afba78f978f589017
UP v2 locker NFT0x0256…2ec20x025650befc1ba9c6bc024425aaf0fec72edf2ec2
Vesting locker0x2b4a…9aa90x2b4ad79da7bd3bf340bbd2ad2039b149214e9aa9
Vesting locker NFT0x12d5…420e0x12d554ef1d5b1dcbc6bc4154ec7ce493933f420e
Safety Deposit Clock In (fee router)0x5564…692c0x55642a3f10f1af5145d3d59021b1d6b03bb8692c
Uniswap V4 PoolManager0x8366…09510x8366a39cc670b4001a1121b8f6a443a643e40951
Uniswap V4 PositionManager0x58da…4fa70x58daec3116aae6d93017baaea7749052e8a04fa7
Exchange and Uniswap V3The Stonk Exchange trades on the up. ve(3,3) contracts. The Uniswap V3 stack below backs the Safety Deposit Box and router rails.
ContractAddress
WETH90x0bd7…ad730x0bd7d308f8e1639fab988df18a8011f41eacad73
PositionManager0x7399…e0d30x73991a25c818bf1f1128deaab1492d45638de0d3
Smart Launch V2Eight quote lanes. Always read through SafeLaunchLensV2. See Trading App Integration for ABIs and HTTP routes.
ContractAddress
SafeLaunchLensV20x25b5…15B30x25b5Df581f4b2Ed450203f375ad8A28b17F115B3
SafeLaunchPunchRouter0x2e2a…5C9D0x2e2ae202BD8C7944189A724D572098c16B375C9D
ClockInCard0xcC92…15420xcC9232eFD27B392fF9F96a6DCD45F12C9b6A1542
StonkIcoBonusKickstarter0x2B93…f2700x2B937fF27D117bDDB409B6da4Ee222F65102f270
Smart Launch pad WETH0xFCd6…EC9f0xFCd61B25BbF3AbD6cf0070D6328E351cc30EEC9f
Smart Launch pad STONK0x8f67…6cD40x8f6782c5Aa37804d08a9b7bf3984Ff3245Fd6cD4
Smart Launch pad USDG0xd4F2…D70a0xd4F20033586977A2511f4A2DB4aF7C79a340D70a
Smart Launch pad GME0x4B9D…8cFD0x4B9Dcd6CCFAeF0f6D23065Dd78E79d5E20ec8cFD
Smart Launch pad NVDA0xEe96…F9fB0xEe96d955d5634813374ecE4C74F2C0ff71B1F9fB
Smart Launch pad AAPL0xB045…a8640xB0453A81Cbf963903409FFF18AD92941e1c7a864
Smart Launch pad SPCX0x0c3b…c9470x0c3b4EDED41696eFF0ed70841f132B519d81c947
Smart Launch pad USO0xDb3C…053B0xDb3C81C841ff88db6cDFbDDB0eE049D162A6053B
Smart Launch pad YBTC0x472a…86040x472a1AB6aEB77E3479193FBe83b718f9Bf5F8604
Stonk Launcher
ContractAddress
Launcher Factory0x80a7…72810x80a77001456bc986083678F9a112B1EC2Aa07281
Launch Fee Router0x74F1…47a50x74F161cfd4035Be8F1606e6604a34548c89447a5
LP Locker0xa6bF…47C80xa6bFF814FC8EE3E1F134C767D384D0d9D94147C8
Clock In Pot0x2098…Ebbe0x2098270d97c0cD0cdEC27296343ce76d7285Ebbe
Launch Deployer0x00f8…Dd970x00f8C29B28CB00a20F0CA071eFAED0D3fE15Dd97
Testnet archive (hackathon demo)Robinhood Chain testnet addresses. Do not use on mainnet (chain ID 4663).
ContractAddress
WETH9 (testnet)0x37E4…46910x37E402B8081eFcE1D82A09a066512278006e4691
Uniswap V3 Factory (testnet)0xFECC…23c10xFECCB63CD759d768538458Ea56F47eA8004323c1
SwapRouter (testnet)0x1b32…67250x1b32F47434a7EF83E97d0675C823E547F9266725
QuoterV2 (testnet)0x126f…0dB10x126f1c1F29A0f49c5D33e0139a5Da1FE25590dB1
PositionManager (testnet)0xBc82…A3270xBc82a9aA33ff24FCd56D36a0fB0a2105B193A327
Launcher Factory (testnet)0x631f…61A20x631f9371Fd6B2C85F8f61d19A90547eE67Fa61A2

Module

NFT collection: Stonk Brokers

StonkBrokers launched as a fixed set of 4,444 items in mid-2026 on Robinhood Chain and is one of the first collections built on the ERC-6551 token-bound wallet standard. Every broker owns a real on-chain wallet that is seeded with tokenized stock at mint and, once activated, can receive stock-token reward drops through the StonkBrokers rewards program. Created by Clutch Markets, the brokers anchor the Stonk Exchange ecosystem, including the Stonk Launcher token launchpad and the vDEX.

StonkBrokers is a unified collection of 4,444 unique pixel art stock brokers, each with an ERC-6551 Token-Bound Account. The free mint is closed, the collection is fully minted out. Acquire brokers on the Anvil NFT AMM after buying $STONKBROKER on OpenSea.

Whitelist slots were historically earned by burning Pup Cup (Ethereum) or Clutch Puppies (ApeChain) NFTs before Thursday, July 16. 11:59 PM EST. That path is closed; ApeChain is not a product surface on this site.

4,444Total supply
Minted outMint status
ERC-721Standard
ERC-6551 TBAWallet
Robinhood MainnetChain
Anvil AMM TradeAcquire via
$STONKBROKERToken
Burn to mint (closed)Whitelist

How to get a broker

1

Buy $STONKBROKER on OpenSea via the Get tab.

2

On Trade, swap 666,666 $STONKBROKER + ETH fee for the next vault broker, or snipe an exact # from inventory (ETH trade fee applies).

3

Each broker has a token bound wallet that holds token drops and travels with the NFT.

4

Activate on the Activate tab to earn tier weighted distributions when someone Clocks In.

Module

Anvil NFT AMM

Home for broker trading, activation, distributions, and loans. Flat AMM price is 666,666 $STONKBROKER + ETH fee plus a native ETH trade fee (10% swap / 15% snipe).

  • Get tab: buy $STONKBROKER on OpenSea.
  • Trade: swap $STONKBROKER for the next vault broker, or snipe a specific #.
  • My Brokers: token bound wallet balances and share art.
  • Activate: stake a broker on the distribution payroll (tier weighted).
  • Distributions: Clock In when the ETH pot is full to swap into stock and airdrop.
  • Loans: borrow full principal against a broker; pay ETH fee upfront.

Open /marketplace. See Contract Addresses for the AMM vault and related contracts.

Module

Activation and distributions (Clock In)

Clock In reward drops are paid from the protocol's StockBooster reward pot under the StonkBrokers rewards program. Only activated brokers receive token airdrops, weighted by tier.

Broker activation

66,666Base 100.00x
166,666T1 125.00x
366,666T2 160.00x
666,666T3 200.00x
1,666,666T4 333.00x

Activation fees are paid in $STONKBROKER (50% burned, 50% protocol by default). Activation clears on true ownership transfer.

Clock In

Clock In is the StonkBrokers motto: the distribution flow is 100% onchain and run by the community itself. Every activated broker directs its own share, pick up to 3 tokens from the menu on the Activate desk (weights of your choosing, 100% into one is fine); brokers with no election on file receive the program default (ETH). When the accrued ETH bar is full, any wallet can hit Clock In and pay gas: the engine tallies elections, swaps the pot into each demanded token in one pass, and credits every broker pro rata by tier weight. Credits are pushed into broker wallets automatically, or collect yours instantly with the Deliver button. No bot required; resume open rounds with the same button.

Overtime (retired)

Overtime was the royalty-funded second shift on the Distributions desk. It has been merged into Clock In v2, royalties now feed the same elected-stock engine as trade fees. Historical Overtime rows keep their Bloomberg-orange styling in airdrop history, and past Overtime tickers keep resolving in wallets.

Robinhood Token multipliers (corp actions)

Robinhood Stock Tokens implement ERC-8056. When the underlying company runs a corporate action (a stock split, or a cash dividend paid by the issuer on the real stock), the token updates an onchain uiMultiplier() (shares per token) instead of rebasing balances. Raw token amounts stay put while each token can represent more than one share. Chainlink USD feeds already quote the full token price (share price × multiplier); the UI shows the live × factor on Distributions and My Brokers. This is not the same as Clock In and Overtime airdrops. Those are marketing rewards funded by AMM trade fees and royalties, not corporate dividends. See Robinhood Chain docs.

Module

Loans

Borrow the full 666,666 $STONKBROKER + ETH fee principal against a broker as collateral. The fee is paid in ETH upfront at 15% APR on the market ETH notional for the loan duration (minimum term floors the fee so borrowing is never cheaper than an AMM exit). Excess msg.value is refunded. Fees split 70% StockBooster / 30% protocol. Repay returns exactly the principal in $STONKBROKER; overdue loans owe an additional ETH late fee at the same rate.

UI: /marketplace?tab=loans. Contract: Loan Vault in addresses.

Module

Safety Deposit Box: liquidity locker

Lock LP on Robinhood Chain to prove liquidity commitments while keeping swap-fee income. Five desks: the V3 locker escrows an existing Uniswap V3 LP position NFT; the V4 locker mints and custodies a native-ETH Uniswap V4 position directly in the canonical PoolManager (V4 position NFTs can't be escrowed as-is, the UI detects them in your wallet and prefills a matching deposit instead); the up. CL locker escrows up. DEX Slipstream concentrated-liquidity position NFTs; the up. v2 locker vaults up. v2 pool LP tokens; and the vesting desk escrows plain ERC-20 tokens with no LP position at all. Locked up. positions can additionally be staked into their pool's up. gauge to earn UP emissions without ever leaving the box. Every lock issues a transferable ownership NFT; whoever holds it collects the position's swap fees and, once the window opens, withdraws the liquidity.

Fee modes (chosen at lock time, immutable)

0.5% upfront

Protocol takes 0.5% of the locked liquidity at lock time. Nothing more on withdraw or fee-collect.

20% of swap fees

Protocol takes 20% of every swap-fee collect (80/20 split). Locked principal is never touched. Offered for Special Partners.

A legacy third mode (1% on withdraw) still functions for locks that chose it but is no longer offered for new locks.

Lock styles and unlock windows

Each lock sets a start and finish timestamp: nothing is withdrawable before start, liquidity vests linearly between the two, and after finish the position is fully withdrawable and releasable. The UI offers three styles built on that window:

Hard lock

Start is set to the unlock date with a 10-minute vest tail after it, 0% withdrawable until the date, then everything. The default for new locks.

Linear vesting

Start is now (or a chosen delay) and finish is the end date, liquidity unlocks continuously across the window, withdrawable as it vests.

Permanent

Window pinned at the top of the uint64 range, vesting never begins and release is impossible for anyone, forever. Swap fees stay claimable.

Lock cards badge every deposit as HARD LOCK, LINEAR VESTING, or PERMANENT so the semantics are readable at a glance. The UI stamps windows a few minutes ahead at submit so transactions can't revert with a past start time; this only ever delays a window, never shortens it.

Where protocol fees go

All locker protocol fees route to the Safety Deposit Clock In contract, an ownerless, pull-based router with a 90% community / 10% protocol split. ETH and WETH flow into the Stock Booster reward pot; other tokens open claim rounds that activated brokers pull into their token-bound wallets under the rewards program, each broker claiming its own tier-weighted allocation.

Safety properties

  • No admin key can seize, withdraw, or release locked liquidity, the owner can only rotate the fee recipient for future fees.
  • Locked principal is mathematically unwithdrawable before the unlock window opens; permanent locks can never be withdrawn by anyone.
  • Only the current holder of the lock's ownership NFT can collect swap fees, withdraw vested liquidity, or release the position.
  • Lock windows are fixed inside the signed transaction, no third party can shorten them after the fact.

Security audit

Hashlock certified. Audited by 0xSimpleFarmer

The Safety Deposit Box contracts passed a full Hashlock-certified security audit by 0xSimpleFarmer (signed off 2026-07-15): 0 critical and 0 open high findings, the two highs identified during review were fixed and covered by regression tests, and every fix was re-verified against live on-chain transactions. The audit covers the locker core, the ownership NFT, fee-mode math, admin trust boundaries, and rug vectors.

Read the full report: Hashlock Certified Contract Audit (full text)

UI: /locker. Contracts: see Contract Addresses.

Module

Smart Launch V2

Permissionless token launcher with anti snipe curves, degen mode, fair launch buffers, and guaranteed bond graduation. Every raise bonds into a permanently locked pool in the Safety Deposit Box (up. Slipstream CL or optional Uniswap v3 venue). Degen launches stream half of every fee to the ICO Bonus Kickstarter.

Trading apps: integrate against StonkSafeLaunchpadV2 + SafeLaunchLensV2 — full addresses, ABIs, and HTTP routes in Trading App Integration.

UI: /launcher. Developers: /launcher/developers

Developers

Trading app integration

For GMGN, BasedBot, aggregators, and bots wiring buy/sell on StonkBrokers launch tokens. Two surfaces: Smart Launch (V2/V3 pad singletons) and Stonk Launcher (factory curve per token). Always key Smart Launch storage on (pad, launchId). Quote through SafeLaunchLensV2 — never reimplement curve tax math.

Trading terminal integration. Chain 4663

Downloads

Full two part guide (Arbitrum One + Robinhood Chain) with the ABI selector and event topic reference.

Smart Launch. V2 pads

V2 pads
ContractAddress
SafeLaunchLensV2 (quotes + views)0x25b5…15B30x25b5Df581f4b2Ed450203f375ad8A28b17F115B3
V2 pad WETH0xFCd6…EC9f0xFCd61B25BbF3AbD6cf0070D6328E351cc30EEC9f
V2 pad STONK0x8f67…6cD40x8f6782c5Aa37804d08a9b7bf3984Ff3245Fd6cD4
V2 pad USDG0xd4F2…D70a0xd4F20033586977A2511f4A2DB4aF7C79a340D70a
V2 pad GME0x4B9D…8cFD0x4B9Dcd6CCFAeF0f6D23065Dd78E79d5E20ec8cFD
V2 pad NVDA0xEe96…F9fB0xEe96d955d5634813374ecE4C74F2C0ff71B1F9fB
V2 pad AAPL0xB045…a8640xB0453A81Cbf963903409FFF18AD92941e1c7a864
V2 pad SPCX0x0c3b…c9470x0c3b4EDED41696eFF0ed70841f132B519d81c947
V2 pad USO0xDb3C…053B0xDb3C81C841ff88db6cDFbDDB0eE049D162A6053B
V2 pad YBTC0x472a…86040x472a1AB6aEB77E3479193FBe83b718f9Bf5F8604

Smart Launch. V3 pads (external token)

V3 pads
ContractAddress
V3 pad WETH0x5BCE…a3B30x5BCEefBa6fDf437A7388aDC5c9056c827baca3B3
V3 pad STONK0x406f…11310x406fd0B957bb8cF1dd57C78540D009578e971131
V3 pad USDG0xF0A0…0eeA0xF0A06Ac7BBb0cc3049B68c257c3ee27CcEA40eeA
V3 pad GME0x5b21…992B0x5b21F8a5Ef81586627B4725844aD447325d0992B
V3 pad NVDA0xDf03…9B540xDf03953DCA8dB733345278A0c5fd2E81fa2A9B54
V3 pad AAPL0xc522…657f0xc522DfaE0D1a140257702392B665183a6De7657f
V3 pad SPCX0xd82d…a86A0xd82da1D8ef59959b170b59147283Ab1F2F1Ca86A
V3 pad USO0x644b…70D20x644b19512052A1b6d38d7B16C6c3Fb1d3F7270D2
V3 pad YBTC0x2bd7…76dA0x2bd7F90cca4660da82aa693cF352dDB6275C76dA

Curve-phase trade (Smart Launch)

solidity
// Reads — SafeLaunchLensV2 @ 0x25b5Df581f4b2Ed450203f375ad8A28b17F115B3
quoteBuy(pad, id, quoteIn) → (tokensOut, taxBps)
quoteSell(pad, id, seller, tokensIn) → (quoteOut, taxBps)

// Writes — StonkSafeLaunchpadV2 @ pad
buy(id, quoteIn, minTokensOut, ref, recipient)
buyEth(id, minTokensOut, ref, recipient) payable   // WETH lane
sell(id, tokensIn, minQuoteOut, ref, account, ethOut)
setOperator(id, operator, approved)

// After core.bonded → swap on locked pool via standard DEX router

Indexer events (Smart Launch)

On each pad: LaunchCreated, LaunchArmed, SafeBuy, SafeSell, LaunchBonded.

HTTP API. Smart Launch

Smart Launch HTTP
RoutePurpose
GET /api/safe-launch/floorLaunch grid: token CA, pad, id, phase, mcap, quote lane.
GET /api/safe-launch/buysLive buy tape (SafeBuy logs).
GET /api/safe-launch/token-logo?tokens=0x…Batch logo lookup (≤60 tokens).
GET /api/launcher/token-image/<hash>Logo bytes (content-addressed).

Stonk Launcher. Factory curve

Factory
ContractAddress
StonkLaunchpadFactory0x80a7…72810x80a77001456bc986083678F9a112B1EC2Aa07281

Curve-phase trade (factory tokens)

solidity
// StonkCurvePool @ pool from factory Launch event
buy(minOut) payable
sell(amount, minOut)

// Factory @ 0x80a77001456bc986083678F9a112B1EC2Aa07281 — index from block 34876725
poolOf(token) → pool address

HTTP API. Stonk Launcher

Launcher HTTP
RoutePurpose
GET /api/launcher/tokensFactory token grid (sort=new|mcap|volume|trending|grad).
GET /api/launcher/token/<address>Single factory token + curve state.
GET /api/launcher/trades?token=0x…Recent trades for a factory token.

Network: Robinhood Chain (chainId 4663). Explorer https://robinhoodchain.blockscout.com

Module

Stonk Launcher

Community curated token launchpad on Robinhood Chain. Bonding-curve sales graduate into locked up. or Uniswap v3 pools with a 33/33/33 fee waterfall and VRNG Clock In buybacks. Factory address 0x80a77001456bc986083678F9a112B1EC2Aa07281 — per-token curve pools emit from launch events. Integrator reference: Trading App Integration.

Community curated by StonkBrokers and $STONKBROKER holders. Launcher activity feeds the protocol's wider ecosystem programs; launched tokens can list on Stonk Exchange (vDEX).

Lifecycle

1. Create

Deploy ERC-20 + sale with fixed price, bonding curve, or custom parameters.

2. Sale

Users buy during the configured sale window.

3. Finalize

Seed Uniswap V3 pool, LP, fee splitter, and staking vault.

Opening Bell buybacks: VRNG-triggered market buys

Every bonding-curve trade pays the launcher fee, and a fixed slice of every fee streams into the Buyback Bar, an on-chain pot that charges as the floor trades. When the bar is full, the miner-backed VRNG (the same certified-print entropy that runs Broker Box) draws two things nobody, not traders, not miners, not the team, can predict or forge: when the bell becomes ring-able, and which live bonding-curve token gets bought.

1. The bar charges

A portion of every buy and sell on every bonding curve feeds the pot. More floor volume = faster charge. The bar level is public, everyone watches it climb.

2. The draw

VRNG picks the moment and the target token in one draw. Selection odds are weighted by each token's fee contribution, curves that feed the bar more carry proportionally better odds, but every live token has a shot on every draw.

3. Clock In

Once the bell goes live, anyone can Clock In to ring it. The entire bar market-buys the drawn token straight into its curve in a single sweep, and the ringer earns a tip for pulling the trigger.

On every other launchpad the fee is pure exit, value leaves the floor and never comes back. Here the house edge is pointed back at the tokens themselves: fees recycle into random, unfrontrunnable buybacks, so expected value flows back to the people actually trading. It is designed to be the highest-RTP meme-coin trading floor crypto has ever seen, the entropy path is byte-identical to Broker Box's audited draw (a pure function of a future certified print), so buyback timing can't be sniped, ground, or selectively aborted by anyone, including us.

UI: /launcher.

Module

Broker Box: World Wide Stonk Exchange

Live on Robinhood Chain mainnet. The floor is the World Wide Stonk Exchange: two counters share one deed collection (First Edition Original Mint). The Certificate Counter sells any listed stock sealed in a bearer deed at exactly . Degen Mode (Play the Box) rolls your multiplier on miner-backed VRNG from 0.70× to the 50× bell and pays out real Robinhood stock tokens the same way. Design RTP is 90.00%. UI: /broker-box.

Machines are ownerless: no pause switch, no upgrade path, no key to player funds. The stocker (treasury on official machines, creator on community launches) can only reclaim idle seed capital and spare bankroll, never reserved prizes, player-owed ETH, or parked protocol accrual. Stock-token play and counter mints are unavailable in the United States; settles, rescues, redeems, and cash-outs still work.

Two counters

Certificate Counter

No game of chance. Buy a 1× Stonk Certificate of any listed stock. Your ETH (minus a flat $2 fee) swaps through StonkStockRouterV2 at purchase; the exact pool output vaults in the deed. Fee split: $1 to StockBooster / $1 to treasury. Size from $1 to $10M, the UI quotes the live pool return (with state-override) before you sign. Mint to yourself or gift to any wallet. Uses no machine inventory.

Degen Mode: Play the Box

Pay a ticket in ETH or USDG, ring the bell, and a provably fair roll strikes your multiplier. Wins settle as stock in your wallet; you then choose instant 95% sell-back (USDG or ETH) or seal the full prize into a numbered deed. Each open pull reserves its worst-case 50× payout in real stock, so ticket size is bound by that machine's live inventory.

Live floor (mainnet machines)

Nine production machines share one certificate collection. Every machine passed a live router-route probe at launch. The counter shelf can also list route-live stocks that do not have a machine (e.g. feed-less tapes sold OTC only).

Machines
ContractAddress
GME GameStop0x8f18…95b00x8f1836209c42d4f6b6caa782c055ee13f8ac95b0
AAPL Apple0xf9bc…0d440xf9bc0777c087af0fe7214de8a5360be6a71d0d44
AMZN Amazon0x2829…b7150x2829b754784352dd2beffa5eb26d5b499315b715
NVDA NVIDIA0xc5e3…58a00xc5e3e9c2a835ec9319fd8c1d516fd4323c5758a0
GOOGL Alphabet0xff20…072f0xff20b4b8e08beaa4064e3ca4cc5a2e40acac072f
MSFT Microsoft0xfc25…54020xfc253e0062eef614e20e0726e5f6ff7559c35402
SLV iShares Silver0x9d2c…25040x9d2c3355502be065975ad47ef5a902f02c772504
SPCX SPAC and New Issue ETF0xf589…46090xf58979d35c3f0ff6a6f7edd909fe8a95a2894609
USO United States Oil0x5b12…c33c0x5b1282b6ad40b3dc294404a2b33ff7657b66c33c

Tickets, inventory and ladder

Contract tiers run $10 / $50 / $100 / $250 / $500 / $1,000. Mainnet sells up through $100 (hard entropy-grind security ceiling: max outcome $5,000 at 50×). A tier opens on a machine when free stock can reserve one worst-case round (62.5× the ticket at the oracle mark). As inventory compounds (edge + sell-back spread + restock), bigger tickets unlock automatically, high-roller rungs above the live cap stay dimmed until the floor deepens. Pay with ETH or USDG (USDG swaps on-chain at the oracle mark; ~2% headroom refunds in ETH).

After you win

  • Instant cash-out. Every degen win lands as stock in your wallet on settle. One tap sells it back at 95% of the live mark, paid in USDG or ETH from the machine bankroll. The 5% spread stays in the bankroll (house revenue); it is reclaimable by the machine's reclaimer.
  • Mint a Stonk Certificate. sealIntoCertificate(roundId) seals 100% of the prize in a numbered polymer deed with its own ERC-6551 vault, no spread taken. Hold it, trade it, gift it, or redeem any time (redeem burns the deed; cashing out after still pays 95%).

How Stonk Certificates work

1. Struck fully onchain

Claiming a win (or buying at the counter) mints the next numbered deed into one shared collection. Artwork is drawn entirely by the smart contract, no servers, no image hosting. Traits are minimal by policy: Stock, Vaulted Amount, Branch.

2. Sealed vault inside

Every deed owns an onchain vault holding the actual stock tokens. The only way stock leaves is redeem, which burns the deed in the same transaction. An emptied note cannot exist, nobody can be sold a spent certificate.

3. Bearer note

Whoever holds the deed owns the vault. Trade it, gift it, or list it, the stock travels sealed inside. Royalty is 3.33% (cap 5%) to the treasury via setRoyalty.

4. Redeem and cash out

Redeem burns the deed and opens the vault into your wallet. From there, one tap sells the stock back to a machine at 95% of the live mark.

VRNG on Robinhood Chain, powered by DERP

Robinhood Chain has no Chainlink VRF on the production path, so the Box draws randomness from DERP: miners publish certified entropy prints to an onchain conductor, and every machine reads its random words from that shared feed. Production machines use 3 prints ahead plus a ~45s settle-delay floor (older builds used 8 prints / 60s). Round time is cadence-bound, typically a couple of minutes; the UI shows a live ETA from mine health. A Chainlink VRF conductor adapter exists for a future migration.

  • Commit first, entropy later. A pull commits to a word that does not exist yet, derived from future certified prints. Neither the player, the house, nor any single miner can choose the outcome. Once the deciding print lands, the ticket cannot be cancelled to dodge a bad roll.
  • Anyone can verify. wordOf(id) equals previewWord(id) once fulfilled. Anyone can recompute the multiplier; our keeper (or any third party) can call fulfill to land the word.
  • Fails closed. If certified prints thin out or stall, machines stop selling new tickets (FloorUnhealthy). Settles, rescues, redeems, and cash-outs always go through. A pull whose word never lands can be rescued for a full ticket refund after 48 hours.
  • Inventory-bound concurrency. Open rounds reserve stock; when free stock cannot back a new ticket the bell greys out until rounds settle or the restock keeper bridges ETH and converts bankroll to stock. Pulls never sell an uncovered prize.

Prize table (bytecode)

Worst roll pays 0.70×, a player can never be down more than 30% on a single pull. RTP 90.00%.

0.70x45.18%
0.75x36.40%
0.80x2.90%
0.85x2.24%
0.90x1.80%
0.95x1.50%
1.00x2.50%
1.10x1.80%
1.25x1.40%
1.50x1.10%
1.75x0.80%
2.00x0.70%
2.50x0.50%
3.00x0.35%
4.00x0.20%
5.00x0.16%
7.50x0.15%
10.00x0.12%
15.00x0.06%
25.00x0.04%
50.00x0.10%

House edge and fee map

Every degen ticket carries a 10% house edge, burned into machine bytecode at launch:

  • 2.5% creator, pushed at settle (official machines set creator = StockBooster, so this also lands on Clock In)
  • 2.5% StockBooster. Clock In pot for activated brokers
  • 5% protocol, accrues in the machine; withdrawable only to the immutable treasury above the bankroll floor
  • 5% sell-back spread, stays in machine bankroll; reclaimable by the reclaimer (treasury on official machines, creator on community ones). Community reclaimers cannot touch protocolAccrued.
  • Counter, flat $2 ($1 booster / $1 treasury), no percentage. Royalty 3.33% on deed secondary sales to treasury.

Broker Box activity feeds the same Clock In reward pot, activated brokers choose what their reward drops pay out in through their Clock In v2 election on the Activate desk.

Deploy your own box (coming soon)

Permissionless launches via the factory are next. One factory call will spin up a new machine pointed at approved stock-token routes and USD feeds, already wired to the shared DERP conductor, swap router, and deed collection. Community launchFor credits the creator with the 2.5% creator share and makes them the reclaimer. Official launch routes creator fees to Clock In. Launches stay curated so junk tokens and junk feeds cannot mint official-looking deeds. Machines migrate VRNG in place via a 3-day timelock (proposeConductor / commitConductor); setMinterRegistrar is redeployable so new machine generations can join the same certificate collection.

Core contracts (mainnet)
ContractAddress
Factory0x278d…d2260x278d4989232c0c213ed4a8a0652f46a21b0fd226
Stonk Certificate0xafbc…e6be0xafbc48317dd946e3b9ce570b75e48a285862e6be
Certificate Counter0x2599…29d70x2599882aaf5c14834562ee59ca7a3d1ffcc229d7
VRNG Conductor0x003e…bcde0x003e29260ef2f762e7f2d95c3d2b7a7f6234bcde
USDG ↔ ETH Exchange0xaf4c…065f0xaf4c809518a9117c4f8e42e82b7221b17fe7065f
StonkStockRouterV20xa88F…00C40xa88F54239Be5124afFea441eDDF423BB138B00C4

Never wire the canonical ERC-6551 registry into a Stonk Certificate deploy, only the project's initializing registry clones + initializes vaults atomically. Full deploy state: contracts/gacha/deployments.mainnet-production.json.

Module

Special Projects

Module

The Stonk Exchange — Powered by up. (vDEX)

Community governed exchange on Robinhood Chain, powered by up. — the ve(3,3) DEX on Robinhood Chain. Swap, provide liquidity (v2 + Slipstream CL), and stake LP in gauges for $UP emissions, live on the trading floor. $STONKBROKER holders vote on how directed flow is routed.

The up. Partnership

Stonk Exchange runs on the up. ve(3,3) engine: Velodrome-style v2 pools, Slipstream concentrated liquidity, gauges, weekly veUP emissions and gauge voting. The up. engine is integrated directly into this section — swap, pool, and gauge staking are live on the trading floor, with the vote suite next. What the partnership entails:

  • $UP is the native vDEX token. UP is pinned on every swap desk menu, one tap from the default (CA 0x57C0…B4F1).
  • Launcher benefits. Tokens launched through Stonk Launcher graduate into a ve(3,3) venue: a gauge can be created and voted for their pool, LPs earn $UP emissions instead of the token paying for its own liquidity, and incentives can be posted to attract deeper books — standing liquidity infrastructure for every launch that makes it.
  • Directed flow. $STONKBROKER remains the governance token of the vDEX — holders direct which pools, routes and ecosystem programs get flow, on top of the veUP gauge layer.
  • Locked liquidity stays home. We do not use the up. locker: up. LP positions (Slipstream position NFTs and v2 LP tokens) lock into the Safety Deposit Box with optional in-locker gauge staking, so locked positions keep earning $UP emissions.

Integrator note: Slipstream is not ABI-compatible with Uniswap V3 — pools are keyed by int24 tickSpacing, never uint24 fee, and swap fees are governance-tunable (read live, never from a static tier). The verified up. contract map lives in app/lib/up-dex.ts; the reference set is vendored at docs/integrations/up/ in the repo. The snippets below are the Safety Deposit Box / Uniswap V3 router rail, not the up. swap ABI.

Quote a swap (SDB / router rail)

solidity
// QuoterV2 at 0x…
function quoteExactInputSingle(
    address tokenIn,
    address tokenOut,
    uint24 fee,
    uint256 amountIn,
    uint160 sqrtPriceLimitX96
) external returns (uint256 amountOut, ...);

Execute a swap (SDB / router rail)

solidity
// SwapRouter at 0x…
struct ExactInputSingleParams {
    address tokenIn;
    address tokenOut;
    uint24 fee;
    address recipient;
    uint256 deadline;
    uint256 amountIn;
    uint256 amountOutMinimum;
    uint160 sqrtPriceLimitX96;
}
function exactInputSingle(ExactInputSingleParams calldata params)
    external payable returns (uint256 amountOut);

ETH ↔ WETH

solidity
// WETH9 at 0x0bd7d308f8e1639fab988df18a8011f41eacad73
function deposit() external payable;
function withdraw(uint256 wad) external;

Fee tiers

500 0.05%Stable pairs
3000 0.3%Standard pairs
10000 1.0%Exotic / low liquidity

UI: /exchange.

Module

Pools: create pools and mint LP

Create Uniswap V3 concentrated liquidity pools and mint LP positions when the vDEX opens.

Coming soon on mainnet. Opens with the Stonk Exchange.

solidity
// PositionManager at 0x73991a25c818bf1f1128deaab1492d45638de0d3
function createAndInitializePoolIfNecessary(
    address token0,
    address token1,
    uint24 fee,
    uint160 sqrtPriceX96
) external payable returns (address pool);

function mint(MintParams calldata params)
    external payable returns (uint256 tokenId, uint128 liquidity, uint256 amount0, uint256 amount1);

Module

Leverage Machine. STORMM

Coming soon on mainnet. StockFi infrastructure.

A permissionless on chain options exchange on Robinhood Chain, powered by the STORMM engine. LP stock tokens or ETH and earn yield from LP fees, option premiums, and stock token multiplier dividends. Buy calls or puts against that liquidity, and every position mints as a tradeable NFT to your wallet. LPs earn option premiums plus LP fees plus stock token multiplier dividends from the same deposit; buyers hold tradeable ERC-721 positions and get leverage on tokenized stocks without traditional liquidation mechanics.

  • Powered by STORMM. STORMM runs on Uniswap V4 LP positions with special hook functionality. Take the NVDA and ETH pair: deposit ETH into put liquidity, NVDA into call liquidity, or both, inside your preselected range. That range is the set of strikes you are comfortable selling your liquidity into.
  • Uniswap LP yield. plus two more streams. While deposited, your range earns classic LP fees from normal token trading on Uniswap, exactly like any V4 position. On top of that it earns premiums from options writers and buyers who leverage against your liquidity, and stock token multiplier dividends on the stock side.
  • Regenerative. no rebalancing. Once you deposit there is no need to rebalance. As traders use your LP and options expire or execute, the liquidity automatically returns to its ticks to accrue more premiums and fees. Impermanent loss is not realized unless you withdraw your initial position. LPs are the house.
  • NFT positions. leverage without liquidations. Every call or put mints to your wallet as an ERC-721 you can hold to expiry, exercise in the money, or sell before expiry. Risk is bounded by the premium you pay, not a maintenance margin call that wipes your wallet.

Full overview: /options. Exercise uses TWAP verified pricing once pools are live on the Stonk Exchange.

solidity
// CoveredCallVault at 0x…
function createOffer(...) external returns (uint256 offerId);
function buyOption(uint256 offerId) external returns (uint256 optionTokenId);
function exercise(uint256 optionTokenId) external;
function reclaimExpired(uint256 optionTokenId) external;

Build

Token Registry

On chain list of known tokens with metadata for exchange UI dropdowns.

Archive

Faucet: testnet only (historical)

The testnet StonkEthFaucet was used during the Robinhood Chain hackathon demo. Mainnet users bridge ETH, there is no faucet on the production site.

solidity
function canClaim(address user) external view returns (bool);
function nextClaimTime(address user) external view returns (uint256);
function claim() external;

Bridge docs: Robinhood Chain.

Reference

ABI quick reference

Key entry points for integrators. Full ABIs live in this repo under app/lib/abis.

Entry points
ContractFunctionPurpose
AMM Vaultbuy / sell / snipeBroker ↔ token trades
ActivationManageractivate / upgradeDistribution payroll tiers
DirectedClockInBoosterelect / crank / deliverClock In v2, elected-stock airdrops
LoanVaultborrow / repay / liquidateETH fee loans
LiquidityLocker (V3)lockByTransfer / collectFees / decreaseLockedLiquidity / releasePositionEscrow + manage V3 LP locks
LiquidityLockerV4lock / collectFees / decreaseLockedLiquidity / releasePositionMint + custody V4 locks
UP CL / v2 lockercollectFees / withdraw / releaseLocked up. positions
Vesting lockerlock / withdraw / collectERC-20 vest in the box
SafeLaunchLensV2quoteBuy / quoteSellSmart Launch curve quotes
StonkSafeLaunchpadV2buy / sell / buyEthSmart Launch curve trades
StonkLaunchpadFactorypoolOf / Launch eventsFactory curve tokens
QuoterV2quoteExactInputSingleSwap quotes (SDB / router rail)
SwapRouterexactInputSingleExecute swap (SDB / router rail)
PositionManagermintLP positions (SDB / router rail)
CoveredCallVaultcreateOffer / buyOption / exerciseOptions (upcoming)

Legal

Protocol license (BUSL 1.1)

Effective 2026-08-25

SB (BVI) Ltd licenses the StonkBrokers Protocol Licensed Work (Clock In / Directed Clock In, Broker Box, Smart Launch / Stonk Launcher, collection / TBA / marketplace, bridge, and related protocol contracts in this repository) under the Business Source License 1.1 (BUSL 1.1). Anvil AMM is under the same license model in the SB (BVI) Ltd Anvil repository (Change Date 2029-08-12).

Warning to cloners and violators.

Production or commercial use of StonkBrokers Protocol or Anvil AMM source — including deploying a competing Clock In engine, Smart Launch pad, Broker Box stack, marketplace derivative, or Anvil factory / vault fork — without an Additional Use Grant or written commercial license from SB (BVI) Ltd violates BUSL 1.1, terminates license rights, and may be pursued as copyright infringement. On-chain bytecode, Blockscout verification, public ABIs, and integration PDFs are not a production-use grant.

  • Non-production study and testing of lawfully received source: allowed. End-user / frontend integration against live Clutch-operated deployments: allowed.
  • Change Date for StonkBrokers Protocol: 2029-08-25 → MIT. Anvil AMM Change Date: 2029-08-12 → MIT.
  • Trademarks (StonkBrokers, Clock In, Smart Launch, Stonklauncher, Clutch, Anvil) are not licensed by BUSL.