Upgrade priority: High
- This release fixes a regression introduced in nb-20251005.
- If you are running with
--hl-node-complianton versions before nb-20251005, the upgrade priority is Medium.
Thanks to everyone who reported issues and helped with testing!
cc/ @AlexVarin2001 @Quertyy
Database format change
This release fixes the severe performance regression from #79 by switching internal storage to HlHeader
(Header + system_tx_count and logs_bloom with system transaction receipts.). [detailed format]
🚫 The safest option is resyncing the node, but if EXPERIMENTAL_MIGRATE_DB env is specified, node will try to migrate itself. (takes 8~10 minutes)
Migration & Impact
- One-time migration: On first start, the node will run a migration step (8~10 minutes). After migration, syncing will resume normally.
- Disk usage: Expect ~5% increase due to new header metadata.
- Performance: --hl-node-compliant mode will be slightly faster.
👉 Please report any issues encountered with the migrator.
What's Changed (nb-20251005..nb-20251009)
- fix: Fix panic when block receipts are called on non-existing blocks by @sprites0 in #84
- feat(breaking): Use custom header format (HlHeader) by @sprites0 in #86
Previous release note
Bug Fixes
- Fixed an issue in
eth_getLogswhere using (1) an address filter with (2) events only present in system transactions caused errors (#78).- This does not impact typical indexers, since they don't use this specific filter combination.
- Resolved multiple issues with
--local-ingest-dir. It now works correctly with improved performance.
New Features
- Added RPC method
eth_blockPrecompileDatafor fetching read precompile information (contributed by @Quertyy). - Upgraded to reth v1.8.2 with Rust edition 2024.
- Note: #72 is not shipped yet (caching spotMeta in DB so that testnet node can start when testnet RPC is down)
Misc changes
- Now the reth fork moved from sprites0/reth to hl-archive-node/reth. As always, Cargo.toml points the exact commit hash, and each version port is tagged like
v1.8.2-fork.
What's Changed (nb-20250915..nb-20251005)
- feat(rpc): add HlBlockPrecompile rpc API by @Quertyy in #74
- feat: Add debug CLI flag to enforce latest blocks (--debug-cutoff-height) by @sprites0 in #77
- fix: Do not filter out logs based on bloom (which is for perf optimization) by @sprites0 in #79
- chore: Upgrade to reth v1.8.2 by @sprites0 in #80
- fix: Fix typo in --local (default hl-node dir) by @sprites0 in #81
- fix(local-ingest-dir): Use more robust resumption for hl-node line reader, fix block number increment for reading files by @sprites0 in #82
Full Changelog:
- nb-20250915...nb-20251005
- nb-20251005...nb-20251009
Current Rust LoC: 9479 lines