Crackear un Bitcoin Wallet con btcrecover 2026

TL;DR

btcrecover es un script Python de código abierto que hace fuerza bruta sobre una contraseña de Bitcoin wallet o rellena una palabra BIP-39 faltante. Solo funciona cuando ya tienes la mayor parte de la respuesta. Usa el fork mantenido en github.com/3rdIteration/btcrecover. El gurnec/btcrecover original fue abandonado el 2017-12-21. No lo clones. Ejecútalo offline. Nunca compartas tu archivo de wallet. Ningún servicio de recuperación serio pide jamás tu frase semilla. Si tienes menos de la mitad de los caracteres de la contraseña, o menos de 22 de 24 palabras, lee la sección de parada antes de quemar tres fines de semana.

La Llamada Que Siempre Empieza Igual

El hermano de un amigo me escribe a las 23:47 de un domingo. Compró 4 BTC en 2017. Guardó el wallet.dat en un NAS que no ha encendido desde 2019. ¿La contraseña? Algo que pensó que nunca olvidaría. Lleva tres fines de semana adivinando. El último intento bloqueó su distribución de teclado en un bucle infinito. Tiene el archivo. Tiene el 75% de la contraseña. Está en pánico.

Para esto se construyó btcrecover.

Y para esto los estafadores cazan con más eficacia. Antes de los pasos técnicos que siguen, lee este artículo entero, sobre todo la sección de seguridad. La recuperación no es una carrera. El Bitcoin seguirá ahí la semana que viene. La persona que te escribe en Telegram ofreciéndose a recuperarlo por una tarifa anticipada, no.

Una nota sobre la historia de "Bitcoin perdido" más famosa. Stefan Thomas, cuyos 7.002 BTC (reportado por el New York Times en enero de 2021) están bloqueados detrás de una contraseña IronKey, es el ancla emocional de cada artículo de esta categoría. Thomas no usó btcrecover y su caso no es un problema de btcrecover. IronKey se autodestruye después de 10 intentos incorrectos. Los archivos cifrados por software no. La mayoría de recuperaciones son mucho más manejables que la suya.

Qué Hace btcrecover y Dónde Falla

btcrecover es un script Python que ejecuta fuerza bruta guiada contra un archivo de wallet cifrado o una frase semilla parcial. No es magia. Es un motor de búsqueda estructurado que prueba variantes plausibles de los datos que ya tienes.

Dos caminos cubren a la mayoría de lectores. El camino A es la recuperación de contraseña en un archivo de wallet cifrado. Un wallet.dat de Bitcoin Core, un wallet de Electrum, un JSON cifrado exportado de Blockchain.info, Bitpay, MultiBit, o un keystore de MetaMask o Trust Wallet. Le alimentas a btcrecover una lista de fragmentos recordados y los permuta con errores tipográficos opcionales hasta que uno descifre el archivo. El camino B es la recuperación de frase semilla con una o dos palabras faltantes. El script complementario seedrecover.py prueba cada palabra BIP-39 en la ranura desconocida contra la lista de direcciones que le proporciones, o contra una instantánea AddressDB de la cadena.

Una advertencia sobre el formato antes de empezar. El camino wallet.dat de btcrecover apunta a wallets heredados de Bitcoin Core en formato Berkeley DB. Los wallets descriptor creados con Bitcoin Core 23 o posterior usan sqlite (predeterminado desde 2022) y un flujo de cifrado distinto. btcrecover no soporta actualmente wallets descriptor sqlite. Confirma tu formato con bitcoin-cli getwalletinfo antes de empezar.

Ambos caminos necesitan algo que ya sabes. Un archivo cifrado más un recuerdo fragmentario, o una semilla casi completa. btcrecover no puede ayudar si todo lo que tienes es una dirección (el problema del logaritmo discreto no es resoluble en hardware de consumidor en ninguna vida humana), o un archivo de wallet que no puedes localizar (usa herramientas de recuperación de archivos como Recuva o PhotoRec), o una frase semilla que anotaste "en algún lugar" (la semilla es el wallet; tienes un problema de búsqueda, no de fuerza bruta), o una semilla de 12 palabras con tres o más palabras faltantes (8.500 millones de combinaciones multiplicadas por el coste de derivación de dirección están más allá de los clústeres GPU de consumidor).

