There are three possible scenarios involving some level of disaster recovery or business continuity procedures;
- If a user has lost a signing device, but utilizes the iCloud syncing feature and possesses the signer passphrase it is possible to simply restore the signer on a new device by downloading the app, logging in, selecting the “restore signer” option and inputting their signer passphrase to decrypt the data on the new device.
- Alternatively, If a users’ signing device is lost or misplaced and the user does not know the signer passphrase, so long as there are enough available shares to reach the vault threshold using other devices, then a reshare request can be created to issue new shares to a newly registered signing device;
- Finally, If there are not enough shares available or the io.vault service becomes persistently unavailable for any reason, utilizing the offline disaster recovery process will be necessary.
7.1 Responsibility
Each user is responsible for retaining, for each of their registered signer’s: the signer passphrase, as well as downloading and storing an up-to-date encrypted device back-up file after participation in any vault creation or reshare and for the safe-keeping of their 24-word secret phrase in an offline and physically secure location.
7.2 Process to recover access
Process Ref. |
Process Step |
1 |
Members of the signing party with devices containing enough secret shares to reach the vault threshold must obtain their corresponding up-to-date encrypted back-up files and device specific 24-word secret phrases. |
2 |
The organization should then decrypt and combine these files using the publicly available, open-source tool (published here on github) on a secure offline computer to generate, for the first time, a valid private key for the desired vault. |
3 |
Follow the step by step guide from GitHub and our online guide. |
Brief Overview |
To use the recovery tool file, you need to launch it via the terminal. Follow the steps below:
For more detailed instructions on using the Terminal, refer to the Apple Terminal Guide or Windows Command Prompt guide. The tool will recover a key that is usable for all existing supported coins in the following wallets: MetaMask (for Ethereum and EVM-based coins and tokens), Electrum wallet (for Bitcoin), and TronLink (for Tron). For detailed information on the process, please visit our online guide. |
Please Note |
Troubleshooting Common Issues:
By following these steps, you should be able to successfully run and interact with the recovery tool file via the terminal |
Please Note |
This process must be used when funds cannot be withdrawn from a vault due to the inability to generate a signed transaction directly using the io.vault product. This can occur for example, by a critical software malfunction, a malicious DOS attack, a permanent service shutdown, or a critical loss of access to the io.finnet app by the user(s). |
Please Note |
The tool will recover a key that is usable for all existing supported coins in the following wallets: MetaMask (for Ethereum and EVM-based coins and tokens), Electrum wallet (for Bitcoin), and TronLink (for Tron). For newer supported chains and coins not listed here, please contact us for further information on which app to use for recovery. |