sdk_relay/docs/TROUBLESHOOTING.md

Dépannage - sdk_relay

Problèmes courants

1) /health renvoie erreur

• Vérifier Bitcoin Core RPC (bitcoin-cli -signet getblockchaininfo)
• Vérifier Blindbit (curl http://blindbit:8000/health)
• Vérifier variables BITCOIN_COOKIE_PATH

2) Port 8090 non accessible

• Vérifier pare-feu
• Vérifier que le processus écoute (netstat/ss)
• Conflit de ports ?

3) Messages WS non reçus

• Handshake bien envoyé ?
• Capabilities compatibles ?
• Heartbeat actif (ping/pong) ?

4) Sync inopérante

• Relais voisins connus ? (GET /relays)
• StateSync visible dans logs ?
• Latence réseau élevée ?

Outils utiles

• docker logs, journalctl (si service)
• RUST_LOG=debug
• Scripts de tests/monitoring