A sovereign, cryptocurrency-grade folder and file encryption engine and CLI written in Rust.
BlockVault secures local directories and individual files using the same cryptographic primitives that protect decentralized blockchain networks: BIP-39 mnemonic seeds, Scrypt key derivation, AES-256-GCM authenticated encryption, and domain-separated Merkle trees.
- BIP-39 Mnemonic Seed Phrases: Generates 12-word (128-bit) or 24-word (256-bit) recovery seed phrases using the official 2,048-word BIP-39 dictionary.
- BIP-39 Optional Passphrase: Supports the "13th/25th word" feature for plausible deniability and multi-factor defense.
- Scrypt Key Derivation: Employs Ethereum-standard memory-hard Scrypt parameters (
N=16384, r=8, p=1) to prevent GPU and ASIC cracking attacks. - AES-256-GCM Authenticated Encryption: Uses Galois/Counter Mode with a 128-bit authentication tag and Additional Authenticated Data (AAD) to ensure privacy and tamper detection.
- Zeroize Memory Hardening: Securely wipes encryption keys, seeds, and plaintext buffers from RAM on drop to thwart cold-boot and memory dump attacks.
- Domain-Separated Merkle Trees: Recursively hashes files via SHA-256 (
0x00leaf prefix,0x01branch prefix, per RFC 6962) to produce an immutable root hash for bit-level integrity verification. - EIP-55 Wallet Identity: Derives a checksummed Ethereum-style creator address from each seed.
Automatically builds and installs the standalone binary into ~/.local/bin:
curl -fsSL https://raw.githubusercontent.com/chronoarchon/blockvault/main/install.sh | bashInstall directly via the one-line PowerShell script or Cargo:
# One-Line Native Installer (PowerShell)
irm https://raw.githubusercontent.com/chronoarchon/blockvault/main/install.ps1 | iex
# Or via Cargo:
cargo install --git https://github.com/chronoarchon/blockvault.gitgit clone https://github.com/chronoarchon/blockvault.git
cd blockvault
cargo build --release
cp target/release/blockvault ~/.local/bin/Encrypts ~/Downloads/documents into ~/Downloads/documents.block and outputs your 12-word recovery seed phrase:
blockvault lock ~/Downloads/documentsGenerates a 256-bit 24-word seed and applies an optional passphrase (the 25th word protection):
blockvault lock ~/Projects/secret-app --words 24 --passphrase "MyPassphrase#2026"Encrypts the target directory and securely deletes the unencrypted source folder upon completion:
blockvault lock ~/Documents/private-vault --replaceSpecify an exact path for the output .block container:
blockvault lock ~/Downloads/data /backup/archives/data-2026.blockPrompts securely in your terminal for your 12 or 24-word seed phrase:
blockvault unlock ~/Downloads/documents.blockRestores the decrypted folder directly into a custom directory (e.g., ~/Restored):
blockvault unlock ~/Downloads/documents.block ~/RestoredIf you locked the block with a passphrase, provide it via -p or --passphrase:
blockvault unlock ~/Projects/secret-app.block ~/Restored -p "MyPassphrase#2026"Pass the recovery seed phrase directly for automated scripts or CI pipelines:
blockvault unlock data.block ~/Restored --phrase "word1 word2 word3 ... word12"Extracts the files and deletes the .block container file upon successful cryptographic verification:
blockvault unlock ~/Downloads/documents.block --replaceBlockVault stores an unencrypted public manifest header containing the creator wallet, Merkle root, file inventory, and cryptographic parameters. Anyone can audit file integrity without knowing the encryption key:
blockvault inspect ~/Downloads/documents.blockOutput:
╔════════════════════════════════════════════════════════════════════════╗
║ 🔎 BLOCKVAULT LEDGER INSPECTION
╠════════════════════════════════════════════════════════════════════════╣
║ Block Height: #1 (Genesis Block)
║ Container Size: 2100 bytes
║ Creator Wallet: 0xFCbd814d3B5a3186A0a3be96C93ae0e0f37288bB
║ Cryptography: AES-256-GCM + Scrypt-N16384-r8-p1
║ Merkle Root: 0xb5e06c7d4e1113e7db61421ca5bb17d34d665a5a4cd4c0d8c393ba8bbe998c84
║ Word Standard: 12-word BIP-39 (Standard)
╠════════════════════════════════════════════════════════════════════════╣
║ MERKLE TREE LEDGER MANIFEST:
╠════════════════════════════════════════════════════════════════════════╣
• invoice.pdf ( 2421 B) SHA256: d1b1cba0...
• backup.sql ( 2453 B) SHA256: 57b26344...
╚════════════════════════════════════════════════════════════════════════╝
BlockVault includes a 10-stage automated test suite that validates every cryptographic primitive, security boundary, and cross-platform edge case:
| Stage | Verification Focus | Status |
|---|---|---|
| Stage 1 | BIP-39 12/24-word generation, wordlist dictionary, and checksum validation | PASSED |
| Stage 2 | Passphrase entropy isolation (13th & 25th word deriving distinct keys) | PASSED |
| Stage 3 | Memory-hard Scrypt KDF ( |
PASSED |
| Stage 4 | AES-256-GCM authenticated encryption, AAD integrity, and tag verification | PASSED |
| Stage 5 | RFC 6962 Merkle tree determinism, cross-platform POSIX path normalization | PASSED |
| Stage 6 | End-to-end folder packing, public header inspection, and extraction | PASSED |
| Stage 7 | Complex multi-megabyte binary payloads, deep directory trees, and Unicode names | PASSED |
| Stage 8 | Tampered container bit-flip detection & wrong mnemonic phrase rejection | PASSED |
| Stage 9 | In-place locker mode (--replace) safe source deletion and cleanup |
PASSED |
| Stage 10 | Cross-platform path resolution, tilde expansion, and typo recovery | PASSED |
cargo testMIT License. Copyright (c) 2026 chronoarchon.



