937646cc45
**Motivations:** - Export Signet and mining wallet backups to git with only 2 versions kept - Document and add backup/restore scripts for signet and mining wallet **Correctifs:** - Backup-to-git uses SSH URL for passwordless cron; copy timestamped files only; prune to 2 versions; remove *-latest from backup repo **Evolutions:** - data/backup-to-git-cron.sh: daily export to git.4nkweb.com/4nk/backup - save-signet-datadir-backup.sh, restore-signet-from-backup.sh, export-mining-wallet.sh, import-mining-wallet.sh - features/backup-to-git-daily-cron.md, docs/MAINTENANCE.md backup section - .gitignore: data/backup-to-git.log **Pages affectées:** - .gitignore, data/backup-to-git-cron.sh, docs/MAINTENANCE.md, features/backup-to-git-daily-cron.md - save-signet-datadir-backup.sh, restore-signet-from-backup.sh, export-mining-wallet.sh, import-mining-wallet.sh - Plus autres fichiers modifiés ou non suivis déjà présents dans le working tree
129 lines
4.4 KiB
Markdown
129 lines
4.4 KiB
Markdown
# Documentation Bitcoin Signet Custom
|
||
|
||
Ce dossier contient toute la documentation nécessaire pour la maintenance et l'utilisation du Bitcoin Signet custom.
|
||
|
||
**Structure du projet :** chemin de base `/home/ncantu/Bureau/code/bitcoin/` ; Mempool dans le sous-répertoire `mempool/`.
|
||
|
||
## Fichiers de Documentation
|
||
|
||
- **[MAINTENANCE.md](./MAINTENANCE.md)** : Documentation complète de maintenance
|
||
- Architecture et structure
|
||
- Configuration et variables d'environnement
|
||
- Commandes de maintenance
|
||
- Gestion du conteneur
|
||
- Mining
|
||
- Accès RPC et API
|
||
- Mise à jour
|
||
- Dépannage
|
||
- Sauvegarde et restauration
|
||
|
||
- **[INSTALLATION_NEW_NODE.md](./INSTALLATION_NEW_NODE.md)** : Guide d'installation d'un nouveau nœud
|
||
- Installation initiale
|
||
- Configuration pour rejoindre une chaîne existante
|
||
- Configuration du mining
|
||
- Vérification et dépannage
|
||
- Partage d'informations avec d'autres nœuds
|
||
|
||
- **[INTERFACES.md](./INTERFACES.md)** : Documentation des interfaces disponibles
|
||
- API REST d'ancrage
|
||
- Interface RPC Bitcoin Core
|
||
- Interface ligne de commande (CLI)
|
||
- Interface ZMQ (ZeroMQ)
|
||
- Interface Docker
|
||
- Interface de configuration
|
||
- Interface de logs
|
||
|
||
- **[MEMPOOL.md](./MEMPOOL.md)** : Documentation de Mempool (explorateur blockchain)
|
||
- Installation et configuration
|
||
- Architecture et services
|
||
- Utilisation et maintenance
|
||
- Dépannage
|
||
- Intégration avec l'infrastructure
|
||
|
||
- **[DOMAINS_AND_PORTS.md](./DOMAINS_AND_PORTS.md)** : Documentation des domaines et ports
|
||
- Liste complète des domaines et services
|
||
- Ports fixes de toutes les APIs
|
||
- Configuration Nginx et routage
|
||
- Services systemd
|
||
- Architecture réseau
|
||
- Certificats SSL/TLS
|
||
|
||
- **[ENVIRONMENT.md](./ENVIRONMENT.md)** : Documentation des fichiers d'environnement
|
||
- Variables d'environnement de tous les services
|
||
- Fichiers `.env` et leur utilisation
|
||
- Configuration des services systemd
|
||
- Ordre de priorité des variables
|
||
- Sécurité et bonnes pratiques
|
||
|
||
- **[DASHBOARD.md](./DASHBOARD.md)** : Documentation du Dashboard
|
||
- Pages disponibles et fonctionnalités
|
||
- Navigation et structure
|
||
- Mise à jour automatique
|
||
- API endpoints utilisés
|
||
- Maintenance et dépannage
|
||
|
||
- **[WEBSITE_SKELETON.md](./WEBSITE_SKELETON.md)** : Squelette de site intégrant UserWallet en iframe
|
||
- Objectif et structure du projet `website-skeleton/`
|
||
- Configuration (origine UserWallet, validateurs)
|
||
- Utilisation, messages postMessage, références
|
||
|
||
- **website-data** (`website-data/`, `features/website-data-architecture.md`) : Iframe data (data.certificator.4nkweb.com), flux site ↔ data (+notifications) ↔ userwallet (relais).
|
||
|
||
- **[PAIRING_PUBLIC_KEY_ENCODING.md](./PAIRING_PUBLIC_KEY_ENCODING.md)** : Encodage de la clé publique dans les mots BIP32
|
||
- Problème identifié (récupération d'un pair par UUID sur un relais)
|
||
- Solution implémentée (encodage direct de la clé publique)
|
||
- Modifications techniques et impact
|
||
- Flux de pairing et migration
|
||
|
||
## Démarrage Rapide
|
||
|
||
### Installation
|
||
|
||
```bash
|
||
cd /home/ncantu/Bureau/code/bitcoin
|
||
sudo docker build -t bitcoin-signet .
|
||
sudo docker run --env-file .env -d --name bitcoin-signet-instance \
|
||
-v signet-bitcoin-data:/root/.bitcoin \
|
||
-p 38332:38332 -p 38333:38333 -p 28332:28332 -p 28333:28333 -p 28334:28334 \
|
||
bitcoin-signet
|
||
```
|
||
|
||
Le volume `signet-bitcoin-data` conserve la chaîne Bitcoin ; sans lui, une recréation du conteneur repart d’une nouvelle chaîne (hauteur 0).
|
||
|
||
### Vérification
|
||
|
||
```bash
|
||
# Alignement Dashboard / Miner / Signet (chaîne ~11535)
|
||
./verify-chain-alignment.sh
|
||
|
||
# État du nœud
|
||
sudo docker exec bitcoin-signet-instance bitcoin-cli -datadir=/root/.bitcoin getblockchaininfo
|
||
```
|
||
|
||
### Correction Dashboard mauvaise chaîne / API ancrage Insufficient Balance
|
||
|
||
Sur la machine bitcoin, à la racine du projet :
|
||
|
||
```bash
|
||
# Vérifier, redémarrer Dashboard et API d’ancrage
|
||
./fix-dashboard-anchor-chain.sh
|
||
|
||
# Avec restauration de la chaîne depuis une sauvegarde
|
||
./fix-dashboard-anchor-chain.sh backups/signet-datadir-YYYYMMDD-HHMMSS.tar.gz
|
||
```
|
||
|
||
### Logs
|
||
|
||
```bash
|
||
sudo docker logs -f bitcoin-signet-instance
|
||
```
|
||
|
||
## Informations Importantes
|
||
|
||
- **Ports** : RPC (38332), P2P (38333), ZMQ (28332-28334)
|
||
- **Configuration** : Fichier `.env` à la racine du projet
|
||
- **Données** : Stockées dans `/root/.bitcoin/` dans le conteneur
|
||
- **Clés** : Générées automatiquement, stockées dans `.env` et `/root/.bitcoin/PRIVKEY.txt`
|
||
|
||
Pour plus de détails, consultez [MAINTENANCE.md](./MAINTENANCE.md).
|