EDUCATIONAL EXAMPLE

Surge Fee Hook

Explore swap & fees behavior as a transparent hook primitive.

1ACTIVE CALLBACKS

OVERVIEW

An educational swap & fees registry example mapped to the Uniswap v4 callback lifecycle.

HOOK DNA

Callback permissions

Lifecycle

beforeInitialize○ INACTIVE

afterInitialize○ INACTIVE

beforeAddLiquidity○ INACTIVE

afterAddLiquidity○ INACTIVE

beforeRemoveLiquidity○ INACTIVE

afterRemoveLiquidity○ INACTIVE

beforeSwap● ACTIVE

afterSwap○ INACTIVE

beforeDonate○ INACTIVE

afterDonate○ INACTIVE

Advanced accounting

beforeSwapReturnDelta○ INACTIVE

afterSwapReturnDelta○ INACTIVE

afterAddLiquidityReturnDelta○ INACTIVE

afterRemoveLiquidityReturnDelta○ INACTIVE

MECHANISM

Read the control surface.

POOL ACTION↓beforeSwap↓SWAP & FEES POLICY↓POOLMANAGER ACCOUNTING

SOLIDITY

No source attached

This educational registry entry does not claim a Solidity implementation. Submit verified original source through the contribution flow.

DEVELOPMENT STATUS

Evidence, not implication.

concept● PASS

reference Code○ NOT VERIFIED

compile○ NOT VERIFIED

unit Tests○ NOT VERIFIED

fuzz Tests○ NOT VERIFIED

invariant Tests○ NOT VERIFIED

fork Tested○ NOT VERIFIED

external Audit○ NOT VERIFIED

testnet Deployment○ NOT VERIFIED

mainnet Deployment○ NOT VERIFIED

DEPLOYMENTS

Onchain records

NO MAINNET DEPLOYMENT. No testnet deployment metadata has been exported.

SECURITY

Trust no badge blindly.

A compiled contract is not necessarily safe. Tests are not an audit. A verified source can still contain exploitable logic.

Review permission bits and constructor configuration.
Model custom accounting and rounding independently.
Require fork, testnet, independent review, and audit evidence before real assets.

CHANGELOG

Reference history

2026-08-14 — Initial HookHood registry entry. No deployed revisions recorded.