██╗ ██╗ ██████╗ █████╗ ██╗ ██╗
██║ ██║ ██╔══██╗██╔══██╗╚██╗ ██╔╝
██║ █╗ ██║█████╗██████╔╝███████║ ╚████╔╝
██║███╗██║╚════╝██╔══██╗██╔══██║ ╚██╔╝
╚███╔███╔╝ ██║ ██║██║ ██║ ██║
╚══╝╚══╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝
Advanced Bitcoin Wallet Generation and Recovery Tool with Passphrase Attack Engine
Created by jino99 — v3.0
This tool is provided for EDUCATIONAL and RESEARCH purposes ONLY.
- Using this tool to access Bitcoin wallets that do not belong to you is ILLEGAL
- The probability of randomly finding a wallet with balance is astronomically low
- This tool is intended for:
- Learning about Bitcoin wallet generation
- Testing wallet recovery mechanisms
- Understanding BIP39 and HD wallet derivation
- Security research and education
By using this tool, you agree to use it legally and ethically.
See Legal Disclaimer.txt for complete terms.
- ✅ BIP39 Mnemonic Generation (12/24 word seed phrases)
- ✅ HD Wallet Derivation (BIP44/49/84)
- ✅ All Address Types — Legacy (
1...), P2SH (3...), Native SegWit (bc1...) - ✅ Full BIP39 passphrase (13th word) support
- ✅ Online balance checking via multiple APIs with async fallback
- 🔥 Multiprocessing DB Search — each worker runs its own SQLite reader, zero IPC bottleneck
- 🔥 100M+ row database support — SQLite WAL + mmap, no RAM loading, instant startup
- 🔥 Passphrase Attack Engine — common, pattern, hybrid, custom wordlist strategies
- 🔥 Target Address Attack — bruteforce a specific address with known seed
- 🔥 Wallet Recovery — derive all address types from any seed phrase
- Python 3.7+
- OS: Linux (recommended), macOS, Windows
| Package | Role | Required? |
|---|---|---|
mnemonic |
BIP39 seed generation | ✅ Required |
coincurve |
Fast secp256k1 (~10x speedup) | Strongly recommended |
aiohttp |
Async balance API calls | Recommended |
requests |
Sync balance API fallback | Recommended |
rich |
Terminal UI (tables, panels) | Recommended |
git clone https://github.com/jino99/w-ray.git
cd w-ray
pip install -r requirements.txt
python w-ray.py[1] Generate Wallet & Check Balance
[2] Search BTC Wallet with Database ← multiprocessing, 100M+ rows
[3] Advanced Passphrase Attack
[4] Target Specific Address Attack
[5] Recover Bitcoin Wallet
[6] Convert TXT/TSV to SQLite
[7] Database Statistics
[8] Passphrase Attack Settings
[9] Exit
address<TAB>balance_in_satoshis
- Place
btc_database.txtorbtc_database.tsvin the working directory - Run option [6] — auto-detects separator, column layout, and header
- The resulting
btc_database.dbis ready immediately — no RAM loading required
- Startup is instant — the tool connects to SQLite and reads nothing into RAM
- Each worker process opens its own read-only connection with 128 MB page cache and 4 GB mmap
- Lookups are O(log n) via the
addressprimary key index
Strategies tried per seed:
- Common passwords + custom
passphrases.txt - Numeric patterns (years, sequences)
- Hybrids (seed word + suffix)
Customize via option [8].
| File | Description |
|---|---|
found_wallets.txt |
Wallets matched in database |
gen_wallets.txt |
Generated wallets with online balance |
recovered_wallet.txt |
Recovery results |
btc_database.db |
SQLite database |
- BIP39 entropy: 128-bit (12 words) or 256-bit (24 words)
- Derivation paths:
m/44'/0'/0'/0/0(Legacy),m/49'/0'/0'/0/0(P2SH),m/84'/0'/0'/0/0(SegWit) - Crypto backend:
coincurve(libsecp256k1) when available, pure-Python secp256k1 fallback - DB: SQLite WAL mode,
PRAGMA mmap_size=4GB,PRAGMA cache_size=-128MB, no full-table scans - IPC: workers send hits only through pipes — pipe stays near-empty at all times
| Operation | Speed |
|---|---|
| Wallet generation (coincurve) | 500–2000/s per core |
| DB lookup (SQLite, 100M rows) | 50k–200k addr/s per worker |
| Online API balance check | 1–2/s (rate-limited) |
Option 2 scales linearly with CPU cores — each core runs a full generate+lookup pipeline independently.
- ✔ Recovery of your own wallets
- ✔ Education and research
- ❌ Unauthorized access to others' wallets
- ❌ Theft or any illegal activity
MIT — see LICENSE.