Add Rivers Shared LaunchHook V4 hook on robinhood

[hooklist-generator]

Summary

Singleton Uniswap v4 hook for Rivers launch pools implementing a phased launchpad lifecycle with band-based bonding curve mechanics. Takes protocol and creator fees on swaps via delta manipulation, dynamically overrides LP fees based on pool phase, and restricts swaps and liquidity to a controller during pre-graduation phases.

Flags

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

Properties

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

Warnings

• Submitter-proposed description rejected: contains unverifiable external claim "Allowlisted for uniroute routing (ROUTE-1517)" not substantiated by the source code. Using AI-generated description.

Closes #1135

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
hooklist	Ready	Preview, Comment	Jul 24, 2026 5:53pm

[github-actions]

Review: hooks/robinhood/0x7a8e7ef7cdeeddef23735689639becba9cfeaacc.json

Contract: LaunchHook on Robinhood chain (chainId 4663)

Flags — All Correct ✓

Decoding the lowest 14 bits of the address 0x...cfeaacc → 0xaacc = 10 1010 1011 0011 00 → confirmed:

Flag	Address Bit	JSON Value	Source (_requiredPermissions)
beforeInitialize	1	true	true ✓
afterInitialize	0	false	(absent = false) ✓
beforeAddLiquidity	1	true	true ✓
afterAddLiquidity	0	false	(absent = false) ✓
beforeRemoveLiquidity	1	true	true ✓
afterRemoveLiquidity	0	false	(absent = false) ✓
beforeSwap	1	true	true ✓
afterSwap	1	true	true ✓
beforeDonate	0	false	(absent = false) ✓
afterDonate	0	false	(absent = false) ✓
beforeSwapReturnsDelta	1	true	true ✓
afterSwapReturnsDelta	1	true	true ✓
afterAddLiquidityReturnsDelta	0	false	(absent = false) ✓
afterRemoveLiquidityReturnsDelta	0	false	(absent = false) ✓

Properties — All Correct ✓

• dynamicFee: true — beforeSwap returns lpFee | LPFeeLibrary.OVERRIDE_FEE_FLAG, selecting between preGraduationLpFee and postGraduationLpFee depending on pool phase. ✓

• upgradeable: false — No proxy pattern, no delegatecall, no mutable implementation slot. source_meta.json confirms "proxy": false. ✓

• requiresCustomSwapData: false — hookData is only used for optional fee-exemption markers and graduation-crossing detection. Empty hookData causes no reverts; swaps proceed with normal fees applied. ✓

• vanillaSwap: false — Correct. Both beforeSwapReturnsDelta and afterSwapReturnsDelta are true; the hook manipulates token deltas to take protocol and creator fees; and LP fees are dynamically overridden. ✓

• swapAccess: "governance" — Correct. beforeSwap gates non-graduated swaps via _feeActive(config.phase), which reflects a boolean-like state flag advanced by controller-only admin functions (markSeeded, activateBootstrap, beginGraduation, etc.). ✓

Metadata — Correct ✓

• chainId: 4663 — matches robinhood entry in chains.json. ✓
• verifiedSource: true — confirmed by source_meta.json. ✓
• name: "Rivers Shared LaunchHook V4" — "LaunchHook" is the contract name; "Rivers" is substantiated by NatSpec (/// @notice Long-lived singleton hook serving versioned Rivers launch pools) and constants (RIVERS_AUTOMATIC_SETTLEMENT, RIVERS_GRADUATION_CROSSING); "Shared" reflects the singleton pattern; "V4" refers to Uniswap v4. No promotional/audit/safety language. ✓
• description — Accurately reflects the source: singleton nature, phased lifecycle (CREATED → SEEDED → BOOTSTRAP_ACTIVE → GRADUATION_PENDING → GRADUATED_LP_ACTIVE → PARTICIPANT_LADDER_SETTLED), band-based settlement mechanics, fee delta manipulation, LP fee override, and pre-graduation controller restriction. ✓

All fields verified against on-chain source. No issues found.