anchorage_layer_simple/fixKnowledge/api-relay-doc-config-cleanup.md
ncantu cad73cb265 UTXO-list: dates/blockTime historiques, récupération frais depuis ancrages, diagnostic Bloc Rewards
**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
2026-01-26 01:59:46 +01:00

1.9 KiB
Raw Blame History

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 denvironnement 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 lenv.

Correctifs

1. features/api-relay.md

  • Variables denvironnement : défaut PORT 8080 → 3019.
  • Exemples (PORT, PEER_RELAYS, curl) : 8080 → 3019.
  • Structure du projet : suppression de config.ts dans larbre ; 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:8080http://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 danalyse

  • 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.