Laboratorio de Bitcoin Script y Taproot en regtest

Este laboratorio da a cada alumno un nodo Bitcoin Core real en una cadena regtest privada, con un JupyterLab de Python sencillo al lado. Al arrancar, el nodo mina 101 bloques, envía una transacción que reparte la recompensa de un bloque en seis salidas (un pago, un bloqueo de tiempo, una multifirma 2 de 3, una salida Taproot, una política de Miniscript y el cambio) y mina el bloque 102. Después, unos scripts cortos enseñan al nodo gastos fijos y ya firmados de esas salidas, y el nodo comprueba cada uno por completo: siempre las mismas respuestas, porque el reloj está fijo.

Es solo técnico: las monedas de regtest existen dentro de cada copia y no tienen valor, las claves son ejemplos públicos y en el laboratorio no hay ninguna clave privada. Cada copia no tiene salida a internet ni acceso a ningún otro alumno, el nodo no se conecta a ningún otro nodo y no se descarga nada en ella.

Qué aprenden los alumnos

Cómo una transacción gasta salidas enteras y devuelve el cambio, y cómo se calculan su comisión y su tasa de comisión: la transacción del laboratorio paga 626 sats por 313 bytes virtuales. Cómo corre un script sobre una pila, en una máquina de juguete que pueden leer, y cómo una salida P2WPKH comprueba una clave y una firma. Cómo un bloqueo de tiempo CLTV rechaza un gasto como non-final hasta que la cadena es lo bastante alta, y cómo un bloqueo CSV cuenta bloques desde la confirmación. Cómo una multifirma 2 de 3 detrás de P2WSH rechaza una firma y acepta dos, y cómo una política de gasto se convierte en Miniscript y luego en Script, comprobado por los descriptores del propio nodo. Cómo se gasta una salida Taproot por su ruta de clave en 99 bytes virtuales o por un script oculto en 125, y por qué eso ayuda a la privacidad. Cómo un canal de pago revoca los estados antiguos y castiga a quien difunde uno. Y cómo una transacción de reemplazo tiene que pagar más que lo que expulsa, y qué hace el pinning. Sirve para cursos de blockchain, seguridad y sistemas distribuidos; consulta en la unidad de tu propio organismo certificador la redacción exacta, aquí no se cita ninguna.

Ejecútalo en tu navegador

El laboratorio inicia dos servicios. bitcoind es la imagen estándar de Bitcoin Core, que escribe su configuración y sus scripts, construye la cadena y deja un pago en la mempool. jupyter escribe btc.py, scriptvm.py, miniscript.py, paychan.py, un cuaderno de inicio y scripts cortos en su carpeta de trabajo. JupyterLab no pide token, porque la puerta de la plataforma ya sabe quién lo abre. El terminal junto al laboratorio no tiene ni nodo ni Python: llega a ellos con docker exec bitcoind y docker exec jupyter, seguido del comando que se ejecuta dentro. Los scripts imprimen siempre lo mismo, en inglés.

  1. Abre la página Contenedor. Abre «Crear» en la barra y elige «Ejecutar un contenedor». Cualquiera puede abrir la página, y el laboratorio de Git y el de SQL se inician sin cuenta. Todos los demás laboratorios necesitan una cuenta gratuita: crea una, inicia sesión y pulsa «Iniciar».
  2. Busca el laboratorio. La tarjeta «Laboratorios de ejemplo» lista todos los ejemplos. Busca Bitcoin Script: bloqueos de tiempo, multifirma y Taproot en regtest.
  3. Pulsa «Iniciar». «Iniciar» lo ejecuta tal cual, con una sola pulsación. «Editar el archivo primero» abre el archivo compose para que lo cambies antes de iniciarlo.
  4. Ábrelo. Pulsa «Abrir terminal» y escribe docker exec bitcoind sh steps/cltv.sh para ver un gasto con bloqueo de tiempo rechazado como non-final a la altura 102. Después pulsa el enlace JupyterLab de la barra del laboratorio para abrir JupyterLab en tu navegador y leer miniscript.py en el editor de archivos.

Qué pedir a los alumnos que entreguen

Un cuaderno propio que use estos archivos para responder a una pregunta que hayan elegido, por ejemplo qué firmantes pueden gastar una política que escribieron, cuánto más grande es un gasto por la ruta de script que uno por la ruta de clave, o quién se lleva las monedas cuando se difunde un estado antiguo de un canal y nadie vigila, descargado desde JupyterLab con File, Download. Y una o dos frases, con sus propias palabras, sobre lo que encontraron. Nada se califica automáticamente: la frase muestra si se entendió. Para un trabajo más avanzado, pide que expliquen por qué un gasto P2WSH enseña todas las ramas de su script y un gasto Taproot por la ruta de script solo enseña una.

