用途:面向区块链索引场景,帮助获取、分析和管理智能合约 ABI,并生成 TypeScript 类型与 schema 提示。
主要能力:从 Etherscan、Basescan 等区块浏览器或文件、包中获取 ABI;解析 ABI 结构,识别事件及其参数类型;判断 ERC20、ERC721、ERC1155、Uniswap 等标准接口;使用 @subsquid/evm-typegen 生成 TypeScript 类型;将事件结构传递给 schema-designer 以辅助数据库设计。
使用方式:已知标准合约可直接使用 commonAbis,例如 import { commonAbis } from "@subsquid/pipes-abi",并引用 commonAbis.erc20.events.Transfer。自定义合约可通过区块浏览器 API 获取 ABI 并保存为 JSON,再运行:npx @subsquid/evm-typegen@latest --abi ./abi/<contract_name>.json --output ./abi/<contract_name>.ts。分析时需区分 BigInt 字段(如 uint256、int256、uint128)与可安全用 Number 的类型(如 uint8、uint16、uint24、uint32),并注意 indexed 字段可用于服务端过滤。
适用场景:用户提供合约地址、询问 ABI 或事件、给出区块浏览器链接,或提到 ABI、合约地址、该合约时。
限制:代理合约可能只返回代理自身 ABI,需另行获取实现合约 ABI,或使用 commonAbis,或依据 topic hash 内联定义事件。若区块浏览器未验证合约、网络错误或地址非合约,则无法获取 ABI。资料未提供收费、价格、平台支持范围等细节。