Documentation des validateurs

1. Installation du nœud

Prérequis
  • Ubuntu 22.04+
  • Go 1.24.2+
  • 8 CPU / 32 GB RAM / 1 TB SSD
Installer le nœud PAXI via Docker
curl -sL https://raw.githubusercontent.com/paxi-web3/paxi/main/scripts/docker_install.sh | bash
Démarrer
docker run -d --name paxi-node-1 --restart unless-stopped \
  -v "$HOME/paxid/paxi:/root/paxi" \
  --network=host \
  paxi-node \
  ./paxid start
Afficher les journaux
docker logs paxi-node-1 -n 10 -f
Conteneur boîte à outils
# 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>
Arrêter
docker stop paxi-node-1
Supprimer
docker rm paxi-node-1

2. Devenir validateur

IMPORTANT : Approvisionnez d’abord votre portefeuille. Assurez-vous d’avoir suffisamment de $DENOM pour couvrir la mise minimale (par ex. 1000000upaxi ou plus), les frais de transaction (par ex. 10000upaxi) et une marge de sécurité.

Vérifier le solde : paxid query bank balances <votre_adresse_portefeuille>

REMARQUE :
1. Sauvegardez toujours priv_validator_key.json et node_key.json dans le répertoire paxi/config et notez votre phrase mnémonique ; ce sont les seuls moyens de récupérer votre nœud après une panne de disque ; ne pas le faire peut arrêter la blockchain.
2. Surveillez régulièrement vos performances de signature : si vous signez moins de 10 blocs sur 100, vous serez slashed.
3. Rejoignez les canaux officiels X (Twitter) ou Discord pour rester informé des annonces, mises à jour et de la santé du réseau afin de pouvoir réagir rapidement.

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

3. Télécharger genesis.json

Obtenir le dernier genesis.json :

Download genesis.json

4. Liste des peers persistants

Coller dans ~/.paxi/config/config.toml → p2p.persistent_peers

d411fc096e0d946bbd2bdea34f0f9da928c1a714@139.99.68.32:26656,509b20ca82d34d0aae1751a681ee386659fb71da@66.70.181.55:26656,ef9a34f874e1490f1333c37f33b21c47fbbcc88c@139.99.69.74:26656

5. Pack de déploiement des contrats

Après avoir lancé le nœud Paxi (paxid start), assurez-vous de relancer le script de synchronisation des contrats WASM. Ne pas le faire peut provoquer des échecs de consensus en raison de fichiers WASM manquants, ce qui peut entraîner le slashing de votre validateur (c’est-à-dire une déduction d’une partie de votre mise).

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

6. Débloquer le validateur

Si votre validateur est mis en veille pour slashing, exécutez la commande suivante pour le débloquer :

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