X PrimeFlow

AtomOne

AtomOne
Chain ID: atomone-testnet-1
Block Height:
Network Status: Connecting
Explorer

Manual node installation

Official operator documentationProject websiteSource repository

BonyNode setup profile

Configure once โ€” generate every command

These values update the AtomOne installation, wallet, validator, sync and firewall commands below.

No seed phrases or private keys
Recommended hardware: 6 Cores, 8GB RAM, 500GB of storage (NVME)Profile is valid โ€” commands are ready

Network: Testnet

Chain ID: atomone-testnet-1

Recommended hardware: 6 Cores, 8GB RAM, 500GB of storage (NVME)

Go version: 1.20.5

Binary: atomoned

Node home: ~/.atomone

1. Prepare the node host

set -euo pipefail
sudo apt-get update
sudo apt-get install -y ca-certificates curl git jq make build-essential

GO_VERSION="1.20.5"
case "$(uname -m)" in
  x86_64) GO_ARCH="amd64" ;;
  aarch64|arm64) GO_ARCH="arm64" ;;
  *) echo "Unsupported CPU architecture: $(uname -m)" >&2; exit 1 ;;
esac

WORK_DIR=$(mktemp -d)
trap 'rm -rf "$WORK_DIR"' EXIT
GO_FILE="go1.20.5.linux-$GO_ARCH.tar.gz"
GO_META_URL="https://go.dev/dl/?mode=json&include=all"
GO_SHA256=$(curl --fail --silent --show-error --proto '=https'   --max-filesize 5242880 --max-time 30 "$GO_META_URL"   | jq -er --arg file "$GO_FILE" '.[] | .files[] | select(.filename == $file) | .sha256'   | head -n 1)
test -n "$GO_SHA256"

curl --fail --location --show-error --retry 3   --proto '=https' --proto-redir '=https'   --max-filesize 268435456 --max-time 900   "https://go.dev/dl/$GO_FILE" -o "$WORK_DIR/$GO_FILE"
printf '%s  %s\n' "$GO_SHA256" "$WORK_DIR/$GO_FILE" | sha256sum --check -
tar -tzf "$WORK_DIR/$GO_FILE" >/dev/null

if [ -d /usr/local/go ]; then
  sudo mv /usr/local/go "/usr/local/go.backup.$(date -u +%Y%m%dT%H%M%SZ)"
fi
sudo tar -C /usr/local -xzf "$WORK_DIR/$GO_FILE"
grep -qxF 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' "$HOME/.profile" 2>/dev/null   || printf '%s\n' 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> "$HOME/.profile"
export PATH="$PATH:/usr/local/go/bin:$HOME/go/bin"
mkdir -p "$HOME/go/bin"
go version | grep -F "go1.20.5"

2. Build the pinned node binary

cd $HOME 
git clone https://github.com/atomone-hub/atomone.git 
cd atomone 
git checkout v1.1.0
make install

# Verify which binary will be used before initialization.
command -v "atomoned"
"atomoned" version

3. Initialize a new node home

set -euo pipefail
BIN="atomoned"
CHAIN_ID="atomone-testnet-1"
MONIKER='validator-name'
NODE_HOME="$HOME/.atomone"

command -v "$BIN"
test ! -e "$NODE_HOME" || { echo "Stop: $NODE_HOME already exists; back it up and review it first." >&2; exit 1; }
"$BIN" init "$MONIKER" --chain-id "$CHAIN_ID" --home "$NODE_HOME"
test -f "$NODE_HOME/config/genesis.json"

4. Install and validate genesis

set -euo pipefail
CHAIN_ID="atomone-testnet-1"
NODE_HOME="$HOME/.atomone"
GENESIS_URL='https://testnet-files.bonynode.online/atomone/genesis.json'
GENESIS_DOWNLOAD="$NODE_HOME/config/genesis.json.download"

test -d "$NODE_HOME/config"
test ! -e "$GENESIS_DOWNLOAD" || { echo "Stop: review the existing $GENESIS_DOWNLOAD first." >&2; exit 1; }
curl --fail --show-error --location --proto "=https" --max-time 120   --output "$GENESIS_DOWNLOAD" "$GENESIS_URL"
jq -e --arg chain "$CHAIN_ID" '.chain_id == $chain' "$GENESIS_DOWNLOAD" >/dev/null
# No published checksum is recorded; the JSON and configured chain ID are validated before replacement.
cp --no-clobber "$NODE_HOME/config/genesis.json" "$NODE_HOME/config/genesis.json.init-backup" || true
install -m 0644 "$GENESIS_DOWNLOAD" "$NODE_HOME/config/genesis.json"
jq -r '.chain_id' "$NODE_HOME/config/genesis.json"

