Validators Documentation

1. Node Installation

Prerequisites

Ubuntu 22.04+
Go 1.24.2+
8 CPU / 32 GB RAM / 1 TB SSD

Install the PAXI Node via Docker

curl -sL https://raw.githubusercontent.com/paxi-web3/paxi/main/scripts/docker_install.sh | bash

Start

docker run -d --name paxi-node-1 --restart unless-stopped \
  -v "$HOME/paxid/paxi:/root/paxi" \
  --network=host \
  paxi-node \
  ./paxid start

Show Logs

docker logs paxi-node-1 -n 10 -f

Toolbox Container

# Enter toolbox
docker run --rm -it --network host \
  -v "$HOME/paxid/paxi:/root/paxi" \
  paxi-node bash

# Show key
./paxid keys show <your address or key name>

# Import key from seed phrase
./paxid keys add <your key name> --recover

# Test query
./paxid query bank balances <your address or key name>

Stop

docker stop paxi-node-1

Remove

docker rm paxi-node-1

2. Become a Validator

IMPORTANT: Fund your wallet FIRST. Ensure you have enough $DENOM to cover min‑self‑delegation (e.g., 1000000upaxi or more), transaction fee (e.g., 10000upaxi), and a safety buffer.

Check balance: paxid query bank balances <your_wallet_address>

NOTE:
1. Always back up your priv_validator_key.json and node_key.json in the paxi/config directory and record your wallet mnemonic—these are the only way to recover your node after a disk failure; failure to do so may halt the entire blockchain.
2. Regularly monitor your signing performance: if you sign fewer than 10 out of any 100 blocks, you will be slashed.
3. Join the official X (Twitter) or Discord channels to stay updated on announcements, upgrades, and network health so you can respond promptly.

./paxid tx staking create-validator "/root/paxi/validator.json" \
  --from <your_wallet_name_or_address> \
  --fees 10000upaxi \
  --gas auto

3. Download genesis.json

Get the latest genesis.json:

Download genesis.json

4. Persistent Peers List

Paste into ~/.paxi/config/config.toml → p2p.persistent_peers

d411fc096e0d946bbd2bdea34f0f9da928c1a714@139.99.68.32:26656,7299b10c0a1545f50c1911b188c579a5e8c5072f@139.99.68.235:26656,509b20ca82d34d0aae1751a681ee386659fb71da@66.70.181.55:26656,57b44498315f013558e342827f352db790d5d90c@142.44.142.121:26656,a325cced9b360c0e5fcbf756e0b1ca139b8f2eef@51.75.54.185:26656,9e64baa45042ae29d999f2677084c9579972722c@139.99.69.74:26656

5. Contracts Deployment Pack

After starting the Paxi node (paxid start), make sure to run the WASM contract synchronization script again. Failing to do so may cause consensus failures due to missing WASM files, which can result in your validator being slashed (i.e., a portion of your stake may be deducted).

curl -sL https://raw.githubusercontent.com/paxi-web3/paxi/main/scripts/sync_wasm.sh | bash

6. Unjail Validator

If your validator is jailed due to slashing, run the following command to unjail:

./paxid tx slashing unjail \
  --from <your_wallet_name> \
  --chain-id <chain_id> \
  --fees 10000upaxi \
  --gas auto

Docs Menu