How it works
The whole machine in one page: what a hook is here, how launches move through the curve, and where every cut of every buy goes.
The lifecycle
- 01Compose
Stack up to five blocks in the builder. Parameters lock at launch time, so the builder shows the composed buy cost before anything signs.
- 02Publish
Save the stack to the onchain registry as a blueprint. Publication stamps your address as author and fixes the royalty you chose.
- 03Launch
Anyone picks a blueprint and launches a fixed-supply token behind it: instant pool, or ten-tranche bonding curve.
- 04Graduate
When the last tranche sells, the same transaction opens the v4 pool, attaches the hook, and locks the LP position in the launchpad. There is no removal function to call, ever.
- 05Trade
Every swap runs through the hook's blocks on the pool's own callbacks. No keeper, no oracle, no admin.
Block reference
For a set number of parent-chain blocks after the pool opens, every buy is capped to a share of supply and pays an extra LP fee. Snipers either wait out the window or fund the LPs they tried to front-run. The window length, cap and tax are fixed at launch.
The swap fee is recomputed inside beforeSwap from the trade's share of pool depth: small trades pay the base tier, tank-sized trades pay the surge tier. Whales fund the pool they drain; the slope is a launch parameter, not a lever anyone holds.
On every exact-input buy, the hook forwards a fixed share of the tokens actually received to 0x…dEaD. It burns output, not intent: what dies is what really traded. Burn never accrues ETH, so a burn-only stack cannot fund an author royalty.
A cut of every buy's ETH leg is donated to the pool's in-range liquidity positions on top of the ordinary fee. Liquidity that shows up early and stays in range earns the stream; out-of-range positions earn nothing.
Each qualifying buy adds an ETH cut to the pot and advances a public counter, at most once per pool per block. When the counter hits the advertised N, that buy's recipient claims the pot. No randomness, no keeper: arithmetic anyone can recompute from the chain.
Cuts land on exact-input buys only. Sells and exact-output buys pay the LP fee and nothing else. That asymmetry is deliberate: the blocks shape entry pressure without taxing exits.
Royalties
A blueprint author earns a share of the eligible ETH hook fees of every launch that runs their stack. Eligible means the ETH-side cuts: the LP stream and the pot cut. Auto Burn destroys token output and never accrues ETH, so a burn-only stack cannot fund a royalty and publishes at 0%. The cap is 10%, enforced by the registry contract, and the rate is fixed at publication so launchers always know the price of borrowing a stack.
Pot arithmetic
The Nth-buy pot is deterministic. A public counter advances at most 1 step per pool per block; when it reaches the advertised N, that buy's recipient claims the pot. A minimum buy of 0.004 ETH qualifies, every qualifying buy must bind a canonical nonzero recipient (the production router supplies one automatically), and a funded pot stays claim-backed for the next scheduled winner. There is no randomness to audit because there is no randomness at all: recompute the counter from the chain and you have the winner.
The curve
A curve launch sells 62% of the fixed 1B supply across 10 tranches, each priced 70% above the one before it. Buyers on tranche one pay the floor; buyers on tranche ten pay roughly 200× the floor, and know it going in. Selling out the final tranche triggers graduation: the raised ETH and remaining supply open the v4 pool, the hook attaches, and the LP position locks, all in the transaction that cleared the last tranche. A launch that never sells out simply keeps trading on the curve; nothing expires.
Leveraged hooks
The first power-up beyond the five blocks: markets that extend credit out of their own liquidity, spot and leverage on one balance sheet. The factory, hook and router contracts are live on Robinhood Chain 4663 with receipts pinned, and opening a market is permissionless. The bonded module marketplace they are designed to arrive through, third parties publishing power-ups behind $OZYCAH bonds, is a labeled design. Leverage can take everything you post as equity. Not financial advice.
Reading the registry
Everything the site shows is a view over public contract state. The typed client wraps the reads:
import { OzycaheRegistry } from "@ozycahe-hooks/sdk";
const registry = new OzycaheRegistry({ chainId: 4663 });
const bp = await registry.blueprint("BP-0031");
// { author, blocks, royaltyPct, launches, feesRouted }
const launch = await registry.launch("0x5eaf…");
// { blueprint, status, tranche, potBalance, params }
// verify an advertised buy overhead yourself:
const quote = await registry.quoteBuy("0x5eaf…", { ethIn: "0.1" });The quote call runs the same composition the contract runs, as a view function, so third parties can verify any advertised number.