vuke

Ferramenta de pesquisa para analisar e reproduzir geração vulnerável de chaves Bitcoin.

Funcionalidades

• Arquitetura modular - fontes e transformações conectáveis
• Múltiplas fontes de entrada
  • Intervalos numéricos (testar sementes fracas)
  • Listas de palavras (análise de brainwallet)
  • Carimbos de data/hora (exploração de PRNG baseada em tempo)
  • Streaming de stdin (integração com pipelines)
• Transformações de vulnerabilidades históricas
  • Direta (bytes brutos como chave)
  • SHA256 (brainwallet clássico)
  • Double SHA256 (hashing estilo Bitcoin)
  • MD5 (hashing fraco legado)
  • Cadeia SHA256 (derivação determinística iterada/indexada)
  • Milksad (MT19937 PRNG - CVE-2023-39910)
  • MultiBit HD (bug de semente como entropia)
  • Electrum pré-BIP39 (derivação determinística 2011-2014)
  • Armory (derivação HD legada)
• Análise de origem de chave - detecção reversa de métodos de geração vulneráveis
• Processamento paralelo via Rayon
• Correspondência de endereços para escaneamento de alvos conhecidos
• Saída em arquivo para salvar resultados
• Armazenamento em nuvem - upload assíncrono para S3/R2/MinIO
• Implementação pura em Rust

Por que este projeto?

Esta ferramenta é projetada para pesquisa em segurança - entender como chaves vulneráveis foram geradas no passado ajuda a melhorar a segurança moderna de carteiras.

Vulnerabilidades históricas que esta ferramenta pode reproduzir:

Instalação

Cargo```bash

cargo install vuke

### Da fonte```bash
git clone https://github.com/oritwoen/vuke
cd vuke
cargo build --release

Uso

Gerar chave única a partir de frase secreta```bash

vuke single "correct horse battery staple" --transform sha256

Saída:```
Passphrase: "correct horse battery staple"
Transform: sha256
Source: correct horse battery staple
---
Private Key (hex):     c4bbcb1fbec99d65bf59d85c8cb62ee2db963f0fe106f483d9afa73bd4e39a8a
WIF (compressed):      L3p8oAcQTtuokSCRHQ7i4MhjWc9zornvpJLfmg62sYpLRJF9woSu
---
P2PKH (compressed):   1JwSSubhmg6iPtRjtyqhUYYH7bZg3Lfy1T
P2WPKH:               bc1qfnpg7ceg02y64qrskgz0drwp3y6hma3q6wvnzr

Varrer wordlist por endereços conhecidos```bash

vuke scan --transform=sha256 --targets known_addresses.txt wordlist --file passwords.txt

### Provedores de Dados

Em vez de caminhos de arquivo, use referências de provedor para carregamento dinâmico de alvos:```bash
# Scan all unsolved b1000 puzzles
vuke scan --transform=milksad --targets boha:b1000:unsolved range --start 1 --end 1000000

# Scan specific collection with filter
vuke scan --transform=sha256 --targets boha:b1000:with-pubkey wordlist --file words.txt

# Available filters: all, unsolved, solved, with-pubkey
vuke scan --targets boha:hash_collision:unsolved wordlist --file words.txt

Provider syntax: provider:collection:filter or provider:collection:id

Available collections (boha provider):

• b1000 - Puzzle Bitcoin 1000 (256 puzzles, 1-256 bits)
• gsmg - Puzzle GSMG
• bitaps - Puzzle Bitaps
• hash_collision - Puzzles de colisão de hash
• zden - Puzzles Zden
• bitimage - Puzzles Bitimage

Testar intervalo numérico (sementes fracas)```bash

vuke generate --transform=milksad range --start 1 --end 1000000

### Testar chaves baseadas em LCG```bash
# Generate keys using glibc rand() (default big-endian)
vuke generate --transform=lcg:glibc range --start 1 --end 1000000

# Use MINSTD variant with big-endian byte order
vuke generate --transform=lcg:minstd:be range --start 1 --end 1000

# Test all LCG variants at once
vuke generate --transform=lcg range --start 1 --end 100