Sé honesto sobre qué problema tienes antes de quemar el fin de semana.

Por Qué gurnec Está Muerto y 3rdIteration Ganó

Si buscas "btcrecover" en Google en 2026, el primer resultado orgánico sigue siendo el tutorial de ReadTheDocs. Debajo está el repositorio original gurnec/btcrecover de GitHub. Debajo, un tutorial popular de Medium que guía a los lectores hacia git clone https://github.com/gurnec/btcrecover. Los tres apuntan a un repositorio abandonado.

El último commit de gurnec/btcrecover fue el 2017-12-21. Referencias a Python 2.7. Formatos de wallet anteriores a SegWit. Sin parches de seguridad. Si lo clonas en 2026, la mitad de los comandos fallarán en silencio o producirán resultados incorrectos.

El fork mantenido en 2026 es github.com/3rdIteration/btcrecover. 846 estrellas, 265 forks (a fecha 2026-05-13). Último commit 2026-05-01. Varios commits por semana durante abril. Python 3.11 y 3.12 soportados. Cobertura para Electrum 4, Sparrow (parcial), MetaMask, Trust Wallet, Phantom, copias SLIP-39 Shamir, y más de 20 cadenas altcoin. El soporte altcoin es irrelevante si estás recuperando Bitcoin, pero confirma que el fork respira. El sitio ReadTheDocs (btcrecover.readthedocs.io) se construye desde 3rdIteration, no desde gurnec. La URL de la documentación es engañosa. La fuente subyacente es el fork mantenido.

También verás un fork mrsmookie/btcrecover en Google. Es un espejo personal de 3 estrellas que apenas ha divergido del código muerto de gurnec. Ignóralo. Ahórrate el desvío.

Construye Primero la Estación de Trabajo Offline

Antes de correr código, necesitas una máquina que no pueda filtrar los datos que vas a manejar. Tu wallet.dat o frase semilla es, durante las próximas horas, el archivo más sensible de tu ordenador. Cualquier cosa que lo exponga a la red es una forma de perder tu Bitcoin. Una app de grabación de pantalla. Una carpeta de sincronización en la nube. Una extensión del navegador que escanea el portapapeles. Una sesión de escritorio remoto.

Usa un laptop sin fondos. No la máquina del día a día con tus sesiones de navegador habituales. Una de repuesto, un viejo laptop de trabajo que puedas borrar, o un arranque USB nuevo. Graba un USB en vivo de Linux Mint o Ubuntu con Balena Etcher o dd, arranca desde él y no lo instales. El USB en vivo significa que nada persiste entre reinicios. Es el entorno más seguro que puedes montar en una tarde. Cuando termine la instalación de dependencias, modo avión. Wi-Fi apagado, Bluetooth apagado, ethernet desconectado. Si no puedes trabajar offline, como mínimo desconéctate durante la fase de fuerza bruta.

Antes del primer comando, haz tres copias del archivo de wallet en tres memorias USB distintas. Etiquétalas. Mantenlas separadas. Si un intento de recuperación corrompe el archivo o una USB muere en tres semanas, tienes copias de seguridad. Mantén la sala limpia. Sin teléfono grabando la pantalla. Sin copia de seguridad de fotos en la nube de tu terminal. Sin espectadores. La inversión es una tarde, y bloquea todas las formas realistas de filtrar el wallet a un atacante.

Instalar btcrecover Paso a Paso

Estás en la máquina offline. Wi-Fi apagado. Tres copias etiquetadas del archivo de wallet.

Primero, confirma Python 3.11 o 3.12:

python3 --version

Si ves 3.10 o anterior, instala un Python más nuevo desde el gestor de paquetes de tu distribución offline. Python 3.13 puede funcionar pero no está oficialmente soportado por 3rdIteration a fecha 2026-05-13.

Clona el fork mantenido en una memoria USB desde una máquina online distinta (tu laptop habitual):

