Par défaut, la copie locale sera synchronisée avec le code le plus récent, qui peut être une version instable ou bêta de bitcoin. Avant de compiler le code, sélectionnez une version spécifique en consultant une version avec la commande Git tag. Cela synchronisera la copie locale avec un instantané (snapshot) spécifique du référentiel de code identifié par une balise de mot-clé (le tag.) Les balises sont utilisées par les développeurs pour marquer des versions spécifiques du code par numéro de version. Tout d’abord, pour trouver les balises disponibles, nous utilisons la commande git tag :

La liste des balises montre toutes les versions publiées de bitcoin. Par convention, les release candidates (ou versions d’évaluations), qui sont destinées aux tests, ont le suffixe "rc". Les versions stables pouvant être exécutées sur des systèmes de production n’ont pas de suffixe. Dans la liste précédente, sélectionnez la version la plus élevée, qui au moment de la rédaction était v0.15.0. Pour synchroniser le code local avec cette version, utilisez la commande git checkout :

Vous pouvez confirmer que vous avez la version souhaitée "extraite" en lançant la commande git status :

Le code source inclut la documentation, qui peut être trouvée dans un certain nombre de fichiers. Passez en revue la documentation principale située dans README.md dans le répertoire bitcoin en tapant more README.md à l’invite et en utilisant la barre d’espace pour passer à la page suivante. Dans ce chapitre, nous allons construire le client Bitcoin en ligne de commande, également connu sous le nom de bitcoind sous Linux. Passez en revue les instructions pour compiler le client de ligne de commande bitcoind sur votre plate-forme en tapant more doc/build-unix.md. Des instructions alternatives pour macOS et Windows peuvent être trouvées dans le répertoire doc, comme build-osx.md ou build-windows.md, respectivement.

Examinez attentivement les prérequis de construction, qui se trouvent dans la première partie de la documentation de construction. Ce sont des bibliothèques qui doivent être présentes sur votre système avant de pouvoir commencer à compiler Bitcoin. Si ces conditions préalables sont manquantes, le processus de génération échouera avec une erreur. Si cela se produit parce que vous avez manqué une condition préalable, vous pouvez l’installer, puis reprendre le processus de génération là où vous l’avez laissé. En supposant que les prérequis sont installés, vous démarrez le processus de génération en générant un ensemble de scripts de génération à l’aide du script autogen.sh.

Le script autogen.sh crée un ensemble de scripts de configuration automatique qui interrogeront votre système pour découvrir les paramètres corrects et s’assurer que vous disposez de toutes les bibliothèques nécessaires pour compiler le code. Le plus important d’entre eux est le script configure qui offre un certain nombre d’options différentes pour personnaliser le processus de construction. Tapez ./configure --help pour voir les différentes options:

Le script configure vous permet d’activer ou de désactiver certaines fonctionnalités de bitcoind grâce à l’utilisation des drapeaux --enable-FEATURE et --disable-FEATURE, où FEATURE est remplacé par le nom de la fonctionnalité, comme indiqué dans la sortie d’aide. Dans ce chapitre, nous allons construire le client bitcoind avec toutes les fonctionnalités par défaut. Nous n’utiliserons pas les indicateurs de configuration, mais vous devriez les consulter pour comprendre quelles fonctionnalités facultatives font partie du client. Si vous êtes dans un environnement universitaire, les restrictions du laboratoire informatique peuvent vous obliger à installer des applications dans votre répertoire personnel (par exemple, en utilisant --prefix=$HOME).

Voici quelques options utiles qui remplacent le comportement par défaut du script configure:

Ensuite, exécutez le script configure pour découvrir automatiquement toutes les bibliothèques nécessaires et créer un script de construction personnalisé pour votre système :

Si tout s’est bien passé, la commande configure se terminera par la création des scripts de construction personnalisés qui nous permettront de compiler bitcoind. S’il y a des bibliothèques manquantes ou des erreurs, la commande configure se terminera par une erreur au lieu de créer les scripts de construction. Si une erreur se produit, elle est probablement due à une bibliothèque manquante ou incompatible. Relisez à nouveau la documentation de build et assurez-vous d’installer les prérequis manquants. Ensuite, exécutez à nouveau configure et voyez si cela corrige l’erreur.

