用 OpenZeppelin MCP 生成 Uniswap…

需要从零搭建 Uniswap v4 hook 合约（自定义 swap 逻辑、动态费用、MEV 防护、预言机、限价单等）时，按决策表选型、配置权限与工具库并调用 MCP 工具生成 Solidity 代码。

适用场景

解决思路

1. 先确认六项决策再调用 MCP 工具：hook 类型、要启用的权限、工具库、shares、访问控制、hook inputs。
2. 按目标从决策表选择基础 hook 类型：自定义 swap 逻辑用 BaseHook；异步/延迟 swap 用 BaseAsyncSwap；hook 自有流动性用 BaseCustomAccounting；自定义曲线用 BaseCustomCurve；动态 LP 费用用 BaseDynamicFee；动态 swap 费用用 BaseOverrideFee；swap 后收费 用 BaseDynamicAfterFee；固定 hook 费用用 BaseHookFee；MEV 防护用 AntiSandwichHook；JIT 防护用 LiquidityPenaltyHook；限价单用 LimitOrderHook；闲置资金生息用 ReHypothecationHook；预言机用 BaseOracleHook；兼容 V3 的预言机用 OracleHookWithV3Adapters。
3. 选型提示：BaseHook 是通用起点，只有内置逻辑确有价值时才选专用类型；BaseCustomCurve 会替换整个 AMM 数学，仅在实现全新定价算法时使用；AntiSandwichHook 与 LiquidityPenaltyHook 都防 MEV 但针对不同对象（交易者 vs JIT LP），先明确要缓解的攻击向量；当下游集成期望 Uniswap v3 IUniswapV3Pool 兼容预言机接口时用 OracleHookWithV3Adapters。
4. 配置权限：14 个权限标志全部先设为 false，只启用逻辑真正需要的回调；每个启用的权限都会扩大攻击面，并需要在部署地址中设置对应 bit。
5. 按风险决定权限：beforeInitialize（校验/限制池创建参数，LOW）、afterInitialize（池创建后初始化状态，LOW）、beforeAddLiquidity（拦截或转换 LP 存款，MEDIUM）、afterAddLiquidity（跟踪 LP 头寸或发奖励，LOW）、beforeRemoveLiquidity（锁定期或退出费，HIGH）、afterRemoveLiquidity（跟踪移除用于记账，LOW）、beforeSwap（修改 swap 行为、动态费用或阻断，HIGH）、afterSwap（观察最终 swap 状态用于预言机或记账，MEDIUM）、beforeDonate（限制捐赠者，LOW）、afterDonate（跟踪捐赠事件，LOW）、beforeSwapReturnDelta（自定义 AMM 曲线或 JIT 流动性，CRITICAL，存在 NoOp 攻击向量）、afterSwapReturnDelta（从 swap 输出中抽取 hook 费用，HIGH）、afterAddLiquidityReturnDelta（调整存款时的 LP 代币数量，HIGH）、afterRemoveLiquidityReturnDelta（调整提取金额，HIGH）。
6. 注意地址编码：权限以 bit 形式编码在 hook 合约部署地址中，地址必须在部署时就有正确的 bit，否则 PoolManager 会 revert；用 v4-periphery 的 HookMiner 挖出能产生正确 bit 模式的 salt；部署后永远不要更改权限，地址不可变。
7. 选择工具库：currencySettler 用于 hook 在自身与 PoolManager 之间转移代币（如自定义记账、收费）；safeCast 用于可能在整数类型转换时溢出的算术；transientStorage 用于在单笔交易内跨回调传递数据而不持久化到存储（需要 EVM Cancun 或更高、Solidity >= 0.8.24）。
8. 工具库提示：启用 beforeSwapReturnDelta、afterSwapReturnDelta、afterAddLiquidityReturnDelta 或 afterRemoveLiquidityReturnDelta 时几乎总需要 currencySettler，它提供实现正确 sync → transfer → settle 顺序的 settle 与 take 辅助函数；transientStorage 是交易内状态的高 gas 效率替代，用于从 beforeSwap 向 afterSwap 传标志或值而无需支付 20k gas 的冷 SSTORE；只要计算涉及 int256/uint256 转换（尤其费用计算）就建议加 safeCast。
9. 配置 shares：false 表示不发 share 代币、不跟踪存入资产所有权，适合不持有用户资金的简单 hook（费用 hook、预言机）；ERC20 表示同质化 share 代币，一枚代表对所有 hook 持有资产的按比例所有权，适合 hook 管理的流动性池且份额可互换；ERC6909 是多代币最小实现，一个合约管理多个 token ID 且开销低于 ERC1155，适合高效管理多种不同资产类别；ERC1155 是标准多代币，带 metadata URI 支持，适合需要广泛钱包与市场兼容性。
10. shares 取舍：false 字节码最小、无份额记账开销；ERC20 是最简单的同质化份额且 DeFi 可组合性好（可作抵押品）；ERC6909 是 gas 高效的多代币最小接口，新协议设计优先；ERC1155 生态支持最广（钱包、浏览器、NFT 市场）但每笔转账 gas 高于 ERC6909。
11. 配置访问控制：ownable 的构造函数为 constructor(IPoolManager, address initialOwner)，单一 owner 控制所有管理函数，适合早期 hook 和个人工具；roles 的构造函数为 constructor(IPoolManager, address admin)，通过 OpenZeppelin AccessControl 提供多角色细粒度权限（如 keeper bot 可更新费用但不能升级合约），适合不同成员需要不同权限；managed 的构造函数为 constructor(IPoolManager, address authority)，由外部 authority 合约治理权限（OpenZeppelin AccessManaged），适合需要跨多合约统一治理层或带时间锁的管理操作。
12. 访问控制注意：改变 access 会改变构造函数签名，需同步更新部署脚本与初始化逻辑；使用 ownable 时确保 initialOwner 不是零地址（OpenZeppelin Ownable 自 v5 起对零地址 revert）。
13. 配置 hook inputs：blockNumberOffset（uint256，被 AntiSandwichHook 与 LiquidityPenaltyHook 使用）表示 sandwich/JIT 检测窗口开启前的区块数；maxAbsTickDelta（int24，被 AntiSandwichHook 使用）表示触发 MEV 防护前每区块允许的最大 tick 移动；不使用这些输入的 hook 类型省略 inputs 字段或传空对象 {}，传不支持的输入不会报错但会被忽略。
14. 按规范 JSON 组装 MCP 工具调用：字段包括 hook（14 种类型之一）、name（Solidity 合约名，PascalCase 无空格）、pausable（布尔，是否用 OpenZeppelin Pausable 包裹并加 pause()/unpause() 管理函数）、currencySettler、safeCast、transientStorage、shares.options（false | "ERC20" | "ERC6909" | "ERC1155"）、permissions（14 个布尔标志）、inputs、access（"ownable" | "roles" | "managed"）、info.license（SPDX 标识符，开源 hook 用 "MIT"）。
15. 按四步工作流执行：Gather（收集需求）→ Configure（配置六项决策）→ Generate（生成）→ Secure（安全审计）。
16. Step 1 收集需求：问用户或从上下文推断——hook 的主要目标是什么（映射到决策表）；需要拦截哪些生命周期事件（映射到权限）；hook 是否持有或移动用户资金（决定 currencySettler 与 shares）；谁管理 hook（单一 owner、角色团队还是外部治理）；是否需要在单笔交易内跨回调传递状态；目标链是否支持 EVM Cancun（transientStorage 必需）。
17. Step 2 选择 hook 类型：用决策表确定唯一最佳类型；若用户目标映射到多个类型，说明取舍并请用户确认；记录所选类型与理由。
18. Step 3 配置全部六项决策：设置 hook 为所选类型；逐个设置权限标志（默认 false，只启用逻辑需要的）；根据工具库指引设置 currencySettler、safeCast、transientStorage；根据 shares 指引设置 shares.options；根据访问控制指引设置 access；仅当 hook 类型使用 blockNumberOffset 或 maxAbsTickDelta 时设置 inputs。
19. Step 4 组装并调用 MCP 工具：用 Step 3 的 JSON 调用 OpenZeppelin Contracts Wizard MCP 工具，工具返回 Solidity 源码但不会自动写文件；拿到代码后向用户展示代码、解释关键生成部分（构造函数、getHookPermissions、启用的回调）、说明需要的手动步骤（用 HookMiner 挖地址、若 access 为 roles 或 managed 需更新部署脚本的构造函数参数）。
20. Step 5 应用安全基础：始终提醒用户并在部署前调用 v4-security-foundations——验证所有启用的回调检查 msg.sender == address(poolManager)；审查所有启用的 *ReturnDelta 权限的 NoOp 攻击暴露；确认每条执行路径的 delta 记账之和为零；运行 v4-security-foundations 的完整部署前审计清单。
21. 记住 MCP 只返回代码不写文件：生成的 Solidity 以字符串返回，需自行写入磁盘（如 packages/contracts/src/hooks/MyHook.sol）。

适用边界 · 注意事项

• 不要在没有先运行 v4-security-foundations 审计权限、delta 记账与访问控制之前部署生成的 hook 代码——hook 配置错误可能导致用户资金被抽干。
• 不要在部署后更改权限：权限编码在不可变的部署地址中，PoolManager 每次回调都会校验这些 bit。
• 不要为 hook 类型传入不支持的 inputs（如对不使用 blockNumberOffset/maxAbsTickDelta 的类型传值），值会被静默忽略。