Skip to content

Latest commit

 

History

History
75 lines (57 loc) · 2.4 KB

README.md

File metadata and controls

75 lines (57 loc) · 2.4 KB
Raw

XRP Vanity Address Generator

Java app to generate XRP Ledger vanity addresses. Inspired by Wietse Wind's xrp-vanity-generator written in Javascript. The Java version has the advantage of being roughly 75x faster and therefore capable of finding a desired vanity address 75x faster.

Ways to run

  1. Targeted Word Mode

    In this mode, only addresses starting with the provided words will be considered.

    ./vanity-generator.sh crypto hodl xrp

  2. Roulette Mode

    In this mode, vanity addresses are generated against a list of the top 20,000 search terms according to Google.

    ./vanity-generator.sh

    By default, the word list only uses words that are 4 letters or longer. This can be adjusted by passing a numeric value. For example, to only consider words with 5 or more letters use:

    ./vanity-generator.sh 5

Running from binary

If you do not have Java and Maven installed, you can alternately the download a native binary executable which can be run offline once downloaded.

Linux

curl -Lo xrp-vanity-generator https://github.com/nhartner/xrp-vanity-address/raw/main/dist/linux-amd64/xrp-vanity-generator
chmod 755 xrp-vanity-generator
./xrp-vanity-generator

Note: currently does not work with musl-based Linux distros like Alpine.

OSX

curl -Lo xrp-vanity-generator https://github.com/nhartner/xrp-vanity-address/raw/main/dist/darwin/xrp-vanity-generator
chmod 755 xrp-vanity-generator
./xrp-vanity-generator

Note: Newer versions of OSX will not execute the binary since it will consider it an untrusted download. The following command will allow you to override that restriction:

sudo spctl --master-disable

Windows

Download https://github.com/nhartner/xrp-vanity-address/raw/main/dist/windows/xrp-vanity-generator.exe

Execute xrp-vanity-generator.exe from a Windows command shell.

Generating an offline executable jar

You can generate an executable jar that can be copied and executed on an offline device. The offline device only needs Java to be installed.

To build the executable jar, run:

./mvnw package

The executable jar will be created under target/vanity-generator.jar

The jar can be executed using java -jar path/to/vanity-generator.jar. For example:

java -jar target/vanity-generator.jar crypto hodl xrpd