智能合约与以太坊 / 系统课时
通过主网分叉复现依赖异常
通过主网分叉复现依赖异常
当合约依赖真实 ERC20 代币和链上价格预言机时,普通 Mock 测试可能掩盖兼容性问题。本课使用 Foundry 固定以太坊主网区块,读取真实合约状态,再注入代币异常返回值与过期价格,验证业务合约是否能够安全拒绝异常数据。
学习目标
- 使用 Foundry 在指定主网区块创建可重复运行的 Fork 测试。
- 复现 ERC20 无返回值、返回 false 和价格源数据过期三种情况。
- 区分真实链上状态与测试注入的异常,并编写可验证的安全断言。
固定主网区块与依赖地址
主网分叉会从 RPC 节点读取指定区块的账户、合约代码和存储状态,并在本地 EVM 中执行测试交易。测试修改不会广播到主网,也不需要持有真实资产。
本例使用以下固定参数:
| 参数 | 测试值 | 作用 |
|---|---|---|
| 网络 | Ethereum Mainnet | 使用真实主网合约 |
| 固定区块 | 19000000 | 冻结基础链上状态 |
| USDT | 0xdAC17F958D2ee523a2206206994597C13D831ec7 |
测试代币兼容性 |
| ETH/USD Feed | 0x5f4ec3df9Cbd43714FE2740f5E3616155c5b8419 |
测试 Chainlink 价格数据 |
| 最大价格年龄 | 3600 秒 | 检测过期数据 |
先安装 Foundry,并创建测试工程。以下命令适用于已经安装 forge 的 macOS、Linux 或 WSL 环境。
forge init fork-deps
cd fork-deps
forge --version预期结果:输出已安装的 Foundry 版本信息,具体版本号可能不同,同时项目中存在 src/、test/ 与 lib/forge-std/。
设置环境变量 MAINNET_RPC_URL,值为支持以太坊主网历史状态查询的 RPC 地址。不要将 RPC 密钥写入 Solidity 源码或提交到仓库。所选节点必须能够读取区块 19000000 的合约状态;没有相应历史状态能力的节点可能报错。
理解 Fork 与异常注入的边界
本例涉及测试合约、被测业务合约、USDT 和 Chainlink Feed 四个对象。Fork 提供真实合约及区块状态,vm.mockCall 则只覆盖指定外部调用的返回数据,用于模拟真实快照未必发生过的故障。

