Guide de mise en route

Installation complète à partir des paquets pré-compilés : nœud, wallet, interface web et minage — sur Ubuntu 24 (ou compatible). En vitesse ? Le guide ultra-rapide (wallet GUI) suffit.

🖥️ Vous utilisez le wallet GUI (Windows / macOS / Linux) ? Ce guide ne vous concerne PAS. La version GUI inclut tout — nœud, wallet, interface — et n'a besoin d'aucun des paquets « console » décrits ici. Suivez simplement le guide ultra-rapide. Le présent guide s'adresse uniquement à ceux qui installent un nœud en ligne de commande (serveur ou Linux sans interface graphique) à partir des paquets pré-compilés.

⚠️ Une seule « banque » par réseau local (LAN). Sur un même réseau, un seul nœud ou wallet GUI peut tourner : les autres ne pourront pas se synchroniser. Ce n'est pas une limitation gênante — un seul nœud (ou un seul wallet GUI, qui contient le nœud) suffit : toutes les machines du LAN minent sur celui-là. Détails à la section « Plusieurs machines (LAN) » en bas de page.

0.Télécharger le paquet pour votre machine

Ouvrez la section Téléchargements du site.
Choisissez le paquet adapté à votre processeur :
- lscpu | grep -o avx512f → si ça répond avx512f : paquet AVX-512
- sinon : paquet AVX2 (zen1 — le plus compatible)

En ligne de commande (au lieu du navigateur) :

wget https://privbank.finance/fichiers/pbc_node_avx2_zen1.tar.gz

Puis :

tar xzf pbc_node_*.tar.gz
cd pbc_node

Le paquet contient : bin/ (nœud + wallets + interface web), web/ (interface), miner/ (mineur CPU).

1.Lancer votre nœud

cd pbc_node
screen -dmS node ./bin/pbcd --log-file $PWD/pbcd.log

⚠️ Plusieurs machines sur le même réseau (LAN) ? Une seule machine du réseau doit faire tourner un nœud (ou un wallet GUI), et elle doit le lancer avec le bind externe — voir la section « Plusieurs machines (LAN) » plus bas.

Votre nœud se connecte automatiquement aux seeds du réseau. Pour vérifier qu'il tourne et synchronise :

curl -s http://127.0.0.1:18831/get_info | grep -E '"height"|connections'

(screen -r node pour voir la console ; Ctrl+A puis D pour en sortir.)

2.Créer votre wallet

./bin/pbc-wallet-cli --generate-new-wallet ~/monwallet

Choisissez un mot de passe de wallet.
NOTEZ IMPÉRATIVEMENT la phrase de récupération (25 mots) affichée — c'est la seule sauvegarde de vos fonds.
Notez votre adresse qui commence par Pbc… (commande address dans le wallet).
Tapez exit pour quitter (le wallet est sauvegardé dans ~/monwallet et ~/monwallet.keys).

3.Lancer le wallet-RPC

screen -dmS wallet-rpc ./bin/pbc-wallet-rpc \
  --daemon-address 127.0.0.1:18831 \
  --wallet-file ~/monwallet \
  --password "VOTRE_MDP_WALLET" \
  --rpc-bind-port 18083 \
  --disable-rpc-login \
  --log-file /tmp/pbc-wallet-rpc.log

⚠️ Remplacez VOTRE_MDP_WALLET par le mot de passe choisi à l'étape 2. Si vous laissez le texte d'exemple, le wallet-RPC plante immédiatement avec invalid password — vérifiez avec tail -3 /tmp/pbc-wallet-rpc.log que le démarrage est bon.

4.Lancer l'interface web du wallet

screen -dmS webui ./bin/pbc-webui \
  --rpc-port 18083 \
  --web-dir $PWD/web \
  --wallet-log /tmp/pbc-wallet-rpc.log

5.Ouvrir votre banque privée dans le navigateur

http://<IP-de-votre-machine>:8880

(Depuis la machine elle-même : http://127.0.0.1:8880.)

Vous y trouverez : tableau de bord, dépôts à terme (30 j à 365 j), récompenses à réclamer (CLAIM), marché obligataire, héritage, et le relevé bancaire (Bank Statement).

6.Miner

Éditez miner/config.json et mettez votre adresse (étape 2) à la place de YOUR_PBC_ADDRESS_HERE :
```
"user": "PbcVotreAdresseIci"
```
Lancez le mineur avec sudo (recommandé — bien meilleures performances : huge pages + optimisation MSR du CPU, qui exigent les droits root) :
```
sudo screen -dmS miner ./miner/pbcminer --config miner/config.json -t $(($(nproc) - 2))
```
Recommandation : tous les threads moins 2 (garde la machine fluide). Le paramètre -t choisit le nombre de threads — mettez la valeur que vous voulez, ex. -t 8.

Sans sudo, le mineur fonctionne quand même (screen -dmS miner ./miner/pbcminer --config miner/config.json) mais avec des performances réduites.

Le mineur travaille contre votre propre nœud (minage solo, algo RandomX V2 rx/pbc, CPU uniquement).

⏳ Normal : vos récompenses de minage arrivent en 4 parts bloquées qui se débloquent à ~24 h / ~30 j / ~60 j / ~90 j (vesting intégré au protocole). Votre solde débloqué montera progressivement.
💡 Astuce : une fois vos premières récompenses débloquées, placez-les en dépôt à terme depuis l'interface web pour générer du rendement — c'est le cœur de PBC.

Plusieurs machines sur le même réseau (LAN)

⚠️ Règle d'or : un seul nœud — ou un seul wallet GUI — par réseau local. Si vous en lancez plusieurs, les suivants ne pourront pas se synchroniser. Et de toute façon un seul suffit : le wallet GUI contient le nœud, et toutes les autres machines du LAN mineront sur lui en solo.

Sur la machine « banque » (celle qui héberge le nœud ou le wallet GUI), le nœud doit accepter les mineurs du réseau. Le wallet GUI le fait automatiquement ; en ligne de commande, lancez le nœud avec le bind externe :

screen -dmS node ./bin/pbcd --rpc-bind-ip 0.0.0.0 --confirm-external-bind --log-file $PWD/pbcd.log

Sur les autres machines (mineurs seuls — pas de nœud, pas de wallet GUI) :

Éditez miner/config.json et pointez vers l'IP locale de la machine « banque » :
```
"url": "192.168.X.X:18831"
```
(remplacez 192.168.X.X par l'IP LAN de cette machine — ip a pour la connaître ; "daemon": true reste tel quel)

Lancez le mineur normalement :

sudo screen -dmS miner ./miner/pbcminer --config miner/config.json -t $(($(nproc) - 2))

Les récompenses arrivent sur l'adresse configurée dans config.json, quel que soit le nœud utilisé.

En cas de problème

Vérifier le nœud : tail -20 pbcd.log (dans le dossier pbc_node)
Vérifier le wallet-RPC : tail -20 /tmp/pbc-wallet-rpc.log
Explorer la chaîne : explorateur de blocs