sdk_relay/docs/TROUBLESHOOTING.md
2025-08-25 15:31:34 +02:00

29 lines
739 B
Markdown

# 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