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,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