0xPolygon/heimdall-v2 - v0.2.15

Published: Jul 28, 2025

Release Summary

Heimdall v0.2.15 has been released. This version includes important bug fixes and improvements. Node operators on amoy and mainnet are recommended to upgrade.


Key Highlights

Critical Bug Fixes

A major issue has been resolved where Heimdall's listener failed to determine the correct ChainID if it was not explicitly set via the command line. This could cause `CommitTimeout` errors and prevent checkpoint submission. The listener now correctly falls back to the network ChainID from the node's status, significantly improving reliability, particularly for nodes with minimal configurations or after a bridge DB reset.


New Features & Enhancements

- New Metrics Package: A new `metrics` package has been introduced to provide metrics related to API calls in different modules. This enhances monitoring and observability for node operators.
- Docker Image Optimization: The Dockerfile now uses a multi-stage build, which dramatically reduces the final image size from hundreds of megabytes to a much smaller footprint. This makes deployments faster and more efficient.
- New `show-account` Command: Ported from Heimdall v1, this new command displays the account's public key in the standard Ethereum format, providing a useful utility for operators.


Other Command Fixes and Improvements

- The `import-validator-key` command has been fixed to ensure it properly registers crypto types before importing a key.
- The `send-checkpoint` command now correctly sets the Bor chain ID when using the `--auto-configure` flag.
- Fixed an issue with generating the `priv_validator_key.json` file from a private key.
- Added a missing nil check to prevent a panic when an account is not found.
- Improved contract address validation within the side handler.

Release Notes

This release contains some bug fixs and improvements. It is recommended to upgrade your nodes amoy and mainnet to this version.

## What's Changed
* backport v0.2.14 to develop by @pratikspatil024 in https://github.com/0xPolygon/heimdall-v2/pull/391
* Dockerfile: use multi-stage build optimisation by @kamuikatsurgi in https://github.com/0xPolygon/heimdall-v2/pull/394
* Add missing nil check if account is not found by @avalkov in https://github.com/0xPolygon/heimdall-v2/pull/397
* feat: Initialise metrics package and add metrics related to module APIs by @kamuikatsurgi in https://github.com/0xPolygon/heimdall-v2/pull/388
* feat(ci): Kurtosis E2E tests by @kamuikatsurgi in https://github.com/0xPolygon/heimdall-v2/pull/389
* Fix generating of priv validator file from private key by @avalkov in https://github.com/0xPolygon/heimdall-v2/pull/398
* Add show-account command by @Raneet10 in https://github.com/0xPolygon/heimdall-v2/pull/396
* Set bor chain id in send-checkpoint command when auto-configure is set by @Raneet10 in https://github.com/0xPolygon/heimdall-v2/pull/395
* fix(listener): fallback to correct ChainID when cliCtx.ChainID is unset by @SunSet0418 in https://github.com/0xPolygon/heimdall-v2/pull/393
* chore: bump alpine image in release dockerfile by @kamuikatsurgi in https://github.com/0xPolygon/heimdall-v2/pull/400
* Fix import-validator-key command by @Raneet10 in https://github.com/0xPolygon/heimdall-v2/pull/399
* Fix contract address validation in side handler by @Raneet10 in https://github.com/0xPolygon/heimdall-v2/pull/405
* V0.2.15 by @pratikspatil024 in https://github.com/0xPolygon/heimdall-v2/pull/406

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

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

Links

Back to 0xPolygon/heimdall-v2 releases