Important
Optional but recommended upgrade.
v2.4.1 is a stability & hardening release. No protocol fork is activated, and operators can upgrade in-place.
Optional event/transfer logs performance improvement:
This release introduces an optional flag to create additional indexes for faster log queries: --logdb-additional-indexes.
After this flag is enabled, a migration will be performed. On a fully synced mainnet node, the process may take tens of minutes, depending on the hardware specifications, during which the API server will be temporarily unavailable.
VeChainThor v2.4.1
What's Changed
v2.4.1 focuses on correctness, safety, and operational robustness following the Hayabusa transition, with targeted improvements across arithmetic safety, txpool behavior, Solo/test stability, and developer/operator ergonomics.
Security & Correctness Hardening
- Added additional underflow/overflow protections across critical calculations, including stricter
uint64/intconversions and use of safe arithmetic helpers. - Fixed a panic condition that could cause the node to exit unexpectedly under specific runtime conditions.
- Corrected a big integer comparison bug in Solo mode that could lead to incorrect block validation.
- Fixed a resource leak by ensuring HTTP response bodies are always closed after use.
Performance, Txpool & Consensus Robustness
- Refactored and cleaned up the packer loop to improve block packing efficiency and long-term maintainability.
- Improved transaction ordering with non-local tx priority handling in the txpool.
- Fixed a priority price calculation bug that could affect transaction fee estimation.
- Improved finality handling in
await-until-steadyfor more robust consensus waiting. - Enhanced on-demand Solo mode to prevent block production with past timestamps.
APIs & Developer Tooling
- Added a raw storage retrieval API for direct access to blockchain state.
- Added build version information to API responses for easier debugging and version tracking.
- Thorclient improvements.
Observability & Operator Experience
- Enhanced logging infrastructure with configurable log levels and improved error reporting.
- Slow query logging is disabled by default to avoid unnecessary production overhead.
- Extended the
--networkflag to support both short and long forms (main/testandmainnet/testnet). - Added optional additional log indexes for improved log query performance via
--logdb-additional-indexes.
CI, Build & Test Reliability
- Increased and consolidated test coverage, including richer staker validation and permutation testing.
- Added and updated Go 1.25 support in build and test configurations.
- Updated Docker base images and Solidity Docker image used for contract compilation.
Contributors
Huge thanks to everyone who brought Hayabusa to life:
Full Changelog:
v2.4.0...v2.4.1