Skip to main content
This content applies to WaaS 1.0 only. We highly recommend that you upgrade to WaaS 2.0.
Cobo MPC WaaS provides Hard Key Recovery for disaster recovery. The tool named cobo-mpc-recovery-tool in this repository can reconstruct the MPC private key that corresponds to the Cobo MPC wallet. Binary archives are published at https://github.com/CoboGlobal/cobo-mpc-recovery-kits/releases

โ€‹
Building the source

Building binary from the source in local environment, instead of using published binary archives
  • Go 1.18 is required. Manually install Go, please click here
  • Clone the repository: 
git clone https://github.com/CoboGlobal/cobo-mpc-recovery-kits.git
  • Enter the directory
cd cobo-mpc-recovery-kits
  • Build cobo-mpc-recovery-tool
make tool
Binary executable found in the build directory

โ€‹
Commands

โ€‹
Recovery command

Reconstruct all MPC key shares in TSS group recovery files, and derive the child private keys of all wallet addresses under the Cobo MPC wallet 
cobo-mpc-recovery-tool [flags]
flagsDescription
csv-fileaddress csv file, contains HD derivation paths
csv-output-diraddress csv output dir, derive keys file output in this directory (default โ€œrecoveryโ€)
group-idrecovery group id
group-recovery-filesTSS group recovery files, such as recovery/tss-group-id-node-1-time1,recovery/tss-group-id-node-2-time2
pathskey HD derivation paths
show-root-private-keyshow TSS root private key

โ€‹
Verify command

Verify all TSS group recovery files are valid 
cobo-mpc-recovery-tool verify [flags]
flagsDescription
group-idrecovery group id
group-recovery-filesTSS group recovery files, such as recovery/tss-group-id-node-1-time1,recovery/tss-group-id-node-2-time2

โ€‹
Running

  • Prerequisites
    • Acquire TSS group recovery files (JSON format) that contain exported MPC key shares.
    • Passphrase of each TSS group recovery file
  • Create a new recovery folder in the same directory level as cobo-mpc-recovery-tool, and paste the TSS group recovery files under the recovery folder 
โ”œโ”€โ”€ cobo-mpc-recovery-tool
โ””โ”€โ”€ recovery
    โ”œโ”€โ”€ tss-group-<GROUP_ID>-node-<NODE_ID1>-recovery-<TIME1>
    โ””โ”€โ”€ tss-group-<GROUP_ID>-node-<NODE_ID2>-recovery-<TIME2>
  • Execute the verify command
./cobo-mpc-recovery-tool verify \
    --group-recovery-files recovery/tss-group-<GROUP_ID>-node-<NODE_ID1>-recovery-<TIME1>,recovery/tss-group-<GROUP_ID>-node-<NODE_ID2>-recovery-<TIME2> \
    --group-id <GROUP_ID>
  • (Optional) Locate the address.csv file after manually exporting the address information from Cobo Custody Web. Please paste address.csv under the recovery folder
โ”œโ”€โ”€ cobo-mpc-recovery-tool
โ””โ”€โ”€ recovery
    โ”œโ”€โ”€ address.csv
    โ”œโ”€โ”€ tss-group-<GROUP_ID>-node-<NODE_ID1>-recovery-<TIME1>
    โ””โ”€โ”€ tss-group-<GROUP_ID>-node-<NODE_ID2>-recovery-<TIME2>
  • Execute the recovery command
Adding flag --csv-file recovery/address.csv or --paths are optional and alternative to recovery command 
./cobo-mpc-recovery-tool \
    --group-recovery-files recovery/tss-group-<GROUP_ID>-node-<NODE_ID1>-recovery-<TIME1>,recovery/tss-group-<GROUP_ID>-node-<NODE_ID2>-recovery-<TIME2> \
    --group-id <GROUP_ID> \
    --show-root-private-key
The MPC root private key and the MPC root extended public key will be reconstructed and shown in logs.
  • Once the execution completed, if flag --csv-file recovery/address.csv added, all child private keys will be saved under the recovery/address-recovery-<TIME>.csv file in plain text. Please make sure that all data stored securely.
Feel free to share your feedback to improve our documentation!