Lab Bitcoin Script : verrous temporels, multisig, Miniscript et Taproot sur un nœud regtest

Ce lab donne à chaque étudiant un vrai nœud Bitcoin Core sur une chaîne regtest privée, et un JupyterLab de Python simple à côté. Au démarrage, le nœud mine 101 blocs, envoie une transaction qui découpe la récompense d’un bloc en six sorties (un paiement, un verrou temporel, un multisig 2 sur 3, une sortie Taproot, une politique Miniscript et la monnaie) et mine le bloc 102. De courts scripts montrent ensuite au nœud des dépenses fixes et signées de ces sorties, et il vérifie chacune entièrement : les mêmes réponses à chaque fois, car l’horloge est fixe.

Il est uniquement technique : les pièces de regtest n’existent que dans chaque copie et n’ont aucune valeur, les clés sont des exemples publics, et aucune clé privée n’est dans le lab. Chaque copie n’a aucun accès à internet ni à aucun autre étudiant, le nœud ne se connecte à aucun autre nœud, et rien n’y est téléchargé.

Ce que les étudiants apprennent

Comment une transaction dépense des sorties entières et rend la monnaie, et comment se calculent ses frais et son taux de frais : la transaction du lab paie 626 sats pour 313 octets virtuels. Comment un script s’exécute sur une pile, dans une machine jouet qu’ils peuvent lire, et comment une sortie P2WPKH vérifie une clé et une signature. Comment un verrou temporel CLTV refuse une dépense comme non-final tant que la chaîne n’est pas assez haute, et comment un verrou CSV compte les blocs depuis la confirmation. Comment un multisig 2 sur 3 derrière P2WSH refuse une signature et en accepte deux, et comment une politique de dépense devient du Miniscript puis du Script, vérifié par les descripteurs du nœud. Comment une sortie Taproot se dépense par son chemin par clé en 99 octets virtuels ou par un script caché en 125, et pourquoi cela protège la vie privée. Comment un canal de paiement révoque les anciens états et punit celui qui en diffuse un. Et comment une transaction de remplacement doit payer plus que ce qu’elle chasse, et ce que fait l’épinglage. Il convient aux cours de blockchain, de sécurité et de systèmes distribués ; vérifiez la formulation exacte dans l’unité de votre propre organisme certificateur, aucune n’est citée ici.

Le lancer dans votre navigateur

Le lab démarre deux services. bitcoind est l’image Bitcoin Core d’origine, qui écrit ses réglages et ses scripts, construit la chaîne et laisse un paiement dans le mempool. jupyter écrit btc.py, scriptvm.py, miniscript.py, paychan.py, un notebook de départ et de courts scripts dans son dossier de travail. JupyterLab ne demande aucun jeton, car la porte de la plateforme sait déjà qui l’ouvre. Le terminal à côté du lab n’a ni nœud ni Python : il les atteint avec docker exec bitcoind et docker exec jupyter, suivis de la commande à lancer à l’intérieur.

  1. Ouvrir la page Conteneur. Ouvrez « Créer » dans la barre et choisissez « Lancer un conteneur ». Tout le monde peut ouvrir la page, et le lab Git et le lab SQL se lancent sans compte. Tous les autres labs demandent un compte gratuit : créez-en un, connectez-vous, puis appuyez sur « Démarrer ».
  2. Trouver le lab. La carte « Laboratoires d’exemple » liste tous les exemples. Trouvez Bitcoin Script : verrous temporels, multisig et Taproot en regtest.
  3. Appuyer sur Démarrer. « Démarrer » le lance tel quel, en un clic. « Modifier le fichier d’abord » ouvre le fichier compose pour que vous puissiez le changer avant de démarrer.
  4. L’ouvrir. Appuyez sur « Ouvrir le terminal » et tapez docker exec bitcoind sh steps/cltv.sh pour voir une dépense verrouillée refusée comme non-final à la hauteur 102. Appuyez ensuite sur le lien JupyterLab de la barre du lab pour ouvrir JupyterLab dans votre navigateur et lire miniscript.py dans l’éditeur de fichiers.

Que demander aux étudiants de rendre

Un notebook à eux qui utilise ces fichiers pour répondre à une question qu’ils ont choisie, par exemple quels signataires peuvent dépenser une politique qu’ils ont écrite, de combien une dépense par script est plus grosse qu’une dépense par clé, ou qui reçoit les pièces quand un ancien état de canal est diffusé et que personne ne surveille, téléchargé depuis JupyterLab avec File, Download. Puis une ou deux phrases, avec leurs propres mots, sur ce qu’ils ont trouvé. Rien n’est noté automatiquement : la phrase montre si c’était compris. Pour un travail plus poussé, demandez d’expliquer pourquoi une dépense P2WSH montre chaque branche de son script et une dépense Taproot par script n’en montre qu’une.

