用途:在 Etherscan、Routescan、Blockscout 区块浏览器上验证已部署的智能合约,基于 Foundry 的 forge verify-contract。适用于验证普通合约、代理合约(ERC1967、UUPS)、工厂创建合约(CREATE2),以及从部署数据中提取构造函数参数。
前提:Foundry ≥1.3.6(用 forge -V 检查,低于则停止)、合约地址、链 ID、浏览器 API 密钥(仅 Etherscan 链需要)、与部署字节码完全一致的源码。
主要能力与用法:按目标链选择验证方式。Etherscan 原生支持链可直接用 --verifier etherscan 加 --rpc-url 与 --etherscan-api-key;当 Foundry 提示无已知 API URL 或使用 Etherscan V2 时,加 --verifier-url "https://api.etherscan.io/v2/api?chainid=<CHAIN_ID>"。Routescan 链(avalanche、chiliz)用 --verifier etherscan 加对应 verifier URL,API key 传 "verifyContract"。Blockscout 链(lightlink、mode、morph、superseed)用 --verifier blockscout 加对应 verifier URL,API key 同样传 "verifyContract"。有构造函数参数时追加 --constructor-args,可用 cast abi-encode 生成。库合约使用完整路径 src/libraries/<Library>.sol:<Library>。
限制与排错:源码须与部署字节码完全匹配,编译漂移需检出部署提交并重装依赖;构造函数参数不匹配需从 broadcast 提取或手动编码;已验证的合约无需操作。代理合约需分别验证实现与代理,工厂合约需从 broadcast initCode 提取参数。具体链列表、特殊案例与排错细节见资料中的表格与参考文件。