A simple CLI tool to generate Stellar vanity addresses.
Vanity Address: similar to a vanity license plate, a vanity cryptocurrency address is an address where either the beginning (prefix) or end (postfix) is a special or meaningful phrase. Generating such an address requires work.
Benchmarking is performed by using criterion.rs via cargo bench, which executes the benches/benchmark.rs file.
To see how things actually perform, not just in theory based on a random chart from the internet, I benchmarked on a CPU-intensive Ubuntu 18.04 box with 32 vCPUs, 64GB RAM, and 400GB Disk. Below are my results with a 32 thread and 10 sample configuration executed against rust 1.43.0 on May 12, 2020. Using only 10 samples is a weakness in this benchmarking example - will need to increase for a more accurate testing in the future.
| prefix size | measured time | |-------------|---------------| | 1 | ~3.6 ms | | 2 | ~47.4 ms | | 3 | ~1.0 s | | 4 | ~26.5 s |
Ah, thanks so much! I have limited computing power.
git clone https://github.com/robertDurst/stellar-vanity-address-generator.gitcd stellar-vanity-address-generatorcargo benchBenchmark Configurations: * as many threads as possible (see note below) * 25 samples per method * 1 - 6 prefixes
Note: this uses num_cpus::get() from num_cpus to determine the maximum number of cores availible. If that is not desired, you'll have to dig in and set this number manually... or open a pr if you know how to pass CLI args to cargo bench :)
``` use stellarvanity::vanitykey::AddressGenerator, deserializepublickey};;
let mut generator: AddressGenerator = Default::default(); let keypair = generator.find(|key| { let public = deserializepublickey(key); // any conditions go here public.asstr().endswith("RUST") // e.g. find address with the "RUST" suffix }); ```
This will continuously loop until a key with the desired properties is found. Once the vanity address is found, a keypair will be returned, which may be deserialized with deserialize_public_key and deserialize_private_key respectively. Note, this is a synchronous function.
```
cargo run -- [--postfix=
Either --postfix or --prefix option is required, while thread count is optional.
```
As an example, the following looks for an address ending in pizza with 8 threads:
cargo run -- -c=8 --postfix=pizza