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
| Mot | Ce que ça veut dire | Exemple |
|---|---|---|
| Multisig | un verrou qui demande plusieurs signatures | 2 sur 3 |
| Seuil | le nombre de clés de la liste qui doivent signer | |
| P2WSH | une sortie verrouillée par le hachage d’un script | |
| Politique | qui peut dépenser, écrit pour être lu par des personnes | |
| Miniscript | une façon structurée d’écrire Script que des outils savent analyser | |
| Descripteur | un 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
docker exec bitcoind sh steps/multisig.shAffiché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émoin | Accepté | Pourquoi |
|---|---|---|
| Élément vide, signature d’Alice, script | false | Operation not valid with the current stack size |
| Élément vide, signatures d’Alice et de Bob, script | true | Deux 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
docker exec jupyter python3 steps/policy.pyAffiché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
| Étape | Alice, ou Bob après 144 blocs |
|---|---|
| Politique | or(pk(alice),and(pk(bob),older(144))) |
| Miniscript | or_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 |
| Taille | 77 octets |
| Façons de dépenser | alice ; 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
docker exec bitcoind sh steps/miniscript.shAffiché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 ?
# 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 ?