Plus facile à lire avec un fond crème, une teinte, plus de contraste ou un texte plus grand ? Choisissez vos couleurs et votre texte, une fois pour toutes les pages.

Leçon gratuite

Les UTXO et une transaction en regtest

Après cette leçon: Je peux calculer les frais d’une transaction à partir de ses entrées et de ses sorties.

Leçon de 60 min3 commandesLab Bitcoin Script : verrous temporels, multisig, Miniscript et Taproot sur un nœud regtest

Pas de comptes, seulement des sorties

Une banque tient un solde pour chaque client. Bitcoin ne tient aucun solde. Il garde une liste de sorties non dépensées, et chaque transaction en consomme certaines et en crée de nouvelles.

Dans ce module, vous lisez cette liste en regtest, une chaîne privée à l’intérieur de votre labo. Ses pièces n’ont aucune valeur, et vous pouvez en lire chaque octet.

À la fin de cette leçon

Remarque

Je peux calculer les frais d’une transaction à partir de ses entrées et de ses sorties.

Mots-clés

MotCe que ça veut direExemple
Sortieun montant verrouillé par un scriptsortie 0 : 10 pièces pour Bob
UTXOune sortie de transaction pas encore dépensée
Entréeun renvoi vers la sortie qu’une transaction dépenseun txid et un numéro de sortie
Fraisles entrées moins les sorties, gardés par le mineur
Regtestune chaîne de test privée où vous minez vous-même les blocs
Coinbasela première transaction d’un bloc, qui paie la récompense

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Regtest est une chaîne que vous contrôlez

Au démarrage du labo, le nœud a miné 101 blocs et versé chaque récompense à Alice. Une récompense ne se dépense qu’après 100 blocs de plus. Les 101 blocs rendent donc la première dépensable.

Le nœud a ensuite envoyé une transaction qui découpe la récompense du bloc 1 en six, puis il a miné le bloc 102. L’horloge du labo est fixe : vous voyez les mêmes blocs à chaque fois.

Demander au nœud la longueur de la chaîne

Commande
docker exec bitcoind bitcoin-cli getblockcount

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Des sorties, pas des soldes

Chaque sortie a un montant et un script de verrouillage qui dit qui peut la dépenser. Une transaction dépense toujours des sorties entières. Alice a donc dépensé les 50 pièces du bloc 1, et elle s’est rendu la monnaie dans une nouvelle sortie.

Le nœud garde l’ensemble des sorties que personne n’a encore dépensées. Une fois une sortie dépensée, il l’oublie.

Lister les sorties de la transaction du labo

Commande
docker exec bitcoind sh steps/utxo.sh

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Exemple travaillé : ce que le nœud a affiché

SortiePiècesTypeVerrouillée par
Récompense du bloc 1rien d’affichédépenséeDéjà consommée
010witness_v0_keyhashLa clé de Bob
15witness_v0_scripthashUn verrou temporel, leçon 2
25witness_v0_scripthashDeux clés sur trois, leçon 3
35witness_v1_taprootTaproot, leçon 4
45witness_v0_scripthashUne politique Miniscript, leçon 3
519.99999374witness_v0_keyhashLa monnaie d’Alice

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

À vous : calculer des frais

Code: python
# Une entrée et deux sorties, en sats (100 000 000 sats font une pièce).
depense = [20000]
paye = [12000, 7000]

frais = sum(depense) - sum(paye)
print("frais :", frais, "sats")

vsize = 141            # la taille que compte le réseau, en octets virtuels
print("taux :", frais / vsize, "sat/vB")
# Ajoutez une troisième sortie de 500 sats et relancez. Que deviennent les frais ?

Une transaction, ce sont des octets lisibles

Une transaction contient une version, ses entrées, ses sorties, un locktime et, pour les sorties récentes, un témoin. Chaque entrée désigne une transaction antérieure par son txid et un numéro de sortie.

Le txid est un double SHA-256 des octets sans le témoin. Le Python du labo relit les octets envoyés par le nœud et retrouve le même txid.

Lire la transaction en Python

Commande
docker exec jupyter python3 steps/decode.py

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

La taille se compte en octets virtuels

Un bloc a une limite de poids. Un octet de témoin pèse 1, tout autre octet pèse 4, et la taille virtuelle vaut le poids divisé par 4.

La transaction du labo pèse 1249, soit 313 octets virtuels. Elle a reçu 50 pièces et versé 4 999 999 374 sats, ce qui laisse 626 sats de frais. Cela fait 2,0 sats par octet virtuel.

Erreur fréquente

Attention

On croit souvent que la chaîne stocke un solde par adresse. Elle ne stocke que des sorties. Un solde est une somme que calcule un portefeuille, en additionnant les sorties non dépensées qu’il sait déverrouiller.

À propos de ce labo et de sa source: Lab Bitcoin Script : verrous temporels, multisig, Miniscript et Taproot sur un nœud regtest

Vous enseignez à une classe ? Proposez ce module à vos étudiants avec un guide de l'enseignant, des devoirs corrigés et un laboratoire pour chaque étudiant.