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

在主网分叉上验证外部依赖

在主网分叉上验证外部依赖

本课使用 Foundry 在固定以太坊主网区块创建测试分叉,直接调用真实 USDC 合约,验证代币精度、授权限制和外部调用失败行为。完成后,你将拥有一套可重复执行的集成测试,并能判断本地 Mock 测试为什么不能替代真实链上依赖验证。

学习目标

  • 使用固定区块和 RPC 配置创建可复现的主网分叉测试环境。
  • 编写 Foundry 测试,检查真实 ERC-20 代币的接口行为和授权边界。
  • 区分 Mock、Fork 与真实主网执行的验证范围,定位外部依赖兼容性问题。

理解主网分叉的测试边界

普通 Foundry 单元测试从本地 EVM 状态开始,外部代币通常需要自行部署 Mock。主网分叉测试则通过 RPC 读取指定区块的链上代码、账户余额和合约存储,使测试可以访问真实部署的协议。

例如,准备集成 USDC 的资金管理合约时,Mock 可能统一返回 18 位精度并允许任意转账,但以太坊主网 USDC 使用 6 位精度,而且转账受到余额与授权限制。只依赖这种 Mock,合约可能在真实部署后出现金额换算错误或交易回滚。

Foundry 主网分叉与真实依赖调用关系

三种测试环境的适用范围如下:

环境 外部依赖 主要验证内容
Mock 单测 自行模拟 本地业务分支、异常处理、边界输入
固定区块 Fork 真实历史链上状态 ABI 兼容性、实际代币行为、协议配置
真实主网交易 当前真实网络状态 最终执行、实际 Gas、交易排序与链上交互

Fork 不是主网交易重放的完整替代品。它默认没有后续区块中的状态变化,也不能保证历史分叉上的成功调用在未来主网上同样成功。测试产生的余额和存储变化不会提交到真实主网。

创建固定区块测试环境

下面使用以太坊主网区块 19000000。该区块已经包含 USDC 合约,适合验证代币接口。将 RPC 密钥配置为环境变量,避免把凭据写进 Solidity 文件或提交到仓库。

前提是已安装 Foundry,执行 forge --version 可以正常显示版本,并且拥有支持历史状态查询的以太坊主网 RPC 服务。

在已有 Foundry 项目根目录执行以下 Bash 命令。没有项目时先执行 forge init fork-lab,再进入新建目录。将地址替换为自己的以太坊主网 RPC 地址。

bash
export MAINNET_RPC_URL='https://your-ethereum-rpc-endpoint'
forge test --fork-url "$MAINNET_RPC_URL" --fork-block-number 19000000 -vv

预期结果:当项目现有测试通过且 RPC 支持该历史区块时,Forge 会显示测试通过统计。具体测试数量取决于项目,不应预设固定数量。

text
Suite result: ok. ... passed; 0 failed; 0 skipped

这里有两个重要参数:

  • --fork-url:指定主网 RPC,Foundry 根据需要读取远程账户代码和状态。
  • --fork-block-number:固定历史区块,减少测试结果随主网最新状态变化而产生的漂移。

在 Solidity 测试中还可以使用 vm.createSelectFork(rpcUrl, blockNumber) 创建并选择分叉。对于只在少数测试中使用主网状态的项目,这种方式比让整个测试套件都运行在 Fork 模式下更合适。

编写真正调用 USDC 的集成测试

本例选择以太坊主网 USDC 地址 0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48。测试目标不是模拟代币返回值,而是在固定区块上读取真实 USDC 的精度与授权状态,并尝试通过资金拉取合约执行 transferFrom。

在 test/USDCFork.t.sol 中写入以下完整测试代码。项目需要已有 forge-std 依赖,且 forge-std/Test.sol 能够正常导入。

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import {Test} from "forge-std/Test.sol";

interface IERC20External {
    function decimals() external view returns (uint8);
    function balanceOf(address owner) external view returns (uint256);
    function allowance(address owner, address spender)
        external view returns (uint256);
    function transferFrom(address from, address to, uint256 amount)
        external returns (bool);
}

contract TokenPuller {
    IERC20External public immutable token;

    constructor(address tokenAddress) {
        token = IERC20External(tokenAddress);
    }

    function pull(address from, uint256 amount) external {
        // 不允许静默接受返回 false 的代币调用
        require(token.transferFrom(from, address(this), amount), "TRANSFER_FAILED");
    }
}

contract USDCForkTest is Test {
    address constant USDC = 0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48;
    uint256 constant FORK_BLOCK = 19_000_000;

    IERC20External usdc;
    TokenPuller puller;
    address actor = address(0xBEEF);

    function setUp() public {
        // 固定主网区块,避免每次运行读取不同状态
        vm.createSelectFork(vm.envString("MAINNET_RPC_URL"), FORK_BLOCK);
        usdc = IERC20External(USDC);
        puller = new TokenPuller(USDC);
    }

    function test_RealTokenMetadata() public view {
        assertEq(block.chainid, 1);
        assertEq(block.number, FORK_BLOCK);
        assertGt(USDC.code.length, 0);
        assertEq(usdc.decimals(), 6);
    }

    function test_TransferWithoutAllowanceReverts() public {
        // 新部署的 puller 没有获得 actor 的授权
        assertEq(usdc.allowance(actor, address(puller)), 0);
        vm.expectRevert();
        puller.pull(actor, 1);
    }

    function test_ZeroBalanceActor() public view {
        assertEq(usdc.balanceOf(actor), 0);
    }
}

