Stonkers

What is it?

Stonkers is a crayon-doodle PFP whose stickers are a real, burnable claim on memecoins.

You pay 0.035 ETH to mint a Hand NFT — a businessman with a random set of meme stickers. 25% of that mint (0.00875 ETH) is a protocol fee. The other 75% (0.02625 ETH) is spent immediately on the memecoins that landed on your hand. If you get bored, you burn the NFT and those tokens come back to your wallet.

It runs on Robinhood Chain. The living spec is whitepaper.txt.

The meme pool:

CASHCAT · STONKBROKER · PONS · MANCER · MOTION · HALT · TENDIES · SNAT · SUSHICAT · FRONG · SWAPPY · HMM

How a hand is built

A card is a (memecoin, leverage) pair. Leverage is 1×, 2×, or 3×. The dealer draws until the leverages sum to 5. Hands are not always five cards — 3× + 2× is a complete hand, and so is five 1× stickers.

The genesis deck is a 52-card template (20 ones, 20 twos, 12 threes). Default shoe is six decks shuffled together. Every name appears at least once at each leverage.

You never pick the cards. Randomness is the shoe.

Fairness: commit, open, audit

Before minting starts, an operator commits keccak256(seed || salt), waits, then opens the shoe with a Fisher–Yates shuffle. The seed is used on-chain to build the shoe but is not published during the sale.

Users mint until the shoe cannot fill another hand. Only then can revealShoe publish seed + salt so anyone can re-derive the shuffle and match the original commitment. Reveal is blocked while cards remain — that is the anti-card-mining rule. /verify recomputes it.

Mint is two transactions

1. commitMint(quantity) — pay exact ETH, reserve worst-case shoe cards. Nothing is dealt yet. Quantity is 1–5.
2. revealMint(commitId) — later block only (same-block commit+reveal reverts). Deals the hand, buys the memes, mints the NFT.

A 3× sticker gets 3/5 of the meme budget; a 1× sticker gets 1/5. The last card takes the remainder so the full 0.02625 ETH is allocated.

Of the tokens the adapter actually buys, ~90.9% is written onto the NFT as handClaims. The rest stays in the vault as a 10% buffer. Two hands with the same sticker names can hold different amounts if their fills differed. Claims are purchase-backed, not a global unit size.

A reverting reveal does not refund commit ETH. A keeper is expected to finish pending reveals.

Burn

Owner calls burn(tokenId). The vault pays handClaims[i] of each card's memecoin to the owner and the NFT is destroyed. No cash settlement.

StockVault tracks liability[token] and enforces balance >= liability. Surplus is overcollateral from the buffer and from optional fee recycling.

Royalties can top up the same hand

Secondary sales use ERC-2981 into a FeeSink. A royalty applier bot calls applyToHand for the sold token: 25% fee, 75% spent on that hand's cards, claims boosted by the same ~90.9% rule.

A raw royalty transfer does not boost claims by itself. Apply can lag minutes. /search shows the top-up table for a token.

Art vs the hand

The crayon doodle (hair, suit, rares) is assigned off-chain from a server seed at tokenId. The meme hand is fully on-chain. They are independent.

Pre-mint, art is gated. Post-mint, tokenURI and image are served from /api/stonkers/{id}.

What you actually own

Not a promised basket size. Not a vibe.

You own cards[] plus handClaims[] — the exact purchase-backed amounts stored at mint, plus any royalty top-ups that actually landed. Burn unwraps that.

The protocol is explicit about the rest: adapter fill quality, operator honesty on the shoe, keeper liveness for reveals, and royalty routing. /boardroom and /activity are the live pulse.