Ensuite, vous allez compiler le code source, un processus qui peut prendre jusqu’à une heure, en fonction de la vitesse de votre processeur et de la mémoire disponible. Pendant le processus de compilation, vous devriez voir une sortie toutes les quelques secondes ou toutes les quelques minutes, ou une erreur si quelque chose ne va pas. Si une erreur se produit ou si le processus de compilation est interrompu, il peut être repris à tout moment en tapant à nouveau make. Tapez make pour lancer la compilation de l’application exécutable :

Sur un système rapide avec plusieurs processeurs, vous souhaiterez peut-être définir le nombre de tâches de compilation parallèles. Par exemple, make -j 2 utilisera deux cœurs s’ils sont disponibles. Si tout se passe bien, Bitcoin Core est maintenant compilé. Vous devez exécuter la suite de tests unitaires avec make check pour vous assurer que les bibliothèques liées ne sont pas cassées de manière évidente. La dernière étape consiste à installer les différents exécutables sur votre système à l’aide de la commande make install. Vous serez peut-être invité à saisir votre mot de passe utilisateur, car cette étape nécessite des privilèges d’administrateur:

L’installation par défaut de bitcoind le place dans /usr/local/bin. Vous pouvez confirmer que Bitcoin Core est correctement installé en demandant au système le chemin des exécutables, comme suit:

( "sécurité", "mots de passe")Bitcoin Core recherchera un fichier de configuration dans son répertoire de données à chaque démarrage. Dans cette section, nous examinerons les différentes options de configuration et créerons un fichier de configuration. Pour localiser le fichier de configuration, exécutez bitcoind -printtoconsole dans votre terminal et recherchez les deux premières lignes.

Vous pouvez appuyer sur Ctrl-C pour fermer le nœud une fois que vous avez déterminé l’emplacement du fichier de configuration. Habituellement, le fichier de configuration se trouve dans le répertoire de données .bitcoin sous le répertoire personnel de votre utilisateur. Il n’est pas créé automatiquement, mais vous pouvez créer un fichier de configuration de démarrage en copiant et collant à partir de l’exemple Exemple de configuration d’un nœud à index complet ci-dessous. Vous pouvez créer ou modifier le fichier de configuration dans votre éditeur préféré.

Bitcoin Core propose plus de 100 options de configuration qui modifient le comportement du nœud de réseau, le stockage de la chaîne de blocs et de nombreux autres aspects de son fonctionnement. Pour voir une liste de ces options, exécutez bitcoind --help :

Voici quelques-unes des options les plus importantes que vous pouvez définir dans le fichier de configuration, ou en tant que paramètres de ligne de commande pour bitcoind :

Exemple de configuration d’un nœud à index complet montre comment vous pouvez combiner les options précédentes, avec un nœud entièrement indexé, fonctionnant comme un backend API pour une application bitcoin.

Exemple de configuration d’un système à ressources limitées montre un nœud à ressources limitées s’exécutant sur un serveur plus petit.

Une fois que vous avez modifié le fichier de configuration et défini les options qui représentent le mieux vos besoins, vous pouvez tester bitcoind avec cette configuration. Exécutez Bitcoin Core avec l’option printtoconsole pour s’exécuter au premier plan avec une sortie vers la console :

Vous pouvez appuyer sur Ctrl-C pour interrompre le processus une fois que vous êtes convaincu qu’il charge les paramètres correctement et s’exécute comme prévu.

Pour exécuter Bitcoin Core en arrière-plan en tant que processus, démarrez-le avec l’option daemon, en tant que bitcoind -daemon.

Pour surveiller la progression et l’état d’exécution de votre nœud Bitcoin, utilisez la commande bitcoin-cli getblockchaininfo :

Cela montre un nœud avec une hauteur de chaîne de blocs de 0 blocs et 83999 en-têtes. Le nœud récupère actuellement les en-têtes de bloc de la meilleure chaîne et continue ensuite à télécharger les blocs complets.

Une fois que vous êtes satisfait des options de configuration que vous avez sélectionnées, vous devez ajouter bitcoin aux scripts de démarrage de votre système d’exploitation, afin qu’il s’exécute en continu et au redémarrage du système d’exploitation. Vous trouverez un certain nombre d’exemples de scripts de démarrage pour différents systèmes d’exploitation dans le répertoire source de bitcoin sous contrib/init et un fichier README.md indiquant quel système utilise quel script.("", startref="BNcore03")

Bitcoin Core fournit des rapports d’état sur différents modules via l’interface JSON-RPC. Les commandes les plus importantes incluent getblockchaininfo, getmempoolinfo, getnetworkinfo et getwalletinfo.

La commande getblockchaininfo RPC de Bitcoin a été introduite plus tôt. La commande getnetworkinfo affiche des informations de base sur l’état du nœud de réseau Bitcoin. Utilisez bitcoin-cli pour l’exécuter :

Les données sont renvoyées en JavaScript Object Notation (JSON), un format qui peut facilement être "consommé" par tous les langages de programmation mais qui est également assez lisible par l’homme. Parmi ces données, nous voyons les numéros de version du client logiciel bitcoin (150000) et du protocole Bitcoin (70015). On y voit le nombre actuel de connexions (8) et diverses informations sur le réseau Bitcoin et les paramètres liés à ce client.

Commandes : getrawtransaction, decoderawtransaction

Dans [cup_of_coffee], Alice a acheté une tasse de café au Bob’s Cafe. Sa transaction a été enregistrée sur la chaîne de blocs avec l’identifiant de transaction (txid) 0627052b6f28912f2703066a912ea577f2ce4da4caa5a5fbd8a57286c345c2f2. Utilisons l’API pour récupérer et examiner cette transaction en transmettant l’identifiant de transaction en tant que paramètre :

La commande getrawtransaction renvoie une transaction sérialisée en notation hexadécimale. Pour décoder cela, nous utilisons la commande decoderawtransaction, en passant les données hexadécimales en paramètre. Vous pouvez copier l’hex renvoyé par getrawtransaction et le coller en tant que paramètre dans decoderawtransaction :

Le décodage de la transaction montre tous les composants de cette transaction, y compris les entrées et les sorties de la transaction. Dans ce cas, nous voyons que la transaction qui a crédité notre nouvelle adresse de 15 millibits a utilisé une entrée et généré deux sorties. L’entrée de cette transaction était la sortie d’une transaction précédemment confirmée (indiquée par txid commençant par 7957a35fe). Les deux sorties correspondent au crédit de 15 millibits et une sortie avec retour à l’expéditeur.

Nous pouvons explorer davantage la chaîne de blocs en examinant la transaction précédente référencée par son txid dans cette transaction en utilisant les mêmes commandes (par exemple, getrawtransaction). En sautant d’une transaction à l’autre, nous pouvons suivre une chaîne de transactions à mesure que les pièces sont transmises d’adresse de propriétaire à adresse de propriétaire.

Commandes : getblock, getblockhash

L’exploration de blocs est similaire à l’exploration de transactions. Cependant, les blocs peuvent être référencés soit par la hauteur du bloc (height), soit par le résultat de hachage (ou hash) du bloc. Tout d’abord, trouvons un bloc par sa hauteur. Dans [cup_of_coffee], nous avons vu que la transaction d’Alice était incluse dans le bloc 277316.

Nous utilisons la commande getblockhash, qui prend la hauteur du bloc comme paramètre et renvoie le hachage pour ce bloc :

Maintenant que nous savons dans quel bloc la transaction d’Alice était incluse, nous pouvons interroger ce bloc. Nous utilisons la commande getblock avec le hachage de bloc comme paramètre :

Le bloc contient 419 transactions et la 64ème transaction répertoriée (0627052b...) est le paiement du café d’Alice. L’entrée ` hauteur ` nous indique qu’il s’agit du 277316e bloc de la chaîne de blocs.

L’assistant bitcoin-cli est très utile pour explorer la bibliothèue (API) Bitcoin Core et les fonctions de test. Mais tout l’intérêt d’une interface de programmation d’application est d’accéder aux fonctions par programmation. Dans cette section, nous montrerons comment accéder à Bitcoin Core à partir d’un autre programme.

L’API de Bitcoin Core est une interface JSON-RPC. JSON signifie JavaScript Object Notation et c’est un moyen très pratique de présenter des données que les humains et les programmes peuvent facilement lire. RPC signifie Remote Procedure Call (ou appel de procédure à distance), ce qui signifie que nous appelons des procédures (fonctions) distantes (sur le nœud Bitcoin Core) via un protocole réseau. Dans ce cas, le protocole réseau est HTTP ou HTTPS (pour les connexions cryptées).

