Shipper's Logs
Concise video recaps of every Envio release. Newest at the top. Skim the highlights, then dive into the full release video.
Looking for the full written history? Every release is on the Changelog, pulled straight from GitHub.
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,enviopackage 88 MB smaller - Powerful
whereoption: conditional event handlers, per-chain filters, and per-event start blocks - ESM migration with top-level
awaitin 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:
createEffectwithout prefix - Required
rateLimitoption and per-call cache override viacontext.cache = false - Development Console shows detailed performance metrics (works with TUI disabled)
- New
getWhere.ltquery 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
_metaquery 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