lecoffre_node/docs/retours_experience/REX_BOOTSTRAP_WEBSOCKET.md

Retour d'Expérience : Bootstrap WebSocket et Faucet

Problème initial

• Erreur : "Failed to create pairing process: Insufficient funds. Missing 1096 sats."
• Cause : Le relai local n'avait pas de fonds car le bootstrap ne fonctionnait pas correctement
• Impact : Impossible de faire du pairing d'appareils

Diagnostic effectué

1. Configuration bootstrap incorrecte

# ❌ Configuration initiale (incorrecte)
bootstrap_url="ws://dev3.4nkweb.com:8090"

2. Tests de connectivité

• Port 8090 : Accessible mais pas de faucet WebSocket
• Port 443 : 502 Bad Gateway
• Port 8080 : Service Express.js sans routes signer/websocket

3. Solution trouvée

# ✅ Configuration corrigée
bootstrap_url="wss://dev3.4nkweb.com/ws/"
bootstrap_faucet=true

Leçons apprises

1. Vérification des endpoints WebSocket

• Toujours tester : wscat -c wss://domain/ws/ avant configuration
• Vérifier le protocole : WSS (sécurisé) vs WS (non sécurisé)
• Tester le faucet : Envoyer une requête faucet et vérifier la réponse

2. Configuration des adresses SP permanentes

# ✅ Ajouter dans sdk_relay.conf
sp_address="tsp1qqgmwp9n5p9ujhq2j6cfqe4jpkyu70jh9rgj0pwt3ndezk2mrlvw6jqew8fhsulewzglfr7g2aa48wyj4n0r7yasa3fm666vda8984ke8tuaf9m89"

3. Diagnostic des fonds

• Vérifier le wallet : docker exec sdk_relay cat /home/bitcoin/.4nk/default | jq '.outputs'
• Vérifier la maturité : Les fonds minés localement peuvent être immatures
• Utiliser le faucet distant : Plus fiable que le minage local pour les tests

Scripts de diagnostic

Test de connectivité WebSocket

#!/bin/bash
# Test de connectivité WebSocket bootstrap
echo "Test de connectivité WebSocket..."
timeout 10 wscat -c wss://dev3.4nkweb.com/ws/ -x '{"type":"faucet","address":"test"}' || echo "Échec de connexion"

Vérification des fonds du relai

#!/bin/bash
# Vérification des fonds du relai
echo "Vérification des fonds du relai..."
docker exec sdk_relay cat /home/bitcoin/.4nk/default | jq '.outputs | length'

Configuration recommandée

sdk_relay.conf

# Configuration bootstrap WebSocket
bootstrap_url="wss://dev3.4nkweb.com/ws/"
bootstrap_faucet=true

# Adresse SP permanente (optionnel mais recommandé)
sp_address="tsp1qqgmwp9n5p9ujhq2j6cfqe4jpkyu70jh9rgj0pwt3ndezk2mrlvw6jqew8fhsulewzglfr7g2aa48wyj4n0r7yasa3fm666vda8984ke8tuaf9m89"

Actions préventives

1. Toujours tester la connectivité WebSocket avant déploiement
2. Configurer une adresse SP permanente pour éviter les changements d'adresse
3. Vérifier les fonds du relai après démarrage
4. Documenter les endpoints de faucet fonctionnels
5. Tester le pairing après chaque modification de configuration

Date

• Créé : 2025-09-20
• Problème résolu : Bootstrap WebSocket et réception de fonds
• Impact : Résolution du problème de fonds insuffisants pour le pairing