cad73cb265
**Motivations:** - Ajouter dates manquantes dans hash_list.txt et compléter historique - Compléter blockTime manquants dans utxo_list.txt et compléter historique - Récupérer frais depuis transactions d'ancrage (OP_RETURN) et les stocker - Bouton UI pour déclencher récupération frais - Diagnostic Bloc Rewards (pourquoi ~4700 BTC au lieu de 50 BTC) **Root causes:** - hash_list.txt sans date (format ancien) - utxo_list.txt blockTime souvent vide - Frais absents du fichier (métadonnées OP_RETURN non stockées) - Pas de moyen de récupérer/compléter frais depuis UI **Correctifs:** - hash_list.txt : format étendu avec date (rétrocompatible) - utxo_list.txt : blockTime complété automatiquement lors écritures - fees_list.txt : nouveau fichier pour stocker frais - updateFeesFromAnchors() : récupère frais depuis OP_RETURN ancrages - Endpoint /api/utxo/fees/update pour déclencher récupération - Bouton "Récupérer les frais depuis les ancrages" dans section Frais (spinner) - Scripts batch : complete-hash-list-dates.js, complete-utxo-list-blocktime.js - Script diagnostic : diagnose-bloc-rewards.js (subsidy, coinbase, listunspent) **Evolutions:** - Frais chargés depuis fees_list.txt dans getUtxoList - Complétion automatique dates/blockTime lors écritures futures **Pages affectées:** - signet-dashboard/src/bitcoin-rpc.js - signet-dashboard/src/server.js - signet-dashboard/public/utxo-list.html - scripts/complete-hash-list-dates.js - scripts/complete-utxo-list-blocktime.js - scripts/diagnose-bloc-rewards.js - features/utxo-list-fees-update-and-historical-completion.md
53 lines
1.9 KiB
Markdown
53 lines
1.9 KiB
Markdown
# API Relay – Correction doc port 8080→3019 et nettoyage config
|
||
|
||
**Auteur:** Équipe 4NK
|
||
**Date:** 2026-01-26
|
||
|
||
## Motivations
|
||
|
||
- Aligner la documentation api-relay sur le port réel (3019) ; les exemples et défauts indiquaient 8080.
|
||
- Supprimer le code mort : `api-relay/src/types/config.ts` (interface `RelayConfig`) n’était pas utilisé ; la config réelle passe par les variables d’environnement dans `index.ts`.
|
||
- Harmoniser le placeholder du champ « relais » dans UserWallet (3019).
|
||
|
||
## Root causes
|
||
|
||
- **Doc** : `features/api-relay.md` et ancien README indiquaient le port 8080 ; le code utilise 3019 par défaut.
|
||
- **config.ts** : Fichier créé pour une config structurée jamais branchée ; `index.ts` lit PORT, HOST, STORAGE_PATH, PEER_RELAYS depuis l’env.
|
||
|
||
## Correctifs
|
||
|
||
### 1. features/api-relay.md
|
||
|
||
- Variables d’environnement : défaut `PORT` 8080 → 3019.
|
||
- Exemples (PORT, PEER_RELAYS, curl) : 8080 → 3019.
|
||
- Structure du projet : suppression de `config.ts` dans l’arbre ; mention « config via env » pour `index.ts`.
|
||
|
||
### 2. api-relay – suppression config.ts
|
||
|
||
- **Fichier supprimé** : `api-relay/src/types/config.ts`.
|
||
- Aucun import ailleurs ; le build reste vert.
|
||
|
||
### 3. userwallet – RelaySettingsScreen
|
||
|
||
- Placeholder du champ « Ajouter un relais » : `http://relay.example.com:8080` → `http://relay.example.com:3019`.
|
||
|
||
## Évolutions
|
||
|
||
- Aucune.
|
||
|
||
## Pages affectées
|
||
|
||
- `userwallet/features/api-relay.md`
|
||
- `api-relay/src/types/config.ts` (supprimé)
|
||
- `userwallet/src/components/RelaySettingsScreen.tsx`
|
||
|
||
## Modalités de déploiement
|
||
|
||
- Aucun redéploiement serveur requis. Rebuild userwallet si déploiement front ; api-relay inchangé côté runtime.
|
||
|
||
## Modalités d’analyse
|
||
|
||
- Vérifier que les exemples curl dans `api-relay.md` ciblent bien un relais sur 3019.
|
||
- `npm run build` dans api-relay doit passer.
|
||
- `npm run build` dans userwallet doit passer.
|