LFG

TopBlast

How the TopBlast vault pays holders who are down versus their entry, on Robinhood Chain and on Solana.

TopBlast is a drawdown vault. The share of the trade tax assigned to TopBlast accumulates there, and the vault pays holders who are down versus their recorded entry price. The payout scales with how far down they are and is capped at their actual loss. Everyone trades on the same curve, with the same tax. On a token with TopBlast on, the keeper sends the payout to the holder's wallet.

This page describes that payout. The fee split that fills the vault is in Fee Structure on Robinhood Chain and in Solana (Raydium LaunchLab) on Solana. Holder rewards, the mode an idle TopBlast vault can roll into, are in Holder Share, Buy & Burn, and Creator Fees.

Robinhood Chain, on the curve

On Robinhood Chain the vault is held in the curve's quote asset. While the token is on its bonding curve, a buy through the router records the position. The entry price is the size-weighted average of those buys: each new buy blends its execution price in by size. The router's sell path updates the committed price and leaves the entry unchanged. A buy that skips the router gets no entry. The dev buy in the launch transaction is recorded before the router is sealed as the only writer of entries and prices. After that seal, the creator cannot rewrite either book.

Drawdown is measured against the engine's committed price. The first price printed in a block is staged, and it becomes the committed price on a later block. A claim in the print's own block still uses the previous committed price.

The payout is the smaller of two numbers. One is the holder's slice of the vault: vault balance times the drawdown, scaled by the share of the recorded position they still hold. That slice is also capped at their share of circulating supply. The other is their actual loss on the tokens they still hold. The size that counts is the minimum of their balance and their recorded position. Sell part of the position and the payout scales down. Sell all of it and the position is no longer eligible. After a payout the recorded size shrinks to the tokens still held and the entry resets to the committed price, so the same drawdown cannot be paid twice.

The keeper pays this on its 15-minute run. Anyone can trigger a payout for a holder, with claimTopBlastPayout or claimTopBlastPayoutFor, and the quote is sent to that holder.

Robinhood Chain, after graduation

After the curve graduates into its Uniswap v4 pool, TopBlast and holder rewards keep running. The pool uses the Pons Uniswap v4 hook. LFG has no Uniswap v4 hook of its own. Quote the engine receives is split the same way as on the curve. The keeper runs every 15 minutes: it re-syncs holder balances, checkpoints TopBlast, pays both modes, and records a price observation at the end of the run. A separate price job runs every 10 minutes. The engine accepts at most one observation every 10 minutes.

Lots and the guarded entry price

The keeper, or anyone, checkpoints balance increases with checkpointTopBlast. Each increase becomes its own lot at a guarded entry price: the lower of the reference price and a 30-minute TWAP. The engine cannot see where the tokens came from, so a transfer in is checkpointed the same way as a buy. A lot counts after a 48-hour hold, measured from the checkpoint. Up to four lots can be waiting. A further increase folds into the newest lot, and only that lot's 48-hour clock starts over.

The first checkpoint after graduation takes the entry recorded on the curve, up to the tokens the wallet still holds, and those tokens count immediately. A balance above that curve entry starts a new lot and waits 48 hours. A decrease comes off the newest lot first, then older lots, then the tokens that have already finished the hold, so a buy and a sell inside the 48 hours cancel.

The reference price is guarded. One observation can move it by at most 5%. It is usable after two observations that were not clamped, from a later block than the one that wrote it, and only while the pool's spot price is within 3% of it. When that price is not ready, checkpointTopBlast reverts and a payout pays nothing. Raw spot is never the entry price and never the price drawdown is measured against.

What a payout pays

Drawdown is measured against the higher of the reference price and a 2-hour TWAP. Nothing is paid at a drawdown of 10% or less. Drawdown above 50% counts only up to 50%. The counted drawdown is that band: min(drawdown, 50%) − 10%. Eligible size is the tokens that have finished the 48-hour hold, capped by the balance the wallet still holds. A position smaller than 0.01% of circulating supply is skipped.

Each day the vault pays at most the lesser of 20% of the vault and 0.5% of the pool's quote-side depth. Depth is the smallest quote-side depth across the recent price observations and the current block. Nothing is paid while that depth is under 10% of the vault. The day's budget is fixed the first time a claim quote is kept that day. The keeper's batch quote is kept even when it pays nothing. A claim that reverts leaves the budget unset. Payouts are pro rata by eligible size times counted drawdown:

post-graduation payouttext
counted  = min(drawdown, 50%) - 10%
budget   = min(20% of the vault, 0.5% of quote-side depth)
payout   = budget × (eligible / circulating supply) × counted / 40%

The result is then capped at the holder's actual loss on the eligible tokens, at 10% of the value of those tokens for the day, at the budget still left that day, and at the vault. After a payout the matured entry resets to the price just used, so the same drawdown cannot be paid twice. The quote is sent to the holder. The keeper pays with claimTopBlastPayoutForMany. Anyone can call that, or claimTopBlastPayout for one holder.

An idle vault rolls into holder rewards

If no payout of at least 0.1% of the vault happens for 30 days, anyone can call flushTopBlast and move the whole vault into holder rewards. A smaller payout does not restart the clock. The 30 days run from the later of graduation, the last payout that met that size, and the last flush. Holder rewards keep running on the same keeper pass: a wallet whose balance rose, including a buy on the Uniswap v4 pool, is re-synced, and the new tokens start earning on the next block.

On Solana

On Solana, TopBlast is opt-in. It is on when the creator gives it a weight at launch. The creator can turn it off later. The reserve already set aside is burned as buyback on a later fee settlement, once the fee account covers it, and holders are not paid from it. The idea matches Robinhood Chain: pay holders who are underwater versus their entry, capped at their actual loss. The books are the keeper's, and the payout is the token itself.

The vault is funded from the Token-2022 transfer fee. The keeper runs every 15 minutes and pays eligible holders automatically. Entry is a weighted average of the wallet's buys, rebuilt from that wallet's on-chain buy history. A holder is eligible when they still hold, the position is underwater versus that entry, and the vault has a balance. The size that counts is the minimum of their balance and their recorded position. The payout scales with the drawdown, and it is capped at their actual loss, converted into tokens at the current price, and at their share of the vault. After a payout the entry price resets to the price just used, so the same drawdown is not paid again.

Curve vaults, pool vaults, other program accounts, the burn address, and the protocol wallets are left out.

Warning

TopBlast pays only from its own vault. It mints nothing, and it does not pull from holder rewards or buy & burn. A large position can take a large share of what is paid that day, and that amount is still capped at the holder's actual loss. Payouts depend on what the vault holds.