Teste xorshift-based keys```bash

Generate keys using all xorshift variants (requires cascade filter for analysis)

vuke generate --transform=xorshift range --start 1 --end 1000000

Use specific variant

vuke generate --transform=xorshift:64 range --start 1 --end 1000 vuke generate --transform=xorshift:128 range --start 1 --end 1000 vuke generate --transform=xorshift:128plus range --start 1 --end 1000 vuke generate --transform=xorshift:xoroshiro range --start 1 --end 1000

### Testar chaves baseadas em timestamp```bash
vuke scan --transform=sha256 --targets addresses.txt timestamps --start 2015-01-01 --end 2015-01-31

Derivar chaves de arquivos (Bitimage)```bash

Generate key from a single file

vuke generate --transform=bitimage files --file image.jpg

Scan directory recursively

vuke generate --transform=bitimage files --dir ./images/

With custom derivation path and passphrase

vuke generate --transform=bitimage --bitimage-path "m/44'/0'/0'/0/0" --bitimage-passphrase "secret" files --file photo.png

Derive multiple addresses per file

vuke generate --transform=bitimage --bitimage-derive-count 10 files --dir ./data/

Brute-force passphrases from wordlist

vuke scan --transform=bitimage --bitimage-passphrase-wordlist passphrases.txt --targets addresses.txt files --dir ./images/

### Múltiplas transformações```bash
vuke scan --transform=sha256 --transform=double_sha256 --transform=md5 --targets addresses.txt wordlist --file words.txt

Pipe do stdin```bash

cat passwords.txt | vuke generate --transform=sha256 stdin

### Salvar resultados em arquivo```bash
vuke generate --output results.csv range --start 1 --end 1000000
vuke generate --output results.txt --verbose range --start 1 --end 1000
vuke scan --output hits.txt --targets addresses.txt wordlist --file passwords.txt

Armazenamento persistente (Parquet)

Armazena resultados no formato Parquet para análise em escala de TB (requer a funcionalidade storage):```bash

Build with storage support

cargo build --release --features storage

Store generated keys to Parquet

vuke generate --storage ./results --transform milksad range --start 1 --end 1000000

Configure chunk rotation

vuke generate --storage ./results --chunk-records 500000 --chunk-bytes 50M range --start 1 --end 10000000

Configure compression (default: zstd level 3)

vuke generate --storage ./results --compression zstd --compression-level 9 range --start 1 --end 1000000

No compression (fastest writes)

vuke generate --storage ./results --compression none range --start 1 --end 1000000

Available algorithms: none, snappy, gzip, lz4, zstd

### Consultar resultados armazenados (SQL)

Consulte arquivos Parquet armazenados usando SQL (requer o recurso `storage-query`):```bash
# Build with query support
cargo build --release --features storage-query

# Count results by transform
vuke query ./results "SELECT transform, COUNT(*) FROM results GROUP BY transform"

# Find matches
vuke query ./results "SELECT * FROM results WHERE matched_target IS NOT NULL LIMIT 10"

# Export to JSON
vuke query ./results --format json "SELECT source, wif_compressed FROM results LIMIT 100"

# Export to CSV
vuke query ./results --format csv "SELECT address_p2pkh_compressed, wif_compressed FROM results" > export.csv

# Show schema
vuke query ./results --schema

Formatos de saída: table (padrão), json, csv

Upload para nuvem (compatível com S3)

Fazer upload de resultados Parquet para armazenamento compatível com S3 (requer o recurso storage-cloud):```bash

Build with cloud upload support

cargo build --release --features storage-cloud

Set credentials (AWS S3)

export AWS_ACCESS_KEY_ID=your_key export AWS_SECRET_ACCESS_KEY=your_secret

Upload to AWS S3

vuke generate --storage ./results --cloud-upload --cloud-bucket my-bucket
--transform milksad range --start 1 --end 1000000

Upload to Cloudflare R2

vuke generate --storage ./results --cloud-upload
--cloud-endpoint https://account.r2.cloudflarestorage.com
--cloud-bucket my-r2-bucket
--transform milksad range --start 1 --end 1000000

Upload to MinIO (self-hosted)

vuke generate --storage ./results --cloud-upload
--cloud-endpoint http://localhost:9000
--cloud-bucket vuke-results
--transform milksad range --start 1 --end 1000000

Delete local files after successful upload

vuke generate --storage ./results --cloud-upload --cloud-bucket my-bucket
--cloud-delete-local
--transform milksad range --start 1 --end 1000000

Fail fast on upload errors (default: continue on failures)

vuke generate --storage ./results --cloud-upload --cloud-bucket my-bucket
--cloud-fail-fast
--transform milksad range --start 1 --end 1000000

Recursos de upload na nuvem:
- Upload multipart em streaming (eficiente em memória para arquivos grandes)
- Tentativa automática com backoff exponencial (5 tentativas, 100ms→30s)
- Uploads simultâneos com paralelismo configurável
- Apenas exclui arquivos locais que foram carregados com sucesso

### Registro no catálogo Iceberg

Registre arquivos Parquet carregados em um catálogo Apache Iceberg para consultas SQL (requer o recurso `storage-iceberg`):```bash
# Build with Iceberg support
cargo build --release --features storage-iceberg

# Set credentials
export CLOUD_ACCESS_KEY_ID=your_key
export CLOUD_SECRET_ACCESS_KEY=your_secret

# Generate, upload, and register in Iceberg catalog
vuke generate --storage ./results --cloud-upload --cloud-bucket my-bucket \
  --iceberg-catalog http://localhost:8181 \
  --transform milksad range --start 1 --end 1000000

# With custom namespace and table name
vuke generate --storage ./results --cloud-upload --cloud-bucket my-bucket \
  --iceberg-catalog http://localhost:8181 \
  --iceberg-namespace my_namespace \
  --iceberg-table my_results \
  --transform milksad range --start 1 --end 1000000

# Using environment variables
export ICEBERG_CATALOG=http://localhost:8181
export ICEBERG_NAMESPACE=vuke
export ICEBERG_TABLE=results
vuke generate --storage ./results --cloud-upload --cloud-bucket my-bucket \
  --transform milksad range --start 1 --end 1000000

Recursos do catálogo Iceberg:

• Protocolo de catálogo REST (compatível com Apache Polaris, Nessie, Tabular, etc.)
• Criação automática de tabelas com esquema e especificação de partição
• Particionado por transform (identidade) e timestamp (dia)
• Credenciais compartilhadas com upload para a nuvem (variáveis de ambiente CLOUD_/AWS_)

Benchmark de transformações```bash

vuke bench --transform milksad

### Analisar origem da chave privada

Verificar se uma chave privada pode ter sido gerada por um método vulnerável:```bash
vuke analyze c4bbcb1fbec99d65bf59d85c8cb62ee2db963f0fe106f483d9afa73bd4e39a8a

Saída:``` Private Key: c4bbcb1fbec99d65bf59d85c8cb62ee2db963f0fe106f483d9afa73bd4e39a8a Bit Length: 256 Hamming Weight: 144

Analysis: ✗ milksad: NOT_FOUND (checked 4294967296 seeds) ✗ direct: NOT_FOUND (no direct patterns detected) ? heuristic: UNKNOWN (entropy=5.00, hamming=144)

Modo rápido (pular força bruta):```bash
vuke analyze --fast L3p8oAcQTtuokSCRHQ7i4MhjWc9zornvpJLfmg62sYpLRJF9woSu

Saída JSON:```bash vuke analyze --fast --json c4bbcb1f...

Analisador específico:```bash
vuke analyze --analyzer milksad c4bbcb1f...

LCG analyzer

Verifique se uma chave foi gerada usando um Gerador Congruencial Linear:```bash

Check all LCG variants

vuke analyze --analyzer lcg

Check specific variant and endianness

vuke analyze --analyzer lcg:glibc:le

With masking for puzzle analysis

vuke analyze --analyzer lcg:glibc --mask 5 0x15

### Análise de chave mascarada (puzzles estilo BTC1000)

Alguns puzzles Bitcoin usam um esquema de mascaramento onde:
1. Uma chave completa de 256 bits é gerada (ex.: a partir do MT19937)
2. A chave é mascarada para N bits com o bit mais alto forçado a 1

Fórmula: `masked_key = (full_key & (2^N - 1)) | 2^(N-1)````bash
# Analyze 5-bit puzzle key 0x15
vuke analyze 0x15 --mask 5 --analyzer milksad

Saída:``` Private Key: 0000000000000000000000000000000000000000000000000000000000000015 Bit Length: 5 Hamming Weight: 3

Analysis: ✓ milksad: CONFIRMED (seed=1610000002, full_key=7ed2...5055, masked=0x15, mask_bits=5, formula=(key & 0x1f) | 0x10)

INPUT:```bash
# Analyze 10-bit puzzle key
vuke analyze 0x202 --mask 10 --analyzer milksad

Filtro em cascata (verificação de múltiplos puzzles)

