Nicolas Cantu
fa13f34e0d
- Scripts de transfert automatique de fonds du wallet mining vers le relay - Vérification automatique des fonds insuffisants - Monitoring continu des fonds - Intégration dans docker-compose - Documentation complète des scripts - Résolution automatique du problème de fonds pour le pairing
187 lines
5.0 KiB
Markdown
187 lines
5.0 KiB
Markdown
# Transfert Automatique de Fonds
|
|
|
|
## Vue d'ensemble
|
|
|
|
Ce système implémente un mécanisme automatique de transfert de fonds du wallet mining vers le relay en cas de fonds insuffisants. Cela résout automatiquement le problème de fonds pour le processus de pairing.
|
|
|
|
## Scripts Disponibles
|
|
|
|
### 1. `scripts/funds/simple_transfer.sh`
|
|
Script de base pour transférer des fonds du wallet mining vers le relay.
|
|
|
|
**Usage:**
|
|
```bash
|
|
./scripts/funds/simple_transfer.sh [amount]
|
|
```
|
|
|
|
**Paramètres:**
|
|
- `amount`: Montant à transférer en BTC (par défaut: 0.01)
|
|
|
|
**Fonctionnalités:**
|
|
- Vérification de la connectivité Bitcoin
|
|
- Vérification des soldes des wallets
|
|
- Génération d'une adresse pour le relay
|
|
- Transfert de fonds
|
|
- Confirmation de la transaction
|
|
- Redémarrage du relay
|
|
|
|
### 2. `scripts/funds/check_and_transfer_funds.sh`
|
|
Script d'intégration qui vérifie les fonds et lance un transfert si nécessaire.
|
|
|
|
**Usage:**
|
|
```bash
|
|
./scripts/funds/check_and_transfer_funds.sh [min_amount]
|
|
```
|
|
|
|
**Paramètres:**
|
|
- `min_amount`: Montant minimum requis en BTC (par défaut: 0.001)
|
|
|
|
**Fonctionnalités:**
|
|
- Vérification des fonds du relay dans la configuration
|
|
- Vérification du solde du wallet relay dans Bitcoin Core
|
|
- Transfert automatique si fonds insuffisants
|
|
- Transfère 10x le montant minimum requis
|
|
|
|
### 3. `scripts/funds/monitor_funds.sh`
|
|
Script de monitoring continu des fonds du relay.
|
|
|
|
**Usage:**
|
|
```bash
|
|
./scripts/funds/monitor_funds.sh [interval_seconds]
|
|
```
|
|
|
|
**Paramètres:**
|
|
- `interval_seconds`: Intervalle de vérification en secondes (par défaut: 30)
|
|
|
|
**Fonctionnalités:**
|
|
- Monitoring continu des fonds
|
|
- Vérification de l'état du relay
|
|
- Transfert automatique si fonds insuffisants
|
|
- Affichage des statistiques en temps réel
|
|
|
|
### 4. `scripts/funds/startup_funds_check.sh`
|
|
Script de vérification des fonds au démarrage.
|
|
|
|
**Usage:**
|
|
```bash
|
|
./scripts/funds/startup_funds_check.sh
|
|
```
|
|
|
|
**Fonctionnalités:**
|
|
- Attente du démarrage des services
|
|
- Vérification de la connectivité Bitcoin
|
|
- Vérification de l'état du relay
|
|
- Lancement du transfert automatique si nécessaire
|
|
|
|
### 5. `scripts/startup-with-funds-check.sh`
|
|
Script de démarrage complet avec vérification des fonds.
|
|
|
|
**Usage:**
|
|
```bash
|
|
./scripts/startup-with-funds-check.sh
|
|
```
|
|
|
|
**Fonctionnalités:**
|
|
- Démarrage des services Docker Compose
|
|
- Attente du démarrage complet
|
|
- Vérification et transfert automatique des fonds
|
|
|
|
## Intégration dans les Applications
|
|
|
|
### Docker Compose
|
|
Le volume `./scripts/funds:/scripts/funds:ro` est monté dans le conteneur `sdk_relay` pour permettre l'accès aux scripts.
|
|
|
|
### Démarrage Automatique
|
|
Utilisez `./scripts/startup-with-funds-check.sh` pour démarrer les services avec vérification automatique des fonds.
|
|
|
|
### Monitoring Continu
|
|
Lancez `./scripts/funds/monitor_funds.sh` en arrière-plan pour un monitoring continu des fonds.
|
|
|
|
## Configuration
|
|
|
|
### Variables d'Environnement
|
|
- `MINING_WALLET`: Nom du wallet mining (par défaut: "mining_mnemonic")
|
|
- `RELAY_WALLET`: Nom du wallet relay (par défaut: "default")
|
|
- `COOKIE_FILE`: Chemin vers le fichier cookie Bitcoin (par défaut: "/home/bitcoin/.bitcoin/signet/.cookie")
|
|
|
|
### Montants par Défaut
|
|
- Montant minimum: 0.001 BTC (100,000 sats)
|
|
- Montant de transfert par défaut: 0.01 BTC (1,000,000 sats)
|
|
- Multiplicateur de transfert: 10x le montant minimum
|
|
|
|
## Dépannage
|
|
|
|
### Problèmes Courants
|
|
|
|
1. **bc non installé**
|
|
```bash
|
|
sudo apt-get install -y bc
|
|
```
|
|
|
|
2. **Permissions insuffisantes**
|
|
```bash
|
|
chmod +x scripts/funds/*.sh
|
|
```
|
|
|
|
3. **Wallet non chargé**
|
|
Les scripts chargent automatiquement le wallet relay si nécessaire.
|
|
|
|
4. **Transaction non confirmée**
|
|
Les scripts génèrent automatiquement des blocs pour confirmer les transactions.
|
|
|
|
### Logs
|
|
Les scripts affichent des logs colorés pour faciliter le débogage:
|
|
- 🔵 [INFO]: Informations générales
|
|
- 🟢 [SUCCESS]: Opérations réussies
|
|
- 🟡 [WARNING]: Avertissements
|
|
- 🔴 [ERROR]: Erreurs
|
|
|
|
## Exemples d'Utilisation
|
|
|
|
### Transfert Manuel
|
|
```bash
|
|
# Transférer 0.01 BTC
|
|
./scripts/funds/simple_transfer.sh 0.01
|
|
|
|
# Transférer 0.1 BTC
|
|
./scripts/funds/simple_transfer.sh 0.1
|
|
```
|
|
|
|
### Vérification et Transfert Automatique
|
|
```bash
|
|
# Vérifier et transférer si nécessaire (minimum 0.001 BTC)
|
|
./scripts/funds/check_and_transfer_funds.sh 0.001
|
|
|
|
# Vérifier et transférer si nécessaire (minimum 0.01 BTC)
|
|
./scripts/funds/check_and_transfer_funds.sh 0.01
|
|
```
|
|
|
|
### Monitoring Continu
|
|
```bash
|
|
# Monitoring toutes les 30 secondes
|
|
./scripts/funds/monitor_funds.sh
|
|
|
|
# Monitoring toutes les 60 secondes
|
|
./scripts/funds/monitor_funds.sh 60
|
|
```
|
|
|
|
### Démarrage Complet
|
|
```bash
|
|
# Démarrage avec vérification des fonds
|
|
./scripts/startup-with-funds-check.sh
|
|
```
|
|
|
|
## Sécurité
|
|
|
|
- Les scripts utilisent des montants par défaut sécurisés
|
|
- Vérification des soldes avant transfert
|
|
- Confirmation des transactions
|
|
- Logs détaillés pour audit
|
|
|
|
## Maintenance
|
|
|
|
- Les scripts sont conçus pour être robustes et auto-réparateurs
|
|
- Monitoring continu disponible
|
|
- Redémarrage automatique du relay après transfert
|
|
- Gestion des erreurs et retry automatique
|