Taller práctico · Bitcoin air-gapped

Monta y usa tu
SeedSigner

Una guía para construir, entender y firmar transacciones con un monedero hardware DIY que cuesta unos 50 € y nunca toca internet.

⏱ 60–90 min 🎯 Nivel principiante 💶 40–50 € en piezas 🔌 100% air-gapped
↓  desliza para empezar  ·  pulsa MODO PRESENTACIÓN abajo para proyectar
01

¿Qué es un SeedSigner?

⏱ 5 min

Un dispositivo air-gapped (aislado de la red) que genera tus claves de Bitcoin y firma transacciones, comunicándose con el mundo exterior solo mediante códigos QR. Las claves privadas nunca salen del aparato.

🔑

Genera la semilla

Crea una frase de 12–24 palabras (BIP39) donde vive tu Bitcoin. Opcionalmente añade una passphrase.

🧠

Es amnésico

No guarda una copia de tus palabras 24/7. Al apagarlo, olvida todo. Esa es su gran diferencia frente a un hardware wallet clásico.

📷

Solo QR

Recibe y envía datos por la cámara y la pantalla. Sin WiFi, sin Bluetooth, sin datos por USB (el USB es solo corriente).

La idea clave Tu semilla nunca toca un dispositivo conectado a internet. El SeedSigner firma "a ciegas" de la red, y solo expone la transacción ya firmada y tu xpub (que es pública y segura de compartir).

¿Y Sparrow Wallet?

SeedSigner por sí solo no ve la blockchain. Necesita un compañero: un monedero software que actúe como observador (watch-only), vea tu saldo, prepare las transacciones y las difunda — pero sin conocer jamás tus claves privadas. Es el dúo perfecto: el cerebro online y la caja fuerte offline.

SeedSigner es compatible con varios: Sparrow, BlueWallet, Nunchuk, Specter o Keeper. En este taller usaremos Sparrow (escritorio, muy visual y didáctico), pero el flujo es idéntico en los demás: lo aprendido aquí se traslada tal cual a BlueWallet o Nunchuk en el móvil.

02

Glosario rápido

para novatos

Si alguno de estos términos te suena a chino, este es tu sitio. Despliega para entenderlos en una frase. (En el resto de la guía aparecen subrayados.)

def Air-gapped ▸
Un dispositivo físicamente aislado de cualquier red (internet, WiFi, Bluetooth, USB de datos). La única forma de entrar y salir información es por la cámara y la pantalla mediante QR.
def Seed / Semilla mnemónica ▸
Las 12 o 24 palabras (estándar BIP39) que son el respaldo maestro de tu monedero. Quien tiene las palabras, tiene el dinero. Se guardan en papel o metal, nunca en digital.
def Passphrase ▸
Una palabra o frase extra y opcional que se suma a la seed (la "palabra 25"). Crea un monedero totalmente distinto. Aporta seguridad pero si la olvidas, pierdes el acceso. En la demo la omitiremos por simplicidad.
def xpub (clave pública extendida) ▸
Una clave pública de la que cuelgan todas tus direcciones. Sirve para ver el saldo y recibir, pero no para gastar. Es segura de compartir con Sparrow.
def Watch-only (observador) ▸
Un monedero que solo mira: conoce tu xpub y por tanto tu saldo y direcciones, pero no puede firmar ni gastar nada. Sparrow funciona así en este taller.
def PSBT ▸
Partially Signed Bitcoin Transaction: una transacción a medio hacer. Sparrow la crea sin firmar, el SeedSigner le pone la firma, y vuelve a Sparrow para enviarla. Es el "documento" que viaja por QR entre ambos.
def Blockchain / Nodo ▸
La cadena de bloques es el registro público de todas las transacciones de Bitcoin. Sparrow se conecta a ella a través de un servidor Electrum o, idealmente, tu propio nodo, para saber tu saldo.
def Derivación / BIP84 ▸
La "ruta" que define qué tipo de direcciones genera tu monedero. BIP84 (native segwit, direcciones que empiezan por bc1) es el estándar moderno. Clave: SeedSigner y Sparrow deben usar la misma derivación o no se entenderán.
def SeedQR ▸
Una forma de respaldar tu seed como un código QR que solo el SeedSigner sabe leer. Permite restaurar el monedero en segundos escaneándolo. Se imprime en plantillas y se guarda en lugar seguro.
03

