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

配置调用序列和测试预算

配置调用序列和测试预算

Echidna 能否发现状态型漏洞,不仅取决于生成多少输入,还取决于每组测试允许连续执行多少笔交易。本篇通过一个存在提款缺陷的合约,配置测试数量、序列长度、Gas 限制和输入约束,观察不同预算如何改变漏洞发现能力。

学习目标

  • 理解 testLimit、seqLen 和 shrinkLimit 的作用及成本差异。
  • 配置交易调用范围、Gas 预算和时间推进限制。
  • 通过可复现案例判断回滚、状态积累与序列长度对测试结果的影响。

测试数量和序列长度分别控制什么

Echidna 的属性测试通常会生成一组连续交易,在同一执行序列内积累合约状态,并检查安全属性。序列结束后,新序列从初始测试状态开始;启用覆盖率引导时,生成器还会利用已经收集的输入与覆盖信息探索新路径。

最常调整的三个参数如下:

参数 作用 本地调试建议值
testLimit 测试交易序列的数量预算 2000
seqLen 每条序列允许的交易数量 2
shrinkLimit 失败序列的缩减尝试预算 1000

例如,将 testLimit 设置为 2000、seqLen 设置为 20,可以粗略理解为最多探索约 40000 个交易位置,但这不是实际成功执行交易数,也不是唯一状态数。提前回滚、测试终止、覆盖引导及内部执行开销都会影响最终结果。

长度为 1 的序列适合发现单次调用即可触发的问题;授权变更后转账、存款后提款、借款后清算等状态依赖问题,则需要至少覆盖相应的调用深度。

增加 testLimit 主要提高尝试次数,增加 seqLen 则允许到达更深的状态。两者不能直接互相替代。

用两笔交易触发状态型漏洞

下面使用 Solidity 0.8.20 编写一个教学合约。它的 deposit 将信用额度设为 1,而 withdraw 错误地增加额度,违反信用额度不超过 1 的安全属性。

将以下内容保存为 SequenceBudget.sol:

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

contract SequenceBudget {
    uint256 public credits;

    function deposit() external {
        // 只允许建立一次初始额度
        require(credits == 0, "already funded");
        credits = 1;
    }

    function withdraw() external {
        require(credits > 0, "no credits");
        // 故意保留缺陷:提款反而增加额度
        credits += 1;
    }

    function echidna_credit_limit() external view returns (bool) {
        return credits <= 1;
    }
}

这是简化的状态测试模型,不涉及真实 ETH 转账。echidna_credit_limit 使用默认的 echidna_ 前缀,返回 false 即代表属性被违反。

从初始状态 credits = 0 出发,最短有效反例是先调用 deposit(),再调用 withdraw(),最终令 credits = 2。

两笔交易触发属性失败的状态迁移图

如果 seqLen: 1,从初始状态单独调用 deposit() 不会违反属性,单独调用 withdraw() 则会回滚,通常无法发现这个两步缺陷。改成 seqLen: 2 后,两次成功调用可以组合出反例。

编写 Echidna 配置并执行

假定本机已经安装支持 Solidity 0.8.20 的 solc 和 Echidna,且能够通过命令行调用。下面使用 Echidna 官方配置格式,具体参数可对照 官方配置示例。

在 SequenceBudget.sol 所在目录创建 echidna.yaml:

yaml
testMode: property
testLimit: 2000
seqLen: 2
shrinkLimit: 1000
coverage: true
corpusDir: corpus
format: text
# 限制单笔交易的执行 Gas
 testMaxGas: 500000

注意 YAML 顶层字段不能额外缩进。实际保存时,应将最后一行 testMaxGas 前面的空格删除,使其与 testLimit 左对齐。

执行测试:

bash
echidna SequenceBudget.sol --contract SequenceBudget --config echidna.yaml

预期结果:Echidna 应找到 echidna_credit_limit 属性失败,并给出包含 deposit()、withdraw() 的反例调用序列;具体输出格式、随机种子、执行次数和缩减后的显示内容可能随版本及运行过程不同。

text
echidna_credit_limit: failed!

上述输出仅展示需要关注的失败状态,不代表完整终端日志。查看反例时,重点核对交易执行顺序,以及失败前是否已经成功建立 credits = 1。

之后将 seqLen 改为 1,保持其他配置不变并重新运行。预期该特定两步缺陷不会被发现;这与增加测试次数无关,而是序列深度不足。

管理 Gas、回滚与输入约束

对于存在复杂循环、时间锁或多用户角色的合约,仅调整测试数量和序列长度还不够。可以在上述配置基础上加入以下参数:

yaml
testMaxGas: 500000
propMaxGas: 500000
maxTimeDelay: 0
maxBlockDelay: 0
maxValue: 0
filterBlacklist: false
filterFunctions:
  - "SequenceBudget.deposit()"
  - "SequenceBudget.withdraw()"

这是配置片段示例,需要将字段合并到现有 echidna.yaml 的顶层,不能出现重复键。

参数 当前值的影响
testMaxGas 限制随机交易可消耗的 Gas
propMaxGas 限制属性检查允许的 Gas
maxTimeDelay 不随机增加交易间时间
maxBlockDelay 不随机增加交易间区块高度
maxValue 随机交易不携带 ETH
filterBlacklist: false 仅允许过滤列表中的目标函数参与随机调用

testMaxGas 不是测试总 Gas 预算,也不能简单视为整个序列的 Gas 上限。将其设置得过低,可能使正常业务调用无法完成。propMaxGas 则影响属性检查,复杂属性可能因为 Gas 不足而出现失败或错误,不能直接当作业务逻辑漏洞。

EVM 交易发生 revert 时,该笔交易的状态修改会回滚;此前已经成功执行的交易状态通常仍保留在同一测试序列内。回滚也会消耗执行预算,因此大量无效调用会浪费探索机会。

上例中,直接执行 withdraw() 因 credits == 0 而回滚,但它不会将之前某次成功的 deposit() 一并撤销。分析失败序列时,应逐笔区分成功交易、回滚交易与最终属性检查。

按缺陷深度分配测试预算

测试预算应结合业务调用链进行调整。以下数值是适合起步的工程配置,不是 Echidna 的固定默认值。

测试场景 testLimit seqLen 主要目标
单次调用边界 5000 1 参数校验、算术和断言
简单状态组合 10000 5 存款、提款和授权切换
多阶段协议操作 20000 30 抵押、借款、偿还与清算

更长的序列会增加状态覆盖机会,也可能让运行变慢、失败路径变长。shrinkLimit 可以从 1000 提高到 5000,以便尝试将复杂反例缩减为便于人工复现的调用序列,但缩减并不保证找到全局最短反例。

实际项目可以先在较短序列中提高测试数量,确保常见路径能充分执行,再逐步提高 seqLen。对于时间依赖、访问控制或资金转移性质,应分别准备允许对应输入的配置,避免一套过紧的限制覆盖全部场景。

建议验收时检查三项结果:测试是否真正执行了预期业务函数、失败反例能否在 Foundry 中按顺序复现、调整序列深度后能否解释测试结果的变化。Echidna 显示属性通过,只表示当前配置和预算下未发现反例,不能证明所有状态均安全。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置调用序列和测试预算

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

登录哪都通