CLAUDE.md - uniswap-hooks Plugin

CLAUDE.md - uniswap-hooks Plugin

Overview

This plugin provides AI-powered, security-first assistance for creating Uniswap v4 hooks. It helps developers design, implement, and test custom hooks for the Uniswap V4 protocol with a strong emphasis on security best practices.

Plugin Components

Skills (./skills/)

• v4-security-foundations: Security-first guide for v4 hook development (NoOp attacks, delta accounting, access control, audit checklists)

Uniswap v4 Hooks Architecture

Hooks are smart contracts that can intercept and modify pool actions at specific points:

Hook Callbacks

Hook Flags

Hooks declare which callbacks they implement via flags:

function getHookPermissions() public pure override returns (Hooks.Permissions memory) {
    return Hooks.Permissions({
        beforeInitialize: false,
        afterInitialize: true,
        beforeAddLiquidity: false,
        afterAddLiquidity: false,
        beforeRemoveLiquidity: false,
        afterRemoveLiquidity: false,
        beforeSwap: true,
        afterSwap: true,
        beforeDonate: false,
        afterDonate: false,
        beforeSwapReturnDelta: false,
        afterSwapReturnDelta: false,
        afterAddLiquidityReturnDelta: false,
        afterRemoveLiquidityReturnDelta: false
    });
}

Development Guidelines

Hook Address Requirements

v4 hooks must have specific address patterns where the last 14 bits encode which callbacks are enabled. Use the hook miner to find valid addresses.

State Management

• Use transient storage for temporary data within a transaction
• Consider gas costs when storing persistent state
• Leverage PoolManager's singleton pattern

Security Considerations

• Validate all inputs in hook callbacks
• Be aware of reentrancy risks
• Consider MEV implications of hook logic
• Test edge cases with extreme tick ranges

File Structure

uniswap-hooks/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── v4-security-foundations/
│       ├── SKILL.md
│       └── references/
│           ├── audit-checklist.md
│           ├── base-hook-template.md
│           └── vulnerabilities-catalog.md
├── project.json
├── package.json
├── CLAUDE.md
└── README.md

Related Resources

• Uniswap v4 Core
• v4 Periphery
• Hook Examples