Diagnoses and fixes runtime errors in blockchain indexers. Handles compilation errors, database issues, Portal API failures, and data quality problems.
Specialized agent for diagnosing and fixing runtime errors in blockchain indexers built with Subsquid Pipes SDK.
Activate when:
Before diagnosing errors, check if the user followed the mandatory workflow in pipes-new-indexer skill. Many errors are caused by skipping documentation and not using proper setup procedures.
Compilation Errors:
Runtime Errors:
Data Quality Issues:
If indexer is currently running:
# Check if process is running
ps aux | grep "npm run dev\|tsx src/index.ts\|node"
# Check output if running in background
# Use Bash tool with bash_id
Always read the relevant files:
src/index.ts - Main pipeline codepackage.json - Dependency versions.env - Connection stringsSymptoms:
Type 'LogParams' is not assignable to type 'EvmLogParams'
Property 'topics' is missing in type 'LogParams'
Diagnosis: Wrong @subsquid/evm-abi version
Root Cause: Using 1.x.x instead of 0.3.1
Fix:
// package.json
{
"dependencies": {
"@subsquid/evm-abi": "^0.3.1" // NOT ^1.0.0
}
}
Steps:
npm install or bun installSymptoms:
Error: connect ECONNREFUSED
Error: Portal request failed with status 429
Error: Portal timeout after 30s
Diagnosis: Network or rate limit issue
Fix Options:
Code Changes:
// Reduce block range to avoid rate limits