Skip to content

feat: Add note about hooks to docs (DEV-1214) - #245

Merged
lucas-manuel merged 1 commit into
devfrom
dev-1214-docs-addition
Feb 11, 2026
Merged

lucas-manuel merged 1 commit into
devfrom
dev-1214-docs-addition

Conversation

@TheMj0ln1r

@TheMj0ln1r TheMj0ln1r commented Feb 11, 2026

Copy link
Copy Markdown
Contributor

Summary by CodeRabbit

  • Documentation
    • Updated Liquidity Operations documentation with new Uniswap V4 integration requirement: only hookless pools are eligible for onboarding to ensure accurate rate limit calculations from token balance differences.

@TheMj0ln1r TheMj0ln1r self-assigned this Feb 11, 2026
@notion-workspace

Copy link
Copy Markdown

@coderabbitai

coderabbitai Bot commented Feb 11, 2026

Copy link
Copy Markdown

Walkthrough

A documentation update was added to LIQUIDITY_OPERATIONS.md specifying that only hookless pools can be onboarded to Uniswap V4 integration. The requirement explains that rate limit decreases are calculated from token balance differences, and pool hooks could manipulate these balances to circumvent the rate limit.

Changes

Cohort / File(s) Summary
Documentation
docs/LIQUIDITY_OPERATIONS.md
Added requirement clarifying that only hookless pools can be onboarded to Uniswap V4 integration, explaining the security rationale for this constraint.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

🐰 A hookless pool, so safe and true,
No tricks to skip our rate limits through,
Balance differences, our guide so bright,
Keep the limits working right,
Documentation shines with new delight! 📋✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'feat: Add note about hooks to docs' accurately describes the main change - adding documentation about hooks to prevent rate limit bypass via pool hook manipulation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch dev-1214-docs-addition

Tip

Issue Planner is now in beta. Read the docs and try it out! Share your feedback on Discord.


Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@docs/LIQUIDITY_OPERATIONS.md`:
- Line 72: Clarify the term "hookless" by replacing the ambiguous wording with a
precise condition: state that a pool is considered hookless when its hooks
address equals the zero address (0x000...000) or when the pool reports "no hooks
configured" according to the Uniswap V4 pool spec; update the sentence
referencing `hookData` and onboarding to explicitly check the pool's hooks
address (or the Uniswap V4 "no hooks configured" indicator) before allowing
onboarding so decisions are unambiguous.


- Only 1:1 stablecoin pools can be onboarded
- Tick limits must be configured.
- Only hookless pools can be onboarded. Rate limit decreases are calculated from token balance differences before and after pool interactions, and empty `hookData` is passed. Pool hooks (if present) could manipulate token balances during the call to bypass the rate limit decrease.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick | 🔵 Trivial

Define “hookless” precisely to avoid ambiguity.

Recommend specifying the exact condition (e.g., hooks address equals zero or “no hooks configured” per Uniswap V4 pool spec) so onboarding decisions are unambiguous.

🤖 Prompt for AI Agents
In `@docs/LIQUIDITY_OPERATIONS.md` at line 72, Clarify the term "hookless" by
replacing the ambiguous wording with a precise condition: state that a pool is
considered hookless when its hooks address equals the zero address (0x000...000)
or when the pool reports "no hooks configured" according to the Uniswap V4 pool
spec; update the sentence referencing `hookData` and onboarding to explicitly
check the pool's hooks address (or the Uniswap V4 "no hooks configured"
indicator) before allowing onboarding so decisions are unambiguous.

@github-actions

Copy link
Copy Markdown

Coverage after merging dev-1214-docs-addition into dev will be

99.30%

Coverage Report
FileStmtsBranchesFuncsLinesUncovered Lines
deploy
   ControllerDeploy.sol100%100%100%100%
   ForeignControllerInit.sol100%100%100%100%
   MainnetControllerInit.sol97.37%93.33%100%100%152, 90
src
   ALMProxy.sol100%100%100%100%
   ALMProxyFreezable.sol100%100%100%100%
   ForeignController.sol96.10%89.66%95.65%98.04%130–131, 131, 131, 556
   MainnetController.sol99.20%100%98.39%99.25%614–615
   OTCBuffer.sol92.31%100%83.33%93.75%55
   RateLimitHelpers.sol100%100%100%100%
   RateLimits.sol100%100%100%100%
   WEETHModule.sol93.18%90%85.71%96.30%65, 72
src/libraries
   AaveLib.sol100%100%100%100%
   ApproveLib.sol100%100%100%100%
   CCTPLib.sol100%100%100%100%
   CurveLib.sol100%100%100%100%
   ERC4626Lib.sol97.06%90%100%100%117
   LayerZeroLib.sol100%100%100%100%
   PSMLib.sol100%100%100%100%
   UniswapV4Lib.sol99.33%95.65%100%100%282
   WEETHLib.sol100%100%100%100%

@lucas-manuel
lucas-manuel merged commit 553bce1 into dev Feb 11, 2026
5 checks passed
@lucas-manuel
lucas-manuel deleted the dev-1214-docs-addition branch February 11, 2026 21:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants