智能合约与以太坊 / 系统课时
定义权限隔离与状态机约束
定义权限隔离与状态机约束
智能合约的安全测试不能只验证合法操作能否成功,还要确认无权限账户无法修改状态,以及业务对象不能跳过规定的状态转换。本课使用 Solidity 和 Foundry,将权限隔离、非法转换回滚、失败后状态不变三类要求写成可执行的模糊测试。
学习目标
- 区分权限约束、状态转换约束与操作失败后的状态保持约束。
- 使用 Foundry 模糊测试验证未授权调用和非法状态转换必须回滚。
- 建立合法操作与非法操作的测试矩阵,并验证状态机不能被绕过。
从业务规则提取安全属性
假设一个订单合约有管理员 Admin、操作员 Operator 两种角色,以及三个业务状态:Pending(待处理)、Active(处理中)、Closed(已关闭)。
业务规定:只有管理员可以激活订单;只有操作员可以关闭已经激活的订单;订单关闭之后不能重新激活。任何失败操作都不能改变订单状态。
可以将这些规则拆成三类属性:
| 属性类型 | 输入条件 | 必须满足的结果 |
|---|---|---|
| 权限隔离 | 非管理员调用 activate | 回滚,状态不变 |
| 权限隔离 | 非操作员调用 close | 回滚,状态不变 |
| 状态转换 | Pending 直接调用 close | 回滚,保持 Pending |
| 状态转换 | Closed 调用 activate | 回滚,保持 Closed |
| 合法转换 | 管理员激活 Pending | 成功,进入 Active |
| 合法转换 | 操作员关闭 Active | 成功,进入 Closed |
这里需要区分两个判断:调用者是否具有对应角色,以及当前状态是否允许执行该动作。通过权限检查并不意味着可以忽略状态检查。

