https://github.com/fabohax/bloot
bitcoin seed phrase lottery bot
https://github.com/fabohax/bloot
bip39 bip84 bitcoin bot
Last synced: 1 day ago
JSON representation
bitcoin seed phrase lottery bot
- Host: GitHub
- URL: https://github.com/fabohax/bloot
- Owner: fabohax
- Created: 2026-04-28T01:42:45.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-12T08:15:33.000Z (19 days ago)
- Last Synced: 2026-06-12T10:10:50.868Z (18 days ago)
- Topics: bip39, bip84, bitcoin, bot
- Language: Python
- Homepage:
- Size: 35.2 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎲 Bitcoin Seed Phrase Lottery Bot
> **⚠️ Disclaimer:** This project is for educational and entertainment purposes only. Never use it with real funds. The probability of finding a funded address is astronomically low — this is a fun experiment, not a real way to get Bitcoin!
---
## 🚀 Features
- Generates random valid 12 or 24-word BIP39 seed phrases
- Derives the first Bitcoin Native SegWit (bc1q...) address (BIP84)
- Checks address balance and transaction count using mempool.space API
- **Saves successful mnemonics and addresses to a text file (`success.txt`) if a funded address is found**
- **Automatically attempts to send funds from found addresses to a preset destination if the address is funded**
- Beautiful, colorful real-time console output with [rich](https://github.com/Textualize/rich)
- Live statistics: attempts, speed, elapsed time, last address
- Batch display to avoid console flooding
- Command-line options for word count, passphrase, balance checking, and more
- Handles KeyboardInterrupt gracefully
---
## 🧠 How It Works
- **BIP39**: Standard for generating mnemonic seed phrases (12 or 24 words) that encode a cryptographic seed.
- **BIP84**: Standard for deriving Native SegWit (bech32/bc1q...) Bitcoin addresses from a seed.
- The bot generates a random mnemonic, derives the first receiving address, and checks if it has ever received Bitcoin.
---
## 🛠️ Installation
1. **Clone the repo:**
```bash
git clone https://github.com/fabohax/bloot.git
cd bloot
```
2. **Install dependencies:**
```bash
pip install -r requirements.txt
```
---
## ▶️ Usage
### Command-Line Options
- `--words 12|24` : Number of BIP39 words (default: 12)
- `--check-balance` : Enable balance checking (default: on)
- `--no-check-balance` : Disable balance checking (faster)
- `--passphrase ` : Optional BIP39 passphrase
- `--batch ` : Show every N attempts (default: 1)
- `--delay ` : Delay between attempts (default: 0)
**Example:**
```bash
python main.py --words 24 --no-check-balance --batch 10
```
or just:
```bash
setup.sh
```
---
## ⚡ Performance & Realistic Expectations
- **Speed:** With balance checking enabled, expect 1-2 attempts/sec (API limited). Without, hundreds/sec.
- **Probability:** The chance of finding a funded address is essentially zero. There are more possible seeds than atoms in the universe!
- **Purpose:** This is a fun, educational lottery—NOT a real way to get Bitcoin.
---
## 🖼️ Example Output
```
[FOUND] abandon castle ... zoo -> bc1qxyz... | Balance: 0 sats | TXs: 0
Attempts: 100 | Speed: 1.23/s | Elapsed: 81.2s | Last: bc1qxyz...
```
- Funded addresses are highlighted in green.
- Unfunded addresses are shown in white/red.
- Live stats update in real time.
---
## ⚠️ WARNING
- **Never use this tool with real funds or for malicious purposes.**
- All generated seeds are random and not recoverable.
- This project is for learning and fun only!
---
## 📚 References
- [BIP39](https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki)
- [BIP84](https://github.com/bitcoin/bips/blob/master/bip-0084.mediawiki)
- [bip-utils](https://github.com/ebellocchia/bip_utils)
- [rich](https://github.com/Textualize/rich)
- [mempool.space API](https://mempool.space/docs/api/)
---
## 👨💻 Author
- Created by @fabohax — inspired by the wild odds of Bitcoin!