Rovereto, sábado 21 de noviembre de 2026 · Año XIII, n.º 325 Bloque 976951
es
Bitcoin Valley
SumarioCerrar

Crónicas del valle donde se paga en bitcoin.

Aprende · Para quien programa

Sobre cerrado

Seis ejercicios del curso para desarrolladores de 2018, rehechos para hoy. Las soluciones ya están en la página, cerradas en un hash: solo se abren con la respuesta correcta.

En el otoño de 2018, mientras en Mani al Cielo se pagaba con Lightning, el equipo de desarrollo de inbitcoin escribía las lecciones del curso para desarrolladores bcademy: cuadernos Jupyter, uno por tema, con el código por completar.1 Quedan veintiuno, de la tercera a la sexta semana. Hemos tomado las preguntas que siguen valiendo y las hemos rehecho para 2026, con los números reales de aquellas lecciones donde se podía.

Hace falta Python 3.9 o más reciente, y nada más: no hay nada que instalar, todo con la biblioteca estándar. Cada ejercicio pide una hora, más o menos.

Cómo funciona el sobre

Debajo de cada ejercicio hay un sobre: una línea de 64 caracteres, el hash SHA-256 de busta-chiusa/ seguido del número del ejercicio, una barra y la respuesta. Escribes tu respuesta y el móvil calcula el hash: si sale igual que el sobre, has encontrado la respuesta, y nadie te la ha dicho. Ni siquiera esta página la conoce.

La idea no es nuestra: una lección de 2018 ya daba las soluciones así, como hashes por comparar. Es un compromiso criptográfico (commitment), y atraviesa todo el curso: los árboles de Merkle, las facturas de Lightning, los sellos de RGB. El sexto ejercicio enseña a abrir los sobres sin resolver nada, y ahí se entiende cuándo aguantan.

Para comprobarlo desde el terminal, con la respuesta escrita en minúsculas y sin espacios:

printf 'busta-chiusa/3/%s' "$RISPOSTA" | sha256sum

1. El hash hecho a mano

El programa del curso empezaba así: «crea tu propia función de hash». Como ejemplo daba esta, que multiplica un número primo por cada letra, elevado a una potencia que depende de la letra y de la posición:

def basic_hash(in_str):
    m = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, 73, 79, 83, 89, 97, 101]
    v = 1
    base = ord('a')
    MAX = 2 ** 64
    for i, c in enumerate(in_str):
        idx = ord(c) - base + 1
        assert 0 <= idx <= 25
        v *= m[idx] ** (idx + i)
    return v % MAX

Prueba basic_hash('moneta') y basic_hash('monete'): una letra de diferencia, números lejanísimos, como debe ser. Luego prueba basic_hash('pizza').

La pregunta: con palabras de solo letras minúsculas, de la a a la y, ¿cuántos resultados distintos puede dar, como máximo, basic_hash? Escribe el número entero. Una ayuda: mira el último bit de los resultados.

Para abrir el sobre hace falta JavaScript.

Después del sobre: qué enseña

