monero-vanity

monero-vanity is a GUI/CLI tool that generates vanity addresses for Monero, like this one:

44hintoFpuo3ugKfcqJvh5BmrsTRpnTasJmetKC4VXCt6QDtbHVuixdTtsm6Ptp7Y8haXnJ6j8Gj2dra8CKy5ewz7Vi9CYW

GUI

gui.mp4

CLI

cli.mp4

---

• Warning
• Comparison
• Estimate
• GUI Usage
• CLI Usage
• Split Key
• Install
• Implementation
• Build

---

Warning

I am not a cryptographer, nor was this code audited.

Use known, good software for generating a wallet with substantial amounts of money.

Comparison

Tested with: Ryzen 5950x, GTX 1660 Ti

Generator	Hardware	Regex	Seed	Split-key	Character match limit	Normal speed	Regex speed
vanity-monero	CPU (x86, 32/64-bit)	🟢	🟢	🟢	None	400k/sec	170k/sec
monero-vanity	CPU (x86, 64-bit)	🟢	🔴	🟢	1-11	72 million/sec	72 million/sec
vanity-xmr-cuda	NVIDIA CUDA GPU	🔴	🔴	🔴	None	8.1 million/sec

The speed comes from:

• Batched EdwardsPoint operations
• Only encoding the first 11 bytes of the Monero address.

This means that you cannot search for anything past 11 characters, e.g:

44hintoFpuo3ug...
          ^
----------|
The last character that will be looked at

'3ug' onward is ignored.

This is fine since you (probably) want the identifier to be near the front.

Anything past 8 characters is also unrealistic, see below:

Estimate

Characters	Example	Rough Time Estimate
1	44h	Instant
2	44hi	Instant
3	44hin	Instant
4	44hint	Instant
5	44hinto	8 seconds
6	44hintoj	7 minutes, 30 seconds
7	44hintoja	2 hours, 45 minutes
8	44hintojan	23 days
9	44hintojana	5 years, 4 months
10	44hintojanai	253 years
11	44hintojanaiy	8,124 years
12	44hintojanaiyo	Pretty much never

Assuming speed of 72 million keys a second

GUI Usage

After finding an address, create a new Monero wallet:

Input the address, private view key, and private spend key:

And verify your new wallet address is correct:

CLI Usage

Usage: monero-vanity [--OPTIONS]

Options:
  -t, --threads <THREADS>  How many threads to use [default: HALF_THREADS]
  -p, --pattern <PATTERN>  Address regex pattern to look for
  -f, --first              Start from 1st character instead of: ^..PATTERN.*$
  -r, --refresh <REFRESH>  How many milliseconds in-between output refreshes [default: 500]
  -v, --version            Print version
  -h, --help               Print help (see more with '--help')

Example 1 - Basic pattern using half threads:

./monero-vanity --pattern hinto

> 44hinto...

Example 2 - Advanced regex pattern using half threads:

./monero-vanity --first --pattern "^.(4|8)h(i|1)nto.*$"

> 48hinto...

After finding the private spend key:

./monero-wallet-cli --generate-from-spend-key YOUR_WALLET_NAME

Enter the private key and the generated wallet will have the address found.

Notes:

• Rust regex is allowed in any mode
• All characters must be ASCII, Unicode, or a regex pattern
• I, O, l, 0, +, / are invalid characters in Monero addresses
• Using slightly less than max threads might be faster

monero-vanity automatically prefixes your input with ^.. and suffixes it with .*$ so that your PATTERN starts from the 3rd character until the 11th character of the address.

Example input: hinto
Actual regex used: ^..hinto.*$

To disable this, use --first.

Warning: this puts you in full control of the regex, you can input any value, even an impossible one.

Split Key

The CLI version has 3 extra options:

• --gen-private-split-key -> Generates a new split key that can be given out to allow others to help you find an address while keeping the private key hidden
• --calculate-split-key -> Calculates addresses for the provided public split key instead of our own generated private key
• --join-split-key -> Joins the private part of a split key with the calculated part to get the generated private key

This lets you generate split keys.

To use, first generate the split keys:

./monero-vanity --gen-private-split-key

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Private Split Key (keep hidden)   | f2149a0c0d09504b71e54cb91358f9f38d10e41d61dea5049dc835dc84204403
Public Split Key (give this out)  | 219126f1bd60e5c0593b3fd80b7493ad71bbb7cd48692e8fb21ab9357294ad44

Generate the other part with: ./monero-vanity --calculate-split-key 219126f1bd60e5c0593b3fd80b7493ad71bbb7cd48692e8fb21ab9357294ad44 --pattern <PATTERN_YOU_WANT>
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

Then give the Public Split Key out to whoever is doing the computation to find the desired pattern:

./monero-vanity --calculate-split-key 219126f1bd60e5c0593b3fd80b7493ad71bbb7cd48692e8fb21ab9357294ad44 --pattern hinto
Threads | 16
Refresh | 500ms
Pattern | ^..hinto.*$

Tries: [120,510,000] | Speed: [60,195,959 keys per second] | Elapsed: [2 seconds]
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Tries                     | 121,750,000
Speed                     | 48,658,219 keys per second
Elapsed                   | 2 seconds
Calculated Split Key part | 41520d03e6465db6e94a8be5627663bfc17d7942e31e995f49d4fce0f509fc06

Join keys with: ./monero-vanity --join-split-key 41520d03e6465db6e94a8be5627663bfc17d7942e31e995f49d4fce0f509fc06 <PRIVATE_SPLIT_KEY_PART>
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

They can now hand you this key 415... and you can join it with your original Private Split Key:

target/release/monero-vanity --join-split-key 41520d03e6465db6e94a8be5627663bfc17d7942e31e995f49d4fce0f509fc06 f2149a0c0d09504b71e54cb91358f9f38d10e41d61dea5049dc835dc84204403


@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Monero Address             | 45hintoZuvbAVmGKGzysC3J3wuiqU9tfZHYspY5Z2LaKLzVt1awQU3WdLnG1KgPr23iXiQ8gDyG341ox2pWTtYmNLuRThP1
Private Spend Key          | 3367a70ff34fad015b30d89e76ce5cb34f8e5d6044fd3e64e69c32bd7a2a400a
Private View Key           | 72be5d4478121eba07f3b5ee88db11eeb67a1cb7b3229c62cdb110cc9da1a40f

Recover with: ./monero-wallet-cli --generate-from-spend-key <YOUR_WALLET_NAME>
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

Which will output your desired address 45hinto... that you can recover.

Install

Download here.

Implementation

1. Random [u8; 64] is generated (512 bits/64 bytes)
2. Scalar is created by reducing the above bytes
3. 10,000 EdwardsPoint's are created with += 1 offsetting
4. EdwardsPoint are batch compressed into Y points
5. Mainnet byte and first 10 CompressedEdwardsY bytes are concatted
6. Those 11 bytes are encoded in base58
7. If regex matches, create full address and return to user, else...
8. Continue, either with next point or next batch

Notes:

• Each thread seeds its own RNG
• The (optional) private view key is also created by reducing 512 random bits

Build

git clone --recursive https://github.com/hinto-janai/monero-vanity
cargo build --release

Optimized for your specific CPU (up to 15%~ speed increase):

RUSTFLAGS="-C target-cpu=native" cargo build --release