Skip to content

Celestia network upgrade process

Blockchain networks often times need to upgrade with new features which require coordination work among the validators prior to activating the upgrades.

This process is called a network upgrade, which can be breaking or non-breaking. During planned network upgrades, the Celestia Labs team will coordinate with the validators to prepare for the upcoming network upgrade.

Breaking network upgrades are not backward-compatible with older versions of the network software which is why it is important that validators upgrade their software to continue validating on the network after the network upgrades.

Non-breaking network upgrades are backward-compatible and require less coordination.

General process

The general process can be broken down into several components:

  • Network upgrade specifications and features (defined by description of features and code implementation of those features).
  • Binary used to add those features. A new binary release with those features will be provided by Celestia Labs team in order for validators to upgrade their nodes to the new binary.
  • A block number for when the breaking network upgrade. Even if validators upgrade their binary to be network upgrade ready, the network upgrade does not happen right away, but some short time in the future at a specific block number.
  • Testing of the features, which happens on testnets first prior to activating on Mainnet Beta in order to ensure the network can upgrade securely.

The two testnets where network upgrades are deployed are:

Lemongrass network upgrade

The Lemongrass network upgrade is the first consensus layer breaking change since Celestia's Mainnet Beta genesis block. The Lemongrass network upgrade includes all of the CIPs listed in CIP-17. The Lemongrass network upgrade will be executed on Arabica, then Mocha, then Mainnet Beta. The network upgrade will take place at an "upgrade height" that will be coordinated offline on a per-network basis. The upgrade heights will be announced in advance (see network upgrades channels) to give node operators time to download and start a compatible binary prior to the upgrade height.

  • If you are a consensus node or validator operator: you will need to download and run a celestia-app binary >= v2.0.0 prior to the --v2-upgrade-height to remain on the canonical chain.
  • If you are a DA node operator, you will need to download and run a compatible celestia-node binary >= v0.16.0-rc0 prior to the upgrade height.
NetworkChain IDDate and approximate time--v2-upgrade-height
Arabicaarabica-112024/08/19 @ 14:00 UTC1751707
Mochamocha-42024/08/28 @ 14:00 UTC2585031
Mainnet Betacelestia2024/09/18 @ 14:00 UTC2371495

WARNING

You do not need to use a tool like cosmovisor to upgrade the binary at the upgrade height. Please upgrade your binary several blocks before the upgrade height.