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

断言未授权操作必须回滚

断言未授权操作必须回滚

修复智能合约的访问控制漏洞后,不能只验证管理员可以操作,还要证明普通账户、伪造签名和重复领取请求一定会回滚。本课使用 Solidity、Hardhat 3 和 Ethers.js 6 编写负向测试,检查回滚原因、状态不变性以及正常授权路径,防止修复后仍存在绕过入口。

学习目标

  • 使用 revertedWithCustomError 断言未授权调用发生预期回滚。
  • 覆盖管理员角色、签名校验和重复领取三类负向场景。
  • 验证失败交易不会改变合约状态,并保留成功路径作为对照。

明确负向测试的判断标准

在 EVM 中,执行期间触发 revert 会撤销该调用事务产生的合约状态变更。测试不能只检查调用失败,因为余额不足、参数编码错误或者其他漏洞同样可能导致失败。

针对三个常见入口,分别定义可验证的安全不变量:

测试入口 非法输入 必须满足的结果
管理员操作 普通账户调用 setLimit 回滚 Unauthorized,限额不变
签名授权 使用其他领取人的有效签名 回滚 InvalidSignature,领取状态不变
重复领取 同一账户再次提交已用授权 回滚 AlreadyClaimed,不得再次转账

这里采用自定义错误而不是依赖字符串消息。自定义错误能够通过错误选择器与参数进行精确匹配,且通常比字符串回滚原因更节省 Gas。

对于签名授权,还需要把领取人地址、金额、链 ID 和合约地址纳入签名摘要,防止授权被转移给其他账户或在不同部署之间重放。本例额外设置一次性领取标志,不允许同一账户再次领取。

编写可测试的安全合约

示例使用 Solidity 0.8.24,签名校验采用 OpenZeppelin Contracts 5.x 的 ECDSA。测试环境需要提供一个具有 Ether 余额的管理员账户。以下是完整的 contracts/SecureVault.sol:

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import {ECDSA} from "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";

contract SecureVault {
    error Unauthorized();
    error InvalidSignature();
    error AlreadyClaimed();
    error LimitExceeded();
    error TransferFailed();

    address public immutable admin;
    uint256 public limit = 1 ether;
    mapping(address => bool) public claimed;

    constructor() payable {
        admin = msg.sender;
    }

    function setLimit(uint256 newLimit) external {
        if (msg.sender != admin) revert Unauthorized();
        limit = newLimit;
    }

    function claim(uint256 amount, bytes calldata signature) external {
        // 将调用者、金额和部署上下文绑定到授权摘要。
        bytes32 digest = keccak256(
            abi.encode(address(this), block.chainid, msg.sender, amount)
        );
        bytes32 ethHash = keccak256(
            abi.encodePacked("\x19Ethereum Signed Message:\n32", digest)
        );

        if (ECDSA.recover(ethHash, signature) != admin) {
            revert InvalidSignature();
        }
        // 先检查并更新领取状态,再执行外部转账。
        if (claimed[msg.sender]) revert AlreadyClaimed();
        if (amount > limit) revert LimitExceeded();
        claimed[msg.sender] = true;

        (bool ok, ) = payable(msg.sender).call{value: amount}("");
        if (!ok) revert TransferFailed();
    }
}

这份实现有两处值得关注:admin 在部署时固定,普通用户不能改变管理员;claimed 在转账前设为 true,避免外部转账期间再次进入领取逻辑。

claim 将领取人绑定为 msg.sender。因此,拿到别人的签名并不意味着可以代替对方领取。示例假设管理员可信,且管理员只签发符合业务规则的授权。生产项目还应考虑签名有效期、授权撤销及可升级合约的域分隔规则。

使用 Hardhat 编写负向测试

采用 Hardhat 3 的 Ethers.js 与 Mocha 测试组合,安装对应依赖后执行测试。下面使用 Hardhat 3 官方插件体系中的 @nomicfoundation/hardhat-toolbox-mocha-ethers,并显式安装 OpenZeppelin 5.x。

bash
npm install --save-dev hardhat@^3 @nomicfoundation/hardhat-toolbox-mocha-ethers
npm install @openzeppelin/contracts@^5

预期结果:依赖安装成功,npm 以退出码 0 结束。安装输出中的包数和审计提示取决于本地依赖树,不作为安全断言。

项目根目录创建 hardhat.config.ts:

ts
import { defineConfig } from "hardhat/config";
import hardhatToolboxMochaEthers from "@nomicfoundation/hardhat-toolbox-mocha-ethers";

export default defineConfig({
  plugins: [hardhatToolboxMochaEthers],
  solidity: "0.8.24",
});

该配置启用 Ethers.js 和 Mocha 测试能力。下面的测试使用 Hardhat 3 的 network.connect() 创建隔离的模拟网络连接,代码放入 test/SecureVault.ts:

ts
import { expect } from "chai";
import { network } from "hardhat";

const { ethers } = await network.connect();

describe("SecureVault authorization", function () {
  async function fixture() {
    const [admin, alice, bob] = await ethers.getSigners();
    const vault = await ethers.deployContract("SecureVault", [], {
      value: ethers.parseEther("5"),
    });
    await vault.waitForDeployment();

    // 签名摘要必须与 Solidity 的 abi.encode 完全一致。
    async function authorize(user: string, amount: bigint) {
      const chainId = (await ethers.provider.getNetwork()).chainId;
      const digest = ethers.keccak256(
        ethers.AbiCoder.defaultAbiCoder().encode(
          ["address", "uint256", "address", "uint256"],
          [await vault.getAddress(), chainId, user, amount]
        )
      );
      return admin.signMessage(ethers.getBytes(digest));
    }

    return { admin, alice, bob, vault, authorize };
  }

  it("rejects non-admin limit changes", async function () {
    const { alice, vault } = await fixture();
    const before = await vault.limit();

    await expect(
      vault.connect(alice).setLimit(ethers.parseEther("3"))
    ).to.be.revertedWithCustomError(vault, "Unauthorized");

    expect(await vault.limit()).to.equal(before);
  });

  it("rejects signatures bound to another recipient", async function () {
    const { alice, bob, vault, authorize } = await fixture();
    const amount = ethers.parseEther("0.5");
    const signature = await authorize(alice.address, amount);
    const before = await ethers.provider.getBalance(await vault.getAddress());

    // Bob 重用 Alice 的签名,不能让合约支付给 Bob。
    await expect(
      vault.connect(bob).claim(amount, signature)
    ).to.be.revertedWithCustomError(vault, "InvalidSignature");

    expect(await vault.claimed(bob.address)).to.equal(false);
    expect(await ethers.provider.getBalance(await vault.getAddress()))
      .to.equal(before);
  });

  it("rejects a second claim without transferring again", async function () {
    const { alice, vault, authorize } = await fixture();
    const amount = ethers.parseEther("0.5");
    const signature = await authorize(alice.address, amount);

    await expect(vault.connect(alice).claim(amount, signature))
      .to.not.be.reverted;
    expect(await vault.claimed(alice.address)).to.equal(true);

    const balanceAfterFirst = await ethers.provider.getBalance(
      await vault.getAddress()
    );

    await expect(
      vault.connect(alice).claim(amount, signature)
    ).to.be.revertedWithCustomError(vault, "AlreadyClaimed");

    expect(await ethers.provider.getBalance(await vault.getAddress()))
      .to.equal(balanceAfterFirst);
  });
});

运行测试:

bash
npx hardhat test test/SecureVault.ts

预期结果:三个测试均通过,Mocha 报告 3 passing。如果其中任何一项断言失败,命令应以非零退出码结束。实际执行时间与测试报告细节可能不同。

为什么还要检查回滚后的状态

单独使用 reverted 只证明发生了回滚,无法区分是预期的权限检查,还是意外的转账失败。因此,本例同时使用精确错误断言和状态断言:

  • 管理员入口:检查 limit() 没有变化,避免未授权交易意外修改业务参数。
  • 签名入口:检查 claimed(bob) 仍为 false,并比较合约的 Ether 余额。
  • 重复领取入口:先证明首次领取成功,再检查第二次交易的错误类型和余额不变性。

对同一笔 EVM 交易而言,真正回滚会撤销该交易对合约存储、余额和日志的状态影响。额外的状态断言能够锁定业务不变量,防止后续修改把安全测试弱化成只接受任何失败。

本例使用 ECDSA.recover,对畸形签名可能抛出 OpenZeppelin 自身的 ECDSA 错误,而非 InvalidSignature。因此,这里的错误断言专门针对格式有效但签名者无权的情况。如果业务要求统一错误类型,可在合约中使用 ECDSA.tryRecover 并显式处理恢复失败。

检查修复是否真正有效

建议在代码评审中做一次受控的回归检查:临时在测试分支移除 setLimit 的管理员校验,然后重新执行测试。预期第一条测试失败,因为未授权调用不再回滚。恢复校验后,三个测试应再次通过。

还应增加两项实际边界检查:合法签名对应的金额被篡改时必须失败;不同链 ID 或不同合约地址下生成的授权不得被当前部署接受。测试时必须确保授权域实际不同,而不是只更换变量名称。

最终验收标准是:合法管理员能够修改限额;合法用户能够首次领取;未授权操作、跨账户签名复用和重复领取均触发指定错误;失败交易不会改变相关业务状态。负向测试只有同时约束错误类型与业务结果,才能有效守住已经修复的安全边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

断言未授权操作必须回滚

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

登录哪都通