【干货干货】configtxlator 工具介绍

这一章我们对configtxlator做一个解说。

 

1, configtxlator 他是什么，有什么用？

   configtxlator 官方说明是用于生成Hyperledger结构通道配置的实用程序；

   此工具提供：编码(proto_encode)、解码(proto_decode)、对比修改结构(compute_update)以及版本信息(version)

  

2, 如何使用configtxlator工具

   从工具的源码定义上,我这里将它有分为了两种用法，：

    (a), 工具非服务化

      

       在cli中动态增加组织的时候，我们configtxlator proto_encode或 configtxlator  proto_decode  这种方式。

       proto_encode和proto_decode两个命令所拥有的参数是一样的，都需要以下几个参数设置：

              type ： 消息结构体类型

              input ： 输入参数，encode（值是json格式），decode（值是proto格式的字节数组）

              output：输出结果；根据输入，输出的是json或者proto格式。

 

              type包含以下几种：

common.Block	区块结构
common.Envelope	带有效载荷和数字签名的数字信封，区块的数据部分就是序列化后的数字信封
common.ConfigEnvelope	包含链配置的数字信封，内容包含ConfigUpdateEnvelope
common.ConfigUpdateEnvelope	提交给排序节点的配置数字信封
common.Config	ConfigEnvelope的配置部分
common.ConfigUpdate	ConfigUpdateEnvelope的一部分

 

 

        compute_update计算修改量，命令拥有以下几个参数

                original ：原始的proto

                updated：修改后的proto

                channel_id：通道id

                output：对比计算后的目标修改配置proto

 

         举例：将当前channel的块消息中的配置decode为json文件

          configtxlator proto_decode --input mychannel.pb --type common.Block | jq .data.data[0].payload.data.config > mychannel.json

         Json内容：

         

 

 

       (b), 工具服务化

      

     可以执行一下命令，启动此工具的rest服务：

     ./configtxlator start --hostname="0.0.0.0" --port=7059

     Hostname : 主机ip，默认当前机器ip

     Port:服务端口，默认7059

     服务启动，通过路由提供一下几种服务：

    

     MsgName对应的就是非服务化中的type。

    

     举例：java中的使用样例

    

 

      如果想查看计算后获取目标修改配置的信息，可以使用common.Envelope,进行解码查看json数据。

      具体给个方法是如何实现的，逻辑不复杂，就不做详细描述了。