HyperIndex v2.31.1 → Major reliability & performance upgrades 🚀

[moose-code]

Hi folks — JonJon here, co-founder at Envio.

We've shipped some massive upgrades over the past few months! Here's what you might have missed:

v2.31.0 — "Big Reliability Release" 🏛️

• Complete rollback on reorg refactoring → fixes all known indexing issues, optimized DB writes (dozens of ms faster!), reorg-resistant event counter
• Extended entity name length support (up to 63 chars)
• Multiple indexers with different schemas on single database now supported

v2.30.0 — Address Format Configuration & Performance 🆕

• Choose between checksum (default) and lowercase addresses → facilitates SubGraph migration and improves performance in some instances
• Faster Event Decoder for RPC source → multiple times faster using the HyperSync event decoder instead of Viem
• Fixes for indexing-at-the-head metric and GraphQL entity read permissions
• Internal improvements: guaranteed single-batch block events, optimized dynamic address persistence

v2.29.0 — Block Handlers 🆕

• Run logic on every block or at intervals! Perfect for aggregations and time-series data
• Use onBlock() for powerful new patterns: time intervals, preset handlers, multichain mode
• Check out the Block Handlers docs for examples

v2.28.0 — Speed & Scale

• 2X faster RPC historical sync → halved the number of requests needed
• Much faster indexing for big factories → 2M addresses now index 2X faster (4 days → 2 days!)
• New official _meta query for tracking indexer progress per chain

v2.27.0 — Preload Optimization ⚡

• Auto-batched entity loading → makes handlers multiple times faster with zero code changes
• Set preload_handlers: true in config and watch the magic happen
• Contract-specific start blocks for optimized indexing

v2.26.0 — Built-in Effect Cache

• Persistent cache for Effect API calls → set cache: true and share cache with Hosted Service
• Dramatically reduces redundant external API calls

Earlier gems you might have missed

• Effect API (v2.19) — auto-batching, memoization & deduplication for external calls
• getOrCreate / getOrThrow helpers — cleaner code, no boilerplate null checks
• Automatic RPC fallback when HyperSync stalls

Need anything?

• Quick tips on schema design or perf tuning
• Help with Block Handlers or Preload optimization
• Migration support for our hosted service (now with monitoring & alerting!)

Reply here or join us on Discord.

# one-liner upgrade
pnpm i envio@latest

Full changelog → https://github.com/enviodev/hyperindex/releases/tag/v2.31.1
Docs → https://docs.envio.dev

Feel free to close if you're all set.
Best,
JonJon & the Envio team