Materiales y costes

📦 checklist

Marca lo que vayas consiguiendo. El hardware completo ronda los 40–50 €. Para el taller / demo no necesitas comprar nada: lo emulamos (sección 11, al final).

0 / 6
0%
✓
Raspberry Pi Zero 1.3
La 1.3 es la ideal: no tiene WiFi ni Bluetooth, así que es air-gapped de fábrica. La Zero W/WH también sirve (sin soldar) pero conviene anular su WiFi. Sirve cualquier Pi 2/3/4 para probar, pero pierden el aislamiento.
~14–21 €
✓
Pantalla HAT 1,3" 240×240 IPS
Waveshare con controlador ST7789, joystick y 3 pulsadores. Debe ser la versión 240×240, no otra resolución.
~21 €
✓
Minicámara para Pi Zero (5MPx)
Módulo "estilo Zero" con sensor OV5647, 1080p. Al estar diseñada para la Pi Zero, ya trae el cable plano correcto: no necesitas adaptador FFC aparte. Conector CSI.
~9 €
✓
MicroSD 8–32 GB
Cualquier tarjeta pequeña sirve. No hace falta formatearla antes (se flashea).
~5 €
✓
Pines GPIO + carcasa (opcional)
Si la Pi no trae pines, hay que soldarlos (o pedir la versión "WH" con pines puestos). Carcasa imprimible en 3D (OpenPill / OrangePill).
DIY
✓
Respaldo de la seed
Papel + plantilla QR, o mejor en metal (arandelas, placas) a prueba de fuego/agua.
papel/metal

Dónde comprarlo

Para la charla El kit completo cabe en una mano y cuesta menos que casi cualquier hardware wallet comercial. Buen momento para pasar las piezas entre el público.

Las piezas: sin conectar y montadas

Ilustración de referencia de los tres componentes principales y cómo encajan. Debajo tienes huecos para tus propias fotos reales del taller.

Raspberry Pi Zero + Pantalla 1,3" + Cámara + cable → Montado

Ilustración esquemática · las proporciones reales varían según el modelo

📷FOTO: componentes sin conectarLas 3 piezas por separado sobre la mesa⬆ clic o arrastra una foto
📷FOTO: Arrancar módulo wifi/BluetoothDispositivo ensamblado y encendido⬆ clic o arrastra una foto

El montaje, paso a paso

Una vez vistos los componentes por separado, así es como se ensamblan. Tres fotos clave para guiar esta parte de la charla — pon aquí tus capturas reales del proceso.

📷FOTO 1: pines + cámaraSoldar/encajar pines GPIO y conectar el cable plano de la cámara⬆ clic o arrastra una foto
📷FOTO 2: pantalla encajadaPantalla Waveshare sobre los pines de la Pi⬆ clic o arrastra una foto
📷FOTO 3: en la carcasaTodo recogido en la OpenPill / OrangePill⬆ clic o arrastra una foto
Recursos de montaje Guías visuales paso a paso: EstudioBitcoin · SeedSigner Hardware. La cámara se inserta abriendo con cuidado la pestaña negra del conector de la Pi; los pines GPIO van con soldador o con la versión "WH" ya soldada.
04

Software: descargar, verificar y flashear

⏱ 15 min

Aquí preparamos la microSD con la imagen oficial. Ojo: no se "copian archivos", se flashea la imagen con una herramienta. Y antes, se verifica que sea auténtica.

Corrección importante para principiantes La imagen .img de SeedSigner no se copia a una tarjeta FAT32. Se graba (flashea) con Balena Etcher o Raspberry Pi Imager, que escriben el sistema completo a bajo nivel. La tarjeta no necesita formateo previo.

