Crackear un Bitcoin Wallet con btcrecover 2026

TL;DR

btcrecover es una herramienta Python de código abierto que hace fuerza bruta sobre una contraseña de Bitcoin wallet o rellena una palabra BIP-39 faltante, pero solo 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 y no debería clonarse. Ejecútalo offline, nunca compartas tu archivo de wallet, y 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 semilla, lee la sección de parada antes de quemar tres fines de semana.

La Llamada Que Siempre Empieza Igual

El hermano de un amigo manda un mensaje a las 23:47 de un domingo por la noche. 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.

Esta es la situación para la que fue construido btcrecover.

Es también la situación que los estafadores explotan con mayor despiadez. Antes de cualquiera de los pasos técnicos que siguen, lee este artículo de principio a fin, especialmente 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, enero de 2021) están bloqueados detrás de una contraseña hardware IronKey, es el ancla emocional de cada artículo en esta categoría. Thomas no usó btcrecover y su situación no es un problema de btcrecover. IronKey se autodestruye después de 10 intentos incorrectos; los archivos de wallet cifrados por software no. La mayoría de historias de recuperación son mucho más manejables que la suya.

Qué Hace btcrecover y Dónde Falla

btcrecover es un script Python que realiza fuerza bruta guiada contra un archivo de wallet cifrado o una frase semilla parcial. No es una varita mágica. Es un motor de búsqueda estructurado que prueba cada variante plausible 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 diferente. btcrecover no soporta actualmente wallets descriptor sqlite, así que confirma tu formato de wallet 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 en absoluto (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 (las 8.500 millones de combinaciones de búsqueda multiplicadas por el coste de derivación de dirección están más allá de los clústeres de GPU de consumidor).

Sé honesto sobre qué problema tienes antes de pasar un fin de semana en ello.

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 de ese, un popular tutorial de Medium que guía a los lectores a través de git clone https://github.com/gurnec/btcrecover. Los tres te dirigen hacia un repositorio abandonado.

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

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

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

Construye Primero la Estación de Trabajo Offline

Antes de que corra cualquier código, necesitas una máquina que no pueda filtrar los datos que estás a punto de 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 aplicación 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, sino 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, que es el entorno más seguro que puedes construir en una tarde. En el momento en que la instalación de dependencias esté hecha, activa el modo avión. Wi-Fi apagado, Bluetooth apagado, ethernet desconectado. Si absolutamente 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 separadas, etiquétalas y mantenlas separadas. Si un intento de recuperación corrompe el archivo o una USB muere en tres semanas, tienes copias de seguridad. Y 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 en que de lo contrario filtrarías el wallet a un atacante.

Instalar btcrecover Paso a Paso

Estás en la máquina offline. El Wi-Fi está apagado. Tienes 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 de 2026-05-13.

A continuación, clona el fork mantenido en una memoria USB desde una máquina online diferente (tu laptop habitual, por ejemplo):

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/ en una memoria USB.

Mueve la USB a la máquina offline, copia btcrecover/ a la carpeta de inicio, luego:

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 más segura: descarga previamente todas 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 más rápida: habilita temporalmente el Wi-Fi solo para el pip install, luego desactívalo inmediatamente antes de tocar el archivo de wallet.

Por último, 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. Cada descifrado correcto produce una cabecera de texto en claro reconocible (mainwallet, un patrón de dirección, una estructura JSON conocida); cada 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 genuinamente indispensable. Un espacio de búsqueda más pequeño significa una 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 realmente recuerdas.

Luego 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 ejecutarse durante horas o días, y sin session.dat cada interrupción te cuesta toda la búsqueda transcurrida.

Mientras se ejecuta, 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 y el recuento real se almacena en el wallet). En una CPU de laptop moderna, espera 50 a 500 claves/seg para wallet.dat. Multiplica por el tamaño de tu espacio de búsqueda para una estimación de 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 inmediatamente 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, mayor 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 (un archivo precomputado de todas las direcciones on-chain) lo cubre; descárgala en la máquina online y cópiala.

