Skip to content

Latest commit

 

History

History
151 lines (97 loc) · 5.5 KB

README.md

File metadata and controls

151 lines (97 loc) · 5.5 KB

Seedtool Application Instructions

The seedtool utility allows you to generate and recover BIP-32 HD wallet master seeds using BIP-39 and SSKR formats. In addition, it supports viewing extended keys and addresses in different formats.

This guide assumes you have successfully completed with Seedtool Installation Instructions.

"No Seed" Functions

There are 4 ways to insert a seed into the seedtool:
A - Generate seed with Dice
B - Restore seed from BIP39
C - Restore seed from SSKR
D - Complete a randomly constructed BIP39 sentence

No Seed Menu

Seed Generation with Dice

By rolling dice and typing the values, you can gather enough auditable entropy to generate a secure master seed. Rolling 50 dice gathers roughly 128 bits of entropy.

Generate Seed

If you press C, 128 bits of TRNG entropy will be mixed in:

Generate Seed

BIP-39 Key Recovery

You can insert a key into the seedtool by entering its BIP-39 recovery mnemonic passphrase. From there you can generate SSKR shares.

BIP-39 Restore

SSKR Recovery

If you possess enough shares of a SSKR set, you can recover the master seed with seedtool. From there you can generate the BIP-39 mnemonic passphrase which will allow you to use it with most wallets.

SSKR Recovery Menu SSKR Share Entry

Completing a randomly constructed BIP39 sentence

This is a way to generate your own seed without relying on hardware or software. See instructions

Functions with a Seed

Once you have a seed through any of the prior flows, you can create BIP-39 and SSKR mnemonic passphrases. In addition, you can view extended public and private keys, wallet addresses etc.

Seed Present Menu

BIP-39 Generation

The BIP-39 phrase is displayed and can be backed up in a secure offline fashion (e.g., hammering into metal).

BIP-39 View

SSKR Generation

SSKR requires some configuration choices to determine total number of shares and the required number of shares present to recover.

SSKR Generation Config SSKR Share View

You can choose among different formats:
SSKR Share Format SSKR Share View UR SSKR Share View QRUR

Displaying Keys

Extended public and private keys (XPUBs and XPRIVs) can be shown in different formats (base58, UR, QR) with different options: slip132, with derivation path and privkey. If privkey is selected, an extended private key (XPRIV) is shown. Derivation path can be manually set or chosen among standard ones: native segwit, nested segwit and cosigner. Cosigner is the one that can be used in multisignature setups.

XPUB BASE58 XPUB OPTIONS XPUB UR

XPUB OPTIONS XPUB OPTIONS XPUB DERIVATION

Displaying Seed

You can choose to export seed in UR or QR-UR format.

seed ur seed qrur

Displaying Addresses

ADDR TEXT ADDR ur ADDR qr ADDR qrur ADDR format

A wallet can be exported in the 4 different formats (text, QR, UR and QR-UR):

wallet export wallet export text wallet export text wallet export text

Setting network

By pressing 1 in Seed Present menu, you can choose among mainnet, testnet and regtest:

wallet export text

Common Workflows

There are several common key management workflows that seedtool is useful for.

Generate a New Wallet

By using dice to generate a BIP-39 mnemonic passphrase, you can avoid trusting a particular hardware vendor's hardware. See: RNG subversion

To execute this flow with seedtool:

  1. Generate a new master seed using 50+ die rolls.
  2. Record your master BIP-39 backup in a secure manner (hammer into metal). This BIP-39 backup may be restored into most other wallets for common use.
  3. Optionally create a SSKR sharded backup set which can serve as long-term cold storage.

Generate a SSKR Backup Set for an Existing Wallet

If you've already got a wallet in use, and have the BIP-39 backup for it, you can generate a SSKR backup set as well:

  1. Restore your seed in seedtool using your BIP-39 backup.
  2. Create a SSKR sharded backup.

Recover a Master Seed from SSKR Backup Shards

If you need to recover your master seed and have enough shards from a SSKR backup set:

  1. Recover the master seed from the SSKR shards.
  2. Create a BIP-39 mnemonic which may then be directly restored into most wallets for use.