4NK_node/specs/spec-technical.md

Spécification Technique - 4NK_node

Vue d'ensemble

Ce document décrit les modifications techniques apportées au projet 4NK_node pour résoudre les problèmes de déploiement Docker.

Problèmes identifiés

1. Résolution DNS dans Docker

• Problème : Le service sdk_relay ne pouvait pas résoudre les noms d'hôtes bitcoin et blindbit
• Cause : Configuration réseau Docker incorrecte
• Solution : Amélioration de la gestion des erreurs et ajout de retry logic

2. Dépendances Git

• Problème : Les dépendances pointaient vers des repositories distants
• Cause : Cargo.toml utilisait des URLs Git au lieu de chemins locaux
• Solution : Modification des dépendances pour utiliser des chemins locaux

3. Configuration du cookie Bitcoin

• Problème : Le chemin du cookie Bitcoin était codé en dur
• Cause : Utilisation de env::var("HOME") dans un contexte Docker
• Solution : Ajout d'une option de configuration personnalisée pour le chemin du cookie

Modifications apportées

sdk_relay

• Branche : docker-fixes
• Modifications :
  • Ajout de la méthode get_cookie_path() dans Config
  • Modification de la signature de rpc_connect() pour accepter un chemin de cookie personnalisé
  • Ajout de logique de retry pour la connexion au daemon Bitcoin
  • Amélioration de la gestion des erreurs de résolution DNS

sdk_common

• Branche : docker-fixes
• Modifications :
  • Modification de la dépendance sp_client pour utiliser un chemin local
  • Correction de la feature blindbit-backend vers blindbit-native

sdk_client

• Branche : docker-fixes
• Modifications :
  • Modification de la dépendance sdk_common pour utiliser un chemin local

4NK_node

• Modifications :
  • Mise à jour du Dockerfile pour cloner les branches docker-fixes
  • Amélioration de la configuration Docker avec healthchecks
  • Ajout de la gestion des erreurs et retry logic

Architecture Docker

Services

1. bitcoin : Nœud Bitcoin Core en mode signet
2. blindbit : Service Blindbit
3. sdk_relay : Service de relais SDK (modifié)
4. tor : Service Tor pour l'anonymat

Réseau

• btcnet : Réseau privé pour la communication entre services

Volumes

• bitcoin_data : Données Bitcoin Core
• sdk_relay_data : Données du relais SDK

Problèmes restants

1. Compilation sdk_relay

• Erreur : Signatures de traits incompatibles
• Cause : Différences entre les versions des traits SpScanner et ChainBackend
• Impact : Le service ne peut pas être compilé actuellement

2. Collision de noms de fichiers

• Erreur : libsp_client.rlib en collision
• Cause : Plusieurs packages avec le même nom
• Impact : Compilation échoue

Recommandations

Court terme

1. Corriger les signatures de traits dans sdk_relay
2. Résoudre les collisions de noms de fichiers
3. Tester la compilation complète

Moyen terme

1. Implémenter les méthodes manquantes dans DummyBackend
2. Ajouter des tests unitaires pour les nouvelles fonctionnalités
3. Documenter l'API des nouvelles méthodes

Long terme

1. Migrer vers une architecture plus modulaire
2. Implémenter une gestion d'état centralisée
3. Ajouter des métriques et monitoring

Fichiers modifiés

sdk_relay

• src/config.rs : Ajout de get_cookie_path()
• src/daemon.rs : Modification de rpc_connect()
• src/main.rs : Ajout de retry logic
• src/scan.rs : Corrections des traits

sdk_common

• Cargo.toml : Modification des dépendances

sdk_client

• Cargo.toml : Modification des dépendances

4NK_node

• sdk_relay/Dockerfile : Mise à jour des branches
• docker-compose.yml : Amélioration de la configuration
• sdk_relay/.conf.docker : Ajout du chemin du cookie