echidna
id:crytic/echidna ·
· 目录记录
项目概述
Echidna是Ethereum智能合约的模糊/属性测试工具:开发者写出应该始终成立的不变量,工具按ABI生成一连串合约调用,尝试找反例并输出触发序列。它补充单元测试的输入覆盖,不是合约安全或无亏损的自动证明。
原项目介绍
忠实中文 / 作者自述整理
作者介绍其为Haskell编写的Ethereum property-based fuzzer,利用ABI语法生成测试,目标是推翻用户定义谓词或Solidity断言,并支持模块化扩展。
短摘 / 原文
Echidna is a Haskell program designed for fuzzing/property-based testing of Ethereum smart contracts.
出处:https://github.com/crytic/echidna/blob/HEAD/README.md
translation_kind:实际选读作者README定位段的忠实中文要点;非全文翻译
excerpt_kind:readme_literal
source_kind:official_repository_readme_via_sanctioned_github_tool
is_self_report:True
excerpt_truncated:False
当前具体详情
做什么
Echidna是Ethereum智能合约的模糊/属性测试工具:开发者写出应该始终成立的不变量,工具按ABI生成一连串合约调用,尝试找反例并输出触发序列。它补充单元测试的输入覆盖,不是合约安全或无亏损的自动证明。
谁会用
编写合约不变量测试的开发者、审计人员及安全研究者。
用户画像依据
按已读作者定位与功能归纳;非客户规模或效果调查
解决的问题(编辑归纳)
单组单元测试难以覆盖合约调用序列和不变量的反例。
文档化使用场景(编辑归纳)
写属性后生成调用序列,审阅最小反例与覆盖,而非把未发现错误当安全证明。
主要能力与用途
输入合约及不变量,随机调用序列若使条件为假则输出该序列,便于复现和修正测试。
可收集语料、变异并用覆盖引导,自动最小化测试用例;Slither提供测试前信息提取。
不变量函数需满足文档命名/签名规范,默认property,另列assertion/Foundry及verification等模式。
交互终端、纯文本或JSON输出便于集成;本次只读这些模式的文档,不验证各模式实际能力或完备性。
如何使用 / 既有稿流程
实际场景:先明确合约应保持的业务条件→写属性/选测试模式→把合约交给fuzzer→审阅触发条件的调用序列和覆盖/最小化结果。本研究不运行Echidna/Slither,不测试第三方合约或执行修复。
用法证据状态
documented_workflow_only_not_executed
公开限制
找不到反例不等于属性已证明或所有业务风险被覆盖;不变量质量与测试边界由使用者负责。
verification模式文档说单交易符号验证,不能把它推广成任意多交易形式化证明。
构建、编译器兼容和资源费用未在所读范围完整核实,执行环境仍需单独评估。
未核实 / 来源缺口
仅所列README范围;未读实现、安装、运行、登录、测试、交易或连接钱包;不把作者宣传当安全/收益验证。
许可讨论
spdx_snapshot
AGPL-3.0
discussion_zh
README明确AGPLv3,全文与依赖未读;商用修改/部署义务不能当作已核豁免。
strict_open_source_verified
False
full_license_text_read
False
完成评估
status
specific_details_complete
count_as_completed
True
reason_zh
已逐项阅读所列README/官方文档,复核具体功能、用户、问题、场景/流程、依赖及边界;仅文档级具体描述,不是运行/源码核验。
completion_scope_zh
文档级具体描述;非源码/运行、安全、收益或许可全文核验
standard_id
pt780u-concrete-v1
problem_solved_zh
单组单元测试难以覆盖合约调用序列和不变量的反例。
documented_use_case_zh
写属性后生成调用序列,审阅最小反例与覆盖,而非把未发现错误当安全证明。
assistant_itemwise_content_reviewed
True
human_reviewed
False
assessed_cst
2026-11-17T08:46:13.116382+08:00
来源
https://github.com/crytic/echidna/blob/HEAD/README.md
local_path 未打进数据包,不生成链接:research/sources/crytic/echidna/README.md.phase032-tool.txt
{ "kind": "official_repository_readme_via_sanctioned_github_tool", "saved_cst": "2026-11-17T08:46:07.224220+08:00", "sha256": "56c991509faf0d67710fd6b86b3c0fcc2714dac058ba2ce442e84fcd451dfcdf", "read_scope": "README开头约1–66行的定位/性质/输入输出/模式与末尾AGPL段;不读实现或执行测试", "capture_kind": "raw_text_tool_result_wrapper", "immutable_commit_verified": false, "readme_read": true, "source_code_read": false }https://github.com/crytic/echidna
{ "kind": "repository_author_metadata_description_and_topics", "snapshot_cst": "2026-11-16T23:03:16+08:00", "description": "Ethereum smart contract fuzzer", "topics": [ "ethereum", "evm", "fuzzer", "security", "smart-contracts", "solidity", "testing" ], "record_sha256": "33527a938f0a4653290fdd54f776fe75e11868eaf60a31bd758c947c9f399f22", "read_scope": "逐项重读作者description前900字符(更长者明确截断)、topics前12项及星数/时间/许可快照;旧文档限制沿用须标非新增核验", "readme_read": false }
研究层级与范围
{
"tier": "B1_readme_light_intro",
"status": "readme_based_brief_available_not_code_or_full_documentary_audit",
"new_source_read_this_phase": true,
"readme_read": true,
"read_scope": "README开头约1–66行的定位/性质/输入输出/模式与末尾AGPL段;不读实现或执行测试",
"source_code_read": false,
"human_reviewed": false,
"human_tested": false,
"not_full_documentary_study": true,
"previous_metadata_profile_generation": "working_copy_after_phase010-b010-20261117T084141+0800",
"previous_metadata_profile_sha256": "8e2c677c03948467adc3c80d1131c8309510647a2e313c9282d1b4f61192a4e0"
}