solodit

Solodit API 技能

从 Cyfrin Solodit（全球最大的区块链安全问题数据库）搜索并检索智能合约安全漏洞。

概述

Solodit 汇集了 50,000 多条安全问题，来源包括 Cyfrin、Sherlock、Code4rena、Trail of Bits、OpenZeppelin 等顶级审计公司。此技能提供 8 个具备智能缓存功能的 MCP 工具：

• search_vulnerabilities - 按关键词、严重性、审计公司、标签、协议等进行搜索
• get_finding - 按 ID 或 slug 检索特定问题
• list_audit_firms - 列出所有可用的审计公司（缓存 24 小时）
• list_tags - 列出所有漏洞标签（缓存 24 小时）
• list_protocol_categories - 列出协议类别（DeFi、NFT、借贷等）
• list_languages - 列出支持的语言（Solidity、Rust、Cairo 等）
• get_statistics - 查看数据库统计信息和缓存状态
• clear_cache - 清除缓存数据，以获取最新结果

设置

1. 获取 API 密钥

1. 在 solodit.cyfrin.io 创建账户
2. 点击右上角的个人资料下拉菜单
3. 打开“API Keys”弹窗并生成新的 API 密钥

2. 设置环境变量

export CYFRIN_API_KEY="sk_your_api_key_here"

将其添加到 Shell 配置文件（~/.bashrc、~/.zshrc）中，以便永久生效。

MCP 工具参考

search_vulnerabilities

搜索并筛选 Solodit 数据库中的安全问题。

参数：

参数	类型	描述
keywords	string	搜索词（例如，“reentrancy”“oracle manipulation”）
impact	string[]	严重性筛选：["HIGH"]、["HIGH", "MEDIUM"] 等
audit_firms	string[]	按审计公司筛选：["Cyfrin", "Sherlock"]
tags	string[]	漏洞标签：["Reentrancy", "Oracle", "Access Control"]
protocol_categories	string[]	协议类型：["DeFi", "NFT", "Lending"]
languages	string[]	编程语言：["Solidity", "Rust", "Cairo"]
protocol	string	协议名称（部分匹配）
min_quality	number	最低质量分数（1-5）
sort	string	排序依据："recency"、"quality"、"rarity"
page	number	页码（默认值：1）
page_size	number	每页结果数（最大值：100，默认值：20）

get_finding

按 ID 或 slug 检索特定漏洞。

参数：

参数	类型	描述
id	string	问题 ID（数字）或 slug（适用于 URL 的标识符）
verbose	boolean	包含完整内容和摘要（默认值：true）

list_audit_firms

列出数据库中所有可用的审计公司。缓存 24 小时。

参数：

参数	类型	描述
refresh	boolean	强制刷新缓存列表（默认值：false）

list_tags

列出所有可用的漏洞标签。缓存 24 小时。

参数：

参数	类型	描述
refresh	boolean	强制刷新缓存列表（默认值：false）

list_protocol_categories

列出所有协议类别（DeFi、NFT、借贷、DEX、跨链桥等）。

list_languages

列出所有支持的编程语言（Solidity、Rust、Cairo、Vyper、Move、Huff、Fe、Ink!）。

get_statistics

获取数据库统计信息，包括问题总数、缓存状态和速率限制信息。

clear_cache

清除缓存数据，以获取最新结果。

参数：

参数	类型	描述
type	string	缓存类型："all"、"search"、"findings"、"metadata"

缓存

MCP 服务采用智能缓存机制，以减少 API 调用：

缓存类型	TTL	用途
搜索结果	5 分钟	最近的搜索查询
单条问题	1 小时	按 ID/slug 检索的问题
元数据	24 小时	审计公司、标签列表

Curl 回退方案

对于不支持 MCP 的环境，可直接使用 curl：

基本搜索

curl -X POST https://solodit.cyfrin.io/api/v1/solodit/findings \
  -H "Content-Type: application/json" \
  -H "X-Cyfrin-API-Key: $CYFRIN_API_KEY" \
  -d '{
    "page": 1,
    "pageSize": 20
  }'

使用筛选条件搜索

curl -X POST https://solodit.cyfrin.io/api/v1/solodit/findings \
  -H "Content-Type: application/json" \
  -H "X-Cyfrin-API-Key: $CYFRIN_API_KEY" \
  -d '{
    "page": 1,
    "pageSize": 20,
    "filters": {
      "keywords": "reentrancy",
      "impact": ["HIGH", "MEDIUM"],
      "sortField": "Quality",
      "sortDirection": "Desc"
    }
  }'

按审计机构筛选

curl -X POST https://solodit.cyfrin.io/api/v1/solodit/findings \
  -H "Content-Type: application/json" \
  -H "X-Cyfrin-API-Key: $CYFRIN_API_KEY" \
  -d '{
    "page": 1,
    "pageSize": 20,
    "filters": {
      "firms": [{"value": "Cyfrin"}, {"value": "Sherlock"}],
      "impact": ["HIGH"]
    }
  }'

示例工作流

安全审计准备

Search for all HIGH severity findings in lending protocols from the last 90 days, sorted by quality score

漏洞研究

Find oracle manipulation vulnerabilities in DeFi protocols with quality score 4 or higher

学习特定攻击模式

Search for flash loan attack examples with tag "Flash Loan" sorted by rarity

探索数据库

List all audit firms available in the database

Get database statistics

速率限制

• 限制：每 60 秒窗口内最多 20 个请求
• 响应头：查看响应中的 X-RateLimit-Remaining
• 缓存：可显著减少 API 调用
• 警告：剩余请求数 ≤5 时发出提醒

常见标签

• 重入
• 预言机
• 访问控制
• 整数溢出/下溢
• 抢跑交易
• 价格操纵
• 闪电贷
• 恶意骚扰
• 拒绝服务
• 逻辑错误

常见审计机构

• Cyfrin
• Sherlock
• Code4rena
• Trail of Bits
• OpenZeppelin
• Consensys Diligence
• Spearbit
• Pashov Audit Group
• Hacken
• ChainSecurity

协议类别

• DeFi
• NFT / NFT 市场
• 借贷 / NFT 借贷
• DEX
• 质押 / 流动性质押
• 治理 / DAO
• 跨链桥 / 跨链
• 收益聚合器
• 期权 / 期权金库
• 预言机
• 游戏
• RWA

支持

• API 文档：Cyfrin Notion
• 网站：solodit.cyfrin.io
• 支持：[email protected]