indexer-performance

name	indexer-performance
description	Use when optimizing indexer speed or tuning sync performance. HyperSync vs RPC, batch size, RPC tuning parameters, WebSocket config, and preload optimization.
metadata	{"managed-by":"envio"}

Performance Tuning

HyperSync (Default — Fastest)

HyperSync is the default data source for supported chains. Up to 1000x faster than RPC. No configuration needed — automatic for supported networks.

Batch Size

full_batch_size: 5000  # Target events per batch (default: 5000)

Reduce if handlers make many slow Effect API calls that can't be batched.

RPC Tuning

When using RPC as a data source, tune these parameters per chain:

chains:
  - id: 1
    rpc:
      - url: ${ENVIO_RPC_URL}
        for: sync                    # sync | realtime | fallback
        ws: ${ENVIO_WS_URL}               # WebSocket for lower-latency realtime block detection
        initial_block_interval: 5000 # Starting blocks per query
        backoff_multiplicative: 0.8  # Scale factor after RPC error (0.5-0.9)
        acceleration_additive: 1000  # Blocks added per successful query
        interval_ceiling: 10000      # Max blocks per query
        backoff_millis: 5000         # Wait after error before retry (ms)
        query_timeout_millis: 20000  # Cancel RPC request after this (ms)
        fallback_stall_timeout: 5000 # Switch to next RPC after stall (ms)
        polling_interval: 1000       # Check for new blocks every N ms (default: 1000)

RPC for Options

Value	Description
sync	RPC as main data source for both historical and realtime
realtime	HyperSync for historical, switch to RPC for realtime (lower latency)
fallback	Backup when primary stalls (default when HyperSync available)

WebSocket for Realtime Indexing

Add ws: for lower-latency new block detection via eth_subscribe("newHeads"):

rpc:
  - url: ${ENVIO_RPC_ENDPOINT}
    ws: ${ENVIO_WS_ENDPOINT}
    for: realtime

Database Indexes

Add @index to schema fields for faster queries — see indexer-schema for full syntax (single-field, composite, DESC direction).

If something is unclear, use the envio-docs skill to search and read the latest documentation.