[aguimaraes1986]

I made a CLI tool to generate Bitcoin private keys offline on air-gapped machines. Its for cold storage, you run it, it prints the keypair, and thats it. No wallet, no network, no state.

The code is around 500 lines of Rust with 6 dependencies (secp256k1, bitcoin_hashes, bech32, getrandom, zeroize, clap). 60 tests including known vectors from Bitcoin wiki and BIP173.

I built this because I wanted a key generator where I can read every line of code myself. Everything else I found was either a full wallet with too much code to check, or a Python/JS tool that I cant compile into a static binary for an offline machine.

Its v0.0.1 and not audited. I'm posting here because I want people to break it. The codebase is small enough to read in one afternoon.

Things I want feedback on:

- Threat model and security assumptions (in the docs/ folder) - Is the entropy handling correct - I wrote Base58 inline (~30 lines) to avoid a dependency, should I not have done that - Anything that would be a problem for real cold storage use

Docs: https://github.com/aguimaraes/btc-keygen/tree/main/docs Repo: https://github.com/aguimaraes/btc-keygen Website: https://aguimaraes.github.io/btc-keygen