MIGRATE TO N3


BLOG November 14, 2025

Neo X MainNet v0.5.1 Upgrade Announcement

We are releasing Neo X MainNet v0.5.1, a patch version introducing several improvements and scheduled upgrades for the network.

This release adds support for event subscriptions from dBFT and enhances PreBlock construction, specifically in Envelope transaction handling. Since the Cancun and Prague upgrades have been successfully deployed on TestNet, this version also schedules the same upgrades for MainNet.

This version is fully compatible with v0.4.2 and v0.5.0 and does not require node resynchronization. For TestNet nodes, no configuration changes are needed when upgrading from v0.5.0. For MainNet nodes, DB reinitialization is required when upgrading from v0.4.2, as the Cancun and Prague forks are now enabled.

Upgrade Instructions (from TestNet v0.5.0 / MainNet v0.4.2 to v0.5.1)

  1. Download the new binary and updated genesis configuration file from the release page.

  2. Gracefully stop your node.

  3. Replace the old binary with the new binary.

  4. For MainNet nodes only: reinitialize the DB (do not delete it) using the following command:

    ./geth init --datadir ./node-datadir ./config/genesis.json

  5. Start your node.

New Features

  • Added support for real-time event subscriptions related to Envelopes.

Behavior Changes

  • Cancun fork enabled at timestamp 1763000000 on MainNet.

  • Prague fork enabled at timestamp 1763000000 on MainNet.

Improvements

  • Refactored PreBlock handling to prevent unexpected Envelope reverts.

  • Updated system contract documentation related to the Message Bridge.

We recommend all TestNet and MainNet node operators upgrade to v0.5.1 to ensure continued stability and compatibility with the upcoming forks.

Stay tuned for future updates!

Written by:
NGD
Tags: