<commit_before>dice-keygen
===========

A command line app that prompts the user to enter inputs from coin flips, or 4, 8, or 16-sided dice and turns them into a hexadecimal string. Prompted by my own desire to create a cryptographically secure Bitcoin private key offline using dice, and my unhappiness with relying on SHA-256 to produce truly random output, as "dice-wallet" does.

Build instructions:

    gcc -o keygen keygen.c

To go from the hexadecimal private key to a Bitcoin private key and public address with bash (preferably using a Linux live image on an offline, air-gapped computer), use [<NAME>'s bitcoin-bash-tools](https://github.com/grondilu/bitcoin-bash-tools). Assuming you go this route and download `bitcoin.sh` from that project, use it like so:

    source bitcoin.sh
    newBitcoinKey 0x<your hexadecimal key goes here>

I've also included a copy of Lucien's script in this repository in case the one hosted under his account ever goes offline or is compromised.
<commit_msg>Add line to README about using this utility to generate Bitcoin private keys.<commit_after>dice-keygen
===========

A command line app that prompts the user to enter inputs from coin flips, or 4, 8, or 16-sided dice and turns them into a hexadecimal string. Prompted by my own desire to create a cryptographically secure Bitcoin private key offline using dice, and my unhappiness with relying on SHA-256 to produce truly random output, as "dice-wallet" does.

Build instructions:

    gcc -o keygen keygen.c

If you are using this utility to create a Bitcoin private key, specify a bit length of 256 when prompted. Also, make sure that the generated hexadecimal string is not larger than `FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141`, which is the maximum value that can be turned into a Bitcoin private key, according to [the wiki](https://en.bitcoin.it/wiki/Private_key#Range_of_valid_private_keys).

To go from the hexadecimal private key to a Bitcoin private key and public address with bash (preferably using a Linux live image on an offline, air-gapped computer), use [<NAME>'s bitcoin-bash-tools](https://github.com/grondilu/bitcoin-bash-tools). Assuming you go this route and download `bitcoin.sh` from that project, use it like so:

    source bitcoin.sh
    newBitcoinKey 0x<your hexadecimal key goes here>

I've also included a copy of Lucien's script in this repository in case the one hosted under his account ever goes offline or is compromised.

{'fraction_non_alphanumeric': 0.060008054772452676, 'fraction_numerical': 0.01369311316955296, 'mean_word_length': 4.594594594594595, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 3, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 1, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '436721', 'n_tokens_mistral': 727, 'n_tokens_neox': 653, 'n_words': 351}