bitcoin-cli

Définition

bitcoin-cli est l'outil en ligne de commande officiel de Bitcoin Core qui permet d'interagir avec un démon bitcoind via son API JSON-RPC. C'est l'équivalent de psql pour PostgreSQL ou redis-cli pour Redis : un client léger qui envoie des commandes au serveur et affiche la réponse en JSON. Tout administrateur de nœud Bitcoin sérieux finit par maîtriser bitcoin-cli.

Quelques commandes essentielles

# Statut général
bitcoin-cli getblockchaininfo
bitcoin-cli getnetworkinfo
bitcoin-cli getmininginfo

# Mempool
bitcoin-cli getmempoolinfo
bitcoin-cli estimatesmartfee 6

# Wallet (si activé)
bitcoin-cli getwalletinfo
bitcoin-cli getbalance
bitcoin-cli listunspent
bitcoin-cli sendtoaddress <addr> <amount>

# Blocs et transactions
bitcoin-cli getblock <hash>
bitcoin-cli getrawtransaction <txid> true
bitcoin-cli decoderawtransaction <hex>

# Peers
bitcoin-cli getpeerinfo
bitcoin-cli addnode <ip:port> add

Authentification

bitcoin-cli lit son authentification dans bitcoin.conf (ou ~/.bitcoin/bitcoin.conf par défaut) :

rpcuser=alice
rpcpassword=motdepasse
rpcport=8332
rpcallowip=127.0.0.1

Pour des raisons de sécurité, on utilise plutôt cookie auth (fichier .cookie généré automatiquement par bitcoind) ou rpcauth (mot de passe haché avec sel, plus sûr que le rpcpassword en clair).

Multi-wallets

Bitcoin Core supporte plusieurs wallets simultanés. Pour adresser un wallet précis :

bitcoin-cli -rpcwallet=mywallet getbalance

Commandes avancées

| Commande | Usage | |----------|-------| | importdescriptors | Import d'un wallet via BIP-380 | | walletpassphrase | Unlock temporaire d'un wallet chiffré | | signrawtransactionwithwallet | Signature locale | | fundrawtransaction | Construction guidée d'une transaction | | submitpackage | Soumission d'un package (BIP-431) | | psbtbumpfee | Augmenter les frais (RBF) |

Pour quoi faire ?

• Vérifier la santé d'un nœud (sync, peers, espace disque).
• Construire des transactions PSBT pour wallets multisig.
• Scripting : automatisation de tâches (analyse, sauvegarde, monitoring).
• Pédagogie : explorer la mécanique interne de Bitcoin.

À retenir

bitcoin-cli reste l'outil de référence pour qui veut comprendre profondément Bitcoin. Les wallets graphiques cachent la complexité, mais c'est en ligne de commande qu'on perçoit la vraie architecture du protocole. Pour un node runner, c'est un compagnon quotidien.