Skip to content

Releases: harmony-one/harmony

Mainnet Release 2026.0.0

04 Mar 12:12
v2026.0.0
638a6e7

Choose a tag to compare

This is a mandatory node upgrade, however, there is no specific deadline since there is no hardfork.
Still Validator and Explorer/RPC nodes are strongly encouraged to upgrade, because there were a lot of code changes on the p2p, consensus, evm and sync changes.

The released version: v2026.0.0-0-g638a6e7f6

Set of changes:

Open Beta: Stream Sync (P2P-Based Synchronization)
  • Introduces Stream Sync as a fully P2P-based synchronization mechanism, removing reliance on DNS-based syncing.
  • Implements staged full synchronization with smart stream selection and failure-based prioritization.
  • Adds progress-based timeouts, configurable chunk sizes, improved stream health monitoring, and structured stream error classification.
  • Integrates BlockNumberCache to reduce redundant block number requests and improve sync efficiency.
  • Enhances crosslink validation, epoch filtering, and sync lifecycle handling to prevent nodes from getting stuck.
  • Includes comprehensive memory leak prevention and cleanup logic across stream and download managers.
  • If you want to go deeper, please read specification

Important

Please note: Stream Sync remains optional; legacy synchronization remains the default for operators.


P2P Transport & Muxer Updates
  • Replaces deprecated mplex with updated muxer configuration.
  • Introduces mplexC6 and prioritizes yamux during connection negotiation.
  • Improves muxer negotiation logic with case-insensitive handling.
  • Adds logging to indicate negotiated muxer per connection.
  • Limits P2P stream goroutines to prevent resource exhaustion.
  • Reduces log noise from benign stream removal events.

Important

During the transition from legacy mplex to mplexC6, yamux acts as a compatibility bridge to ensure seamless connectivity between upgraded and non-upgraded nodes.
Operators are safe to upgrade — connection interoperability is preserved during the transition period.


BlockNumberCache: Performance and Stability Improvements
  • Adds BlockNumberCache to optimize block height queries across peers.
  • Tracks cache hit/miss statistics and invalidates entries on stream failures.
  • Fixes eviction edge cases, race conditions, and double-stop panics.
  • Ensures safe shutdown by stopping background cleanup goroutines.
  • Includes benchmarks and extended test coverage.
BLS12-381 / EIP-2537 Precompile Support
  • Implements full BLS12-381 elliptic curve precompiles including G1, G2, pairing, SWU, and isogeny operations.
  • Adds field arithmetic support (fp, fp2, fp6, fp12) and optimized multiplication backends.
  • Updates gas cost calculations and activation configuration under EIP-2537.
  • Aligns precompile initialization and address assignments with protocol specifications.
  • Adds comprehensive success and failure test coverage.

Important

Please note: this change will require a future hard fork. The activation date will be announced separately.


go-ethereum Upgrade & EVM Alignment
  • Upgrades embedded go-ethereum components to align with upstream behavior.
  • Aligns SSTORE gas calculation and jump table initialization with latest go-ethereum rules.
  • Fixes tracer-related fork risks during block processing.
  • Resolves nil trie panics and edge cases leading to potential data inconsistencies.
  • Updates chain ID handling and built-in EVM logic to match upstream implementation.
  • Improves RLP decoding fallback handling for better compatibility and stability.
Shard Configuration Update (4 → 2)
  • Updates shard count from 4 to 2 across configuration files.
  • Adjusts wallet, Rosetta, VM tests, and consensus constants accordingly.
  • Removes obsolete shard configuration sections.
Trusted Peers & Networking Enhancements
  • Improves trusted peer handling with DNS auto-population.
  • Prevents self-dial errors and fixes bootnode nil host panics.
  • Enhances stream removal logic and error handling stability.
  • Expands networking-related metrics for better observability.
Monitoring & Stability Improvements
  • Expands metrics for stream management and recoverable errors.
  • Prevents goroutine leaks and improves cleanup logic.
  • Reduces log noise while improving contextual logging.
  • Increases test coverage for race conditions and edge cases.

PR list:

Read more

Mainnet Release 2025.1.0 and 2025.1.1

29 May 14:39
v2025.1.1

Choose a tag to compare

Mainnet Release v2025.1.1

This is a mandatory validator upgrade, however, there is no specific deadline since there is no hardfork. The release improves consensus and network stability.

Validator and Explorer/RPC nodes are strongly encouraged to upgrade, because there were several fixes:

  • effectiveGas field in the old getTransactionReceipt operation
  • fix for the ShardIDFromKey
  • upgrade to the go 1.24
  • implementation of EIP-1153
  • consensus logic minor improvements
  • bootnode's stability improvements
  • ongoing stream sync development

The released version: v2025.1.1-0-gca41a9970

What's Changed

  • feat(hmy_tests) - enable new test job for each PR and new commits to main and dev by @mur-me in #4899
  • Fully Disable Libp2p Resource Manager by Setting ResourceManager to nil by @GheisMohammadi in #4901
  • Improve Stream Handling, Avoid Stream Reset on Recoverable Failures by @GheisMohammadi in #4900
  • Fix P2P Host Gater Initialization, Add new Blocking Gater to P2P Host by @GheisMohammadi in #4904

Full Changelog: v2025.1.0...v2025.1.1

The released version: v2025.1.0-0-ge10d464a9

