智能合约与以太坊 / 系统课时
区分示例断言与普遍安全属性
区分示例断言与普遍安全属性
测试智能合约时,固定输入断言只能证明某个案例正确,无法保证其他金额、账户或调用顺序同样安全。本课通过一个 Foundry 可运行示例,对比单点断言与模糊测试属性,并学会把业务约束写成能够接受大量随机输入的测试。
学习目标
- 区分固定案例断言与适用于一组输入的安全属性。
- 使用 Foundry 编写示例测试和参数化模糊测试。
- 识别属性中的前置条件、断言范围及容易遗漏的边界。
固定断言究竟证明了什么
假设有一个储蓄合约,用户可以存入 ETH,并提取不超过自己余额的金额。业务要求是:成功存入多少,就应给该用户增加多少记账余额。
固定示例可以选择用户 Alice 存入 1 ETH,再检查余额是否等于 1 ETH。它明确、容易调试,但验证范围仅限这一笔交易。
| 测试方式 | 输入范围 | 能证明什么 | 主要盲区 |
|---|---|---|---|
| 示例断言 | 指定账户、1 ETH | 这个案例的结果正确 | 其他金额和账户 |
| 参数化模糊测试 | 大量生成的账户和金额 | 属性对本次执行的测试样本成立 | 未采样输入和调用序列 |
| 状态不变量测试 | 多次调用形成的状态序列 | 属性在被检查的可达状态中成立 | 未覆盖的操作及环境条件 |
注意:模糊测试通过并不等于数学证明。它只是用更多输入寻找反例;随机种子、运行次数和输入约束都会影响覆盖范围。
把业务规则改写为安全属性
对于存款功能,不要把规则写死成“存入 1 ETH 后余额为 1 ETH”。更通用的规则是:对任意有效用户和有效金额,成功存款后,该用户的余额增量必须等于存入金额。
设调用前余额为 、存款金额为 、调用后余额为 ,属性是:
这里必须说明三个边界:
- 前置条件:金额大于 0,发送者拥有足够 ETH,且调用成功。
- 检查对象:当前调用者的记账余额,而不是所有用户余额。
- 检查时机:存款交易执行成功之后,读取最新状态。
当用户存入 0 时,如果业务规定必须拒绝,就应另外验证回退行为,而不是随意把 0 纳入成功存款属性。
业务中至少应区分三类约束:成功操作的后置条件、非法操作必须回退的条件,以及无论经过多少次操作都不能破坏的全局不变量。例如“任何用户不能提取超过自身余额的资产”与“所有用户记账余额之和不超过合约实际资产”属于不同检查范围。
使用 Foundry 验证两种断言
以下示例适用于 Foundry 的 Forge 测试环境,使用 Solidity 0.8.24 和 forge-std。先创建工程:
forge init property-demo
cd property-demo预期结果:生成包含 `src`、`test`、`lib/forge-std` 的 Foundry 项目。初始化命令的终端日志可能随 Foundry 版本不同。
将以下完整合约保存为 `src/Savings.sol`:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
contract Savings {
mapping(address => uint256) public balances;
function deposit() external payable {
require(msg.value > 0, "zero deposit");
// 只增加实际付款者的余额,避免替其他账户记账。
balances[msg.sender] += msg.value;
}
}合约使用映射记录账户余额,`deposit` 只接受正数金额。接下来将测试文件保存为 `test/Savings.t.sol`:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
import {Test} from "forge-std/Test.sol";
import {Savings} from "../src/Savings.sol";
contract SavingsTest is Test {
Savings internal savings;
function setUp() public {
savings = new Savings();
}
function test_DepositExample() public {
address alice = makeAddr("alice");
vm.deal(alice, 2 ether);
vm.prank(alice);
savings.deposit{value: 1 ether}();
assertEq(savings.balances(alice), 1 ether);
}
function testFuzz_DepositIncreasesBalance(
address user,
uint96 rawAmount
) public {
// 排除无法作为普通测试发送者使用的特殊地址。
vm.assume(user != address(0));
vm.assume(user != address(savings));
vm.assume(user != address(this));
uint256 amount = bound(uint256(rawAmount), 1, 100 ether);
uint256 beforeBalance = savings.balances(user);
vm.deal(user, amount);
vm.prank(user);
savings.deposit{value: amount}();
// 验证余额增量,而不是某个写死的最终金额。
assertEq(savings.balances(user), beforeBalance + amount);
}
}`test_DepositExample` 是固定断言;`testFuzz_DepositIncreasesBalance` 接收 Forge 生成的地址和无符号整数。`bound` 将测试金额映射至 1 wei~100 ETH,`vm.deal` 为发送者配置测试余额,`vm.prank` 将下一次调用的发送者设置为指定用户。
这里使用了 `vm.assume` 过滤少量特殊地址。不要用大量 `assume` 排除普通输入,否则会降低生成有效案例的效率。测试金额已通过 `bound` 限定,也不需要再用 `assume` 检查金额范围。
运行测试:
forge test --match-contract SavingsTest -vv预期结果:两个测试均通过;模糊测试项会显示 `runs` 和 `μ` 等统计信息,具体数值依运行配置及 Foundry 版本而变化。
[PASS] test_DepositExample()
[PASS] testFuzz_DepositIncreasesBalance(address,uint96)上述是关键通过状态的摘录,并非完整终端输出。通过只能表明合约满足当前两类测试,不能据此断言所有存取款行为安全。
利用故意引入的缺陷比较检出能力
现在做一次受控实验:暂时把 `Savings.sol` 中增加余额的语句改为以下错误实现(片段示例,依赖前面的完整合约):
// 错误:某个金额会被多记 1 wei。
if (msg.value == 2 ether) {
balances[msg.sender] += msg.value + 1;
} else {
balances[msg.sender] += msg.value;
}执行两个测试:
forge test --match-contract SavingsTest -vv预期结果:固定的 1 ETH 示例仍会通过。模糊测试只有在生成或映射出恰好 2 ETH 时才会失败;如果没有命中,也可能通过。这恰好说明模糊测试不能保证发现极窄的触发条件。
为了确定性地验证这个缺陷,再增加一个针对 2 ETH 的固定回归案例。放入 `SavingsTest` 合约内部(片段示例,复用已有 `savings` 和 `setUp`):
function test_DepositTwoEtherRegression() public {
address alice = makeAddr("alice");
vm.deal(alice, 2 ether);
vm.prank(alice);
savings.deposit{value: 2 ether}();
assertEq(savings.balances(alice), 2 ether);
}预期结果:在错误实现下,该测试失败,因为实际记账余额为 `2 ether + 1`。恢复原合约后,三个测试都应该通过。
这个实验体现两类测试的互补关系:示例断言适合锁定已知缺陷和关键业务案例,模糊测试适合探索未知输入组合。找到反例后,应把它固化为回归测试,避免以后只依赖随机采样再次命中。
判断属性是否真正覆盖业务约束
写完测试后,可以从以下角度逐条审查:
| 检查项 | 不足的写法 | 更有效的写法 |
|---|---|---|
| 金额范围 | 永远存入 1 ETH | 覆盖 1 wei 到业务上限 |
| 断言依据 | 只检查函数没有回退 | 检查存款前后的余额增量 |
| 身份范围 | 始终使用同一发送者 | 生成不同有效发送者 |
| 失败路径 | 只测成功操作 | 单独检查零金额是否回退 |
| 操作序列 | 仅验证一次存款 | 使用状态化测试检查多次存取 |
一个很容易出现的伪属性是 `assertTrue(balance >= 0)`:由于 Solidity 的 `uint256` 本来就不会小于 0,这种断言几乎不提供业务保障。
还要留意测试代码自身的假设。若通过过度约束金额、强制余额初始化为固定值,或者只在操作前检查状态,可能导致测试虽然全部通过,却没有验证原本关心的安全性质。
对于更复杂的储蓄合约,下一步应验证跨账户隔离、提取后余额变化、失败交易不改变状态,以及多次操作后的资产守恒。这些约束需要额外的测试用例或状态化模糊测试,不能由当前存款增量属性自动推出。
实际项目中保留少量清晰的固定回归案例,再用参数化属性扩大输入范围;已知边界必须确定性测试,随机模糊测试负责探索未预料的反例。