智能合约与以太坊 / 系统课时
配置调用序列和测试预算
配置调用序列和测试预算
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:
// 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:
testMode: property
testLimit: 2000
seqLen: 2
shrinkLimit: 1000
coverage: true
corpusDir: corpus
format: text
# 限制单笔交易的执行 Gas
testMaxGas: 500000注意 YAML 顶层字段不能额外缩进。实际保存时,应将最后一行 testMaxGas 前面的空格删除,使其与 testLimit 左对齐。
执行测试:
echidna SequenceBudget.sol --contract SequenceBudget --config echidna.yaml预期结果:Echidna 应找到 echidna_credit_limit 属性失败,并给出包含 deposit()、withdraw() 的反例调用序列;具体输出格式、随机种子、执行次数和缩减后的显示内容可能随版本及运行过程不同。
echidna_credit_limit: failed!上述输出仅展示需要关注的失败状态,不代表完整终端日志。查看反例时,重点核对交易执行顺序,以及失败前是否已经成功建立 credits = 1。
之后将 seqLen 改为 1,保持其他配置不变并重新运行。预期该特定两步缺陷不会被发现;这与增加测试次数无关,而是序列深度不足。
管理 Gas、回滚与输入约束
对于存在复杂循环、时间锁或多用户角色的合约,仅调整测试数量和序列长度还不够。可以在上述配置基础上加入以下参数:
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 显示属性通过,只表示当前配置和预算下未发现反例,不能证明所有状态均安全。