VanitySearch is a bitcoin address prefix finder. If you want to generate safe private keys, use the -s option to enter your passphrase which will be used for generating a base key as for BIP38 standard (VanitySearch.exe -s "My PassPhrase" 1MyPrefix). You can also use VanitySearch.exe -ps "My PassPhrase" which will add a crypto secure seed to your passphrase.
VanitySearch may not compute a good grid size for your GPU, so try different values using -g option in order to get the best performances. If you want to use GPUs and CPUs together, you may have best performances by keeping one CPU core for handling GPU(s)/CPU exchanges (use -t option to set the number of CPU threads).
- Added support for Ethereum vanity address generation with -coin eth
- Support vanity address of specific bit length of private key, specify bit length by -bit argument
- Curve-symmetry and Endomorphism removed to get private keys in desired bit range but this is only applicable if -bit value is specified less than 256
- Fixed size arithmetic
- Fast Modular Inversion (Delayed Right Shift 62 bits)
- SecpK1 Fast modular multiplication (2 steps folding 512bits to 256bits using 64 bits digits)
- Use some properties of elliptic curve to generate more keys
- SSE Secure Hash Algorithm SHA256 and RIPEMD160 (CPU)
- Multi-GPU support
- CUDA optimisation via inline PTX assembly
- Seed protected by pbkdf2_hmac_sha512 (BIP38)
- Support P2PKH, P2SH and BECH32 addresses
- Support split-key vanity address
Disucussion about VanitySearch@bitcointalk
You can downlad latest release from https://github.com/JeanLucPons/VanitySearch/releases
VanitySearch.exe -h
VanitySeacrh [-check] [-v] [-u] [-b] [-c] [-gpu] [-stop] [-coin cointype] [-i inputfile]
[-gpuId gpuId1[,gpuId2,...]] [-g g1x,g1y,[,g2x,g2y,...]]
[-o outputfile] [-m maxFound] [-ps seed] [-s seed] [-t nbThread]
[-bit bitNumber] [-nosse] [-r rekey] [-check] [-kp] [-sp startPubKey]
[-rp privkey partialkeyfile] [prefix]
prefix: prefix to search (Can contains wildcard '?' or '*')
-v: Print version
-u: Search uncompressed addresses
-b: Search both uncompressed or compressed addresses
-c: Case unsensitive search
-coin: coint type, btc or eth
-gpu: Enable gpu calculation
-stop: Stop when all prefixes are found
-i inputfile: Get list of prefixes to search from specified file
-o outputfile: Output results to the specified file
-gpu gpuId1,gpuId2,...: List of GPU(s) to use, default is 0
-g g1x,g1y,g2x,g2y, ...: Specify GPU(s) kernel gridsize, default is 8*(MP number),128
-m: Specify maximun number of prefixes found by each kernel call
-s seed: Specify a seed for the base key, default is random
-ps seed: Specify a seed concatened with a crypto secure random seed
-t threadNumber: Specify number of CPU thread, default is number of core
-bit bitNumber: Specify bit length for private key, default is 256 bit
-nosse: Disable SSE hash function
-l: List cuda enabled devices
-check: Check CPU and GPU kernel vs CPU
-cp privKey: Compute public key (privKey in hex hormat)
-ca pubKey: Compute address (pubKey in hex hormat)
-kp: Generate key pair
-rp privkey partialkeyfile: Reconstruct final private key(s) from partial key(s) info.
-sp startPubKey: Start the search with a pubKey (for private key splitting)
-r rekey: Rekey interval in MegaKey, default is disabled
Examples of specified private key bit length
VanitySearch.exe -stop -bit 39 1TryM
VanitySearch v1.20
Difficulty: 264104224
Search: 1TryM [Compressed]
Start Fri Oct 15 00:40:25 2021
Base Key bit: 39
Number of CPU thread: 8
[9.05 Mkey/s][GPU 0.00 Mkey/s][Total 2^26.51][Prob 30.4%][50% in 00:00:09][Found 0]
PubAddress: 1TryMKJTma3F3mhjkEF7EkPrV9F7dtyai
Priv (WIF): p2pkh:KwDiBf89QgGbjEhKnhXJuH7LrciVrZi3qYjgd9SREV4R1eGkjaKp
Priv (HEX): 0x5E54DAD576 (39 bit)
VanitySearch.exe -stop -gpu -coin eth -bit 64 0x11111111
VanitySearch v1.21
Difficulty: 536870912
Search: 0x11111111 [Uncompressed]
Start Sun Nov 7 21:36:29 2021
Base Key bit: 64
Number of CPU thread: 7
GPU: GPU #0 GeForce GTX 1650 (14x64 cores) Grid(112x128)
[230.86 Mkey/s][GPU 225.90 Mkey/s][Total 2^32.64][Prob 100.0%][99% in 00:00:00][Found 0]
PubAddress: 0x111111117e824a856b5effe8b963793535815c12
Priv (HEX): 0xBC75787EE49E1011 (64 bit)
VanitySearch.exe -stop -gpu -bit 35 1TryMe
VanitySearch v1.20
Difficulty: 15318045009
Search: 1TryMe [Compressed]
Start Fri Oct 15 00:38:09 2021
Base Key bit: 35
Number of CPU thread: 7
GPU: GPU #0 GeForce GTX 1650 (14x64 cores) Grid(112x128)
[337.32 Mkey/s][GPU 327.99 Mkey/s][Total 2^30.95][Prob 12.6%][50% in 00:00:25][Found 0]
PubAddress: 1TryMetDf977P9BcfKnaLCuNPfm4eypsD
Priv (WIF): p2pkh:KwDiBf89QgGbjEhKnhXJuH7LrciVrZi3qYjgd9MS62gtCMYQT62W
Priv (HEX): 0x598CAFB0D (35 bit)
VanitySearch.exe -stop -gpu -bit 96 1TryMe
VanitySearch v1.20
Difficulty: 15318045009
Search: 1TryMe [Compressed]
Start Fri Oct 15 00:28:59 2021
Base Key bit: 96
Number of CPU thread: 7
GPU: GPU #0 GeForce GTX 1650 (14x64 cores) Grid(112x128)
[310.17 Mkey/s][GPU 302.04 Mkey/s][Total 2^33.25][Prob 48.7%][50% in 00:00:01][Found 0]
PubAddress: 1TryMeZVFiaXtDD8D1FFXJj5UuV1HtAKU
Priv (WIF): p2pkh:KwDiBf89QgGbjEhKnhXJuH7LrciVt4abP5vjyjncdymKef64QryP
Priv (HEX): 0x9F63200FCDFD9F1929B1BAF5 (96 bit)
VanitySearch.exe -stop -bit 64 -gpu 16jY7qL
VanitySearch v1.20
Difficulty: 15318045009
Search: 16jY7qL [Compressed]
Start Fri Oct 15 00:30:41 2021
Base Key bit: 64
Number of CPU thread: 7
GPU: GPU #0 GeForce GTX 1650 (14x64 cores) Grid(112x128)
[314.36 Mkey/s][GPU 306.27 Mkey/s][Total 2^32.46][Prob 32.0%][50% in 00:00:14][Found 0]
PubAddress: 16jY7qLd6HsDtgXh8BaMoBLDMV1YcHGsTo
Priv (WIF): p2pkh:KwDiBf89QgGbjEhKnhXJuH7LrciVrZi3qYyn7ayGgS342CGhE4Wk
Priv (HEX): 0xA9383F4D35CFEF7F (64 bit)
VanitySearch.exe -stop -gpu -bit 161 bc1quantum
VanitySearch v1.20
Difficulty: 1073741824
Search: bc1quantum [Compressed]
Start Fri Oct 15 00:32:35 2021
Base Key bit: 161
Number of CPU thread: 7
GPU: GPU #0 GeForce GTX 1650 (14x64 cores) Grid(112x128)
[323.54 Mkey/s][GPU 314.17 Mkey/s][Total 2^30.88][Prob 84.2%][90% in 00:00:01][Found 0]
PubAddress: bc1quantumfwq02nva78crzak633xk6wuxpwg4szl7
Priv (WIF): p2wpkh:KwDiBf89QgGbjEhKnkzfuJ4JQ7hui5U5Tf7VMbsi3dPMXUNHgUuJ
Priv (HEX): 0x1F46DC5D1D8833FBEC21A802AA90C007BE2DA0C95 (161 bit)
VanitySearch.exe -stop -gpu -bit 250 3MyCoin
VanitySearch v1.20
Difficulty: 15318045009
Search: 3MyCoin [Compressed]
Start Fri Oct 15 00:34:27 2021
Base Key bit: 250
Number of CPU thread: 7
GPU: GPU #0 GeForce GTX 1650 (14x64 cores) Grid(112x128)
[188.92 Mkey/s][GPU 183.85 Mkey/s][Total 2^33.12][Prob 45.7%][50% in 00:00:06][Found 0]
PubAddress: 3MyCoinXVYZJ9m2ARq2MbgMusULQF3P1UC
Priv (WIF): p2wpkh-p2sh:KwJrurJF7raxzDaG9rrMUXaarGxQgY5kL1side8WH2F9fBThPRqD
Priv (HEX): 0x2A64C1801029CB75965AD137B23B4B7D41CCF1F0C1E0B82FCD7B80644FB3F02 (250 bit)
Examples of Ethereum
VanitySearch.exe -stop -gpu -coin eth -bit 120 0x23abcdef
VanitySearch v1.21
Difficulty: 1073741824
Search: 0x23abcdef [Uncompressed]
Start Sun Nov 7 21:32:48 2021
Base Key bit: 120
Number of CPU thread: 7
GPU: GPU #0 GeForce GTX 1650 (14x64 cores) Grid(112x128)
[242.19 Mkey/s][GPU 236.41 Mkey/s][Total 2^30.46][Prob 74.7%][80% in 00:00:01][Found 0]
PubAddress: 0x23abcdef666cb10ff46c5715ed26134ef9e0c649
Priv (HEX): 0x9794FD6E7C8F5077F1FD4792ECF6C6 (120 bit)
VanitySearch.exe -stop -gpu -coin eth -bit 64 0x11abcdef
VanitySearch v1.21
Difficulty: 536870912
Search: 0x11abcdef [Uncompressed]
Start Sun Nov 7 21:34:53 2021
Base Key bit: 64
Number of CPU thread: 7
GPU: GPU #0 GeForce GTX 1650 (14x64 cores) Grid(112x128)
[246.35 Mkey/s][GPU 240.75 Mkey/s][Total 2^30.90][Prob 97.6%][99% in 00:00:01][Found 0]
PubAddress: 0x11abcdef0575456f2555dde265dc1b9fcb7e5943
Priv (HEX): 0xC7616A2C38DDBF4C (64 bit)
VanitySearch.exe -stop -gpu -coin eth 0xbbabcdef
VanitySearch v1.21
Difficulty: 4294967296
Search: 0xbbabcdef [Uncompressed]
Start Sun Nov 7 21:33:40 2021
Base Key bit: 256
Number of CPU thread: 7
GPU: GPU #0 GeForce GTX 1650 (14x64 cores) Grid(112x128)
[328.41 Mkey/s][GPU 321.72 Mkey/s][Total 2^31.63][Prob 53.9%][60% in 00:00:01][Found 0]
PubAddress: 0xbbabcdeffa77688cc8be39fca85055173f10ea9a
Priv (HEX): 0x5D2163EF6E0E8D7A336C71ED195759B433B255C7C6EEF751A686C8D2B73AD22F (255 bit)
Exemple (Windows, Intel Core i7-4770 3.4GHz 8 multithreaded cores, GeForce GTX 1050 Ti):
C:\C++\VanitySearch\x64\Release>VanitySearch.exe -stop -gpu 1TryMe
VanitySearch v1.17
Difficulty: 15318045009
Search: 1TryMe [Compressed]
Start Fri Jan 31 08:12:19 2020
Base Key: DA12E013325F12D6B68520E327847218128B788E6A9F2247BC104A0EE2818F44
Number of CPU thread: 7
GPU: GPU #0 GeForce GTX 1050 Ti (6x128 cores) Grid(48x128)
[251.82 Mkey/s][GPU 235.91 Mkey/s][Total 2^32.82][Prob 39.1%][50% in 00:00:12][Found 0]
PubAddress: 1TryMeJT7cfs4M6csEyhWVQJPAPmJ4NGw
Priv (WIF): p2pkh:Kxs4iWcqYHGBfzVpH4K94STNMHHz72DjaCuNdZeM5VMiP9zxMg15
Priv (HEX): 0x310DBFD6AAB6A63FC71CAB1150A0305ECABBE46819641D2594155CD41D081AF1
C:\C++\VanitySearch\x64\Release>VanitySearch.exe -stop -gpu 3MyCoin
VanitySearch v1.11
Difficulty: 15318045009
Search: 3MyCoin [Compressed]
Start Wed Apr 3 14:52:45 2019
Base Key:FAF4F856077398AE087372110BF47A1A713C8F94B19CDD962D240B6A853CAD8B
Number of CPU thread: 7
GPU: GPU #0 GeForce GTX 1050 Ti (6x128 cores) Grid(48x128)
124.232 MK/s (GPU 115.601 MK/s) (2^33.18) [P 47.02%][50.00% in 00:00:07][0]
Pub Addr: 3MyCoinoA167kmgPprAidSvv5NoM3Nh6N3
Priv (WIF): p2wpkh-p2sh:L2qvghanHHov914THEzDMTpAyoRmxo7Rh85FLE9oKwYUrycWqudp
Priv (HEX): 0xA7D14FBF43696CA0B3DBFFD0AB7C9ED740FE338B2B856E09F2E681543A444D58
C:\C++\VanitySearch\x64\Release>VanitySearch.exe -stop -gpu bc1quantum
VanitySearch v1.11
Difficulty: 1073741824
Search: bc1quantum [Compressed]
Start Wed Apr 3 15:01:15 2019
Base Key:B00FD8CDA85B11D4744C09E65C527D35E231D19084FBCA0BF2E48186F31936AE
Number of CPU thread: 7
GPU: GPU #0 GeForce GTX 1050 Ti (6x128 cores) Grid(48x128)
256.896 MK/s (GPU 226.482 MK/s) (2^28.94) [P 38.03%][50.00% in 00:00:00][0]
Pub Addr: bc1quantum898l8mx5pkvq2x250kkqsj7enpx3u4yt
Priv (WIF): p2wpkh:L37xBVcFGeAZ9Tii7igqXBWmfiBhiwwiKQmchNXPV2LNREXQDLCp
Priv (HEX): 0xB00FD8CDA85B11D4744C09E65C527D35E2B1D19095CFCA0BF2E48186F31979C2
It is possible to generate a vanity address for a third party in a safe manner using split-key.
For instance, Alice wants a nice prefix but does not have CPU power. Bob has the requested CPU power but cannot know the private key of Alice, Alice has to use a split-key.
Alice generates a key pair on her computer then send the generated public key and the wanted prefix to Bob. It can be done by email, nothing is secret. Nevertheless, Alice has to keep safely the private key and not expose it.
VanitySearch.exe -s "AliceSeed" -kp
Priv : L4U2Ca2wyo721n7j9nXM9oUWLzCj19nKtLeJuTXZP3AohW9wVgrH
Pub : 03FC71AE1E88F143E8B05326FC9A83F4DAB93EA88FFEACD37465ED843FCC75AA81
Note: The key pair is a standard SecpK1 key pair and can be generated with a third party software.
Bob runs VanitySearch using the Alice's public key and the wanted prefix.
VanitySearch.exe -sp 03FC71AE1E88F143E8B05326FC9A83F4DAB93EA88FFEACD37465ED843FCC75AA81 -gpu -stop -o keyinfo.txt 1ALice
It generates a keyinfo.txt file containing the partial private key.
PubAddress: 1ALicegohz9YgrLLa4ADCmam7X2Zr6xJZx
PartialPriv: L2hbovuDd8nG4nxjDq1yd5qDsSQiG8xFsAFbHMcThqfjSP6WLg89
Bob sends back this file to Alice. It can also be done by email. The partial private key does not allow anyone to guess the final Alice's private key.
Alice can then reconstructs the final private key using her private key (the one generated in step 1) and the keyinfo.txt from Bob.
VanitySearch.exe -rp L4U2Ca2wyo721n7j9nXM9oUWLzCj19nKtLeJuTXZP3AohW9wVgrH keyinfo.txt
Pub Addr: 1ALicegohz9YgrLLa4ADCmam7X2Zr6xJZx
Priv (WIF): p2pkh:L1NHFgT826hYNpNN2qd85S7F7cyZTEJ4QQeEinsCFzknt3nj9gqg
Priv (HEX): 0x7BC226A19A1E9770D3B0584FF2CF89E5D43F0DC19076A7DE1943F284DA3FB2D0
Basically the -sp (start public key) adds the specified starting public key (let's call it Q) to the starting keys of each threads. That means that when you search (using -sp), you do not search for addr(k.G) but for addr(kpart.G+Q) where k is the private key in the first case and kpart the "partial private key" in the second case. G is the SecpK1 generator point.
Then the requester can reconstruct the final private key by doing kpart+ksecret (mod n) where kpart is the partial private key found by the searcher and ksecret is the private key of Q (Q=ksecret.G). This is the purpose of the -rp option.
The searcher has found a match for addr(kpart.G+ksecret.G) without knowing ksecret so the requester has the wanted address addr(kpart.G+Q) and the corresponding private key kpart+ksecret (mod n). The searcher is not able to guess this final private key because he doesn't know ksecret (he knows only Q).
Note: This explanation is simplified, it does not take care of symmetry and endomorphism optimizations but the idea is the same.
The bitcoin address (P2PKH) consists of a hash160 (displayed in Base58 format) which means that there are 2160 possible addresses. A secure hash function can be seen as a pseudo number generator, it transforms a given message in a random number. In this case, a number (uniformaly distributed) in the range [0,2160]. So, the probability to hit a particular number after n tries is 1-(1-1/2160)n. We perform n Bernoulli trials statistically independent.
If we have a list of m distinct addresses (m<=2160), the search space is then reduced to 2160/m, the probability to find a collision after 1 try becomes m/2160 and the probability to find a collision after n tries becomes 1-(1-m/2160)n.
An example:
We have a hardware capable of generating 1GKey/s and we have an input list of 106 addresses, the following table shows the probability of finding a collision after a certain amount of time:
Time | Probability |
---|---|
1 second | 6.8e-34 |
1 minute | 4e-32 |
1 hour | 2.4e-30 |
1 day | 5.9e-29 |
1 year | 2.1e-26 |
10 years | 2.1e-25 |
1000 years | 2.1e-23 |
Age of earth | 8.64e-17 |
Age of universe | 2.8e-16 (much less than winning at the lottery) |
Calculation has been done using this online high precision calculator
As you can see, even with a competitive hardware, it is very unlikely that you find a collision. Birthday paradox doesn't apply in this context, it works only if we know already the public key (not the address, the hash of the public key) we want to find. This program doesn't look for collisions between public keys. It searchs only for collisions with addresses with a certain prefix.
Intall CUDA SDK and open VanitySearch.sln in Visual C++ 2017.
You may need to reset your Windows SDK version in project properties.
In Build->Configuration Manager, select the Release configuration.
Build and enjoy.
Note: The current relase has been compiled with CUDA SDK 10.0, if you have a different release of the CUDA SDK, you may need to update CUDA SDK paths in VanitySearch.vcxproj using a text editor. The current nvcc option are set up to architecture starting at 3.0 capability, for older hardware, add the desired compute capabilities to the list in GPUEngine.cu properties, CUDA C/C++, Device, Code Generation.
-
Intall CUDA SDK.
-
Install older g++ (just for the CUDA SDK). Depenging on the CUDA SDK version and on your Linux distribution you may need to install an older g++.
-
Install recent gcc. VanitySearch needs to be compiled and linked with a recent gcc (>=7). The current release has been compiled with gcc 7.3.0.
-
Edit the makefile and set up the appropriate CUDA SDK and compiler paths for nvcc. Or pass them as variables to
make
invocation.CUDA = /usr/local/cuda-8.0 CXXCUDA = /usr/bin/g++-4.8
-
You can enter a list of architectrures (refer to nvcc documentation) if you have several GPU with different architecture.
-
Set CCAP to the desired compute capability according to your hardware. See docker section for more. Compute capability 2.0 (Fermi) is deprecated for recent CUDA SDK.
-
Go to the VanitySearch directory.
-
To build CPU-only version (without CUDA support):
$ make all
-
To build with CUDA:
$ make gpu=1 CCAP=2.0 all
Runnig VanitySearch (Intel(R) Xeon(R) CPU, 8 cores, @ 2.93GHz, Quadro 600 (x2))
$ export LD_LIBRARY_PATH=/usr/local/cuda-8.0/lib64
$ ./VanitySearch -t 7 -gpu -gpuId 0,1 1TryMe
# VanitySearch v1.10
# Difficulty: 15318045009
# Search: 1TryMe [Compressed]
# Start Wed Mar 27 10:26:43 2019
# Base Key:C6718D8E50C1A5877DE3E52021C116F7598826873C61496BDB7CAD668CE3DCE5
# Number of CPU thread: 7
# GPU: GPU #1 Quadro 600 (2x48 cores) Grid(16x128)
# GPU: GPU #0 Quadro 600 (2x48 cores) Grid(16x128)
# 40.284 MK/s (GPU 27.520 MK/s) (2^31.84) [P 22.24%][50.00% in 00:02:47][0]
#
# Pub Addr: 1TryMeERTZK7RCTemSJB5SNb2WcKSx45p
# Priv (WIF): Ky9bMLDpb9o5rBwHtLaidREyA6NzLFkWJ19QjPDe2XDYJdmdUsRk
# Priv (HEX): 0x398E7271AF3E5A78821C1ADFDE3EE90760A6B65F72D856CFE455B1264350BCE8
latest
,cuda-ccap-6
,cuda-ccap-6.0
(cuda/Dockerfile)cuda-ccap-5
,cuda-ccap-5.2
(cuda/Dockerfile)cuda-ccap-2
,cuda-ccap-2.0
(cuda/ccap-2.0.Dockerfile)cpu
(cpu/Dockerfile)
Docker images are build for CPU-only version and for each supported CUDA Compute capability version (CCAP
). Generally, users should choose latest CCAP
supported by their hardware and driver. Compatibility table can be found on Wikipedia or at the official NVIDIA web page of your product.
Docker uses multi-stage builds to improve final image size. Scripts are provided to facilitate the build process.
When building on your own, full image name (including owner/repo parts) can be customized via IMAGE_NAME
environment variable. It defaults to just vanitysearch
withour owner part. Pre-built images are available on Docker hub from @ratijas.
Build and tag vanitysearch:cpu
image:
$ ./docker/cpu/build.sh
Build with "default" GPU support, which might not be suitable for your system:
$ ./docker/cuda/build.sh
Build with customized GPU support:
$ env CCAP=5.2 CUDA=10.2 ./docker/cuda/build.sh
As for docker-compose folks, sorry, docker-composed GPUs are not (yet) supported on a 3.x branch. But it (hopefully) will change soon.
Note: VanitySearch image does not (neither should) require network access. To further ensure no data ever leaks from the running container, always pass --network none
to the docker run command.
$ docker run -it --rm --gpus all --network none ratijas/vanitysearch:cuda-ccap-5.2 -gpu -c -stop 1docker
# VanitySearch v1.18
# Difficulty: 957377813
# Search: 1docker [Compressed, Case unsensitive] (Lookup size 3)
# Start Sat Jul 11 17:41:32 2020
# Base Key: B506F2C7CA8AA2E826F2947012CFF15D2E6CD3DA5C562E8252C9F755F2A4C5D3
# Number of CPU thread: 1
# GPU: GPU #0 GeForce GTX 970M (10x128 cores) Grid(80x128)
#
# PubAddress: 1DoCKeRXYyydeQy6xxpneqtDovXFarAwrE
# Priv (WIF): p2pkh:KzESATCZFmnH1RfwT5XbCF9dZSnDGTS8z61YjnQbgFiM7tXtcH73
# Priv (HEX): 0x59E27084C6252377A8B7AABB20AFD975060914B3747BD6392930BC5BE7A06565
VanitySearch is licensed under GPLv3.