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

用 Forge Fuzz 探索边界输入

用 Forge Fuzz 探索边界输入

智能合约在正常金额和固定账户下通过测试,不代表极小金额、不同调用者或连续提款时仍然安全。本课使用 Foundry 的 Forge Fuzz 自动生成测试输入,对一个 ETH 金库合约执行多账户存取操作,验证账户余额与合约资金约束,并学会定位和复现失败样本。

学习目标

  • 使用 testFuzz、vm.assume 和 bound 约束金额与账户输入。
  • 编写双账户存取款模糊测试,检查资金守恒与账户隔离。
  • 使用 Forge 执行、复现和分析失败样本,区分测试假设错误与真实漏洞。

理解 Fuzz 测试的输入空间

Forge 将带参数、名称以 testFuzz 开头的测试函数识别为模糊测试,并自动生成多组参数。与仅测试 1 ether 的普通单元测试相比,模糊测试能够覆盖零值、极大整数、不同地址以及其他容易遗漏的输入。

例如,一个存款函数接收 uint256 amount,其原始输入范围是 0 到 2^256 - 1。如果业务规定单笔存款不得超过 10 ether,就需要明确测试范围,而不能依赖随机数据恰好落在合理区间。

常用的输入处理方式如下:

方法 作用 适用情况
vm.assume(condition) 不满足条件时丢弃当前输入 排除零地址、重复账户等无效组合
bound(value, min, max) 将数值映射到指定闭区间 控制金额、时间和数组长度
vm.deal(account, amount) 设置测试账户的 ETH 余额 为不同金额的存款准备资金
vm.prank(account) 将下一次调用的 msg.sender 设为指定地址 模拟不同账户操作

vm.assume 不应大量用于限制整数范围。例如,直接假设随机 uint256 小于 10 ether,几乎所有随机值都会被丢弃,可能触发拒绝次数限制。金额范围优先使用 bound。

创建可测试的 ETH 金库

以下示例适用于使用 forge-std 测试库的 Foundry 项目。先在已有 Foundry 项目中创建 src/SecureVault.sol,使用 Solidity 0.8.24 编写一个包含存款、提款和余额查询的最小金库。

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

contract SecureVault {
    mapping(address => uint256) public balances;

    function deposit() external payable {
        require(msg.value > 0, "ZERO_DEPOSIT");
        balances[msg.sender] += msg.value;
    }

    function withdraw(uint256 amount) external {
        require(amount > 0, "ZERO_WITHDRAW");
        require(balances[msg.sender] >= amount, "INSUFFICIENT_BALANCE");

        // 先更新内部账本,避免外部调用期间重复使用旧余额。
        balances[msg.sender] -= amount;

        (bool ok, ) = payable(msg.sender).call{value: amount}("");
        require(ok, "TRANSFER_FAILED");
    }
}

这里使用 Checks-Effects-Interactions 顺序:先检查提款条件,再扣减余额,最后发送 ETH。外部转账失败时交易整体回滚,账本扣减也会回滚。

本次测试关注两个资金约束:正常存取后,合约持有的 ETH 应等于所有测试账户在金库中的余额之和;账户 A 提款时,账户 B 的内部余额不得发生变化。

该示例不处理第三方强制转入 ETH 等特殊情况,因此不能把“合约余额永远等于内部账本总额”无条件推广到任意主网部署环境。

编写金额与账户模糊测试

创建 test/SecureVault.t.sol,输入两个账户和两个金额。测试固定执行“账户 A 存款、账户 B 存款、账户 A 提款、账户 B 提款”的调用次序,并在关键位置检查资金约束。

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

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

contract SecureVaultFuzzTest is Test {
    SecureVault vault;

    function setUp() public {
        vault = new SecureVault();
    }

    function testFuzz_DepositWithdraw(
        address alice,
        address bob,
        uint256 rawAlice,
        uint256 rawBob
    ) public {
        // 排除影响测试独立性的账户组合。
        vm.assume(alice != address(0) && bob != address(0));
        vm.assume(alice != bob);
        vm.assume(alice != address(this) && bob != address(this));
        vm.assume(alice != address(vault) && bob != address(vault));
        vm.assume(alice.code.length == 0 && bob.code.length == 0);

        uint256 a = bound(rawAlice, 1 wei, 10 ether);
        uint256 b = bound(rawBob, 1 wei, 10 ether);

        vm.deal(alice, a);
        vm.deal(bob, b);

        // 两个账户分别存款,检查资金总量。
        vm.prank(alice);
        vault.deposit{value: a}();
        vm.prank(bob);
        vault.deposit{value: b}();

        assertEq(address(vault).balance, a + b);
        assertEq(vault.balances(alice), a);
        assertEq(vault.balances(bob), b);

        // A 提款不能影响 B 的账本。
        vm.prank(alice);
        vault.withdraw(a);
        assertEq(address(vault).balance, b);
        assertEq(vault.balances(bob), b);
        assertEq(alice.balance, a);

        vm.prank(bob);
        vault.withdraw(b);
        assertEq(address(vault).balance, 0);
        assertEq(vault.balances(alice), 0);
        assertEq(vault.balances(bob), 0);
        assertEq(bob.balance, b);
    }
}