一个重要边界是:权限失败和状态错误都应该使交易回滚,但不能假设它们一定返回同一种错误。测试安全属性时,首先验证操作被拒绝及状态不变,再根据需要验证具体错误类型。
实现带权限检查的最小状态机
下面使用 Solidity 0.8.24 编写一个可以测试的订单合约。它采用固定角色和自定义错误,避免引入额外的权限管理依赖,便于直接观察安全属性。
在已有 Foundry 项目中创建 src/OrderWorkflow.sol:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
contract OrderWorkflow {
enum State { Pending, Active, Closed }
error Unauthorized();
error InvalidState();
address public immutable admin;
address public immutable operator;
State public state;
constructor(address operator_) {
require(operator_ != address(0), "zero operator");
admin = msg.sender;
operator = operator_;
state = State.Pending;
}
function activate() external {
// 权限检查和状态检查必须同时满足。
if (msg.sender != admin) revert Unauthorized();
if (state != State.Pending) revert InvalidState();
state = State.Active;
}
function close() external {
if (msg.sender != operator) revert Unauthorized();
if (state != State.Active) revert InvalidState();
state = State.Closed;
}
}这份合约有两个刻意保留的设计约束。
第一,admin 和 operator 在部署时确定,测试时可以明确区分两个角色。生产合约若需要角色变更,还必须额外测试角色授予、撤销及管理员交接。
第二,所有状态修改都集中在两个入口函数,且仅在检查通过之后执行。Solidity 的 revert 会回滚当前调用产生的状态修改,因此非法操作不应留下部分状态变化。
特别注意:权限检查顺序会影响具体错误。无权限账户在错误状态下调用 close(),会先触发 Unauthorized(),而不是 InvalidState()。
使用模糊测试验证越权操作
Foundry 会为带参数且以 testFuzz 开头的测试函数生成多组输入。我们可以让它不断选择不同的调用者地址,检查这些地址是否能够越权修改订单。
在 test/OrderWorkflow.t.sol 中创建完整测试文件:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
import {Test} from "forge-std/Test.sol";
import {OrderWorkflow} from "../src/OrderWorkflow.sol";
contract OrderWorkflowTest is Test {
OrderWorkflow internal workflow;
address internal constant OPERATOR = address(0xB0B);
function setUp() public {
// 测试合约自身是部署者,因此也是管理员。
workflow = new OrderWorkflow(OPERATOR);
}
function testFuzz_NonAdminCannotActivate(address caller) public {
vm.assume(caller != address(this));
uint8 beforeState = uint8(workflow.state());
vm.prank(caller);
vm.expectRevert(OrderWorkflow.Unauthorized.selector);
workflow.activate();
assertEq(uint8(workflow.state()), beforeState);
}
function testFuzz_NonOperatorCannotClose(address caller) public {
vm.assume(caller != OPERATOR);
workflow.activate();
uint8 beforeState = uint8(workflow.state());
vm.prank(caller);
vm.expectRevert(OrderWorkflow.Unauthorized.selector);
workflow.close();
assertEq(uint8(workflow.state()), beforeState);
}
function testFuzz_InvalidTransition(uint8 choice) public {
if (choice % 2 == 0) {
// Pending 不允许直接进入 Closed。
vm.prank(OPERATOR);
vm.expectRevert(OrderWorkflow.InvalidState.selector);
workflow.close();
assertEq(uint8(workflow.state()), 0);
} else {
workflow.activate();
vm.prank(OPERATOR);
workflow.close();
// Closed 不允许重新激活。
vm.expectRevert(OrderWorkflow.InvalidState.selector);
workflow.activate();
assertEq(uint8(workflow.state()), 2);
}
}
function test_ValidLifecycle() public {
workflow.activate();
assertEq(uint8(workflow.state()), 1);
vm.prank(OPERATOR);
workflow.close();
assertEq(uint8(workflow.state()), 2);
}
}这组测试分别覆盖未授权激活、未授权关闭、非法状态转换以及正常状态生命周期。
vm.prank(caller) 只修改下一次调用的 msg.sender,所以可以在单次测试中模拟不同地址。vm.assume 用于排除不属于当前属性测试范围的输入:管理员不应作为非管理员测试的样本,操作员也不应作为非操作员测试的样本。
vm.expectRevert 要求随后的目标调用回滚并匹配指定错误。紧接着使用 assertEq 检查状态没有变化,避免只验证错误而忽略实际业务状态。
运行测试并解释结果
在 Foundry 项目根目录执行命令。前提是项目已经通过 forge init 初始化、存在 forge-std 测试依赖,并使用支持 Solidity 0.8.24 的编译器。
forge test --match-contract OrderWorkflowTest -vv预期结果:四个测试函数全部通过,输出中包含以下测试名称及 PASS 状态。
[PASS] testFuzz_InvalidTransition(uint8)
[PASS] testFuzz_NonAdminCannotActivate(address)
[PASS] testFuzz_NonOperatorCannotClose(address)
[PASS] test_ValidLifecycle()实际输出还会包含测试运行次数、Gas 消耗、编译信息等内容,具体数值随 Foundry 版本和运行配置变化。
建议增加模糊测试次数,使输入地址覆盖更充分:
forge test --match-contract OrderWorkflowTest --fuzz-runs 1000预期结果:所有测试仍通过;三个模糊测试分别执行约定数量的有效随机测试用例,普通测试仍执行一次。若启用了其他模糊测试配置,统计信息可能有所不同。
这里要避免一个误解:随机测试通过 1000 次,并不等于数学上证明所有地址和所有状态组合都安全。当前测试只覆盖明确编写的操作入口与属性。
还要检查测试是否过度排除输入。比如将 vm.assume 写成只接受某个固定地址,就会使原本覆盖大量地址的测试退化为极少数样本。
区分应当回滚和允许改变状态的操作
安全属性必须同时包含成功路径和拒绝路径,否则容易把一个始终回滚的合约误判为安全。
对当前订单业务,建议使用下面的验收矩阵:
| 当前状态 | 调用者 | 操作 | 预期行为 |
|---|---|---|---|
| Pending | Admin | activate | 成功,进入 Active |
| Pending | Operator | activate | 回滚,保持 Pending |
| Pending | Operator | close | 回滚,保持 Pending |
| Active | Admin | activate | 回滚,保持 Active |
| Active | Operator | close | 成功,进入 Closed |
| Active | 普通用户 | close | 回滚,保持 Active |
| Closed | Admin | activate | 回滚,保持 Closed |
| Closed | Operator | close | 回滚,保持 Closed |
其中最容易遗漏的是具有正确角色但状态不合法的情况。例如,操作员确实具有关闭权限,却不能直接关闭 Pending 订单。相反,管理员具有激活权限,也不能重新激活 Closed 订单。
还有一个必须验证的性质:合法操作确实能够到达目标状态。test_ValidLifecycle 就是用来排除所有操作都回滚的错误实现。
在真实项目中,如果合约还有余额、订单归属、计数器或事件日志,失败操作也应检查这些相关状态是否保持一致,不能只检查 state 一个变量。
将单步属性扩展为状态序列约束
前面的模糊测试针对单个调用或固定的短序列。对于具有充值、提现、暂停、恢复等多个入口的合约,还需要考虑随机操作序列中的状态约束。
例如,订单关闭后不允许重新打开,这不仅是一次 activate() 的拒绝规则,也是一条跨越任意后续调用的属性:一旦进入 Closed,所有允许执行的后续操作都不能使状态回到 Pending 或 Active。
Foundry 的 Invariant Testing 可以在测试期间对目标合约生成调用序列,并在序列执行过程中反复检查不变量。不过,状态机测试通常需要 Handler 来限定真实参与者、生成有意义的动作并记录历史状态,不能把任意随机调用的覆盖范围误认为完整业务覆盖。
实际扩展时,可以按以下顺序实施:
- 将所有会修改订单状态的外部函数列入状态机操作集合。
- 为每个操作定义调用者角色、允许的前置状态和成功后的状态。
- 用 Handler 构造多步调用序列,跟踪是否曾经进入 Closed。
- 在不变量检查中断言:如果历史记录表明订单已关闭,则当前状态始终为 Closed。
- 分别测试操作成功与回滚的场景,防止 Handler 把失败调用全部过滤掉。
本例最终形成三道可以自动执行的检查:错误角色不能改变状态,非法状态转换必须回滚,合法角色在正确状态下必须能够完成业务操作。后续增加任何新的状态或权限入口,都应该同步更新状态转换矩阵和对应测试。