Ao analisar chaves mascaradas, uma correspondência de um único bit pequeno tem altas taxas de falsos positivos. O filtro em cascata verifica candidatos em relação a múltiplas chaves de puzzle conhecidas:```bash

Verify seed against multiple puzzles with increasing bit widths

vuke analyze 0x16 --analyzer milksad --cascade "5:0x16,10:0x273,15:0x7a85"

Saída:```
Private Key: 0000000000000000000000000000000000000000000000000000000000000016
Bit Length:  5
Hamming Weight: 3
---
Analysis:
  ✓ milksad: CONFIRMED (seed=100 (0x00000064))
  P5: target=0x16, full_key=08961c8b18dbd0ab4337434767df7b69572fad6c4f00c186b03f43d88af70a26
  P10: target=0x273, full_key=5e413501b4371e2862271f1f3550bc2f4236b6abe29ec9350e166bd322c3e673
  P15: target=0x7a85, full_key=f133ff22f0aac1de185139938f664d10e4ac2de46be7d29f3c458e353a1efa85)

O formato em cascata é bits:target,bits:target,... onde:

• bits é a largura da máscara (1-64)
• target é hex (com prefixo 0x) ou decimal

Análise de probabilidade:

• P5 sozinho: 1/16 de chance de falso positivo
• P5 + P10: 1/16 × 1/512 = 1/8192
• P5 + P10 + P15: falso positivo virtualmente impossível

Análise baseada em provedores

Use provedores de dados para configurar automaticamente a análise de puzzles:```bash

Auto-set mask from puzzle bits (puzzle #5 = 5 bits)

vuke analyze 0x15 --puzzle boha:b1000:5

Build cascade from solved neighbors (3 puzzles before #5)

vuke analyze 0x15 --cascade boha:b1000:5:3 --analyzer milksad

Verify key against entire collection

vuke analyze 0x01 --verify boha:b1000

JSON output for scripting

vuke analyze 0x01 --verify boha:b1000 --json

A bandeira `--puzzle`:
- Carrega o contexto do puzzle do provedor
- Define automaticamente `--mask` a partir de puzzle.key.bits
- Exibe o endereço esperado para verificação

A `--cascade` com provedor:
- Formato: `boha:collection:puzzle_id:neighbor_count`
- Constrói cascata a partir de N puzzles resolvidos antes do alvo
- Padrão: 5 vizinhos se a contagem não for especificada

### Analisador MT19937-64 (sementes de 64 bits)

Para testar hipóteses de sementes de 64 bits, o analisador `mt64` **requer** filtro de cascata
(o espaço de semente de 64 bits não pode ser pesquisado exaustivamente):```bash
# MT19937-64 cascade search - REQUIRES cascade filter
vuke analyze 0x15 --analyzer mt64 --cascade "5:0x15,10:0x202,20:0xd2c55,30:0x3d94cd64"

Progresso mostra a taxa de busca e acertos do filtro em cascata:``` ⠋ Searched: 1200000 seeds | Rate: 850K/s | Elapsed: 1.4s | Cascade hits: 73

### Analisador Xorshift (sementes de 64 bits)

Xorshift PRNGs (usados nos motores JavaScript V8/SpiderMonkey) também exigem filtro em cascata
devido ao espaço de sementes de 64 bits:```bash
# Test all xorshift variants
vuke analyze 0x15 --analyzer xorshift --cascade "5:0x15,10:0x202,20:0xd2c55"

# Test specific variant
vuke analyze 0x15 --analyzer xorshift:64 --cascade "5:0x15,10:0x202,20:0xd2c55"
vuke analyze 0x15 --analyzer xorshift:128plus --cascade "5:0x15,10:0x202,20:0xd2c55"

Variantes suportadas:

• xorshift:64 - Xorshift clássico de estado de 64 bits
• xorshift:128 - Xorshift de estado de 128 bits (semente inicializada como (seed, 0))
• xorshift:128plus - Xorshift128+ (usado no V8/SpiderMonkey Math.random())
• xorshift:xoroshiro - Xoroshiro128** (variante moderna)

Analisador MultiBit HD (bug da semente como entropia)

