bruteforce-wallet

Overview

bruteforce-wallet recovers the password securing an encrypted cryptocurrency wallet file (Bitcoin Core wallet.dat, and other wallet formats using compatible encryption). Given a wordlist, it attempts to decrypt the wallet’s master key, useful for forensic recovery of forgotten wallet passwords or auditing wallet password strength during an assessment.

Common Usage

Brute-force a Bitcoin Core wallet.dat with a wordlist

bruteforce-wallet -f wordlist.txt wallet.dat

Multi-threaded attack

bruteforce-wallet -f rockyou.txt -t 8 wallet.dat

Resume from a specific line in the wordlist

bruteforce-wallet -f wordlist.txt -s 500000 wallet.dat

Typical Workflow

Step 1: Confirm the wallet is encrypted

python3 -c "import bsddb3" 2>/dev/null; file wallet.dat

Step 2: Run the brute-force with a targeted wordlist

bruteforce-wallet -f targeted.txt -t 8 wallet.dat

Step 3: Once recovered, unlock the wallet in the actual client

bitcoin-cli walletpassphrase "<found_pass>" 60

Tips

• Supports several wallet formats beyond Bitcoin Core — check the project’s README for the current list before assuming compatibility
• Like LUKS, wallet encryption uses a deliberately slow KDF — expect modest attempts/sec even multi-threaded
• Pair with a targeted wordlist (BopsCrK, cewl) built from OSINT on the wallet owner rather than a generic list for realistic odds

Usage: bruteforce-wallet [options] <wallet_file>

Options:
  -f FILE      Wordlist file to try as passwords
  -t THREADS   Number of threads to use
  -s N         Start at line N in the wordlist
  -b SIZE      Batch size per thread
  -v           Verbose, print progress/attempts
  -h           Show help

Supported wallet types include Bitcoin Core (wallet.dat) and other
Berkeley DB / compatible-encryption wallet formats.

Vue d’ensemble

bruteforce-wallet récupère le mot de passe sécurisant un fichier de wallet de cryptomonnaie chiffré (le wallet.dat de Bitcoin Core, et d’autres formats de wallet utilisant un chiffrement compatible). À partir d’une wordlist, il tente de déchiffrer la clé maîtresse du wallet, ce qui est utile pour la récupération forensique de mots de passe de wallet oubliés ou pour auditer la robustesse d’un mot de passe de wallet lors d’une évaluation.

Utilisation courante

# Brute-force d'un wallet.dat Bitcoin Core avec une wordlist
bruteforce-wallet -f wordlist.txt wallet.dat

# Attaque multi-threadée
bruteforce-wallet -f rockyou.txt -t 8 wallet.dat

# Reprendre à une ligne précise de la wordlist
bruteforce-wallet -f wordlist.txt -s 500000 wallet.dat

Workflow typique

# Étape 1 : confirmer que le wallet est chiffré
python3 -c "import bsddb3" 2>/dev/null; file wallet.dat

# Étape 2 : lancer le brute-force avec une wordlist ciblée
bruteforce-wallet -f targeted.txt -t 8 wallet.dat

# Étape 3 : une fois récupéré, déverrouiller le wallet dans le client réel
bitcoin-cli walletpassphrase "<found_pass>" 60

Conseils

• Supporte plusieurs formats de wallet au-delà de Bitcoin Core : consultez le README du projet pour la liste à jour avant de présumer d’une compatibilité
• Comme LUKS, le chiffrement de wallet utilise une KDF volontairement lente : attendez-vous à un débit modeste de tentatives/sec même en multi-thread
• Associez une wordlist ciblée (BopsCrK, cewl) construite à partir d’OSINT sur le propriétaire du wallet plutôt qu’une liste générique, pour des chances réalistes

Usage: bruteforce-wallet [options] <wallet_file>

Options:
  -f FILE      Wordlist file to try as passwords
  -t THREADS   Number of threads to use
  -s N         Start at line N in the wordlist
  -b SIZE      Batch size per thread
  -v           Verbose, print progress/attempts
  -h           Show help

Supported wallet types include Bitcoin Core (wallet.dat) and other
Berkeley DB / compatible-encryption wallet formats.