vanity-core 0.3.2

Multi-chain vanity address grinding core library
Documentation

vanity-address

Fast, local, multi-chain vanity address generator

Generate multi-chain keypairs whose public address matches your desired prefix and/or suffix — 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.

CI Release crates.io License: MIT Security Policy Keys stay local No network Stars PRs Welcome

Features · Demo · Install · Usage · Architecture · Desktop App · Security · Contributing


✨ Features

Feature Solana EVM
Prefix matching ✅ ✅
Suffix matching ✅ ✅
Case-insensitive mode ✅ ✅ (hex)
Exact case mode ✅ —
Parallel CPU grinding ✅ ✅
Live progress + ETA ✅ ✅
Multiple key export formats ✅ ✅
100% offline / local ✅ ✅

13+ chains · CLI + desktop app · MIT licensed · privacy-first (keys never leave your machine)


🎬 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.3.2 if a newer release exists: https://github.com/yudizaxay/vanity-address/releases/latest
curl -LO https://github.com/yudizaxay/vanity-address/releases/download/v0.3.2/VanityAddress-0.3.2-Linux-CLI.tar.gz
tar xzf VanityAddress-0.3.2-Linux-CLI.tar.gz
./vanity-address
# Or install the CLI from crates.io (requires Rust)
cargo install vanity-address

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)

vanity-address

Wizard flow: chain → prefix/suffix → pattern → estimate → confirm → grind.

Direct mode

vanity-address --chain sol --suffix axay
vanity-address --chain evm --prefix dead --suffix beef -q
vanity-address --chain sol --suffix ax --json --no-benchmark --force

Common flags

Flag Description
--chain <ID> sol, evm, btc, ltc, doge, …
--prefix / --suffix Match start or end of address
--json Machine-readable output (scripts)
--save Append keys to vanity-results.txt
-q, --quiet Minimal output for scripts

📖 Full guide: docs/USAGE.md — all chains, JSON schema, pattern rules, performance tips


🏗 Architecture

┌───────────────────┐   ┌───────────────────┐
│  vanity-address    │   │    vanity-app      │
│      (CLI)         │   │  (Tauri desktop UI)│
├───────────────────┴───┴───────────────────┤
│                vanity-core lib              │
│  ┌────────┐ ┌─────┐ ┌──────────┐ ┌───────┐ │
│  │ Solana │ │ EVM │ │ Bitcoin… │ │  +10  │ │
│  │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
13 chains, live ETA, stop mid-grind ✅
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
Open 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:

make check-ci

📖 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

GitHub Report Bug Request Feature

If this project helped you, consider giving it a ⭐ on GitHub!