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

Multisig, politiques de dépense et Miniscript

Après cette leçon: Je peux vérifier quels signataires et quelles attentes permettent de dépenser une politique.

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

Deux clés sur trois

Une association garde sa caisse ainsi : deux de ses trois responsables doivent être d’accord avant toute sortie d’argent. Si l’un perd sa clé, les deux autres peuvent encore agir.

Bitcoin sait écrire cette règle dans une sortie. Cette leçon écrit des règles de ce genre, les relit et laisse le nœud les vérifier.

À la fin de cette leçon

Remarque

Je peux vérifier quels signataires et quelles attentes permettent de dépenser une politique.

Mots-clés

MotCe que ça veut direExemple
Multisigun verrou qui demande plusieurs signatures2 sur 3
Seuille nombre de clés de la liste qui doivent signer
P2WSHune sortie verrouillée par le hachage d’un script
Politiquequi peut dépenser, écrit pour être lu par des personnes
Miniscriptune façon structurée d’écrire Script que des outils savent analyser
Descripteurun texte qui dit à un portefeuille comment une sortie est verrouillée

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

OP_CHECKMULTISIG compte les signatures

La sortie 2 du labo est verrouillée par « 2, trois clés, 3, OP_CHECKMULTISIG ». Le premier nombre est le seuil, le second le nombre de clés.

Le script entier est trop long pour une adresse, donc la sortie garde son hachage SHA-256. C’est P2WSH. Celui qui dépense montre le script dans le témoin, et le nœud vérifie qu’il correspond au hachage avant de l’exécuter.

Dépenser le multisig avec une, puis deux

Commande
docker exec bitcoind sh steps/multisig.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é : la réponse du nœud

TémoinAcceptéPourquoi
Élément vide, signature d’Alice, scriptfalseOperation not valid with the current stack size
Élément vide, signatures d’Alice et de Bob, scripttrueDeux sur trois, dans l’ordre des clés

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

Pourquoi le témoin commence par un élément vide

Remarque

OP_CHECKMULTISIG retire de la pile un élément de plus que nécessaire. Corriger ce vieux bogue couperait le réseau en deux. Chaque dépense multisig commence donc par un élément vide, qu’il consomme.

Une politique s’écrit pour des personnes

Une politique dit qui peut dépenser, en termes simples. Par exemple : « Alice, ou Bob après 144 blocs ». Écrire le script à la main pour cela est facile à rater.

Miniscript écrit Script à partir d’un petit jeu de pièces, pour qu’un programme puisse vérifier ce qu’un script autorise. Un compilateur transforme une politique en Miniscript, et Miniscript se traduit directement en Script.

Compiler deux politiques avec le jouet du labo

Commande
docker exec jupyter python3 steps/policy.py

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é : politique, Miniscript, script

ÉtapeAlice, ou Bob après 144 blocs
Politiqueor(pk(alice),and(pk(bob),older(144)))
Miniscriptor_d(pk(alice),and_v(v:pk(bob),older(144)))
Script<alice> OP_CHECKSIG OP_IFDUP OP_NOTIF <bob> OP_CHECKSIGVERIFY 144 OP_CHECKSEQUENCEVERIFY OP_ENDIF
Taille77 octets
Façons de dépenseralice ; bob après 144 blocs

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

Faire vérifier la même politique par le nœud

Commande
docker exec bitcoind sh steps/miniscript.sh

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

Le nœud et le jouet sont d’accord

Le nœud a lu le Miniscript comme un descripteur et a calculé bcrt1qss48..., la même adresse que le jouet. Le jouet a donc construit le même script.

La dépense d’Alice a été acceptée. Celle de Bob a été refusée comme non-BIP68-final : la pièce n’a que quelques blocs, et sa branche en attend 144.

Erreur fréquente

Attention

On croit souvent qu’une adresse montre les règles de ses pièces. Une adresse P2WSH n’est qu’un hachage. Les règles apparaissent quand les pièces sont dépensées, et alors chaque branche du script est montrée, utilisée ou non.

À vous : quelle façon s’ouvre ?

Code: python
# Une politique comme liste de façons de dépenser : qui signe, et combien attendre.
facons = [
    ({"alice"}, 0),
    ({"bob"}, 144),
]

signe = {"bob"}
age = 50            # blocs depuis la confirmation de la pièce

for noms, attente in facons:
    ok = noms <= signe and age >= attente
    print("il faut", sorted(noms), "après", attente, "blocs :", ok)
# Mettez age à 144, puis signe à {"alice"}. Quelle façon s’ouvre à chaque fois ?

À 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.