Descarga la imagen oficial

Ve a la web o al GitHub oficial y descarga el archivo pi0.img (para Pi Zero 1.3 y Zero W), junto con los 2 archivos de verificación: el manifiesto y su firma.

seedsigner.com/software ↗  ·  GitHub Releases ↗

Verifica la descarga — el paso que casi nadie hace y todos deberían

Comprobar que la imagen es auténtica evita instalar una versión manipulada que podría robarte los fondos. Hay dos formas; para principiantes, la de Sparrow es la más sencilla y no toca la terminal.

Sparrow Wallet trae una herramienta "Verify Download" que sirve para verificar cualquier software firmado, no solo Sparrow — incluida la imagen de SeedSigner. Es arrastrar y soltar.

Descarga 3 archivos en la misma carpeta

De la página de releases de SeedSigner: la imagen (.img o .zip), el manifiesto (...sha256) y la firma del manifiesto (...sha256.asc o .sig). Los tres juntos, por ejemplo en Descargas.

Abre Sparrow

Necesitas Sparrow 1.8.3 o superior (ya verificado e instalado).

Tools → Verify Download

En el menú Tools → Verify Download. O directamente arrastra cualquiera de los 3 archivos sobre la ventana de Sparrow y el diálogo se abre solo.

Lee el resultado

Sparrow comprueba el hash y la firma y te dice si todo cuadra. Verás un mensaje de verificación correcta con el firmante. Si sale en rojo o "failed", no flashees esa imagen.

📷FOTO: diálogo "Verify Download" de Sparrow en verdeCaptura del resultado correcto⬆ clic o arrastra una foto

Método clásico por terminal. Debe aparecer "Good signature" y el hash debe coincidir. Hazlo antes de flashear.

verificación GPG · terminal
# importar la clave del desarrollador (primera vez)
gpg --keyserver hkps://keys.openpgp.org --recv-keys <ID_CLAVE>

# verificar la firma del manifiesto
gpg --verify seedsigner.<version>.sha256.sig seedsigner.<version>.sha256

# comprobar el hash de la imagen
sha256sum --check seedsigner.<version>.sha256
En WindowsSin terminal Unix, usa CertUtil -hashfile imagen.img SHA256 y compara a mano el hash con el del archivo .SHA256. Por eso el método de Sparrow es más cómodo.
Si la verificación fallaNo flashees la imagen. Bórrala y vuelve a descargarla de una fuente oficial. La verificación solo es fiable si la clave pública pertenece de verdad al proyecto: contrástala con varias fuentes.

Flashea la microSD

Instala Balena Etcher (recomendado para novatos) o Raspberry Pi Imager. Abre el programa → Flash from file → selecciona la imagen (puede ir comprimida en .zip) → elige tu microSD como destino → Flash!

Balena Etcher ↗  ·  Raspberry Pi Imager ↗

Monta el hardware e inserta la SD

Coloca pantalla, cámara y placa en la carcasa según el kit. Inserta la microSD ya flasheada, conecta la corriente por USB y espera ~45 segundos a que aparezca el logo.

Guía visual de montaje ↗

Comprueba que arranca

Verifica la versión de firmware en pantalla y navega por el menú para confirmar que todo responde.

Truco Guarda una segunda microSD con una versión anterior. Si una actualización trae fallos, vuelves atrás en segundos. Las actualizaciones se hacen reflasheando la tarjeta, nunca por internet (OTA).
06

Generar la seed y obtener el xpub

⏱ 15 min

Todo esto ocurre air-gapped, dentro del SeedSigner (o del emulador en la demo).

Crear monedero nuevo

En el menú elige "Create new wallet" / "Generate seed".

Generar la frase mnemónica

El dispositivo genera tu seed (BIP39). Anótala en papel o metal y confírmala palabra por palabra. Este respaldo es tu dinero — guárdalo offline.

