Mainnet upgrade: v1.0.2

About the mainnet v1.0 upgrade

This release enables mainnet deployment for Amplifier.

This release includes the following version updates:

Changelog

Changes since 0.35.x:

  • Various fixes that improve stability
  • New queries in the axelarnet module to query the IBC path for a chain and the chain by IBC path
  • Added a new message type “BatchRequest”. In contrast to cosmos default behaviour, where the entire tx gets rolled back if there is an error in any of the contained message executions, this batch only rolls back the state for the specific messages that fail and keeps the rest
  • Allow refundable messages to be batched
  • Correctly pass message IDs between core and the new amplifier
  • Add functionality to quickly (de)activate the connection between core and amplifier in case of emergencies

See all the changes in the axelar-core release notes.

Upgrade height 14231100 at approximately 2:30PM UTC on August 28th, 2024 (countdown)

⚠️

As of v1.0.2, the axelard binary releases require GLIBC_2.34, which is not present on Ubuntu 20.04.

You will need to compile axelard from source, or upgrade to Ubuntu 22.04.

⚠️

If using the community node setup scripts, please update to the latest commit on main first. wasmvm lib will be auto-downloaded to $AXELARD_HOME/lib but you’ll need to add it to LD_LIBRARY_PATH before running the script.

  1. If you’re a validator or have delegated to one, you can vote for the upgrade proposal, while it’s active, via
axelard tx gov vote 221 yes --from validator
  1. Wait for the proposed upgrade block, 14231100. Your node will panic at that block height with a log: {"level":"error","module":"consensus","err":"UPGRADE \"v1.0\" NEEDED at height: 14216700", ...}. Stop your node after chain halt.
pkill -f 'axelard start'
# Validators need to also stop vald/tofnd
pkill -f 'vald-start'
pkill -f tofnd
  1. Backup the state:
cp -r ~/.axelar/.core/data ~/.axelar-lisbon-3-upgrade-0.35/.core/data
⚠️

Caution: If you backup the entire folder, ~/.axelar_testnet/.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 axelard node with the new v1.0.2 build.
  2. If you’re a validator also restart vald with v1.0.2 and tofnd with v1.0.1.

Example using join scripts in axelarate-community git repo:

# in axelarate-community repo (https://github.com/axelarnetwork/axelarate-community)
git checkout main
git pull
KEYRING_PASSWORD="pw-1" ./scripts/node.sh -n testnet -a v1.0.2
# For validators, restart vald/tofnd
KEYRING_PASSWORD="pw-1" TOFND_PASSWORD="pw-2" ./scripts/validator-tools-host.sh -n testnet -a v1.0.2 -q v1.0.1
Edit this page