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

限制目标选择器与调用账户

限制目标选择器与调用账户

Foundry 的不变量测试会连续执行随机函数调用,但默认目标范围可能过宽,导致大量无关调用消耗测试预算。本课使用 targetContract、targetSelector 和 targetSender 精确控制合约、函数和调用身份,并通过一个可运行的账户余额示例,观察目标集合如何影响状态覆盖与缺陷发现能力。

学习目标

  • 掌握三个目标过滤接口的作用、调用方式及组合关系。
  • 编写包含指定函数选择器和调用账户的不变量测试。
  • 根据调用覆盖情况调整目标集合,避免测试通过却遗漏关键状态转换。

理解三个目标过滤维度

Foundry 的状态不变量测试会生成多次函数调用,执行一段调用序列后检查 invariant_ 开头的测试函数。每次调用都涉及三个关键维度:调用哪个合约、执行哪个函数、以什么身份调用。

接口 限制对象 典型用途
targetContract(address) 被随机调用的合约地址 只测试资金池或业务处理器
targetSelector(FuzzSelector) 指定合约的函数选择器集合 聚焦存款、取款等状态转换
targetSender(address) 随机调用使用的发送者地址 模拟普通用户、管理员等身份

这三个接口由 forge-std/StdInvariant.sol 提供,通常在测试合约的 setUp() 中配置。

未显式配置目标合约时,Foundry 通常会把 setUp() 中部署的合约纳入候选。未限制发送者时,模糊测试器可以生成随机调用身份。使用显式目标后,测试范围由配置的目标集合决定。

不变量测试的合约、选择器与发送者三个过滤维度

需要特别注意,targetSelector 接收的不是单个 bytes4,而是包含目标合约地址和选择器数组的 FuzzSelector 结构体。同一个合约可以选择多个函数,函数选择器通常通过 ContractName.functionName.selector 获取。

编写指定目标的不变量测试

下面使用一个简化的内部记账合约。用户可以调用 deposit 增加余额,调用 withdraw 扣减余额。系统维护所有用户余额的总和 totalDeposits。

测试目标是验证:在仅有 Alice 和 Bob 两个调用者的情况下,无论存款与取款以什么顺序发生,两人的余额之和始终等于合约记录的总余额。

前置条件:已经安装 Foundry,并在项目目录执行过 forge init,确保存在 lib/forge-std 依赖。将以下完整 Solidity 代码保存到 test/VaultInvariant.t.sol。

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

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

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

    // 同步更新用户余额和总账
    function deposit(uint256 amount) external {
        require(amount > 0 && amount <= 1000, "invalid amount");
        balances[msg.sender] += amount;
        totalDeposits += amount;
    }

    function withdraw(uint256 amount) external {
        require(amount > 0, "zero amount");
        require(balances[msg.sender] >= amount, "insufficient balance");
        balances[msg.sender] -= amount;
        totalDeposits -= amount;
    }
}

contract VaultInvariantTest is StdInvariant, Test {
    Vault internal vault;
    address internal alice = address(0xA11CE);
    address internal bob = address(0xB0B);

    function setUp() public {
        vault = new Vault();

        // 只对目标资金池执行随机调用
        targetContract(address(vault));

        bytes4[] memory selectors = new bytes4[](2);
        selectors[0] = Vault.deposit.selector;
        selectors[1] = Vault.withdraw.selector;

        // 将随机调用限定为两个修改余额的函数
        targetSelector(
            FuzzSelector({
                addr: address(vault),
                selectors: selectors
            })
        );

        // 只使用 Alice 和 Bob 两个调用身份
        targetSender(alice);
        targetSender(bob);
    }

    function invariant_totalMatchesBalances() public view {
        uint256 sum = vault.balances(alice) + vault.balances(bob);
        assertEq(vault.totalDeposits(), sum);
    }
}

代码中 deposit 和 withdraw 都使用 msg.sender 区分用户。targetSender(alice) 与 targetSender(bob) 将外部随机调用的身份限制为这两个地址,因此不变量能够通过查询两人的余额来校验总账。

这个示例使用模拟记账单位,不传输真实 ETH,也不代表完整的资金托管合约。deposit 的单次金额限制为 1~1000;模糊测试仍可能生成不合法参数并触发回滚,这属于正常的输入探索行为。

运行测试并检查目标配置

先在项目根目录执行测试,使用详细日志查看执行结果。

