Hyperledger Fabric 联盟区块链 Node.js 链码开发[秒级]

Hyperledger Fabric 是一个联盟区块链，Fabric 区块链也支持智能合约区块链最直白的解释，称为 Chaincode。 Fabric 链码是一个标准的（在 docker 容器中运行）操作系统进程，它通过 gRPC 协议与 Fabric 节点进行通信。因此，理论上可以用任何语言开发 Fabric 链码。目前官方提供三种开发语言的Fabric链码开发包：Go、Java和Node.js。本文将介绍如何使用node.js开发Fabric链码。

去汇智网以互动的方式学习更多以太坊、比特币、EOS、tendermint等区块链开发教程。

Fabric官方提供了两种开发node.js链码的方式：fabric-shim和fabric-contract-api。

使用 fabric-shim 开发 Fabric 链码

fabric-shim 是一个底层链码开发包，封装了与节点通信的grpc协议。安装方法如下：

~/fabric-shim-chaincode-demo$ npm install fabric-shim

fabric-shim 要求链码开发人员定义一个实现两个预定义方法的类。

参数stub由节点传入，它提供了一种访问链上账本的方法，以便读取或更新账本状态。

例如，以下代码实现了一个最小的 node.js 链码，每次调用链码时更新 acc0 的状态（例如，此状态可用于表示账户余额）：

const shim = require('fabric-shim');
class EzChaincode {
    async Init(stub) {       
        return shim.success(Buffer.from('init done!'));//返回success对象
    }
    async Invoke(stub) {
        let key = 'acc0';
        let oldValue = await stub.getState(key); //读取账本中acc0的状态
        let newValue = oldValue + 100; 
        await stub.putState(key, Buffer.from(newValue)); //更新acc0的状态
        return shim.success(Buffer.from('update done!'));//返回success对象
    }
};

一旦定义了链码，就可以使用 shim.start() 方法启动链码实例。例如：

const shim = require('fabric-shim');
class EzChainCode {...}
shim.start(new EzChaincode());

这是一个完整的Fabric链码！将以上代码另存为demo.js，直接用node.js启动即可：

~/fabric-shim-chaincode-demo$ node demo.js

使用fabric-contract-api开发Fabric链码

fabric-shim 是一种相对底层的fabric grpc 协议封装。它直接将链码接口暴露给开发者。虽然简单直接，但是如果要实现比较复杂的链码区块链最直白的解释，开发者需要自己在Invoke实现方法路由中创建。

fabric-contract-api 是更高级别的封装。开发者直接继承开发包提供的Contract类，不用担心合约方法的路由。 fabric-contract-api的开发方法如下：

~/fabric-contract-api-demo$ npm install fabric-contract-api

使用fabric-contract-api的链码示例代码如下，除构造函数外的每个方法都自动调用一个链码方法，可以被外部应用调用：

//demo.js
const { Contract } = require('fabric-contract-api');
class EzContract extends Contract
    constructor(){
        super('EzContract'); 
    }
    async update(ctx, newValue) {
        await ctx.stub.putState('acc0', Buffer.from(newValue));
        return Buffer.from('update done!');
    }
    async remove(ctx) {
        //.....
    }
};
module.exports.contracts = ['EzContract'];

与fabric-shim不同，fabric-contract-api只需要chaincode来导出contracts数组，所以不能直接使用node.js启动chaincode，需要使用fabric-chaincode-node程序。例如：

~/fabric-contract-api-demo$ fabric-chaincode-node demo.js