Une leçon de base sur ce lab

Bitcoin Script Basics est une petite leçon qui se fait dans ce lab. L’étudiant y lit la chaîne et ses sorties non dépensées, exécute un script sur une pile, tente une dépense verrouillée dans le temps, dépense un multisig 2 sur 3 et une sortie Taproot, et voit un ancien état de canal de paiement puni.

Un compte personnel gratuit la reçoit dans le module Basics, qui se trouve sur « Accueil », et chaque établissement peut la copier depuis le dossier Basics de la Bibliothèque. Elle est volontairement petite : elle montre à un enseignant ce qu’est une leçon qui se fait dans un lab, et le lab fait le reste. Copiez-la dans un module à vous pour la modifier. Le module universitaire Bitcoin Script, Taproot et canaux de paiement en regtest se travaille dans le même lab.

Le code sur GitHub

Le fichier compose n’a pas de Dockerfile : il lance deux images publiques d’origine, Bitcoin Core (bitcoin/bitcoin, MIT) et scipy-notebook des Jupyter Docker Stacks (BSD-3-Clause), chacune figée sur une étiquette et lancée avec son propre compte sans privilèges, le nœud avec 192 Mo de mémoire et JupyterLab avec 512 Mo. Aucune des deux images n’est distribuée par nous. Le fichier écrit chaque script à partir d’un texte fixe au démarrage, l’horloge du nœud est fixe et chaque dépense a été signée à l’avance : chaque copie affiche donc la même chose et rien n’est téléchargé. Les limites sont honnêtes : aucun nœud Lightning ne tourne dans le lab, donc un canal de paiement est un modèle Python de ses règles, et le compilateur de politiques est un petit compilateur à nous dont le nœud vérifie la sortie. Rien n’est conservé quand le lab s’arrête : l’étudiant télécharge son notebook avant.

En faire un travail

Indiquez dans la tâche ce qu’il faut rendre.

  1. Créer le lab. Dans votre module, ajoutez une tâche et choisissez la carte « Lab de conteneurs », puis « Dans un dépôt GitHub ». Indiquez https://github.com/mitsurutech/lab-bitcoin-lab avec la branche main. Le fichier compose par défaut est compose.yaml. Faites d’abord un fork du dépôt si vous voulez le modifier, par exemple pour ajouter une dépense à vous ou une autre politique pour le compilateur jouet.
  2. Publier et l’essayer. « Publier » fige le commit qui vous a été montré : un changement ultérieur dans le dépôt ne modifie donc pas un lab que vous avez déjà proposé. Démarrez d’abord votre propre copie.
  3. Le distribuer. Attribuez-le comme n’importe quelle tâche, avec une échéance si vous le souhaitez, et indiquez dans la tâche ce qu’il faut faire et ce qu’il faut rendre.
  4. Noter ce qui est rendu. Ouvrez la copie d’un étudiant et le travail rendu, notez-le et renvoyez-le avec un motif s’il demande un complément.

Essayer ce lab, et ce qu’il coûte

Un compte personnel gratuit permet de suivre les leçons de base de ce lab, avec chaque mois assez de crédit gratuit pour suivre la plupart des leçons, sans carte. Pour une classe, un établissement a ses 365 premiers jours gratuits pour 50 élèves au plus, puis paie par élève et par an, tous les labs compris et les enseignants gratuits.

Questions fréquentes

Ce sont de vrais bitcoins ?
Non. Regtest est une chaîne de test privée, à l’intérieur du lab de chaque étudiant. Ses pièces ne peuvent pas en sortir et n’ont aucune valeur, et le lab n’a aucun accès à internet. Le module porte sur le fonctionnement du système, jamais sur les prix ni le trading.
Pourquoi le terminal utilise-t-il docker exec bitcoind et docker exec jupyter ?
Le terminal du lab contient quelques clients, mais ni nœud Bitcoin ni Python. docker exec lance une commande dans l’un des conteneurs du lab : bitcoind a le nœud et bitcoin-cli, et jupyter a Python.
Pourquoi chaque lancement affiche-t-il la même chose ?
L’horloge du nœud est fixe et il ne parle à aucun autre nœud, donc les blocs qu’il mine au démarrage ont les mêmes hachages à chaque fois. Les dépenses qu’une leçon montre ont été signées à l’avance et sont seulement présentées au nœud avec testmempoolaccept, qui les vérifie sans rien changer. Le seul script qui mine d’autres blocs change la hauteur, ce que la leçon signale.
Le lab fait-il tourner un nœud Lightning ?
Non. Aucune image qui en fait tourner un hors ligne sur une chaîne regtest, sans rien télécharger, n’est épinglée pour ce lab. La leçon sur les canaux de paiement utilise paychan.py, un court modèle Python des états d’un canal, de la révocation et de la punition, et explique le vrai mécanisme.