4nk/anchorage_layer_simple
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
anchorage_layer_simple/docs/README.md
ncantu 937646cc45 Daily backup to git cron, backup/restore scripts, docs 
**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
2026-02-04 03:07:57 +01:00

4.4 KiB
Raw Blame History

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 : 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 : 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 : 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 : 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 : 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 : 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 : 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 : 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 : 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

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

# 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 :

# 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

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.