Giter VIP home page Giter VIP logo

nano-vanity's Introduction

nano-vanity

Generate a NANO address with a prefix of your choice. The longer the prefix, the longer it'll take to compute.

Installation

First, setup Rust. The best way to do this is with rustup.

To install nano-vanity from crates.io:

cargo install nano-vanity

To install nano-vanity from source:

cargo install --path .

If you want to enable GPU support, install OpenCL and add --features gpu to the install command.

For a list of nano-vanity options, use nano-vanity --help.

Seed Generation

By default, nano-vanity generates private keys instead of seeds. You can use these in the desktop wallet (they're refered to as adhoc keys), however, most other wallets do not yet support them.

You can generate seeds instead of private keys with --generate-seed. Note that doing so is a bit slower.

To explain the difference between seeds and private keys:

  • Seeds plus an index (1st key, 2nd key, etc) generate a private key. Currently, this project will always use the first index (index 0).
  • A private key generates a public key.
  • Addresses are another way of writing public keys.

Wildcards

You can leave a character up to chance by using . or *.

You can specify that a character must be a number with #.

Using your GPU

This project supports using your GPU to compute the address. This utilizes OpenCL, so you'll need OpenCL installed and working.

To build this project with GPU support, pass cargo --features gpu.

To enable GPU use, use the --gpu (or -g) option. To disable use of your CPU, use --threads 0 (or -t 0).

Intel GPUs are not supported, as in most cases running the code on the integrated GPU is no faster than running it on the CPU.

To change your GPU device, use --gpu-device [index], where [index] is the index of your GPU starting at 0. To change your GPU platform, use --gpu-platform [index].

Testing randomness

To test the randomness of seeds from this program, you can use dieharder (here's an article on it).

Dieharder should not be taken as proof that this program is secure, however, it should be used as evidence, in combination with an examination of the program's source code.

Here's an example of how to run this with dieharder:

nano-vanity --threads 1 --no-progress --limit 0 --simple-output xrb_1 | cut -d' ' -f1 | xxd -r -p | dieharder -a -g stdin_input_raw

If you get a weak or failed test, run that test again by passing dieharder -d [test]. While it's statistically unlikely that a test would fail despite nothing being wrong, it can happen, especially given the number of tests dieharder runs.

To be even more careful, you can modify nano-vanity's parameters. The important ones are --simple-output, which makes the output format easily parseable, and -l 0, which generates infinite keys instead of just one.

nano-vanity's People

Contributors

hdhoang avatar lukefor avatar plasmapower avatar webmaster128 avatar zhyatt avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.