|
| 1 | +# Mainnet upgrade: v1.1 |
| 2 | + |
| 3 | +import { Callout } from "/src/components/callout"; |
| 4 | + |
| 5 | +Instructions for the `2024-Dec-18` mainnet upgrade to axelar-core `v1.1.2`. |
| 6 | +Release notes can be found [here](https://github.com/axelarnetwork/axelar-core/releases/tag/v1.1.2) |
| 7 | + |
| 8 | +Upgrade height `15890800` [countdown](https://www.mintscan.io/axelar/block/15890800) |
| 9 | + |
| 10 | +## About the v1.1 upgrade |
| 11 | +The `v1.1.2` upgrade is a consensus breaking release for Axelar mainnet. It enables the deployment of ITS Hub on mainnet. |
| 12 | + |
| 13 | +1. If you're a validator or have delegated to one, please vote for the upgrade proposal via |
| 14 | + |
| 15 | + |
| 16 | +```bash |
| 17 | +axelard tx gov vote 257 yes --from validator |
| 18 | +``` |
| 19 | + |
| 20 | +<Callout type="warning" emoji="⚠️"> |
| 21 | + `axelard` must be built with `go-1.23` for this release. |
| 22 | +</Callout> |
| 23 | + |
| 24 | + |
| 25 | +2. 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. |
| 26 | + |
| 27 | +```bash |
| 28 | +pkill -f 'axelard start' |
| 29 | +# Validators need to also stop vald/tofnd |
| 30 | +pkill -f 'vald-start' |
| 31 | +pkill -f tofnd |
| 32 | +``` |
| 33 | + |
| 34 | +3. Backup the state: |
| 35 | + |
| 36 | +```bash |
| 37 | +cp -r ~/.axelar/.core/data ~/.axelar-dojo-1-upgrade-1.1.2/.core/data |
| 38 | +``` |
| 39 | + |
| 40 | +<Callout type="warning" emoji="⚠️"> |
| 41 | + Caution: If you backup the entire folder, `~/.axelar/.core`, that'll |
| 42 | + also include your private keys (inside `config` and `keyring-file` |
| 43 | + subfolders). That can be dangerous if anyone gets access to your backups. We |
| 44 | + recommend backing up keys separately when you first create your node, and then |
| 45 | + excluding them from any data backups. |
| 46 | +</Callout> |
| 47 | + |
| 48 | +4. Restart your node with the new `v1.1.2` build. |
| 49 | +5. If you're a validator also restart `vald` with `v1.1.2` and `tofnd` with `v1.0.1`. |
| 50 | + |
| 51 | +Example using join scripts in [axelarate-community git repo](https://github.com/axelarnetwork/axelarate-community): |
| 52 | + |
| 53 | + |
| 54 | + |
| 55 | +```bash |
| 56 | +# in axelarate-community repo |
| 57 | +git checkout main |
| 58 | +git pull |
| 59 | +KEYRING_PASSWORD="pw-1" ./scripts/node.sh -n mainnet -a v1.1.2 |
| 60 | +# For validators, restart vald/tofnd |
| 61 | +KEYRING_PASSWORD="pw-1" TOFND_PASSWORD="pw-2" ./scripts/validator-tools-host.sh -n mainnet -a v1.1.2 -q v1.0.1 |
| 62 | +``` |
0 commit comments