← Back to 0xPolygon/heimdall-v2 releases

0xPolygon/heimdall-v2 - v0.3.0 New

Published: Sep 2, 2025

MAINNET Deadline: Sep 16, 2025

Release Summary

Heimdall v0.3.0: Mandatory Mainnet Hard Fork Scheduled

This is a mandatory hard fork release for all mainnet node operators. The upgrade is scheduled for September 16th, 2025, around 14:00 UTC at block number 28913694. All node operators must upgrade their nodes before this block height to remain in sync with the network.

This release implements a permanent fix for a recent network outage and introduces significant operational changes and improvements.

Breaking Changes

Mandatory Upgrade: This hard fork is required to apply a crucial fix related to a previous network outage.

Bridge Process Change: The bridge can no longer be run as a separate, standalone process. It has been integrated into the main heimdalld service. Validators must now update their service configurations to start the bridge using a command similar to heimdalld start --bridge --all --rest-server.

Key Improvements and Features

Enhanced Stability: If the rest-server becomes unresponsive, heimdalld will no longer crash. It will now log persistent warning messages, allowing operators to diagnose and fix the issue without node downtime.

Proposer Reward Tracking: A new fee-transfer event is now emitted during the EndBlocker process. This makes it significantly easier for validators and indexers to track block proposal rewards.

Improved Monitoring: Additional Prometheus metrics have been added for sidechain messages (side_msgs) and ABCI handlers, offering deeper insights into node performance and behavior.

Consensus Fix: The voting power check has been re-enabled in the vote tallying process. This ensures the voting power from vote extensions does not exceed the total power of the current validator set, improving consensus stability.

CLI Command Fix: The generate-keystore command has been fixed. It now correctly respects a provided private key. The previous behavior of generating a random keystore is now available via the new --generate-new flag.

Other Notable Changes

The CI end-to-end testing framework has been migrated from matic-cli to kurtosis.

Dependencies have been updated, including `cosmos-sdk` and a switch from `nhooyr.io` to `github.com/coder/ws` for websockets to resolve build issues on certain operating systems.

The legacy "spans backfill" logic, used after the v1-to-v2 migration, has been removed.

Release Notes

**This is a hardfork release for mainnet, scheduled for September 16th 2025, at around 14:00 UTC (block number `28913694`)**

**It mainly contains the following changes.**

Breaking changes:
- a permanent fix for the recent outage requiring a hard fork, hence all node operators are required to upgrade ahead of time.
- the deletion of `bridge` as a standalone process. This means the `bridge` can't run now as a separate process, but will always be embedded in `heimdalld` as a child process via the `--bridge` flag. All validators (hence running the `bridge`) will need to adapt and use `heimdalld start --bridge --all --rest-server` (or variants of this command based on their setup) to start the `bridge` within the `heimdalld` service.

**New features, improvements and bug fixes:**
- Improvements to the `bridge` service and `rest-server` connection
- Validation of `bor_chain_id` during `checkpoints` workflow at `side_server` level against the chain parameters
- bump of dependencies
- replace `nhooyr.io` library with `github.com/coder ws` as per https://github.com/0xPolygon/heimdall-v2/pull/421 (thanks @DaveWK for your contribution)
- Fix some functions' comments as per https://github.com/0xPolygon/heimdall-v2/pull/383 (thanks @stellrust for your contribution)
- Expose proposer transfer event during `EndBlocker` as per https://github.com/0xPolygon/heimdall-v2/pull/376 (thanks @haiyanghe for your contribution). 
- Replace `matic-cli` with `kurtosis` for CI e2e tests
- additional metrics for `side_msgs` and `ABCI` handlers
- Removal of spans backfill logic post v1->v2 migration
- Fix the `generate-keystore` command
- Various minor improvements
 

## What's Changed
V0.3.0 candidate by @marcello33 in https://github.com/0xPolygon/heimdall-v2/pull/449, including the following PRs:

* chore: remove validator test case and bump kurtosis by @kamuikatsurgi in https://github.com/0xPolygon/heimdall-v2/pull/413
* chore: side msg and abci handler metrics by @kamuikatsurgi in https://github.com/0xPolygon/heimdall-v2/pull/410
* Delete spans backfill by @avalkov in https://github.com/0xPolygon/heimdall-v2/pull/344
* misc: migrated from maticnetwork to 0xPolygon by @pratikspatil024 in https://github.com/0xPolygon/heimdall-v2/pull/420
* chore: bump kurtosis by @kamuikatsurgi in https://github.com/0xPolygon/heimdall-v2/pull/422
* Re-enable voting power check in tally votes by @Raneet10 in https://github.com/0xPolygon/heimdall-v2/pull/409
* fix: build by @kamuikatsurgi in https://github.com/0xPolygon/heimdall-v2/pull/423
* Fix generate-keystore command by @Raneet10 in https://github.com/0xPolygon/heimdall-v2/pull/424
* update: cosmos-sdk by @kamuikatsurgi in https://github.com/0xPolygon/heimdall-v2/pull/425
* feat: bump kurtosis and migrate to pos-workflows by @kamuikatsurgi in https://github.com/0xPolygon/heimdall-v2/pull/431
* Resolve main-develop conflicts by @Raneet10 in https://github.com/0xPolygon/heimdall-v2/pull/430
* Back merge main->develop by @Raneet10 in https://github.com/0xPolygon/heimdall-v2/pull/428
* feat: remove matic-cli e2e-tests by @kamuikatsurgi in https://github.com/0xPolygon/heimdall-v2/pull/432
* bridge: improvements / app: improvements by @marcello33 in https://github.com/0xPolygon/heimdall-v2/pull/427
* Set voting power and valset check heights for amoy by @Raneet10 in https://github.com/0xPolygon/heimdall-v2/pull/435
* Add penultimate valset to genesis export by @Raneet10 in https://github.com/0xPolygon/heimdall-v2/pull/436


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

Links

Back to 0xPolygon/heimdall-v2 releases