Integrating the Hookr app
Read how hookr.fun itself reads the deployment record, which writes are actually wired up, and what another interface should copy.
On this page
What hookr.fun itself does to drive the contracts, written down because an interface built on the same contracts has the same problems to solve. The contracts remain the authority; where this page and a contract disagree, the contract wins.
The Contracts an Interface Touches
| Role | Contract | What it is needed for |
|---|---|---|
| Root hook | HookrRoot | the hooks field of every PoolKey, and laneOf(id) for the lane's gas floor |
| Launcher | HookrLauncher | a token launch, or pools for an existing token: a family of 1 to 8 pools, one per quote asset |
| Router | HookrRouter | single-pool swaps that carry the payer to the root, settle exact amounts and return unused ETH |
| Quoter | HookrQuoter | quote and quoteDetailed for a HookrRouter swap, and quoteExactInputSingle / quote in V4Quoter's shape for the Universal Router |
| Core module | HookrRules | a pool's Anti-Snipe, dynamic fee, Auto Burn, LP Rewards and royalty settings, and its fee and refund claims |
| Registry | HookrRegistry | reads only: launchers, roots, admitted Hook Blocks, quote assets and the arb recapture lane |
Swaps can also go through the Universal Router with empty hookData; Swapping and quoting has both paths and their approvals.
Where Addresses and ABIs Come From
The app never types an address into a component. It reads the release book it ships, and every address on this documentation site renders from the same book:
Hookr’s contracts
The table lists Hookr’s 35 core contracts, rendered from the hookr-1 release book the app ships, source commit 412960b37a631ce145d49fb4a1887f04a4d1fa74, in deployment order.
Each one’s source is verified on RobinScan, on Sourcify as an exact match and on Blockscout as a full match. The arb recapture table below repeats HookrLane and adds What The Hook’s executor and the whole-pot King of the Pool contracts, and the Wallet Cap table adds Wallet Cap’s core and its module. None of the contracts they add is in the release book.
Arb recapture
The registry opened the lane on HookrRoot on 2026-10-07. The executor is What The Hook’s contract, not Hookr’s. King of the Pool is live on ETH/HOOKR (0xd7cc047d…bc99), on the whole-pot Rules: each arb profit splits What The Hook 25% · Hookr 25% · Pot 50%, with nothing to traders or LPs, and the round’s winner takes the whole pot.
| Contract | Address |
|---|---|
| HookrLane, the arb recapture lane on HookrRoot | 0x9A8a1006469BA196f8FEfc017a53505C83A060BB |
| What The Hook's arb recapture executor, 25% of each arb recapture's profit | 0x4B4c16681401454140a9dBca55e5c186BBE8D728 |
| HookrRules, King of the Pool whole-pot Rules | 0x10f684361b35c8411a2c07f68a6fb1f4b7e555f7 |
| HookrRecapture, the whole-pot Rules' module | 0x60efc4a41498e9433be2155b6cc1677aec31d649 |
Wallet Cap
Wallet Cap runs on a core of its own: the whole-pot core with a cap on each wallet’s buys while a pool’s launch guard lasts. Hookr’s hook admits it, and a Wallet Cap pool’s claims are made on it.
| Contract | Address |
|---|---|
| HookrRulesWalletCap, Wallet Cap's core | 0xb67b73e28c522a3aac438be970bf94976deee52a |
| HookrRecapture, the module of Wallet Cap's core | 0xbbc43dc2f01f5e7882cacd78ef094a44ef0e4d23 |
Before it offers a write, hookr.fun reads the release manifest from chain, readReleaseManifest(client, HOOKR_1) in hookr-sdk, which refuses any contract whose code is not the code the release deployed. A release that does not read hides the write surfaces rather than sending a transaction the release cannot take.
Vocabulary Not to Blur
- Subject. The token the Hook Blocks act on. A buy is quote to subject.
- Quote. What the pool is priced in. LP Rewards, the royalty and Hookr's share are paid in the quote.
- Arb recapture. Profit from the arb a swap opens, recaptured by the lane's executor. It is paid out of that profit, never out of a trade, so it is never a swap fee.
Reads Before a Write
- The release manifest, as above, before showing any launch or swap control.
- The pool's frozen Hook Blocks, read from the pool, before quoting or offering a liquidity mint. A pool's terms never change after launch.
laneOf(id)on the root before a swap on a pool with arb recapture on, for the lane's gas floor.- A quote of the exact path the swap takes, close to execution.
Separating Accrued From Collected
What a pool owes and what reached an address are two numbers. A view shows claimable and claimed apart and never sums them; presenting the first as revenue received overstates it.