Join the Devnet

The Devnet is a public development network designed for testing new features, experimenting with smart contracts, and onboarding validators or developers — all without risking real assets.

It closely mirrors the mainnet environment, but with shorter block times, more relaxed parameters, and easier access to tokens for testing.

Use the Devnet to:

  • Deploy and test CosmWasm smart contracts

  • Interact with on-chain modules in a safe sandbox

  • Validate node configuration before mainnet launch

  • Report bugs and help improve the Axiome Chain

Whether you're a developer, validator, or just curious, Devnet is the ideal place to get started.

How to Run a Devnet Node

Follow these steps to set up and run a node connected to the Axiome Devnet.

1. Download the Devnet Build

Download the latest version of the Devnet node binary from links below.

Linux x86_64:

You also need to download the libwasmvm shared library, which is required for CosmWasm support.

⚠️ Make sure to place libwasmvm.x86_64.so in a location accessible by your system (e.g., /usr/lib/ or /usr/local/lib/), and run ldconfig if necessary.


2. Get the Genesis File

Download the current genesis.json file from the provided link.

And place it in your node’s configuration directory, usually located at:

~/.axmd/config/genesis.json

3. Configure the Node

Open your config.toml file (typically located at ~/.axmd/config/config.toml) and set the following:

  • Persistent peers – a list of stable nodes to connect with.

  • RPC / P2P ports – ensure they don’t conflict with other services.

Currently our devnet peer is:

persistent_peers = "[email protected]:26656"

4. Start the Node

Run the node using the downloaded binary:

./axmd start

If everything is configured correctly, your node should sync with the Devnet.


(Optional) Create a systemd Service

To run your node as a background service and start it automatically on boot, you can create a systemd unit file:

sudo nano /etc/systemd/system/axmd.service

Paste the following (update paths as needed):

[Unit]
Description=Axmd+Wasm service
After=multi-user.target
StartLimitIntervalSec=0

[Install]
WantedBy=multi-user.target

[Service]
WorkingDirectory=<your-node-path>
Environment="DAEMON_HOME=<your-daemon-home>"
Environment="DAEMON_NAME=axmd"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=true"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
Environment="DAEMON_DATA_BACKUP_DIR=/mnt/axm"
Environment="UNSAFE_SKIP_BACKUP=true"
Type=simple
Restart=always
RestartSec=60
User=root
LimitNOFILE=262144
ExecStart=<your-node-path>/axmd start
StandardOutput=append:/var/log/axmd-wasm.log
StandardError=append:/var/log/axmd-wasm.log

Then enable and start the service:

sudo systemctl daemon-reexec
sudo systemctl enable axmd
sudo systemctl start axmd

Last updated