驗證者文檔

1. 節點安裝

配置要求
  • Ubuntu 22.04+
  • Go 1.24.2+
  • 8 CPU / 32 GB RAM / 1 TB SSD
透過 Docker 安裝 PAXI 節點
curl -sL https://raw.githubusercontent.com/paxi-web3/paxi/main/scripts/docker_install.sh | bash
啟動
docker run -d --name paxi-node-1 --restart unless-stopped \
  -v "$HOME/paxid/paxi:/root/paxi" \
  --network=host \
  paxi-node \
  ./paxid start
查看日誌
docker logs paxi-node-1 -n 10 -f
工具箱容器
# 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>
停止
docker stop paxi-node-1
移除
docker rm paxi-node-1

2. 成為驗證者

重要：請先為您的錢包充值，確保有足夠的 $DENOM 以涵蓋：最低自委託金額（例如 1000000upaxi 或更多）、交易手續費（例如 10000upaxi）以及一定的緩衝額。

檢查餘額：paxid query bank balances <您的錢包地址>

注意：
1. 請務必備份 paxi/config 目錄下的 priv_validator_key.json 和 node_key.json，並妥善記錄錢包助記詞；這是磁碟故障後唯一的恢復方式，否則可能導致整個區塊鏈網路停擺。
2. 必須定期檢查節點簽名表現：若連續在 100 個區塊中簽名少於 10 次，將被扣除部分質押代幣作為懲罰。
3. 驗證人請加入官方 X 或 Discord 社群，關注最新公告、升級及網路狀態，以便及時響應。

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

3. 下載 genesis.json

取得最新的 genesis.json：

Download genesis.json

4. Persistent Peers 列表

貼到 ~/.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. 合約部署包

在啟動 Paxi 節點（paxid start）後，請務必再次執行 WASM 合約同步腳本。若不執行，可能會因缺少 WASM 檔案導致共識失敗，進而造成您的驗證者被罰（扣除部分質押金）。

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

6. 解除監禁驗證者

如果您的驗證者因懲罰被監禁，請運行以下命令解除監禁：

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