univ4-hooks

The aeon.fun Uniswap v4 hook fleet: 12 hooks deployed on Base (8453), Robinhood Chain (4663), Ethereum (1), and Monad (143). Most inherit a mandatory 10 bps protocol fee (AeonFee); the two beforeSwap-only window gates (DailyWindowGate, MarketHoursGate) were deployed as pure gates and take no fee.

Hooks

Hook	What it does
AeonFee	Base: mandatory non-virtual 10 bps fee on the unspecified currency, routed to a fixed treasury. Inherited by every fee/value hook below; the two window gates are beforeSwap-only and take no fee.
DynamicFee	Higher LP fee when the market is choppy, eased when calm (one-swap lag).
NoOp	Passthrough; only the base fee applies.
HeavierHand	Only admits swaps paying in the heavier side; inverts past a skew cap. Virtual reserves via StateLibrary.
BlockEcho	Swap size must echo the block number's trailing digits (within a window).
TailTwins	Swap size low byte must match the live price low byte (within tolerance).
TotalizerTrap	Blocks swaps that would land the pool's running total on a multiple of 11.
CrownClash	0.07% tribute + on-chain volume leaderboard. Custody-free (routes straight to treasury).
LegacyLedger	0.05% tax + on-chain loyalty tiers. Custody-free.
ExactInGate	Admits exact-input swaps only; blocks exact-output.
CapGate	Rejects swaps above a fixed size cap.
DailyWindowGate	Swaps clear only in a fixed 10-minute daily window (00:00-00:10 UTC). beforeSwap-only gate, no AeonFee.
MarketHoursGate	Swaps clear only during US market hours (09:30-16:00 ET, Mon-Fri). beforeSwap-only gate, no AeonFee.

AeonFee base

Every fee-taking hook inherits AeonFee, which takes 10 bps of each swap's unspecified (output) currency and routes it to a fixed treasury via poolManager.take(). The recipient and rate are compile-time constants and afterSwap is not virtual, so a derived hook cannot lower, skip, or redirect the protocol fee. A hook layers its own post-swap logic through _afterSwapExtra, which runs after the fee is taken (effective fee = max(hook's own fee, 10 bps)). The two beforeSwap-only window gates (DailyWindowGate, MarketHoursGate) were deployed without this base, so they implement no fee callback and take nothing.

Build and test

forge build
forge test

lib/v4-core is the vendored v4-core source the contracts build against (kept in-tree so the build matches the deployed bytecode). Unit tests are self-contained (no forge-std). The mainnet-fork gates in test/fork/ need an RPC, e.g.:

forge test --fork-url <eth-mainnet-rpc> --match-path test/fork/ForkDeploy.t.sol -vv

Live addresses

See DEPLOYMENTS.md.

The hook list (published to aeon.fun/hooks)

Beyond the aeon fleet, this repo is the registry behind aeon.fun/hooks: a structured, validated list of v4 hooks - the fleet plus community submissions.

• One file per hook at hooks/<slug>.json, checked against schema.json.
• A v4 hook encodes its permission flags in the low 14 bits of its address, so flags, flagBits, and the callback list are all derived from the address - a submitter only supplies a chain and an address.
• hooklist.json is the aggregated, machine-readable registry the website reads; HOOKS.md is the human catalog. Both are generated - do not hand-edit them.

To submit a hook, open a Submit a hook issue with the chain and address; a workflow decodes the flags and opens a PR. See CONTRIBUTING.md for the full format and flow.