5. Configure client and selected RPC port

set -euo pipefail
CHAIN_ID="atomone-testnet-1"
NODE_HOME="$HOME/.atomone"
CLIENT_TOML="$NODE_HOME/config/client.toml"
LOCAL_RPC="tcp://127.0.0.1:35657"

test -f "$CLIENT_TOML"
cp --no-clobber "$CLIENT_TOML" "$CLIENT_TOML.bonynode-backup" || true
sed -i -E   -e "s|^chain-id[[:space:]]*=.*|chain-id = \"$CHAIN_ID\"|"   -e 's|^keyring-backend[[:space:]]*=.*|keyring-backend = "os"|'   -e "s|^node[[:space:]]*=.*|node = \"$LOCAL_RPC\"|"   "$CLIENT_TOML"
grep -E '^(chain-id|keyring-backend|node)[[:space:]]*=' "$CLIENT_TOML"

6. Apply ports, pruning, indexer and Prometheus settings

set -euo pipefail
NODE_HOME="$HOME/.atomone"
APP_TOML="$NODE_HOME/config/app.toml"
CONFIG_TOML="$NODE_HOME/config/config.toml"

test -f "$APP_TOML"
test -f "$CONFIG_TOML"
cp --no-clobber "$APP_TOML" "$APP_TOML.bonynode-backup" || true
cp --no-clobber "$CONFIG_TOML" "$CONFIG_TOML.bonynode-backup" || true

# Application API, gRPC and optional EVM ports.
sed -i   -e 's|:1317|:35317|g'   -e 's|:8080|:35080|g'   -e 's|:9090|:35090|g'   -e 's|:9091|:35091|g'   -e 's|:8545|:35545|g'   -e 's|:8546|:35546|g'   -e 's|:6065|:35065|g'   "$APP_TOML"

# CometBFT RPC, P2P, proxy-app, pprof and Prometheus ports.
sed -i   -e 's|:26658|:35658|g'   -e 's|:26657|:35657|g'   -e 's|:6060|:35060|g'   -e 's|:26656|:35656|g'   -e 's|:26660|:35660|g'   "$CONFIG_TOML"

sed -i -E   -e 's|^pruning[[:space:]]*=.*|pruning = "custom"|'   -e 's|^pruning-keep-recent[[:space:]]*=.*|pruning-keep-recent = "100"|'   -e 's|^pruning-keep-every[[:space:]]*=.*|pruning-keep-every = "0"|'   -e 's|^pruning-interval[[:space:]]*=.*|pruning-interval = "19"|'   "$APP_TOML"
sed -i -E 's|^indexer[[:space:]]*=.*|indexer = "null"|' "$CONFIG_TOML"
sed -i -E 's|^prometheus[[:space:]]*=.*|prometheus = true|' "$CONFIG_TOML"

grep -E '^(pruning|pruning-keep-recent|pruning-interval)[[:space:]]*=' "$APP_TOML"
grep -E '^(indexer|prometheus)[[:space:]]*=' "$CONFIG_TOML"
printf 'RPC=%s P2P=%s API=%s gRPC=%s Prometheus=%s\n'   '35657' '35656' '35317'   '35090' '35660'

7. Configure minimum gas prices

set -euo pipefail
APP_TOML="$HOME/.atomone/config/app.toml"
test -f "$APP_TOML"
cp --no-clobber "$APP_TOML" "$APP_TOML.bonynode-backup" || true

if grep -q '^minimum-gas-prices' "$APP_TOML"; then
  sed -i 's|^minimum-gas-prices *=.*|minimum-gas-prices = "7500uatone"|' "$APP_TOML"
else
  printf '
minimum-gas-prices = "7500uatone"
' >> "$APP_TOML"
fi
grep '^minimum-gas-prices' "$APP_TOML"

Node sync checker

Compare the selected local RPC height with the chain-verified BonyNode reference. Stop with Ctrl+C.

#!/usr/bin/env bash
set -euo pipefail

CHAIN_ID="atomone-testnet-1"
LOCAL_RPC="http://127.0.0.1:35657"
REFERENCE_RPC="https://atomone-testnet-rpc.bonynode.online"

read_height() {
  local endpoint="$1"
  curl --fail --silent --show-error --max-time 10 "$endpoint/status"     | jq -er --arg chain "$CHAIN_ID" '
        select(.result.node_info.network == $chain)
        | .result.sync_info.latest_block_height
        | select(test("^[0-9]+$"))
      '
}

