Mainnet upgrade: v1.1

Instructions for the 2024-Dec-18 mainnet upgrade to axelar-core v1.1.2. Release notes can be found here

Upgrade height 15890800 countdown

The v1.1.2 upgrade is a consensus breaking release for Axelar mainnet. It enables the deployment of ITS Hub on mainnet.

  1. If you’re a validator or have delegated to one, please vote for the upgrade proposal via
Terminal window
axelard tx gov vote 257 yes --from validator

⚠️

axelard must be built with go-1.23 for this release.

  1. Wait for the proposed upgrade block, 15890800. Your node will panic at that block height with a log: {"level":"error","module":"consensus","err":"UPGRADE \"v1.1.2\" NEEDED at height: 15890800",. Stop your node after chain halt.
Terminal window
pkill -f 'axelard start'
# Validators need to also stop vald/tofnd
pkill -f 'vald-start'
pkill -f tofnd
  1. Backup the state:
Terminal window
cp -r ~/.axelar/.core/data ~/.axelar-dojo-1-upgrade-1.1.2/.core/data

⚠️

Caution: If you backup the entire folder, ~/.axelar/.core, that’ll also include your private keys (inside config and keyring-file subfolders). That can be dangerous if anyone gets access to your backups. We recommend backing up keys separately when you first create your node, and then excluding them from any data backups.

  1. Restart your node with the new v1.1.2 build.
  2. If you’re a validator also restart vald with v1.1.2 and tofnd with v1.0.1.

Example using join scripts in axelarate-community git repo:

Terminal window
# in axelarate-community repo
git checkout main
git pull
KEYRING_PASSWORD="pw-1" ./scripts/node.sh -n mainnet -a v1.1.2
# For validators, restart vald/tofnd
KEYRING_PASSWORD="pw-1" TOFND_PASSWORD="pw-2" ./scripts/validator-tools-host.sh -n mainnet -a v1.1.2 -q v1.0.1

Edit on GitHub