Add LivoSwapHook hook on ethereum

[hooklist-generator]

Summary

Singleton Uniswap v4 hook for tokens graduated via the Livo launchpad that collects a 0.5% LP fee (split 50/50 between creator and treasury) on all swaps, plus an optional time-limited buy/sell tax configurable per token. Swaps are blocked before token graduation.

Flags

Flag	Value
beforeInitialize	false
afterInitialize	false
beforeAddLiquidity	false
afterAddLiquidity	false
beforeRemoveLiquidity	false
afterRemoveLiquidity	false
beforeSwap	true
afterSwap	true
beforeDonate	false
afterDonate	false
beforeSwapReturnsDelta	true
afterSwapReturnsDelta	true
afterAddLiquidityReturnsDelta	false
afterRemoveLiquidityReturnsDelta	false

Properties

Property	Value
dynamicFee	false
upgradeable	false
requiresCustomSwapData	false
vanillaSwap	false
swapAccess	governance

Warnings

• Submitter did not provide a name. Using AI-derived "LivoSwapHook".
• Submitter did not provide a description. Using AI-generated description.

Closes #586

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
hooklist	Ready	Preview, Comment	May 27, 2026 6:42pm

[github-actions]

Review: hooks/ethereum/0x068241d20c59980abeaeded990d2441f05f5c0cc.json

Address Flags

Address ends in ...c0cc. Lower 14 bits: 0x00CC = 0000 0000 1100 1100.

Bit	Flag	Address	JSON
13	beforeInitialize	0	false ✓
12	afterInitialize	0	false ✓
11	beforeAddLiquidity	0	false ✓
10	afterAddLiquidity	0	false ✓
9	beforeRemoveLiquidity	0	false ✓
8	afterRemoveLiquidity	0	false ✓
7	beforeSwap	1	true ✓
6	afterSwap	1	true ✓
5	beforeDonate	0	false ✓
4	afterDonate	0	false ✓
3	beforeSwapReturnsDelta	1	true ✓
2	afterSwapReturnsDelta	1	true ✓
1	afterAddLiquidityReturnsDelta	0	false ✓
0	afterRemoveLiquidityReturnsDelta	0	false ✓

Confirmed by getHookPermissions() in source, which returns exactly the same set.

Properties

• dynamicFee: false ✓ — _beforeSwap always returns 0 as the fee override; no updateDynamicLPFee() call anywhere.
• upgradeable: false ✓ — No proxy pattern, delegatecall, mutable implementation storage, or SELFDESTRUCT.
• requiresCustomSwapData: false ✓ — Neither _beforeSwap nor _afterSwap reads hookData; swaps function fully without it.
• vanillaSwap: false ✓ — Both beforeSwapReturnsDelta and afterSwapReturnsDelta are true; the hook takes ETH fees from swap deltas, modifying swap execution.
• swapAccess: "governance" ✓ — _beforeSwap reverts with NoSwapsBeforeGraduation() if ILivoToken(tokenAddress).graduated() returns false. This is a boolean flag (set by the launchpad graduation process) gating swap access, matching the governance classification.

Metadata

• verifiedSource: true ✓ — source_meta.json confirms "verified": true.
• chainId: 1 ✓ — Matches ethereum in chains.json.
• name: "LivoSwapHook" ✓ — Matches contractName in source_meta.json and NatSpec @title LivoSwapHook in source.
• description ✓ — All claims substantiated by source: singleton architecture (NatSpec), 0.5% fee (LP_FEE_BPS = 50), 50/50 creator/treasury split (_accrue logic), optional time-limited tax (_getTaxParams with graduationTimestamp + taxDurationSeconds), graduation gate (NoSwapsBeforeGraduation revert). No marketing, audit, or endorsement language.

All checks pass.