← retour aux outils back to tools

# bruteforce-wallet

Brute-force le mot de passe protégeant un fichier de wallet de cryptomonnaie chiffré, comme le wallet.dat de Bitcoin Core. Brute-forces the password protecting an encrypted cryptocurrency wallet file, such as Bitcoin Core's wallet.dat.

↗ https://github.com/glv2/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

Help / Man page

    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

Aide / Page de manuel

    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.