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

通过主网分叉复现依赖异常

通过主网分叉复现依赖异常

当合约依赖真实 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 环境。

bash
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 时必须回滚;价格必须大于零,时间戳不能位于未来,且不能超过允许年龄。

solidity
// 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 可以读取历史区块,然后执行:

bash
forge test --match-contract ForkDependencyTest -vv

预期结果:成功编译并连接到可用历史状态 RPC 后,测试摘要应显示 5 个测试通过、0 个失败。测试名称分别为:

text
[PASS] testAcceptsEmptyTokenReturn()
[PASS] testRealTokenMetadata()
[PASS] testRejectsNonPositivePrice()
[PASS] testRejectsStaleOracle()
[PASS] testRejectsTokenFalse()

测试耗时、Gas、编译信息和实际日志顺序可能不同,不应对它们进行固定字符串断言。

如果想单独查看过期价格案例,可运行:

bash
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、外部依赖地址、测试命令、依赖版本和五项断言结果。这样在修复合约逻辑后,测试人员能够使用同一个历史状态复核修复是否生效,而不会受到最新链上余额或报价变化的干扰。

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

目录与阅读设置

阅读设置

17

记录一个想法

通过主网分叉复现依赖异常

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

登录哪都通