@cryptodevops/n8n-nodes-blockstream-api/README.md

n8n node for Blockstream API (Esplora) - Bitcoin transactions, mempool, UTXO

# n8n-nodes-blockstream-api

Ce package contient un nœud n8n pour interagir avec l'API Blockstream (Esplora), permettant d'accéder aux données Bitcoin sans nécessiter de clé API.

## Fonctionnalités

### Opérations disponibles

- **Get Transaction** : Récupère les informations détaillées d'une transaction
- **Get Transaction Status** : Vérifie le statut de confirmation d'une transaction
- **Get Address Info** : Obtient les statistiques d'une adresse Bitcoin
- **Get Address Transactions** : Récupère l'historique des transactions d'une adresse
- **Get Address UTXO** : Liste les sorties non dépensées d'une adresse
- **Get Block Info** : Récupère les informations d'un bloc spécifique
- **Get Latest Blocks** : Obtient les derniers blocs minés
- **Get Mempool Stats** : Récupère les statistiques du mempool
- **Broadcast Transaction** : Diffuse une transaction sur le réseau

### Réseaux supportés

- **Bitcoin Mainnet** : Réseau principal Bitcoin
- **Bitcoin Testnet** : Réseau de test Bitcoin
- **Liquid** : Réseau Liquid
- **Liquid Testnet** : Réseau de test Liquid

## Installation

```bash
npm install @cryptodevops/n8n-nodes-blockstream-api
```

## Utilisation

1. Ajoutez le nœud "Blockstream API (Esplora)" à votre workflow n8n
2. Sélectionnez le réseau souhaité (Mainnet, Testnet, Liquid, etc.)
3. Choisissez l'opération à effectuer
4. Remplissez les paramètres requis (ID de transaction, adresse, hash de bloc, etc.)
5. Exécutez le workflow

## API Blockstream (Esplora)

Ce nœud utilise l'API publique Blockstream basée sur Esplora :

- **Bitcoin Mainnet** : `https://blockstream.info/api/`
- **Bitcoin Testnet** : `https://blockstream.info/testnet/api/`
- **Liquid** : `https://blockstream.info/liquid/api/`
- **Liquid Testnet** : `https://blockstream.info/liquidtestnet/api/`

### Avantages

- ✅ Aucune clé API requise
- ✅ Accès gratuit aux données Bitcoin
- ✅ API REST simple et fiable
- ✅ Support de plusieurs réseaux
- ✅ Données en temps réel

## Documentation API

Pour plus d'informations sur l'API Blockstream (Esplora), consultez la documentation officielle :
https://github.com/Blockstream/esplora/blob/master/API.md

## Exemples d'utilisation

### Récupérer une transaction
- Opération : "Get Transaction"
- Transaction ID : `f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16`

### Vérifier les UTXO d'une adresse
- Opération : "Get Address UTXO"
- Adresse : `1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa`

### Obtenir les statistiques du mempool
- Opération : "Get Mempool Stats"

### Surveiller une adresse Bitcoin
```
Blockstream API (Get Address Info) → Condition (si nouveau solde) → Notification
```

### Vérifier le statut d'une transaction
```
Blockstream API (Get Transaction Status) → Condition (si confirmée) → Action
```

### Analyser les UTXO
```
Blockstream API (Get Address UTXO) → Traitement → Rapport
```

## Configuration

Aucune configuration ou clé API n'est requise. Le nœud utilise directement l'API publique Blockstream.

## Gestion d'erreurs

- Continuation en cas d'erreur (configurable)
- Messages d'erreur détaillés avec codes de statut HTTP
- Validation automatique des paramètres d'entrée

## Licence

MIT

## Support

Pour signaler des bugs ou demander des fonctionnalités, veuillez utiliser le système d'issues GitHub.

## Tests

Exécutez les tests pour vérifier la connectivité :

```bash
# Test du nœud Binance
node test-binance-node.js

# Test de validation des credentials
node test-credential-validation.js

# Test de compatibilité n8n
node test-n8n-compatibility.js
```

## Dépannage

Consultez le fichier [TROUBLESHOOTING.md](./TROUBLESHOOTING.md) pour les problèmes courants et leurs solutions.

## Développement

### Structure du projet
```
├── credentials/           # Définitions des credentials
├── nodes/                # Nœuds n8n
│   └── Binance/         # Nœud Binance
├── test-*.js            # Scripts de test
└── dist/                # Fichiers compilés
```

### Build
```bash
npm run build
```

### Développement
```bash
npm run dev
```

## Support

Pour le support et les questions, veuillez ouvrir une issue sur le [repository GitHub](https://github.com/GitCryptoDevOps/n8n-nodes-binance).

## Licence

MIT

## Changelog

### v0.3.0
- 🎯 Package dédié exclusivement à Binance
- ✨ 84 opérations Binance disponibles
- 📊 Support complet des données de marché
- 💼 Gestion complète de compte
- 📈 Trading spot avancé
- 🔄 Ordres OCO, OTO, OTOCO
- 💰 Trading sur marge
- 💎 Simple Earn (épargne)
- 🔄 Conversion de cryptomonnaies
- 👥 Gestion des sous-comptes
- 💳 Portefeuille et capital

### v0.2.0
- ✨ Ajout du nœud Binance avec 7 opérations
- 🔧 Enrichissement automatique des données
- 📚 Documentation complète

### v0.1.0
- 🎉 Version initiale