# <img src='Bitcoin.svg.png' width='22'> btc-vanity

A bitcoin vanity address generator written with the Rust programming language.

With btc-vanity you can create a private key which has a compressed bitcoin pay address that has a custom prefix, suffix or a string at somewhere in the address.

You can easily run btc-vanity terminal application locally or use it as a library to create your vanity keypair securely.

## Screenshots

DO NOT USE THE PRIVATE KEYS ON THE SCREENSHOTS! NEVER EVER SHARE YOUR PRIVATE KEY! THESE ACCOUNTS ARE NOT IN USE! USING THESE ACCOUNTS MEAN YOU PROBABLY LOSE YOUR MONEY!

![My Image](example.png)
![My Image](examples-input-file.png)

Here’s how you could rewrite the features section based on the information provided:

## Features

- **Flexible Address Customization**: Generate Bitcoin addresses with prefixes, suffixes, or the desired pattern located anywhere in the address.
- **Case Insensitivity Support**: Option to ignore case when searching for vanity addresses.
- **Batch Wallet Generation**: Input a file containing multiple desired addresses and generate wallets in bulk.
- **Output Wallets to File**: Automatically save generated wallet addresses to an output file for easy access.
- **Configurable Flags**: Use an input file to pass custom flags for each desired wallet address.
- **Comprehensive Documentation**: Full library documentation to help you get started and understand the available features.
- **Versioned and Maintained**: The latest version is highly recommended for optimal performance and features.

## Installation

```
$ cargo install btc-vanity
```
[btc-vanity crates.io](https://crates.io/crates/btc-vanity)


## Example Usages

```
$ btc-vanity -c -a Emiv
```

```
$ btc-vanity -s -o wallet.txt TALA
```

```
$ btc-vanity -f -p -c -i inputs.txt -o wallets.txt
```

## CLI

```
$ btc-vanity --help
A bitcoin vanity address generator written with the Rust programming language.

Usage: btc-vanity [OPTIONS] [string]

Arguments:
  [string]  String used to match addresses.

Options:
  -i, --input-file <input-file>    File with strings to match addresses with.
                                   Important: Write every string in a separate line.
  -f, --force-flags                Use this flag to override the flags in the input file
                                   or use in file to override cli flags for only that string.
                                   Note: Cli -f is stronger than input-file -f.
  -o, --output-file <output-file>  Crates a file that contains found wallet/s.
  -p, --prefix                     Finds a vanity address which has 'string' prefix. [default]
  -s, --suffix                     Finds a vanity address which has 'string' suffix.
  -a, --anywhere                   Finds a vanity address which includes 'string' at any part of the address.
  -t, --threads <threads>          Number of threads to be used. [default: 16]
  -c, --case-sensitive             Use case sensitive comparison to match addresses.
  -d, --disable-fast               Disables fast mode to find a prefix more than 4 characters.
  -h, --help                       Print help
  -V, --version                    Print version
```

## Documentation

[btc-vanity documentation](https://docs.rs/btc-vanity/latest/btc_vanity/index.html)


## Disclaimer

**USE WITH CAUTION AND UNDERSTANDING**

btc-vanity is a tool designed to assist users in generating customized vanity Bitcoin addresses using the Rust programming language. While btc-vanity aims to provide a secure and efficient method for generating vanity addresses, it is essential to exercise caution and follow the best security practices.

1. **Security Awareness**: Generating and using vanity addresses involves the creation of private keys and public addresses. Private keys grant control over the associated Bitcoin funds. It is crucial to understand the risks involved in managing private keys and to never share them with anyone. Keep your private keys stored securely and never expose them to potential threats.

2. **Risk of Loss**: Improper use of btc-vanity, mishandling of private keys, or failure to follow security guidelines may result in the loss of Bitcoin funds. Always double-check the addresses generated and verify their accuracy before using them for transactions.

3. **Verification**: Before utilizing any vanity address generated by btc-vanity, thoroughly verify the integrity of the software and the generated addresses. Only use versions of btc-vanity obtained from reputable sources, such as the official crates.io page.

4. **Backup and Recovery**: Maintain proper backups of your private keys and any relevant data. In the event of device failure, loss, or corruption, having secure backups will help prevent irreversible loss of funds.

5. **Use at Your Own Risk**: The btc-vanity software is provided "as is," without any warranties or guarantees. The author(s) and contributors of btc-vanity shall not be held responsible for any direct or indirect damages, losses, or liabilities resulting from the use or misuse of this software.

6. **Educational Purposes**: btc-vanity is intended for educational and personal use. It is your responsibility to ensure compliance with any legal, regulatory, or tax requirements in your jurisdiction related to Bitcoin and cryptocurrency usage.

By using btc-vanity, you acknowledge and accept the risks associated with generating vanity addresses and handling private keys. It is your responsibility to exercise diligence, follow security best practices, and be aware of potential risks.

Remember, the security of your Bitcoin holdings is paramount. Always prioritize the safety and security of your assets.