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 | Tron |
|---|---|---|---|
| Prefix / suffix / contains | ✅ | ✅ | ✅ |
| Parallel CPU grinding | ✅ | ✅ | ✅ |
| Contract vanity (CREATE · nonce 0) | — | ✅ evm-contract |
✅ trx-contract |
| CREATE2 salt vanity | — | ✅ --create2 / SDK |
— |
| Token mint vanity | ✅ sol-mint |
— | — |
| 100% offline / local | ✅ | ✅ | ✅ |
49 wallet chains + 4 deploy modes (evm-contract, trx-contract, sol-mint, create2) · CLI + desktop + npm SDK · web app (wallets) · MIT · keys never leave your machine
0.8.1 in tree: OpenCL GPU for EVM (~90× CPU on Apple M4; other GPUs untested) and experimental Solana — CLI/desktop — via
--gpu auto,gpu devices/gpu bench, with CPU re-verify; Bitcoin-family forks, puzzle mode, split-key, security model. Web/npm stay CPU-only (no GPU, puzzle, or split-key). See CHANGELOG · BENCHMARKS.
🎬 Demo
🌐 Web App
vanity-address.online/generate — nothing to install. Works in recent Chrome, Firefox, Safari, and Edge.
Pick a chain → type your word → generate → save
Guides & tools (how addresses work, valid characters, time estimates): Solana · Ethereum · Bitcoin · CREATE2 · Tron · TON · all chains · difficulty calculator
| Web app | |
|---|---|
All 49 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 / CREATE2 modes | ✅ Address / Contract header toggle |
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.8.1 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> |
Wallet (sol, evm, trx, …) or deploy mode (evm-contract, trx-contract, sol-mint) |
--prefix / --suffix / --contains |
Match start, end, or anywhere (* OK) |
--create2 |
EVM CREATE2 salt grind (needs --deployer + --init-code-hash) |
--deployer / --init-code-hash |
CREATE2 factory address + keccak256(init code) |
--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 (deploy modes)
Use these when you want a vanity contract or token mint, not a wallet.
| Mode | Flag / chain | What you grind | Tip |
|---|---|---|---|
| EVM contract | --chain evm-contract |
Deployer key → contract at nonce 0 | First tx on that chain must be the deploy |
| Tron contract | --chain trx-contract |
Deployer key → T… contract at nonce 0 |
Same rule as EVM |
| EVM CREATE2 | --create2 --deployer 0x… --init-code-hash 0x… |
Salt for a known factory | Output is a salt, not a private key |
| Solana mint | --chain sol-mint |
Mint keypair | Save JSON → spl-token create-token mint.json |
# EVM CREATE (nonce 0) — fund the deployer, deploy as its first transaction
# Tron CREATE (nonce 0)
# EVM CREATE2 — you already have the factory + init-code hash
# Solana token mint
# → save "Mint Keypair (JSON)" as mint.json, then:
Interactive CLI: after the A–Z wallet list, digit keys pick deploy modes (CREATE2 stays --create2 because it needs factory params). Desktop app: same modes under Deploy / mint, with CREATE2 fields on the pattern screen.
📖 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 — programmatic API via WebAssembly (Node: multi-core workers by default):
const = require;
;
// [{ id: "evm-contract", needsFactory: false }, … { id: "create2", needsFactory: true }]
const wallet = await ;
console.log;
// EVM / Tron contract (CREATE · nonce 0)
const contract = await ;
// contract.address = vanity contract; contract.privateKey = deployer key
// CREATE2 salt (needs factory params)
const = await ;
Also: generateAddresses, validatePattern, isValidChain, timeoutMs, rich onProgress.
📖 Full guide: docs/SDK.md — API reference, deploy modes, workers, progress/ETA
🏗 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 |
|---|---|
| 49 wallet chains, live ETA, stop mid-grind | ✅ |
Deploy / mint modes (evm-contract, trx-contract, sol-mint, CREATE2) |
✅ |
| 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 — this is a key generator, not a wallet, and it is not formally audited.
Rule Detail Local only Keys are generated on your machine No network This tool never connects to the internet while grinding Web app Loads once, then generates in the tab — no cookies, no uploads, strict CSP Never share Do not share private keys with anyone Large funds Prefer offline CLI/desktop; treat saves/downloads as plaintext secrets 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
Policy: SECURITY.md · Threat model: docs/SECURITY-MODEL.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!