HyperledgerFabric1.4节点SDK快速入门指南

hyperledger fabric的node sdk最新版本为1.4&＃xff0c;本文将介绍如何使用最新版本的fabric node sdk开发node.js应用&＃xff0c;以实现与fabric区块链的交互&＃xff0c;例如查询链码状态&＃xff0c;或者提交链码交易。

本文分五个部分来介绍node.js开发人员如何快速上手fabric node sdk&＃xff1a;

• 工作原理&＃xff1a;介绍fabric node sdk的工作机制与实现原理
• 身份标识&＃xff1a;介绍在fabric node sdk中如何标识应用的身份&＃xff08;证书与密钥&＃xff09;
• 通道配置&＃xff1a;介绍在fabric node sdk中如何配置通道的网络拓扑
• 链码状态查询&＃xff1a;介绍使用fabric node sdk查询链码状态的方法
• 链码交易提交&＃xff1a;介绍使用fabric node sdk提交链码交易的方法

如果希望高效系统地掌握Fabric区块链的链码及应用开发&＃xff0c;建议访问汇智网的在线互动课程&＃xff1a;

• Fabric区块链Java开发详解
• Fabric区块链NodeJs开发详解

1、fabric node sdk 工作原理

在hyperledger Fabric区块链架构中&＃xff0c;应用是通过节点的RPC协议API接口访问安装在peer节点上的链码&＃xff1a;

类似于shim api对链码通信协议的封装&＃xff0c;Fabric Node SDK提供了对节点RPC协议接口的封装&＃xff0c;其入口类为Client&＃xff0c;通道操作则封装在Channel类中&＃xff1a;

2、fabric node sdk中的身份标识

由于hyperledger fabric是许可制&＃xff08;Permissioned&＃xff09;区块链&＃xff0c;每一个参与fabric区块链的成员都需要有明确的身份标识&＃xff0c;因此fabric node sdk中的Client实例需要使用一个User实例来表征其访问Fabric区块链网络的身份。例如&＃xff0c;下面的node.js代码载入本地msp目录中的PEM编码的用户证书与相应的密钥并生成User对象&＃xff0c;然后设置为Client实例的当前身份&＃xff1a;

let client &＃61; new Client
let keyPem &＃61; fs.readFileSync(&＃39;.msp/keystore/user-key.pem&＃39;,&＃39;utf-8&＃39;)
let certPem &＃61; fs.readFileSync(&＃39;./msp/signcerts/user-cert.pem&＃39;,&＃39;utf-8&＃39;)
let user &＃61; await client.createUser({ //创建User对象username: &＃39;user&＃39;, //用户名称mspid: &＃39;SampleOrg&＃39;, //所属MSP的IDcryptoContent: {privateKeyPEM: keyPem, //用户私钥signedCertPEM: certPem //用户证书},skipPersistence: true //不计入缓存
})
client.setUserContext(user,true) //设置为client的当前身份


2、fabric node sdk通道配置

使用Client实例的newChannel()方法可以创建一个空的通道对象&＃xff0c;我们还需要添加Peer和Orderer实例&＃xff0c;以便该通道对象了解要访问的fabric网络的拓扑结构。例如&＃xff0c;下面的node.js代码为通道对象配置部署在本机的peer对等节点和orderer排序节点&＃xff0c;在默认配置下&＃xff0c;对等节点在7051端口监听&＃xff0c;而排序节点在7052端口监听&＃xff1a;

let channel &＃61; client.newChannel(&＃39;ch1&＃39;)
channel.addPeer(client.newPeer(&＃39;grpc://127.0.0.1:7051&＃39;))
channel.addOrderer(client.newOrderer(&＃39;grpc://127.0.0.1:7050&＃39;))


3、fabric node sdk查询链码状态

在fabric node sdk中&＃xff0c;通道对象的queryByChaincode()方法用于链码状态查询。例如&＃xff0c;下面的node.js代码调用链码counter-cc中定义的value()方法&＃xff0c;以获取计数器的当前值&＃xff1a;

let req &＃61; {chaincodeId: &＃39;counter-cc&＃39;,fcn: &＃39;value&＃39;,args: []
}
let ret &＃61; await channel.queryByChaincode(req)


4、fabric node sdk提交链码交易

在fabric node sdk中&＃xff0c;向链码提交交易则复杂一些&＃xff0c;需要依次使用sendTransactionProposal()和sendTransaction()这两个方法&＃xff0c;这是因为hyperledger fabric引入了背书&＃xff08;endorsement&＃xff09;机制&＃xff0c;在应用向排序节点提交交易之前&＃xff0c;需要按照既定的策略首先获取对等节点的背书。

提交链码交易的时序表示如下&＃xff1a;

下面的代码展示了在fabric node sdk中链码交易的两阶段提交过程&＃xff1a;

let req &＃61; {chaincodeId: &＃39;counter-cc&＃39;,fcn: &＃39;inc&＃39;,args: [&＃39;10&＃39;],txId: client.newTransactionID()
}
let prsp &＃61; await channel.sendTransactionProposal(req) //获取peer背书
let rsp &＃61; await channel.sendTransaction({ //提交交易proposalResponses: prsp[0],proposal: prsp[1]
})


汇智网原创&＃xff0c;转载请标明出处。