SuperAPI AI 工具集

v4-security-foundations

安全与审计

查看项目

更新于 10-16 07:21

技能介绍

用途:这是面向 Uniswap v4 hook 开发的安全优先指南,强调在编写任何 hook 代码前先理解安全概念,因为 hook 漏洞可能导致用户资金被抽干。

主要能力:

  1. 威胁模型:涵盖调用者验证(仅 PoolManager 可调用 hook)、sender 身份(msg.sender 恒为 PoolManager,sender 参数是路由而非用户)、状态暴露、重入面等,并给出缓解措施。
  2. 权限风险矩阵:列出全部 14 个 hook 权限及风险等级,从 LOW 到 CRITICAL,并说明风险阈值。
  3. NoOp Rug Pull 攻击:解释 BEFORE_SWAP_RETURNS_DELTA(bit 10)为何最危险,附恶意示例代码与检测步骤,同时说明 JIT 流动性、自定义 AMM 曲线等合法用途。
  4. Delta 记账基础:核心不变量 sum(deltas)==0,take/settle/sync 的用途与方向,正确结算顺序 sync → transfer → settle,以及常见错误。
  5. 访问控制:onlyPoolManager 修饰符、路由白名单、通过 hookData 获取用户身份,以及 msg.sender 陷阱。
  6. 代币处理风险:fee-on-transfer、rebase、ERC-777、可暂停、黑名单、低精度代币及安全余额检查模式。
  7. Base Hook 模板:默认关闭全部权限,仅按需启用。
  8. 安全检查清单、Gas 预算指南(各回调目标与上限)、风险评分系统与审计层级建议、绝对禁止事项、部署前审计清单及生产 hook 参考。

使用方式:资料未提供安装命令或具体调用步骤,仅给出 Foundry 相关命令示例,如 forge test --match-test test_beforeSwapGas --gas-report 与 forge snapshot --match-contract MyHookTest。

适用场景:开发或审计 Uniswap v4 hook、评估 hook 权限风险、设计 delta 结算与访问控制时参考。

限制:资料未说明收费、价格、平台支持范围或实际效果;部分内容为安全建议而非强制规范,具体实现需结合项目与审计判断。