Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hinto-janai/monero-vanity
Monero vanity address generator for CPUs
https://github.com/hinto-janai/monero-vanity
Last synced: 3 months ago
JSON representation
Monero vanity address generator for CPUs
- Host: GitHub
- URL: https://github.com/hinto-janai/monero-vanity
- Owner: hinto-janai
- License: mit
- Created: 2022-09-27T17:20:16.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-08-26T15:31:27.000Z (over 1 year ago)
- Last Synced: 2024-09-27T12:05:06.961Z (4 months ago)
- Language: Rust
- Homepage:
- Size: 7.06 MB
- Stars: 32
- Watchers: 2
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-monero - Monero Vanity Address Generator - Monero vanity address generator for CPUs (Tools / Other Wallets)
README
# monero-vanity
monero-vanity is a GUI/CLI tool that generates vanity addresses for Monero, like this one:
```
44hintoFpuo3ugKfcqJvh5BmrsTRpnTasJmetKC4VXCt6QDtbHVuixdTtsm6Ptp7Y8haXnJ6j8Gj2dra8CKy5ewz7Vi9CYW
```
#### GUI
https://user-images.githubusercontent.com/101352116/229327381-2b001b8a-b1a0-4889-93d2-ce6a9c2a858f.mp4
#### CLI
https://user-images.githubusercontent.com/101352116/229327380-52a7f8a2-fcf7-4eb0-9ec8-c0554f86a2bc.mp4
---
* [Warning](#Warning)
* [Comparison](#Comparison)
* [Estimate](#Estimate)
* [GUI Usage](#GUI-Usage)
* [CLI Usage](#CLI-Usage)
* [Split Key](#split-key)
* [Install](#Install)
* [Implementation](#Implementation)
* [Build](#Build)
---
## Warning
**I am not a cryptographer, nor was this code audited.**
Use [known, good software](https://www.getmonero.org/downloads) for generating a wallet with substantial amounts of money.
## Comparison
*Tested with: Ryzen 5950x, GTX 1660 Ti*
| Generator | Hardware | Regex | Seed | [Split-key](https://en.bitcoin.it/wiki/Split-key_vanity_address) | Character match limit | Normal speed | Regex speed |
|---------------------------------------------------------------------|----------------------|-------|------|-----------|-----------------------|------------------|-------------|
| [vanity-monero](https://github.com/monero-ecosystem/vanity-monero) | CPU (x86, 32/64-bit) | 🟢 | 🟢 | 🟢 | None | 400k/sec | 170k/sec
| **[monero-vanity](https://github.com/hinto-janai/monero-vanity)** | CPU (x86, 64-bit) | 🟢 | 🔴 | 🟢 | `1-11` | 72 million/sec | 72 million/sec
| [vanity-xmr-cuda](https://github.com/SChernykh/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
```bash
Usage: monero-vanity [--OPTIONS]
Options:
-t, --threads How many threads to use [default: HALF_THREADS]
-p, --pattern Address regex pattern to look for
-f, --first Start from 1st character instead of: ^..PATTERN.*$
-r, --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:
```bash
./monero-vanity --pattern hinto
> 44hinto...
```
Example 2 - Advanced regex pattern using half threads:
```bash
./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](https://docs.rs/regex/latest/regex/#syntax)
- All characters must be ASCII, Unicode, or a regex pattern
- `I`, `O`, `l`, `0`, `+`, `/` are invalid characters in [Monero addresses](https://monerodocs.org/cryptography/base58)
- 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](https://en.bitcoin.it/wiki/Split-key_vanity_address).
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
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
```
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
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
```
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
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
```
Which will output your desired address `45hinto...` that you can recover.
## Install
Download [here.](https://github.com/hinto-janai/monero-vanity/releases)
## Implementation
1. [Random `[u8; 64]` is generated (512 bits/64 bytes)](https://github.com/hinto-janai/monero-vanity/blob/43d0dbedb23bbe157ea76704e848d4708531ff5e/src/address.rs#L69)
2. [Scalar is created by reducing the above bytes](https://github.com/hinto-janai/monero-vanity/blob/43d0dbedb23bbe157ea76704e848d4708531ff5e/src/address.rs#L53)
3. [10,000 `EdwardsPoint`'s are created with += 1 offsetting](https://github.com/hinto-janai/monero-vanity/blob/43d0dbedb23bbe157ea76704e848d4708531ff5e/src/address.rs#L81)
4. [EdwardsPoint are batch compressed into Y points](https://github.com/hinto-janai/monero-vanity/blob/43d0dbedb23bbe157ea76704e848d4708531ff5e/src/address.rs#L87)
5. [Mainnet byte and first 10 CompressedEdwardsY bytes are concatted](https://github.com/hinto-janai/monero-vanity/blob/43d0dbedb23bbe157ea76704e848d4708531ff5e/src/address.rs#L91)
6. [Those 11 bytes are encoded in base58](https://github.com/hinto-janai/monero-vanity/blob/43d0dbedb23bbe157ea76704e848d4708531ff5e/src/address.rs#L107)
7. [If regex matches, create full address and return to user, else...](https://github.com/hinto-janai/monero-vanity/blob/43d0dbedb23bbe157ea76704e848d4708531ff5e/src/address.rs#L109)
8. [Continue, either with next point or next batch](https://github.com/hinto-janai/monero-vanity/blob/43d0dbedb23bbe157ea76704e848d4708531ff5e/src/address.rs#L130)
**Notes:**
- [Each thread seeds its own RNG](https://github.com/hinto-janai/monero-vanity/blob/43d0dbedb23bbe157ea76704e848d4708531ff5e/src/address.rs#L68)
- The (optional) private _view_ key is also created by reducing [512 random bits](https://github.com/hinto-janai/monero-vanity/blob/43d0dbedb23bbe157ea76704e848d4708531ff5e/src/address.rs#L118)
## 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
```