aggregator-hook-creator

用途：该技能面向 Uniswap v4 开发，讲解并指导构建 Aggregator Hooks——即包装 Curve、Balancer、Aerodrome 等非 Uniswap 池的 v4 hook，使 Uniswap 路由能纳入外部流动性来源，从而在多个协议间选择最优流动性以改善执行质量。主要能力与模式：支持价格比较（beforeSwap）、拆分路由（beforeSwap、afterSwap）、流动性不足时回退路由（beforeSwap）以及路由决策与成交量分析（afterSwap）。提供两种方案：Proposal #1 通用 Hook，单次部署、通过 hookData 传入编码后的外部调用（ExternalAction 结构含 to、value、data），路由逻辑在链下计算，适合快速原型与多协议聚合；Proposal #2 协议专用 Hook，每个 DEX 一个专用 hook（如 CurveAggregatorHook 持有 ICurvePool），适合生产部署、gas 优化与更易审计。资料还给出协议兼容矩阵（Curve、Aerodrome、Balancer、Fluid V2、Sushiswap、PancakeswapV3 的额外跳数、回调、是否替代 Router、是否支持唯一池）。使用方式与关键流程：外部路由时，用户输入代币经 Router 到 PoolManager，在 beforeSwap 回调中进行外部 DEX 调用，hook 使用 beforeSwapReturnDelta 声明已处理该交换，并通过 settle() 与 take() 结清欠款，且 hook 需对目标外部 DEX 完成代币授权。限制与安全要求：前置知识包括 viem 集成、Uniswap 交换模式、v4 hook 架构基础，并需先完成 v4-security-foundations，理解 NoOp 攻击、delta 记账与访问控制。必须校验外部调用返回、防范单区块价格操纵、防重入、遵守用户滑点且禁止零 minAmountOut；避免无界循环、硬编码地址、直接处理 ETH 与未检查算术。通用 Hook 存在任意外部调用风险，建议采用允许列表、选择器过滤与 value 上限。部署需审计、分叉主网测试、验证授权与 gas、正确配置 PoolManager 地址、初始化池并监控 RouteDecision 事件。完整实现代码、协议参考与测试套件见技能内 references 文件；其余细节暂未提供。