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

TL;DR

• Simply ensure the omniops/halovisor:v0.15.0 docker image is running BEFORE the upgrade height.
  • halovisor:v0.15.0: wraps cosmovisor with 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: 13926000 ~= 20 May 2025 12 UTC (noon).
• Mainnet upgrade height and date: 12046000 ~= 22 May 2025 12 UTC (noon).
• Version(s) supported before upgrade: halo:v0.13.0 .. v0.14.1
• Version required after upgrade: halo:v0.15.0

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

Details

The 3_drake upgrade is the third network upgrade (hard fork) planned for the Omni network and is included in the halo:v0.15.0 release.

The upgrade contains changes to halo's logic adding support withdrawals of staking delegations and staking rewards from the omni consensus chain to the omni EVM.

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.15.0 contains the halo:v0.14.1 and halo:v0.15.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.15.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.15.0
   

3. 🥉Manual binary/docker swapping

   • Swapping halo binary version manually is also an option.
   • When halo:v0.14.1 reaches the network upgrade height, it will stall.
   • Stop it, and replace it with halo:v0.15.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.