⚛️ AtomOne Testnet Full Node & Validator Setup Guide

A complete guide to running an AtomOne testnet full node and registering as a validator
System preparation, binary installation, Cosmovisor setup, snapshot sync, and validator creation — step by step.

hazennetworksolutions.com

Author: HazenNetworkSolutions
Network: AtomOne Testnet (Chain ID: atomone-testnet-1)
Version: v4.0.0
Last Updated: May 2026

Hardware Requirements
Step 1 — System Verification
Step 2 — System Update and Dependencies
Step 3 — Install Go
Step 4 — Download and Build Binary
Step 5 — Install Cosmovisor
Step 6 — Create Systemd Service
Step 7 — Initialize the Node
Step 8 — Download Genesis and Addrbook
Step 9 — Configure Ports, Gas Prices and Pruning
Step 10 — Configure Seeds and Peers
Step 11 — Start the Node
Step 12 — Create a Wallet
Step 13 — Register as a Validator
Monitoring the Node
Useful Commands
Staying Updated

Hardware Requirements

Component	Minimum	Recommended
Operating System	Ubuntu 22.04+	Ubuntu 24.04
CPU	4 cores	8 cores
RAM	16 GB	32 GB
Disk	500 GB NVMe SSD	2 TB NVMe SSD
Network	100 Mbps	1 Gbps

⚠️ Disk usage grows over time. Plan for long-term storage growth if running an archival node.

Step 1 — System Verification

After SSH-ing into your server, verify the system meets requirements:

lsb_release -a          # Should be Ubuntu 22.04 or higher
uname -r                # Kernel version
lscpu | grep -E "Model name|CPU\(s\)|Thread|Socket|Core"
free -h                 # Minimum 16 GB RAM
df -h                   # Minimum 500 GB free disk

Step 2 — System Update and Dependencies

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git wget htop tmux build-essential jq make lz4 gcc unzip

Step 3 — Install Go

AtomOne v4.0.0 requires Go 1.22+:

cd $HOME
VER="1.22.10"
wget "https://golang.org/dl/go$VER.linux-amd64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$VER.linux-amd64.tar.gz"
rm "go$VER.linux-amd64.tar.gz"

echo "export PATH=\$PATH:/usr/local/go/bin:\$HOME/go/bin" >> $HOME/.bash_profile
source $HOME/.bash_profile
[ ! -d ~/go/bin ] && mkdir -p ~/go/bin

Verify the installation:

go version

Expected output: go version go1.22.10 linux/amd64

Step 4 — Download and Build Binary

cd $HOME
rm -rf atomone
git clone https://github.com/atomone-hub/atomone
cd atomone
git checkout v4.0.0
make build

mkdir -p $HOME/.atomone/cosmovisor/genesis/bin
mv build/atomoned $HOME/.atomone/cosmovisor/genesis/bin/
rm -rf build

ln -s $HOME/.atomone/cosmovisor/genesis $HOME/.atomone/cosmovisor/current -f
sudo ln -s $HOME/.atomone/cosmovisor/current/bin/atomoned /usr/local/bin/atomoned -f

Verify:

atomoned version

Expected output: v4.0.0

Alternatively, download the pre-built binary directly:

wget -O atomoned https://github.com/atomone-hub/atomone/releases/download/v4.0.0/atomoned-v4.0.0-linux-amd64
chmod +x atomoned
mkdir -p $HOME/.atomone/cosmovisor/genesis/bin
mv atomoned $HOME/.atomone/cosmovisor/genesis/bin/
ln -s $HOME/.atomone/cosmovisor/genesis $HOME/.atomone/cosmovisor/current -f
sudo ln -s $HOME/.atomone/cosmovisor/current/bin/atomoned /usr/local/bin/atomoned -f

Step 5 — Install Cosmovisor

Cosmovisor handles automatic binary upgrades:

go install cosmossdk.io/tools/cosmovisor/cmd/[email protected]

Verify:

cosmovisor version

Step 6 — Create Systemd Service

Set your moniker and port prefix before creating the service:

MONIKER="YOUR_MONIKER"
PORT="26"   # Default is 26. Change to avoid conflicts (e.g. 27, 28...)

Create the service file:

