This guide describes the process to participate in the critical coordinated Omni 4_earhart network upgrade (hard fork). This follows on the previous 3_drake , 2_magellan, and 1_uluwatu network upgrades.

TL;DR

• Simply ensure the omniops/halovisor:v0.17.0 docker image is running BEFORE the upgrade height.
  • halovisor:v0.17.0: wraps cosmovisor with halo:v0.16.0 (3_drake) and halo:v0.14.1 (2_magellan) and halo:v0.15.0 (3_drake)
  • It will perform the binary switch automatically at the required block.
• Omega upgrade height and date: 20128000 +~= 26 Aug 2025 13h00 UTC.
• Mainnet upgrade height and date: TBD.
• Version(s) supported before upgrade: halo:v0.15.0 .. v0.16.0
• Version required after upgrade: halo:v0.17.0

🚧 Like any blockchain network upgrade (hard fork), nodes that do not upgrade will stall.

Details

The 4_earhart upgrade is the fourth network upgrade (hard fork) planned for the Omni network and is included in the halo:v0.17.0 release.

The upgrade contains changes to halo's logic adding support EVM redenomination from OMNI to NOM, increasing the EVM account balances by 75x.

No changes to geth is required, this version is still compatible with v1.14.13.

See the Validator FAQ for details on halovisor vs halo and docker vs binaries

halo Deployment Instructions

There are basically three ways to run a halo:

1. 🥇omniops/halovisor:<latest> docker container

   • Simply run the latest version of halovisor docker container BEFORE the upgrade height. It will automatically detect and run the correct halo binary version using cosmovisor internally.
   • E.g. omniops/halovisor:v0.17.0 contains the halo:v0.14.1 and halo:v0.16.0 and halo:v0.17.0 binaries and will automatically switch at the correct height.
   • It only requires a single docker volume mount: -v ~/.omni/<network>/halo:/halo
   • It will persist the cosmovisor “current” binary symlink to: /halo/halovisor-current

2. 🥈Standard Cosmovisor with halo binaries

   • Install and configure stock-standard CosmosSDK Cosmovisor with halo binaries, see docs here and here and here. This will also automatically swap the “current” binary at the correct height.
   • The binaries versions to use are:
     • genesis: halo:v0.8.1
     • upgrade/1_uluwatu: halo:v0.12.0
     • upgrade/2_magellan: halo:v0.14.1
     • upgrade/3_drake: halo:v0.16.0
     • upgrade/4_earhart: halo:v0.17.0
   • Suggested env vars:
     • ENV DAEMON_ALLOW_DOWNLOAD_BINARIES=false
     • ENV DAEMON_RESTART_AFTER_UPGRADE=true
   • The folder structure should be:

   ~/.omni/omega/halo # $DEAMONHOME
     ├─ data/...
     ├─ config/...
     ├─ cosmovisor/
     │ ├── genesis/bin/$DEAMONNAME             # halo:v0.8.1
     │ ├── upgrades/1_uluwatu/bin/$DEAMONNAME  # halo:v0.12.0
     │ ├── upgrades/2_magellan/bin/$DEAMONNAME # halo:v0.14.1
     │ ├── upgrades/3_drake/bin/$DEAMONNAME    # halo:v0.16.0
     │ ├── upgrades/4_earhart/bin/$DEAMONNAME  # halo:v0.17.0
   

3. 🥉Manual binary/docker swapping

   • Swapping halo binary version manually is also an option.
   • When halo:v0.16.0 reaches the network upgrade height, it will stall.
   • Stop it, and replace it with halo:v0.17.0
   • Start the node and it should catch up and continue processing the chain.
   • Note this will include downtime and is therefore not advised for validators as will negatively impact validator performance.