For AI agents: the documentation index is at /llms.txt. Markdown versions of pages are available by appending .md to the URL.
Skip to main content

Shipper's Logs

Concise video recaps of every Envio release. Newest at the top. Skim the highlights, then dive into the full release video.


v3.0.0 β€” HyperIndex V3 Is Here πŸš€β€‹

Links: What's new in V3 Β· Migrate to V3 Β· GitHub release notes Β· Introducing HyperIndex V3 (YouTube) Β· V2 vs V3 Comparison (YouTube) Β· Migrate V2 to V3 (YouTube)

Highlights

  • 3Γ— faster backfill (and faster still on v3.1 β€” ~50,000 events/sec on average)
  • New unified handlers API: indexer.onEvent() / indexer.onBlock() β€” no more generated package, envio package 88 MB smaller
  • Powerful where option: conditional event handlers, per-chain filters, and per-event start blocks
  • ESM migration with top-level await in handlers
  • Automatic handler registration from src/handlers β€” no more handler paths in config
  • New testing framework: run and snapshot-test your indexer programmatically, no live indexer needed
  • Experimental ClickHouse storage in dual mode with Postgres (supported on Envio Cloud dedicated plans)
  • HyperSync source improvements: server-side events replace polling, query cache (up to 90% egress reduction for self-hosters)
  • RPC source for real-time indexing with experimental WebSocket support
  • Experimental Solana support via slot handlers, plus block-handler-only indexers
  • pnpm no longer required β€” use npm, yarn, bun, or any package manager
  • Official Prometheus metrics endpoint and a cleaner TUI with live events/sec

v2.32.0 β€” Effect API Graduation, Console Insights, New Query​

Links: GitHub release notes Β· YouTube

Highlights

  • Effect API leaves experimental: createEffect without prefix
  • Required rateLimit option and per-call cache override via context.cache = false
  • Development Console shows detailed performance metrics (works with TUI disabled)
  • New getWhere.lt query helper
  • Internal cleanups: librarified config and in-memory table

v2.31.0 β€” Big Reliability Release πŸ›οΈβ€‹

Links: GitHub release notes Β· YouTube

Highlights

  • Rollback reorg refactor β†’ resolves known indexing issues
  • Faster DB writes and reorg‑resistant event counter
  • Entity name length up to 63 chars
  • Multiple indexers with different schemas on one database

v2.30.0 β€” Address Format Configuration & Performance πŸ†•β€‹

Links: GitHub release notes Β· YouTube

Highlights

  • Choose address format: checksum (default) or lowercase
  • Faster RPC event decoding via HyperSync event decoder
  • Fixes for indexing-at-the-head metric and GraphQL read permissions
  • Internal improvements to batching and persistence

v2.29.0 β€” Block Handlers πŸ†•β€‹

Links: GitHub release notes Β· YouTube

Highlights

  • Run logic every block or at intervals with onBlock()
  • Great for time-series and aggregations
  • New patterns: preset handlers and multichain mode

v2.28.0 β€” Speed & Scale​

Links: GitHub release notes Β· YouTube

Highlights

  • 2Γ— faster RPC historical sync (fewer requests)
  • Big factory indexing 2Γ— faster (e.g., 2M addresses: 4 days β†’ 2 days)
  • New official _meta query for per‑chain indexer progress

v2.27.0 β€” Preload Optimization βš‘β€‹

Links: GitHub release notes Β· YouTube

Highlights

  • Auto‑batched entity loading via preload_handlers: true
  • Contract‑specific start blocks for optimized indexing

Want something added? Open an issue or PR on our GitHub.