Vanitygen was the first command-line vanity Bitcoin address generator. A few other vanity address generators exist including Vanitygen-plus and VanitySearch.
If you're tired of the random addresses generated by regular Bitcoin clients, you can use a vanity address program to create a more personalized address. For example, you could create an address that starts '1Satoshi' and ask people to send Bitcoin to 1SatoshiHHqnDPRSfiZ5GXJ8Gk9dbjO.
Vanity address programs accept as input a pattern (e.g. 1Bitcoin) and create a public address and private key. The amount of time required to find a given pattern depends on how complex the pattern is, the speed of the computer, whether it is using CPU or GPU, and if you get lucky.
The example below (from 2014) illustrates a session of vanitygen. It takes about 10 seconds to create the new public and private keys using a Core 2 Duo E6600 CPU on x86-64 Linux.
Please note that vanitygen is a legacy program and that the information below is provided for historical purposes.
$ ./vanitygen 1Boat Difficulty: 4476342 Pattern: 1Boat Address: 1BoatSLRHtKNngkdXEeobR76b53LETtpyT Privkey: 5J4XJRyLVgzbXEgh8VNi4qovLzxRftzMd8a18KkdXv4EqAwX3tS
Vanitygen includes components to perform address searching on a CPU (vanitygen) and OpenCL-compatible GPU (oclvanitygen). Both can be built from source and are included in the Windows binary package. Also included is oclvanityminer, the vanity address mining client. Oclvanityminer can be used to automatically claim bounties on sites such as ThePiachu's Vanity Pool.
Current version: 0.22.
Get the source from GitHub. Includes Makefiles for Linux and Mac OS X.
Main discussion at BitcoinTalk.
The latest source doesn't work properly for high-end AMD cards (7XXX and greater). The solution is to change line 459 in oclengine.c from: return quirks; to: return quirks & ~VG_OCL_AMD_BFI_INT;
Windows x86+x64 binaries that solve this problem plus provide support for compressed keys here. PGP signature here. If you have any problems with the binaries, join the relevant BitcoinTalk discussion.
Expected keysearch rate
The table below shows the key search rate one can expect from different hardware. The last five examples, which use GPU processors, were taken from DaveF's list of speeds that can be achieved with the VanitySearch address generator.
|Core i5 750 @2.67 GHz||nVidia GTS 250||1.54 Mkey/s||110% CPU |
|Core2 Duo 6600||nVidia GTX 285||3.5 Mkey/s||100% CPU / 90% GPU |
|Sempron 140||AMD 5830||5.5 Mkey/s||100% CPU / 60% GPU |
|AMD Radeon r7 240||4 Mkey/s|||
|Core i7||AMD 6500M||4.5 Mkey/s||98% GPU|
|nVidia GeForce GTX 680M||14-16 Mkey/s|||
|nVidia GeForce GTX 970||38 Mkey/s|||
|Core i7-4702MQ 2.2GHz||1.09 Mkey/s|
|Core i7-4702MQ 2.2GHz||GeForce GT750M||5.38 Mkey/s|
|AMD Radeon r9 280x||25-35 Mkey/s|
|Sapphire Radeon HD 7970||28Mkey/s|||
|AMD Radeon HD 5870||30 Mkey/s|||
|Asus Strix GTX 970||40Mkey/s|||
|nVidia GeForce GTX 780 Ti (3GB 384-bit GDDR5)||50-60 Mkey/s|||
|Core i5-2500K @ 3.30GHz||AMD RX 480||57-64 Mkey/s||With AMD patch |
|GeForce GTX 1060 3GB (9x128 cores) Grid(72x128)||322 Mkey/s|||
|GeForce GTX 1080 Ti (28x128 cores) Grid(224x128)||896 Mkey/s|||
|EVGA RTX 2080 XC ULTRA||1425 Mkey/s|||
|GPU #0 Tesla V100-SXM2-16GB (80x64 cores) Grid(640x128)||1815 Mkey/s|||
|GPU #0 GeForce RTX 2080 SUPER (48x64 cores) Grid(384x256)||2002 Mkey/s|||
Difficulty of finding a vanity address
The difficult of discovering a Bitcoin vanity address depends on its exact structure (what are the leading letters or numbers) and how likely such an output is given the algorithms involved, which can consist of several pivots where the difficulty suddenly changes.
|1QLbz6||259,627,881||This vanity is alphabetically located before a major pivot, the RIPEMD160 hash value of 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF (address: 1QLbz7JHiBTspS962RLKV8GndWFwi5j6Qr).|
|1QLbz7||837,596,142||This vanity is partially after a pivot and thus the difficulty increases.|
|1QLbz7JHiBTspS962RLKV8GndWG||1.6489E+47||After a major pivot and 59 times as difficult as the 'E' vanity.|
|1aaaaa||15,318,045,009||After various pivots and subsequently more difficult.|
|1abcdef||888,446,610,539||Six characters case sensitive starting with a lower case character.|
|111111||1,099,511,627,776||A special case: leading number 1 (one) is especially difficult.|
|1abcdefg||51,529,903,411,245||Seven characters case sensitive starting with a lower case character.|
|1abcdefgh||2,988,734,397,852,220||Eight characters case sensitive starting with a lower case character.|
Using a vanity address generator to try to attack addresses
You might think that you would be able to find the private key for a given address by running a vanity address generator. In practice, this is considered impossible. Given that the difficulty increases exponentially the longer your vanity is, so does the average time required to find that vanity. The table below shows how an increasingly complex vanity affects the difficulty and average time required to find a match only for that vanity, let alone the full address, for a machine capable of looking through one million keys per second.
|1Bitc||4,476,342 (4.48E+6)||< 10s|
|1Bitco||259,627,881 (2.6E+8)||3 minutes|
|1Bitcoi||15,058,417,127 (1.506E+10)||3 hours|
|1BitcoinEaterAddressDontSend||1.6209E+47||3.3E+33 or 3.3 decillion years.|
Outsourcing vanity address generation
The standard way to generate a vanity address is to calculate it yourself by downloading the program and then running it on your system. However, for longer prefixes, you are unlikely to have enough computational resources or time to calculate them. In these cases, you can outsource your vanity address generation to a Bitcoin Vanity Generation Website. A good idea is to use split-key address generation.