Wallet Forge

100% client-side wallet data preparation tool with enterprise-grade validation

🔥 Features

Security First

🔒 100% Client-Side — Zero backend, zero network requests
🔒 No External Dependencies — All code runs locally
🔒 No Data Storage — Nothing saved to disk or cloud
🔒 Offline Ready — Works without internet connection
🔒 Open Source — Fully auditable single HTML file
🔥 Burn Session — Nuclear option to clear all data

Validation (v1.2, extended in v2.1)

✅ EIP-55 Checksum — Proper Ethereum address validation
✅ Private Key Format — 64-char hex with optional 0x prefix
✅ Real-Time Errors — Shows exact line numbers of invalid entries
✅ Count Mismatch Detection — Warns when PKs ≠ Addresses
✅ Zero-Key Detection — Prevents all-zero private keys
✅ BIP-39 Mnemonic Validation (v2.1) — Checks every word against the real 2048-word BIP-39 list and verifies the cryptographic checksum bits (via the browser's built-in Web Crypto SHA-256) — not just "is this 12 or 24 words"

Multi-Chain & Mnemonic Support (v2.0)

🌐 Multi-Chain Address Detection — Recognizes Ethereum (0x...), Bitcoin (legacy 1.../3... and bech32 bc1...), Tron (T...), and Solana addresses, with a per-chain breakdown next to the Addresses field
🌱 Mnemonic / Seed Phrase Field — Optional dedicated field for 12/15/18/21/24-word seed phrases, kept separate from private keys/addresses
📌 Extra Column — Optional free-text column for tags, labels, or amounts
🖊️ Custom Column Headers — Rename output columns to match whatever a downstream tool expects

Data Processing

🧹 Auto-Clean — Removes labels, quotes, and extra whitespace
🎲 Shuffle — Fisher-Yates randomization for security
🔄 Deduplicate — Remove duplicate wallet pairs
📏 Normalize — Lowercase and trim all entries
🔧 0x Formatting — Add or remove 0x prefix from private keys (v1.3)

Export Formats (v1.2, expanded in v2.0)

📋 Default — private_key, address (CSV)
🔑 Keys Only — Private keys (one per line)
🏠 Addresses Only — Addresses (one per line)
🌱 Mnemonics Only (v2.0) — Seed phrases (one per line)
🔢 Indexed — With row numbers for tracking
📄 TSV (v2.0) — Tab-separated, for tools that choke on commas
🧾 JSONL (v2.0) — One JSON object per line, useful for streaming into a bot/script

Import/Export

📂 JSON — Import/export structured wallet data (objects, or a flat array of keys/addresses)
📊 CSV / TSV — Standard spreadsheet formats
📄 TXT — Plain text lists (one per line)
🖱️ Drag & Drop (v2.0) — Drop a file anywhere on the page to import it
💾 Individual Downloads — Export keys or addresses separately

🚀 Quick Start

Use Online

Visit the deployed version: wallet-forge.vercel.app

Use Locally (Recommended for Maximum Security)

# 1. Clone the repository
git clone https://github.com/CryptoExplor/Wallet-Forge
cd Wallet-Forge/public

# 2. Disconnect from internet (optional but recommended)

# 3. Open in browser
open index.html  # macOS
start index.html # Windows
xdg-open index.html # Linux

Works 100% offline — no internet required after download.

Deploy Your Own

Vercel (Recommended)

git clone https://github.com/CryptoExplor/Wallet-Forge
cd Wallet-Forge
vercel deploy --prod

GitHub Pages

git clone https://github.com/CryptoExplor/Wallet-Forge
cd Wallet-Forge
# Enable Pages: Settings → Pages → Source: main → Folder: /public
git push origin main

Netlify Drop

Visit app.netlify.com/drop
Drag the public folder
Done!

📖 Usage

Basic Workflow

Import or paste wallet data (keys, addresses, or both)
Validation runs automatically — see errors in real-time
Process as needed — clean, shuffle, dedupe
Select export format — choose the output you need
Export in your preferred format

Validation Example

Input:
0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb  ❌ Invalid (missing char)
0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045  ✅ Valid

Result:
✓ Valid: 1  ✗ Invalid: 1
Bad lines: 1

Processing Options

Remove Duplicates — Enabled by default
Normalize — Lowercase + trim (enabled by default)
Pad Empty Values — Fill mismatched rows with blanks

Private Key Formatting (New in v1.3)

Choose how private keys are exported:

Keep As-Is — No modification (default)
Ensure 0x prefix — Add 0x to all keys
Remove 0x prefix — Strip 0x from all keys

Perfect for different tool compatibility (ethers.js, hardhat, etc.).

Export Presets (New in v1.2)

Perfect for bot integration:

Default — Full wallet pairs for record keeping
Keys Only — For ethers.js signer arrays
Addresses Only — For recipient lists
Indexed — For batch operations with tracking

Burn Session (New in v1.2)

Nuclear option for maximum security:

🔥 Burn Session → Clears all data + reloads page

Use after sensitive operations.

🔐 Security Model

Wallet Forge is designed to be maximally safe by default:

Core Principles

Runs entirely in your browser — No server-side processing
No backend — Zero API calls, zero data transmission
No analytics — Zero tracking or telemetry
No wallet connections — Doesn't interact with MetaMask, WalletConnect, etc.
No signing or transaction logic — Pure data preparation only
Can be used fully offline — Download once, use forever

Maximum Security Usage

For maximum security when handling sensitive data:

Download the files (index.html + sha3.min.js)
Disconnect from the internet (turn off WiFi/unplug ethernet)
Open in browser (works perfectly offline)
Use Wallet Forge normally (import, validate, export)
Burn session when done (clears all data + reloads)

What This Tool Does NOT Do

❌ No API calls to any server
❌ No external CDN dependencies (v1.2+)
❌ No analytics, cookies, or tracking
❌ No localStorage (except burn session)
❌ No wallet signing or transactions
❌ No network requests of any kind

Trust Verification

Verify it yourself:

# 1. Download the app
git clone https://github.com/CryptoExplor/Wallet-Forge
cd Wallet-Forge/public

# 2. Disconnect from internet
# (turn off WiFi or unplug ethernet)

# 3. Open in browser
open index.html

# 4. Tool works perfectly offline ✅

See SECURITY.md for complete verification guide.

Audit Trail

Single HTML file (~54KB as of v2.1 — see SECURITY.md for exact byte counts)
Local crypto library (sha3.min.js ~9.6KB)
No build process
No obfuscation
Fully inspectable source code
Content Security Policy enforced

Safe For

✅ Private key management
✅ Airdrop preparation
✅ Multi-wallet operations
✅ Dev/test workflows
✅ Offline environments
✅ Air-gapped systems

🎯 Use Cases

Airdrop Farming

Import wallet sets
Validate all addresses
Shuffle for randomness
Export for bot consumption

Bot Integration (v1.2)

Export keys-only for ethers.js
Export indexed for batch tracking
Export addresses for recipient lists
Prep data before automation

Development

Clean messy CSV exports
Normalize address formats
Prepare test wallets
Generate structured data

Portfolio Management

Merge multiple sources
Remove duplicates
Validate checksums
Export unified lists

🔧 Technical Details

File Size

~54KB uncompressed (grew with v2.0's multi-chain/mnemonic support and the v2.1 BIP-39 wordlist)
~19KB gzipped
Single file deployment

Browser Support

Chrome/Edge (latest)
Firefox (latest)
Safari (latest)
All modern browsers

Standards

EIP-55 address checksum (js-sha3)
BIP-39 mnemonic wordlist + checksum (Web Crypto SHA-256, v2.1)
RFC 4180 CSV format
JSON structured output

Network Status Indicator (v1.2)

Shows ✅ Offline Safe when disconnected
Shows ⚠️ Online (no network calls) when connected
Real-time status updates

📝 File Formats

JSON Structure

[
  {
    "private_key": "0x...",
    "address": "0x..."
  }
]

CSV Formats

Default:

private_key,address
"0x...","0x..."

Indexed (new in v1.2):

index,private_key,address
1,"0x...","0x..."

Keys Only:

0x...
0x...

Addresses Only:

0x...
0x...

📋 Changelog

v2.1 (Current) - Real Mnemonic Validation & Hardening

✅ Real BIP-39 Validation — Mnemonic badge now checks every word against the official 2048-word list and verifies the checksum bits (via Web Crypto SHA-256), instead of just counting words
✅ Fixed BTC/Tron addresses being misclassified as Solana in the chain-breakdown display (regex ordering)
✅ Fixed a text-cleanup edge case where a quoted CSV value followed by a trailing comma kept a stray quote character
✅ Fixed JSON import silently corrupting data when given a flat array of strings (e.g. ["0xabc...", "0xdef..."]) instead of objects
✅ Preview/Download now report how many duplicate rows were removed, instead of dropping them silently
✅ "Include Mnemonic column" on export now defaults off (opt-in) since a seed phrase is more sensitive than a single private key
✅ Debounced live validation so pasting very large lists doesn't stall the tab
✅ Accessibility: form labels are now properly associated with their fields
✅ Mobile layout fix for the Custom Column Names section

v2.0 - Multi-Chain & Mnemonic Support

✅ Multi-chain address detection — Ethereum, Bitcoin (legacy + bech32), Tron, Solana
✅ Mnemonic / seed phrase field (12/15/18/21/24 words)
✅ Custom column headers for exported data
✅ Drag & drop file import
✅ TSV and JSONL export formats
✅ Fully offline — no CDN, no build step

v1.3 - Format Flexibility

✅ 0x Prefix Toggle — Add or remove 0x from private keys on export
✅ Tool compatibility for ethers.js, hardhat, and other frameworks
✅ Footer logo updates (GitHub, Farcaster icons)

v1.2 - Trust Hardening

✅ Proper EIP-55 checksum validation (js-sha3)
✅ Export format presets (4 modes)
✅ Burn Session button
✅ Network status indicator
✅ Removed CDN dependencies (fully offline)
✅ Zero-key detection

v1.1 - Validation

Real-time validation
Line number error reporting
Deduplication
Shuffle function
Count mismatch warnings

v1.0 - Initial Release

Basic import/export
CSV/JSON support
Auto-clean

🤝 Contributing

Contributions welcome! Please:

Fork the repo
Create a feature branch
Submit a PR

Development

No build process needed:

# Edit index.html directly
# Test in browser
# Commit changes

📄 License

MIT License - see LICENSE file

🔗 Links

Live App: wallet-forge.vercel.app
Repository: github.com/CryptoExplor/Wallet-Forge
Report Bug: GitHub Issues
Request Feature: GitHub Issues
Security Guide: SECURITY.md

⚠️ Disclaimer

This tool handles sensitive data (private keys). While it runs entirely client-side with no network access:

Always verify the source code before use
Use on a secure, malware-free machine
Never share private keys with anyone
Test with small amounts first
For maximum security: download and run offline

See SECURITY.md for complete verification instructions.

Use at your own risk. No warranties provided.

v2.1 — Made with 🔥 by CryptoExplor

Trust through transparency. Security through simplicity.

Name		Name	Last commit message	Last commit date
public		public
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
vercel.json		vercel.json

Latest commit

History

Folders and files

Repository files navigation

Wallet Forge

🔥 Features

Security First

Validation (v1.2, extended in v2.1)

Multi-Chain & Mnemonic Support (v2.0)

Data Processing

Export Formats (v1.2, expanded in v2.0)

Import/Export

🚀 Quick Start

Use Online

Use Locally (Recommended for Maximum Security)

Deploy Your Own

Vercel (Recommended)

GitHub Pages

Netlify Drop

📖 Usage

Basic Workflow

Validation Example

Processing Options

Private Key Formatting (New in v1.3)

Export Presets (New in v1.2)

Burn Session (New in v1.2)

🔐 Security Model

Core Principles

Maximum Security Usage

What This Tool Does NOT Do

Trust Verification

Audit Trail

Safe For

🎯 Use Cases

Airdrop Farming

Bot Integration (v1.2)

Development

Portfolio Management

🔧 Technical Details

File Size

Browser Support

Standards

Network Status Indicator (v1.2)

📝 File Formats

JSON Structure

CSV Formats

📋 Changelog

v2.1 (Current) - Real Mnemonic Validation & Hardening

v2.0 - Multi-Chain & Mnemonic Support

v1.3 - Format Flexibility

v1.2 - Trust Hardening

v1.1 - Validation

v1.0 - Initial Release

🤝 Contributing

Development

📄 License

🔗 Links

⚠️ Disclaimer

About

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages