Nicolas Cantu
3c75658fb5
- Documentation complète des REX dans docs/retours_experience/ - Scripts automatisés de vérification dans scripts/rex/ - Pérennisation des solutions aux problèmes rencontrés - Amélioration de la maintenance et du debugging
88 lines
2.9 KiB
Markdown
88 lines
2.9 KiB
Markdown
# 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
|
|
```bash
|
|
# ❌ 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
|
|
```bash
|
|
# ✅ 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
|
|
```bash
|
|
# ✅ 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
|
|
```bash
|
|
#!/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
|
|
```bash
|
|
#!/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
|
|
```ini
|
|
# 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
|