SuperAPI AI 工具集

web3-forge

编程与开发

查看项目

更新于 10-16 08:41

技能介绍

web3-forge 是一个面向 Foundry 的测试与脚本编写技能,用于在 Solidity 项目中组织并编写测试和部署脚本。它强调在真实代码库中查找示例,并附带多份参考文档,按场景提示何时阅读:设置测试时参考 test-infrastructure.md(常量、默认值、mock),使用 vm cheatcode 时参考 cheat-codes.md,编写不变量测试时参考 invariant-patterns.md,做形式化验证(Halmos、Certora、符号执行)时参考 formal-verification.md,编写部署脚本时参考 deployment-scripts.md,主网上线前参考 deployment-checklist.md,测量 gas 时参考 gas-benchmarking.md,在 Sablier 仓库中工作时参考 sablier-conventions.md。

它按目录与命名区分测试类型:集成具体测试位于 tests/integration/concrete/(.t.sol),模糊测试位于 tests/integration/fuzz/,分叉测试位于 tests/fork/,不变量测试位于 tests/invariant/(Invariant.t.sol),脚本位于 scripts/solidity/(*.s.sol)。

主要规则包括:具体测试按 BTT 路径命名(如 test_RevertWhen_{Condition}、test_When_{Condition}),事件断言先于调用,状态断言后于调用;模糊测试先 bound 后 assume,按依赖顺序 bound;分叉测试用 vm.createSelectFork、deal、assumeNoBlacklisted、forceApprove 处理 USDC/USDT 等代币特性;不变量测试通过 handlers、stores 与 Invariant.t.sol 结构,仅 target handler 并排除协议合约;脚本继承 BaseScript 并使用广播模式,先模拟再广播。

运行与调试部分列出常用命令,例如:forge test --match-path "tests/integration/concrete/**"、forge test --match-contract Invariant_Test、forge test --match-test testFuzz_ --fuzz-runs 1000、forge coverage --report lcov,以及部署脚本的模拟与广播命令 forge script ... --broadcast --verify。调试支持 -v 至 -vvvvv 的详细级别、console2 日志、forge debug、forge inspect MyContract storage-layout 与 vm.label 等。限制方面,资料未说明其支持的 Foundry 版本范围、与其他测试框架的兼容性及平台要求,这些暂未提供。