Skip to content

Commit

Permalink
feat: add mainnet v1.0 update instructions (#1114)
Browse files Browse the repository at this point in the history
  • Loading branch information
StephenFluin authored Aug 21, 2024
1 parent cef7010 commit 7048bc9
Show file tree
Hide file tree
Showing 2 changed files with 82 additions and 2 deletions.
80 changes: 80 additions & 0 deletions src/pages/resources/mainnet/upgrades/v1.0.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
# Mainnet upgrade: v1.0.2

import { Callout } from '/src/components/callout'

## About the mainnet v1.0 upgrade

This release enables mainnet deployment for [Amplifier](/dev/amplifier/introduction).

This release includes the following version updates:
- `axelard` and `vald` to [1.0.2](https://github.com/axelarnetwork/axelar-core/releases/tag/v1.0.2)
- `tofnd` to [1.0.1](https://github.com/axelarnetwork/tofnd/releases/tag/v1.0.1)


## 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](https://github.com/axelarnetwork/axelar-core/releases).

Upgrade height `14231100` at approximately **2:30PM UTC on August 28th, 2024** ([countdown](https://www.mintscan.io/axelar/block/14231100))

<Callout type="warning" emoji="⚠️">
As of v1.0.2, the `axelard` [binary releases](https://github.com/axelarnetwork/axelar-core/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.
</Callout>

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

1. If you're a validator or have delegated to one, you can vote for the upgrade proposal, while it's active, via

```bash
axelard tx gov vote 221 yes --from validator
```

2. 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.

```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/.core/data ~/.axelar-lisbon-3-upgrade-0.35/.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.0.2` build.
5. 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](https://github.com/axelarnetwork/axelarate-community):

```bash
# 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
```
4 changes: 2 additions & 2 deletions src/pages/resources/testnet/upgrades/v1.0.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ Example using join scripts in [axelarate-community git repo](https://github.com/
# 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.1
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.1 -q v0.10.1
KEYRING_PASSWORD="pw-1" TOFND_PASSWORD="pw-2" ./scripts/validator-tools-host.sh -n testnet -a v1.0.2 -q v0.10.1
```

0 comments on commit 7048bc9

Please sign in to comment.