Skip to content

Commit 278ed4e

Browse files
authored
feat: added v1.1.2 core upgrade docs (#1275)
1 parent 8acbd67 commit 278ed4e

File tree

4 files changed

+77
-5
lines changed

4 files changed

+77
-5
lines changed
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
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+
```

src/content/docs/resources/testnet/upgrades/v112.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Testnet upgrade: V1.1.2
1+
# Testnet upgrade: v1.1
22

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

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

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

10-
## About the V1.1.2 upgrade
11-
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.
10+
## About the v1.1 upgrade
11+
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.
1212

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

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

2424

25-
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.
25+
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.
2626

2727
```bash
2828
pkill -f 'axelard start'

src/layouts/navigation.ts

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -634,6 +634,10 @@ export const getNavigation = (section) => {
634634
{
635635
title: "Mainnet axelard",
636636
children: [
637+
{
638+
title: "v1.1",
639+
href: "/resources/mainnet/upgrades/v112/",
640+
},
637641
{
638642
title: "v1.0",
639643
href: "/resources/mainnet/upgrades/v1/",
@@ -699,6 +703,10 @@ export const getNavigation = (section) => {
699703
{
700704
title: "Testnet axelard",
701705
children: [
706+
{
707+
title: "v1.1",
708+
href: "/resources/testnet/upgrades/v112/",
709+
},
702710
{
703711
title: "v1.0",
704712
href: "/resources/testnet/upgrades/v1/",

src/upgrade-path.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,4 +22,6 @@ layout: /src/layouts/None.astro
2222
| [v0.33.2](/resources/mainnet/upgrades/v33/) | 6895400 | 9151750 |
2323
| [v0.34.3](/resources/mainnet/upgrades/v34/) | 9151750 | 11795700 |
2424
| [v0.35.5](/resources/mainnet/upgrades/v35/) | 11795700 | 14231100 |
25-
| [v1.0.5](/resources/mainnet/upgrades/v31/) | 14231100 | N/A |
25+
| [v1.0.5](/resources/mainnet/upgrades/v31/) | 14231100 | 15890800 |
26+
| [v1.1.2](/resources/mainnet/upgrades/v112/) | 15890800 | N/A |
27+

0 commit comments

Comments
 (0)