← Back to Documentation

Model + Passphrase File

Mode 5: Combine a model file (seed constraints) with a passphrase list

📋 Overview

Mode 5 is a combination of Mode 0 (model-based seed recovery) and a passphrase list. You provide a model file describing seed word candidates and a passphrase file listing candidate passphrases (one per line). wrecover tests every valid seed combination from the model against every passphrase in the list.

Use this mode when you are uncertain both about some seed words and which passphrase was used, but have a manageable list of passphrase candidates.

💡 GPU Supported

Mode 5 fully supports GPU acceleration (CUDA and OpenCL) in the Pro version.

📄 File Formats

Model file (-cf) — same format as Mode 0

One line per mnemonic position. Multiple words on a line = candidates for that slot. Modifier prefixes (@, @#N) apply. File must be .txt extension. See Mode 0 documentation for full format details.

Passphrase file (-pps)

A plain text file with one passphrase candidate per line. The file must have a .txt extension. wrecover converts it to a binary index (.bin) at first run. On resume (-wi), supply the .bin file path.

# passphrases.txt
MyPassphrase
password123
Satoshi2009
hodl!
""
💡 Empty passphrase

To include an empty passphrase (no BIP39 passphrase) in the list, add a blank line to the file.

🚀 Commands

New search — CPU

wrecover -l 12 -m 5 -cf model.txt -pps passphrases.txt -addr "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" -wlang en -ws -wf recovery.wrec -wp "this workfile password"

New search — GPU (Pro)

wrecover -l 24 -m 5 -cf model.txt -pps passphrases.txt -addr "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh" -wlang en -ws -wf recovery.wrec -wp "this workfile password" -gpu -grid 2048 -gblock 256

Resume (provide .bin passphrase file)

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

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

📖 Parameter Reference

OptionDescriptionRequired
-l 12|18|24Mnemonic lengthYes
-m 5Select Mode 5Yes
-cf <model.txt>Model file (same format as Mode 0)Yes
-pps <file.txt|.bin>Passphrase list (.txt new search, .bin resume)Yes
-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.

🌎 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

Total work = (seed combinations from model) × (number of passphrases). Seed combinations are processed at seed-recovery speed; for each valid seed, all passphrases are tested.

Hardware12-word18-word24-word
CPU — per thread (Free & Pro)3,000–4,000/sec3,000–4,000/sec3,000–4,000/sec
NVIDIA Tesla T4 (Pro)~2.6M/sec~9.8M/sec~21M/sec
NVIDIA RTX PRO 6000 (Pro)~31.4M seeds/sec~117.2M seeds/sec~264M seeds/sec
N× GPUs (Pro)Linear: N × single-GPU throughput
💡 Free vs Pro

Free: CPU only, max 10 threads. Pro: unlimited threads + GPU. Throughput scales linearly with thread count on CPU.

← Back to Documentation