2.0 Migration Plan

Main testing goal: to verify the operation of the blockchain under real-network conditions and to check the ability to correctly upgrade this network from v1.0.4 to v2.0.0, as well as the stability of subsequent operation.

Action Plan

1. Launch the current devnet build on 30+ nodes. The nodes must become validators. Check network stability under various load scenarios and partial node shutdowns ( 1–4 days after launch).

2. Launch a maximally close copy of the mainnet on 30+ nodes. A genesis based on the mainnet will be prepared (accounts will be preserved, but validators removed). Launch the network, allow it to produce a sufficient block volume, then perform an upgrade to v2.0.0. Test the network for as long as needed (various contract execution scenarios, calling capabilities, using feegrant, authz, etc.).

3. After the checks are completed, if everything works stably — prepare and launch the mainnet (upgrade the blockchain to v2, update the production version of the explorer and block indexer).

4. Launch the required swap contracts and services, deploy the production version of Axiome Swap and the basic version of Pump (cw20 creation).

---

1. Launching Distributed Blockchain Testing

Connect to the devnet using the instruction

Join the Devnet

and actual node build:

https://axiome.fra1.cdn.digitaloceanspaces.com/axmd/axmd-v2-0-0-alphaaxiome.fra1.cdn.digitaloceanspaces.com

To speed up the process, you can use a preprocessed blocks archive:

# Set DAEMON_HOME (usually ~/.axmd)
DAEMON_HOME="/home/axm/.axmd"

# Download block archives
curl -O https://devnet.lon1.digitaloceanspaces.com/blocks/data-20251202.tar.bz2aa
curl -O https://devnet.lon1.digitaloceanspaces.com/blocks/data-20251202.tar.bz2ab
curl -O https://devnet.lon1.digitaloceanspaces.com/blocks/data-20251202.tar.bz2ac

# Download WASM archive
curl -O https://devnet.lon1.digitaloceanspaces.com/blocks/wasm.tar.bz2

# Unpack blocks into $DAEMON_HOME
cat data-20251202.tar.bz2* | bunzip2 | tar -x -C "$DAEMON_HOME"

# Unpack WASM into $DAEMON_HOME
bunzip2 -c wasm.tar.bz2 | tar -x -C "$DAEMON_HOME"

Request 25,000 AXM from the faucet (the faucet amount will be increased for the testing period).

Wait for your node to synchronize and launch your validator.

# if catching_up false - node synced and ready to become validator
axmd status --output text | grep catching_up
# or you can use jq (apt install jq) to parse json responses
axmd status --output json | jq .sync_info

Your account must be registered in the x/referral module to delegate and start validation (you can send 1 AXM to another validator using the mobile app or send a register-referral tx from the axm node CLI).

# you can use devnet test account axm1v6xdm93m5s9lvu0ux4k76s2p7hgkzj00u8w5z7 as referrer-address
axmd tx referral register-referral [referrer-address] --from <your-key>

During this time, bots will generate background load by trading tokens on SWAP. The Axiome team will monitor the blockchain.

You can set the default chain ID for all commands with the following command:

axmd config set client chain-id demo

After launching, send the validator name to the Telegram validator group (if you are not in it, contact @axm_node_support).

2. Launch a copy of the mainnet

Since this chain is intended for upgrade testing, there is no block explorer or any other GUI available at the moment.

You need to stop the currently running devnet node and reset its state.

## Stop the Axiome node
## (This command may differ depending on your installation method)
systemctl stop axmd
## Reset node state
## (Replace axmd with your binary name if needed)
axmd comet unsafe-reset-all

Download the updated mainnet state (genesis)

https://devnet.lon1.digitaloceanspaces.com/dev-2/genesis.jsondevnet.lon1.digitaloceanspaces.com

curl -L "https://devnet.lon1.digitaloceanspaces.com/dev-2/genesis.json" \
     -o "<path-to-your-genesis.json>"

Download the Axiome Chain v1.0.4 binary

https://github.com/axiome-pro/axm-node/releases/download/v1.0.4/axmd-linux-amd64-1.0.4github.com

curl -L "https://github.com/axiome-pro/axm-node/releases/download/v1.0.4/axmd-linux-amd64-1.0.4" \
     -o "axmd104"
chmod 755 axmd104

Update persistent_peers in your config.toml

persistent_peers="[email protected]:26656"

Start the new binary using the appropriate method for your installation.

Node verification and initial setup

Check if the node is synced

axmd status --output text | grep catching_up

Create a new key

axmd key add my-test-key

Request test tokens

Ask for tokens in the Validators Telegram group.

Check your balance

axmd q bank balances $(axmd keys show my-test-key -a)

Register in the referral module under the Axiome account

axmd tx referral register-referral axm1ytal6q2qc3rkha3x24m4ynh9nvzmpkm8lucq00 \
   --from my-test-key --chain-id axiome-dev-2 \
   --gas auto --gas-prices 1.5uaxm --gas-adjustment=1.4

Check if registration was successful

axmd q referral get $(axmd keys show my-test-key -a)

Upgrade is scheduled at block height 125,000.

The updated binary is available here: https://devnet.lon1.digitaloceanspaces.com/axmd-linux-200

When the consensus error "UPGRADE NEEDED" appears, stop the node and restart it using the new binary.

Further instructions will be added to this document as the stages progress.

Some Useful Commands

Node Status

Check whether the node is fully synced:

axmd status --output text | grep catching_up

Show full node status:

axmd status

Show the latest block:

axmd status --output text | grep latest_block_height

Balances and Tokens

Check account balance:

axmd q bank balances <address>

Send tokens:

axmd tx bank send <from> <to> <amount> \
     --gas auto --gas-prices 1.5uaxm --gas-adjustment=1.4 --chain-id axiome-dev-2

Validator Queries

List all validators:

axmd q staking validators

List all non-jailed validators:

axmd q staking validators --output json \
  | jq '.validators[] | select(.jailed != true)'

Search for a validator by moniker (case-insensitive):

axmd q staking validators --output json \
  | jq '.validators[] | select(.description.moniker | test("<MONIKER>"; "i"))'

Show information about your validator:

axmd q staking validator <valoper-address>

Delegation and Staking

Delegate tokens to a validator:

axmd tx staking delegate <valoper-address> <amount> \
  --from <key> --chain-id axiome-dev-2 --fees 5000uaxm

Undelegate tokens:

axmd tx staking undelegate <valoper-address> <amount> \
  --from <key> --chain-id axiome-dev-2 --fees 5000uaxm

Redelegate stake:

axmd tx staking redelegate <src-valoper> <dst-valoper> <amount> \
  --from <key> --chain-id axiome-dev-2 --fees 5000uaxm