io-vault-disaster-recovery-cli

README

TSS Recovery Tool

This tool is intended to recover the private key of TSS vaults, by 'combining' the secrets of each TSS app backup file.

If you pass export and password it will generate a keystore file.

Compiling

Compile for current arch:

$ make build

Compile for Windows:

$ make build-win

The resulting executable will be in the bin/ folder.

Usage

First you will want to get the vault IDs available in the files:

$ ./bin/recovery-tool sandbox/file1.bin sandbox/file2.bin

Once you have the vault-ids, supply it to the tool to begin the recovery.

$ ./bin/recovery-tool --vault-id cl347wz8w00006sx3f1g23p4s sandbox/file1.bin sandbox/file2.bin

Bitcoin Recovery

The tool exports two WIFs for import into the Electrum Bitcoin wallet: one for mainnet (bc1 address), and another for testnet (tb1 address). Choose the one depending on your vault's environment.

A WIF looks like: L1CujRNEhNfZgTS9b6e3hytTDu7gpUv1kiLx4ETEEhEc8nJcx4QA

You may download Electrum wallet, and follow these steps to import a WIF:

IMPORTANT: If you intend to recover a testnet key (address with tb1 prefix), you must run Electrum with the --testnet flag from your Terminal: On a Mac, this is done as follows: open -n /Applications/Electrum.app --args --testnet

Prefix the WIF string with with p2wpkh:, then paste it into the box.

Create a password for the wallet.

After syncing up the chain (may take a while), Electrum should show your balances, and the private key is recovered.