vanity-address
Fast, local, multi-chain vanity address generator
Generate multi-chain keypairs whose public address matches your desired prefix, suffix, and/or contains pattern — entirely on your machine. No servers. No tracking. Keys never leave your device.
Privacy-first: keys are generated on your device only. No accounts. No telemetry. Audit the source before you trust any vanity tool.
No install? Generate in your browser → — same engine, runs entirely in the tab.
Features · Demo · Web App · Install · Usage · Architecture · Desktop App · Security · Contributing
✨ Features
| Feature | Solana | EVM |
|---|---|---|
| Prefix matching | ✅ | ✅ |
| Suffix matching | ✅ | ✅ |
Contains + * wildcards |
✅ | ✅ |
| Multi-pattern OR | ✅ | ✅ |
| Case-insensitive mode | ✅ | ✅ (hex) |
| Exact case mode | ✅ | — |
| Parallel CPU grinding | ✅ | ✅ |
| Live progress + ETA | ✅ | ✅ |
| Multiple key export formats | ✅ | ✅ |
| Contract address vanity | — | ✅ CREATE + CREATE2 |
| Token mint vanity | ✅ SPL | — |
Owner-only key files (0600) |
✅ | ✅ |
| 100% offline / local | ✅ | ✅ |
31 chains + contract & token-mint modes · CLI + desktop + web app + npm SDK · MIT licensed · privacy-first (keys never leave your machine)
New in 0.6.4: a web app — generate in your browser with the same Rust engine, nothing to install, keys never leave the tab. 0.6.3: difficulty warnings based on real measured speed, a per-character pattern guide, and an honest progress line. 0.6.2: impossible prefixes are rejected up front (no more grinding forever on e.g. Kaspa
ax), exact difficulty estimates for every chain, and fixed address starts are added for you. 0.6.1: vanity contract addresses with no factory (--chain evm-contract), vanity Solana token mints (--chain sol-mint), Hyperliquid + Sonic aliases, owner-only key files. See the CHANGELOG.
🎬 Demo
🌐 Web App
vanity-address.netlify.app/generate — nothing to install. Works in recent Chrome, Firefox, Safari, and Edge.
Pick a chain → type your word → generate → save
| Web app | |
|---|---|
All 31 chains, prefix / suffix / contains, * wildcards, comma OR |
✅ |
| Same Rust engine (WebAssembly) on all your CPU cores | ✅ |
| Difficulty estimate measured on your device | ✅ |
| Keys blurred until shown · copy · download as text | ✅ |
| Cookies, analytics, or third-party requests | ❌ none |
| Works offline once loaded (turn off Wi-Fi if you like) | ✅ |
Contract / token-mint modes, --count, verify |
Use the CLI |
Keys exist only in the open tab and are never stored or sent anywhere. The device remembers just two things in localStorage: your theme and that you've read the safety notice. The page ships a strict Content-Security-Policy that blocks any outside connection. For large balances, prefer the offline CLI or desktop app.
📦 Install
Download from GitHub Releases — no Rust or Node.js required.
| I want… | My computer | File |
|---|---|---|
| No install | Any modern browser | Web app |
| Desktop app | Mac M1–M4 | VanityAddress-*-Mac-AppleSilicon-Desktop.dmg |
| Desktop app | Windows 10/11 | VanityAddress-*-Windows-Desktop.exe |
| CLI | Mac M1–M4 | VanityAddress-*-Mac-AppleSilicon-CLI.tar.gz |
| CLI | Mac Intel | VanityAddress-*-Mac-Intel-CLI.tar.gz |
| CLI | Windows | VanityAddress-*-Windows-CLI.zip |
| CLI | Linux | VanityAddress-*-Linux-CLI.tar.gz |
Quick start (Linux):
# Replace 0.6.4 if a newer release exists: https://github.com/yudizaxay/vanity-address/releases/latest
# Homebrew 6+: trust the tap once, then install (builds from source; requires Rust)
&& &&
# Or install via npm (pre-built binary; Node.js 18+)
# npx vanity-address
# Or install the CLI from crates.io (requires Rust; first compile often takes 3–8 min)
Faster? Skip compiling — download the pre-built CLI from Releases (~30s).
Remove later?cargo uninstall vanity-address— see Install guide → Uninstall.
macOS may block unsigned apps — see Install guide → Gatekeeper.
Windows SmartScreen may warn — More info → Run anyway. Desktop app needs WebView2 (usually already on Windows 11).
📖 Full guide: docs/INSTALL.md — per-platform steps, .dmg / Windows installer, checksums, Homebrew, crates.io, build from source
🚀 Usage
Interactive mode (default)
Wizard flow: chain → match kind → pattern → estimate → confirm → grind.
Direct mode
Common flags
| Flag | Description |
|---|---|
--chain <ID> |
sol, evm, base, hyperliquid, btc-segwit, sei, … or deploy mode evm-contract / sol-mint |
--prefix / --suffix / --contains |
Match start, end, or anywhere (* OK) |
--count N |
Find N matches |
--json |
Machine-readable output (scripts) |
--save |
Append keys to vanity-results.txt (owner-only 0600 on macOS/Linux) |
-q, --quiet |
Minimal output for scripts |
Contract & token addresses
# EVM: grind a deployer key — its first deploy (nonce 0) lands on 0xcafe…
# Solana: vanity token mint → save "Mint Keypair (JSON)" as mint.json
For
evm-contract, the deploy must be the deployer's very first transaction on that chain. Using a factory? Use--create2instead.
📖 Full guide: docs/USAGE.md — all chains, deploy modes, JSON schema, pattern rules, performance tips
📦 Use it in your own code
npm install vanity-address also gives you a programmatic API — no
subprocess, runs in-process via WebAssembly (Node uses multi-core workers by default):
const = require;
console.log;
const wallet = await ;
console.log;
Also: generateAddresses, validatePattern, listChains, timeoutMs, rich onProgress.
📖 Full guide: docs/SDK.md — full API reference, workers, progress/ETA, supported chains
🏗 Architecture
┌───────────────────┐ ┌─────────────────────┐
│ vanity-address │ │ vanity-app │
│ (CLI) │ │ (Tauri desktop UI) │
├───────────────────┴───┴─────────────────────┤
│ vanity-core lib │
│ ┌────────┐ ┌─────┐ ┌──────────┐ ┌───────┐ │
│ │ Solana │ │ EVM │ │ Bitcoin… │ │ +28 │ │
│ │Grinder │ │Grind│ │ Grinders │ │ more │ │
│ └────────┘ └─────┘ └──────────┘ └───────┘ │
│ ChainGrinder trait │
└─────────────────────────────────────────────┘
New chain = one file + trait implementation in vanity-core/src/chains/. CLI and desktop UI are thin frontends over the same engine — no duplicated chain logic. The web app and npm SDK run the same engine compiled to WebAssembly (vanity-wasm/).
🖥 Desktop App
Vanity Address (vanity-app/) — native Tauri UI wired directly to vanity-core.
Home → Chain → Pattern → Summary → Grind → Result
| Feature | Desktop |
|---|---|
| 31 chains, live ETA, stop mid-grind | ✅ |
| Contract / token-mint modes | CLI only (for now) |
| Impractical-pattern warning | ✅ |
| Masked keys + reveal / copy / save | ✅ |
Install: download the Mac .dmg or Windows .exe from Releases — see docs/INSTALL.md.
Build from source: cd vanity-app && npm install && npm run tauri dev
🔐 Security
⚠️ Read before generating keys
Rule Detail Local only Keys are generated on your machine No network This tool never connects to the internet Web app Loads once, then generates in the tab — no cookies, no uploads, strict CSP Never share Do not share private keys with anyone Verify first Always double-check the address before sending funds Saved keys --savefiles are owner-only (0600) on macOS/Linux; secrets are wiped from memory after useOpen source Audit the code — trust, but verify
Full policy: SECURITY.md
🤝 Contributing
Contributions welcome — new blockchains, bug fixes, features, docs, and tests.
Before opening a PR:
📖 CONTRIBUTING.md — add a chain, PR checklist, project structure
| Want to… | Start here |
|---|---|
| Add a blockchain | vanity-core/src/chains/ + contributing guide |
| Fix a bug | Fork → branch → PR with repro steps |
| Propose a feature | Open a feature request |
📄 License
MIT License — free for personal and commercial use.
Built with 🦀 Rust · Keys stay on your machine
If this project helped you, consider giving it a ⭐ on GitHub!