¿Te resulta más fácil leer con fondo crema, un tono de color, más contraste o un texto más grande? Elige tus colores y tu texto una sola vez, para todas las páginas.

Lección gratuita

Multifirma, políticas de gasto y Miniscript

Después de esta lección: Puedo comprobar qué firmantes y qué esperas pueden gastar una política.

Lección de 70 min3 comandosLaboratorio de Bitcoin Script y Taproot en regtest

Dos llaves de tres

Un club guarda sus ahorros de forma que dos de sus tres responsables tienen que estar de acuerdo para sacar dinero. Si uno pierde su llave, los otros dos todavía pueden actuar.

Bitcoin puede escribir esa regla en una salida. En esta lección escribes reglas así, las vuelves a leer y dejas que el nodo las compruebe.

Al terminar esta lección

Nota

Puedo comprobar qué firmantes y qué esperas pueden gastar una política.

Palabras clave

PalabraQué significaEjemplo
Multifirmaun candado que necesita varias firmas2 de 3
Umbralcuántas de las claves de la lista tienen que firmar
P2WSHuna salida bloqueada con el hash de un script
Políticaquién puede gastar, escrito para que lo lean personas
Miniscriptuna forma ordenada de escribir Script que las herramientas pueden analizar
Descriptorun texto que dice a una cartera cómo está bloqueada exactamente una salida

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

OP_CHECKMULTISIG cuenta firmas

La salida 2 del laboratorio está bloqueada por "2, tres claves, 3, OP_CHECKMULTISIG". El primer número es el umbral y el segundo dice cuántas claves hay.

El script entero es demasiado largo para una dirección, así que la salida guarda su hash SHA-256. Eso es P2WSH. Quien gasta enseña el script en el testigo, y el nodo comprueba que coincide con el hash antes de ejecutarlo.

Gasta la multifirma con una y dos firmas

Comando
docker exec bitcoind sh steps/multisig.sh

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Ejemplo: lo que dijo el nodo

TestigoPermitidoPor qué
Elemento vacío, firma de Alice, scriptfalseOperation not valid with the current stack size
Elemento vacío, firmas de Alice y Bob, scripttrueDos de tres, en el orden de las claves

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Por qué el testigo empieza vacío

Nota

OP_CHECKMULTISIG saca de la pila un elemento más de los que necesita. Ese error antiguo no se puede arreglar sin partir la red en dos. Por eso todo gasto multifirma empieza con un elemento vacío para que lo saque.

Una política se escribe para personas

Una política dice quién puede gastar, con palabras sencillas. Por ejemplo: "Alice, o Bob después de 144 bloques". Escribir a mano el script que le corresponde es fácil de hacer mal.

Miniscript es una forma de escribir Script con un conjunto pequeño de piezas, para que un programa pueda comprobar qué permite un script. Un compilador convierte una política en Miniscript, y Miniscript se traduce directamente a Script.

Compila dos políticas con el juguete del laboratorio

Comando
docker exec jupyter python3 steps/policy.py

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Ejemplo: política, Miniscript, script

PasoAlice, o Bob después de 144 bloques
Políticaor(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
Tamaño77 bytes
Formas de gastaralice; bob después de 144 bloques

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Deja que el nodo compruebe la misma política

Comando
docker exec bitcoind sh steps/miniscript.sh

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

El nodo y el juguete coinciden

El nodo leyó el Miniscript como un descriptor y calculó bcrt1qss48..., la misma dirección que imprimió el juguete. Así que el juguete construyó el mismo script.

El gasto de Alice se permitió. El de Bob se rechazó como non-BIP68-final, porque la moneda solo tiene unos pocos bloques y su rama espera 144.

Un error frecuente

Advertencia

Mucha gente cree que una dirección enseña las reglas de sus monedas. Una dirección P2WSH es solo un hash. Las reglas aparecen cuando se gastan las monedas, y entonces se ven todas las ramas del script, se usen o no.

Pruébalo: ¿qué forma se abre?

Código: python
# Una política como lista de formas de gastar: quién firma y cuánto hay que esperar.
ways = [
    ({"alice"}, 0),
    ({"bob"}, 144),
]

signed = {"bob"}
age = 50            # bloques desde que se confirmó la moneda

for names, wait in ways:
    ok = names <= signed and age >= wait
    print("necesita", sorted(names), "tras", wait, "bloques:", ok)
# Cambia age a 144, y después signed a {"alice"}. ¿Qué forma se abre cada vez?

Sobre este laboratorio y su código: Laboratorio de Bitcoin Script y Taproot en regtest

¿Enseñas a una clase? Asigna este módulo a tus alumnos con guía del profesor, tareas con corrección automática y un laboratorio para cada alumno.