bound 将任意生成金额映射到 1 wei 至 10 ether,因此不会因随机金额超过测试账户资金而产生无关失败。两个测试账户分别注入恰好足够的 ETH,完成全部提款后,预期各自恢复原有资金。

这里用 alice.code.length == 0 和 bob.code.length == 0 排除普通合约账户,因为没有接收 ETH 能力的合约可能导致转账失败。它不是对任意地址均安全的判定,也不能可靠地排除所有特殊地址。测试 EOA 场景时还应注意预编译地址等特殊目标;若发现这类反例,需要单独处理,而不是把所有失败一概视为金额漏洞。

本测试仅覆盖一种固定操作顺序,金额与账户会变化,但调用顺序不会自动随机化。

执行测试并检查失败样本

在项目根目录执行以下命令。项目需要安装 Foundry,并能解析 forge-std/Test.sol;如果是新项目,可先运行 forge init 创建标准目录和测试依赖。

bash
forge test --match-test testFuzz_DepositWithdraw -vvv

预期结果:在支持上述 Solidity 编译版本且依赖齐全的项目中,测试通过,Forge 输出包含类似以下内容的结果。具体运行次数、Gas 数据及耗时因 Foundry 版本和配置而异。

text
[PASS] testFuzz_DepositWithdraw(address,address,uint256,uint256)
Suite result: ok. 1 passed; 0 failed

若希望明确设置测试轮数,可在 foundry.toml 中加入以下配置片段。它依赖已有 Foundry 项目,修改后重新执行 forge test 生效。

toml
[fuzz]
runs = 1000
max_test_rejects = 65536

runs = 1000 表示每个 Fuzz 测试目标执行 1000 组有效输入;max_test_rejects 限制因假设不满足而被丢弃的输入次数。提高拒绝上限不能代替改进过严的前置条件。

如果测试失败,Forge 会报告反例参数。在支持失败样本持久化的 Foundry 版本中,默认还会保存可复现输入,后续重跑可能优先复用该样本。排查时应记录 Forge 版本、完整失败参数和失败断言,不要仅根据红色日志判断根因。

用真实错误验证断言是否有效

为了确认测试确实能够发现资金隔离问题,可以临时把 withdraw 中的余额扣减语句改为错误版本:

solidity
// 片段示例:仅用于本地故障注入,替换 SecureVault.withdraw 中的原扣减语句。
balances[msg.sender] = 0;

这段代码在全额提款场景下仍可能通过,因为每次提款恰好提走该账户全部余额。因此,当前测试虽然验证了双账户隔离,却无法发现“部分提款错误清零”的缺陷。

应再补充一个针对部分提款的测试:

solidity
function testFuzz_PartialWithdraw(uint256 rawAmount) public {
    uint256 amount = bound(rawAmount, 2 wei, 10 ether);
    address user = makeAddr("partial-user");
    vm.deal(user, amount);

    vm.prank(user);
    vault.deposit{value: amount}();

    // 只提走 1 wei,剩余余额必须仍可使用。
    vm.prank(user);
    vault.withdraw(1 wei);

    assertEq(vault.balances(user), amount - 1 wei);
    assertEq(address(vault).balance, amount - 1 wei);
}

该函数应添加在前面的 SecureVaultFuzzTest 合约内部,依赖原有的 Test、SecureVault 导入和 setUp 初始化。

预期结果:使用原始正确合约时测试通过;使用临时错误版本时,首次检查剩余账本余额的断言失败。因为金额至少为 2 wei,错误清零与正确剩余金额必然不同。

bash
forge test --match-test testFuzz_PartialWithdraw -vvv

确认测试能发现错误后,恢复 balances[msg.sender] -= amount;,再次执行测试,验证修复生效。

判断覆盖范围与测试局限

Fuzz 测试的质量取决于输入条件、操作顺序和断言,而不只是运行次数。对 ETH 金库可以使用以下验收表检查覆盖范围。

风险场景 本次覆盖情况 后续验证方式
极小金额及随机金额 已覆盖合法范围 额外断言零金额必须回滚
不同账户余额隔离 已覆盖双账户 增加第三账户操作
部分提款余额错误 已覆盖补充测试 变化提款比例与顺序
任意调用次序 未覆盖 使用状态机或不变量测试
恶意接收方重入 未覆盖 使用攻击合约模拟回调
第三方强制转入 ETH 未覆盖 单独测试额外 ETH 的处理规则

对无效输入,应测试其正确回滚,而不是简单地用 vm.assume 全部排除。例如,零金额提款可以使用 vm.expectRevert 验证预期拒绝行为。对于实际部署的资产合约,还应测试权限、外部调用失败、重入和资产精度边界。

本次双账户 Fuzz 验证的是给定前置条件与操作序列下的资金约束。如果目标是覆盖随机存款、部分提款、转账和多账户交错操作,应升级为 Foundry 的 Stateful Invariant Testing,由 Handler 生成多步调用序列,并持续检查全局资产约束。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Forge Fuzz 探索边界输入

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

登录哪都通