From acf7a69fdf7dfa590da12830696dda0738794581 Mon Sep 17 00:00:00 2001 From: haiyizxx Date: Tue, 11 Feb 2025 16:36:28 -0500 Subject: [PATCH] doc(testnet): upgrade doc for v1.2 (#1291) --- .../docs/resources/testnet/upgrades/v121.mdx | 66 +++++++++++++++++++ src/content/docs/validator/setup/manual.mdx | 6 +- src/layouts/navigation.ts | 4 ++ src/upgrade-path-testnet.md | 5 +- 4 files changed, 76 insertions(+), 5 deletions(-) create mode 100644 src/content/docs/resources/testnet/upgrades/v121.mdx diff --git a/src/content/docs/resources/testnet/upgrades/v121.mdx b/src/content/docs/resources/testnet/upgrades/v121.mdx new file mode 100644 index 000000000..e4e456b9e --- /dev/null +++ b/src/content/docs/resources/testnet/upgrades/v121.mdx @@ -0,0 +1,66 @@ +# Testnet upgrade: v1.2 + +import { Callout } from "/src/components/callout"; + +Instructions for the `v1.2` testnet upgrade to axelar-core `v1.2.1`. +Release can be found [here](https://github.com/axelarnetwork/axelar-core/releases/tag/v1.2.1) + +Upgrade height `17629900` [countdown](https://www.mintscan.io/axelar-testnet/block/17629900) + +## About the v1.2 upgrade +The `v1.2` upgrade is a consensus breaking release for Axelar testnet. + +1. If you're a validator or have delegated to one, please vote for the upgrade proposal via + +```bash +axelard tx gov vote 201 yes --from validator +``` + + + `axelard` must be built with `go-1.23` for this release. + + Node operators using binaries need to update `wasmvm` from `v1.3.1` to `v1.5.8` [libwasmvm.x86_64.so](https://github.com/CosmWasm/wasmvm/releases/tag/v1.5.8), and add the folder containing the library to `LD_LIBRARY_PATH`. + + 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. + + + +2. Wait for the proposed upgrade block, `17629900`. Your node will panic at that block height with a log: `{"level":"error","module":"consensus","err":"UPGRADE \"v1.2\" NEEDED at height: 17629900",`. Stop your node after chain halt. + +```bash +pkill -f 'axelard start' +# Validators need to also stop vald/tofnd +pkill -f 'vald-start' +pkill -f tofnd +``` + +3. Backup the state: + +```bash +cp -r ~/.axelar_testnet/.core/data ~/.axelar-lisbon-3-upgrade-1.2.1/.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. + + + +4. Restart your `axelard` node with the new `v1.2.1` build. +5. If you're a validator also restart `vald` with `v1.2.1` and `tofnd` with `v1.0.1`. + +Example using join scripts in [axelarate-community git repo](https://github.com/axelarnetwork/axelarate-community): + +```bash +# in axelarate-community repo +git checkout main +git pull +KEYRING_PASSWORD="pw-1" ./scripts/node.sh -n testnet -a v1.2.1 +# For validators, restart vald/tofnd +KEYRING_PASSWORD="pw-1" TOFND_PASSWORD="pw-2" ./scripts/validator-tools-host.sh -n testnet -a v1.2.1 -q v1.0.1 +``` + diff --git a/src/content/docs/validator/setup/manual.mdx b/src/content/docs/validator/setup/manual.mdx index 878cd7882..f5eb273e1 100644 --- a/src/content/docs/validator/setup/manual.mdx +++ b/src/content/docs/validator/setup/manual.mdx @@ -17,7 +17,7 @@ Check the appropriate version for the network accordingly: ```bash -AXELARD_RELEASE=v1.0.5 +AXELARD_RELEASE=v1.1.3 TOFND_RELEASE=v1.0.1 WASMVM_RELEASE=v1.3.1 ``` @@ -25,9 +25,9 @@ WASMVM_RELEASE=v1.3.1 ```bash -AXELARD_RELEASE=v1.0.5 +AXELARD_RELEASE=v1.2.1 TOFND_RELEASE=v1.0.1 -WASMVM_RELEASE=v1.3.1 +WASMVM_RELEASE=v1.5.8 ``` diff --git a/src/layouts/navigation.ts b/src/layouts/navigation.ts index ac6f274f7..f94d38aa5 100644 --- a/src/layouts/navigation.ts +++ b/src/layouts/navigation.ts @@ -703,6 +703,10 @@ export const getNavigation = (section) => { { title: "Testnet axelard", children: [ + { + title: "v1.2", + href: "/resources/testnet/upgrades/v121/", + }, { title: "v1.1", href: "/resources/testnet/upgrades/v112/", diff --git a/src/upgrade-path-testnet.md b/src/upgrade-path-testnet.md index f60b746e2..6d83b0247 100644 --- a/src/upgrade-path-testnet.md +++ b/src/upgrade-path-testnet.md @@ -27,5 +27,6 @@ layout: /src/layouts/None.astro | [v0.33.2](/resources/testnet/upgrades/v33/) | 8528500 | 9462850 | | [v0.34.3](/resources/testnet/upgrades/v34/) | 9462850 | 12017025 | | [v0.35.3](/resources/testnet/upgrades/v35/) | 12017025 | 14625900 | -| [v1.0.0](/resources/testnet/upgrades/v11/) | 14625900 | 16665600 | -| [v1.1.2](/resources/testnet/upgrades/v112/) | 16665600 | N/A | +| [v1.0.0](/resources/testnet/upgrades/v11/) | 14625900 | 16665600 | +| [v1.1.2](/resources/testnet/upgrades/v112/) | 16665600 | 17629900 | +| [v1.2.1](/resources/testnet/upgrades/v121/) | 17629900 | N/A |