Thanks to visit codestin.com
Credit goes to Github.com

Skip to content

feat(transform): add bitimage transform #58

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
oritwoen merged 3 commits into from
Jan 5, 2026
Merged

feat(transform): add bitimage transform #58

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
858eac9
feat(transform): add bitimage transform for file-derived keys
oritwoen Jan 5, 2026
36988e0
fix: address code review feedback
oritwoen Jan 5, 2026
25bb812
fix: track only successfully processed files in stats
oritwoen Jan 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions Cargo.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

1 change: 1 addition & 0 deletions Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ secp256k1 = { version = "0.29", features = ["global-context"] }
bitcoin = { version = "0.32", features = ["rand"] }
rand_mt = "4.2"
num-bigint = "0.4"
base64 = "0.22"

# GPU acceleration (optional)
wgpu = { version = "24", optional = true }
Expand Down
25 changes: 24 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -154,6 +154,25 @@ vuke generate --transform=xorshift:xoroshiro range --start 1 --end 1000
vuke scan --transform=sha256 --targets addresses.txt timestamps --start 2015-01-01 --end 2015-01-31
```

### Derive keys from files (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/
```

### Multiple transforms

```bash
Expand Down Expand Up @@ -597,6 +616,7 @@ vuke generate --transform=sha256_chain:iterated --chain-depth 10 range --start 1
| `lcg[:variant][:endian]` | LCG PRNG with 32-bit seed | Legacy C stdlib rand() |
| `xorshift[:variant]` | Xorshift PRNG with 64-bit seed | V8/SpiderMonkey Math.random() |
| `sha256_chain[:variant]` | Deterministic SHA256 chain | Iterated/indexed key derivation |
| `bitimage` | File→base64→SHA256→BIP39→HD | Bitimage puzzle key derivation |

## Supported Analyzers

Expand Down Expand Up @@ -653,6 +673,7 @@ src/
├── 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
Expand All @@ -670,7 +691,8 @@ src/
│ ├── range.rs # Numeric range source
│ ├── wordlist.rs # File-based wordlist
│ ├── timestamps.rs # Date range → Unix timestamps
│ └── stdin.rs # Streaming from stdin
│ ├── stdin.rs # Streaming from stdin
│ └── files.rs # File/directory source for binary data
├── storage/
│ ├── mod.rs # StorageBackend trait
│ ├── parquet_backend.rs # Parquet file writer
Expand All @@ -696,6 +718,7 @@ src/
│ ├── 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
└── output/
├── mod.rs # Output trait
Expand Down
Loading