What's Changed

New Contributors

Full Changelog: v2025.0.0...v2025.1.0

Mainnet Release 2025.0.0

27 Jan 08:13
a63980b

Choose a tag to compare

Mainnet Release v2025.0.0

This is a mandatory validator upgrade, however, there is no specific deadline since there is no hardfork. The release improves consensus and network stability.

Explorer/RPC nodes are strongly encouraged to upgrade if they require support for the effectiveGasPrice field in transaction receipts.

The released version: v2025.0.0-0-ga63980b9

What's Changed

New Contributors

Full Changelog: v2024.3.1...v2025.0.0

Mainnet Release 2024.3.0 and 2024.3.1

17 Oct 04:08
8ba758a

Choose a tag to compare

Mainnet Release v2024.3.0 and v2024.3.1

Attention mainnet node operators: A mandatory upgrade is required as a hardfork will occur at epoch 2152 (block 64,847,872), approximately on October 31, 2024, at 13:02 UTC.

This upgrade will activate the first phase of HIP32, marking a significant step toward full decentralization. Leader rotation will be enabled, and Harmony’s internal nodes will be reduced to 2 slots per shard with 1% vote power.

Additionally, this upgrade will enhance epoch transitions on Shard 1, which is expected to significantly reduce signature losses.

Please ensure your node is updated before the hardfork to maintain network compatibility and stability.

The released version: v2024.3.1-0-g8ba758a4

What's Changed in v2024.3.1-0

#4774 - [ci] upgrade github actions and merge artifacts

Full Changelog: v2024.3.0...v2024.3.1

What's Changed in v2024.3.0-0

#4747 - add connection manager high water mark flag to boot node
#4739 - Lock free consensus methods
#4745 - [CI] - point to master, cover fork repos in ci, silence docker output
#4752 - stable localnet with external
#4735 - Add RPC for Boot Nodes
#4755 - feat(Makefile) - cover verbose mode for the local debug
#4754 - Improve Crosslinks Retrieving and Processing
#4753 - Fix for localnet syncing ports.
#4758 - feat(localnet) - add localnet log aggregation tool
#4761 - feat(Makefile) - add switch for the legacy sync, make stream sync default option
#4748 - Broadcast vote power
#4756 - Broadcast epoch block
#4763 - [localnet] fix external config
#4764 - Switch Localnet Muxer to Yamux
#4766 - feat(RPC) - GetLastSigningPower on public harmony API
#4765 - Improve Crosslink Retrieve from RawDB
#4757 - Not Checking Pending Crosslinks for First ten Epoch
#4663 - Empty signing power workaround
#4769 / #4770 - Set HIP32 epoch activation to 2152 and set new sharding config

Full Changelog: v2024.3.0...v2024.3.1

Mainnet Release 2024.2.0

02 Sep 05:09
c44c2ea

Choose a tag to compare

Mainnet Release v2024.2.0

This is a non-mandatory upgrade for validator and explorer nodes. We are now using Go 1.22.5 and this release includes several bug fixes, performance enhancements, and protocol improvements for both Harmony nodes and boot nodes.

The released version: v2024.2.0-0-gc44c2ea8

What's Changed

New Contributors

Full Changelog: v2024.0.0...v2024.2.0

Mainnet Release 2024.1.0

16 Jun 06:41
b02ea4c

Choose a tag to compare

Mainnet Release v2024.1.0

Mandatory upgrade for all mainnet node operator. This upgrade contains a hardfork happening at epoch 1976 (block 59080704) approximatively on June 20, 2024 at 00:06:49 UTC.

This update will address the validator max rate issue and enforce a uniform validator rate check.

Released version: v2024.1.0-0-gb02ea4c8

What's Changed

Full Changelog: v2024.0.0...v2024.1.0

Mainnet Release 2024.0.0

06 Mar 04:40
b3aebb6

Choose a tag to compare

Pre-release

Mainnet Release v2024.0.0

Non mandatory release upgrade for all nodes (RPC and Validator) but recommended for improved stability.

What's Changed

New Contributors

Full Changelog: v2023.4.2...v2024.0.0

Mainnet Release 2023.4.2

19 Dec 10:13
8717ccf

Choose a tag to compare

Mainnet Release 2023.4.2

The released version: v2023.4.2-0-g8717ccf6

What's Changed

Full Changelog: v2023.4.1...v2023.4.2

Mainnet Release 2023.4.1

18 Dec 19:51
dd65484

Choose a tag to compare

Mainnet Release v2023.4.1

This version contains bug in the tx hash result and shouldn't be used by any RPC node provider. Please upgrade to v2023.4.2 for a more stable version.

The released version: v2023.4.1-0-gdd65484d

What's Changed

Full Changelog: v2023.4.0...v2023.4.1

Mainnet Release 2023.4.0

15 Dec 18:08
3e7ff38

Choose a tag to compare

Mainnet Release v2023.4.0

The released version: v2023.4.0-0-g3e7ff383

This is an urgent update required by all validators. Hard-forking update that will go into effect on epoch 1733 at blockheight 51118080

Estimated Hard-Fork Date: 2023-12-17 12:20:15+00:00

What's Changed

Note

This version contains bug in the tx hash result and shouldn't be used by any RPC node provider. Please upgrade to v2023.4.2 for a more stable version.

Full Changelog: v2023.3.0...v2023.4.0