用途:该技能面向使用 Subsquid Pipes SDK 构建的区块链索引器,帮助定位并修复运行时错误,包括 TypeScript 编译失败、数据库连接异常、Portal API 报错或超时、事件解码失败、内存溢出、游标损坏以及数据缺失或错误等。触发场景包括用户报告报错、索引器崩溃、数据为空或不准、同步过慢等。
主要能力:按错误类型分类诊断,涵盖编译错误(类型不匹配、依赖缺失、ABI 版本冲突)、运行时错误(Portal 连接失败、数据库连接、事件解码、内存、游标)、数据质量问题(事件缺失、参数错误、重复记录、区块范围错误)。提供常见错误模式的处理方法,例如 ABI 版本不匹配、Portal 429 限流、数据库未启动、代理合约 ABI 导致启动崩溃、工厂索引器暂无数据、时间戳显示 1970、ClickHouse 表结构问题、进程中断恢复、Node.js 版本兼容性、Hyperliquid 校验差异等。还包含数据验证与质量检查的分级方法(表结构、数据质量、完整性)。
使用方式:先确认用户是否遵循 pipes-new-indexer 的强制工作流;检查运行进程(如 ps aux | grep "npm run dev|tsx src/index.ts|node");阅读 src/index.ts、package.json、.env 及错误堆栈;按错误模式执行修复,如调整依赖版本、缩小区块范围、启动数据库、重新生成 ABI、清理 sync 表、设置 NODE_OPTIONS 等。
适用场景:Subsquid Pipes 索引器的开发与运维排障,尤其是 EVM 与 Hyperliquid 数据同步问题。
限制:资料未提供该技能的安装方式、收费模式、支持平台及完整验证流程;部分修复命令依赖具体环境,需按实际项目调整。