这个测试使用真实 USDC 的代理合约代码和历史存储,但 TokenPuller 是在本地分叉上新部署的测试合约。代币授权仍然需要真实满足 ERC-20 的状态要求。

这里的 test_ZeroBalanceActor 额外假定示例地址在所选历史区块的 USDC 余额为零。如果更换区块或账户,应先读取余额再决定断言;它不是任何随机地址永远为零的保证。

其中 vm.expectRevert() 只要求下一次调用回滚,不指定错误编码,因为不同代币实现可能使用不同的回滚字符串或自定义错误。更严格的集成测试可以在确认目标实现后,进一步检查具体错误原因。

运行测试并检查外部调用

本例已经在 setUp() 中主动创建分叉,因此命令行不必重复传入 --fork-url。环境变量必须在执行 Forge 的终端中可用。

bash
forge test --match-contract USDCForkTest -vvvv

预期结果:在 RPC 正常、依赖齐全、历史状态符合断言时,三个测试通过。

text
[PASS] test_RealTokenMetadata()
[PASS] test_TransferWithoutAllowanceReverts()
[PASS] test_ZeroBalanceActor()

实际输出还会包含 Gas、执行时间和测试套件统计,这些数值会随 Foundry 版本及运行环境变化。执行追踪可用于检查 TokenPuller.pull 是否进入真实 USDC 合约,以及失败是否发生在代币授权检查阶段。

对外部调用失败可以按以下顺序定位:

  1. 检查 USDC.code.length 是否大于零,排除地址、网络或区块错误。
  2. 检查 decimals() 与预期是否一致,避免将 6 位精度按 18 位精度计算。
  3. 检查 balanceOf(from) 和 allowance(from, spender),确认余额与授权是否足够。
  4. 使用 -vvvv 检查调用轨迹,定位真实回滚位置,区分被测合约的 require 与外部代币自身的回滚。

例如,100 USDC 的最小单位数量是 100000000,不是 100000000000000000000。如果资金管理合约错误地将 100 USDC 按 18 位精度传给 transferFrom,即使用户授权了 100 USDC,也可能因为所请求金额远超余额或额度而失败。

增加外部依赖的对抗性验证

真实协议测试不能只验证正常返回。应主动覆盖不授权、授权不足、资金不足、返回值不符合预期以及协议依赖状态变化等情况。

对抗场景 测试输入 验收要求
未授权 allowance = 0,拉取 1 最小单位 调用失败,不能转走资金
授权不足 allowance = 500000,拉取 1000000 调用失败或按协议明确定义的逻辑处理
精度错误 100 USDC 按 18 位换算 金额检查能识别错误数量级
余额不足 balance = 0,拉取 1 失败,不得错误记账
返回 false 使用明确返回 false 的测试代币 被测合约必须拒绝将失败调用当成成功

其中返回 false 的场景不适合仅通过真实 USDC 验证。应另外部署一个受控测试代币,让 transferFrom 返回 false,观察被测合约是否正确处理。这样可以覆盖真实 USDC 未必触发的 ERC-20 兼容性分支。

如果需要模拟用户持币并成功授权,可在 Fork 环境中使用测试账户获得资产,例如通过真实持币账户授权的合法调用,或者通过测试辅助工具修改本地状态。后一种方式必须在测试名称和注释中明确标记为人为注入状态,不能宣称完全复现了真实链上资金转移。

同样,面对 Uniswap 等外部协议,除检查目标地址存在代码外,还应验证池子真实储备、代币排序、手续费配置、调用路径以及滑点保护。不能因为 Mock Router 总能返回期望数量,就认定真实路由调用安全。

区分可复现性与真实环境覆盖

固定区块能够让相同测试尽量基于相同历史状态执行,但重复运行还依赖 RPC 数据一致性、测试代码、Foundry 版本和外部调用配置。建议在 CI 中固定以下信息:

  • 链 ID:以太坊主网为 1。
  • 区块号:本例为 19000000。
  • 外部合约地址:使用经过核验的主网部署地址。
  • 工具版本:记录 forge --version,团队统一版本。
  • RPC 能力:确保可以读取指定历史状态。

对于可升级代理协议,单个固定区块只能验证该历史时点的实现。若要检查升级影响,可以分别选择升级前后的区块,并验证代理实现、接口和关键业务行为。若需要测试尚未发生的升级,则必须在本地分叉上明确模拟升级操作及相应权限。

最终验收标准是:测试能够访问真实 USDC、正确读取 6 位精度、确认未授权资金拉取失败,并且同一固定区块在相同环境下可以重复执行。这样才能把本地业务逻辑缺陷、代币兼容性问题和 RPC 环境故障分开定位。

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

目录与阅读设置

阅读设置

17

记录一个想法

在主网分叉上验证外部依赖

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

登录哪都通