Fetch Source 是一个用于获取已验证智能合约源代码的技能,支持从 Sourcify 和 Etherscan 下载任意 EVM 兼容链上的合约源码。
用途 该技能用于在用户需要下载、查看或分析已验证智能合约源代码时,自动从可信来源获取源码文件。
主要能力
- 优先尝试 Sourcify(无需 API 密钥)。
- 若 Sourcify 未找到,则回退到 Etherscan v2 API(需设置环境变量 ETHERSCAN_API_KEY)。
- 支持所有 Etherscan 源码格式:标准 JSON 输入(带或不带额外大括号)以及单一扁平文件。
- 根据编译器版本自动检测 Vyper 与 Solidity。
- 将源码文件保存到 sources_<address>/ 目录(或通过 -o 指定自定义目录)。
- 同时保存原始 API 响应为 sourcify.json 或 etherscan.json。
使用方式 命令格式: ./scripts/fetch_sources.sh -c <chain_id> [-o <output_dir>] <address>
可选环境变量:ETHERSCAN_API_KEY(用于在 Sourcify 未找到时启用 Etherscan 回退)。
示例:
获取以太坊(链 ID 1)上的 Uniswap V3 Factory
./scripts/fetch_sources.sh -c 1 0x1F98431c8aD98523631AE4a59f267346ea31F984
自定义输出目录
./scripts/fetch_sources.sh -c 137 -o ./uniswap_polygon 0x1F98431c8aD98523631AE4a59f267346ea31F984
常见链 ID:1(Ethereum)、10(Optimism)、56(BSC)、137(Polygon)、8453(Base)、42161(Arbitrum)。
输出
- sources_<address>/sourcify.json 或 etherscan.json — 原始 API 响应。
- sources_<address>/<filepath>.sol — 验证器返回的各个源文件。
适用场景 适用于需要获取已验证智能合约源码进行审计、学习、分析或二次开发的场景,尤其适合跨多条 EVM 链的合约源码收集。
限制
- 仅支持已验证的合约源码;未验证的合约无法获取。
- 使用 Etherscan 回退时需要有效的 ETHERSCAN_API_KEY。
- 具体支持的链范围取决于 Sourcify 和 Etherscan 的覆盖情况。
- 其他功能细节暂未提供。