Head back to Documentation


Create QRL Mnemonic From Dice

For those who are completely paranoid about random number generation, it is possible to create entropy for a seed or mnemonic by rolling a dice.

The more sides the dice has the more bits of entropy may be gathered with each roll, resulting in fewer rolls to complete a mnemonic.

The functions work for any sided dice, but I would recommend a polyhedral dice (e.g. 100 sided) which allows 6 bits of entropy per roll to be harvested.

QRL Mnemonic Generation

For the QRL mnemonic (34 words, 12 bits per word, 408 bits required) this translates to 68 dice rolls to complete a mnemonic phrase.


You will need a dice, a PC with python loaded and some time to roll the dice.

Security First

To securely generate a QRL mnemonic you will want to work in an offline, air gapped PC. Make sure you are not running on an infected piece of hardware. It is recommended to boot into a live USB running a Linux distribution.

There are lots of options out there for distributions to use. The biggest thing here is the OS is brand new, and not previously compromised.

Live USB Distribution options

Always verify the hash of the file you grab to ensure the file is not tampered with.


You need to get the files hosted on github and save them to the PC.

Clone the repository from github:

git clone https://github.com/surg0r/dice.git

To run the software use:

python dice.py

Follow the instructions rolling the dice the appropriate number of times and record the number rolled each time. This will create a truly random mnemonic phrase from the word-list found in the repository on github.

Still stuck? There's help over on Discord!