💼
Cobo MPC Co-Managed Custody
English
English
  • Cobo MPC Co-Managed Custody
    • MPC-TSS Technology
    • Quick Start Guide
      • Cobo Custody
        • Manage Account
          • Team (Only Visible to Admins)
          • Me (Team Members)
      • TSS Node Deployment
      • MPC Wallet Management on Cobo Custody Web
    • Web User Guide
      • Add TSS Node
      • Create MPC Wallet(s)
        • Send / Receive Wallet
          • Manage Coins
          • Create and Manage Wallet Addresses
          • Export Addresses
          • View Transactions
          • Configure Risk Control Policies
          • Manage API
          • Manage API Callbacks
          • Manage Settings
        • Web3 Wallet
          • Create and Manage Wallet Addresses
          • View NFTs
          • Access DApps
            • Cobo Connect
            • MetaMask Institutional
          • View Transactions
          • Manage Coins
          • Configure Risk Control Policies
          • Manage API
          • Manage API Callbacks
          • Manage Settings
    • TSS Node User Guide
      • Network Requirements
      • Server Environment Preparation
        • SGX-Ready Server
        • Off-The-Shelf Server
        • Apple MacBook
      • TSS Node Deployment
        • TSS Node Package
        • TSS Node Initialization
        • TSS Node Startup
        • TSS Node on Cobo Custody Web & MPC Root Extended Public Key Derivation
      • TSS Node Callback
        • TSS Node Callback Mechanism
        • Callback Server Requirements
          • Callback Server Examples
        • Callback Server Configuration
        • TSS Node Configuration & Callback Server Startup
      • TSS Node Update
      • TSS Node Release Notes
      • Appendix
        • TSS Node Configuration Methods
        • TSS Node Command Lines
        • TSS Node Risk Control
    • MPC Key Share User Guide
      • MPC Key Share Management
        • Backup
        • Restore
      • Disaster Recovery
        • Soft Key Recovery
        • Hard Key Recovery
        • Third Party Key Recovery
    • Supported Tokens and Chains
Powered by GitBook
LogoLogo
On this page
  • Init: initialize the TSS Node
  • Info: view the information
  • Info group: view the group information
  • Start: start up the TSS Node
  • Version: query the version
  • Status: check the running states
  • Log: view container logs
  • Stop: stop the TSS Node
  1. Cobo MPC Co-Managed Custody
  2. TSS Node User Guide
  3. Appendix

TSS Node Command Lines

Init: initialize the TSS Node

sudo ./tss-node.sh init

You’ll be able to initialize the TSS Node and create a database file. The execution will fail if the database file already exists. For more information, please refer to "TSS Node Initialization."

Info: view the information

sudo ./tss-node.sh info

You can review information associated with the TSS Node:

  • Node ID

  • Callback server’s RSA public key

Output example:

$ sudo ./tss-node.sh info
Container started: 5c3819f6bf9425312ad5fe9561a9d8a4ae7145e05f73b3998a3a8112d7056653
Wait a few seconds ..
INFO[2022-12-14T09:12:11Z] Node ID: coboXNCDGc4eWaWYTbbgH3Q5jmNNRpZzVatRXyanYeC2XjkJb
INFO[2022-12-14T09:12:11Z] Callback public key:
-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz13MMDtCMdmBci/f7boS
……
gQIDAQAB
-----END PUBLIC KEY-----
5c3819f6bf9425312ad5fe9561a9d8a4ae7145e05f73b3998a3a8112d7056653

Info group: view the group information

sudo ./tss-node.sh info group [group_id]

What is a group?

Each group is composed of three TSS Nodes. In other words, each group manages the three MPC key shares associated with a MPC root extended private key. Do note that the root extended private key will not be materialized in any single location.

If a TSS Node manages the MPC key shares for different MPC root extended private keys, it will then belong to multiple groups simultaneously.

You can use the info group command to query the following group information:

Item

Value

Description

Group ID

vnJShriEOIzBLaOUxUDs

Unique identifier of each group

Created Time

2023-01-11 14:36:42.179778596 +0000 UTC

Creation time of the group

Root Extended Public Key

xpub661MyMwAq……Mcet8

MPC root extended public key corresponding to the MPC key shares under the current group

ChainCode

0x098a……9dd9

ChainCode corresponds to the MPC root extended public key; hexadecimal

Share ID

121637……483926

Share ID of a MPC key share; decimal

Share Public Key

0x0231adf……d2773

Public key corresponds to the MPC key share; default: compressed public key; hexadecimal

Type

1

Type: 1 represents ECDSA, and 2 represents EdDSA

Curve

secp256k1

Supported signature algorithm

Threshold

2

Minimum number of MPC key shares required for each transaction signing

Local Node ID

coboA1B2C3D4

Node ID of the locally stored TSS Node

Other Node IDs

[coboA1B2C3D4, coboA2B3C4D5]

Node IDs of the TSS Nodes managed by other parties

Participants:

3

Total number of MPC key shares, Node IDs, MPC key share IDs, MPC key share public keys

Start: start up the TSS Node

sudo ./tss-node.sh start

The cobo-tss-node will start to run. For more information, please refer to “TSS Node Startup.”

Version: query the version

sudo ./tss-node.sh version

You can check the version of the TSS Node.

Status: check the running states

sudo ./tss-node.sh status

Output example:

$ sudo ./tss-node.sh status
Checking docker engine ... OK, version: 19.03.6
Checking container image ... OK, id: sha256:4ff66478be3f193293fbaf85ce764734dab14eff002699636d1329a16f1ce57b

=================================================================
Recent logs from TSS-node daemon container cefc3335c10b (Running)
-----------------------------------------------------------------
INFO[2022-12-14T09:00:37Z] Failed to register service: invalid TSS Node, please initial TSS Node in Cobo Custody Web first
INFO[2022-12-14T09:00:52Z] Start to register service
INFO[2022-12-14T09:00:52Z] Failed to register service: invalid TSS Node, please initial TSS Node in Cobo Custody Web first
INFO[2022-12-14T09:01:07Z] Start to register service
INFO[2022-12-14T09:01:07Z] Failed to register service: invalid TSS Node, please initial TSS Node in Cobo Custody Web first

Execution workflow:

  • Check whether the Docker Engine has been successfully installed and whether the client has been granted permissions

  • Check whether the SGX driver is running (applicable to a SGX-ready version)

  • Check whether the container image has been built

  • Check whether any container has an error

  • Check the TSS Node container that is currently running and output the latest five logs

Log: view container logs

sudo ./tss-node.sh log

The container logs will be displayed. To view more, please access the complete log files in the logs/folder.

Stop: stop the TSS Node

sudo ./tss-node.sh stop

The TSS Node will no longer run on the backend.

PreviousTSS Node Configuration MethodsNextTSS Node Risk Control

Last updated 11 months ago