chapters· What is GlueHook
01 · Getting started

What is GlueHook

One hook, a pot per pool, buybacks and sell defense powered by the traffic itself.

Hook is a free, open-source Uniswap V4 hook that gives any pool an automatic buyback machine and self-compounding liquidity — running fully on-chain, inside the trades themselves. No price oracles. No keeper bots. No admin keys. One contract, at the same address on 23 networks.

0%
protocol fee
23
networks, 1 address
0
oracles & keepers
0
keys over the hook

Four things, one contract

One pool, one pot, two mechanics

Every pool that adopts the hook gets a pot: a permissionless war chest denominated in the pool's buyback currency. Anyone can fuel it — the token team, a protocol treasury, a community member, another contract. The pot spends itself through two mechanics, both triggered by ordinary traders doing what they came to do:

pump — on buys
someone buys the token
the pot buys MORE in the same tx
bought tokens → recipient or burn

buyers amplify the up-move — sized so it can never be sandwiched.

shield — on sells
someone sells the token
the pot absorbs it at the pool's exact price
the pool's price does not move

sellers get exactly what the pool would have paid — supply never hits the curve.

Plus the thing V3 and V4 never had: compounding

Concentrated-liquidity pools park trading fees outside the position — they sit idle until someone pays gas to collect and re-mint them. Each hooked pool can run one LP program: a hook-held position whose fees are harvested automatically inside swaps and split by rules you choose — a share re-mints itself as deeper liquidity, a share fuels the pot, a share burns, and the rest pays whoever you name.

the core idea

Every activation is a real market participant paying their own gas to move in the direction the pot amplifies. The machine needs no privileged actor — only traffic.

Swaps are never stopped — no matter your settings

Every mechanic in the hook is a passenger on somebody's trade, and a passenger never gets to crash the ride. A bad configuration, a hostile recipient, a token with a broken burn function — none of it can revert, delay or brick a swap:

surfacewhat happens instead of a revert
the pumpruns in a try/catch self-call — a state that would revert the buyback skips the pump, the buyer's swap lands untouched
the shieldquotes zeros when the pot is empty, unconfigured, or a leg rounds to nothing — the sell simply executes through the pool as normal
auto-harvestruns under a hard gas budget; a heavy run reverts atomically inside its own frame, fees stay pending, the swap completes
deliveries & payoutsa refused transfer parks or is booked as owed — retryable and claimable later, never blocking the carrying trade
the worst a bad setting can do

Waste its own opportunity. Misconfigure every share and recipient you have and the pool still trades exactly like a vanilla Uniswap pool — the machine degrades to a no-op, never to a roadblock. The complete failure-mode inventory is a chapter of its own: Trading never stops.

The life of a hooked pool

launchPool — pool + pot + seeded LP program, ONE transaction
donate — anyone fuels the pot, any time
trade — every buy pumps, every sell is shielded
harvest — fees split & compound automatically inside swaps
surrender (optional) — lock the LP or freeze the rules forever· trustless endgame

Pick your path

FAQ

Is GlueHook a token or a protocol with fees?+

Neither. It is a single immutable contract with zero protocol fee, no token, no owner and no upgrade path. The only fee anywhere is the pool's own Uniswap LP fee, which goes to liquidity providers as always.

Do I have to use every feature?+

No. A pool can run just the pot (buybacks only), just the LP program (compounding only), both, or neither side armed — every rule is opt-in and most can be changed later by the roles that own them.

Who can trigger the machine?+

Nobody has to. The pump and the shield fire inside ordinary swaps; the auto-harvest fires inside ordinary swaps once fees pass your minimums. Manual entries (harvest, flushDirect, claim) exist as permissionless or role-gated fallbacks.

FAQ

Do I need to change my token to use GlueHook?+

No. Any standard ERC20 (or the chain's native coin) works as-is — the machine lives in the pool, not in your token. You launch a Uniswap V4 pool with the hook attached and everything else stays untouched.

Does GlueHook take a fee?+

No. Zero protocol fee, on everything, forever — there isn't even a fee switch to flip. The only fee in the system is the pool's own Uniswap LP fee, which you chose at launch and which pays liquidity providers.

Is this a token? Is there something to buy?+

No token, no points, nothing to buy. GlueHook is a free piece of infrastructure: one immutable contract at the same address on every supported network.

Can a trader tell the difference on a hooked pool?+

Buys and sells route exactly like any V4 pool — same interfaces, same aggregators. The difference is what happens inside the swap: buys can trigger a buyback, sells can be absorbed by the pot, and neither adds a step for the trader.

What do I actually have to trust?+

Only the immutable code. There is no admin key over funds, no oracle, no upgradeability, no pause switch. The pot can only be spent buying or defending its own pool, and every rule you set is enforced on-chain.