bash
forge test --match-contract VaultInvariantTest -vv

预期结果:如果项目依赖已经正确安装、Solidity 编译通过,测试汇总中会包含以下通过记录,具体运行次数和日志排版取决于 Foundry 版本及配置。

text
[PASS] invariant_totalMatchesBalances()

默认不变量运行参数可以通过 foundry.toml 中的 [invariant] 配置调整。为了让不同目标配置使用相同预算进行比较,可以设置以下参数。

toml
[invariant]
runs = 256
depth = 50
fail_on_revert = false

这些配置的含义分别是执行 256 轮不变量测试、每轮尝试生成深度为 50 的调用序列,以及不把普通调用回滚直接判定为不变量失败。具体可执行调用数量还会受到回滚、生成策略和测试执行情况影响。

配置生效后再次执行相同的 forge test 命令,观察是否仍然通过。也可以使用 forge test --match-contract VaultInvariantTest -vvv 检查更详细的运行信息。

比较不同目标集合的覆盖范围

三个接口的组合决定随机调用能够探索哪些状态。对本例而言,限制合约为 Vault 后,再选择两个改变余额的函数,测试器就不必把执行预算分配给余额查询等无关调用。

可以依次调整 setUp(),在相同的 runs = 256 和 depth = 50 下比较不同配置。

配置 允许的主要行为 覆盖上的影响
仅 targetContract 目标合约中可调用的 ABI 函数 范围较广,可能浪费调用预算
增加 targetSelector,只选择 deposit 仅增加用户余额 无法探索取款后的状态
选择 deposit 和 withdraw 存入、扣减、连续存取 可以探索更多账户余额转换
再限制 Alice 和 Bob 两个指定身份执行上述函数 适合检查固定身份集合的余额关系

例如,保留 deposit 而删除 withdraw 选择器后,不变量仍可能通过,但完全不能证明取款逻辑正确。这是目标集合过窄造成的测试盲区。

反过来,如果移除两行 targetSender,随机调用身份将不再限制为 Alice 和 Bob。此时其他地址也可能成功存款,导致 totalDeposits 包含第三方余额,而原不变量只统计两人,测试就可能失败。

这类失败不一定代表业务合约出现缺陷,也可能是测试断言的统计范围与调用身份范围不一致。修复时应根据实际业务选择扩大余额统计范围,或者恢复调用身份限制,不能直接删除失败断言。

避免目标过滤掩盖真实漏洞

目标选择器适合聚焦关键操作,但不能只保留最容易通过的路径。在有管理员、普通用户、清算人的真实协议中,可以把不同身份交互拆分为多个不变量测试场景。

一个借贷协议可以这样配置测试范围:

  1. 普通用户场景:目标函数包含存款、借款、还款和提款;发送者使用三个测试账户。
  2. 管理权限场景:目标函数包含暂停、恢复及风险参数更新;根据业务授权要求单独测试管理员和未授权地址。
  3. 清算场景:目标函数包含借款、抵押品价格变化处理及清算入口;通过专用 Handler 构造满足清算条件的状态。

这里的 Handler 是测试人员编写的操作包装合约,不是 Foundry 自动提供的业务函数。它可以约束金额、准备用户资产或构造合法前置状态。使用 Handler 时通常将 targetContract 和 targetSelector 指向 Handler,并由 Handler 调用真实协议。

还需要区分随机调用身份与内部调用身份:targetSender 控制的是模糊测试器发起目标调用所使用的 msg.sender。如果目标是 Handler,Handler 再调用其他合约,内部合约通常看到的是 Handler 地址,除非 Handler 显式使用测试作弊码等方式模拟其他身份。因此不能假设限制测试器的发送者后,所有内部合约都会直接识别为 Alice 或 Bob。

最后做一次覆盖检查:确认每个关键状态修改函数至少包含在一个测试目标集合中;为管理员和普通用户分别安排权限测试;比较不同配置下的回滚情况;对存款后提款、不同用户交替操作等重要序列编写确定性测试作为补充。

targetContract 决定测试对象,targetSelector 决定可执行操作,targetSender 决定调用身份。三者配合能够提高特定状态路径的探索效率,但限制越严格,越需要核对是否排除了真正可能引发漏洞的调用序列。

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

目录与阅读设置

阅读设置

17

记录一个想法

限制目标选择器与调用账户

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

登录哪都通