while true; do
  if LOCAL_HEIGHT=$(read_height "$LOCAL_RPC") && NETWORK_HEIGHT=$(read_height "$REFERENCE_RPC"); then
    BLOCKS_LEFT=$((NETWORK_HEIGHT - LOCAL_HEIGHT))
    [ "$BLOCKS_LEFT" -ge 0 ] || BLOCKS_LEFT=0
    printf 'Local: %s | Network: %s | Blocks left: %s\n'       "$LOCAL_HEIGHT" "$NETWORK_HEIGHT" "$BLOCKS_LEFT"
  else
    printf 'Unable to validate one of the chain-ID checked RPC heights; retrying...\n' >&2
  fi
  sleep 5
done
Snapshot and fast sync

Open the live snapshot tool for current metadata, checksum validation and rollback-safe restore commands.

Open snapshot tool

Automatic installer

Create or restore wallet

set -euo pipefail
BIN="atomoned"
WALLET='wallet'
[[ "$WALLET" =~ ^[a-zA-Z0-9_-]{1,64}$ ]] || { echo "Invalid wallet name" >&2; exit 1; }

# Create a new key. Store the mnemonic offline; it cannot be recovered by BonyNode.
"$BIN" keys add "$WALLET"

# To restore an existing key, run this separately:
# "$BIN" keys add "$WALLET" --recover

WALLET_ADDRESS=$("$BIN" keys show "$WALLET" -a)
"$BIN" query bank balances "$WALLET_ADDRESS"

Create validator

BIN="atomoned"
CHAIN_ID="atomone-testnet-1"
WALLET='wallet'
MONIKER='validator-name'
IDENTITY=''
WEBSITE=''
DETAILS='Independent validator'
AMOUNT="1000000uatone"
MIN_SELF_DELEGATION="1"
COMMISSION_RATE="0.10"
COMMISSION_MAX_RATE="0.20"
COMMISSION_MAX_CHANGE="0.01"

"$BIN" tx staking create-validator   --amount "$AMOUNT"   --from "$WALLET"   --commission-rate "$COMMISSION_RATE"   --commission-max-rate "$COMMISSION_MAX_RATE"   --commission-max-change-rate "$COMMISSION_MAX_CHANGE"   --min-self-delegation "$MIN_SELF_DELEGATION"   --pubkey "$("$BIN" tendermint show-validator)"   --moniker "$MONIKER"   --identity "$IDENTITY"   --website "$WEBSITE"   --details "$DETAILS"   --chain-id "$CHAIN_ID"   --gas 300000 --fees 7500uatone   -y

Basic host firewall

set -euo pipefail

P2P_PORT="35656"
sudo ufw default allow outgoing
sudo ufw default deny incoming
sudo ufw allow OpenSSH
sudo ufw allow "$P2P_PORT/tcp"
sudo ufw enable
sudo ufw status verbose

# RPC/API/gRPC remain private unless you deliberately add authenticated
# reverse-proxy rules. Never expose validator signing services publicly.

Reversible decommission

This procedure stops and disables the service but retains the node home, binary and service file. Verify the backup before any later deletion.

set -euo pipefail

SERVICE="atomoned"
NODE_HOME="$HOME/.atomone"
STAMP=$(date -u +%Y%m%dT%H%M%SZ)
RETIRED_HOME="$NODE_HOME.retired.$STAMP"
KEY_BACKUP="$HOME/atomoned-validator-keys-$STAMP.tar.gz"
NODE_STOPPED=0

rollback() {
  trap - ERR INT TERM
  if [ "$NODE_STOPPED" -eq 1 ]; then sudo systemctl start "$SERVICE" || true; fi
  exit 1
}
trap rollback ERR INT TERM

test -d "$NODE_HOME"
test ! -e "$RETIRED_HOME"
test -s "$NODE_HOME/config/priv_validator_key.json"
test -s "$NODE_HOME/data/priv_validator_state.json"
sudo systemctl stop "$SERVICE"
NODE_STOPPED=1

# Back up validator identity/state before moving anything.
tar -czf "$KEY_BACKUP" -C "$NODE_HOME"   config/priv_validator_key.json config/node_key.json data/priv_validator_state.json
test -s "$KEY_BACKUP"
mv "$NODE_HOME" "$RETIRED_HOME"
sudo systemctl disable "$SERVICE"
NODE_STOPPED=0
trap - ERR INT TERM

echo "Node home was retained at: $RETIRED_HOME"
echo "Critical key backup: $KEY_BACKUP"
echo "No binary, service file or node data was deleted."