Hook launchpad docs

Release manifest gate

One versioned manifest supplies every read address and every browser-write and agent release gate. Opening writes requires a deployment newer than the read-only slots already on chain, four nonzero address/runtime-hash pairs, the bounded Hookr router, a reviewed source commit, and one block shared by the fork and linkage readback.

The ordered deployment evidence is launchpad, hook, router, setHook, then all five hook-registry receipts. The canary evidence is live launches on every lane (instant, auction, and $HOOKR-paired) plus a real flywheel buyback burn, each backed by its own receipt: the instant launch and a bounded-router buy against it, one full auction cycle (auction launch, bid, migration, bidder exit, token claim, and proceeds claim), the $HOOKR-quoted launch with its router approval and buy on the pair, and the flywheel's fee collection and buyback burn. Every receipt is required; a production boolean alone cannot open writes.

No machine blockers: every gate condition above is satisfied by the checked-in manifest.

1 · Choose a launch path

Every path mints a fixed supply of 1,000,000,000 tokens with no owner, mint function, pause, blacklist or transfer tax. The creator receives no token allocation. What changes is how the first market and its opening price are formed.

Instant pool. Zero-seed: the launch transaction takes no ETH from the creator (no seed, no dev-buy folded in) and the entire supply is placed as one locked, launchpad-owned sell position. The Uniswap v4 pool opens at a fixed platform-wide valuation of 2.5 ETH FDV, the same for every launch; nobody picks the price. Buyers supply all the ETH, and the first buys move the price up from that fixed opening. Anyone can swap as soon as the launch transaction lands. Four of the five hook blocks work here; the LP Rewards block is structurally unavailable on this lane because a zero-seed pool has no in-range liquidity providers at open to receive its donation.

Auction launch. The creator reserves a disclosed 20–50% of supply to seed the pool and the rest is sold through Uniswap's deployed Continuous Clearing Auction. A bidder sets a budget and maximum price; fills spread across the window, each block clears at one price, and that price can rise as demand arrives. Two terms are public before anyone bids: the floor FDV, the starting valuation (product default 0.22ETH), and the graduation threshold (the contract's raise floor), the minimum successful raise (product default 1.1 ETH). Ending below that threshold fails the launch: every bid is refunded, the supply is burned, and no pool opens. All five hook blocks work on this ETH-quoted lane.

Quote currency.Both lanes quote in ETH by default, and a launch can pair with $HOOKR instead. A $HOOKR-paired instant launch opens at a fixed 2,500,000 $HOOKR FDV, and the auction's product terms are a 600,000 $HOOKR floor FDV and a 3,000,000 $HOOKR graduation threshold. $HOOKR pairs support the Anti-Snipe guard and Surge Fees blocks only: the Auto Burn, LP Rewards and Nth-buy Pot blocks account in native ETH end to end, so on a $HOOKR pair they are refused at launch rather than approximated. A $HOOKR-paired launch pays no protocol fee anywhere: 100% of the quote-side fees it collects route to the creator, and the token side of every collection is burned, as on every launch.

Retained curve generations. Legacy releases, every generation before V1, sold through a stepped bonding curve: ten tranches, each priced 70% above the one before it, graduating into their pool when the last tranche sold out. Those tokens remain readable and tradable under their own launch contracts; V1 simply no longer offers the curve for new launches. Hookr names public releases Legacy, V1, and V2 for the separate modular system, never the internal generation number.

Active release capability: fixed-price instant pool and auction launch. The launcher also verifies the instant preview against the deployed launchpad before it enables signing.

2 · Auction settlement and pool opening

An auction launch graduates by total raised, not by tranches. When the window ends at or above the disclosed graduation threshold, anyone can trigger migration (settlement is permissionless), and the pool opens at the auction's final clearing price, with the creator's hook attached and a dynamic fee. The reserved supply and the share of the raise it absorbs become a full-range Uniswap v4 position owned by the launchpad contract, which has no function to remove liquidity: the liquidity is locked by construction, not by promise. At the 50% reserve the reserved tokens are worth the whole raise at the clearing price, so all of it locks as liquidity and the creator is paid nothing; at a smaller reserve the un-locked balance is paid to the creator as the proceeds the launch disclosed before anyone bid. Any supply the position cannot absorb is burned. Trading fees earned by the position can be collected by anyone; the ETH side splits between creator and protocol and the token side is burned.

An auction that ends below its graduation threshold fails instead: every bid is refunded through the auction, the token supply is burned, and no pool ever opens. An instant launch has nothing to settle: its pool is live in the launch transaction itself.

For tokens launched under retained curve generations, graduation stays what it was: when the last curve tranche sold out, the ETH raised and the remaining supply became a full-range position at exactly the price the curve ended on. That description remains true for those tokens forever.

3 · Fee defaults and locked liquidity

A published hook carries swap rules only. The current V1 launcher pre-sets fee routing, while the selected launch path determines liquidity placement. Auction reserve and graduation terms remain public before bidding.

