Bitcoin2john |top| Jun 2026
: The ciphertext that actually locks your private keys.
For complex, long passwords, CPU cracking is slow. Use OpenCL ( john --format=bitcoin-opencl ) or CUDA to utilize your graphics card.
This guide covers: what it is, how it works, installation, usage, hash formats, integration with John the Ripper, and real-world recovery scenarios.
It prints a consolidated output line following a format recognizable by auditing engines. Bitcoin2john
It extracts the necessary data from the wallet and constructs a specific hash format—a representation of the encrypted password—that JtR can manipulate.
Once you have the hash file ( hash.txt ), run john :
Despite its name, is not a hacking program. It is a data extraction utility. The "john" in its name refers to John the Ripper , the famous password cracking software. : The ciphertext that actually locks your private keys
bitcoin2john is a critical and powerful first step in the password recovery process for encrypted Bitcoin Core wallets. It provides a legitimate means of regaining access to lost funds by extracting the necessary data for password-cracking tools. However, understanding the technical background, preparing your environment, and strictly adhering to legal and ethical guidelines are essential for success.
: Hashcat is often preferred for GPU acceleration. You will need to use Mode 11300 for standard Bitcoin Core wallet.dat files. Example command: hashcat -m 11300 hash.txt wordlist.txt Security Warning
The goal of using bitcoin2john is to get the hash into a password-cracking tool. The process generally follows these steps: This guide covers: what it is, how it
bitcoin2john is a Python script (originally part of the suite, specifically run/bitcoin2john.py ) that extracts the master encryption key and associated metadata from a Bitcoin Core wallet file ( wallet.dat ) and formats it into a hash string that john (or hashcat ) can crack.
The primary goal of bitcoin2john.py is to convert a wallet's internal data into a format that password cracking tools like John the Ripper or Hashcat can understand.
python bitcoin2john.py /path/to/your/wallet.dat > hash.txt
When an individual loses access to a local cryptocurrency wallet password, recovery tools cannot audit the database directly due to its size and structure. resolves this blocker by translating the complex database syntax into a localized string of characters. Password cracking software like John the Ripper or Hashcat can then read this string to test candidate passwords off-chain without modifying or corrupting the original wallet. Technical Architecture: How It Works