节点证书

需求分析

控制联盟链中普通节点的接入和退出。能够控制节点访问且不依赖于第三方CA。

任一想要加入联盟的节点必须经过联盟内成员的同意。申请
联盟管理员可以决定（或共同决定）踢出某个节点。吊销

总体设计

为每个节点颁发一个证书，证书类型分为4类
1. InitConsensus：创世区块中指定的共识节点，自签名
2. InitClient：创世区块中指定的观察节点（见证节点），自签名。memeberGroup: 1,0
3. Consensus：通过提案添加的共识节点证书
4. Client：通过提案申请的客户端证书、或共识节点直接颁发（不走合约）的证书。
在三处会对证书进行验证
1. 节点启动时，验证证书合法性；
2. 节点运行时，定期验证书状态；吊销
3. 节点间握手时，互相校验彼此的证书。
颁布证书的方式有三种：
1. 添加共识节点、替换共识节点时（链配置更改合约）；[A,B,C,D]; E consensus, D->E; 1把D吊销，E
2. 向节点证书合约发起申请；client 任一共识节点签名后即可
3. 节点用自己的私钥签名生成证书（但只有共识节点生成的证书才能通过验证，握手的时候校验）。
吊销证书的方式有三种
1. 删除共识节点，替换共识节点。
2. 向节点证书合约发起吊销申请。
3. 节点单方面吊销某个证书。

详细设计

新增合约

新增合约以及新增的合约方法

合约地址	新增方法	方法描述
zltc_QLbz7JHxYJDL9LAguz9rKrwNtmfY2UoAZ 节点证书合约	apply	申请证书
	revoke	申请吊销证书
	revokeClient	申请吊销节点
	uploadKey	上传公钥
	upAndApply	上传公钥并申请证书
zltc_ZwuhH4dudz2Md2h6NFgHc8yrFUhKy2UUZ链配置更改合约	addLatcSaintNew	通过公钥添加共识节点
	replaceLatcSaintNew	通过公钥替换共识节点
zltc_amgWuhifLRUoZc3GSbv9wUUz6YUfTuWy5提案投票合约	signVote	签名投票

关于证书类型

InitConsensus：创世区块配置文件genesis.json中配置了共识节点信息，latcSaints，根据此配置信息即指定了哪些节点拥有InitConsensus证书
InitClient: genesis.json中增加了配置项observers类型与 latcSaint一致，带配置项指定了哪些节点拥有InitClient证书
Consensus: 获取该类型的证书的途径: 通过添加共识节点和替换共识节点;.
Client: 获取该类型的证书有两种途径：a.通过向节点证书合约发起申请，由共识节点进行签名投票。b. 共识节点通过latc_publishCert直接发布证书。关于签名投票和**发布证书分别会在节点证书合约和新增接口**中详细说明

证书类型:

证书类型	对映int
InitConsensus	1
InitClient	2
Consensus	3
Client	4

证书验证

节点启动
节点握手

共识节点操作

1.添加共识节点

途径1：先上传新的共识节点的公钥到节点证书合约（点击跳转上传公钥的接口），然后执行后续加共识节点的逻辑

途径2：通过合约新方法：AddLatcSaintCodeNew，该方法要求申请时将公钥作为参数（之前是以地址作为参数）。

签名投票
获取证书
获取证书文件（下载）

2. 删除共识节点

删除共识节点后，被删除的共识节点（账户A），账户A的所有共识节点证书（ininConsensus, Consensus）都会被吊销；替换节点时被替换的节点同样如此。

3. 替换共识节点

4. 删除见证节点

在添加了节点证书之后，可以通过将某个见证节点的证书吊销的方式将其踢出网络。

如果已知该节点所用的证书序列号，通过合约吊销证书，可以通过latc_peers 查看连

如果未知该节点的证书序列号，可通过合约吊销客户端

5.提案结构:

如下为添加共识节点的提案内容示例，nodeCertProposal字段为生成证书的提案。==为proposalId或nodeCertProposal投票皆可。==

json

{
            "proposalId": "0x03000000007323431313139",
            "proposalState": 1,
            "nonce": 0,
            "launcher": "xxx",
            "createAt": 12312312,
            "modifiedAt": 12312312,
            "txHash": "xxx",
            "dbNumber": 0,
            "modifyType": 2,
            "configValue": [
                "xxxx"
            ],
            "nodeCertProposal": "0x05000000030323431313139"
        }

投票通过, 通过后分别查看两个提案的内容如下：

a. 链配置更改提案, receipt字段为证书序列号列表（批量添加时会有多个序列号返回）

json

