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

区分示例断言与普遍安全属性

区分示例断言与普遍安全属性

测试智能合约时,固定输入断言只能证明某个案例正确,无法保证其他金额、账户或调用顺序同样安全。本课通过一个 Foundry 可运行示例,对比单点断言与模糊测试属性,并学会把业务约束写成能够接受大量随机输入的测试。

学习目标

  • 区分固定案例断言与适用于一组输入的安全属性。
  • 使用 Foundry 编写示例测试和参数化模糊测试。
  • 识别属性中的前置条件、断言范围及容易遗漏的边界。

固定断言究竟证明了什么

假设有一个储蓄合约,用户可以存入 ETH,并提取不超过自己余额的金额。业务要求是:成功存入多少,就应给该用户增加多少记账余额。

固定示例可以选择用户 Alice 存入 1 ETH,再检查余额是否等于 1 ETH。它明确、容易调试,但验证范围仅限这一笔交易。

测试方式 输入范围 能证明什么 主要盲区
示例断言 指定账户、1 ETH 这个案例的结果正确 其他金额和账户
参数化模糊测试 大量生成的账户和金额 属性对本次执行的测试样本成立 未采样输入和调用序列
状态不变量测试 多次调用形成的状态序列 属性在被检查的可达状态中成立 未覆盖的操作及环境条件

注意:模糊测试通过并不等于数学证明。它只是用更多输入寻找反例;随机种子、运行次数和输入约束都会影响覆盖范围。

把业务规则改写为安全属性

对于存款功能,不要把规则写死成“存入 1 ETH 后余额为 1 ETH”。更通用的规则是:对任意有效用户和有效金额,成功存款后,该用户的余额增量必须等于存入金额。

设调用前余额为 BB、存款金额为 AA、调用后余额为 B′B',属性是:

B′=B+AB'=B+A

这里必须说明三个边界:

  • 前置条件:金额大于 0,发送者拥有足够 ETH,且调用成功。
  • 检查对象:当前调用者的记账余额,而不是所有用户余额。
  • 检查时机:存款交易执行成功之后,读取最新状态。

当用户存入 0 时,如果业务规定必须拒绝,就应另外验证回退行为,而不是随意把 0 纳入成功存款属性。

业务中至少应区分三类约束:成功操作的后置条件、非法操作必须回退的条件,以及无论经过多少次操作都不能破坏的全局不变量。例如“任何用户不能提取超过自身余额的资产”与“所有用户记账余额之和不超过合约实际资产”属于不同检查范围。

使用 Foundry 验证两种断言

以下示例适用于 Foundry 的 Forge 测试环境,使用 Solidity 0.8.24 和 forge-std。先创建工程:

bash
forge init property-demo
cd property-demo

预期结果:生成包含 `src`、`test`、`lib/forge-std` 的 Foundry 项目。初始化命令的终端日志可能随 Foundry 版本不同。

将以下完整合约保存为 `src/Savings.sol`:

solidity
// 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`:

solidity
// 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` 检查金额范围。

运行测试:

bash
forge test --match-contract SavingsTest -vv

预期结果:两个测试均通过;模糊测试项会显示 `runs` 和 `μ` 等统计信息,具体数值依运行配置及 Foundry 版本而变化。

text
[PASS] test_DepositExample()
[PASS] testFuzz_DepositIncreasesBalance(address,uint96)

上述是关键通过状态的摘录,并非完整终端输出。通过只能表明合约满足当前两类测试,不能据此断言所有存取款行为安全。

利用故意引入的缺陷比较检出能力

现在做一次受控实验:暂时把 `Savings.sol` 中增加余额的语句改为以下错误实现(片段示例,依赖前面的完整合约):

solidity
// 错误:某个金额会被多记 1 wei。
if (msg.value == 2 ether) {
    balances[msg.sender] += msg.value + 1;
} else {
    balances[msg.sender] += msg.value;
}

执行两个测试:

bash
forge test --match-contract SavingsTest -vv

预期结果:固定的 1 ETH 示例仍会通过。模糊测试只有在生成或映射出恰好 2 ETH 时才会失败;如果没有命中,也可能通过。这恰好说明模糊测试不能保证发现极窄的触发条件。

为了确定性地验证这个缺陷,再增加一个针对 2 ETH 的固定回归案例。放入 `SavingsTest` 合约内部(片段示例,复用已有 `savings` 和 `setUp`):

solidity
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,这种断言几乎不提供业务保障。

还要留意测试代码自身的假设。若通过过度约束金额、强制余额初始化为固定值,或者只在操作前检查状态,可能导致测试虽然全部通过,却没有验证原本关心的安全性质。

对于更复杂的储蓄合约,下一步应验证跨账户隔离、提取后余额变化、失败交易不改变状态,以及多次操作后的资产守恒。这些约束需要额外的测试用例或状态化模糊测试,不能由当前存款增量属性自动推出。

实际项目中保留少量清晰的固定回归案例,再用参数化属性扩大输入范围;已知边界必须确定性测试,随机模糊测试负责探索未预料的反例。

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

目录与阅读设置

阅读设置

17

记录一个想法

区分示例断言与普遍安全属性

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

登录哪都通