# BIP39 CLI
A simple command-line tool for generating BIP39 mnemonic phrases.
## Installation
Install from crates.io:
```bash
cargo install bip39-cli
```
Or build from source:
```bash
git clone https://github.com/partylikeits1983/bip39-cli
cd bip39-cli
cargo build --release
```
## Usage
### Basic Usage
Generate a 12-word mnemonic phrase (default):
```bash
bip39-cli
```
or explicitly:
```bash
bip39-cli --generate
```
### Generate 24-word mnemonic
```bash
bip39-cli --generate --words 24
```
### Use custom entropy
You can provide your own entropy string:
```bash
bip39-cli --generate --entropy "my custom entropy string"
```
### Help
```bash
bip39-cli --help
```
## Examples
```bash
$ bip39-cli
🔐 BIP39 Mnemonic Phrase (12 words):
Generated 12 words:
abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about
$ bip39-cli --words 24
🔐 BIP39 Mnemonic Phrase (24 words):
Generated 24 words:
abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon art
$ bip39-cli --entropy "my secret"
🔐 BIP39 Mnemonic Phrase (12 words):
Randomness used: Custom string: "my secret"
Generated 12 words:
flat lawsuit suggest glove mom kitchen acquire trouble clog spirit process rain
```
## Options
- `-g, --generate`: Generate a new mnemonic phrase (default behavior)
- `-w, --words <WORDS>`: Number of words in the mnemonic (12 or 24) [default: 12]
- `-e, --entropy <STRING>`: Custom entropy string (optional)
- `-h, --help`: Print help information
- `-V, --version`: Print version information
## Security Note
⚠️ **Important**: The generated mnemonic phrases are for educational and development purposes. For production use with real cryptocurrency, ensure you're using a secure, offline environment and proper entropy sources.
## License
This project is licensed under either of
- Apache License, Version 2.0
- MIT License
at your option.