# 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