智能合约与以太坊 / 系统课时
在主网分叉上验证外部依赖
在主网分叉上验证外部依赖
本课使用 Foundry 在固定以太坊主网区块创建测试分叉,直接调用真实 USDC 合约,验证代币精度、授权限制和外部调用失败行为。完成后,你将拥有一套可重复执行的集成测试,并能判断本地 Mock 测试为什么不能替代真实链上依赖验证。
学习目标
- 使用固定区块和 RPC 配置创建可复现的主网分叉测试环境。
- 编写 Foundry 测试,检查真实 ERC-20 代币的接口行为和授权边界。
- 区分 Mock、Fork 与真实主网执行的验证范围,定位外部依赖兼容性问题。
理解主网分叉的测试边界
普通 Foundry 单元测试从本地 EVM 状态开始,外部代币通常需要自行部署 Mock。主网分叉测试则通过 RPC 读取指定区块的链上代码、账户余额和合约存储,使测试可以访问真实部署的协议。
例如,准备集成 USDC 的资金管理合约时,Mock 可能统一返回 18 位精度并允许任意转账,但以太坊主网 USDC 使用 6 位精度,而且转账受到余额与授权限制。只依赖这种 Mock,合约可能在真实部署后出现金额换算错误或交易回滚。

三种测试环境的适用范围如下:
| 环境 | 外部依赖 | 主要验证内容 |
|---|---|---|
| Mock 单测 | 自行模拟 | 本地业务分支、异常处理、边界输入 |
| 固定区块 Fork | 真实历史链上状态 | ABI 兼容性、实际代币行为、协议配置 |
| 真实主网交易 | 当前真实网络状态 | 最终执行、实际 Gas、交易排序与链上交互 |
Fork 不是主网交易重放的完整替代品。它默认没有后续区块中的状态变化,也不能保证历史分叉上的成功调用在未来主网上同样成功。测试产生的余额和存储变化不会提交到真实主网。
创建固定区块测试环境
下面使用以太坊主网区块 19000000。该区块已经包含 USDC 合约,适合验证代币接口。将 RPC 密钥配置为环境变量,避免把凭据写进 Solidity 文件或提交到仓库。
前提是已安装 Foundry,执行 forge --version 可以正常显示版本,并且拥有支持历史状态查询的以太坊主网 RPC 服务。
在已有 Foundry 项目根目录执行以下 Bash 命令。没有项目时先执行 forge init fork-lab,再进入新建目录。将地址替换为自己的以太坊主网 RPC 地址。
export MAINNET_RPC_URL='https://your-ethereum-rpc-endpoint'
forge test --fork-url "$MAINNET_RPC_URL" --fork-block-number 19000000 -vv预期结果:当项目现有测试通过且 RPC 支持该历史区块时,Forge 会显示测试通过统计。具体测试数量取决于项目,不应预设固定数量。
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 能够正常导入。
// 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 的终端中可用。
forge test --match-contract USDCForkTest -vvvv预期结果:在 RPC 正常、依赖齐全、历史状态符合断言时,三个测试通过。
[PASS] test_RealTokenMetadata()
[PASS] test_TransferWithoutAllowanceReverts()
[PASS] test_ZeroBalanceActor()实际输出还会包含 Gas、执行时间和测试套件统计,这些数值会随 Foundry 版本及运行环境变化。执行追踪可用于检查 TokenPuller.pull 是否进入真实 USDC 合约,以及失败是否发生在代币授权检查阶段。
对外部调用失败可以按以下顺序定位:
- 检查
USDC.code.length是否大于零,排除地址、网络或区块错误。 - 检查
decimals()与预期是否一致,避免将 6 位精度按 18 位精度计算。 - 检查
balanceOf(from)和allowance(from, spender),确认余额与授权是否足够。 - 使用
-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 环境故障分开定位。