需要区分两种测试结果:
- 真实状态测试:直接调用区块 19000000 的 USDT,检查
decimals()是否为 6。这验证 Fork 确实加载了真实合约。 - 故障注入测试:用
vm.mockCall替换代币转账或价格读取的返回值。这验证业务合约在指定异常条件下的反应,不代表该异常真实发生于区块 19000000。
vm.mockCall 可以按目标地址及调用数据匹配外部调用。它不会改变主网历史,也不能代替针对代币手续费、黑名单、权限和真实余额变化的完整集成测试。
编写可复现的 Fork 安全测试
在 test/ForkDependency.t.sol 创建以下完整测试文件。示例采用 Solidity 0.8.20 语法和 Foundry 的 forge-std/Test.sol,不依赖额外的 Chainlink 或 OpenZeppelin 包。
业务合约实现两个防护规则:代币转账允许空返回值,但显式返回 false 时必须回滚;价格必须大于零,时间戳不能位于未来,且不能超过允许年龄。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import {Test} from "forge-std/Test.sol";
interface IERC20Metadata {
function decimals() external view returns (uint8);
}
interface IPriceFeed {
function latestRoundData() external view returns (
uint80 roundId,
int256 answer,
uint256 startedAt,
uint256 updatedAt,
uint80 answeredInRound
);
}
contract DependencyGuard {
address public immutable token;
IPriceFeed public immutable feed;
constructor(address token_, address feed_) {
token = token_;
feed = IPriceFeed(feed_);
}
function send(address to, uint256 amount) external {
// 兼容不返回 bool 的历史 ERC20 实现。
(bool ok, bytes memory data) = token.call(
abi.encodeWithSignature("transfer(address,uint256)", to, amount)
);
require(ok, "TOKEN_CALL_FAILED");
require(
data.length == 0 ||
(data.length == 32 && abi.decode(data, (bool))),
"TOKEN_FAILED"
);
}
function readPrice() external view returns (int256) {
(, int256 answer, , uint256 updatedAt, ) =
feed.latestRoundData();
require(answer > 0, "BAD_PRICE");
require(updatedAt <= block.timestamp, "FUTURE_PRICE");
require(
block.timestamp - updatedAt <= 3600,
"STALE_PRICE"
);
return answer;
}
}
contract ForkDependencyTest is Test {
address constant USDT =
0xdAC17F958D2ee523a2206206994597C13D831ec7;
address constant ETH_USD =
0x5f4ec3df9Cbd43714FE2740f5E3616155c5b8419;
DependencyGuard guard;
function setUp() public {
// 每个测试固定在同一个历史区块上开始。
vm.createSelectFork(vm.envString("MAINNET_RPC_URL"), 19000000);
guard = new DependencyGuard(USDT, ETH_USD);
}
function testRealTokenMetadata() public view {
assertEq(IERC20Metadata(USDT).decimals(), 6);
}
function testRejectsTokenFalse() public {
// 仅替换该笔 transfer 的返回值,不实际转账。
bytes memory callData = abi.encodeWithSignature(
"transfer(address,uint256)", address(0xBEEF), 1e6
);
vm.mockCall(USDT, callData, abi.encode(false));
vm.expectRevert(bytes("TOKEN_FAILED"));
guard.send(address(0xBEEF), 1e6);
}
function testAcceptsEmptyTokenReturn() public {
// 模拟成功调用但没有 ABI 返回数据的代币。
bytes memory callData = abi.encodeWithSignature(
"transfer(address,uint256)", address(0xBEEF), 1e6
);
vm.mockCall(USDT, callData, bytes(""));
guard.send(address(0xBEEF), 1e6);
}
function testRejectsStaleOracle() public {
uint256 staleTime = block.timestamp - 7200;
bytes memory result = abi.encode(
uint80(1), int256(2000e8),
staleTime, staleTime, uint80(1)
);
vm.mockCall(
ETH_USD,
abi.encodeWithSelector(IPriceFeed.latestRoundData.selector),
result
);
vm.expectRevert(bytes("STALE_PRICE"));
guard.readPrice();
}
function testRejectsNonPositivePrice() public {
bytes memory result = abi.encode(
uint80(1), int256(0),
block.timestamp, block.timestamp, uint80(1)
);
vm.mockCall(
ETH_USD,
abi.encodeWithSelector(IPriceFeed.latestRoundData.selector),
result
);
vm.expectRevert(bytes("BAD_PRICE"));
guard.readPrice();
}
}这段代码中的 DependencyGuard 是教学用最小业务合约,不是完整的生产级资产托管实现。其 send() 没有访问控制,不应直接部署并存入资产;生产系统必须补齐调用者权限、资金归属和额度等约束。这里使用空返回值模拟兼容性,不能据此证明真实转账已经发生。
对于价格源,2000e8 表示一个假设的 8 位精度报价,数值为 2000,并非历史真实价格。模拟过期时间为当前 Fork 区块时间减去 7200 秒,超过业务设置的 3600 秒阈值。
运行测试并核对断言
确认 MAINNET_RPC_URL 已在执行 forge 的终端环境中设置,并且 RPC 可以读取历史区块,然后执行:
forge test --match-contract ForkDependencyTest -vv预期结果:成功编译并连接到可用历史状态 RPC 后,测试摘要应显示 5 个测试通过、0 个失败。测试名称分别为:
[PASS] testAcceptsEmptyTokenReturn()
[PASS] testRealTokenMetadata()
[PASS] testRejectsNonPositivePrice()
[PASS] testRejectsStaleOracle()
[PASS] testRejectsTokenFalse()测试耗时、Gas、编译信息和实际日志顺序可能不同,不应对它们进行固定字符串断言。
如果想单独查看过期价格案例,可运行:
forge test --match-test testRejectsStaleOracle -vvvv预期结果:该测试显示 [PASS],详细执行轨迹中可以检查价格源调用和预期回滚。由于 vm.expectRevert 已声明预期异常,发生 STALE_PRICE 回滚代表保护逻辑正常工作,而不是测试失败。
验收时重点检查三个事实:真实 USDT 的精度读取成功;模拟返回 false 的转账被拒绝;超过 3600 秒的预言机报价被拒绝。空返回值案例只是兼容性验证,不是资金到账验证。
排查 Fork 失败与错误的安全结论
| 现象 | 可能原因 | 修复或核对方法 |
|---|---|---|
MAINNET_RPC_URL 未设置 |
环境变量未传入进程 | 在同一终端设置并重新运行 |
| 历史状态读取失败 | RPC 不支持所需历史状态 | 使用具备历史状态查询能力的节点 |
| 真实合约调用失败 | 链 ID 或目标网络错误 | 确认 RPC 为以太坊主网,检查区块号及合约地址 |
| Mock 测试通过但真实调用失败 | Mock 覆盖了真实返回行为 | 添加不使用 Mock 的独立集成测试 |
| 价格校验意外通过 | 时间阈值或注入数据有误 | 检查 updatedAt、区块时间及 3600 秒阈值 |
对于价格源还应测试 latestRoundData() 直接回滚、负数报价、未来时间戳和 updatedAt 为零的情况。零时间戳会因年龄过大被本例拒绝;生产合约可以增加更明确的未初始化数据检查,并根据所依赖 Feed 的更新频率选择合理的有效期。
交付回归测试时,记录链 ID 1、固定区块 19000000、外部依赖地址、测试命令、依赖版本和五项断言结果。这样在修复合约逻辑后,测试人员能够使用同一个历史状态复核修复是否生效,而不会受到最新链上余额或报价变化的干扰。