智能合约与以太坊 / 系统课时
限制目标选择器与调用账户
限制目标选择器与调用账户
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。
// 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;模糊测试仍可能生成不合法参数并触发回滚,这属于正常的输入探索行为。
运行测试并检查目标配置
先在项目根目录执行测试,使用详细日志查看执行结果。
forge test --match-contract VaultInvariantTest -vv预期结果:如果项目依赖已经正确安装、Solidity 编译通过,测试汇总中会包含以下通过记录,具体运行次数和日志排版取决于 Foundry 版本及配置。
[PASS] invariant_totalMatchesBalances()默认不变量运行参数可以通过 foundry.toml 中的 [invariant] 配置调整。为了让不同目标配置使用相同预算进行比较,可以设置以下参数。
[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 包含第三方余额,而原不变量只统计两人,测试就可能失败。
这类失败不一定代表业务合约出现缺陷,也可能是测试断言的统计范围与调用身份范围不一致。修复时应根据实际业务选择扩大余额统计范围,或者恢复调用身份限制,不能直接删除失败断言。
避免目标过滤掩盖真实漏洞
目标选择器适合聚焦关键操作,但不能只保留最容易通过的路径。在有管理员、普通用户、清算人的真实协议中,可以把不同身份交互拆分为多个不变量测试场景。
一个借贷协议可以这样配置测试范围:
- 普通用户场景:目标函数包含存款、借款、还款和提款;发送者使用三个测试账户。
- 管理权限场景:目标函数包含暂停、恢复及风险参数更新;根据业务授权要求单独测试管理员和未授权地址。
- 清算场景:目标函数包含借款、抵押品价格变化处理及清算入口;通过专用 Handler 构造满足清算条件的状态。
这里的 Handler 是测试人员编写的操作包装合约,不是 Foundry 自动提供的业务函数。它可以约束金额、准备用户资产或构造合法前置状态。使用 Handler 时通常将 targetContract 和 targetSelector 指向 Handler,并由 Handler 调用真实协议。
还需要区分随机调用身份与内部调用身份:targetSender 控制的是模糊测试器发起目标调用所使用的 msg.sender。如果目标是 Handler,Handler 再调用其他合约,内部合约通常看到的是 Handler 地址,除非 Handler 显式使用测试作弊码等方式模拟其他身份。因此不能假设限制测试器的发送者后,所有内部合约都会直接识别为 Alice 或 Bob。
最后做一次覆盖检查:确认每个关键状态修改函数至少包含在一个测试目标集合中;为管理员和普通用户分别安排权限测试;比较不同配置下的回滚情况;对存款后提款、不同用户交替操作等重要序列编写确定性测试作为补充。
targetContract 决定测试对象,targetSelector 决定可执行操作,targetSender 决定调用身份。三者配合能够提高特定状态路径的探索效率,但限制越严格,越需要核对是否排除了真正可能引发漏洞的调用序列。