anchorage_layer_simple/fixKnowledge/bloc-rewards-amount-not-50-btc.md

Bloc Rewards : montants affichés ≠ 50 BTC (4 premières années)

Auteur : Équipe 4NK
Date : 2026-01-26
Version : 1.0

Problème

En UTXO-list, section Bloc Rewards (Récompenses de minage) :

• Attendu : 50 🛡 par bloc (récompense de base des 4 premières années, protocole Bitcoin).
• Observé : 4 700 🛡, 4 250 🛡, 4 100 🛡, etc. (ex. utxo_list.txt).

Chaîne de données (origine des montants)

1. RPC : listunspent (Bitcoin Core) retourne pour chaque UTXO un champ amount en BTC.
2. bitcoin-rpc.js : on récupère utxo.amount, on catégorise les coinbase en bloc_rewards, on écrit en fichier item.amount.
3. Fichier : utxo_list.txt, format category;txid;vout;amount;confirmations;.... Le montant écrit = valeur RPC.
4. utxo-list.html : en chargement fichier, on parse amount et on affiche Math.round(utxo.amount) 🛡.

Donc on affiche strictement ce que le nœud fournit via listunspent. Aucune transformation (sats→BTC, somme, etc.) côté dashboard.

Récompense de bloc côté protocole

• Coinbase : 1 output = subsidy (récompense de base) + frais des transactions du bloc.
• 4 premières années (blocs 0–209 999) : subsidy = 50 BTC (mainnet / signet standard).
• Les frais sont en général bien plus petits que 50 BTC.

Si on voit 4 700 BTC par bloc, ce n’est pas « 50 + frais » dans un cadre standard.

Causes possibles

1. Subsidy custom (signet)
   Le signet peut utiliser des paramètres de chaîne différents (ex. autre courbe de subsidy). La récompense de bloc est définie dans les chain params du nœud, pas dans le miner.

2. Miner / getblocktemplate
   Le miner utilise getblocktemplate. La coinbase est construite par le nœud. La valeur de l’output coinbase (donc ce que listunspent voit) vient du nœud, pas du script miner ou de blocktools.create_coinbase.

3. Bug en amont
   Moins probable, mais possible : bug ou config spéciale du nœud / du wallet (autre unité, autre agrégation).

Comment vérifier (diagnostic)

À lancer sur la machine où tourne le nœud / le wallet utilisé par le dashboard :

# 1. Montants listunspent (ex. wallet custom_signet)
bitcoin-cli -rpcwallet=custom_signet listunspent 1 | jq '.[] | select(.txid) | {txid, vout, amount, confirmations}'

# 2. Détail d’une coinbase particulière (ex. premier bloc rewards du fichier)
TXID="d7696ca795fe16dfa8516f5267d476c755a8f2bdb93f5ff0dc14a2599c070cce"
bitcoin-cli getrawtransaction "$TXID" 1 | jq '{txid, vout: [.vout[] | {n, value}], blockhash, blockheight}'

• Comparer amount (listunspent) et vout[].value (getrawtransaction) aux montants affichés dans l’UI et dans utxo_list.txt.
• Vérifier blockheight : si height < 210 000, la subsidy standard est 50 BTC.

Ensuite, côté nœud :

• Config signet (fichier conf, signetchallenge, etc.).
• Si possible, source des chain params (subsidy, halving) pour ce signet custom (ex. fork Easepay ou autre).

Actions recommandées

1. Ne pas forcer l’affichage à « 50 🛡 » : on affiche la donnée brute pour garder le problème visible et traçable.
2. Identifier la source :
   • soit subsidy custom du signet → documenter la règle (ex. « X BTC par bloc pour ce signet ») et adapter l’affichage / les explications si besoin ;
   • soit anomalie (config, bug) → corriger côté nœud / chain params.
3. Documenter : une fois la règle connue, mettre à jour ce doc (et éventuellement l’UI) pour indiquer la récompense de bloc réelle pour ce signet.

Pages / composants affectés

• signet-dashboard/src/bitcoin-rpc.js : lecture utxo.amount (listunspent), écriture fichier.
• signet-dashboard/public/utxo-list.html : affichage Math.round(utxo.amount) pour Bloc Rewards.
• utxo_list.txt : reflet des montants RPC.

Références

• Bitcoin Core RPC : listunspent (amount en BTC), getrawtransaction (vout[].value).
• miner_imports/test_framework/blocktools.py : create_coinbase(height, nValue=50) — utilisé par les tests, pas par le miner en production pour ce signet ; la coinbase réelle vient du nœud.