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

定义权限隔离与状态机约束

定义权限隔离与状态机约束

智能合约的安全测试不能只验证合法操作能否成功,还要确认无权限账户无法修改状态,以及业务对象不能跳过规定的状态转换。本课使用 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:

solidity
// 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 中创建完整测试文件:

solidity
// 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 的编译器。

bash
forge test --match-contract OrderWorkflowTest -vv

预期结果:四个测试函数全部通过,输出中包含以下测试名称及 PASS 状态。

text
[PASS] testFuzz_InvalidTransition(uint8)
[PASS] testFuzz_NonAdminCannotActivate(address)
[PASS] testFuzz_NonOperatorCannotClose(address)
[PASS] test_ValidLifecycle()

实际输出还会包含测试运行次数、Gas 消耗、编译信息等内容,具体数值随 Foundry 版本和运行配置变化。

建议增加模糊测试次数,使输入地址覆盖更充分:

bash
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 来限定真实参与者、生成有意义的动作并记录历史状态,不能把任意随机调用的覆盖范围误认为完整业务覆盖。

实际扩展时,可以按以下顺序实施:

  1. 将所有会修改订单状态的外部函数列入状态机操作集合。
  2. 为每个操作定义调用者角色、允许的前置状态和成功后的状态。
  3. 用 Handler 构造多步调用序列,跟踪是否曾经进入 Closed。
  4. 在不变量检查中断言:如果历史记录表明订单已关闭,则当前状态始终为 Closed。
  5. 分别测试操作成功与回滚的场景,防止 Handler 把失败调用全部过滤掉。

本例最终形成三道可以自动执行的检查:错误角色不能改变状态,非法状态转换必须回滚,合法角色在正确状态下必须能够完成业务操作。后续增加任何新的状态或权限入口,都应该同步更新状态转换矩阵和对应测试。

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

目录与阅读设置

阅读设置

17

记录一个想法

定义权限隔离与状态机约束

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

登录哪都通