BRRR docs

BRRR is an idle machine-shop game on Robinhood Chain. You commission a press — an ERC-721 bound to one official Robinhood Stock Token ticker (NVDA, AAPL, TSLA, QQQ and the rest of the list). You keep that press running by loading it with the matching Stock Token, which the game calls paper. A running press accrues notes.

Notes are a claim on a vault. The vault fills from two places and only two: the Stock Tokens players load as paper, and the 4% tax charged on every $BRRR trade. Cashing out pays your pro-rata share of that vault, burns the notes that paid you, and resets the press to its commissioning stats.

$BRRR is the central token and it launches first. The game contracts can come after. While only the market is live, every swap still accrues to the vault — there is simply nobody claiming from it yet.

Two assets, two jobs. $BRRR is minting, calibration and unjamming. Official Robinhood Stock Tokens are paper. They are ERC-20s issued by Robinhood Assets (Jersey) Limited. They are not the press NFT, and the press NFT is not the stock.

BRRR is a fork of the FrenPet loop (Base, 2023), by way of StockPet. It is not a fork of anyone’s contracts. FrenPet minted a pixel pet, reset a 3-day time-of-death with shrooms paid in $FP, staked $FP for points with a 30-day linear unlock, ran PvP for a slice of the opponent’s points, and paid ETH from a 4% Uniswap v2 buy/sell tax. Claiming burned points and reset ATK/DEF.

What is kept, and what changes:

• Keep: the reload cadence, stake-to-play with a vest, point-share claims, claim reset, PvP steal, a halt state that ends in death.
• Drop: a transfer tax on the token, Uniswap v2, ETH-only rewards, burning the food.
• Add: ticker-bound machines, paper that is an official Stock Token deposited into the vault, Chainlink 24h return as the raid multiplier, and a v4 hook on a real $BRRR/WETH pool rather than a tax on transfers.

FrenPet had to block other pools because the tax lived on the token. $BRRR has no transfer tax. The fee lives on the hook attached to the canonical $BRRR/WETH pool, so the token stays a plain, composable ERC-20 that anyone can list anywhere.

$BRRR is a fixed-supply ERC-20 on Robinhood Chain: 1,000,000,000 tokens, 18 decimals, no transfer tax, no blacklist, no rebase, no mint function after deployment.

The sinks are commissioning extra presses, calibration (a temporary lock, not a burn), and unjamming a jammed press. Demand also comes from players who swap $BRRR into a Stock Token in order to load paper — which is a swap on the hooked pool, which pays the vault, which pays players.

Launch on Pons V2

$BRRR launches on the Pons V2 bonding curve, which is denominated in ETH and holds the entire supply. When the curve sells out, liquidity graduates into a permanently locked Uniswap v4 pool at the 4.2 ETH threshold. There is no team allocation carved out of the curve and no presale.

The canonical market is a Uniswap v4 pool, $BRRR/WETH, quoted in WETH. Robinhood Chain already runs the v4 PoolManager; official Stock Token liquidity sits in that same singleton. We do not bootstrap NVDA or QQQ pools — the router finds those and we piggyback on them.

We do not run our own hook. A Uniswap v4 pool has exactly one hook for its whole life, and the graduated pool is created by Pons with theirs. Fees reach us through Pons instead, in two streams:

• The creator tax, 4% of every trade. We set this at launch; Pons caps it at 10%. It is paid entirely to the fee recipient and never split with the protocol, and it applies on the bonding curve as well as the pool — so it earns from the first trade, months before the pool exists.
• A slice of Pons’s own pool hook. Their hook takes 1% of each swap, keeps 30% as protocol revenue, and earmarks 50% of the rest for a buyback. What is left, around 0.35% of volume, is credited to us.

Neither stream is pushed anywhere. Pons credits a shared escrow keyed by recipient, and the recipient has to pull. That is what FeeCollector is for, and why it is the one contract that absolutely must be able to make calls and receive ETH — an address that cannot do both watches the fees accrue and never touches them. Anyone can trigger the pull; no privileged party can sit on the fees.

What the collector pulls is split 70% to the player vault, 30% to the team. Nothing is earmarked for LPs — Pons already runs its own buyback out of its hook share. The team’s cut is capped in the contract at 30% and the setter refuses anything higher, so it can be lowered later but never raised.

In-app, loading paper when you do not already hold the Stock Token is one transaction: $BRRR to WETH on the hooked pool, then WETH to the ticker on the existing official pool, then deposit into the vault. If you already hold the Stock Token you skip the swap and deposit directly.

Later: a dynamic fee driven by the QQQ Chainlink feed, and hookData so afterSwap can load a press atomically. V1 uses a plain router and a multicall.

Presses are ERC-721s. The first one is free apart from gas. Further presses cost $BRRR on a quadratic curve: cost(n) = 100 × n², where n is how many presses you already own. The first mint is 0 $BRRR. After that the next mint costs 100 $BRRR at count 1, 400 at count 2, 1600 at count 4. The live curve is on the commissioning page.

At commission the press binds to one official Robinhood Stock Token ticker. That ticker is its DNA. Visually it decides the plate stamp and the drawing colours; mechanically it decides what counts as full-rate paper and what multiplier the press carries into a raid. It starts at 10 pressure, 10 plate, 0 notes, and a full 3-day paper load.

A press must be loaded at least every 3 days. A matching load — NVDA paper into an NVDA press — resets the timer to a full 3 days. The timer does not stack past its cap, so there is no point pre-loading a week of paper into one press.

Cross-ticker paper is allowed at 50% efficiency: it buys half the time extension, or takes twice the tokens for the same extension.