O MultiBit HD Beta 7 (2014-2016) tinha um bug onde a semente BIP39 de 64 bytes era passada diretamente para o construtor DeterministicSeed do BitcoinJ como entropia (esperado 16-32 bytes). Isso criava chaves incompatíveis que não podem ser recuperadas com ferramentas BIP39 padrão.```bash

Check if a key was generated by the MultiBit HD bug

vuke analyze --analyzer multibit-hd --mnemonic "word1 word2 ... word12"

Test with a specific passphrase

vuke analyze --analyzer multibit-hd --mnemonic "word1 word2 ..." --passphrase "my passphrase"

Dictionary attack with mnemonic file

vuke analyze --analyzer multibit-hd --mnemonic-file candidates.txt

Gerar chaves defeituosas a partir de um mnemônico conhecido:```bash
vuke single "skin join dog sponsor camera puppy ritual diagram arrow poverty boy elbow" --transform=multibit

Saída (primeira chave em m/0'/0/0):``` P2PKH (compressed): 1LQ8XnNKqC7Vu7atH5k4X8qVCc9ug2q7WE

Isso corresponde ao endereço com bug do [MultiBit HD issue #445](https://github.com/Multibit-Legacy/multibit-hd/issues/445).
O endereço BIP39 correto seria `12QxtuyEM8KBG3ngNRe2CZE28hFw3b1KMJ`.

### Chaves Electrum pré-BIP39 (2011-2014)

Carteiras Electrum antes da adoção do BIP39 usavam um esquema de derivação determinística personalizado:
- Semente hex de 128 bits expandida via 100.000 iterações SHA256
- Chaves filhas derivadas como `(master + sequence) mod n`
- Chaves públicas não comprimidas para endereços

Gere chaves de uma semente Electrum antiga:```bash
# Generate receiving chain addresses (first 20 keys)
vuke single "acb740e454c3134901d7c8f16497cc1c" --transform electrum

# Generate change chain addresses
vuke single "acb740e454c3134901d7c8f16497cc1c" --transform electrum:change

Saída (endereço de recebimento 0):``` P2PKH (uncompressed): 1FJEEB8ihPMbzs2SkLmr37dHyRFzakqUmo

### Analisador de cadeia SHA256

Detecta chaves geradas usando cadeias SHA256 determinísticas (key[n] = SHA256(key[n-1]) ou SHA256(seed || n)):```bash
# Check with iterated chain (default): key[n] = SHA256(key[n-1])
vuke analyze <KEY> --analyzer sha256_chain --chain-depth 20

# Check indexed variant: key[n] = SHA256(seed || n as bytes)
vuke analyze <KEY> --analyzer sha256_chain:indexed --chain-depth 20

# With masking for puzzle analysis
vuke analyze 0x15 --mask 5 --analyzer sha256_chain --chain-depth 10

# With cascade filter for reduced false positives
vuke analyze 0x15 --analyzer sha256_chain --cascade "5:0x15,10:0x202" --chain-depth 10

Variantes suportadas:

• sha256_chain ou sha256_chain:iterated - Derivação em cadeia: key[n] = SHA256(key[n-1])
• sha256_chain:indexed ou sha256_chain:indexed:be - Indexada: SHA256(seed || n) com big-endian
• sha256_chain:indexed:le - Indexada com ordem de bytes little-endian
• sha256_chain:counter - Indexada por string: SHA256(seed || "n")

Transformação da cadeia SHA256

Gerar chaves usando derivação em cadeia SHA256:```bash

Generate iterated chain keys from numeric seeds

vuke generate --transform=sha256_chain range --start 1 --end 1000

Generate indexed chain with counter strings

vuke generate --transform=sha256_chain:counter --chain-depth 5 wordlist --file seeds.txt

Generate with specific chain depth

vuke generate --transform=sha256_chain:iterated --chain-depth 10 range --start 1 --end 100

## Transformações Suportadas

| Transform | Descrição | Caso de Uso |
|-----------|-------------|----------|
| `direct` | Bytes brutos preenchidos até 32 bytes | Testar sementes numéricas brutas |
| `sha256` | SHA256(entrada) | Brainwallets clássicos |
| `double_sha256` | SHA256(SHA256(entrada)) | Hashing estilo Bitcoin |
| `md5` | MD5(entrada) duplicado para 32 bytes | Hashing fraco legado |
| `milksad` | PRNG MT19937 com semente de 32 bits | CVE-2023-39910 (libbitcoin) |
| `mt64` | PRNG MT19937-64 com semente de 64 bits | Teste de hipótese de semente de 64 bits |
| `multibit` | Bug de semente-como-entropia do MultiBit HD | Carteiras MultiBit HD de 2014-2016 |
| `armory` | Cadeia de derivação HD do Armory | Carteiras pré-BIP32 |
| `electrum` | Derivação pré-BIP39 do Electrum | Carteiras Electrum de 2011-2014 |
| `electrum:change` | Cadeia de troco do Electrum | Endereços de troco Electrum de 2011-2014 |
| `lcg[:variant][:endian]` | PRNG LCG com semente de 32 bits | rand() da stdlib C legada |
| `xorshift[:variant]` | PRNG Xorshift com semente de 64 bits | Math.random() do V8/SpiderMonkey |
| `sha256_chain[:variant]` | Cadeia SHA256 determinística | Derivação de chave iterada/indexada |
| `bitimage` | Arquivo→base64→SHA256→BIP39→HD | Derivação de chave de puzzle Bitimage |

## Analisadores Suportados

| Analisador | Método | Caso de Uso |
|----------|--------|----------|
| `milksad` | Força bruta de 2^32 sementes | Verificar se a chave é vítima do Milksad |
| `milksad --mask N` | Força bruta com mascaramento de N bits | Análise de puzzle estilo BTC1000 |
| `milksad --cascade` | Verificação sequencial multi-alvo | Reduzir falsos positivos em pesquisa de puzzles |
| `mt64 --cascade` | Força bruta de 2^64 com filtro em cascata | Hipótese de PRNG de 64 bits para BTC1000 |
| `multibit-hd --mnemonic` | Testar mnemônico contra a chave | Verificar origem do bug MultiBit HD |
| `multibit-hd --mnemonic-file` | Ataque de dicionário | Encontrar mnemônico para chave MultiBit HD |
| `direct` | Detecção de padrões | Detectar sementes pequenas, strings ASCII |
| `heuristic` | Análise estatística | Anomalias de entropia, peso de Hamming |
| `lcg[:variant][:endian]` | Força bruta de 2^31-2^32 sementes | Detectar rand() glibc/minstd/msvc/borland |
| `xorshift[:variant] --cascade` | Força bruta de 2^64 com filtro em cascata | PRNGs xorshift do V8/SpiderMonkey |
| `sha256_chain[:variant]` | Força bruta de 2^32 sementes com profundidade de cadeia | Cadeias de chave SHA256 determinísticas |

## Uso da Biblioteca```rust
use vuke::derive::KeyDeriver;
use vuke::transform::{Input, Transform, Sha256Transform};

fn main() {
    let deriver = KeyDeriver::new();
    let transform = Sha256Transform;

    let input = Input::from_string("test passphrase".to_string());
    let mut buffer = Vec::new();
    transform.apply_batch(&[input], &mut buffer);

    for (source, key) in buffer {
        let derived = deriver.derive(&key);
        println!("Source: {}", source);
        println!("WIF: {}", derived.wif_compressed);
        println!("Address: {}", derived.p2pkh_compressed);
    }
}

Arquitetura```

src/ ├── main.rs # CLI entry point (clap derive) ├── lib.rs # Library exports ├── derive.rs # Private key → address derivation ├── matcher.rs # Address matching against targets ├── network.rs # Bitcoin network handling ├── benchmark.rs # Performance testing ├── provider.rs # Data provider system (boha puzzles) ├── lcg.rs # LCG PRNG shared logic ├── xorshift.rs # Xorshift PRNG shared logic ├── mt64.rs # MT19937-64 PRNG shared logic ├── multibit.rs # MultiBit HD bug logic (PBKDF2, BIP32) ├── electrum.rs # Electrum pre-BIP39 deterministic derivation ├── sha256_chain.rs # SHA256 chain shared logic (iterated/indexed) ├── bitimage.rs # Bitimage puzzle derivation logic ├── analyze/ │ ├── mod.rs # Analyzer trait and types │ ├── key_parser.rs # Parse hex/WIF/decimal keys │ ├── output.rs # Plain text and JSON formatting │ ├── milksad.rs # MT19937 brute-force (GPU accelerated) │ ├── mt64.rs # MT19937-64 brute-force (requires cascade) │ ├── multibit.rs # MultiBit HD mnemonic verification │ ├── lcg.rs # LCG brute-force (glibc, minstd, msvc, borland) │ ├── xorshift.rs # Xorshift brute-force (requires cascade) │ ├── sha256_chain.rs # SHA256 chain brute-force (GPU accelerated) │ ├── direct.rs # Pattern detection │ └── heuristic.rs # Statistical analysis ├── source/ │ ├── mod.rs # Source trait and types │ ├── range.rs # Numeric range source │ ├── wordlist.rs # File-based wordlist │ ├── timestamps.rs # Date range → Unix timestamps │ ├── stdin.rs # Streaming from stdin │ └── files.rs # File/directory source for binary data ├── output/ │ ├── mod.rs # Output trait │ ├── console.rs # Console output (compact CSV + verbose YAML) │ ├── multi.rs # Multi-output dispatcher │ ├── storage.rs # Parquet backend bridge (feature: storage) │ └── query_format.rs # DuckDB result formatting (feature: storage-query) ├── transform/ │ ├── mod.rs # Transform trait and types │ ├── input.rs # Input value representation │ ├── direct.rs # Raw bytes transform │ ├── sha256.rs # SHA256 hashing │ ├── double_sha256.rs # Double SHA256 │ ├── md5.rs # MD5 hashing │ ├── milksad.rs # MT19937 PRNG (CVE-2023-39910) │ ├── mt64.rs # MT19937-64 PRNG transform │ ├── multibit.rs # MultiBit HD seed-as-entropy bug │ ├── electrum.rs # Electrum pre-BIP39 deterministic derivation │ ├── lcg.rs # LCG PRNG transform │ ├── xorshift.rs # Xorshift PRNG transform │ ├── sha256_chain.rs # SHA256 chain transform │ ├── bitimage.rs # File-derived HD keys (Bitimage puzzle) │ └── armory.rs # Armory HD derivation ├── gpu/ # WebGPU acceleration (feature: gpu) │ ├── mod.rs # Module exports │ ├── context.rs # GPU device initialization │ ├── error.rs # GPU error types │ ├── buffer.rs # GPU buffer utilities │ ├── hash.rs # SHA256/MD5 hash pipelines │ ├── mt19937.rs # MT19937 brute-force pipeline │ ├── sha256_chain.rs # SHA256 chain pipeline │ └── shaders/ # WGSL compute shaders │ ├── mt19937.wgsl │ ├── sha256.wgsl │ └── md5.wgsl └── storage/ # Persistent storage (feature: storage) ├── mod.rs # StorageBackend trait ├── schema.rs # Arrow schema definitions ├── parquet_backend.rs # Parquet file writer with auto-chunking ├── query.rs # DuckDB SQL executor (feature: storage-query) ├── cloud/ # S3-compatible upload (feature: storage-cloud) │ ├── mod.rs # CloudUploader trait │ ├── s3.rs # S3/R2/MinIO implementation │ ├── credentials.rs # Credential resolution │ ├── sync.rs # Batch upload with concurrency │ ├── progress.rs # Upload progress tracking │ └── error.rs # Cloud error types └── iceberg/ # Iceberg catalog (feature: storage-iceberg) ├── mod.rs # Iceberg integration entry ├── catalog.rs # REST catalog client ├── schema.rs # Iceberg schema mapping ├── partition.rs # Partition spec └── error.rs # Iceberg error types

## Requisitos

- Rust 1.70+

## Aviso Legal

Esta ferramenta é apenas para **fins educacionais e de pesquisa em segurança**. Não a utilize para acessar carteiras que não sejam suas. Os autores não são responsáveis por qualquer uso indevido.

## Licença

Licença MIT - consulte [LICENSE](https://github.com/oritwoen/vuke/blob/HEAD/LICENSE) para obter detalhes.

## Referências

- [Vulnerabilidade Milksad](https://milksad.info/) - CVE-2023-39910
- [Issue #445 do MultiBit HD](https://github.com/Multibit-Legacy/multibit-hd/issues/445) - Bug de semente como entropia
- [Ataques a Brainwallet](https://eprint.iacr.org/2016/103.pdf) - Artigo acadêmico
- [Documentação do Armory](https://btcarmory.com/) - Carteira HD legada
- [Gerador Linear Congruencial](https://en.wikipedia.org/wiki/Linear_congruential_generator) - Wikipedia
- [PRNGs Xorshift](https://en.wikipedia.org/wiki/Xorshift) - Wikipedia
- [Derivação de chave do Electrum 1.x](https://github.com/spesmilo/electrum/blob/b9196260cfd515363a026c3bfc7bc7aa757965a0/lib/bitcoin.py) - Código-fonte pré-BIP39