Fees. V1 has no curve fee. The current launcher submits creatorFeeBps = 0 and feeRecipients = []; zero activates the contract default. On an ETH pair, the collected quote-side position fees remaining after any guard withholding split 50% to the creator and 50% to the protocol; the creator side credits the launching wallet. The token side is burned. This is current launcher policy, not a universal restriction in the V1 contract ABI. On retained earlier generations, token pages continue to show the fee routing stored for that launch. Separately, every eligible ETH-pair swap pays the flat 0.3% flywheel protocol fee. Anyone may collect that ETH into the burner; only its owner may spend it on a buyback, capped per call and once per block with a reviewed minimum $HOOKR output. The buy routes through the canonical ETH/$HOOKR pool and burns every token bought in the same transaction. A $HOOKR pair pays no protocol fee and routes the full collected quote side to the creator.

Liquidity. On the instant lane the whole supply is the liquidity: one locked, launchpad-owned token-only sell position opened at the fixed valuation, and fee collection pokes that position. On the auction lane the reserved supply and the raise it absorbs become one locked full-range position at the clearing price, and any supply the position cannot absorb is burned. Neither lane has a function that removes the position.

4 · The five hook blocks

• Anti-Snipe. For a set number of blocks after the pool opens, buys are capped and pay an extra LP fee. The cap is based on total supply on both lanes, and on an auction launch the guard starts at migration. Those blocks are counted on the parent chain (~12 s each), not this chain’s ~0.1 s blocks. Exact-output buys are blocked during the window so the cap cannot be routed around.
• Surge Fees.The LP fee scales with how much of the pool's in-range depth a trade consumes, from your base fee up to your ceiling. No oracle involved.
• Auto Burn. A configured share of actual exact-input buy token output goes directly to the dead address. There is no ETH vault, keeper or separate market buy. New $HOOKR-paired launches cannot use this native-ETH block.
• LP Rewards. An ETH-side share of an exact-input buy is donated to in-range liquidity providers inside that swap. New launches can use it on the ETH-quoted auction lane only: the zero-seed instant lane has no in-range LP at open, and $HOOKR pairs refuse native-ETH cut blocks.
• Nth-buy Pot. An ETH-side share fills a deterministic pot. A public counter advances at most once per pool per block, and the Nth qualifying slot wins. A minimum buy applies. Qualifying swaps must canonically bind a nonzero recipient, the production router supplies that binding automatically, and claimants can redirect payout. A funded pot remains claim-backed for the next scheduled winner; there is no permissionless flush. New $HOOKR-paired launches cannot use this native-ETH block.

Reading the market figures

Market figures do not all share one source. Hookr launch activity and 24-hour launch summaries use indexed settled trades. Pooled charts, volume, and TVL, including Hookr pools, use live third-party market data. Each figure should be read with its displayed source and window.

• Windows stay source-specific. Hookr-indexed launch history uses settled timestamps and clamps a window to the readable lifetime of a launch. Pooled 24-hour fields use the live third-party provider's trailing window.
• Volume stays pool- and source-specific. Hookr-indexed launch volume counts the quote-currency leg of settled Hookr trades. Pooled volume is the provider's pool trading volume for its stated window. Provider TVL is the pool's current reserve estimate, not the token's market cap. ETH and HOOKR values are never converted or added together.
• Sorting uses available pool fields. Discover can sort by trailing 24-hour volume or TVL when the source provides those values. Missing data stays unavailable and sorts last; it is not replaced with zero or inferred from another market.
• Change follows the named source.Hookr-indexed launch change compares settled Hookr trades. Pooled change uses the provider's stated window. A missing change remains unavailable.
• Unavailable is not zero. A missing value can mean no trades in the window, a failed read, or an unresolved source window. The interface does not replace it with an estimate.

What Hookr does not claim

• Nothing here is independently audited. The contracts are deployed and were exercised end to end by a canary launch before writes opened. Tests, readable source, and canary receipts are release evidence: they are not an audit, and no third party has reviewed this code.
• The Nth-buy Pot is not random. The public potBuyCountdetermines the next slot, so expect it to be raced. The one-advance-per-block rule stops a single atomic call from manufacturing every remaining slot; it does not make the outcome fair or private.
• No fairness, anti-bot or anti-MEV guarantee. The anti-snipe block caps per-swap size for a window; it does not identify people and cannot stop someone using many wallets.
• No punitive exit taxes.Hook-block fee cuts apply to exact-input buys only, and the guard's size cap and snipe tax never apply to a sell. On an ETH-paired V1 pool the flat 0.3% protocol fee applies to buys and sells alike (the same fee in both directions, not an exit penalty), and an exact-output sell is exempt by construction rather than charged in tokens. Auto Burn is an output-token share; LP/pot shares are ETH-side.
• Routing is release-pinned. Live-pool trades route only through the bounded Hookr router pinned in the release manifest by address and runtime hash; it enforces minimum output, deadline, and recipient on-chain.
• Rules are immutable after the pool opens. An instant pool opens in its launch transaction, a successful auction launch opens through migration, and a retained curve launch opens after its last tranche. In every case, the hook cannot be edited or replaced on that live pool; changing rules means launching a new token.

Current live contracts · Robinhood Chain 4663