智能合约与以太坊 / 系统课时
验证链上源码与部署参数
验证链上源码与部署参数
合约地址出现链上代码,不代表浏览器已确认源码与部署产物一致。本课从 Sepolia 部署交易追溯创建者与参数,再使用原 Foundry 工程重新编译并提交 Etherscan 验证,最后检查公开的 ABI 和只读调用是否可用。
学习目标
- 从部署地址核对网络、创建交易和链上运行时代码。
- 对齐编译器设置与 ABI 编码后的构造参数,完成源码验证。
- 判断验证结果,并用 ABI 对照实际链上状态。
核对 Sepolia 地址与创建交易
准备实际部署后的合约地址、Sepolia RPC URL、Etherscan API V2 Key,以及部署时使用的 Foundry 项目。打开 Sepolia Etherscan,搜索合约地址而非交易哈希;在地址页面的创建者信息中进入创建交易,核对交易成功、创建出的合约地址和部署账户。工厂部署的创建者可能是工厂合约,不一定是最初发起交易的外部账户。
下面的 Bash 命令会交互读取参数;API Key 输入不回显,全部只保存在当前终端会话。不要输入私钥,也不要把密钥提交到 Git。
read -r -p "Sepolia RPC URL: " SEPOLIA_RPC_URL
read -r -p "合约地址: " CONTRACT_ADDRESS
read -r -p "构造函数 initialOwner: " INITIAL_OWNER
read -r -s -p "Etherscan API Key: " ETHERSCAN_API_KEY
printf '\n'
export SEPOLIA_RPC_URL CONTRACT_ADDRESS INITIAL_OWNER ETHERSCAN_API_KEY
# 先确认 RPC 链,再检查地址是否已有运行时代码
cast chain-id --rpc-url "$SEPOLIA_RPC_URL"
cast codesize "$CONTRACT_ADDRESS" --rpc-url "$SEPOLIA_RPC_URL"预期输出(第二行随合约而变):
11155111
<非零代码字节数>链 ID 为 11155111 且代码长度大于零,才继续验证。若长度是 0,先排查地址、网络或部署交易;链上运行时代码与创建交易 Input Data 中的创建字节码不是同一份数据。
对齐源码、编译设置和构造参数
源码验证会用提交的源码与参数重新编译,再将产物和链上部署结果比对。应回到实际部署时的源码版本,而不是拿最新修改过的文件替代。逐项检查:
| 项目 | 核对依据 | 不一致的后果 |
|---|---|---|
| 合约标识 | src/Counter.sol:Counter,含依赖与链接库 |
编译目标或库地址错误 |
| 编译器 | solc 完整版本与提交标识 |
字节码或元数据不同 |
| 编译选项 | optimizer、optimizer_runs、evm_version、via_ir |
重编译结果不同 |
| 构造参数 | 部署时实际传入的值,按构造函数类型 ABI 编码 | 创建字节码校验失败 |
例如构造函数为 constructor(address initialOwner, uint256 initialCount),部署参数依次是管理员地址与 42。initialOwner 要使用部署时的地址,而非当前钱包地址;构造参数编码值也不能用十进制 42 直接替代。没有构造参数的合约无需传入 --constructor-args。

使用 Foundry 提交源码验证
以下命令适用于已将 src/Counter.sol:Counter 部署到 Sepolia、构造函数参数为 (address,uint256) 且部署时 initialCount=42 的示例工程。必须在该工程根目录运行,并沿用部署时的 foundry.toml、源码、依赖版本和链接库配置;其他合约要替换路径、类型与实参。
# 使用原构建配置编译,避免修改部署时的选项
forge build
forge verify-contract "$CONTRACT_ADDRESS" src/Counter.sol:Counter \
--chain sepolia \
--rpc-url "$SEPOLIA_RPC_URL" \
--verifier etherscan \
--etherscan-api-key "$ETHERSCAN_API_KEY" \
--constructor-args "$(cast abi-encode 'constructor(address,uint256)' "$INITIAL_OWNER" 42)" \
--watch预期结果:构建成功、验证服务接受请求后,--watch 等待到最终验证结果。成功时终端可见类似:
Contract successfully verified.命令不会再次部署,也不需要部署账户私钥。--watch 返回前的“已提交”不等于验证成功;应以最终成功状态和浏览器页面共同判断。
在浏览器确认 ABI 与部署参数
重新打开 Sepolia Etherscan 的合约地址页面,依次核对:
Contract→Code显示Source Code Verified,优先确认Exact Match,不要把Similar Match当成完整元数据匹配。- 对照
Compiler Version、Optimization Enabled、Runs与源码文件;确认页面展示的Constructor Arguments解码值和部署记录一致。 - 在
Contract→Code找到Contract ABI;Read Contract应列出 ABI 中的只读函数。对示例Counter,若合约定义了uint256 public count,可读取count()并与本地调用对照。
在同一终端运行只读调用(仅适用于具有 count() 的示例合约):
cast call "$CONTRACT_ADDRESS" "count()(uint256)" --rpc-url "$SEPOLIA_RPC_URL"预期结果:若部署时初始值为 42 且之后未修改,返回:
42如果状态已被更新,应以实际链上数值为准;它不影响源码验证是否成立。ABI 是调用函数和解析返回值的接口描述,不是运行时代码,也不证明业务逻辑安全。
失败时按差异类型处理
- 找不到合约代码:先确认
cast chain-id为11155111、cast codesize大于零,并检查创建交易是否已确认。 - 字节码不匹配:还原部署时的源码提交、
solc完整版本、优化开关及次数、evm_version、via_ir、依赖库与链接地址。不要为让验证通过而随意更改源码。 - 构造参数错误:核对类型顺序、地址、整数单位与实际部署值,重新使用
cast abi-encode编码;创建交易输入与运行时代码不能直接逐字比较。 - 显示已验证但 ABI 不符合预期:检查是否搜索错合约地址,或当前地址是代理合约;代理的实现合约需在其真实实现地址单独核验源码和 ABI。
保留部署交易哈希、合约地址、源码提交号及编译配置,才能在下次复现同一验证结果。命令选项可参考 Foundry 验证文档。