Lorsque nous avons utilisé la commande bitcoin-cli pour obtenir de l’aide sur une commande, elle nous a montré un exemple d’utilisation de curl, le client HTTP polyvalent en ligne de commande pour construire l’un de ces appels JSON-RPC :

Cette commande montre que curl soumet une requête HTTP à l’hôte local (127.0.0.1), se connecte au port bitcoin par défaut (8332) et soumet une requête jsonrpc pour la méthode getblockchaininfo en utilisant l’encodage text/plain.

Vous remarquerez peut-être que curl demandera que les informations d’identification soient envoyées avec la demande. Bitcoin Core créera un mot de passe aléatoire à chaque démarrage et le placera dans le répertoire de données sous le nom .cookie. L’assistant bitcoin-cli peut lire ce fichier de mots de passe étant donné le répertoire de données. De même, vous pouvez copier le mot de passe et le transmettre à curl (ou à tout wrapper Bitcoin Core RPC de niveau supérieur). Alternativement, vous pouvez créer un mot de passe statique avec le script d’assistance fourni dans ./share/rpcauth/rpcauth.py dans le répertoire source de Bitcoin Core.

Si vous implémentez un appel JSON-RPC dans votre propre programme, vous pouvez utiliser une bibliothèque HTTP générique pour construire l’appel, similaire à ce qui est montré dans l’exemple curl précédent.

Cependant, il existe des bibliothèques dans la plupart des langages de programmation qui "enveloppent" l’API Bitcoin Core d’une manière qui rend cela beaucoup plus simple. Nous utiliserons la bibliothèque python-bitcoinlib pour simplifier l’accès à l’API. N’oubliez pas que cela nécessite que vous disposiez d’une instance Bitcoin Core en cours d’exécution, qui sera utilisée pour effectuer des appels JSON-RPC.

Le script Python dans Exécution de getblockchaininfo via l’API JSON-RPC de Bitcoin Core effectue un simple appel getblockchaininfo et imprime le paramètre blocks à partir des données renvoyées par Bitcoin Core (nœud complet requis).

Son exécution nous donne le résultat suivant:

Il nous indique que notre nœud local Bitcoin Core a 394075 blocs dans sa chaîne de blocs. Ce n’est pas un résultat spectaculaire, mais cela démontre l’utilisation de base de la bibliothèque en tant qu’interface simplifiée avec l’API JSON-RPC de Bitcoin Core.

Ensuite, utilisons les appels getrawtransaction et decodetransaction pour récupérer les détails du paiement du café d’Alice. Dans Récupérer une transaction et itérer ses sorties, nous récupérons la transaction d’Alice et listons les sorties de la transaction. Pour chaque sortie, nous affichons l’adresse et la valeur du destinataire. Pour rappel, la transaction d’Alice avait une sortie pour payer Bob’s Cafe et une sortie pour rendre la monnaie à Alice.

En exécutant ce code, nous obtenons :

Les deux exemples précédents sont assez simples. Vous n’avez pas vraiment besoin d’un programme pour les exécuter ; vous pouvez tout aussi bien utiliser l’assistant bitcoin-cli. L’exemple suivant, cependant, nécessite plusieurs centaines d’appels RPC et démontre plus clairement l’utilisation d’une interface de programmation.

Dans Récupération d’un bloc et ajout de toutes les sorties de transaction, nous récupérons d’abord le bloc 277316, puis récupérons chacune des 419 transactions en référence à chaque identifiant de transaction. Ensuite, nous parcourons chacune des sorties de la transaction et additionnons la valeur.

En exécutant ce code, nous obtenons :

Notre exemple de code calcule que la valeur totale des transactions dans ce bloc est de 10 322,07722534 BTC (dont 25 BTC de récompense et 0,0909 BTC de frais). Comparez cela au montant rapporté par un site d’exploration de blocs en recherchant le hachage ou la hauteur du bloc. Certains explorateurs de blocs rapportent la valeur totale hors récompense et hors frais. Voyez si vous pouvez repérer la différence.

De nombreuses autres bibliothèques existent dans une variété d’autres langages de programmation et d’autres sont créées tout le temps.