enviodev/indexing-performance
packages/cli/templates/static/shared/.claude/skills/indexing-performance/SKILL.md
Use when optimizing indexer speed or tuning sync performance. HyperSync vs RPC, batch size, RPC tuning parameters, WebSocket config, and preload optimization.
$ install --global
skillsauthnpx skillsauth add enviodev/hyperindex indexing-performanceInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 9:03 PM1.8s1 file scanned
SKILL.md
- name:
- indexing-performance
- description:
- >-
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 | live | fallback
ws: ${ENVIO_WS_URL} # WebSocket for lower-latency live 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 live |
| live | HyperSync for historical, switch to RPC for live (lower latency) |
| fallback | Backup when primary stalls (default when HyperSync available) |
WebSocket for Live Indexing
Add ws: for lower-latency new block detection via eth_subscribe("newHeads"):
rpc:
- url: ${ENVIO_RPC_ENDPOINT}
ws: ${ENVIO_WS_ENDPOINT}
for: live
Database Indexes
Add @index to schema fields for faster queries — see indexing-schema for full syntax (single-field, composite, DESC direction).
Deep Documentation
Full reference: https://docs.envio.dev/docs/HyperIndex-LLM/hyperindex-complete
Related Skills
enviodev/testing
development
VerifiedTrustedCommunity
Write and run tests for HyperIndex indexers using Vitest and createTestIndexer(). Covers test setup, processing block ranges, asserting entity changes with toMatchInlineSnapshot, and TDD workflow. Use when writing tests, debugging handler output, or verifying indexer behavior.
508SKILL.mdUpdated Apr 17, 2026
enviodev/subgraph-migration
data-ai
VerifiedTrustedCommunity
Migrate a TheGraph subgraph to Envio HyperIndex using TDD. Covers schema conversion (remove @entity, Bytes->String, @derivedFrom), handler translation (save->set, store.get->context.get, templates->contractRegister), and verification against subgraph data.
508SKILL.mdUpdated Apr 17, 2026
enviodev/indexing-wildcard
data-ai
VerifiedTrustedCommunity
Use when indexing all instances of a contract across all addresses (e.g., all ERC-20 transfers on a chain). Config setup (no address), wildcard handler option, and event.srcAddress.
508SKILL.mdUpdated Apr 17, 2026
enviodev/indexing-transactions
data-ai
VerifiedTrustedCommunity
Use when needing transaction-level data in handlers. Configure field_selection to include transaction fields on events, and access via event.transaction. No native transaction handler — access through event handlers.
508SKILL.mdUpdated Apr 17, 2026