在即将正式发布的Hyperledger Fabric SDK 1.0中,Hyperledger Fabric通过gRPC提供服务接口以取代现有的REST API。本文介绍了如何使用Node.JS访问Hyperledger Fabric的gRPC服务。
Hyperledger Fabric的gRPC服务接口可以通过安装Hyperledger fabric Client (HFC)获取。
在工作目录下运行如下npm
命令以安装HFC。
npm install hfc
gRPC接口定义文件(.proto)都在HFC的lib\protos
下
api.proto
ca.proto
chaincode.proto
chaincodeevent.proto
devops.proto
events.proto
fabric.proto
server_admin.proto
其中的api.proto
定义了名为Openchain
的服务, 该服务提供了若干个接口以获取Hyperledger Fabric区块网络的具体信息。
// Interface exported by the server.
service Openchain {
// GetBlockchainInfo returns information about the blockchain ledger such as
// height, current block hash, and previous block hash.
rpc GetBlockchainInfo(google.protobuf.Empty) returns (BlockchainInfo) {}
// GetBlockByNumber returns the data contained within a specific block in the
// blockchain. The genesis block is block zero.
rpc GetBlockByNumber(BlockNumber) returns (Block) {}
// GetBlockCount returns the current number of blocks in the blockchain data
// structure.
rpc GetBlockCount(google.protobuf.Empty) returns (BlockCount) {}
// GetPeers returns a list of all peer nodes currently connected to the target
// peer.
rpc GetPeers(google.protobuf.Empty) returns (PeersMessage) {}
}
以下代码使用GetBlockCount
接口获取区块总数。
var fs = require('fs');
var grpc = require('grpc');
var ProtoBuf = require("protobufjs");
var apiProto = grpc.load("./protos/api.proto").protos;
var client = new apiProto.Openchain('192.168.99.100:7051', grpc.credentials.createInsecure());
client.getBlockCount({}, function(err, blockCount) {
if (err) {
console.log("Error :" + err);
} else if (blockCount) {
console.dir(blockCount, { depth: null });
}
});
GetBlockCount
接口返回一个BlockCount
消息, 该消息包含一个count
成员, 也就是当前网络中的区块总数。
message BlockCount {
uint64 count = 1;
}
以下代码则使用GetBlockByNumber
接口获取某个区块的信息。
function callbackForBlock(blockNumber) {
return function(err, block) {
console.log("Block[" + blockNumber.number + "]");
if (err) {
console.log("Error :" , err);
} else if (block) {
console.dir(block, { depth: null });
}
console.log("=======================");
};
}
for (var n=0; n<blockCount.count; n++) {
var blockNumber = {
number : n
};
client.getBlockByNumber(blockNumber, callbackForBlock(blockNumber));
}
GetBlockByNumber
接口需要一个输入参数, 用于指定区块号码,其返回消息则是一个Block
消息, 其数据结构定义在fabric.proto
中。
总结
本文介绍了一个使用Node.JS访问Hyperledger Fabric gRPC服务的示例程序。