Luego 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 (aproximadamente 4,2 millones de combinaciones); espera varias horas. Con tres, estás mirando 8.500 millones de combinaciones, lo que está prácticamente fuera del alcance sin una búsqueda respaldada por AddressDB en una máquina mucho más grande.

Aceleración GPU y Listas de Tokens

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

La GPU ayuda con la recuperación de contraseña de wallet.dat de Bitcoin Core. La derivación de claves se paraleliza bien a través de muchos núcleos de GPU. Una GPU de escritorio como una RTX 3060 generalmente corre 10 a 100 veces más rápido que una CPU de laptop en cargas de trabajo de btcrecover, dependiendo del formato de wallet y el kernel. La GPU no ayuda significativamente 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 suficientemente rápida. 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, luego en el 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 el kernel y el driver. La solución más 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 todas formas.

Nunca Hagas Estas Cuatro Cosas

Esta es la única sección que importa si no te llevas nada más del artículo.

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 de wallet, extraen lo que sea 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 a la nube crea una copia que ya no controlas. Solo transferencia local por USB.
3. Ejecuta btcrecover en un USB en vivo de Linux limpio, no en Windows. OneDrive, Defender y varios productos de 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 una 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, y 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

Hay un momento en cada recuperación donde la respuesta correcta es parar. Conocer ese momento salva tu cordura y protege tus fondos de la fase de desesperación, cuando los estafadores convierten a sus víctimas de mayor valor.

Para y reconsidera si has pasado tres fines de semana completos y agotado tus permutaciones de lista de tokens más plausibles, o si el tamaño estimado de tu espacio de búsqueda dividido por tu tasa de claves/seg supera un año calendario, o si trabajas con menos del 50% de los caracteres de la contraseña y menos del 60% de su forma general, o si todo lo que tienes es una dirección sin archivo de wallet ni fragmentos de frase semilla (los fondos están matemáticamente fuera del alcance en ese caso), o si estás empezando 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 el pánico ha bajado y la realidad presupuestaria ha llegado. 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 lo contrario gastarías en semanas de esfuerzo de recuperación suele estar mejor desplegado en nuevas posiciones aseguradas con un hardware wallet y la higiene adecuada de auto-custodia.

La respuesta incorrecta es seguir intentando sin nueva información y sin nuevo estrechamiento del 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, exactamente como habría sido si el wallet hubiera sido continuamente accesible. No hay evento de impuesto sobre la renta, ningún evento de ganancias de capital bajo el estatus de inversor privado, ningún 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 período de acceso perdido, eso es un asunto de cumplimiento separado. El régimen suizo de autodenuncia (Selbstanzeige) permite una corrección única sin penalización; un contable o un Steuerberater cantonal puede guiarte a través del 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 y ninguna pide tu frase semilla. Los compromisos individuales de clave perdida son raros y caso por caso para ambas firmas, así que llama antes de asumir que manejan tu escenario. Para casos más pequeños (por debajo de aproximadamente 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 específico, o te haya encontrado en Telegram, Twitter / X, Reddit o YouTube.

btcrecover vs Servicios Comerciales de Recuperación

Tres opciones generales para el momento de tomar una decisión.

Para cantidades por debajo de aproximadamente CHF 50.000 con una contraseña o semilla casi completa, el DIY con btcrecover es más rápido, gratuito 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. Cualquier cosa enrutada a través de 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 antiguo archivo de wallet ha vivido en un almacenamiento que puede o no haber sido comprometido durante el período de acceso perdido. Tu contraseña está ahora en el historial de tu terminal. Ambos son artefactos de menor seguridad que una semilla nueva generada en un hardware wallet nuevo, así que 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 usando una comisión que confirme en un bloque. Verifica la recepción en un explorador de bloques desde un dispositivo online separado (nunca pongas la máquina offline online), luego borra el antiguo archivo de wallet de cada USB de respaldo, formatea los USB y desecha 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, y 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.