← Back to Documentation

Brute Passphrase

Mode 2: Brute-force a BIP39 passphrase with full character-set search

📋 Overview

Mode 2 brute-forces a BIP39 passphrase when you know the complete seed phrase but have forgotten the passphrase. It systematically tests every combination of printable characters from a minimum to a maximum length against the target address.

The character set used is: uppercase letters (A–Z), lowercase letters (a–z), digits (0–9), and the special characters !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~.

⚠️ Full brute-force grows exponentially

The total number of combinations is 95N (95 printable ASCII characters) for a passphrase of exactly N characters. Beyond 5–6 characters, GPU acceleration is essential. If you know parts of the passphrase, Mode 3 (mask) or Mode 4 (substitution) will be far more efficient.

💡 GPU Supported

Mode 2 fully supports GPU acceleration (CUDA and OpenCL) in the Pro version, reaching ~1.75M passphrases/sec on a NVIDIA RTX PRO 6000.

🚀 Commands

New search — CPU

wrecover -m 2 -mf "word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12" -addr "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" -wlang en -lmin 1 -lmax 6 -ws -wf recovery.wrec -wp "this workfile password"

New search — GPU (Pro)

wrecover -m 2 -mf "word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12" -addr "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" -wlang en -lmin 1 -lmax 7 -ws -wf recovery.wrec -wp "this workfile password" -gpu -grid 2048 -gblock 256

Resume from work file

# CPU
wrecover -wi -wf recovery.wrec -wp "this workfile password"

# GPU (Pro)
wrecover -wi -wf recovery.wrec -wp "this workfile password" -gpu -grid 2048 -gblock 256

📖 Parameter Reference

OptionDescriptionRequired
-m 2Select Mode 2Yes
-mf "<full mnemonic>"Complete, known seed phrase (all words)Yes
-lmin <N>Minimum passphrase length to tryYes
-lmax <N>Maximum passphrase length to tryYes
-addr <address>Target blockchain addressYes
-wlang <code>BIP39 wordlist languageYes
-wsNew searchYes*
-wiResume from work fileYes*
-wf <file.wrec>Work file pathYes
-dpath <path>Override derivation pathNo
-t <N>CPU threads (Free: max 10; Pro: unlimited)No
-gpuEnable GPU (Pro only)No
-grid <N>GPU grid size (Pro, default 256)No
-gblock <N>GPU threads/block (Pro, default 256, max 256)No
-wp <password>Encrypt work fileNo
-save-onlyCreate work file onlyNo
-startp <N>Start at offset N (Pro only)No
-endp <N>Stop at offset N (Pro only)No

* Use either -ws (new search) or -wi (resume) — not both at the same time.

🌎 Languages & Address Types

Languages (-wlang)

CodeLanguage
enEnglish
esSpanish
frFrench
itItalian

Address types (auto-detected)

Address formatTypeDefault derivation path
Starts with 1Bitcoin Legacy (P2PKH)m/44'/0'/0'/0
Starts with 3Bitcoin SegWit P2SHm/49'/0'/0'/0
Starts with bc1qBitcoin Native SegWitm/84'/0'/0'/0
Starts with 0xEthereumm/44'/60'/0'/0

⚡ Performance & Search Space

The character set contains 95 printable ASCII characters. Search space = 951 + 952 + … + 95lmax combinations.

Passphrase lengthCombinationsCPU 8 threadsTesla T4NVIDIA RTX PRO 6000
Up to 4 chars (lowercase only)~475,000~8 min<3 secInstant
Up to 5 chars (lowercase only)~12M~3.5 hours~64 sec~6 sec
Up to 6 chars (lowercase only)~322M~4 days~28 min~3 min
Up to 5 chars (full 95-char set)~9B~120 days~13 hours~1 hour
Up to 6 chars (full 95-char set)~865B~32 years~53 days~5 days

Actual throughput:

HardwarePassphrase throughput
CPU — per thread (Free & Pro)700–1,200 passphrases/sec
NVIDIA Tesla T4 (Pro)~187,000 passphrases/sec
NVIDIA RTX PRO 6000 (Pro)~1,750,000 passphrases/sec
N× GPUs (Pro)Linear: N × single-GPU throughput
💡 Free vs Pro

Free version: CPU only, max 10 threads. Pro version: unlimited CPU threads + GPU acceleration (CUDA & OpenCL). Throughput scales linearly with thread count on CPU.

← Back to Documentation