Fabric node sdk 1.4簡明教程

hyperledger fabric的node sdk最新版本為1.4，本文將介紹如何使用最新版本的fabric node sdk開發node.js應用，以實現與fabric區塊鏈的交互，例如查詢鏈碼狀態，或者提交鏈碼交易。

本文分五個部分來介紹node.js開發人員如何快速上手fabric node sdk：

• 工作原理：介紹fabric node sdk的工作機制與實現原理
• 身份標識：介紹在fabric node sdk中如何標識應用的身份（證書與密鑰）
• 通道配置：介紹在fabric node sdk中如何配置通道的網絡拓撲
• 鏈碼狀態查詢：介紹使用fabric node sdk查詢鏈碼狀態的方法
• 鏈碼交易提交：介紹使用fabric node sdk提交鏈碼交易的方法

如果希望高效系統地掌握Fabric區塊鏈的鏈碼及應用開發，建議訪問匯智網的在線互動課程：

• Fabric區塊鏈Java開發詳解
• Fabric區塊鏈NodeJs開發詳解

1、fabric node sdk 工作原理

在hyperledger Fabric區塊鏈架構中，應用是通過節點的RPC協議API接口訪問安裝在peer節點上的鏈碼：

類似于shim api對鏈碼通信協議的封裝，Fabric Node SDK提供了對節點RPC協議接口的封裝，其入口類為Client，通道操作則封裝在Channel類中：

2、fabric node sdk中的身份標識

由于hyperledger fabric是許可制（Permissioned）區塊鏈，每一個參與fabric區塊鏈的成員都需要有明確的身份標識，因此fabric node sdk中的Client實例需要使用一個User實例來表征其訪問Fabric區塊鏈網絡的身份。例如，下面的node.js代碼載入本地msp目錄中的PEM編碼的用戶證書與相應的密鑰并生成User對象，然后設置為Client實例的當前身份：

let client = new Client
let keyPem = fs.readFileSync('.msp/keystore/user-key.pem','utf-8')
let certPem = fs.readFileSync('./msp/signcerts/user-cert.pem','utf-8')
let user = await client.createUser({        //創建User對象
  username: 'user',                         //用戶名稱
  mspid: 'SampleOrg',                       //所屬MSP的ID
  cryptoContent: {
    privateKeyPEM: keyPem,                  //用戶私鑰
    signedCertPEM: certPem                  //用戶證書
  },
  skipPersistence: true                     //不計入緩存
})
client.setUserContext(user,true)            //設置為client的當前身份

2、fabric node sdk通道配置

使用Client實例的newChannel()方法可以創建一個空的通道對象，我們還需要添加Peer和Orderer實例，以便該通道對象了解要訪問的fabric網絡的拓撲結構。例如，下面的node.js代碼為通道對象配置部署在本機的peer對等節點和orderer排序節點，在默認配置下，對等節點在7051端口監聽，而排序節點在7052端口監聽：

let channel = client.newChannel('ch2')
channel.addPeer(client.newPeer('grpc://127.0.0.1:7051'))
channel.addOrderer(client.newOrderer('grpc://127.0.0.1:7050'))

3、fabric node sdk查詢鏈碼狀態

在fabric node sdk中，通道對象的queryByChaincode()方法用于鏈碼狀態查詢。例如，下面的node.js代碼調用鏈碼counter-cc中定義的value()方法，以獲取計數器的當前值：

let req = {
  chaincodeId: 'counter-cc',
  fcn: 'value',
  args: []
}
let ret = await channel.queryByChaincode(req)

4、fabric node sdk提交鏈碼交易

在fabric node sdk中，向鏈碼提交交易則復雜一些，需要依次使用sendTransactionProposal()和sendTransaction()這兩個方法，這是因為hyperledger fabric引入了背書（endorsement）機制，在應用向排序節點提交交易之前，需要按照既定的策略首先獲取對等節點的背書。

提交鏈碼交易的時序表示如下：

下面的代碼展示了在fabric node sdk中鏈碼交易的兩階段提交過程：

let req = {
  chaincodeId: 'counter-cc',
  fcn: 'inc',
  args: ['10'],
  txId: client.newTransactionID()
}
let prsp = await channel.sendTransactionProposal(req)  //獲取peer背書
let rsp = await channel.sendTransaction({              //提交交易
  proposalResponses: prsp[0],
  proposal: prsp[1]
})

匯智網原創，轉載請標明出處。