智能合约与以太坊 / 系统课时

验证链上源码与部署参数

验证链上源码与部署参数

合约地址出现链上代码,不代表浏览器已确认源码与部署产物一致。本课从 Sepolia 部署交易追溯创建者与参数,再使用原 Foundry 工程重新编译并提交 Etherscan 验证,最后检查公开的 ABI 和只读调用是否可用。

学习目标

  • 从部署地址核对网络、创建交易和链上运行时代码。
  • 对齐编译器设置与 ABI 编码后的构造参数,完成源码验证。
  • 判断验证结果,并用 ABI 对照实际链上状态。

核对 Sepolia 地址与创建交易

准备实际部署后的合约地址、Sepolia RPC URL、Etherscan API V2 Key,以及部署时使用的 Foundry 项目。打开 Sepolia Etherscan,搜索合约地址而非交易哈希;在地址页面的创建者信息中进入创建交易,核对交易成功、创建出的合约地址和部署账户。工厂部署的创建者可能是工厂合约,不一定是最初发起交易的外部账户。

下面的 Bash 命令会交互读取参数;API Key 输入不回显,全部只保存在当前终端会话。不要输入私钥,也不要把密钥提交到 Git。

bash
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"

预期输出(第二行随合约而变):

text
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。

Sepolia 合约部署数据与源码验证的对应关系

使用 Foundry 提交源码验证

以下命令适用于已将 src/Counter.sol:Counter 部署到 Sepolia、构造函数参数为 (address,uint256) 且部署时 initialCount=42 的示例工程。必须在该工程根目录运行,并沿用部署时的 foundry.toml、源码、依赖版本和链接库配置;其他合约要替换路径、类型与实参。

bash
# 使用原构建配置编译,避免修改部署时的选项
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 等待到最终验证结果。成功时终端可见类似:

text
Contract successfully verified.

命令不会再次部署,也不需要部署账户私钥。--watch 返回前的“已提交”不等于验证成功;应以最终成功状态和浏览器页面共同判断。

在浏览器确认 ABI 与部署参数

重新打开 Sepolia Etherscan 的合约地址页面,依次核对:

  1. Contract → Code 显示 Source Code Verified,优先确认 Exact Match,不要把 Similar Match 当成完整元数据匹配。
  2. 对照 Compiler Version、Optimization Enabled、Runs 与源码文件;确认页面展示的 Constructor Arguments 解码值和部署记录一致。
  3. 在 Contract → Code 找到 Contract ABI;Read Contract 应列出 ABI 中的只读函数。对示例 Counter,若合约定义了 uint256 public count,可读取 count() 并与本地调用对照。

在同一终端运行只读调用(仅适用于具有 count() 的示例合约):

bash
cast call "$CONTRACT_ADDRESS" "count()(uint256)" --rpc-url "$SEPOLIA_RPC_URL"

预期结果:若部署时初始值为 42 且之后未修改,返回:

text
42

如果状态已被更新,应以实际链上数值为准;它不影响源码验证是否成立。ABI 是调用函数和解析返回值的接口描述,不是运行时代码,也不证明业务逻辑安全。

失败时按差异类型处理

  • 找不到合约代码:先确认 cast chain-id 为 11155111、cast codesize 大于零,并检查创建交易是否已确认。
  • 字节码不匹配:还原部署时的源码提交、solc 完整版本、优化开关及次数、evm_version、via_ir、依赖库与链接地址。不要为让验证通过而随意更改源码。
  • 构造参数错误:核对类型顺序、地址、整数单位与实际部署值,重新使用 cast abi-encode 编码;创建交易输入与运行时代码不能直接逐字比较。
  • 显示已验证但 ABI 不符合预期:检查是否搜索错合约地址,或当前地址是代理合约;代理的实现合约需在其真实实现地址单独核验源码和 ABI。

保留部署交易哈希、合约地址、源码提交号及编译配置,才能在下次复现同一验证结果。命令选项可参考 Foundry 验证文档。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

验证链上源码与部署参数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通