sudo tee /etc/systemd/system/atomoned.service > /dev/null << EOF
[Unit]
Description=AtomOne Node Service
After=network-online.target

[Service]
User=$USER
ExecStart=$(which cosmovisor) run start --home $HOME/.atomone
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="DAEMON_HOME=$HOME/.atomone"
Environment="DAEMON_NAME=atomoned"
Environment="UNSAFE_SKIP_BACKUP=true"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:$HOME/.atomone/cosmovisor/current/bin"

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable atomoned

Step 7 — Initialize the Node

atomoned config set client chain-id atomone-testnet-1
atomoned config set client keyring-backend os
atomoned config set client node tcp://localhost:${PORT}657

atomoned init $MONIKER --chain-id atomone-testnet-1

Set environment variables permanently:

echo "export MONIKER=$MONIKER" >> $HOME/.bash_profile
echo "export ATOMONE_CHAIN_ID=\"atomone-testnet-1\"" >> $HOME/.bash_profile
echo "export ATOMONE_PORT=$PORT" >> $HOME/.bash_profile
source $HOME/.bash_profile

Step 8 — Download Genesis and Addrbook

wget -O $HOME/.atomone/config/genesis.json \
  https://atomone.fra1.digitaloceanspaces.com/atomone-testnet-1/genesis.json

wget -O $HOME/.atomone/config/addrbook.json \
  https://raw.githubusercontent.com/hazennetworksolutions/atomone-testnet/refs/heads/main/addrbook.json

Verify genesis checksum:

sha256sum $HOME/.atomone/config/genesis.json

Step 9 — Configure Ports, Gas Prices and Pruning

Custom Ports

If you changed the default port prefix, apply it here:

sed -i.bak -e "s%:1317%:${ATOMONE_PORT}317%g;
s%:8080%:${ATOMONE_PORT}080%g;
s%:9090%:${ATOMONE_PORT}090%g;
s%:9091%:${ATOMONE_PORT}091%g" $HOME/.atomone/config/app.toml

sed -i.bak -e "s%:26658%:${ATOMONE_PORT}658%g;
s%:26657%:${ATOMONE_PORT}657%g;
s%:6060%:${ATOMONE_PORT}060%g;
s%:26656%:${ATOMONE_PORT}656%g;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${ATOMONE_PORT}656\"%;
s%:26660%:${ATOMONE_PORT}660%g" $HOME/.atomone/config/config.toml

Gas Prices

sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0.025uatone,0.025uphoton"|g' \
  $HOME/.atomone/config/app.toml

Pruning

sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.atomone/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.atomone/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"19\"/" $HOME/.atomone/config/app.toml

Enable Prometheus (optional)

sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.atomone/config/config.toml

Disable Indexer (saves disk space)

sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.atomone/config/config.toml

Step 10 — Configure Seeds and Peers

SEEDS="85e441cfe74b8c0f8b820beff46edab20e92716c@atomone-testnet-seed.itrocket.net:62657"
PEERS="bddf062a8328bcc50e37f83448e770e2e385c72f@atomone-testnet-peer.itrocket.net:62656,[email protected]:62656,[email protected]:19656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656"

sed -i -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*seeds *=.*/seeds = \"$SEEDS\"/}" \
       -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*persistent_peers *=.*/persistent_peers = \"$PEERS\"/}" \
       $HOME/.atomone/config/config.toml

Step 11 — Start the Node

sudo systemctl start atomoned
sudo journalctl -u atomoned -f --no-pager -o cat

Verify all services are running:

sudo systemctl status atomoned --no-pager

The service should show active (running).

Check sync status:

atomoned status 2>&1 | jq .SyncInfo

Wait until catching_up is false before proceeding to validator registration.

Step 12 — Create a Wallet

atomoned keys add wallet

⚠️ CRITICAL: Save your mnemonic phrase in a secure location. Without it, you cannot recover your wallet.

To recover an existing wallet:

atomoned keys add wallet --recover

Check your balance (after receiving testnet tokens):

atomoned query bank balances $(atomoned keys show wallet -a)

Step 13 — Register as a Validator

The node must be fully synced before creating a validator.

Get your pubkey:

atomoned comet show-validator

Create validator JSON:

