Burrow Quick Start


I release this software, set of procedures and posts, free of charge, under the MIT License, for use at your own risk, without warranty of any kind. Never use these materials (or any other software, for that matter) with assets of value unless and until you are fully comfortable with them and understand exactly what they are and how they work. My software has not yet undergone a formal, 3rd party audit.


Insecure Dry-Run

If you want to play around with Burrow on an insecure, connected device for testing purposes only then download the latest tar or zip, extract and find executables for each platform in the bin folder.

RPi Setup

For those who are anxious to get started generating an audited seed phrase on an air-gapped RPi using the ShowMyWork feature:

  1. Gather the neccessary hardware:

    • Raspberry Pi (Tested on 3B+)
    • HDMI Display
    • SD Card
    • A/C Adapter
    • USB Keyboard (wireless is discouraged)
    • Set of (at least 11) 8-sided dice
  2. Download the latest, zipped Rasberry Pi image

  3. Unzip the image using a utility like 7-zip

  4. Use a utility like Win32 Disk Imager to flash the SD Card with the unzipped image file

    • For OS-specific recommendations on SD Card flashing utilities, see the "Writing the Image" section on raspberrypi.org's Installing OS Images Guide
  5. Insert the SD Card into the Rasberry Pi and power up the device

  6. WAIT for the device to reboot TWICE

    • Once to expand the filesystem
    • Again to activate the read-only filesystem
      • The device will boot into a prompt and it will appear as though it is "just sitting"… give it 10 to 15 seconds and it will reboot a second time…
  7. Print the Seed Generation Worksheet and Lookup Tables

  8. Type burrow mnemonic -i8b 256 or seedgen and press [Enter] to interactively generate a mnemonic based on 256-bit entropy generated from rolls of 8-sided dice

    • You can find a more detailed walk-through here