Rovereto, jueves 19 de noviembre de 2026 · Año XIII, n.º 323
es
Bitcoin Valley
SumarioCerrar

Crónicas del valle donde se paga en bitcoin.

Aprende · Guía · Lección 6

Una clave con dados

De una paper wallet te fías tanto como te fías de quien la ha hecho. Si la haces tú, la confianza se queda en casa. Aquí está cómo, con los dados en lugar del azar del ordenador.

El programa es paperwallet-tools, de Marco Amadori. Es software libre, con licencia GNU GPL versión 3 o posterior, y esta guía sigue la versión 0.1.1. Funciona desde la línea de comandos, está probado en Debian, y hace dos cosas:

  • paperwallet.py crea una dirección bc1q… con su clave privada, y las imprime en una tarjeta del tamaño de una tarjeta de crédito. Fuera está la dirección, para recibir y comprobar el saldo. Dentro, doblada y tapada por un dibujo que la oculta a contraluz, la clave que gasta.
  • paperseed.py crea las palabras de recuperación (la frase semilla), 12 o 24, y las imprime en una tarjeta más grande.

Los dos escriben un PDF para imprimir a doble cara y un archivo .md con los mismos datos.

Por qué los dados

Sin dados la clave nace de 32 bytes aleatorios de /dev/random, y es la opción recomendada. Los dados sirven a quien no quiere fiarse del ordenador para el azar: la aleatoriedad la pones tú, una tirada cada vez. La clave es el SHA-256 de lo que escribes.

Hace falta mucha. Para una clave de 256 bits:

Qué tiras Cada tirada Tiradas para 256 bits
Dado de 16 caras, de 0 a F una cifra hexadecimal, 4 bits 64
Dado de 6 caras unos 2,6 bits 100
Moneda, 1 para cara y 0 para cruz 1 bit 256

Un dado de 16 caras lleva las cifras del 0 al 9 y las letras de la A a la F: cada tirada es una cifra hexadecimal. Son raros, y la tienda de la Valley los vendía. Con el dado de 6 caras escribes los números tal como salen, del 1 al 6. Los espacios y los saltos de línea no cuentan, y tampoco las mayúsculas y minúsculas.

Tus tiradas64 con el dado de 16 caras, 100 con el de 6
SHA-256
→
La clave privadadentro de la tarjeta doblada: quien la tiene, gasta
↓ de la clave, la dirección ↓
La dirección bc1q…fuera de la tarjeta: para recibir y comprobar el saldo
El azar lo pones tú, la clave nace de las tiradas y la dirección de la clave. Fuera solo se lee lo que se puede enseñar.

Tres reglas:

  1. Cada cifra viene de una tirada de verdad. No las escribas a ojo ni las corrijas: las personas no saben ser aleatorias.
  2. Nada de frases inventadas. Una frase o una contraseña pensadas por una persona son una brain wallet: tarde o temprano alguien las adivina y vacía la wallet.
  3. Las tiradas valen tanto como la clave. Las mismas tiradas dan siempre la misma clave. Si las apuntas en una hoja, esa hoja hay que destruirla.

El programa estima cuánto azar hay en lo que escribes. Si está por debajo de los 256 bits te avisa antes de pedir más, y te paras con Ctrl-C. La estimación es optimista: señala los casos seguro demasiado débiles, pero no garantiza los demás. Más tiradas no hacen daño.

El ordenador y la impresora

  • Una máquina desconectada de la red. Mejor un sistema live como Tails, con los archivos en memoria (tmpfs) y la máquina apagada al final.
  • Una impresora USB sin memoria. Una impresora de red, o con una memoria interna, puede guardar una copia de lo que imprime.
  • Nunca fotografíes la tarjeta abierta, las tiradas o la pantalla.

También el programa pone de su parte: al arrancar bloquea los sockets de Python, así ni él ni sus bibliotecas pueden abrir conexiones. Protege de una conexión involuntaria, pero no sustituye a desconectar.

Instalar

Se instala antes, en una máquina que luego desconectarás, o en el sistema live. Hacen falta Python 3 y cinco bibliotecas. En Debian:

sudo apt install libsecp256k1-6 python3-mnemonic python3-pycryptodome python3-reportlab python3-qrcode fonts-open-sans

En Debian 13 trixie la biblioteca se llama libsecp256k1-2: pon esa en lugar de libsecp256k1-6. También se puede instalar con pip, en un entorno virtual, o construir el paquete Debian: las instrucciones están en el README del proyecto.

Descarga el código de la página del proyecto y luego desconecta la red. Los programas se lanzan desde la carpeta del proyecto, como ./paperwallet.py y ./paperseed.py. Si falta una biblioteca se paran y dicen cuál.

La paper wallet, paso a paso

1. Una prueba de impresión

Primero se prueba con una wallet de usar y tirar, en signet, una red de pruebas cuyos satoshis no valen nada: cada panel lo lleva escrito en diagonal.

