TSS Node 子命令说明

• Init 初始化

sudo ./tss-node.sh init

初始化 TSS Node 密钥和数据，创建数据库文件。如果数据库文件已经存在，则执行会失败。详情参见【初始化 TSS Node】章节。​

• Info 查看信息​

sudo ./tss-node.sh info

查看 TSS Node 基本信息，包括：

• 查看 Node ID 信息

• 查看回调客户端公钥信息

示例：

$ 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 查看 Group 信息

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

参数	描述
group_id（可选）	指定单个 Group ID 查询信息。如不指定，则输出全部 Group 信息。

Group 是指三个 TSS Node 组成的逻辑上的小组：它们共同管理同一个根私钥的三个分片。如果一个 TSS Node 参与管理了多个不同根私钥的分片，那么它同时属于多个 Group。

使用 info group 命令可以查看 TSS Node 所属的 Group 信息，包括如下属性：

属性	参考值	描述
Group ID	vnJShriEOIzBLaOUxUDs	Group 唯一标识
Created Time	2023-01-11 14:36:42.179778596 +0000 UTC	Group 创建时间
Root Extended Public Key	xpub661MyMwAq……Mcet8	当前 Group 包含的私钥分片对应的 根扩展公钥
ChainCode	0x098a……9dd9	根私钥对应的 ChainCode，16 进制
Share ID	121637……483926	私钥分片的 Share ID ，10 进制
Share Public Key	0x0231adf……d2773	私钥分片对应的公钥，默认为压缩公钥，16 进制
Type	1	类型，默认 1
Curve	secp256k1	使用的签名算法
Threshold	2	签名所需要的最少私钥分片数量
Local Node ID	coboA1B2C3D4	本地 TSS Node 的 Node ID
Other Node IDs	[coboA1B2C3D4, coboA2B3C4D5]	其他参与方的 TSS Node 的 Node ID
Participants:	3	总的私钥分片数量（即参与方总数），以及所有参与方的 Node ID、私钥分片 Share ID 与私钥分片 Share Public Key

• Start 启动后台服务

sudo ./tss-node.sh start

• Version 查看版本

sudo ./tss-node.sh version

查看 TSS Node 版本信息。

• Pull 拉取并更新容器镜像

sudo ./tss-node.sh pull

拉取最新版本的 TSS Node 容器镜像。

• Status 检查系统环境和运行状态

sudo ./tss-node.sh status

示例：

$ 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

程序执行流程：

1. 检查 docker 安装是否正常，且当前用户有权限操作 docker

2. 如果是 SGX 版本，检查 SGX 驱动是否正常

3. 检查容器镜像是否已经存在：如果已经存在，并不会主动更新；如果不存在，则拉取最新的容器镜像

4. 检查是否有状态异常的容器

5. 检查当前运行的 TSS Node 容器，并输出最近的5条日志

• Log 查看容器日志

sudo ./tss-node.sh log

显示容器的标准输出日志。如果希望看到更多日志，您可以访问 logs/ 文件夹中的完整日志文件。

• Stop 停止后台服务

sudo ./tss-node.sh stop

停止 TSS Node 后台服务。