git clone https://github.com/3rdIteration/btcrecover.git
cd btcrecover && git log -1 --format="%cd"

El último commit debería ser de las últimas semanas. Si ves 2017, clonaste el repositorio equivocado. Comprueba la URL. Copia el directorio btcrecover/ a la USB.

Lleva la USB a la máquina offline, copia btcrecover/ a la carpeta de inicio, y:

cd ~/btcrecover
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

pip no puede llegar a internet porque estás offline. Dos opciones. La segura: descarga previamente las dependencias en la máquina online con pip download -r requirements.txt -d wheels/, copia wheels/ al USB, luego pip install --no-index --find-links=wheels/ -r requirements.txt. La rápida: habilita el Wi-Fi solo para el pip install, y desactívalo de inmediato antes de tocar el archivo de wallet.

Verifica la instalación con python btcrecover.py --version. Deberías ver una cadena de versión y ningún error. Si ves ImportError o ModuleNotFoundError, el virtualenv probablemente no está activado.

Crackear wallet.dat Cuando Recuerdas a Medias la Contraseña

Este es el caso común. Tienes un archivo de wallet cifrado (wallet.dat de Bitcoin Core, un JSON keystore cifrado de Blockchain.info, MultiBit, o un wallet web moderno) y recuerdas la mayor parte de la contraseña.

btcrecover no "adivina" tu contraseña. Genera candidatos a partir de una lista de tokens que escribes, aplica errores tipográficos y reglas de capitalización, y prueba cada uno contra la suma de verificación del archivo cifrado. Un descifrado correcto produce una cabecera en claro reconocible (mainwallet, un patrón de dirección, una estructura JSON conocida). Uno incorrecto produce basura. btcrecover se detiene en el primer acierto.

Escribe la lista de tokens. Abre un archivo de texto. En líneas separadas, enumera cada fragmento que puedas haber usado. Ejemplo para un hipotético wallet de 2018:

Wallet
2018
Marathon
!
Bordeaux
14

Eso le da a btcrecover seis tokens para permutar. Añade directivas modificadoras donde sea útil:

%t Wallet
%t Marathon
%t Bordeaux
2018
14
!

%t habilita permutaciones de errores tipográficos en la línea siguiente. Otras directivas incluyen %p para rango de longitud de contraseña, %n para patrones numéricos y %c para capitalización. La ReadTheDocs de 3rdIteration cubre la gramática completa de la lista de tokens. Es el único lugar donde la documentación es indispensable. Espacio de búsqueda más pequeño, recuperación más rápida. Seis fragmentos con dos errores tipográficos cada uno lleva horas. Doce fragmentos con cuatro errores tipográficos puede llevar semanas. Sé preciso con lo que de verdad recuerdas.

Ejecuta btcrecover con --autosave:

python btcrecover.py \
  --wallet ~/recovery/wallet.dat \
  --tokenlist ~/recovery/tokens.txt \
  --autosave ~/recovery/session.dat \
  --typos 2 \
  --typos-capslock --typos-swap

El autoguardado es esencial. Una fuerza bruta puede correr horas o días. Sin session.dat cada interrupción te cuesta toda la búsqueda transcurrida.

Mientras corre, observa la tasa de keys/sec. El wallet heredado de Bitcoin Core deriva la clave de cifrado con al menos 25.000 iteraciones SHA-512 (EVP_BytesToKey, mayor en máquinas más rápidas; el recuento real se almacena en el wallet). En una CPU de laptop moderna, espera entre 50 y 500 claves/seg para wallet.dat. Multiplica por el tamaño de tu espacio de búsqueda para estimar tiempo. Si la respuesta son años, tu lista de tokens es demasiado amplia.

Cuando btcrecover encuentra la contraseña, la imprime en stdout. No la uses al momento para desbloquear el wallet en una máquina conectada. Cópiala en papel, cierra btcrecover, y pasa al barrido post-recuperación.

Fuerza Bruta sobre una Palabra BIP-39 Faltante

Caso menos frecuente, más carga emocional. Tienes un cuaderno con 23 de 24 (o 11 de 12) palabras semilla BIP-39, una ranura es ilegible o está arrancada, y necesitas encontrar qué palabra va ahí. btcrecover incluye seedrecover.py exactamente para esto.

