Quand vous faites tourner votre propre nœud Bitcoin — le fondement du minage solo et le refus de faire confiance à la copie du registre de quelqu’un d’autre — vous lui parlez par l’interface JSON-RPC. bitcoin-cli est la porte d’entrée, et derrière elle se trouve un catalogue de commandes réparties en catégories : Blockchain, Mining, Network, Wallet, Raw Transactions, Util, Control et Generating. Cette référence couvre les commandes qu’un mineur et opérateur de nœud utilise réellement — la catégorie Mining au complet, plus les commandes Blockchain et Network qui vous disent si votre nœud est sain et souverain. Chaque description ici provient de la documentation RPC canonique de Bitcoin Core.
Deux notes avant les tableaux. D’abord, il s’agit d’un sous-ensemble de travail, pas de l’API complète (~130 commandes) — c’est la tranche qui compte pour le minage et l’exploitation d’un nœud, ce qui est le domaine de D-Central. Ensuite, la disponibilité des RPC et les champs exacts évoluent d’une version de Bitcoin Core à l’autre; traitez ceci comme le cœur stable et confirmez les détails précis avec bitcoin-cli help <commande> sur votre propre nœud.
Commandes Mining — le pont vers le minage solo
Ces six commandes sont l’interface littérale entre un nœud Bitcoin et le matériel ou le logiciel de minage. Si vous branchez un ASIC ou une configuration de minage solo à votre propre nœud, c’est la couche qui les relie.
| Commande | Rôle |
|---|---|
getblocktemplate |
Renvoie les données nécessaires pour construire un bloc à miner — le hash du bloc précédent, les transactions en attente à inclure, la cible de difficulté et les autres paramètres dont un mineur a besoin pour bâtir un bloc candidat valide. |
getmininginfo |
Renvoie un objet JSON d’état lié au minage : blocks, currentblockweight, currentblocktx, difficulty, networkhashps, pooledtx, chain et warnings. |
getnetworkhashps |
Renvoie le hashrate estimé du réseau (hachages par seconde) sur les n derniers blocs. Les paramètres optionnels nblocks (défaut 120; -1 pour les blocs depuis le dernier changement de difficulté) et height (défaut -1) permettent une estimation à un point précis. |
prioritisetransaction |
Accepte un identifiant de transaction et un delta de frais en satoshis pour augmenter (ou diminuer) la priorité qu’accorde l’algorithme de minage à cette transaction — sans payer réellement les frais sur la chaîne. |
submitblock |
Tente de soumettre au réseau un bloc nouvellement résolu. Le paramètre hexdata porte le bloc encodé en hexadécimal. |
submitheader |
Décode le hexdata fourni comme un en-tête de bloc et le soumet comme sommet de chaîne candidat s’il est valide. |
La logique à comprendre : le logiciel d’un mineur solo interroge getblocktemplate pour obtenir du travail, le hache, et renvoie un bloc résolu via submitblock. Cette boucle — exécutée contre votre propre nœud plutôt que le serveur d’un pool — est ce qui rend le minage solo sans confiance. Pour situer le solo par rapport au minage en pool, voyez notre guide de décision pool vs solo et le calculateur de probabilité de minage solo.
Commandes Blockchain — mon nœud est-il synchronisé et honnête?
Elles répondent aux questions que tout opérateur de nœud se pose : suis-je entièrement synchronisé, que fait la chaîne, et quelle est la taille de l’état que je valide?
| Commande | Rôle |
|---|---|
getblockchaininfo |
Renvoie l’état global de la chaîne : chain (main/test/regtest), blocks, headers, bestblockhash, difficulty, verificationprogress (0–1), initialblockdownload, size_on_disk et pruned. |
getblockcount |
Renvoie la hauteur de la chaîne validée à plus grand travail — la hauteur de bloc actuelle de votre nœud. |
getbestblockhash |
Renvoie le hash d’en-tête du meilleur bloc (le sommet) de la chaîne que votre nœud tient pour valide. |
getblockhash |
Renvoie le hash d’en-tête du bloc à une hauteur donnée. |
getdifficulty |
Renvoie la difficulté de preuve de travail actuelle, en multiple de la difficulté minimale. |
getmempoolinfo |
Renvoie les statistiques du mempool : nombre de transactions (size), octets virtuels, usage mémoire, maxmempool et les taux de frais minimaux (mempoolminfee, minrelaytxfee). |
getrawmempool |
Renvoie les identifiants des transactions actuellement dans le mempool de votre nœud (optionnellement avec le détail verbeux par transaction). |
gettxoutsetinfo |
Renvoie des statistiques sur l’ensemble des sorties de transaction non dépensées (UTXO) : hauteur de bloc et hash du sommet, nombre de sorties, métriques de taille de l’ensemble UTXO, un hash sérialisé, l’usage disque estimé et le montant total de bitcoins. |
verifychain |
Re-vérifie la base de données de blocs locale jusqu’à une profondeur et une rigueur choisies — un contrôle d’intégrité de ce que votre nœud a stocké. |
pruneblockchain |
Sur un nœud élagué, élague manuellement le stockage de blocs jusqu’à une hauteur cible (ou un horodatage), libérant du disque tout en conservant la validation complète. |
Commandes Network — à qui mon nœud parle-t-il?
| Commande | Rôle |
|---|---|
getnetworkinfo |
Renvoie l’état du réseau P2P : version, subversion, protocolversion, connections (plus connections_in/connections_out), networkactive, relayfee, incrementalfee et warnings. |
getpeerinfo |
Renvoie des données sur chaque nœud connecté sous forme de tableau JSON — un objet par pair, couvrant l’adresse, le sens de la connexion, la version et le trafic. |
getconnectioncount |
Renvoie le nombre de connexions que votre nœud entretient actuellement avec d’autres nœuds. |
Pourquoi c’est important pour la souveraineté
Chaque commande ci-dessus s’exécute contre un registre que vous validez. Un pool vous dit ce qu’il veut vous faire croire à propos de la chaîne; getblockchaininfo et getbestblockhash vous disent ce que votre propre nœud a vérifié de façon indépendante. Miner en solo contre getblocktemplate signifie que le bloc que vous trouveriez est votre bloc, bâti à partir de votre politique de mempool — sans dépositaire, sans permission. C’est la forme concrète de la pile souveraine : posséder le nœud, posséder le template, posséder le registre.
Pour aller plus loin : notre référence des implémentations de nœud Bitcoin compare les logiciels qui exposent cette API, le pôle des pools de minage couvre le spectre du dépositaire au solo, et le Manuel de terrain du minage Bitcoin relie la couche nœud au matériel, au firmware et aux pools qui l’entourent. Pour les arguments exacts d’une commande sur votre version, bitcoin-cli help <commande> fait autorité.
