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.
Features · Demo · 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 + npm SDK · MIT licensed · privacy-first (keys never leave your machine)
New in 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
📦 Install
Download from GitHub Releases — no Rust or Node.js required.
| I want… | My computer | File |
|---|---|---|
| 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.3 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.
🖥 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 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!