1.4.3.17. 更新共识节点地址待签名payload生成
参数说明
nodeOrgId: 节点组织Id
nodeOldNodeId: 节点原Id
nodeNewNodeId: 节点新Id
CreateChainConfigConsensusNodeIdUpdatePayload(nodeOrgId, nodeOldNodeId, nodeNewNodeId string) (*common.Payload, error)
1.4.3.18. 删除共识节点地址待签名payload生成
参数说明
nodeOrgId: 节点组织Id
nodeId: 节点Id
CreateChainConfigConsensusNodeIdDeletePayload(nodeOrgId, nodeId string) (*common.Payload, error)
1.4.3.19. 添加共识节点待签名payload生成
参数说明
nodeOrgId: 节点组织Id
nodeIds: 节点Id
CreateChainConfigConsensusNodeOrgAddPayload(nodeOrgId string, nodeIds []string) (*common.Payload, error)
1.4.3.20. 更新共识节点待签名payload生成
参数说明
nodeOrgId: 节点组织Id
nodeIds: 节点Id
CreateChainConfigConsensusNodeOrgUpdatePayload(nodeOrgId string, nodeIds []string) (*common.Payload, error)
1.4.3.21. 删除共识节点待签名payload生成
参数说明
nodeOrgId: 节点组织Id
CreateChainConfigConsensusNodeOrgDeletePayload(nodeOrgId string) (*common.Payload, error)
1.4.3.22. 添加共识扩展字段待签名payload生成
参数说明
kvs: 字段key、value对
CreateChainConfigConsensusExtAddPayload(kvs []common.KeyValuePair) (common.Payload, error)
1.4.3.23. 更新共识扩展字段待签名payload生成
参数说明
kvs: 字段key、value对
CreateChainConfigConsensusExtUpdatePayload(kvs []common.KeyValuePair) (common.Payload, error)
1.4.3.24. 删除共识扩展字段待签名payload生成
参数说明
keys: 待删除字段
CreateChainConfigConsensusExtDeletePayload(keys []string) (*common.Payload, error)
1.4.3.25. 修改地址类型payload生成
参数说明
addrType: 地址类型,0-ChainMaker; 1-ZXL
CreateChainConfigAlterAddrTypePayload(addrType string) (*common.Payload, error)
1.4.3.26. 启用或停用Gas计费开关payload生成
CreateChainConfigEnableOrDisableGasPayload() (*common.Payload, error)
1.4.3.27. 开启或关闭链配置的Gas优化payload生成
CreateChainConfigOptimizeChargeGasPayload(enable bool) (*common.Payload, error)
1.4.3.28. 查询最新权限配置列表
GetChainConfigPermissionList() ([]*config.ResourcePolicy, error)
1.4.4. 证书管理接口
1.4.4.1. 用户证书添加
参数说明
在common.TxResponse.ContractResult.Result字段中返回成功添加的certHash
go AddCert() (*common.TxResponse, error)
1.4.4.2. 用户证书删除
参数说明
certHashes: 证书Hash列表
DeleteCert(certHashes []string) (*common.TxResponse, error)
1.4.4.3. 用户证书查询
参数说明
certHashes: 证书Hash列表 返回值说明
*common.CertInfos: 包含证书Hash和证书内容的列表
QueryCert(certHashes []string) (*common.CertInfos, error)
1.4.4.4. 获取用户证书哈希
GetCertHash() ([]byte, error)
1.4.4.5. 生成证书管理操作Payload(三合一接口)
参数说明
method: CERTS_FROZEN(证书冻结)/CERTS_UNFROZEN(证书解冻)/CERTS_REVOCATION(证书吊销)
kvs: 证书管理操作参数
CreateCertManagePayload(method string, kvs []common.KeyValuePair) common.Payload
1.4.4.6. 生成证书冻结操作Payload
参数说明
certs: X509证书列表
CreateCertManageFrozenPayload(certs []string) *common.Payload
1.4.4.7. 生成证书解冻操作Payload
参数说明
certs: X509证书列表
CreateCertManageUnfrozenPayload(certs []string) *common.Payload
1.4.4.8. 生成证书吊销操作Payload
参数说明
certs: X509证书列表
CreateCertManageRevocationPayload(certCrl string) *common.Payload
1.4.4.9. 待签payload签名
一般需要使用具有管理员权限账号进行签名 参数说明
payload: 待签名payload
SignCertManagePayload(payload common.Payload) (common.EndorsementEntry, error)
1.4.4.10. 发送证书管理请求(证书冻结、解冻、吊销)
参数说明
payload: 交易payload
endorsers: 背书签名信息列表
timeout: 超时时间,单位:s,若传入-1,将使用默认超时时间:10s
withSyncResult: 是否同步获取交易执行结果 当为true时,若成功调用,common.TxResponse.ContractResult.Result为common.TransactionInfo 当为false时,若成功调用,common.TxResponse.ContractResult为空,可以通过common.TxResponse.TxId查询交易结果
SendCertManageRequest(payload common.Payload, endorsers []common.EndorsementEntry, timeout int64,
withSyncResult bool) (*common.TxResponse, error)
1.4.5. 消息订阅接口
1.4.5.1. 区块订阅
参数说明
startBlock: 订阅起始区块高度,若为-1,表示订阅实时最新区块
endBlock: 订阅结束区块高度,若为-1,表示订阅实时最新区块
withRwSet: 是否返回读写集
onlyHeader: 若设置为true,将忽略withRwSet选项,仅返回区块头(common.BlockHeader),若设置为false,将返回common.BlockInfo
SubscribeBlock(ctx context.Context, startBlock, endBlock int64, withRWSet, onlyHeader bool) (<-chan interface{}, error)
1.4.5.2. 交易订阅
参数说明
startBlock: 订阅起始区块高度,若为-1,表示订阅实时最新区块
endBlock: 订阅结束区块高度,若为-1,表示订阅实时最新区块
contractName :指定订阅指定合约的交易,可以传用户合约名称或系统合约名称,若为空,表示订阅所有合约的交易
txIds: 订阅txId列表,若为空,表示订阅所有txId
SubscribeTx(ctx context.Context, startBlock, endBlock int64, contractName string,
txIds []string) (<-chan interface{}, error)
1.4.5.3. 合约事件订阅
参数说明
startBlock: 订阅起始区块高度,若为-1,表示订阅实时最新区块
endBlock: 订阅结束区块高度,若为-1,表示订阅实时最新区块
contractName :指定订阅的合约名称
topic :指定订阅主题
SubscribeContractEvent(ctx context.Context, startBlock, endBlock int64, contractName,
topic string) (<-chan interface{}, error)
1.4.5.4. 多合一订阅
参数说明
txType: 订阅交易类型,目前已支持:区块消息订阅(common.TxType_SUBSCRIBE_BLOCK_INFO)、交易消息订阅(common.TxType_SUBSCRIBE_TX_INFO)
payloadBytes: 消息订阅参数payload
Subscribe(ctx context.Context, payloadBytes *common.Payload) (<-chan interface{}, error)
1.4.6. 证书压缩
开启证书压缩可以减小交易包大小,提升处理性能
1.4.6.1. 启用压缩证书功能
EnableCertHash() error
1.4.6.2. 停用压缩证书功能
DisableCertHash() error
1.4.7. 层级属性加密类接口
注意:层级属性加密模块 Id 使用 / 作为分隔符,例如: Org1/Ou1/Member1
1.4.7.1. 生成层级属性参数初始化交易 payload
参数说明
orgId: 参与方组织 id
hibeParams: 传入序列化后的hibeParams byte数组
CreateHibeInitParamsTxPayloadParams(orgId string, hibeParams []byte) ([]*common.KeyValuePair, error)