Profanity is a high performance (probably the fastest!) vanity address generator for Ethereum. Create cool customized addresses that you never realized you needed! Recieve Ether in style! Wow!
A previous version of this project has a known critical issue due to a bad source of randomness. The issue enables attackers to recover private key from public key: https://blog.1inch.io/a-vulnerability-disclosed-in-profanity-an-ethereum-vanity-address-tool
This project "profanity2" was forked from the original project and modified to guarantee safety by design. This means source code of this project do not require any audits, but still guarantee safe usage.
Project "profanity2" is not generating key anymore, instead it adjusts user-provided public key until desired vanity address will be discovered. Users provide seed public key in form of 128-symbol hex string with -z parameter flag. Resulting private key should be used to be added to seed private key to achieve final private key of the desired vanity address (private keys are just 256-bit numbers). Running "profanity2" can even be outsourced to someone completely unreliable - it is still safe by design.
Note: when upgrading to a new version of profanity2, delete the cache-opencl.* files (or pass --no-cache) once so the OpenCL program is rebuilt with the new kernel.
Generate private key and public key via openssl in terminal (remove prefix "04" from public key):
$ openssl ecparam -genkey -name secp256k1 -text -noout -outform DER | xxd -p -c 1000 | sed 's/41534e31204f49443a20736563703235366b310a30740201010420/Private Key: /'| sed 's/a00706052b8104000aa144034200/\'$'\nPublic Key: /'Derive public key from existing private key via openssl in terminal (remove prefix "04" from public key):
$ openssl ec -inform DER -text -noout -in <(cat <(echo -n "302e0201010420")<(echo -n "PRIVATE_KEY_HEX")<(echo -n "a00706052b8104000a")| xxd -r -p)2>/dev/null | tail -6 | head -5 | sed 's/[ :]//g'| tr -d '\n'&&echoUse private keys as 64-symbol hexadecimal string WITHOUT 0x prefix:
(echo 'ibase=16;obase=10'&& (echo '(PRIVATE_KEY_A + PRIVATE_KEY_B) % FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141'| tr '[:lower:]''[:upper:]')) | bcUse private keys as 64-symbol hexadecimal string WITH 0x prefix:
$ python3
>>> "%064x" % ((PRIVATE_KEY_A + PRIVATE_KEY_B) %0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141)The combined private key must be used as a 64-symbol hexadecimal string. Neither bc nor Python's hex() prints leading zeros, so whenever the sum has fewer than 64 symbols (about 1 chance in 16), pad it with leading zeros. The Python snippet above does this automatically thanks to "%064x". Example:
PRIVATE_KEY_A = 0bc657b0af28b743c7f0d49c4de78efd47a5c8923dabfdef051fff5cdc7c30e7
PRIVATE_KEY_B = 0000f8ba428990fca1e618a252ac3614f5de19b20ff00c2ded57bfb6933830aa
sum (63 symbols): bc7506af1b2484069d6ed3ea093c5123d83e2444d9c0a1cf277bf136fb46191
private key (padded): 0bc7506af1b2484069d6ed3ea093c5123d83e2444d9c0a1cf277bf136fb46191
OpenCL ships with the system, so only the Xcode Command Line Tools are needed:
xcode-select --install # skip if already installed
makeThis produces bin/profanity2.x64, with the two OpenCL kernels copied next to
it so the directory can be moved elsewhere as is. Works on both Intel and
Apple Silicon (M1/M2/M3/M4) Macs.
See docs/BUILD_UBUNTU.md. In short:
sudo apt install -y build-essential opencl-headers ocl-icd-opencl-dev clinfo
makeplus the OpenCL runtime (driver) of your GPU vendor — the document covers NVIDIA/AMD/Intel setup and common errors.
See docs/BUILD_WINDOWS.md — building with MSYS2/MinGW-w64
or against a vendor OpenCL SDK, plus troubleshooting for the most common errors
(CL/cl.h: No such file or directory, CreateProcess(NULL, uname -s, ...) failed,
empty device list, WSL2 limitations).
A prebuilt image with the OpenCL runtime is available, so nothing has to be installed on the machine that does the searching:
docker run --rm --gpus all ghcr.io/1inch/profanity2:latest --matching dead -z $PUBLIC_KEYSince the tool only needs your public key, that machine does not have to be yours. See docs/VASTAI.md for renting a GPU on vast.ai and running the image there with your own parameters.
src/ C++ sources of the host program
kernels/ the OpenCL kernels, keccak.cl and profanity.cl
bin/ what make produces: the binary and a copy of the kernels
build/ object files
docker/ the shipping image and its entrypoint
bench/ tooling that compares the speed of two revisions on one GPU
tests/ correctness tests and a microbenchmark for the mp-math kernels
docs/ build guides for Ubuntu and Windows, and the vast.ai guide
make copies the kernels into bin/ because that is the first place the binary
looks for them, so it can be started from any directory. It still falls back to
the working directory, which is where releases before this layout kept them.
usage: ./profanity2 [OPTIONS]
Mandatory args:
-z Seed public key to start, add it's private key
to the "profanity2" resulting private key.
Basic modes:
--benchmark Run without any scoring, a benchmark.
--zeros Score on zeros anywhere in hash.
--letters Score on letters anywhere in hash.
--numbers Score on numbers anywhere in hash.
--mirror Score on mirroring from center.
--leading-doubles Score on hashes leading with hexadecimal pairs
-b, --zero-bytes Score on hashes containing the most zero bytes
Modes with arguments:
--leading <single hex> Score on hashes leading with given hex character.
--matching <hex string> Score on hashes matching given hex string.
-e, --exact <hex mask> Print every hash matching the given mask exactly,
not just the best one. Non-hex characters (e.g. X)
are wildcards. Runs until interrupted.
Advanced modes:
--contract Instead of account address, score the contract
address created by the account's zeroth transaction.
--leading-range Scores on hashes leading with characters within
given range.
--range Scores on hashes having characters within given
range anywhere.
Range:
-m, --min <0-15> Set range minimum (inclusive), 0 is '0' 15 is 'f'.
-M, --max <0-15> Set range maximum (inclusive), 0 is '0' 15 is 'f'.
Device control:
-s, --skip <index> Skip device given by index.
-n, --no-cache Don't load cached pre-compiled version of kernel.
Tweaking:
-w, --work <size> Set OpenCL local work size. [default = 64]
-W, --work-max <size> Set OpenCL maximum work size. [default = -i * -I]
-i, --inverse-size Set size of modular inverses to calculate in one
work item. [default = 255]
-I, --inverse-multiple Set how many above work items will run in
parallell. [default = 16384]
Examples:
./profanity2 --leading f -z HEX_PUBLIC_KEY_128_CHARS_LONG
./profanity2 --matching dead -z HEX_PUBLIC_KEY_128_CHARS_LONG
./profanity2 --matching badXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXbad -z HEX_PUBLIC_KEY_128_CHARS_LONG
./profanity2 --exact 1337XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXc0de -z HEX_PUBLIC_KEY_128_CHARS_LONG
./profanity2 --leading-range -m 0 -M 1 -z HEX_PUBLIC_KEY_128_CHARS_LONG
./profanity2 --leading-range -m 10 -M 12 -z HEX_PUBLIC_KEY_128_CHARS_LONG
./profanity2 --range -m 0 -M 1 -z HEX_PUBLIC_KEY_128_CHARS_LONG
./profanity2 --contract --leading 0 -z HEX_PUBLIC_KEY_128_CHARS_LONG
./profanity2 --contract --zero-bytes -z HEX_PUBLIC_KEY_128_CHARS_LONG
About:
profanity2 is a vanity address generator for Ethereum that utilizes
computing power from GPUs using OpenCL.
Forked "profanity2":
Author: 1inch Network <info@1inch.io>
Disclaimer:
This project "profanity2" was forked from the original project and
modified to guarantee "SAFETY BY DESIGN". This means source code of
this project doesn't require any audits, but still guarantee safe usage.
From original "profanity":
Author: Johan Gustafsson <profanity@johgu.se>
Beer donations: 0x000dead000ae1c8e8ac27103e4ff65f42a4e9203
Disclaimer:
Always verify that a private key generated by this program corresponds to
the public key printed by importing it to a wallet of your choice. This
program like any software might contain bugs and it does by design cut
corners to improve overall performance.
All examples below require the mandatory -z argument: your seed public key as a 128-symbol
hex string without the 04 prefix (see
Getting public key for mandatory -z parameter).
In the examples it is abbreviated as $PUBLIC_KEY:
export PUBLIC_KEY="HEX_PUBLIC_KEY_128_CHARS_LONG"Score on addresses starting with as many repetitions of a single hex character as possible. The score is the number of leading characters, so the tool keeps running and prints better and better results:
# 0x00000... (as many leading zeros as possible)
./bin/profanity2.x64 --leading 0 -z $PUBLIC_KEY# 0xaaaaa... (as many leading "a"s as possible)
./bin/profanity2.x64 --leading a -z $PUBLIC_KEY--matching takes a hex pattern up to 40 characters long (the length of an address without 0x).
Every position that is not a valid hex character (conventionally X) is a wildcard that
matches anything. The score is the number of matched fixed positions.
Prefix — a short pattern is anchored to the beginning of the address:
# 0xdead...
./bin/profanity2.x64 --matching dead -z $PUBLIC_KEYSuffix — pad the beginning of a full 40-character pattern with X wildcards:
# 0x...999999
./bin/profanity2.x64 --matching XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX999999 -z $PUBLIC_KEYPrefix and suffix at the same time — fix both ends, wildcard the middle:
# 0x1111...2222
./bin/profanity2.x64 --matching 1111XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX2222 -z $PUBLIC_KEY# 0xbad...bad
./bin/profanity2.x64 --matching badXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXbad -z $PUBLIC_KEYArbitrary positions — any mix of fixed characters and wildcards works:
# 0xXXXXcafeXXXX...XXXX (characters 5-8 are "cafe")
./bin/profanity2.x64 --matching XXXXcafeXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -z $PUBLIC_KEYNote: only results improving the best score so far are printed, so after a result matching
all fixed positions is found nothing better can appear — stop the program with Ctrl-C.
Keep in mind that every additional fixed character multiplies the expected search time by 16.
--exact takes the same mask format as --matching (up to 40 characters, non-hex characters
are wildcards) but skips the scoring system entirely: it prints every address that matches
all fixed positions of the mask and keeps running until stopped with Ctrl-C. Use it when you
want to collect several candidate addresses in one run instead of restarting --matching for
each one:
# Every address 0x1337...c0de found, not just the first one
./bin/profanity2.x64 --exact 1337XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXc0de -z $PUBLIC_KEY# Every address with at least five leading zeros
./bin/profanity2.x64 --exact 00000XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -z $PUBLIC_KEYThe first matches take longer to appear than with --matching (partial matches are not
reported), and a very short mask can produce more matches per GPU round than the result
buffer holds — the program prints a warning with the number of dropped matches if that
happens.
Score on the total amount of matching characters anywhere in the address:
# As many "0" characters as possible, e.g. 0x00aa0e050bb03c0b066e00c0f70a03d0d000b0d7
./bin/profanity2.x64 --zeros -z $PUBLIC_KEY# Only letters (a-f), e.g. 0xffcadbfaecfcdeaddeedabadfeedfacebeefcafe
./bin/profanity2.x64 --letters -z $PUBLIC_KEY# Only numbers (0-9), e.g. 0x8896339129744478701529940603494328137361
./bin/profanity2.x64 --numbers -z $PUBLIC_KEYScore on characters within a given hex range, set with -m/--min and -M/--max
(0 is 0, 15 is f):
# Leading characters in range 0-1, e.g. 0x0110100...
./bin/profanity2.x64 --leading-range -m 0 -M 1 -z $PUBLIC_KEY# Leading characters in range a-c, e.g. 0xcbabacc...
./bin/profanity2.x64 --leading-range -m 10 -M 12 -z $PUBLIC_KEY# Characters in range 0-1 anywhere in the address
./bin/profanity2.x64 --range -m 0 -M 1 -z $PUBLIC_KEY# Address mirrored around its center, e.g. 0x...abccba...
./bin/profanity2.x64 --mirror -z $PUBLIC_KEY# Leading pairs of identical characters, e.g. 0x00fFcc55...
./bin/profanity2.x64 --leading-doubles -z $PUBLIC_KEY# As many zero BYTES (pairs "00" at even positions) as possible; such addresses# save gas when used in calldata, e.g. 0x00815e00c0fd4a2d00ae00fa00e300ee00fc0034
./bin/profanity2.x64 --zero-bytes -z $PUBLIC_KEYAdd --contract to any scoring mode to score the address of the contract deployed by the
zeroth transaction of the found account instead of the account address itself:
# Account whose first deployed contract gets a 0x00000... address
./bin/profanity2.x64 --contract --leading 0 -z $PUBLIC_KEY# Account whose first deployed contract address has the most zero bytes
./bin/profanity2.x64 --contract --zero-bytes -z $PUBLIC_KEY# Measure hashrate without any scoring
./bin/profanity2.x64 --benchmark -z $PUBLIC_KEY# Multiple GPUs are used automatically; skip a device (e.g. an integrated GPU) by index
./bin/profanity2.x64 --leading 0 -s 1 -z $PUBLIC_KEY| Model | Clock Speed | Memory Speed | Speed | Time to match eight characters |
|---|---|---|---|---|
| GTX 1070 | 1750 | 4000 | 225 MH/s | ~19s |
| RTX 4090 | 2550 | 10500 | 1361 MH/s | ~3s |
| RX 480 | 1328 | 4000 | 120 MH/s | ~36s |
| RX 7900 XTX | 2500 | 10000 | 592 MH/s | ~7s |
| Apple Silicon M1 (8-core GPU) | 1278 | 4266 | 60 MH/s | ~72s |
| Apple Silicon M1 Max (32-core GPU) | 1296 | 6400 | 229 MH/s | ~19s |
| Apple Silicon M2 (10-core GPU) | 1398 | 6400 | 75 MH/s | ~57s |
| Apple Silicon M3 Pro (18-core GPU) | 1398 | 6400 | 129 MH/s | ~33s |
| Apple Silicon M4 Max (40-core GPU) | 1800 | 8533 | 467 MH/s | ~9s |
This project is licensed under the MIT License.