Add Squid indexer to ERC20 transfer events benchmark

[DZakh]

Summary

This PR adds a complete Squid (Subsquid) implementation to the ERC20 transfer events benchmark suite, enabling performance comparison with existing indexers (Ponder, Envio, and Rindexer).

Key Changes

• Benchmark Integration: Added benchmarkSquid() function to run.ts that:

  • Manages Squid processor and GraphQL server as separate processes
  • Handles PostgreSQL database lifecycle via Docker Compose
  • Queries indexed transfer and approval events with block height tracking
  • Measures indexing performance over a configurable duration

• Process Management: Refactored active process tracking from single activeProc to activeProcs array to support Squid's dual-process architecture (processor + GraphQL server)

• Squid Project Structure: Created complete Squid implementation including:

  • processor.ts: EVM batch processor configured for Ethereum mainnet, monitoring ERC20 contract events from block 18,600,000
  • main.ts: Event handler that processes Transfer and Approval events, maintains Account balances and Allowance state
  • schema.graphql: GraphQL schema defining Account, TransferEvent, Allowance, and ApprovalEvent entities
  • TypeORM entity models with proper indexing and bigint transformers
  • ERC20 ABI definitions and type-safe event decoders
  • Docker Compose configuration for PostgreSQL database
  • TypeScript configuration and build setup

• CI/CD: Added GitHub Actions workflow job for Squid project validation (dependency installation and typecheck)

Implementation Details

• Event IDs use format {blockHeight}-{logIndex} for consistent identification across indexers
• Account balance tracking uses delta accumulation pattern for efficient state management
• Allowance state is upserted on each Approval event
• GraphQL server timeout increased to 60 seconds to accommodate initial indexing
• Processor and GraphQL server are started concurrently and cleaned up independently

https://claude.ai/code/session_01BrQJTpQMVQLbH3Sr5k2BDz