vanity-eth/README.md
2018-02-09 15:29:12 +01:00

65 lines
1.8 KiB
Markdown

# Vanity-ETH
[![Build Status](https://travis-ci.org/bokub/vanity-eth.svg?branch=master)](https://travis-ci.org/bokub/vanity-eth)
[![Maintainability](https://api.codeclimate.com/v1/badges/818874f09ea56c310072/maintainability)](https://codeclimate.com/github/bokub/vanity-eth/maintainability)
Browser-based ETH vanity address generator
Just type [`git.io/veth`](https://git.io/veth) to use it ⚡️
## Usage
First of all, visit [`git.io/veth`](https://git.io/veth)
Enter the prefix of your choice, then click 'generate' to start.
Ethereum addresses are hexadecimal, which means your prefix can only contain numbers and letters from A to F.
You can increase the number of threads allocated to address generation to be faster, or decrease it if you computer struggles.
## How it works
You browser is going to generate a ton of random addresses until one of them starts with your prefix.
Everything is computed by your browser, so you should notice a better speed on a powerful computer.
## Security
As explained above, everything is computed in your browser. Nothing ever leaves your machine, or even your browser tab.
You can download the latest build of Vantiy-ETH from Github and use it completely offline.
Vanity-ETH uses a cryptographically secure pseudorandom number generator (CSPRNG) to generate Ethereum addresses.
## Offline usage
Vanity-ETH works perfectly offline! Once the web page is loaded, you can turn off the internet and continue playing.
You can also download the latest build of Vanity-ETH, check out the [wiki page](https://github.com/bokub/vanity-eth/wiki/Download-Vanity-ETH)
## Local development
Install dependencies
```sh
npm i
```
Run the dev-sever while you code
```sh
npm run dev
```
Build the project
```sh
npm run build
```
The Travis CI bot is in charge of building and deploying Vanity-ETH to Github pages.