Un error de uno en el índice hace entrar el acento grave (`, el único que lleva el 2) y deja fuera la z. Sin el 2, cada palabra es un producto de primos impares, y el resultado es siempre impar: la mitad de los valores posibles no sale nunca. Una función de hash de verdad acepta cualquier secuencia de bytes y usa todos sus bits por igual. Por eso Bitcoin usa SHA-256, y no una función inventada en casa.

2. La prueba en cuatro números

En la cabecera de un bloque no están las transacciones: hay un solo hash, la raíz de un árbol de Merkle construido encima de ellas. La lección de 2018 lo hacía construir a mano, con transacciones falsas de dos bytes y un hash de cuatro caracteres, para que todo cupiera en una hoja:

from hashlib import md5   # MD5 no es seguro: aquí solo sirve para hacer números cortos

def merge(a, b):
    return md5(a + b).digest()[:2]

txids = [bytes.fromhex(x) for x in
         'b930 9162 5a4e 9808 f157 7dc1 754e 1ddb e758 e747 59a1 ce11 0b4d 7181 d68b 3790'.split()]

Escribe make_tree(txids), que devuelve los niveles del árbol, de las hojas a la raíz. Si la raíz sale b63d, es el mismo árbol de 2018. Luego escribe make_proof(index, tree) y check_proof(txid, root, proof): la prueba de que 1ddb está en el bloque son cuatro números, no dieciséis. El testigo enseña cuáles, para tocarlos con el dedo.

La lección preguntaba después: ¿y si las transacciones son impares? Bitcoin empareja la última consigo misma. Prueba con un bloque de siete:

third_block = [bytes.fromhex(x) for x in '1ff1 df9f 491a 952d 4691 0efa 7245'.split()]

La pregunta: ¿cuál es la raíz de third_block, con la regla de Bitcoin? Escribe los cuatro caracteres hexadecimales.

Para abrir el sobre hace falta JavaScript.

Después del sobre: el duplicado

El cuaderno de 2018 terminaba con una pregunta maliciosa: ¿sabes encontrar otra lista de transacciones con la misma raíz? Basta repetir la última, 7245, y la raíz no cambia. Es un fallo real del árbol de Bitcoin, el CVE-2012-2459, y el código de Bitcoin Core lo explica en un comentario que empieza con «WARNING!» y se dirige justo a quien está aprendiendo. La defensa: un bloque con dos transacciones iguales al final de un nivel se descarta como «bad-txns-duplicate», pero su cabecera no se marca como no válida, porque la misma cabecera pertenece también al bloque bueno.6

3. Doce palabras, la última a elegir

Las palabras de recuperación de una wallet siguen el BIP-39: 128 bits aleatorios, más 4 bits de control tomados del SHA-256 de esos 128, hacen 132 bits, es decir, doce grupos de 11. Cada grupo es el número de una palabra en una lista de 2.048.2 La lección de 2018 lo hacía construir paso a paso.

Descarga la lista inglesa oficial, english.txt del repositorio de los BIP, y comprueba que es la correcta: su SHA-256 es 2f5eed53a4727b4bf8880d8f3f199efc90e58503646d9ff8eff3a2ed3b24dbda. Escribe valid_mnemonic(words), que comprueba los bits de control.

Para probar tu código usa solo las frases de prueba públicas del BIP-39, como once veces abandon y luego about. Las palabras de una wallet de verdad no deben meterse nunca en un programa ni en una web: se escriben en papel y nada más.

Una comprobación a medio camino: con hashlib.pbkdf2_hmac("sha512", ...), 2.048 vueltas y la passphrase de prueba TREZOR, la semilla de esa frase empieza por c55257c360c07c72.

La pregunta: las primeras once palabras son abandon. ¿Cuántas palabras de la lista, puestas en el duodécimo lugar, dan una frase válida?

Para abrir el sobre hace falta JavaScript.

Después del sobre: por qué justo esas

La última palabra lleva 7 bits aleatorios y los 4 de control. Los 7 bits se pueden elegir libremente, los 4 no: los decide el SHA-256 de todo lo demás. Una duodécima palabra tomada al azar es correcta una vez de cada dieciséis: por eso, quince veces de cada dieciséis, la wallet se da cuenta de una palabra copiada mal.

4. Por qué dos derivaciones

El cuaderno sobre el BIP-32 de 2018, el de las wallets que de una sola semilla generan un árbol de claves, hacía una pregunta y la dejaba ahí: «¿por qué hay dos algoritmos para crear las claves hijas?». Las claves normales se derivan también solo de la clave pública extendida, el xpub: un registro de los ingresos puede generar todas las direcciones sin poder gastar. Las claves hardened no. Este ejercicio responde con un ataque.

Un compañero ha compartido el xpub de su cuenta de prueba, para llevar un registro de los ingresos. Luego, para un test, ha pegado en un chat la clave privada de la dirección número 5, derivada de forma normal. Son claves de la red de prueba, nacidas de una semilla escrita en esta página: cualquiera puede reconstruirlas, y no hay dinero encima.

tpub = "tpubD9KA96Wig8KzCRAX9ESPbuaNUd9tkUahrq1j9vR86hUEZkovCnvpg6yZoyeJg7kVjVDaYkJob9BXPg7C9S8D5SsTx6sx3AT9hLrgLtrJp3H"
child_5 = 0x9dbb596bfa26edc00c6e4b90f73227cf1279ce54a8efabe400f9c69106d3aff1
N = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141   # el orden de secp256k1

Necesitas dos cosas de la especificación del BIP-32: el formato de una clave extendida (78 bytes en base58 con control: el código de cadena está en los bytes del 13 al 44, la clave pública comprimida del 45 al 77) y la fórmula de la derivación normal. La clave hija es la suma, módulo N, de la clave madre y de un número, IL, que se calcula con HMAC-SHA512 usando el código de cadena como clave, y la clave pública madre más el índice como mensaje. Todo lo que hace falta para calcular IL está en el xpub.

No hace falta hacer cuentas con la curva elíptica. El base58 lo escribes en seis líneas: es un cambio de base, con un alfabeto sin 0, O, I ni l.

La pregunta: ¿cuál es la clave privada madre? Escríbela en hexadecimal, 64 caracteres.

Para abrir el sobre hace falta JavaScript.

Después del sobre: la respuesta de 2018

Con el xpub y una sola clave privada hija normal se remonta a la clave madre, y de ahí a todas las claves de la cuenta. El BIP-32 lo escribe en la sección sobre seguridad: una clave pública extendida debe tratarse con más cuidado que una clave pública cualquiera.3 Por eso las wallets derivan con hardened los niveles altos de la ruta (m/84'/0'/0'), donde el apóstrofo significa índice de 231 en adelante y HMAC calculado con la clave privada, y dejan normales solo los últimos, los de las direcciones. Quien recibe un xpub ve también todos los cobros de esa cuenta.

5. El tiempo relativo

El BIP-68 da un sentido nuevo al campo nSequence de cada input: una espera mínima desde la confirmación del output que se gasta, en bloques o en múltiplos de 512 segundos. El BIP-112 añade la instrucción OP_CHECKSEQUENCEVERIFY, que mete esa espera dentro del script.4 Las reglas: si el bit 31 está encendido, el campo no vale como espera; si está encendido el bit 22, la espera es por tiempo; el valor está en los 16 bits bajos.

El cuaderno de 2018 daba siete números por descifrar:

nsequences = [6, 506353076, 2147483647, 4194310, 4259839, 2147483648, 2822828760]

def decode_nsequence(n_seq):
    """Devuelve ('blocks', n), ('time', segundos) o ('disabled', 0)."""

Escribe la función, y antes de fiarte mira los números en hexadecimal: alguno tiene bits encendidos donde no los esperas.

La pregunta: ¿cuántos bloques tiene que esperar el input con nSequence 506353076?

Para abrir el sobre hace falta JavaScript.

Después del sobre: los bits de reserva

506353076 es 0x1e2e55b4: tiene encendidos varios bits que el BIP-68 no usa, y hay que ignorarlos. Se han dejado libres a propósito: el cuaderno preguntaba si un soft fork podría alargar la espera a diez años, y el BIP-68 responde que esos bits sirven precisamente para aumentar la duración máxima o la precisión, en el futuro. Hoy la espera relativa trabaja en cada canal Lightning: quien cierra un canal por su cuenta espera to_self_delay bloques antes de gastar su parte, y en ese tiempo el otro puede castigar un cierre hecho con un estado antiguo.5

En el 52.º Bitcoin Milano Meetup, el 13 de junio de 2018, el canal se explicaba justo así: Alice tiene en la mano una transacción que vale solo desde el 31 de diciembre, así sabe que recupera su dinero aunque Bob desaparezca, y Bob sabe que tiene que cerrar antes.8

Una nota sobre los sobres de 2018. El cuaderno daba las soluciones de este ejercicio como siete hashes RIPEMD-160, con la función para calcularlos. Rehaciendo las cuentas hoy, con la solución del docente, ninguna se abre: quien las cerró usó una receta algo distinta de la escrita, y no la hemos encontrado. Un sobre vale tanto como la receta publicada con él: por eso aquí la receta está escrita arriba, en la página.

6. Abre el sobre

Este sobre contiene cuatro caracteres hexadecimales, de 0000 a ffff, y ningún ejercicio por resolver.

La pregunta: ¿cuáles son? Tienes la receta, tienes Python, y solo hay 65.536 posibilidades.

Para abrir el sobre hace falta JavaScript.

Con el mismo bucle se abren los sobres 2 y 5 sin hacer el ejercicio, y el 3 y el 1 con algún intento razonado. Solo aguanta el 4, que esconde un número de 256 bits. Un hash esconde solo lo que es difícil de adivinar: si las respuestas posibles son pocas, el sobre es de cristal.

Lightning usa el mismo sobre, en la versión que aguanta. Cada factura contiene un payment_hash, el SHA-256 de 32 bytes aleatorios que solo conoce quien cobra: el preimage. Quien cobra solo cobra revelando el preimage, y quien paga se lo encuentra en la mano como recibo.7 Nadie puede abrir el sobre antes, porque 2256 intentos no los hace nadie. En el mismo meetup de Milán el contrato se contaba como una caja negra de la que salen los bitcoin cuando alguien muestra el preimage de un hash; tres semanas después, en Venecia, Amadori lo explicaba con Alice que tiene que pagar a Eric: Eric crea el secreto y a Alice solo le da el hash.9

La factura de Eric2.000 sat · H = SHA-256(R)H es el sobre cerrado: R solo lo sabe EricIda«paga si muestras R»VueltaR abre los sobres2.003 saten un máximo de 160 bloquesRBob muestra Ry cobra 2.003 sat2.002 saten un máximo de 120 bloquesRCarol muestra Ry cobra 2.002 sat2.001 saten un máximo de 80 bloquesRDiana muestra Ry cobra 2.001 sat2.000 saten un máximo de 40 bloquesREric muestra Ry cobra 2.000 satAlicepaga 2.003 satBobse queda 1 satCarolse queda 1 satDianase queda 1 satEricconoce R
Redibujado a partir de la historia que se contaba en los meetups de 2018, con los precios de hoy. Yendo hacia Eric el plazo se acorta 40 bloques por paso, algo menos de siete horas: quien está en medio siempre tiene tiempo de cobrar de quien lo precede, después de haber visto R.

En 2019 inbitcoin contó adónde lleva la idea, en su aportación a un proyecto de investigación con la Universidad de Calabria: los sellos de un solo uso, «una versión digital de la brida numerada para paquetes», y RGB, nacido en 2015-2016 de las sesiones de investigación de Blockchainlab en Milán, en las que participaba inbitcoin.10 Ahí el sobre está dentro de una transacción bitcoin cualquiera, escondido en una clave pública: no se lee, se demuestra después, a quien hace falta.

Qué ha cambiado desde 2018

El resto del curso hablaba de herramientas que mientras tanto han cambiado. Si retomas los cuadernos, ten presente:

  • BIP-70, el protocolo de pago que el curso hacía usar con un servidor de prueba, fue eliminado de Bitcoin Core en la versión 0.20, en 2020.11 Hoy la solicitud de pago on-chain es el viejo BIP-21, bitcoin:dirección?amount=…, y para Lightning la factura del BOLT 11.
  • Las API de blockchain.info de los ejercicios del programa ya no sirven: tu nodo responde a las mismas preguntas, y un explorador de código abierto como mempool.space se instala en casa.
  • Taproot (BIP-340, 341 y 342) está activo desde el bloque 709.632, noviembre de 2021: firmas Schnorr, que se prueban en la firma.12
  • Las especificaciones de Lightning ya no están en lightning-rfc: el repositorio se llama lightning/bolts.
  • Lighter, el caso de estudio de la sexta semana, está parado desde 2020. Su historia está en la crónica.

Una cosa de 2018, en cambio, vale como era: el ejercicio sobre las unidades de Lightning pedía convertir bitcoin, satoshis y millisatoshis truncando, nunca redondeando. Añadimos un detalle para quien escribe una wallet en el navegador: 21 millones de bitcoin en millisatoshis son 2,1 × 10¹⁸, más allá del límite de los enteros exactos de JavaScript (Number.MAX_SAFE_INTEGER, unos 9 × 10¹⁵). Para los millisatoshis hacen falta BigInt o cadenas de texto.

En clase: cara o cruz en un sobre

Quince minutos, para una clase de informática o para cualquiera que tenga un móvil. Hace falta una moneda de verdad, y este sello:

Para el sello hace falta JavaScript.

  1. Pide un pronóstico. Cada uno elige cara o cruz, la escribe en el sello y copia en la pizarra, junto a su nombre, los primeros ocho caracteres (los rojos).
  2. Lanza la moneda. Quien ha acertado revela su elección; la clase la reescribe en el sello y comprueba que salen los mismos ocho caracteres. Nadie puede cambiar de idea después del lanzamiento.
  3. Haz notar el agujero. Antes del lanzamiento bastaba con escribir «cara» y «cruz» en el sello para conocer el pronóstico de todos: las respuestas posibles eran dos.
  4. Repite con una palabra secreta. Cada uno añade palabras que solo conoce quien las escribe: «cara gato azul 17». Ahora la pizarra no dice nada hasta la revelación.

Ese añadido secreto es el preimage de Lightning, y los 32 bytes aleatorios de una factura hacen el mismo trabajo. Para una hora entera con los estudiantes está En clase; para las soluciones de referencia en Python, escríbenos.

El testigo Todas las lecciones


  1. Curso bcademy, cuadernos Jupyter de las semanas 3-6 (versión para los estudiantes y para el docente) y programa del curso, septiembre-noviembre de 2018; archivo de inbitcoin. Las preguntas y el código de 2018 citados aquí vienen de ahí: la función basic_hash (programa), los dieciséis txid y el bloque de siete (lección 5b), la pregunta sobre el BIP-32 (lección 4c), los siete nSequence (lección 5h), las unidades de Lightning (lección 6c). ↩

  2. BIP-39, leído el 20 de noviembre de 2026. La frase de prueba y la semilla con la passphrase TREZOR son el primero de los vectores de prueba oficiales, en el repositorio de referencia python-mnemonic. ↩

  3. BIP-32, sección «Security», leído el 20 de noviembre de 2026. La clave extendida de este ejercicio nace de la semilla SHA-256 de «bcademy, Rovereto, novembre 2018», ruta m/0', y la clave filtrada es m/0'/5. ↩

  4. BIP-68 y BIP-112, leídos el 20 de noviembre de 2026. Los bits libres están en la sección «Deployment» del BIP-68. ↩

  5. BOLT 3, la salida to_local, leído el 20 de noviembre de 2026. ↩

  6. Bitcoin Core, src/consensus/merkle.cpp, el comentario al principio del archivo, y bad-txns-duplicate en src/validation.cpp, leídos el 20 de noviembre de 2026. ↩

  7. BOLT 11, el campo p: «Preimage of this provides proof of payment». Leído el 20 de noviembre de 2026. ↩

  8. 52.º Bitcoin Milano Meetup, «Layer 2: Lightning Network», 13 de junio de 2018, min. 8; el contrato con el hash en el min. 11. ↩

  9. Amadori en el Bitcoin Venezia Meetup, «Lightning Network è arrivato», 2 de julio de 2018, min. 26. ↩

  10. Marco Amadori y Martino Salvetti, The path to Blockchain Enabled Smart Contracts, aportación de inbitcoin al proyecto de investigación IOT&B con Blockchainlab y la Universidad de Calabria, 3 de diciembre de 2019, actualizada el 24 de febrero de 2020, licencia CC BY-SA 4.0; archivo de inbitcoin. La cita está en la p. 6; el «pequeño paréntesis histórico» sobre el nacimiento de RGB, en las pp. 5-6. ↩

  11. Notas de la versión de Bitcoin Core 0.20.0: «BIP70 support has been fully removed». ↩

  12. Notas de la versión de Bitcoin Core 0.21.1: Taproot activo desde el bloque 709632. ↩