Una lección básica sobre este laboratorio

Bitcoin Script Basics es una lección pequeña que se hace en este laboratorio. En ella el alumno lee la cadena y sus salidas no gastadas, corre un script sobre una pila, prueba un gasto con bloqueo de tiempo, gasta una multifirma 2 de 3 y una salida Taproot, y ve cómo se castiga un estado antiguo de un canal de pago.

Las cuentas personales gratuitas la tienen en el módulo Basics, que está en Inicio, y cada centro puede copiarla de la carpeta Basics de la Biblioteca. Es pequeña a propósito: muestra a un docente lo que es una lección que se hace en un laboratorio, y el laboratorio hace el resto. Cópiala en un módulo tuyo para cambiarla. El módulo universitario Bitcoin Script, Taproot y canales de pago en regtest se hace en el mismo laboratorio.

El código en GitHub

El archivo compose no tiene Dockerfile: ejecuta dos imágenes públicas estándar, Bitcoin Core (bitcoin/bitcoin, MIT) y el scipy-notebook de los Jupyter Docker Stacks (BSD-3-Clause), cada una fijada a una etiqueta y con su propia cuenta sin privilegios, el nodo con 192 MB de memoria y JupyterLab con 512 MB. No distribuimos ninguna de las dos imágenes. El archivo escribe cada script a partir de un texto fijo al arrancar, el reloj del nodo está fijo y cada gasto se firmó por adelantado, así que cada copia imprime lo mismo y no se descarga nada. Los límites son honestos: en el laboratorio no corre ningún nodo Lightning, así que un canal de pago es un modelo en Python de sus reglas, y el compilador de políticas es uno diminuto nuestro cuyo resultado comprueba el nodo. No se conserva nada cuando el laboratorio se detiene, así que el alumno descarga antes su cuaderno.

Ponlo como tarea

Indica en la tarea qué entregar.

  1. Crea el laboratorio. En tu módulo añade una tarea y elige la tarjeta «Laboratorio de contenedores», y después «En un repositorio de GitHub». Indica https://github.com/mitsurutech/lab-bitcoin-lab con la rama main. El archivo compose es el predeterminado, compose.yaml. Haz un fork del repositorio antes si quieres modificarlo, por ejemplo para añadir un gasto propio u otra política para el compilador de juguete.
  2. Publica y pruébalo. «Publicar» fija el commit que te mostraron, así que un cambio posterior en el repositorio no altera un laboratorio que ya has asignado. Inicia primero tu propia copia.
  3. Asígnalo. Asígnalo como cualquier tarea, con una fecha de entrega si quieres, e indica en la tarea qué hacer y qué entregar.
  4. Califica lo entregado. Abre la copia de un alumno y el trabajo que ha entregado, califícalo y devuélvelo con un motivo si necesita más.

Prueba este laboratorio, y lo que cuesta

Con una cuenta personal gratuita puedes seguir las lecciones básicas de este laboratorio, con crédito gratuito suficiente cada mes para seguir la mayoría de las lecciones y sin tarjeta. Para una clase, un centro tiene gratis sus primeros 365 días, hasta 50 alumnos, y después paga por alumno y año, con todos los laboratorios incluidos y el profesorado gratis.

Preguntas frecuentes

¿Son bitcoins de verdad?
No. Regtest es una cadena de pruebas privada dentro del laboratorio de cada alumno. Sus monedas no pueden salir de ella ni tienen valor, y el laboratorio no tiene salida a internet. El módulo trata de cómo funciona el sistema, nunca de precios ni de compraventa.
¿Por qué el terminal usa docker exec bitcoind y docker exec jupyter?
El terminal del laboratorio lleva algunos clientes, pero ni un nodo de Bitcoin ni Python. docker exec ejecuta un comando dentro de uno de los contenedores del laboratorio: bitcoind tiene el nodo y bitcoin-cli, y jupyter tiene Python.
¿Por qué cada ejecución imprime lo mismo?
El reloj del nodo está fijo y no habla con ningún otro nodo, así que los bloques que mina al arrancar tienen siempre los mismos hashes. Los gastos que enseña una lección se firmaron por adelantado y solo se muestran al nodo con testmempoolaccept, que los comprueba y no cambia nada. El único script que mina más bloques cambia la altura, y la lección lo dice.
¿El laboratorio ejecuta un nodo Lightning?
No. Para este laboratorio no hay fijada ninguna imagen que lo ejecute sin conexión en una cadena regtest sin descargar nada. La lección de canales de pago usa paychan.py, un modelo corto en Python de los estados, la revocación y el castigo de un canal, y explica el mecanismo real.