Elegir el tipo de monedero

Single-sig (una sola firma) con derivación BIP84 (m/84'/0'/0', native segwit). Para practicar puedes usar testnet (bitcoin de prueba sin valor).

Passphrase (opcional)

Puedes añadir una passphrase. En la demo la omitimos para no complicar. Si la usas, documenta bien cómo recuperarla.

Respaldar como SeedQR (opcional)

Exporta la frase a una plantilla SeedQR para poder restaurar el monedero escaneando un QR.

Exportar el xpub a Sparrow

Conecta el SeedSigner a un monedero software (Sparrow): el dispositivo mostrará tu xpub como un QR grande para escanear. El xpub es público y seguro de compartir.

📷FOTO: pantalla "generate seed"El SeedSigner mostrando las palabras / dados⬆ clic o arrastra una foto
📷FOTO: QR del xpub en pantallaEl código grande listo para escanear⬆ clic o arrastra una foto
Seguridad La seed nunca se expone en digital. El xpub sí se comparte: sirve solo para ver y recibir, jamás para gastar.
💡 Para hacerlo tú Si quieres reproducir todos estos pasos en pantalla grande sin el aparato físico, al final de la guía tienes la Demo con máquina virtual (sección 11), plegada como complemento opcional.
07

Crear el monedero watch-only en Sparrow

⏱ 10 min

Sparrow se queda con tu xpub y desde ahí ve tu saldo y prepara transacciones, sin poder gastar nada.

RecuerdaUsamos Sparrow por ser muy visual, pero BlueWallet o Nunchuk (ambos también en móvil) hacen exactamente lo mismo con SeedSigner. Si prefieres el móvil, el concepto es idéntico: importar el xpub y luego firmar por QR.

Nuevo monedero

Abre Sparrow → File → New Wallet. Ponle nombre (ej. "Taller Watch-Only").

Tipo de keystore

En Keystore elige importar desde "Airgapped Hardware Wallet" → SeedSigner, o pega/escanea el xpub / Extended Public Key.

Escanear el QR

Escanea con la cámara del ordenador el QR del xpub que muestra el SeedSigner (o pégalo).

Coincidir la derivación

El paso crítico: la derivación en Sparrow (ej. BIP84 m/84'/0'/0') debe ser la misma que generaste en SeedSigner. Ajusta también la red (mainnet o testnet).

Conectar a un servidor

Preferences → Server: conecta a un servidor Electrum / Esplora público o, idealmente, a tu propio nodo. Sincroniza.

Verificar saldo

Sparrow mostrará saldo y UTXOs (en una cuenta nueva, vacíos). Ya tienes el monedero observador listo.

📷FOTO: pantalla "New Wallet" de SparrowTipo de keystore / SeedSigner⬆ clic o arrastra una foto
📷FOTO: escaneando el QR del xpubCámara del PC leyendo el SeedSigner⬆ clic o arrastra una foto
⬇️

Descargar Sparrow

Desde sparrowwallet.com/download — y verifícalo antes de instalar (arrastra los 3 archivos al diálogo Tools → Verify Download, igual que con SeedSigner).

08

El flujo de firma (PSBT)

⏱ 20–30 min

El corazón del taller. Pulsa cada paso para ver el detalle. Observa cómo la clave privada nunca sale del SeedSigner: solo viajan QR.

SPARROW

1 · Crear transacción

Introduce destino y cantidad. Selecciona las comisiones.

▾
SPARROW

2 · Exportar PSBT

Genera la PSBT sin firmar y muéstrala como QR animado.

▾
SEEDSIGNER

3 · Escanear y revisar

Escanea el QR. Verifica en pantalla inputs, salidas, importe y comisión.

▾
SEEDSIGNER

4 · Firmar

Confirma. El dispositivo firma y devuelve la PSBT firmada como QR.

▾
SPARROW

5 · Importar firma

Escanea el QR firmado. Sparrow comprueba que la firma es válida.

▾
SPARROW

6 · Broadcast

Envía la transacción a la red. ¡Hecho!

▾
En Sparrow: ve a Send, pega la dirección de destino y el importe. Elige la comisión (sat/vB) según la prisa. Pulsa Create Transaction.
En Sparrow: pulsa "Show QR" / Export PSBT. Si la transacción es grande, el QR se anima en varias partes. Alternativa: guardar el archivo .psbt en la microSD.
En SeedSigner: menú "Scan" → apunta la cámara al QR animado de Sparrow. El dispositivo muestra los detalles: a dónde va, cuánto, y la comisión. Verifica visualmente que todo coincide antes de firmar.
En SeedSigner: si todo es correcto, confirma para firmar. La clave privada firma dentro del dispositivo y nunca sale. Te muestra la PSBT ya firmada como un nuevo QR.
En Sparrow: vuelve a escanear, ahora el QR firmado del SeedSigner. Sparrow detecta la firma y marca la transacción como completa / válida.
En Sparrow: pulsa Broadcast Transaction. Se difunde a la red de Bitcoin a través de tu servidor/nodo. Aparecerá como pendiente y luego confirmada.
Demo en directo Haz el flujo completo en testnet o con cantidades minúsculas. Así el público ve el ciclo real sin arriesgar fondos.
09

Buenas prácticas y seguridad

⏱ 10 min
📵

Seed siempre offline

Nunca guardes la seed en algo conectado a internet: ni foto, ni nube, ni notas del móvil.

🗂️

Al menos 2 copias

Respaldos físicos en lugares separados. Metal > papel ante fuego e inundaciones.

🧪

Prueba la recuperación

Antes de confiar fondos grandes, practica restaurar el monedero desde la seed en un entorno seguro.

🔐

Passphrase con cabeza

Úsala solo si entiendes sus implicaciones. Si la pierdes, pierdes el acceso a esos fondos.

✅

Firmware oficial y verificado

Actualiza solo desde fuentes oficiales y verifica las firmas siempre que puedas.

🖥️

Tu propio nodo

Para máxima privacidad y verificación, conecta Sparrow a un nodo propio en vez de a servidores de terceros.

10

Problemas frecuentes

🔧 soluciones
! Sparrow no reconoce el xpub ▸
Revisa la derivación (BIP84 vs otra) y la red (mainnet vs testnet). Deben coincidir exactamente con lo generado en SeedSigner.
! La PSBT es demasiado grande para el QR ▸
Usa la microSD para transferir el archivo .psbt en lugar del QR.
! El SeedSigner no arranca ▸
Comprueba que la microSD esté bien flasheada (no copiada) y bien insertada. Da ~45s al logo. Prueba reflashear o con otra tarjeta.
! Firma inválida ▸
Verifica que el xpub y la derivación del monedero que creó la PSBT coinciden con la seed que está firmando.
! El emulador falla al arrancar ▸
Es un desajuste de versión. Si ves SETTING__DISPLAY_CONFIGURATION, la versión de SeedSigner es demasiado antigua; si ves is_screenshot_generator, es demasiado nueva. Usa la v0.8.6: git clone --branch 0.8.6 ... como en la sección 11.
! Error "externally-managed-environment" al instalar con pip ▸
Ubuntu reciente (PEP 668) no deja instalar en el Python del sistema. Crea un entorno virtual: python3 -m venv --system-site-packages .venv y source .venv/bin/activate, luego instala con pip (sin sudo).
! La webcam no se ve en la VM ▸
Asegúrate de tener el Extension Pack instalado y, con la VM en marcha, selecciónala en Dispositivos → Cámaras web.
11 Demo en vivo con máquina virtual complemento opcional ▸

Para proyectar la demo ante el público sin que 20 personas miren una pantalla diminuta, no usamos el hardware: corremos el emulador de SeedSigner dentro de una máquina virtual Ubuntu. Las flechas del teclado hacen de botones y la webcam del portátil hace de cámara.

Por qué emulador y no virtualizar la Raspberry Emular el chip ARM de la Pi Zero con QEMU no sirve aquí: la cámara CSI no está emulada (no podrías escanear QR) y el kernel actual ni siquiera arranca. El emulador Python está hecho justo para resolver esto: ventana en el escritorio + webcam + teclado.

Descargas necesarias

  • VirtualBox (instalador para Windows hosts)
  • VirtualBox Extension Pack — misma página. Necesario para pasar la webcam a la VM.
  • Ubuntu 22.04 LTS (archivo .iso, ~5 GB)

Instala VirtualBox + Extension Pack

Instala VirtualBox. Luego: Archivo → Preferencias → Extensiones → + y añade el .vbox-extpack.

Crea la VM

Pulsa Nueva. Tipo: Linux, Versión: Ubuntu (64-bit), RAM: 2048 MB mínimo (4096 mejor), disco: 20 GB VDI dinámico. En Sistema → Procesador dale 2 CPUs.

Prepara la webcam

En Configuración → USB: activa Controlador USB 2.0 (EHCI) y añade tu webcam con el icono +.

Instala Ubuntu

En Almacenamiento monta la ISO, arranca la VM, Install Ubuntu, teclado español, borrar disco (el virtual) e instalar, crea tu usuario. ~15 min y reinicia.

Guest Additions (pantalla completa)

Menú Dispositivos → Insertar imagen de Guest Additions y ejecuta:

terminal Ubuntu
sudo apt install build-essential dkms linux-headers-$(uname -r)
sudo /media/$USER/VBox_GAs_*/VBoxLinuxAdditions.run
sudo reboot

Dentro de Ubuntu, abre el terminal (Ctrl+Alt+T)

Ejecuta los bloques en orden. Clonamos SeedSigner en la versión 0.8.6 (la estable actual, compatible con el emulador) y usamos un entorno virtual (venv), obligatorio en Ubuntu reciente por PEP 668.

1 · dependencias del sistema
sudo apt update && sudo apt upgrade -y
sudo apt install -y git python3-full python3-venv python3-tk libzbar0
2 · clonar (v0.8.6) y fusionar
git clone --branch 0.8.6 https://github.com/SeedSigner/seedsigner.git
cd seedsigner/src
git clone https://github.com/enteropositivo/seedsigner-emulator.git
rsync -a seedsigner-emulator/seedsigner ./
3 · crear y activar el entorno virtual
python3 -m venv --system-site-packages .venv
source .venv/bin/activate
4 · dependencias Python (con el venv activo)
pip install --upgrade Pillow setuptools
pip install embit dataclasses qrcode tk opencv-python
pip install git+https://github.com/jreesun/urtypes.git@e0d0db277ec2339650343eaf7b220fffb9233241
pip install git+https://github.com/enteropositivo/pyzbar.git@a52ff0b2e8ff714ba53bbf6461c89d672a304411#egg=pyzbar
5 · arrancar el emulador
python3 main.py
Cada sesión nuevaAntes de lanzar el emulador en un terminal nuevo: cd ~/seedsigner/src y source .venv/bin/activate.
Si la webcam no apareceCon la VM en marcha: menú Dispositivos → Cámaras web y selecciona la tuya. VirtualBox la conecta en caliente.
Solo para demostraciónEl emulador es para enseñar y probar. Nunca lo uses con fondos reales: no es air-gapped.

El teclado hace de botones del HAT

Navegación

  • ← → ↑ ↓  mover por los menús
  • Enter  confirmar / seleccionar
  • 1 · 2 · 3  botones laterales del HAT

Cámara

  • La webcam del portátil hace de cámara CSI
  • Escanea QR de PSBT y direcciones igual que el aparato real
  • Si hay varias cámaras, sale un desplegable para elegir
Para proyectarPon la ventana del emulador a pantalla completa dentro de Ubuntu (es redimensionable) y proyecta esa pantalla. Así todo el público ve los menús a tamaño grande.
Copiado ✓