Escribe la semilla con la ranura faltante marcada. Ejemplo para una semilla de 24 palabras:

1. abandon  2. ability  3. able  4. about  5. above  6. absent
7. absorb   8. abstract 9. absurd 10. abuse 11. access 12. accident
13. account 14. accuse  15. achieve 16. acid 17. acoustic 18. acquire
19. across  20. act     21. action 22. actor 23. ?       24. add

Necesitas dos cosas. El índice de la ranura faltante (aquí, 23), y al menos una dirección pública derivada de este wallet. La dirección permite que seedrecover.py verifique semillas candidatas sin emitir nunca una transacción. Cualquier dirección de destino antigua del historial de tu wallet sirve. Si no tienes nada a mano, una instantánea AddressDB (archivo precomputado de todas las direcciones on-chain) lo cubre. Descárgala en la máquina online y cópiala.

Ejecuta:

python seedrecover.py \
  --mnemonic "abandon ability able about above absent absorb abstract absurd abuse access accident account accuse achieve acid acoustic acquire across act action actor ? add" \
  --addresses bc1q... \
  --autosave seed-session.dat

El script itera cada palabra BIP-39 en la ranura desconocida, deriva las rutas estándar (m/84'/0'/0'/0/0 para Native SegWit, m/49'/0'/0'/0/0 para nested SegWit, m/44'/0'/0'/0/0 para legacy), y compara contra tu dirección de verificación. Con una palabra faltante y una dirección conocida, esto lleva menos de 10 minutos en un laptop moderno. Con dos, el espacio de búsqueda se convierte en 2048 al cuadrado (unos 4,2 millones de combinaciones). Espera varias horas. Con tres, son 8.500 millones de combinaciones, prácticamente fuera del alcance sin una búsqueda respaldada por AddressDB en una máquina mucho mayor.

Aceleración GPU y Listas de Tokens

La aceleración GPU es la pregunta más frecuente sobre btcrecover y la característica peor entendida.

La GPU ayuda con la recuperación de contraseña de wallet.dat de Bitcoin Core. La derivación de claves se paraleliza bien sobre muchos núcleos GPU. Una GPU de escritorio como una RTX 3060 corre típicamente 10 a 100 veces más rápido que una CPU de laptop en cargas de btcrecover, según el formato de wallet y el kernel. La GPU no ayuda de forma significativa a la recuperación de frase semilla BIP-39. El cuello de botella ahí es la derivación de clave hijo BIP-32 y la generación de direcciones (SHA-256 + RIPEMD-160 en pasos seriales), y para una o dos palabras faltantes una CPU es suficiente. No pierdas un fin de semana instalando CUDA para seedrecover.py.

En Linux, instala el driver NVIDIA y el toolkit CUDA desde el gestor de paquetes de tu distribución, y dentro del venv de btcrecover:

pip install pyopencl
python btcrecover.py --wallet wallet.dat --tokenlist tokens.txt --enable-gpu

Si pyopencl falla al instalarse, probablemente tengas una discrepancia entre kernel y driver. La salida rápida es un par CUDA + driver nuevo en el USB en vivo de Ubuntu offline.

En Apple Silicon (M1 a M4), la aceleración GPU es inestable en 2026. Las compilaciones de pyopencl fallan contra macOS moderno y el backend Metal de Apple no está soportado upstream. Recurre a CPU en hardware Apple. Para el caso típico de "recuerdo la mayor parte de mi contraseña", la CPU termina en horas de todos modos.

Nunca Hagas Estas Cuatro Cosas

Si no te llevas nada más del artículo, llévate esta sección.

1. Nunca compartas tu archivo de wallet o semilla con nadie que ofrezca "ayudar." Ningún servicio de recuperación legítimo pide tu frase semilla. El patrón es universal. Un extraño te escribe en Telegram, Twitter / X, Reddit o YouTube, ofreciéndose a recuperar tu wallet por una tarifa anticipada. Quieren el archivo, extraen lo recuperable y desaparecen con los fondos. Bloquea. Denuncia. Sigue adelante.
2. Nunca subas tu archivo de wallet a un servicio en la nube. Ni Google Drive, ni Dropbox, ni WeTransfer, ni un adjunto de Discord. Cada subida crea una copia que ya no controlas. Transferencia local por USB y nada más.
3. Ejecuta btcrecover en un USB en vivo de Linux limpio, no en Windows. OneDrive, Defender y varios productos AV de terceros pondrán en cuarentena o subirán archivos que coincidan con patrones de wallet.
4. Paga solo en caso de éxito, nunca por adelantado. El modelo legítimo es porcentaje en caso de éxito, tomado de los fondos recuperados en depósito. Las tarifas anticipadas son señal de estafa al 100% en este sector. La misma regla aplica a tu contraseña recuperada. No la escribas en un navegador, sesión RDP o cualquier terminal sincronizado con la nube. Nunca publiques tu archivo de wallet en un foro pidiendo ayuda. Incluso con la dirección redactada, los metadatos del archivo pueden identificar qué direcciones controla, y todos los que descarguen la publicación pueden competir contigo por la clave recuperada.

Cuándo Detener la Recuperación DIY

En cada recuperación llega un momento en que la respuesta correcta es parar. Reconocer ese momento salva tu cordura y protege tus fondos de la fase de desesperación, cuando los estafadores cazan a sus víctimas de mayor valor.

Para y reconsidera si has pasado tres fines de semana completos y agotado las permutaciones más plausibles de tu lista de tokens. Si tu espacio de búsqueda estimado dividido por tu tasa de claves/seg supera un año calendario. Si trabajas con menos del 50% de los caracteres de la contraseña y menos del 60% de su forma general. Si todo lo que tienes es una dirección sin archivo de wallet ni fragmentos de semilla (los fondos están matemáticamente fuera del alcance en ese caso). Si empiezas a considerar servicios que te encontraron en tus DMs.

Si paras, tienes tres opciones. Esperar. Tu memoria es la variable limitante, y la contraseña exacta a veces emerge semanas o meses después, una vez que baja el pánico y llega la realidad presupuestaria. Contratar a una firma suiza con licencia. Para casos de alto valor (por encima de CHF 50.000 equivalente), Sygnum y Crypto Finance pueden trabajar en custodia institucional y recuperación bajo NDA. Cobran porcentajes en caso de éxito y nunca piden tu frase semilla. Aceptar la pérdida. El diseño de Bitcoin incluye un pequeño porcentaje de monedas perdidas como característica, no como error, y el capital que de otro modo quemarías en semanas de recuperación suele estar mejor desplegado en posiciones nuevas aseguradas con un hardware wallet y la higiene adecuada de auto-custodia.

La respuesta incorrecta es seguir intentando sin información nueva y sin estrechar el espacio de búsqueda. En ese punto no estás recuperando Bitcoin. Estás apostando con tu tiempo.

El Ángulo Fiscal y Fiduciario Suizo

Dos preguntas que los lectores suizos siempre hacen.

¿Es la recuperación de Bitcoin un evento imponible? No. La recuperación en sí no es un evento de realización. Estás recuperando el acceso a una propiedad que ya poseías. El Bitcoin sigue siendo tu propiedad privada mobiliaria y está sujeto al Vermögenssteuer anual al valor de la lista de cursos de la ESTV del 31 de diciembre, igual que si el wallet hubiera sido accesible todo el tiempo. No hay evento de impuesto sobre la renta. No hay evento de ganancias de capital bajo estatus de inversor privado. No hay evento de donación. Consulta el marco completo en la guía fiscal de Bitcoin en Suiza. Si has estado omitiendo el Bitcoin perdido de tus declaraciones de impuesto patrimonial durante el periodo de acceso perdido, ese es un asunto de cumplimiento aparte. El régimen suizo de autodenuncia (Selbstanzeige) permite una corrección única sin penalización. Un contable o un Steuerberater cantonal puede guiarte por el formulario.

¿A quién puedo contratar si el DIY falla? Sygnum (Zúrich, con licencia FINMA) y Crypto Finance (Zug, con licencia FINMA, parte del Deutsche Börse Group) son las dos opciones institucionales suizas. Ambas trabajan en custodia institucional y recuperación de activos digitales bajo NDA. Ambas cobran porcentajes en caso de éxito. Ninguna pide tu frase semilla. Los compromisos individuales de clave perdida son raros y caso por caso para ambas. Llama antes de asumir que manejan tu escenario. Para casos pequeños (por debajo de unos CHF 50.000), la mayoría de firmas respetables rechazarán el compromiso. El coste operativo supera el porcentaje que pueden cobrar. Las recuperaciones pequeñas son DIY o nada.

Evita cualquier servicio que te pida enviar por correo o subir tu frase semilla, cobre un anticipo "para análisis", prometa una tasa de éxito porcentual fija sin ver tu caso, o te haya encontrado en Telegram, Twitter / X, Reddit o YouTube.

btcrecover vs Servicios Comerciales de Recuperación

Tres opciones generales en el momento de decidir.

Por debajo de unos CHF 50.000 con una contraseña o semilla casi completa, el DIY con btcrecover es más rápido, gratis y más seguro que cualquier compromiso con terceros. Por encima de ese umbral, donde tu situación es técnicamente recuperable pero operativamente compleja, una firma suiza verificada vale el porcentaje. Todo lo demás enrutado por los DMs de un extraño es el camino de la estafa. La única respuesta segura es el silencio.

Barrer los Fondos Recuperados Inmediatamente

Ejecutaste btcrecover. Imprimió la contraseña. Abriste el wallet en la máquina offline. El saldo está ahí. La recuperación no ha terminado.

Tu archivo de wallet antiguo ha vivido en almacenamiento que puede haber sido comprometido durante el periodo de acceso perdido. Tu contraseña ahora está en el historial del terminal. Ambos son artefactos de menor seguridad que una semilla nueva generada en un hardware wallet nuevo. Por eso el paso final obligatorio es el barrido.

En la misma máquina offline, inicializa un hardware wallet que nunca haya estado online. Genera una nueva semilla de 24 palabras, escríbela en papel y no la uses para nada más primero (consulta la guía de configuración de hardware wallet para la higiene canónica). Abre el wallet recuperado, genera una nueva dirección de recepción en el dispositivo hardware y envía el saldo completo a esa dirección con una comisión que confirme en un bloque. Verifica la recepción en un explorador de bloques desde un dispositivo online aparte (nunca pongas la máquina offline online). Borra el archivo de wallet antiguo de cada USB de respaldo, formatea los USB y tira las etiquetas. La semilla y contraseña antiguas son capital muerto. Nunca las reutilices.

Has convertido "Bitcoin perdido detrás de una contraseña que recordaba a medias" en "Bitcoin bajo una semilla de hardware wallet nueva generada offline y respaldada correctamente." Ese es el estado final. Todo lo demás es papeleo.

Lectura Relacionada

• Guía de auto-custodia de Bitcoin: la higiene canónica para tu destino de barrido
• Seguridad de la frase semilla BIP-39: qué hace que una semilla sea recuperable en primer lugar
• Planificación de herencia de Bitcoin: el problema estructural hermano a la recuperación
• Bitcoin y CVE-2023-50428 (entropía débil de Libbitcoin): cuando la mala entropía crea wallets recuperables sin el consentimiento del propietario
• Impuesto sobre Bitcoin en Suiza: cómo aparece el Bitcoin recuperado en tu declaración

Aviso Legal

Este artículo es contenido educativo para titulares de Bitcoin que gestionan su auto-custodia. No es asesoramiento legal, financiero ni fiscal. La recuperación de Bitcoin es una operación de alto riesgo. Haz tres copias offline del archivo de wallet antes de ejecutar cualquier comando. Verifica el fork mantenido de 3rdIteration antes de clonar. Nunca compartas tu frase semilla o archivo de wallet con nadie que ofrezca "ayuda." Para casos de alto valor o cualquier pregunta fiscal suiza compleja, consulta a una firma supervisada por la FINMA y a un Steuerberater con licencia suiza respectivamente.