# bitcoio.org — Gerador e Consultor de Seeds

Ferramenta educacional para **gerar seeds Bitcoin (BIP39)** e **consultar o saldo** usando um nó Bitcoin completo local.

> ⚠️ **Aviso importante:** este script é para **estudo** e para **verificar as suas próprias seeds**. Gerar seeds aleatórias na esperança de "achar" uma carteira com saldo é matematicamente impossível (~1 em 10³⁰). Veja a explicação em [bitcoio.org](https://bitcoio.org).

---

## O que ele faz

1. **Gera** seeds BIP39 de 12 palavras (128 bits de entropia criptograficamente segura).
2. **Deriva** os endereços em vários padrões: `BIP44` (legacy), `BIP49` (segwit p2sh), `BIP84` (segwit), `BIP86` (taproot) e Electrum.
3. **Consulta o saldo** de todos via `scantxoutset` no seu nó local.
4. **Reporta** apenas as carteiras **com saldo > 0**.

---

## Arquivos

| Arquivo | Descrição |
|---------|-----------|
| `gerador_seeds.py` | Script principal (Python 3, sem dependências pip). |
| `bip39_english.txt` | Lista oficial de 2048 palavras do padrão BIP39 (obrigatória). |

---

## Requisitos

1. **Python 3.8+** (usa apenas a biblioteca padrão: `ctypes`, `urllib`, `multiprocessing`, `hashlib`...).
2. **Um nó Bitcoin Core** rodando localmente com RPC habilitado (`server=1` + `rpcuser`/`rpcpassword` no `bitcoin.conf`).
3. **`libsecp256k1.so`** (opcional, mas recomendado) — acelera a derivação em ~35x. Sem ele, o script usa um fallback mais lento.

---

## Como rodar

1. Coloque `gerador_seeds.py` e `bip39_english.txt` no mesmo diretório.
2. Ajuste as constantes no topo do script (datadir, credenciais RPC, etc.):
   ```python
   RPC_USER = "seu_usuario"
   RPC_PASS = "sua_senha"
   RPC_URL = "http://127.0.0.1:8332"
   ```
3. Execute:
   ```bash
   python3 gerador_seeds.py
   ```

O script é interativo — ele pergunta:
- Quantas seeds gerar por rodada.
- Se quer adicionar alguma seed manual (para checar as suas).
- Quantas rodadas repetir com novas gerações.

---

## Exemplo de uso legítimo

Para **conferir uma seed que é sua** (descobrir em qual caminho e endereço estão seus fundos), rode o script e cole a sua seed na opção "adicionar seed manual". Ele deriva BIP44/49/84/86 + Electrum e aponta exatamente onde há saldo.

---

## Segurança

- Com a configuração padrão (`REAL_ENTROPY_BYTES = 16`), as seeds têm 128 bits de entropia real (seguras).
- A seed nunca sai da sua máquina — tudo é local.
- Nunca compartilhe suas seeds. Quem as tiver, controla seus fundos.

---

## Disclaimer

Projeto educacional. Não é aconselhamento financeiro. Não use para tentar acessar fundos de terceiros — além de fútil, seria ilegal.