Network Upgrade to v2.0.0

General Information

IMPORTANT!

Version v2.0.0 introduces consensus-breaking changes. The upgrade will be performed via a governance software upgrade proposal with a specified block height, after all validators have prepared the new node version.

Before the upgrade block is reached, do not restart your node.

---

What’s New in v2.0.0 (Short Overview)

• Added CosmWasm module (x/wasm)

• Added Authz and Feegrant modules

• Introduced new KV-stores: wasm, authz, feegrant

• Requires libwasmvm version 1.5

• Upgrade is performed as an in-place software upgrade

---

Upgrade Options

Choose the appropriate section depending on how your node is deployed:

• Upgrade using a custom or manually downloaded binary

• Upgrade using Cosmovisor

---

Upgrade Using a Custom or Manually Downloaded Binary

Requirements

• Node binary v2.0.0

• libwasmvm version 1.5

Download Links

• Node binary: https://github.com/axiome-pro/axm-node/releases/download/v2.0.0/axmd-linux-amd64-2.0.0

• libwasmvm v1.5: https://github.com/axiome-pro/axm-node/releases/download/v2.0.0/libwasmvm.x86_64.so

Upgrade Procedure

1. Download the new binary and place it next to the old one

2. Install libwasmvm.x86_64.so on your system

3. Wait until the network halts at the upgrade block height

4. Start the node using the new binary

Important: Do not start the new binary before the upgrade block is reached.

---

Upgrade Using Cosmovisor

Important: If you are using Cosmovisor, do not restart the node manually — Cosmovisor will handle the upgrade automatically at the upgrade height.

---

Environment Variable (Recommended)

export daemon_home=/home/axm/.axmd

Verify that the variable is set correctly:

echo $daemon_home

---

Step-by-Step Instructions

1. Create the Upgrade Directory

mkdir -p $daemon_home/cosmovisor/upgrades/v2.0.0/bin

---

2. Download the v2.0.0 Binary

curl -L -o $daemon_home/cosmovisor/upgrades/v2.0.0/bin/axmd \
https://github.com/axiome-pro/axm-node/releases/download/v2.0.0/axmd-linux-amd64-2.0.0

Set executable permissions:

chmod 755 $daemon_home/cosmovisor/upgrades/v2.0.0/bin/axmd

---

3. Install libwasmvm (Required)

sudo curl -L -o /usr/lib/libwasmvm.x86_64.so \
https://github.com/axiome-pro/axm-node/releases/download/v2.0.0/libwasmvm.x86_64.so

sudo ldconfig

---

4. Verify Versions

Check node version:

$daemon_home/cosmovisor/upgrades/v2.0.0/bin/axmd version

Expected output:

v2.0.0

Check wasmvm version:

$daemon_home/cosmovisor/upgrades/v2.0.0/bin/axmd q wasm libwasmvm-version

---

5. Fix Directory Ownership if needed

sudo chown axm:users $daemon_home/cosmovisor -R

---

After the Upgrade

Once the upgrade block height is reached:

• Cosmovisor will automatically switch to the new binary

• The node will continue running without manual intervention

• No additional actions are required from validators

Recommended checks after upgrade:

• Node logs

• Chain synchronization

• Validator participation in consensus

• RPC / gRPC responsiveness

---

Common Issues

• ❌ Missing libwasmvm → node fails to start after upgrade

• ❌ Incorrect binary version → upgrade application error

• ❌ Wrong directory permissions → Cosmovisor cannot switch binaries

---

Support

If you encounter issues during the upgrade:

• Ensure all steps were completed before the upgrade block

• Double-check binary and libwasmvm versions

• Contact the core team or validator support channels