Build Hook

Overview

Builds a complete Uniswap V4 hook by delegating to the hook-builder agent. Handles the full development lifecycle: understanding requirements, determining hook flags, generating Solidity contracts, generating Foundry tests, mining a CREATE2 address with correct flag bits, and producing deployment scripts. Returns production-ready code artifacts written directly to the project.

When to Use

Activate when the user asks:

• "Build a V4 hook"
• "Create a limit order hook"
• "Build a dynamic fee hook"
• "Create a TWAMM hook"
• "Custom hook for V4"
• "Hook that charges higher fees during volatility"
• "Build a hook that distributes LP fees to stakers"
• "Create a hook with oracle integration"

Parameters

Workflow

1. Extract parameters from the user's request: identify the hook behavior, any explicitly mentioned callbacks, constraints, and target chain.

2. Delegate to hook-builder: Invoke Task(subagent_type:hook-builder) with the full context. The hook-builder agent will:

   • Understand the requirements and determine which callbacks are needed
   • Map callbacks to hook flags and validate the flag combination
   • Generate a Solidity contract extending BaseHook with proper NatSpec
   • Generate comprehensive Foundry tests (unit, integration, edge cases, gas snapshots)
   • Mine a CREATE2 salt that produces an address encoding the required flags
   • Produce a deployment script with verification steps

3. Present results to the user with a summary covering:

   • Files written (contract path, test path, deployment script path)
   • Hook architecture explanation (what it does, how state flows)
   • Callbacks implemented and their flag bitmask
   • Gas estimates per callback (from Foundry test output)
   • Next steps for the developer (run tests, deploy to testnet, mainnet considerations)

Output Format

Present a summary followed by the generated files:

V4 Hook Built: LimitOrderHook

  Contract:   src/hooks/LimitOrderHook.sol (187 lines)
  Tests:      test/hooks/LimitOrderHook.t.sol (12 tests)
  Deployment: script/DeployLimitOrderHook.s.sol

  Callbacks: beforeSwap, afterSwap
  Flags:     0x00C0
  CREATE2:   Salt mined, address verified

  Gas Estimates:
    beforeSwap: ~45,000 gas
    afterSwap:  ~32,000 gas
    Total overhead per swap: ~77,000 gas

  Architecture:
    Orders are placed at specific ticks and stored in an on-chain order book.
    During beforeSwap, the hook checks for matching orders at the target tick.
    Matched orders are filled atomically within the same transaction.

  Next Steps:
    1. Run tests: forge test --match-contract LimitOrderHookTest
    2. Deploy to testnet: forge script script/DeployLimitOrderHook.s.sol --rpc-url sepolia
    3. Verify on Etherscan: forge verify-contract \x3Caddress> LimitOrderHook

Important Notes

• This skill delegates entirely to the hook-builder agent -- it does not call MCP tools directly.
• The hook-builder generates production-quality Solidity code with reentrancy protection and access control.
• CREATE2 address mining ensures the deployed address encodes the correct hook flags in its leading bytes (required by V4 PoolManager).
• Foundry must be installed for test generation and compilation. If not found, the skill will provide installation instructions.
• Generated code uses Solidity ^0.8.26 and imports from @uniswap/v4-core and @uniswap/v4-periphery.

Error Handling