Skip to content

Commit

Permalink
doc(testnet): upgrade doc for v1.2 (#1291)
Browse files Browse the repository at this point in the history
  • Loading branch information
haiyizxx authored Feb 11, 2025
1 parent 45cb03f commit acf7a69
Show file tree
Hide file tree
Showing 4 changed files with 76 additions and 5 deletions.
66 changes: 66 additions & 0 deletions src/content/docs/resources/testnet/upgrades/v121.mdx
Original file line number Diff line number Diff line change
@@ -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
```

<Callout type="warning" emoji="⚠️">
`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.
</Callout>


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
```

<Callout type="warning" emoji="⚠️">
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.
</Callout>


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
```

6 changes: 3 additions & 3 deletions src/content/docs/validator/setup/manual.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,17 +17,17 @@ Check the appropriate version for the network accordingly:
<tabs>
<tab-item title="Mainnet">
```bash
AXELARD_RELEASE=v1.0.5
AXELARD_RELEASE=v1.1.3
TOFND_RELEASE=v1.0.1
WASMVM_RELEASE=v1.3.1
```

</tab-item>
<tab-item title="Testnet">
```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
```

</tab-item>
Expand Down
4 changes: 4 additions & 0 deletions src/layouts/navigation.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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/",
Expand Down
5 changes: 3 additions & 2 deletions src/upgrade-path-testnet.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |

0 comments on commit acf7a69

Please sign in to comment.