{"id":22859188,"url":"https://github.com/emivvvvv/btc-vanity","last_synced_at":"2025-04-05T18:06:16.381Z","repository":{"id":185446420,"uuid":"673315553","full_name":"Emivvvvv/btc-vanity","owner":"Emivvvvv","description":"A blazingly fast Bitcoin, Ethereum, and Solana vanity address generator.","archived":false,"fork":false,"pushed_at":"2025-02-15T09:55:04.000Z","size":2465,"stargazers_count":44,"open_issues_count":1,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-04T10:38:20.039Z","etag":null,"topics":["bitcoin","bitcoin-wallet","btc","cryptocurrency","eth","ethereum","rust","sol","solana","vanity","vanity-address","vanitygen"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Emivvvvv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-01T11:00:49.000Z","updated_at":"2025-03-26T10:29:24.000Z","dependencies_parsed_at":"2025-01-10T13:34:08.293Z","dependency_job_id":"2c1ce339-d6a7-48bb-9120-e288f96ad794","html_url":"https://github.com/Emivvvvv/btc-vanity","commit_stats":{"total_commits":49,"total_committers":2,"mean_commits":24.5,"dds":"0.020408163265306145","last_synced_commit":"e8982737232593323519191b6fd5cade818bffdc"},"previous_names":["emivvvvv/btc-vanity"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Emivvvvv%2Fbtc-vanity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Emivvvvv%2Fbtc-vanity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Emivvvvv%2Fbtc-vanity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Emivvvvv%2Fbtc-vanity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Emivvvvv","download_url":"https://codeload.github.com/Emivvvvv/btc-vanity/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247378140,"owners_count":20929296,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitcoin","bitcoin-wallet","btc","cryptocurrency","eth","ethereum","rust","sol","solana","vanity","vanity-address","vanitygen"],"created_at":"2024-12-13T09:06:18.829Z","updated_at":"2025-04-05T18:06:16.363Z","avatar_url":"https://github.com/Emivvvvv.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src='images/bitcoin.svg' height='22'\u003e \u003cimg src='images/ethereum.png' height='22'\u003e \u003cimg src='images/solana.png' height='22'\u003e btc-vanity\n#### v 2.1.0\nA blazingly fast vanity address generator written with the Rust programming language.  Supporting Bitcoin (always included), Ethereum, and Solana (via optional features).\n\nWith btc-vanity, you can generate wallets that have custom addresses with prefixes, suffixes, substrings, or even regex patterns. It's designed for **speed**, **flexibility**, and **security**.\n\nYou can easily run the btc-vanity terminal application locally or use it as a library to create your vanity keypairs securely.\n\n## Key Features\n\n**Multi-Chain Support**:\n*   **Bitcoin:** Always included.\n*   **Ethereum:**  Enabled via the `ethereum` feature.\n*   **Solana:** Enabled via the `solana` feature.\n\n**Advanced Customization**: Match prefixes, suffixes, substrings, or regex-based patterns with optional case insensitivity. \u003cbr\u003e\n**Blazingly Fast Performance**: Fully utilize your hardware with customizable thread counts. \u003cbr\u003e\n**Batch File Support**: Bulk generate addresses using input files with desired patterns. \u003cbr\u003e\n\n## Installation\n\n\u003e [!CAUTION]\n\u003e btc-vanity has recently migrated to version 2. Please use it cautiously.\n\n### CLI\n\nInstall the binary using `cargo`:\n\n```bash\ncargo install btc-vanity  # Installs Bitcoin support only (default)\ncargo install btc-vanity --features ethereum  # Installs with Ethereum support\ncargo install btc-vanity --features solana    # Installs with Solana support\ncargo install btc-vanity --features all       # Installs with all features (Bitcoin, Ethereum, Solana)\n```\n\n**Important:**  You *must* use the `--features` flag to enable Ethereum and/or Solana support.  If you omit the flag, you'll only get Bitcoin functionality.\n\n### Library\n\nInclude `btc-vanity` in your `Cargo.toml`:\n\n```toml\n[dependencies]\nbtc-vanity = \"2.1.0\"  # Bitcoin support only\n\n# For Ethereum support:\n# btc-vanity = { version = \"2.1.0\", features = [\"ethereum\"] }\n\n# For Solana support:\n# btc-vanity = { version = \"2.1.0\", features = [\"solana\"] }\n\n# For all features:\n# btc-vanity = { version = \"2.1.0\", features = [\"all\"] }\n```\n\nCrate on [crates.io](https://crates.io/crates/btc-vanity) \u003cbr\u003e\nDocumentation on [docs.rs](https://docs.rs/btc-vanity/latest/btc_vanity/index.html)\n\n## CLI Usage\n\n### Basic CLI Syntax\n\nThe CLI tool provides several options to customize your address generation:\n\n```shell\n$ btc-vanity [OPTIONS] \u003cPATTERN\u003e\n```\n\n#### Blockchain Selection\n\n*   `--btc`: Generates Bitcoin keypairs and addresses. (Always available)\n*   `--eth`: Generates Ethereum keypairs and addresses. (**Requires the `ethereum` feature**)\n*   `--sol`: Generates Solana keypairs and addresses. (**Requires the `solana` feature**)\n\n#### General Options\n\n*   `-i, --input-file \u003cFILE\u003e`: Reads patterns and flags from the specified file (one pattern per line).\n*   `-o, --output-file \u003cFILE\u003e`: Saves generated wallet details to the specified file.\n*   `-t, --threads \u003cN\u003e`: Sets the number of threads for address generation.\n*   `-f, --force-flags`: Forces CLI flags to override flags in the input file.\n*   `-d, --disable-fast`: Disables fast mode (allows longer patterns).\n\n#### Matching Options\n\n*   `-p, --prefix`: Matches the pattern as a prefix (default).\n*   `-s, --suffix`: Matches the pattern as a suffix.\n*   `-a, --anywhere`: Matches the pattern anywhere in the address.\n*   `-r, --regex \u003cREGEX\u003e`: Matches addresses using a regular expression.\n*   `-c, --case-sensitive`: Enables case-sensitive matching.\n\n### Bitcoin CLI Examples\n\nThese examples *always* work, as Bitcoin support is always included.\n\nGenerate a Bitcoin address with prefix `1Emiv` (case-insensitive):\n\n```shell\n$ btc-vanity Emiv\n```\n\nGenerate a Bitcoin address containing the substring `test` (case-sensitive):\n\n```shell\n$ btc-vanity -a -c test\n```\n\nGenerate a Bitcoin address using a regex pattern `^1E.*T$`:\n\n```shell\n$ btc-vanity -r \"^1E.*T$\"\n```\n\nGenerate multiple Bitcoin addresses and save to `wallets.txt`:\n\n\u003e [!NOTE]\n\u003e -f flag will override any pattern flags inside the `input-file.txt`.\n\u003e For example if there line `emiv -s --eth` will become `emiv -p --btc -c`.\n\u003e The resulting wallet will be printed in `wallets.txt`.\n\n```shell\n$ btc-vanity -f --btc -p -c -i input-file.txt -o wallets.txt\n```\n### Ethereum and Solana CLI Examples\n**Important:** These commands *require* that you installed `btc-vanity` with the appropriate features (see Installation section above).\nGenerate an Ethereum address starting with 0xdead with 8 threads:\n```shell\n# Ensure you installed with: cargo install btc-vanity --features ethereum\n$ btc-vanity --eth -t 8 dead\n```\n\nGenerate a Solana address ending with 123:\n```shell\n# Ensure you installed with: cargo install btc-vanity --features solana\n$ btc-vanity --sol -s 123\n```\n\n## Library Usage\n\nHere are some usage examples of `btc-vanity` as a library.\n\n### Generate a Bitcoin Vanity Address\nFind a Bitcoin address that contains the substring `emiv` (case-insensitive) using 16 threads:\n```rust\nuse btc_vanity::{BitcoinKeyPair, VanityAddr, VanityMode};\n\nlet vanity_address: BitcoinKeyPair = VanityAddr::generate(\n            \"emiv\", // Desired substring\n            16,     // Number of threads\n            false,  // Case-insensitive\n            true,   // Enable fast mode\n            VanityMode::Anywhere // Match substring anywhere in the address\n            ).unwrap();\n\nprintln!(\"Vanity address:\\n\\\n          private_key (WIF): {}\\n\\\n          public_key (compressed): {}\\n\\\n          address (compressed): {}\\n\",\n          vanity_address.get_wif_private_key(),\n          vanity_address.get_comp_public_key(),\n          vanity_address.get_comp_address());\n```\n\n#### Generate an Ethereum Vanity Address\n**Requires the `ethereum` feature.**\nMatch an Ethereum address with the prefix `0xdead` using 8 threads:\n```rust\n# #[cfg(feature = \"ethereum\")] // Important: Only compile this example with the feature!\n# {\nuse btc_vanity::{EthereumKeyPair, VanityAddr, VanityMode};\n\nlet vanity_address: EthereumKeyPair = VanityAddr::generate(\n            \"dead\", // Desired prefix\n            8,      // Number of threads\n            false,  // Case-insensitive (Case sensitivity not supported on ETH generation)\n            true,   // Enable fast mode\n            VanityMode::Prefix // Match substring at the start\n            ).unwrap();\n\nprintln!(\"Ethereum vanity address:\\n\\\n          private_key (hex): {}\\n\\\n          public_key (hex): {}\\n\\\n          address (hex): {}\\n\",\n          vanity_address.get_private_key_as_hex(),\n          vanity_address.get_public_key_as_hex(),\n          vanity_address.get_address_with_prefix());\n# }\n```\n\n#### Generate a Solana Vanity Address\n**Requires the `solana` feature.**\n\nCreate a Solana address with `meow` anywhere in the address (case-sensitive) using 4 threads:\n\n```rust\n# #[cfg(feature = \"solana\")] // Important: Only compile this example with the feature!\n# {\nuse btc_vanity::{SolanaKeyPair, VanityAddr, VanityMode}; // Removed KeyPairGenerator\n\nlet vanity_address: SolanaKeyPair = VanityAddr::generate(\n            \"meow\",  // Desired substring\n            4,      // Number of threads\n            true,   // Case-sensitive\n            true,   // Enable fast mode\n            VanityMode::Anywhere // Match substring anywhere in the address\n            ).unwrap();\n\nprintln!(\"Solana vanity address:\\n\\\n          private_key (Base58): {}\\n\\\n          public_key (Base58): {}\\n\\\n          address (Base58): {}\\n\",\n          vanity_address.get_private_key_as_base58(),\n          vanity_address.get_public_key_as_base58(),\n          vanity_address.get_address());\n\n# }\n\n```\n#### Regex Matching for Bitcoin Addresses\nFind a Bitcoin address that matches a regex pattern `^1E.ET.*T$` with using 12 threads:\n\n```rust\nuse btc_vanity::{BitcoinKeyPair, VanityAddr};\n\nlet vanity_address = VanityAddr::generate_regex::\u003cBitcoinKeyPair\u003e(\n            \"^1E.*ET.*T$\", // The regex pattern\n            12            // Number of threads\n            ).unwrap();\n\nprintln!(\"Bitcoin regex-matched vanity address:\\n\\\n          private_key (WIF): {}\\n\\\n          public_key (compressed): {}\\n\\\n          address (compressed): {}\\n\",\n          vanity_address.get_wif_private_key(),\n          vanity_address.get_comp_public_key(),\n          vanity_address.get_comp_address());\n```\n\n## Contributing\n\nContributions are welcome! If you’d like to improve btc-vanity or add support for additional chains, feel free to open an issue or submit a pull request on GitHub.\n\n## Disclaimer\n\n**USE WITH CAUTION AND UNDERSTANDING**\n\nbtc-vanity is a tool designed to assist users in generating customized vanity Bitcoin, Solana, and Ethereum 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.\n\n1.  **Security Awareness**: Generating and using vanity addresses involves the creation of private keys and public addresses. Private keys grant control over the associated 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.\n\n2.  **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, Solana, or Ethereum funds. Always double-check the addresses generated and verify their accuracy before using them for transactions.\n\n3.  **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.\n\n4.  **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.\n\n5.  **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.\n\n6.  **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, Solana, Ethereum, and cryptocurrency usage.\n\nBy 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.\n\nRemember, the security of your cryptocurrency holdings is paramount. Always prioritize the safety and security of your assets.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femivvvvv%2Fbtc-vanity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femivvvvv%2Fbtc-vanity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femivvvvv%2Fbtc-vanity/lists"}