Guide de compilation du code source et de mise en route

La voie complète : compilation du nœud, des wallets et de l'interface web depuis le code source officiel (liboqs d'abord !), puis mise en route détaillée étape par étape.

1.Prérequis (Ubuntu 24 / Debian 12)

sudo apt update
sudo apt install -y build-essential cmake pkg-config git \
  libboost-all-dev libssl-dev libzmq3-dev libunbound-dev \
  libsodium-dev libreadline-dev libexpat1-dev libncurses5-dev \
  doxygen graphviz screen curl

2.Télécharger et vérifier le code source

wget https://privbank.finance/fichiers/PBC_source_v8.2.18_2026-09-08.tar.gz
md5sum PBC_source_v8.2.18_2026-09-08.tar.gz

Le md5 affiché doit correspondre exactement à celui du fichier md5sums.txt publié sur le site. Ne compilez jamais une archive dont le md5 ne correspond pas.

tar xzf PBC_source_v8.2.18_2026-09-08.tar.gz
cd pbc-chain

3.Compiler liboqs (cryptographie post-quantique) — OBLIGATOIRE d'abord

PBC embarque liboqs (Dilithium + Kyber) dans external/liboqs : elle doit être compilée et installée avant le nœud.

cd external/liboqs
mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=OFF \
      -DCMAKE_INSTALL_PREFIX="$PWD/install" ..
make -j$(nproc)
make install

4.Compiler le nœud, les wallets et l'interface web

cd ../../..        # retour à la racine pbc-chain
mkdir -p build/release && cd build/release
cmake -Wno-dev -DCMAKE_BUILD_TYPE=Release \
      -DBUILD_TESTS=OFF -DBUILD_DOCUMENTATION=OFF \
      -DBUILD_DEBUG_UTILITIES=OFF -DUSE_DEVICE_TREZOR=OFF \
      -DBUILD_GUI_DEPS=OFF ../..
make -j$(nproc) daemon simplewallet wallet_rpc_server pbc-webui

Les binaires sont dans build/release/bin/ :

• pbcd — le nœud (daemon)
• pbc-wallet-cli — wallet en ligne de commande
• pbc-wallet-rpc — wallet RPC (backend de l'interface web)
• pbc-webui — serveur de l'interface web (fichiers web dans web/ à la racine du source)

5.(Optionnel) Compiler le mineur CPU

cd ~    # hors de l'arbre pbc-chain
wget https://privbank.finance/fichiers/PBC_pbcminer_v2_2026-08-26.tar.gz
tar xzf PBC_pbcminer_v2_2026-08-26.tar.gz
cd pbcminer_v2
mkdir -p build && cd build
cmake -Wno-dev ..
make -j$(nproc)

Le binaire pbcminer est dans build/.

6.Mise en route — pas à pas

Une fois compilés, les binaires sont dans build/release/bin/ (pbc-webui dans build/release/src/webui/) et les fichiers de l'interface web dans web/ à la racine du source. Lancez dans l'ordre :

6.1Lancer votre nœud

screen -dmS node ./build/release/bin/pbcd --log-file $PWD/pbcd.log

Votre nœud se connecte automatiquement aux seeds du réseau. 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.)

6.2Créer votre wallet

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

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

6.3Lancer le wallet-RPC

screen -dmS wallet-rpc ./build/release/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

6.4Lancer l'interface web du wallet

screen -dmS webui ./build/release/src/webui/pbc-webui \
  --rpc-port 18083 \
  --web-dir <racine-du-source>/web \
  --wallet-log /tmp/pbc-wallet-rpc.log

(Remplacez <racine-du-source> par le chemin du dossier pbc-chain — les fichiers de l'interface sont dans son sous-dossier web/.)

6.5Ouvrir 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.6Miner

Le mineur CPU est un projet séparé — binaire + config dans la section Téléchargements, source incluse (ou compilé à l'étape 5 ci-dessus). Éditez miner/config.json et mettez votre adresse (étape 6.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). Sans sudo, le mineur fonctionne quand même 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.

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

Sur la machine « banque » (celle qui héberge le nœud), lancez-le avec le bind externe :

screen -dmS node ./build/release/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) : é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), puis lancez le mineur normalement. Les récompenses arrivent sur l'adresse configurée dans config.json, quel que soit le nœud utilisé.

8.En cas de problème

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