¿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

Fundamentos de Bitcoin Script

La lección completa es gratis e interactiva. Léela aquí, o pulsa Iniciar laboratorio para practicarla de verdad en un laboratorio en vivo, sin cuenta.

Laboratorio de contenedores11 min de lectura7 comandos

Reglas escritas en las propias monedas

Cada moneda de una cadena de Bitcoin lleva un programa diminuto que dice quién puede gastarla. Puede pedir una clave, dos claves cualesquiera de tres, o que no se gaste antes de cierto bloque. Este laboratorio te da una cadena privada llamada regtest, donde minas tú los bloques. Sus monedas no tienen valor, así que puedes probar lo que quieras.

Al terminar esta lección

Nota

Puedo explicar cómo el script de una salida decide quién puede gastarla.

Palabras clave

  • Salida: una cantidad bloqueada por un script.
  • Script: el programa pequeño que bloquea una salida.
  • Pila: un montón donde lo último que entra es lo primero que sale.
  • Bloqueo de tiempo: una regla que hace esperar a una moneda hasta una altura de bloque.
  • Multifirma: un candado que necesita varias firmas.
  • Taproot: una salida que es una sola clave, con scripts de reserva ocultos.

Para empezar: lo que ya sabes

Nota

Responde mentalmente. 1. ¿Qué demuestra una firma digital? 2. ¿Qué le pasa a un hash si cambias una letra del mensaje? 3. ¿Por qué cada bloque guarda el hash del anterior? Respuestas: que quien tiene una clave privada dio su acuerdo; cambia por completo; para que cambiar un bloque antiguo rompa la cadena.

Antes de empezar

Nota

Pulsa Iniciar el laboratorio en la barra de arriba de la lección y espera a que diga que está en marcha. Hay dos contenedores. bitcoind es el nodo y jupyter tiene Python. El terminal llega a ellos con docker exec bitcoind y docker exec jupyter, que ejecutan un comando dentro de cada uno. El enlace JupyterLab abre el cuaderno, en el puerto 8888. Cada botón Ejecutar de abajo escribe su comando en el terminal de tu laboratorio, uno detrás de otro en la misma sesión. Para verlos o escribir los tuyos, pulsa Abrir el terminal (pestaña nueva) en la barra.

Una cadena para ti

Al arrancar el laboratorio, su nodo minó 101 bloques y pagó todas las recompensas a Alice. Una recompensa solo se puede gastar cuando hay 100 bloques más encima. Después envió una transacción y minó el bloque 102, así que el nodo responde 102.

Comando
docker exec bitcoind bitcoin-cli getblockcount

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

Las monedas son salidas, no saldos

El nodo guarda las salidas que nadie ha gastado. La recompensa del bloque 1 está gastada, así que el nodo no imprime nada para ella. La transacción del laboratorio creó seis salidas: 10 monedas para Bob, cuatro de 5 monedas bloqueadas por scripts y 19.99999374 monedas de cambio para Alice. Los 0.00000626 que faltan son la comisión.

Comando
docker exec bitcoind sh steps/utxo.sh

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

Un script corre sobre una pila

Script lee los elementos de izquierda a derecha. Los datos se ponen encima de una pila, y un opcode trabaja con los de arriba. En este juguete, la clave de Alice coincide con el hash del candado y su gasto termina en 1, así que pasa. La clave de Bob da otro hash, así que su gasto se para en OP_EQUALVERIFY.

Comando
docker exec jupyter python3 steps/stack.py

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

Un bloqueo de tiempo hace esperar a una moneda

La salida 1 dice 110 OP_CHECKLOCKTIMEVERIFY: no se puede gastar antes del bloque 111. La cadena está en el 102, así que el nodo rechaza un gasto firmado como non-final. Un gasto que declara un locktime más pequeño falla el script: Locktime requirement not satisfied.

Comando
docker exec bitcoind sh steps/cltv.sh

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

Comprueba

Consejo

¿Qué haría aceptable el gasto bloqueado? Respuesta: más bloques. Cuando la cadena llega a la altura 110, el bloque siguiente es el 111 y el mismo gasto se permite.

Dos firmas de tres

La salida 2 necesita dos firmas cualesquiera de Alice, Bob y Carol. El nodo rechaza un gasto solo con la firma de Alice y permite uno con las de Alice y Bob. Aquí el nodo comprueba firmas reales, y en el laboratorio no hay ninguna clave privada: los gastos se firmaron por adelantado.

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.

Taproot: una clave, scripts ocultos

La salida 3 es Taproot. Alice puede gastarla con una sola firma, la ruta de clave: 99 bytes virtuales. O Bob puede enseñar un script oculto y una prueba corta de que pertenece al árbol: la ruta de script, 125 bytes virtuales. Los scripts que nadie usa nunca se enseñan.

Comando
docker exec bitcoind sh steps/taproot.sh

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

Un canal de pago castiga un estado antiguo

Un canal deja que dos personas se paguen muchas veces con solo dos transacciones en la cadena. Cada pago crea un estado nuevo y anula el anterior. Si Alice difunde un estado antiguo y Bob está vigilando, Bob se lleva los 100000 sats. Esta parte es un modelo en Python: en el laboratorio no corre ningún nodo Lightning. El script imprime en inglés: watching es vigilando y punished es castigada.

Comando
docker exec jupyter python3 steps/cheat.py

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

Un error frecuente

Advertencia

Mucha gente cree que la cadena guarda un saldo para cada persona. Guarda salidas no gastadas, cada una con su propio candado. Un saldo es una suma que calcula una cartera al juntar las salidas que puede desbloquear.

El mismo trabajo en un cuaderno

Abre JupyterLab desde la barra y haz doble clic en start.ipynb. Lee la transacción del laboratorio, corre un script, compila una política y difunde un estado de un canal. Haz clic en una celda y pulsa Mayús e Intro para ejecutarla. La última celda es el sitio de tu propia pregunta.

Comprobación final

Consejo

Responde sin volver atrás. 1. ¿Qué guarda el nodo en lugar de saldos? 2. ¿Por qué se paró el gasto de juguete de Bob? 3. ¿Cuántas firmas necesita la salida 2 de 3? 4. ¿Qué gasto Taproot es más pequeño? Respuestas: salidas no gastadas; su clave no coincidía con el hash; dos; el de la ruta de clave.

Para los docentes

Consejo

Esta lección es un pequeño ejemplo de una lección practicada en un laboratorio: los pasos y los botones Ejecutar son la lección, y el laboratorio es la copia propia de cada alumno. El laboratorio son dos servicios, un nodo Bitcoin Core en regtest y un JupyterLab con Python sencillo, y nada de lo que hay aquí se corrige solo: el alumno entrega un cuaderno propio y una frase sobre lo que mostró. Ideas clave: 1. Las salidas están bloqueadas por scripts. 2. Los bloqueos de tiempo, la multifirma y Taproot son reglas que comprueba un nodo. 3. Un canal guarda los pagos fuera de la cadena. Error frecuente: creer que la cadena guarda saldos. Las monedas de regtest no tienen valor; mantenga la lección en lo técnico, y los scripts imprimen en inglés. Material: el laboratorio y un navegador. Consejo: dibuje seis cajas con candado para las seis salidas antes del primer Ejecutar. Cópiela en su propio módulo y modifíquela, o cree una desde cero con el menú Laboratorio del constructor de lecciones.

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

¿Enseñas a una clase? Asigna estas lecciones a tus estudiantes con calificación y un laboratorio para cada uno.