A meal costs $2.00 of the Stock Token, whichever ticker you are bound to. Not a fixed number of tokens — shares are priced per share, and a flat amount would make ten NVDA and ten HOOD buy the same three days for very different money. Every press would end up bound to whatever is cheapest that week, and the ticker, which is supposed to be the press’s identity, would collapse into an arbitrage.

The conversion happens once, at configuration, and the result is stored. It is deliberately not read from an oracle at feeding time: a raid with a dead feed degrades to even odds, but a feed with a dead feed reverts, and a press that cannot be fed jams, and a press that stays jammed is burned. That would turn an oracle outage into permanent loss of player assets. Prices drift instead, and the sizes get rebalanced.

Paper is not consumed. Official Stock Tokens are real-world-asset wrappers; burning them would destroy inventory for no game reason. Deposits go into the rewards vault. Loading is how the dividend basket grows, in equity, on top of the hook fees.

This is the part worth sitting with: every reload makes the vault bigger for everyone. Your press staying alive is a cost you pay and a dividend everyone else receives, which is exactly the tension that makes the clock matter.

Timer hits zero and the press jams. A jammed press is halted for 7 days: no printing, no raiding, no calibration. Its only legal action is being unjammed. Jammed presses also leak harder — a raider takes 1% of their notes instead of 0.5%.

Unjamming costs $BRRR, or a large Stock Token load. If the press is not unjammed before the jam window closes, it seizes: the NFT is burned, calibrated $BRRR is returned to the owner, and unclaimed notes are voided.

Calibration locks $BRRR against a press. The full amount unlocks linearly over 30 days and can be withdrawn as it vests. Nothing is confiscated and nothing is burned.

Calibrating grants notes, resets the paper timer the same way a load does, and raises pressure and plate. It is a temporary sink — a way to convert conviction into printing rate without touching supply permanently. Paper is the permanent sink into the vault; calibration is the soft one.

Notes are not a token. They do not transfer and they never trade. They are your share of the vault: your_notes / total_notes × vault. You earn them by loading paper, by calibrating, and — once raids are live — by winning raids.

Cashing out pays the current basket: the Stock Tokens that were loaded as paper, plus the hook fees converted into that basket. It burns your notes and resets pressure and plate to 10 / 10. That is the same tension FrenPet had — farm the share, or cash it in and start the climb again.

V1 is one shared basket, pro-rata across every press. Later, a press bound to a given ticker can take a bonus slice of that ticker’s pocket in the vault.

Phase 03. A press can raid every 30 minutes, targeting a press that has not been hit for 1 hour, capped at 32 raids per day.

Win chance is pressure / (pressure + target_plate). Both sides are first multiplied by that press’s ticker Chainlink 24h return. Green day, the press hits harder. Red day, it tanks. The winner takes up to 0.5% of the target’s notes, or 1% if the target is jammed.

This is FrenPet’s bonk read as a pair trade. The oracles are the per-asset Chainlink feeds already published for Robinhood Stock Tokens, so there is no new price authority to trust.

1. $BRRR on Pons V2, graduation into the locked v4 pool, hook attached. The site can go live with nothing on it but these docs. The vault starts filling.
2. Press NFT, loading with Stock Tokens, the jam clock, seizure, calibration, notes and claims.
3. Raids, with the Chainlink multipliers.
4. Daily wheel, sector runs, evolution past rev. 10, hookData swap-and-load, optional dynamic fee.

Defaults. Not on-chain until deploy. If a value here disagrees with a live contract, the contract wins and this page is wrong.

• Presses are game NFTs. They confer no legal or beneficial interest in the underlying equity. Robinhood Stock Tokens themselves are tokenised debt securities issued by RHJ, not the share, and are restricted in the US and other jurisdictions.
• The protocol fee only hits the hooked $BRRR/WETH pool. Volume on other pools does not fill the vault. That is intentional — the token stays composable — and it is a concentration risk if liquidity fragments.
• Claims dilute when total notes rise. Loading paper puts stock into the vault, and hook fees work the other way. A late claim on a growing basket can be worth less per note.
• Raid multipliers depend on Chainlink feeds for each Stock Token. A stale or halted feed weakens that press’s multiplier, and it is not equal to the press being dead.
• Official Stock Tokens must be identified by contract address. Feeding the wrong ERC-20 will not count and cannot be reverted.
• Seizure is a burn of the NFT. Calibrated $BRRR and unclaimed notes are handled as described above: the $BRRR comes back, the notes do not. The press is gone.
• The vault owner can drain the basket. RewardsVault.rescue and rescueAll move assets out with no reference to notes, cooldown or vote. The stated purpose is recovering a basket nobody will ever claim, and the contract cannot tell that case from any other. Your claim on the vault is only as good as the key that owns it.
• The fee collector owner can redirect fees. execute calls anything as the collector, and rescueAll pulls straight from Pons’s escrow. Both exist so the fees can never be bricked by an interface we guessed wrong — the same reach that prevents that also permits diverting the money.
• Both of the above are why the owner addresses matter more than the code. Check what they are, and whether they are a multisig or one key on a laptop, before sizing a position.
• Parameters can change until the contracts are deployed and, if applicable, ownership is renounced or behind a timelock. Read the contract section when addresses go live.
• Launch mechanics are Pons’s, not ours. The bonding curve, the 4.2 ETH graduation threshold and the lock on the graduated pool are theirs. Read their docs too.

Nothing is deployed. The addresses below that are live belong to chain infrastructure, not to BRRR, and are listed so you can verify what we are building on.

Back to the home page.