Índice
- 1. El problema: una semilla no es un backup completo
- 2. Qué es un descriptor (BIP-380)
- 3. Anatomía de un descriptor multisig
- 4. Qué debe incluir el backup
- 5. Cómo exportarlo
- 6. Cómo restaurar sin el fabricante
- 7. La prueba de recuperación que sí vale
- 8. Errores comunes
- 9. Seguridad y privacidad del descriptor
- 10. Límites y para quién tiene sentido
- Preguntas frecuentes
- Artículos relacionados
- Fuentes y referencias
- En un multisig, las semillas no bastan: sin el descriptor no sabes qué script, qué umbral, qué xpubs ni qué rutas de derivación producen tus direcciones.
- El descriptor es un texto legible que describe la wallet completa, con un checksum de 8 caracteres que detecta errores de copia. No es secreto, pero sí sensible: revela todas tus direcciones.
- Coldcard lo exporta desde
Advanced/Tools > Export Wallet > Descriptory, en multisig, genera incluso el comandoimportdescriptorslisto para Bitcoin Core. - Guarda el descriptor junto a las semillas, en otro soporte si puedes, y prueba la recuperación en un dispositivo limpio antes de confiar en él. Sin esa prueba, el backup es una hipótesis.
Cuando alguien monta un multisig 2-de-3, lo normal es obsesionarse con las tres semillas: grabarlas en acero, repartirlas entre custodios, comprobar que dos reconstruyen la clave. Todo eso es necesario, pero no es suficiente. Hay una cuarta pieza que suele quedarse en el ordenador de quien configuró la wallet y que, si se pierde, puede convertir tres semillas perfectas en un montón de palabras sin direcciones que gastar: el descriptor.
El descriptor es la receta que dice qué script hay que construir, con qué claves, en qué orden y con qué rutas de derivación. Sin él, una wallet nueva puede saber que tiene las llaves, pero no qué cerraduras abrir. Este artículo explica qué es, qué debe incluir tu backup, cómo exportarlo y cómo restaurar un multisig sin depender del fabricante ni del ordenador original.
1. El problema: una semilla no es un backup completo
BIP-39 popularizó la idea de que la semilla es el backup. Para una wallet de una sola firma con una ruta estándar, esa idea funciona razonablemente: la mayoría de wallets prueban las rutas habituales (BIP-44, BIP-49, BIP-84) hasta encontrar fondos. Pero esa comodidad es una convención, no una garantía. El propio BIP-380 lo dice en su motivación: guardar solo las claves privadas es insuficiente, sobre todo desde SegWit, porque una wallet restaurada no sabe qué tipo de script o de dirección debe producir.
En multisig el problema se multiplica. La wallet no es «una clave»: es una política. Necesitas saber cuántas claves hay, cuántas firmas se exigen, cuáles son las claves públicas de los otros firmantes, en qué orden se combinan, qué tipo de script (P2WSH, P2SH-P2WSH, Taproot) y qué rutas de derivación. Nada de eso está en tu semilla. Está en el descriptor, o en la configuración propietaria del software que usaste para crearlo.
Si esa configuración se pierde, tus semillas siguen siendo válidas, pero el software nuevo no sabe qué direcciones vigilar. En el mejor caso, alguien reconstruye la política a mano con los xpubs de los tres dispositivos. En el peor, uno de los firmantes ya no está disponible, el fabricante cambió la app y nadie recuerda si el script era nativo o envuelto. El descriptor elimina esa ambigüedad.
2. Qué es un descriptor (BIP-380)
Un descriptor es una expresión de texto que describe un conjunto de scripts de salida. Se compone de una expresión de script, como wpkh(), sh() o wsh(), y de expresiones de clave que incluyen la clave pública, su huella maestra y la ruta de derivación. El resultado es una receta completa: con esta clave, en esta ruta, construye este script y estas direcciones.
BIP-380 define la sintaxis general, el checksum y el conjunto de caracteres. BIP-381 añade pk(), pkh() y sh(); BIP-382, wpkh() y wsh(); BIP-383, multi() y sortedmulti(); BIP-386, tr() para Taproot; y BIP-389, la notación multipath <0;1> para recibir y cambio en una sola cadena. El estándar figura como Deployed y Bitcoin Core lo implementa desde la versión 0.17.
El descriptor no contiene claves privadas cuando se exporta como «watch-only»: contiene claves públicas extendidas, huellas y rutas. Eso significa que no sirve para gastar, pero sí para reconstruir la wallet, ver saldos y generar direcciones. También significa que no es un secreto en el mismo sentido que una semilla, aunque sí es información sensible: con un xpub se pueden derivar todas las direcciones de una cuenta y, con ellas, reconstruir parte de tu historial.
3. Anatomía de un descriptor multisig
Un descriptor multisig nativo de SegWit tiene esta forma: wsh(sortedmulti(2,[huella/ruta]xpub.../0/*,[huella/ruta]xpub.../0/*,[huella/ruta]xpub.../0/*))#checksum. Cada pieza tiene una función.
| Elemento | Qué indica | Ejemplo |
|---|---|---|
wsh() |
Script witness (P2WSH); también existe sh(wsh(...)) para P2SH-P2WSH |
wsh(...) |
sortedmulti(2, ...) |
Umbral 2 y claves ordenadas lexicográficamente (BIP-67) | sortedmulti(2, ...) |
[0f056943/48h/1h/0h/2h] |
Huella maestra y ruta de derivación hasta la clave | [0f056943/48h/1h/0h/2h] |
xpub.../0/* |
Clave pública extendida, rama externa y comodín de direcciones | xpub.../0/* |
#977ap7x5 |
Checksum de 8 caracteres; no es cifrado, es detección de errores | #977ap7x5 |
La documentación de Coldcard incluye un ejemplo público de descriptor multisig en testnet. Es útil para ver la estructura completa, pero no debe usarse para fondos:
wsh(sortedmulti(2,[0f056943/48h/1h/0h/2h]tpubDF2rnouQaaYrXF4noGTv6rQYmx87cQ4GrUdhpvXkhtChwQPbdGTi8GA88NUaSrwZBwNsTkC9bFkkC8vDyGBVVAQTZ2AS6gs68RQXtXcCvkP/0/*,[7575334b/44h/1h/0h]tpubDCnmwfrYynsdiqpRZ1UNhuVfpbqvxjXgW9JBoAed7nXeGPGUYFTgJDJ83J6QPqyTc6ARq3Tens739SLbjuQmh8NgJmhBQ9gKfgoT8E36Ebt/0/*))#977ap7x5
El prefijo tpub indica testnet; en mainnet será xpub. Las rutas 48h/1h/0h/2h siguen BIP-48 para multisig nativo; en P2SH-P2WSH cambia el último componente. El /0/* significa «rama externa, todas las direcciones». Para el cambio se usa /1/*, o una expresión multipath /<0;1>/* que cubre ambas ramas en una sola cadena.
Ese último detalle importa al restaurar. Si tu backup solo incluye la rama externa, la wallet recuperará las direcciones de recepción pero no verá el cambio. La notación <0;1> de BIP-389 existe precisamente para no tener que guardar dos descriptores casi idénticos.
4. Qué debe incluir el backup
El descriptor es la pieza central, pero no la única. Un backup de multisig completo debería permitir a otra persona reconstruir la wallet sin preguntarte nada. Esta es la lista mínima.
| Dato | Por qué | Dónde va |
|---|---|---|
| Descriptor completo con checksum | Define script, umbral, claves y rutas | Texto + copia impresa o metálica |
| Red (mainnet/testnet) y tipo de script | Un descriptor de testnet no sirve en mainnet; P2WSH no es P2SH-P2WSH | Nota junto al descriptor |
| Rutas de derivación y huellas | Permiten comprobar que cada xpub es la correcta | Dentro del descriptor |
| Semillas o shares (umbral) | Sin claves privadas no hay gasto; el descriptor solo describe | Backup habitual, separado |
| Primera dirección y huella | Prueba de que la restauración reproduce la wallet correcta | Nota de verificación |
| Software y versión | Compatibilidad de formato y de derivación | Nota de contexto |
| Instrucciones para herederos | Un descriptor sin explicación es un jeroglífico | Documento de herencia |
No hace falta guardar el descriptor en cada ubicación donde haya una semilla. De hecho, puede ser mejor separarlo: el descriptor no permite gastar, pero revela privacidad. Si un custodio tiene una share y el descriptor, no puede mover fondos, pero sí conocer el historial de direcciones. La decisión depende de tu modelo de amenaza; lo que no es opcional es tener al menos una copia íntegra y verificada.
5. Cómo exportarlo
La exportación depende de la wallet que hayas usado. En Coldcard, el menú está documentado y genera descriptores de una sola firma y de multisig. Para una wallet individual: Advanced/Tools > Export Wallet > Descriptor, eliges cuenta, formato de dirección y si quieres recibir y cambio en una sola cadena o por separado. El dispositivo puede guardarlo en microSD, disco virtual, NFC o QR, y añade un archivo de firma si lo guardas en tarjeta.
Para multisig: Settings > Multisig Wallets > tu wallet > Descriptors. Desde ahí puedes ver el descriptor, exportarlo o generar directamente el comando importdescriptors para Bitcoin Core. Esa última opción es la más útil para una recuperación de emergencia: no tienes que reconstruir el JSON a mano.
En Bitcoin Core, una wallet con descriptores se puede inspeccionar con listdescriptors. En Sparrow o Nunchuk, el descriptor se muestra en la configuración de la wallet y se puede copiar o exportar; la interfaz exacta cambia entre versiones, así que conviene verificarla en la documentación del proyecto. Lo importante es obtener el descriptor completo, con checksum, y no una versión truncada o sin la rama de cambio.
6. Cómo restaurar sin el fabricante
La prueba de fuego de un backup es restaurarlo en un entorno que no sea el original. Para un multisig, el camino más independiente es Bitcoin Core con una wallet descriptor. El comando importdescriptors acepta un array de descriptores y reconstruye la wallet; el campo timestamp indica desde cuándo escanear la blockchain, range cuántas direcciones derivar, active si es la descriptor activa y internal si es la rama de cambio.
bitcoin-cli importdescriptors '[{"desc":"wsh(sortedmulti(2,...))#checksum","timestamp":"now","active":true,"range":[0,100],"internal":false}]'
El formato exacto lo genera Coldcard al exportar el comando, así que no tienes que escribirlo desde cero. Si usas una copia manual, verifica el checksum antes de importar y comprueba que el descriptor incluye las dos ramas. Un timestamp demasiado reciente puede hacer que la wallet no vea fondos antiguos; "now" solo es adecuado si sabes que la wallet nunca recibió pagos antes de ese momento.
Después de importar, Bitcoin Core derivará las direcciones y buscará UTXOs. Si el descriptor es correcto y el rescan cubre el historial, verás el saldo. Si no aparece nada, no asumas que la wallet está vacía: revisa el checksum, la red, el tipo de script, la ruta y el timestamp. Un error de un solo carácter en el descriptor puede producir una wallet válida pero distinta, y el checksum está precisamente para detectarlo.
7. La prueba de recuperación que sí vale
Importar el descriptor y ver la huella correcta es un buen comienzo, pero no es una prueba completa. La comprobación definitiva es reproducir una dirección conocida y, si el importe lo justifica, hacer un gasto de prueba. Para un multisig, necesitas además reunir el umbral de semillas o shares y firmar con el mismo script que describe el descriptor.
- Anota la primera dirección de recepción antes de guardar la wallet, junto con la huella y la ruta.
- Restaura en un entorno limpio: otro Bitcoin Core, otra instancia de Sparrow o un dispositivo distinto. No reutilices la wallet original.
- Importa el descriptor y comprueba que la primera dirección coincide exactamente, no solo el prefijo.
- Reúne el umbral de semillas e intenta firmar una transacción pequeña hacia una dirección propia. Si el descriptor es incorrecto, la firma no será válida para el script.
- Repite con cada combinación de shares que vayas a conservar, igual que harías con un backup Shamir.
Si no puedes hacer un gasto de prueba, al menos verifica varias direcciones de la rama externa y de cambio, y confirma que el saldo y el historial aparecen. Una huella correcta con direcciones distintas es una señal de alarma: significa que el descriptor describe otra wallet.
8. Errores comunes
La mayoría de los fallos de recuperación de multisig no son criptográficos, son de configuración. Estos son los que más se repiten.
| Error | Qué provoca | Cómo evitarlo |
|---|---|---|
| Guardar solo las semillas | La wallet nueva no conoce el script ni los xpubs | Guardar el descriptor completo con checksum |
| Descriptor sin rama de cambio | Se recuperan las recepciones pero no el vuelto | Usar /<0;1>/* o guardar los dos descriptores |
| Confundir P2WSH con P2SH-P2WSH | Las direcciones no coinciden | Anotar el tipo de script y probar la primera dirección |
| Mezclar xpub de otra cuenta | El descriptor es válido pero apunta a otra wallet | Verificar huellas y rutas una por una |
| Usar testnet en mainnet | Direcciones y saldo invisibles | Comprobar tpub frente a xpub |
| Perder el checksum | El parser puede rechazar el descriptor o aceptar un error | Guardar la cadena completa, con # incluido |
| No probar la recuperación | El fallo aparece cuando ya no hay margen | Probar en limpio antes de mover fondos |
Hay un error conceptual que conviene desterrar: el descriptor no es un backup de las claves. Es un backup de la estructura. Si lo guardas y pierdes las semillas, no podrás gastar. Si guardas las semillas y pierdes el descriptor, podrás gastar solo si reconstruyes la estructura. La seguridad está en tener las dos cosas y saber combinarlas.
9. Seguridad y privacidad del descriptor
El descriptor contiene claves públicas extendidas, huellas y rutas. No permite firmar, pero sí derivar todas las direcciones de la cuenta. Quien lo obtenga puede ver tu saldo y tu historial si consulta la blockchain, y puede intentar correlacionar tus pagos. Por eso no conviene publicarlo, subirlo a un repositorio ni enviarlo por canales inseguros. Si lo guardas cifrado, mejor; si lo imprimes, trátalo como documentación sensible, no como un secreto equiparable a la semilla.
El checksum de 8 caracteres detecta cualquier error de un solo símbolo y la mayoría de errores de dos o tres; en cadenas de hasta 507 caracteres detecta cualquier error de cuatro símbolos, y la probabilidad de que un error aleatorio pase inadvertido es de una entre 240. No es criptografía de autenticación: alguien podría construir un descriptor malicioso con checksum válido. La defensa es verificar la procedencia y comparar la primera dirección con la que tenías anotada.
En herencia, el descriptor es especialmente crítico. Tus herederos pueden tener las semillas y las instrucciones, pero si el descriptor se perdió con tu ordenador, la reconstrucción depende de que los tres xpubs sigan siendo accesibles y de que alguien sepa qué script se usó. Guarda el descriptor con el documento de herencia y explica, en una frase, qué es y para qué sirve. La copia debe estar actualizada: si cambias de wallet o de cuenta, el descriptor antiguo ya no describe la nueva.
10. Límites y para quién tiene sentido
El descriptor no es una varita mágica. No sustituye a las semillas, no permite gastar y no arregla una política mal diseñada. Tampoco es universal: aunque el estándar está desplegado, no todas las wallets lo exportan ni lo importan con la misma comodidad, y las wallets de hardware antiguas pueden no soportarlo. En multisig, la recuperación sin fabricante exige un software que entienda descriptores y, a ser posible, que sepas usar sin la interfaz que creó la wallet.
Merece la pena para cualquier multisig con fondos relevantes, para quien quiera recuperar sin depender de una app concreta y para quien esté montando una estructura de herencia. También para el usuario de una sola firma que quiera un backup más completo que la semilla: un descriptor wpkh() con su ruta y su checksum elimina la ambigüedad de «prueba estas rutas hasta que aparezca el saldo».
No es prioritario para quien tiene una wallet de una sola firma con una ruta estándar y un backup BIP-39 bien probado, ni para quien no piensa salir del ecosistema de una sola app. Pero incluso en ese caso, exportar el descriptor y guardarlo cuesta menos que reconstruir una wallet a ciegas el día que la app cambie.
Preguntas frecuentes
¿El descriptor contiene claves privadas?
El descriptor que se exporta para una wallet de solo lectura contiene claves públicas extendidas, huellas y rutas, no claves privadas. No permite gastar. Si exportas una versión con xprv, entonces sí contiene material privado y debe tratarse como una semilla.
¿Puedo recuperar un multisig solo con las semillas?
A veces, si el software nuevo puede reconstruir la política a partir de las semillas y si todos los firmantes están disponibles. Pero no es lo normal ni lo recomendable: sin el descriptor no sabes el script exacto, el orden de las claves ni las rutas. Guarda el descriptor y prueba la recuperación.
¿El descriptor sirve para una wallet de una sola firma?
Sí. Un descriptor wpkh([huella/84h/0h/0h]xpub.../0/*)#checksum describe una wallet nativa SegWit de una sola firma. Es útil para eliminar la dependencia de las rutas por defecto y para recuperar en Bitcoin Core.
¿Dónde guardo el descriptor?
Junto al backup de las semillas, pero no necesariamente en el mismo lugar. Al menos una copia íntegra, con checksum, en un soporte duradero; otra en el documento de herencia. Si lo guardas cifrado, conserva la clave de descifrado por separado.
¿Qué pasa si el descriptor se corrompe?
El checksum detecta la mayoría de errores de copia. Si no pasa la verificación, no lo importes: recupera otra copia o reconstruye el descriptor desde los xpubs y la configuración original. Un descriptor corrupto puede producir una wallet válida pero distinta.
¿Puedo usar el descriptor en otra marca de hardware wallet?
Depende. El descriptor es estándar, pero la importación y la firma necesitan soporte del fabricante y del software. Bitcoin Core, Sparrow y Nunchuk son buenas opciones para una recuperación independiente; comprueba que entienden el tipo de script y la ruta antes de confiar.
El descriptor es la pieza que convierte un montón de semillas en una wallet recuperable. No sustituye al backup de las claves, pero sin él un multisig depende de la memoria del software que lo creó. Expórtalo, guárdalo con checksum, verifica la primera dirección y haz una prueba de recuperación real. Es un paso pequeño que evita el escenario más caro: tener todas las llaves y no saber qué cerradura abren.
Artículos relacionados
- Multisig 2-de-3 para empresas: recuperación sin custodio
- Herencia criptográfica: protocolo para tus herederos
- Pérdida de shares: plan de contingencia
- Shamir Backup SLIP-39: guía del esquema 2-de-3
- Coldcard Mk4: anatomía de la firma air-gapped
Fuentes y referencias
- BIP-380 — Output Script Descriptors General Operation (Deployed): https://github.com/bitcoin/bips/blob/master/bip-0380.mediawiki
- BIP-383 — Multisig Output Script Descriptors (multi y sortedmulti): https://github.com/bitcoin/bips/blob/master/bip-0383.mediawiki
- BIP-389 — Multipath Descriptor Key Expressions (Draft): https://github.com/bitcoin/bips/blob/master/bip-0389.mediawiki
- BIP-32 — Hierarchical Deterministic Wallets: https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki
- BIP-67 — Deterministic Pay-to-script-hash multi-signature addresses through public key sorting: https://github.com/bitcoin/bips/blob/master/bip-0067.mediawiki
- Bitcoin Core — importdescriptors RPC: https://developer.bitcoin.org/reference/rpc/importdescriptors.html
- Bitcoin Core — getdescriptorinfo RPC: https://developer.bitcoin.org/reference/rpc/getdescriptorinfo.html
- Bitcoin Core — deriveaddresses RPC: https://developer.bitcoin.org/reference/rpc/deriveaddresses.html
- Bitcoin Core — documentación de descriptores: https://github.com/bitcoin/bitcoin/blob/master/doc/descriptors.md
- COLDCARD Documentation — Descriptor Export: https://coldcard.com/docs/descriptor_export/
- COLDCARD Documentation — Multisig Features: https://coldcard.com/docs/multisig/
- Sparrow Wallet — documentación oficial: https://sparrowwallet.com/
- Nunchuk — documentación oficial: https://nunchuk.io/