./paperwallet.py --network signet -o prueba

Imprime prueba.pdf en A4, a escala 100 % (no «ajustar a la página»), a doble cara, girando por el lado largo. Mira la hoja a contraluz: las marcas del centro de los márgenes tienen que coincidir. Luego borra los archivos de prueba.

2. La wallet, con tus tiradas

./paperwallet.py --entropy-prompt -o wallet

El programa pide las tiradas y no las muestra mientras escribes. Salen wallet.pdf y wallet.md. En la pantalla solo aparecen datos públicos, como la dirección: nunca la clave.

También puedes leer las tiradas desde un archivo, con --entropy-file dados.txt: ese archivo es un secreto como la clave, y hay que tenerlo en memoria y borrarlo. Existe también --entropy-string, pero el texto acabaría en el historial de la shell.

Si quieres la clave protegida por una contraseña, añade --bip38: la contraseña se pide dos veces y no se ve nunca. Con las dos copias de serie, una va en claro y otra cifrada.

3. Imprime, corta, dobla

Cada hoja lleva dos tiras: de serie, dos copias de la misma wallet, para guardar en sitios distintos. Corta por las marcas y dobla siguiendo los pasos impresos en el dorso: lado de la clave hacia arriba, luego las líneas 1, 2 y 3 en orden. Fuera quedan la dirección y la portada, dentro la clave, bajo al menos dos capas de papel por lado.

Cierra el borde abierto con cinta adhesiva sobre las dos bandas SEAL, y firma encima de la cinta: si alguien abre la tarjeta, se nota.

4. La comprobación de la dirección

Antes de mandarle dinero, importa la clave desde el archivo .md en una wallet sin conexión y mira que dé la dirección impresa. Con Electrum se arranca así:

electrum --offline

Luego creas una wallet nueva con «Import Bitcoin addresses or private keys» y pegas el texto del QR de la clave, el que empieza por p2wpkh:.

5. Borra, y apaga

Borra wallet.pdf y wallet.md, o mételos en un archivo cifrado. Luego apaga la máquina.

Las palabras de recuperación con dados

Lo mismo vale para las palabras de recuperación:

./paperseed.py --entropy-prompt -o palabras

Salen 24 palabras, o 12 con --words 12, en una tarjeta por hoja A4 que doblada mide 148 × 60 mm.

Dentro están las palabras numeradas y un SeedQR, que leen SeedSigner, Blockstream Jade y BlueWallet, entre otros, más un segundo QR con las palabras en claro para las wallets que no leen el SeedQR, como Electrum. Fuera está la clave pública extendida de la cuenta, la xpub: le basta a una wallet de solo lectura para seguir el saldo, y no gasta.

Con --passphrase añades una passphrase: se pide dos veces, nunca se imprime. La tarjeta solo dice que hace falta.

La prueba de impresión, el corte, el doblado y el sello son los mismos. Luego, como para las palabras en el metal de la lección 6, antes de fiarte prueba a restaurar la wallet desde la tarjeta, con unos pocos satoshis. Al final borra palabras.pdf y palabras.md, o cífralos.

Para quien recibe la tarjeta

Una paper wallet es un buen regalo. Las instrucciones para quien la recibe van impresas dentro; en breve:

  1. Comprueba el saldo solo con la dirección, en una wallet de solo lectura (watch-only). Cómo hacerlo en privado está en la lección 3. Para un vistazo rápido está ericonto: escaneas la dirección y ves el saldo.
  2. Cuando quieras gastar, haz el sweep: abre la tarjeta y, desde un aparato de confianza, pasa todo el saldo a una wallet tuya. En Electrum es Wallet › Private keys › Sweep, y escaneas el QR de la clave. En Sparrow es Tools › Sweep Private Key: elige Native SegWit e introduce la clave sin p2wpkh:.
  3. Todo de una vez. Después del sweep la clave ya no se usa, y no se recibe más dinero en ella.
  4. Destruye todas las copias de la tarjeta.

Para comprobar la dirección y para el sweep recomendamos con gusto dos programas libres y no custodiales: Electrum y Sparrow.

Lo que hace el programa, y lo que te toca a ti

El programa:

  • bloquea los sockets de Python al arrancar;
  • no usa archivos temporales, y escribe el PDF y el .md una sola vez, legibles solo por ti;
  • antes de escribir comprueba su propio trabajo: de la clave a la dirección, de las palabras a la semilla;
  • en la pantalla solo muestra datos públicos.

Te toca a ti lo que el programa no puede controlar: la cola de impresión del sistema, que escribe en disco, las impresoras de red o con memoria, el swap. Y la memoria del ordenador: Python no garantiza borrar de ella los secretos. Por eso lo ideal sigue siendo un sistema live desconectado, una impresora USB sin memoria y la máquina apagada al final.

Vuelve a la lección 6: guardar, y dejar Todas las lecciones