{
            "proposalId": "0x03000000003230323431313139",
            "proposalState": 2,
            "nonce": 0,
            "receipt": "[\"117521\"]",
            "launcher": "xxx",
            "createAt": 1732004792,
            "modifiedAt": 1732005008,
            "txHash": "xxx",
            "dbNumber": 277,
            "modifyType": 2,
            "configValue": [
                "xxx"
            ],
            "nodeCertProposal": "0x05000000003230323431313139"
}

b. 节点证书提案。receipt字段为证书序列号列表（批量添加时会有多个序列号返回）

json

{
            "proposalId": "0x05000000003230323431313139",
            "proposalState": 2,
            "nonce": 2,
            "receipt": "[\"117521\"]",
            "launcher": "xxx",
            "createAt": 1732004792,
            "modifiedAt": 1732005008,
            "txHash": "xxx",
            "dbNumber": 276,
            "applyType": "Apply",
            "certType": "Consensus",
            "orgName": "zkjg.cn",
            "nodeCertParam": [
                {
                    "address": "zltc_Xmk6g2Lgxitrx4xEPUZgF4hHdnHwDcBuU",
                    "serialNumber": 0,
                    "certDigest": "xxx",
                    "signs": "xxx"
                }
            ],
            "configModifyProposal": "0x03000000003230323431313139"
        }

总结

如下图，旧表示之前发起相关提案的接口，新表示使用公钥替换地址作为参数的接口；

节点证书合约

节点证书合约为新增合约，合约地址为：zltc_QLbz7JHxYJDL9LAguz9rKrwNtmfY2UoAZ；合约ABI：

该合约提供了四个方法：上传公钥UPLOAD_PUB申请证书APPLY_CERT吊销证书REVOKE_CERT上传公钥并申请证书UP_APPLY。

要申请证书，公钥是必须要上传的，UP_APPLY 方法将上传公钥和申请证书放在一个步骤中。
公钥只需要上传一次：如节点A申请了一个证书过期了，现要再申请一次，可以直接通过APPLY_CERT方法申请。
在申请证书之后，提案详细中会返回证书摘要信息，”审核员“对该概要进行签名投票；
证书的过期时间为1年，暂不支持指定

节点证书提案结构

字段名	类型	描述
applyType	string	申请类型，apply/revoke
certType	string	证书类型
orgName	string	组织名，预留
nodeCertParam	[]list	{ "address": "申请人地址 address", "serialNumber": 序列号, "certDigest": "证书摘要，字符串类型 base64" "signs": "签名，字符串类型 base64" "revoked": 是否已经吊销，在批量吊销证书的时候可参考该字段 }
configModifyProposal	string	相关链的链配置已更改提案ID

申请证书

吊销证书

吊销共识节点证书，需要大多数共识节点同意（如2/3），吊销见证节点证书，只需要任一共识节点同意。

合约方法介绍

签名投票

在此之前，针对提案的投票，需要有权限的账户构造一笔交易（交易中包含提案ID以及统一或反对）发送到投票合约。在生成证书的过程中需要有权限的用户对证书内容进行签名来授权给证书合法性，这个过程需要有权限的用户针对特定内容在合约以外（安全性由用户自己控制）用自己的私钥对证书内容签名。

此时，签名投票需要账户构造一笔交易（交易中包含：提案ID，签名信息，签名者）发送到投票合约signVote方法（详情见投票预置合约ABI）

支持签名投票的提案有：
添加/更改共识节点提案（大类为配置修改提案）
申请证书提案（大类为节点证书提案）

异常情况

上述需要申请证书的功能中，由于证书需要公钥，所以在申请之前必须保证账户公钥已经上传到链上，或使用新方法用公钥代替地址。在缺失公钥时会报如下错误：申请证书需要上传公钥, 该地址的公钥还没上传

通过节点证书合约申请证书时，只能够申请client类型的证书，否则将报错：只有客户端证书才能申请
通过节点证书合约吊销节点时，只能吊销见证节点，如果尝试吊销的节点是共识节点，将会报错 只有客户端地址可以吊销

提案

区块验证

节点证书 ​

需求分析 ​

总体设计 ​

详细设计 ​

新增合约 ​

关于证书类型 ​

证书验证 ​

共识节点操作 ​

1.添加共识节点 ​

2. 删除共识节点 ​

3. 替换共识节点 ​

4. 删除见证节点 ​

5.提案结构: ​

总结 ​

节点证书合约 ​

节点证书提案结构 ​

申请证书 ​

吊销证书 ​

合约方法介绍 ​

签名投票 ​

异常情况 ​

节点证书

需求分析

总体设计

详细设计

新增合约

关于证书类型

证书验证

共识节点操作

1.添加共识节点

2. 删除共识节点

3. 替换共识节点

4. 删除见证节点

5.提案结构:

总结

节点证书合约

节点证书提案结构

申请证书

吊销证书

合约方法介绍

签名投票

异常情况