漏洞扫描器

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

目的

扫描 Cosmos SDK 模块和 CosmWasm 合约,查找导致链停止、共识失败或资金损失的漏洞。生成并行扫描代理(每个代理专门针对一个漏洞类别),将发现结果返回给主要技能,然后将它们作为单独的降价文件写入输出目录。输出目录:默认为.bughunt_cosmos/。如果用户在提示中指定不同的目录,请改用该目录。

何时使用

审核 Cosmos SDK 模块(自定义x/模块) 审查 CosmWasm 智能合约 Cosmos 链的启动前安全评估 调查链暂停事件

何时不使用

无需 Cosmos SDK 的纯 Solidity/EVM 审计 — 使用 Solidity 特定工具 CometBFT 共识引擎内部结构 — 这涵盖了 SDK 模块,而不是共识层本身 没有区块链上下文的常规 Go 代码审查 Cosmos SDK 应用程序逻辑不是共识关键的(例如 CLI 命令、REST 端点) 没有自定义 SDK 模块的链上的 CosmWasm 仅合约审计 — 单独使用 CosmWasm 检查表项目

基本原则

共识路径为王——如果错误位于共识关键执行路径(BeginBlock、EndBlock、FinalizeBlock、msg_server handlers、AnteHandler)上,则仅对链停止/资金损失产生影响。在报告之前,请务必验证调查结果是否可以达成共识。状态分歧 = 链停止——任何导致验证器计算不同状态根的不确定性都会使链停止。这是最高严重性的类别,因为它同时影响所有验证器。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@trailofbits · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第一阶段:发现(同步)

Entry:用户提供的目标代码库路径。代码库包含 Go 源代码(例如,`x/` 模块、`go.mod`)或带有 `cosmwasm_std` 的 Rust 合约。运行同步子代理(代理工具),并以 DISCOVERY.md 的完整内容作为提示。代理必须: 按照发现工作流程探索目标代码库 在其响应中返回完整的 CLAUDE.md 内容(技术清单和威胁模型)

02
第 2 阶段:并行漏洞扫描

在单个消息中生成扫描代理以实现最大并行度。使用下面的代理提示模板,填写每个代理的参考文件。子代理只需要读取访问权限(Grep、Glob、Read)——它们在响应中返回结果,主要技能写入文件。始终生成这 3 个代理:代理名称·参考文件·范围`core-scanner`·`VULNERABILITY_PATTERNS.md`·§1-9:非确定性、ABCI、签名者、验证、处理程序、安全性

03
第三阶段:写下调查结果

所有扫描代理返回后,将发现文件写入输出目录(默认`.bughunt_cosmos/`): 解析每个代理对`FINDING_FILE:`块的响应 对于每个发现,使用`FINDING_FILE:`中的文件名将内容写入`{OUTPUT_DIR}/{filename}`(如果不存在),首先创建输出目录

04
第 4 阶段:验证完整性

写入所有结果后,验证对每个模式进行了评估:收集每个代理返回的摘要行(§NUM 条目) 根据预期总数检查模式计数: `core-scanner`:8 种模式(§1-9,仅排除 §8 旧模式) `state-scanner`:13 种模式(§11-23)

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。