Skip to content

Commit

Permalink
feat: added v1.1.2 core upgrade docs (#1275)
Browse files Browse the repository at this point in the history
  • Loading branch information
benjamin852 authored Dec 13, 2024
1 parent 8acbd67 commit 278ed4e
Show file tree
Hide file tree
Showing 4 changed files with 77 additions and 5 deletions.
62 changes: 62 additions & 0 deletions src/content/docs/resources/mainnet/upgrades/v112.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# Mainnet upgrade: v1.1

import { Callout } from "/src/components/callout";

Instructions for the `2024-Dec-18` mainnet upgrade to axelar-core `v1.1.2`.
Release notes can be found [here](https://github.com/axelarnetwork/axelar-core/releases/tag/v1.1.2)

Upgrade height `15890800` [countdown](https://www.mintscan.io/axelar/block/15890800)

## About the v1.1 upgrade
The `v1.1.2` upgrade is a consensus breaking release for Axelar mainnet. It enables the deployment of ITS Hub on mainnet.

1. If you're a validator or have delegated to one, please vote for the upgrade proposal via


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

<Callout type="warning" emoji="⚠️">
`axelard` must be built with `go-1.23` for this release.
</Callout>


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.

```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-dojo-1-upgrade-1.1.2/.core/data
```

<Callout type="warning" emoji="⚠️">
Caution: If you backup the entire folder, `~/.axelar/.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 node with the new `v1.1.2` build.
5. If you're a validator also restart `vald` with `v1.1.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
git checkout main
git pull
KEYRING_PASSWORD="pw-1" ./scripts/node.sh -n mainnet -a v1.1.2
# For validators, restart vald/tofnd
KEYRING_PASSWORD="pw-1" TOFND_PASSWORD="pw-2" ./scripts/validator-tools-host.sh -n mainnet -a v1.1.2 -q v1.0.1
```
8 changes: 4 additions & 4 deletions src/content/docs/resources/testnet/upgrades/v112.mdx
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Testnet upgrade: V1.1.2
# Testnet upgrade: v1.1

import { Callout } from "/src/components/callout";

Expand All @@ -7,8 +7,8 @@ Release can be found [here](https://github.com/axelarnetwork/axelar-core/release

Upgrade height `16665600` [countdown](https://www.mintscan.io/axelar-testnet/block/16665600)

## About the V1.1.2 upgrade
The `v1.1.2` upgrade is a non-consensus breaking patch release for `v1.1.x.` `v1.1.x.` Once live, it will enable the deployment of ITS Hub on testnet.
## About the v1.1 upgrade
The `v1.1.2` upgrade is a consensus breaking release for Axelar testnet. Once live, it will enable the deployment of ITS Hub on testnet.

1. If you're a validator or have delegated to one, please vote for the upgrade proposal via

Expand All @@ -22,7 +22,7 @@ axelard tx gov vote 164 yes --from validator
</Callout>


2. Wait for the proposed upgrade block, `16665600`. Your node will panic at that block height with a log: `{"level":"error","module":"consensus","err":"UPGRADE \"v1.1.2\" NEEDED at height: ",`. Stop your node after chain halt.
2. Wait for the proposed upgrade block, `16665600`. Your node will panic at that block height with a log: `{"level":"error","module":"consensus","err":"UPGRADE \"v1.1.2\" NEEDED at height: 16665600",`. Stop your node after chain halt.

```bash
pkill -f 'axelard start'
Expand Down
8 changes: 8 additions & 0 deletions src/layouts/navigation.ts
Original file line number Diff line number Diff line change
Expand Up @@ -634,6 +634,10 @@ export const getNavigation = (section) => {
{
title: "Mainnet axelard",
children: [
{
title: "v1.1",
href: "/resources/mainnet/upgrades/v112/",
},
{
title: "v1.0",
href: "/resources/mainnet/upgrades/v1/",
Expand Down Expand Up @@ -699,6 +703,10 @@ export const getNavigation = (section) => {
{
title: "Testnet axelard",
children: [
{
title: "v1.1",
href: "/resources/testnet/upgrades/v112/",
},
{
title: "v1.0",
href: "/resources/testnet/upgrades/v1/",
Expand Down
4 changes: 3 additions & 1 deletion src/upgrade-path.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,4 +22,6 @@ layout: /src/layouts/None.astro
| [v0.33.2](/resources/mainnet/upgrades/v33/) | 6895400 | 9151750 |
| [v0.34.3](/resources/mainnet/upgrades/v34/) | 9151750 | 11795700 |
| [v0.35.5](/resources/mainnet/upgrades/v35/) | 11795700 | 14231100 |
| [v1.0.5](/resources/mainnet/upgrades/v31/) | 14231100 | N/A |
| [v1.0.5](/resources/mainnet/upgrades/v31/) | 14231100 | 15890800 |
| [v1.1.2](/resources/mainnet/upgrades/v112/) | 15890800 | N/A |

0 comments on commit 278ed4e

Please sign in to comment.