Password Attackspassword-crackingwalletbitcoinpeercoinlitecoinbruteforcedictionary

bruteforce-wallet

bruteforce-wallet attempts to recover passwords for encrypted cryptocurrency wallet files like Peercoin, Bitcoin, or Litecoin wallet.dat files using exhaustive or dictionary-based methods.

Description

bruteforce-wallet is designed to find the password of an encrypted wallet file by either generating all possible passwords from a specified charset or using a dictionary file with one password per line. It supports encrypted wallets from Peercoin, Bitcoin, Litecoin, and similar cryptocurrencies.

The tool operates in two primary modes: exhaustive mode, which is useful when partial password knowledge exists (e.g., beginning, end, or length constraints), and dictionary mode for trying passwords from a file. Features include multi-threading for faster cracking, progress reporting via USR1 signal, and customizable character sets based on the current locale.

This package is particularly helpful for recovering access to wallet.dat files when passwords are forgotten but some details are remembered, though exhaustive cracking of strong, unknown passwords is computationally infeasible.

How It Works

In exhaustive mode, bruteforce-wallet systematically generates and tests passwords within specified constraints (minimum/maximum length, prefix, suffix, charset) against one encrypted address in the wallet to decrypt it. Dictionary mode reads passwords line-by-line from a file and attempts each one. Multi-threading accelerates the process, and a USR1 signal triggers progress output to stderr without halting execution. The tool targets the wallet.dat format used by various cryptocurrencies.

Installation

bash
sudo apt install bruteforce-wallet

Flags

-b <string>Beginning of the password. default: ""
-e <string>End of the password. default: ""
-f <file>Read the passwords from a file instead of generating them.
-hShow help and quit.
-l <length>Minimum password length (beginning and end included). default: 1

Examples

Basic usage: run bruteforce-wallet on a wallet file with specified options.
bruteforce-wallet [options] <wallet file>
Dictionary mode: try passwords from passwords.txt on wallet.dat.
bruteforce-wallet -f passwords.txt wallet.dat
Exhaustive mode: try passwords starting with 'start', ending with 'end', minimum length 8.
bruteforce-wallet -b 'start' -e 'end' -l 8 wallet.dat
Default exhaustive mode with minimum length 1 on wallet.dat.
bruteforce-wallet wallet.dat
Send USR1 signal to running process to print progress info to stderr.
kill -USR1 <pid>
Show help and quit.
bruteforce-wallet -h
Updated 2026-04-16kali.org ↗