0xPolygon/heimdall-v2 - v0.2.9 New

Published: Jul 10, 2025

Release Summary

A new version of Heimdall-v2, v0.2.9, has been released for mainnet, incorporating important optimizations and fixes.

Critical Upgrade Information:
It is crucial that you upgrade your Bor client to v2.2.8 and Erigon to v3.0.14 before attempting to install this Heimdall update. Once Bor and Erigon are upgraded, then proceed with the Heimdall-v2 v0.2.9 upgrade in the same order.

Key Highlights in v0.2.9:

This release brings a notable performance enhancement with an optimized state sync query, which should improve the efficiency of node synchronization.

Additionally, the update includes numerous documentation improvements, providing clearer instructions for installation, Docker configurations (including validator setups), telemetry, and network port setups for sentries and other components. Critical fixes to migration scripts are also part of this release.

Release Notes

⚠️🚨  This version of heimdall-v2 for _mainnet_ must be installed **only after** Bor is upgraded to `v2.2.8` and Erigon is upgraded to `v3.0.14` 🚨⚠️ 
Once Bor/Erigon is upgraded, Heimdall-v2 should be upgraded to `v0.2.9` **in the same order**.



## What's Changed
* Fix migration script and shasum paths in doc by @kaustubhkapatral in https://github.com/0xPolygon/heimdall-v2/pull/341
* update docs with final v2 version by @marcello33 in https://github.com/0xPolygon/heimdall-v2/pull/343
* update docs with telemetry upgrade info by @marcello33 in https://github.com/0xPolygon/heimdall-v2/pull/345
* update order of instructions for docker by @marcello33 in https://github.com/0xPolygon/heimdall-v2/pull/346
* update instructions with ports protocols by @marcello33 in https://github.com/0xPolygon/heimdall-v2/pull/347
* update instructions with open ports for sentries by @marcello33 in https://github.com/0xPolygon/heimdall-v2/pull/348
* update instructions for docker vals by @marcello33 in https://github.com/0xPolygon/heimdall-v2/pull/349
* update send-ack instruction by @marcello33 in https://github.com/0xPolygon/heimdall-v2/pull/350
* update send-ack instruction - fix by @marcello33 in https://github.com/0xPolygon/heimdall-v2/pull/351
* update pex info by @marcello33 in https://github.com/0xPolygon/heimdall-v2/pull/352
* Updating sha512 and migrate.sh by @djpolygon in https://github.com/0xPolygon/heimdall-v2/pull/353
* x/clerk: fix TestGetRecordListWithTime_Pagination by @Raneet10 in https://github.com/0xPolygon/heimdall-v2/pull/355
* Optimize state sync query by @avalkov in https://github.com/0xPolygon/heimdall-v2/pull/354

## New Contributors
* @kaustubhkapatral made their first contribution in https://github.com/0xPolygon/heimdall-v2/pull/341

**Full Changelog**: https://github.com/0xPolygon/heimdall-v2/compare/v0.2.7...v0.2.9

Links

Back to 0xPolygon/heimdall-v2 releases