Owned roots
Use Hookr's hook with a saved hook of your own, or deploy a Hookr hook at an address of your own.
On this page
Deploying a new hook of your own is paused in the app until own hooks take every Hook Block Hookr's hook takes; hooks already deployed keep working.
Your blocks run on one of two hooks: Hookr's shared hook, or a hook of your own that you deploy from a saved hook. Either one opens pools for a new token, or new pools for a token that already exists.
- Use Hookr's hookThe shared root, with nothing to deploy.
- Cost
- Gas only
- Blocks
- Any, or the set a saved hook names
- Opens pools
- Anyone
- Tokens
- New, or one that already exists
- Deploy your own hookAn unmodified Hookr root at an address of your own.
- Cost
- Gas only, no Hookr fee to deploy
- Blocks
- The set its saved hook names, fixed at deploy
- Opens pools
- Everyone, or you alone
- Tokens
- New, or one that already exists
- Owned root deploy fee
What a saved hook does
A saved hook is a named set of blocks on Hookr's shared root: the features its pools may use, their caps, up to 4 add-ons and 4 gates, and whether its pools may carry arbitrage recapture. Writing one costs gas only.
- A pool joins a saved hook when it names it at launch and its terms fit inside it.
- The saved hook's writer lists the pool, or anyone does for a public saved hook.
- The book of saved hooks holds no assets, and nothing on a swap reads it.
What your own hook does
In the Builder you build it on the same board as a hook on Hookr's shared hook, then Deploy your own hook saves the board and deploys it with one button; the wallet asks twice, once to save and once to deploy.
- It is an unmodified Hookr root at an address of your own, made from a saved hook and registered in the same transaction.
- The deploy fee at launch was 0 ETH; read the current fee in the terms above before signing. Hookr's treasury can raise it, to at most 1 ETH, and a change reaches only hooks deployed after it.
- It opens pools for everyone, or for its owner alone.
- Its owner can pause new pools on it, and hands the role on in two steps.
- Its pools run their own copy of the core blocks, deployed with the root, which pays Hookr's treasury at least its share floor, the same as on the shared hook.
- On Robinhood Chain a hook from HookrOwnedRootFactoryV2 copies Hookr's combined core, so its pools take the core Hook Blocks a pool on the shared hook takes, each one the hook allowed at deploy: Swap Cut, Storm Fee, Wallet Cap, a Buy/Sell Block, Sandwich Guard and King of the Pool. Exit Clock and Holder Pot are closed on the core it copies, and there Sandwich Guard and arbitrage recapture do not share a pool.
- The factory has no cap on roots, and lists every one.
Arbitrage recapture is on for your hook's pools, as on every new pool. It stays off only if the saved hook does not allow it or you switch it off at deploy, and then it can never open on that hook.
Read which with laneSource() on your hook: the shared hook's address means on while Hookr's lane is open, zero means off. A pool opened without arbitrage recapture keeps none, since a pool fixes its terms when it opens.
- Your hook's pools follow the executor Hookr's lane has open and move to a later one at the same or a lower share; at a higher share they run no arbitrage recapture.
- Opening an executor takes the registry's owner, a Safe, and 30 minutes, and it can refuse any outer swap; pools on Hookr's shared hook keep the one they opened with.
- One arbitrage recapture can trade across your hook's pools, another creator's included on a public hook, paying each pool's base fee and what its add-on asks, except a buy during a launch guard, which pays every block.
- The arbitrage recapture's profit is split under the pool whose swap opened it.
Who opens pools on your hook
HookrLauncher opens a pool on your hook only for a caller the registry's rootOpenFor(hook, caller) answers true for. You choose at deploy which callers that is.
- Owner-only. Only the hook's owner opens pools on it. A launchpad names its own wallet or contract as the owner, so its users open pools through the launchpad.
- Public. Anyone opens pools on it. A public hook must allow Anti-Snipe, dynamic fees, LP Rewards and the creator royalty, a
ruleMaskthat includes27; only Auto Burn may be left out. A public deploy that leaves out more revertsSoftMaskNeedsOwnerOnly; that hook deploys owner-only. - Paused. While its owner pauses it (
setPaused(hook, true)on the factory), it opens no new pools for anyone. Pools already open keep trading.
A launch the registry refuses reverts InvalidFamily() before anything moves.
Accepting ownership
The owner you name at deploy holds the role at once only when it is the wallet that deploys. Any other owner, such as your launchpad's contract, is only the pending owner until it calls acceptRootOwnership(hook) on the factory. Until then the hook has no owner: an owner-only hook opens no pools for anyone, and nobody can pause it or hand it on. pendingRootOwner(hook) reads who may accept.
Handing the role on later takes the same two steps: the owner calls transferRootOwnership(hook, next), and next calls acceptRootOwnership(hook).