cat > $HOME/validator.json << EOF
{
  "pubkey": $(atomoned comet show-validator),
  "amount": "1000000uatone",
  "moniker": "YOUR_MONIKER",
  "identity": "",
  "website": "",
  "security": "",
  "details": "",
  "commission-rate": "0.05",
  "commission-max-rate": "0.20",
  "commission-max-change-rate": "0.01",
  "min-self-delegation": "1"
}
EOF

Submit the transaction:

atomoned tx staking create-validator $HOME/validator.json \
  --from wallet \
  --chain-id atomone-testnet-1 \
  --gas auto \
  --gas-adjustment 1.4 \
  --fees 500uatone \
  -y

Verify your validator:

atomoned query staking validator $(atomoned keys show wallet --bech val -a)

Monitoring the Node

Watch live block commits:

sudo journalctl -u atomoned -f --no-pager | grep "committed block"

Expected output:

INF committed state app_hash=... height=XXXXXX

Full logs:

sudo journalctl -u atomoned -f --no-pager

Sync status:

atomoned status 2>&1 | jq .SyncInfo

Service management:

# Restart service
sudo systemctl restart atomoned

# Stop service
sudo systemctl stop atomoned

# Check status
sudo systemctl status atomoned

Useful Commands

Wallet

# List wallets
atomoned keys list

# Show wallet address
atomoned keys show wallet -a

# Check balance
atomoned query bank balances $(atomoned keys show wallet -a)

Staking

# Delegate tokens
atomoned tx staking delegate $(atomoned keys show wallet --bech val -a) 1000000uatone \
  --from wallet --chain-id atomone-testnet-1 --gas auto --gas-adjustment 1.4 --fees 500uatone -y

# Redelegate tokens
atomoned tx staking redelegate $(atomoned keys show wallet --bech val -a) <NEW_VALOPER> 1000000uatone \
  --from wallet --chain-id atomone-testnet-1 --gas auto --gas-adjustment 1.4 --fees 500uatone -y

# Undelegate tokens
atomoned tx staking unbond $(atomoned keys show wallet --bech val -a) 1000000uatone \
  --from wallet --chain-id atomone-testnet-1 --gas auto --gas-adjustment 1.4 --fees 500uatone -y

Rewards

# Withdraw all rewards
atomoned tx distribution withdraw-all-rewards \
  --from wallet --chain-id atomone-testnet-1 --gas auto --gas-adjustment 1.4 --fees 500uatone -y

# Withdraw commission
atomoned tx distribution withdraw-rewards $(atomoned keys show wallet --bech val -a) --commission \
  --from wallet --chain-id atomone-testnet-1 --gas auto --gas-adjustment 1.4 --fees 500uatone -y

Governance

# List proposals
atomoned query gov proposals

# Vote on a proposal
atomoned tx gov vote 1 yes \
  --from wallet --chain-id atomone-testnet-1 --gas auto --gas-adjustment 1.4 --fees 500uatone -y

Validator Operations

# Edit validator
atomoned tx staking edit-validator \
  --new-moniker "NEW_MONIKER" \
  --identity "" \
  --from wallet --chain-id atomone-testnet-1 --gas auto --gas-adjustment 1.4 --fees 500uatone -y

# Unjail validator
atomoned tx slashing unjail \
  --from wallet --chain-id atomone-testnet-1 --gas auto --gas-adjustment 1.4 --fees 500uatone -y

# Check validator signing info
atomoned query slashing signing-info $(atomoned comet show-validator)

Staying Updated

Follow these channels to stay informed about upgrades and announcements:

Discord: AtomOne Developer Discord
GitHub Releases: atomone-hub/atomone Releases
Official Docs: docs.atom.one

Upgrade with Cosmovisor (example: v5.0.0)

mkdir -p $HOME/.atomone/cosmovisor/upgrades/v5/bin
wget -O $HOME/.atomone/cosmovisor/upgrades/v5/bin/atomoned \
  https://github.com/atomone-hub/atomone/releases/download/v5.0.0/atomoned-v5.0.0-linux-amd64
chmod +x $HOME/.atomone/cosmovisor/upgrades/v5/bin/atomoned

Cosmovisor will automatically switch to the new binary at the upgrade block height.

Guide maintained by HazenNetworkSolutions

AtomOne Testnet