在超级账本Fabric中，链码（chaincode）延伸自智能合约的概念（链码使用参见本书9.5节），支持采用主流高级编程语言编写。

链码会对Fabric应用程序发送的交易做出响应，执行代码逻辑，与账本进行交互。区块链网络中的成员商定业务逻辑后，可将业务逻辑编程到链码中，大家遵循合约执行。

链码会创建一些状态（state）并写入账本中。状态带有绑定到链码的命名空间，仅限于创建它的链码使用，不能被其他链 码直接访问。不过，在合适的许可范围内，一个链码也可以调用另一个链码，间接访问其状态。另外，在一些场景下，不仅需要访问状态的当前值，还需要能够查询 状态的所有历史值，这就对存放账本状态的数据库提出了更多的要求。

链码在Fabric节点上的隔离沙盒（目前为Docker容器）中执行，并通过gRPC协议来与节点进行交互。必要的交互包括调用链码、读写账本、返回响应结果等。

Fabric支持多种计算机语言实现的链码，包括Golang、JavaScript、Java等。下面以Golang为例介绍链码需要实现的接口和必要结构。

13.2.1　Chaincode接口

每个链码都需要实现以下Chaincode接口：

type Chaincode interface {
    Init(stub ChaincodeStubInterface) pb.Response
    Invoke(stub ChaincodeStubInterface) pb.Response
}

其中：

·Init：当链码收到实例化（instantiate）或升级（upgrade）类型的交易时，Init方法会被调用；

·Invoke：当链码收到调用（invoke）或查询（query）类型的交易时，Invoke方法会被调用。

13.2.2　链码结构

一个链码的必要结构如下所示：

package main

// 引入必要的包
import (
    "github.com/hyperledger/fabric/core/chaincode/shim"
    pb "github.com/hyperledger/fabric/protos/peer"
)

// 声明一个结构体
type SimpleChaincode struct {}

// 为结构体添加Init方法
func (t *SimpleChaincode) Init(stub shim.ChaincodeStubInterface) pb.Response {
    // 在该方法中实现链码初始化或升级时的处理逻辑
    // 编写时可灵活使用stub中的API
}

// 为结构体添加 Invoke 方法
func (t *SimpleChaincode) Invoke(stub shim.ChaincodeStubInterface) pb.Response {
    // 在该方法中实现链码运行中被调用或查询时的处理逻辑
    // 编写时可灵活使用stub中的API
}

// 主函数，需要调用 shim.Start() 方法
func main() {
    err := shim.Start(new(SimpleChaincode))
    if err != nil {
        fmt.Printf("Error starting Simple chaincode: %s", err)
    }
}

1.依赖包

从import代码段可以看到，链码需要引入如下的依赖包：

·"github.com/hyperledger/fabric/core/chaincode/shim"：shim包提供了链码与账本交互的中间层。链码通过shim.ChaincodeStub提供的方法来读取和修改账本状态；

·pb"github.com/hyperledger/fabric/protos/peer"：Init和Invoke方法需要返回pb.Response类型。

2.Init和Invoke方法

编写链码，关键是要实现Init和Invoke这两个方法。

当部署或升级链码时，Init方法会被调用。如同名字所描述的，该方法用来完成一些初始化的工作。当通过调用链码来做一些实际性的工作时，Invoke方法被调用，因此响应调用或查询的业务逻辑都需要在该方法中实现。

Init或Invoke方法以stub shim.ChaincodeStubInterface作为传入参数，pb.Response作为返回类型。其中，stub包含丰富的API，功能包括 对账本进行操作、读取交易参数、调用其他链码等，链码开发者最好能够熟练使用这些API。

stub中包含的API将在下一节详细介绍。

13.2.3　链码基本工作原理

在Fabric中，链码运行在节点上的沙盒（Docker容器）中，被调用时的基本工作流程如图13-2所示。

图13-2　链码工作流程

首先，用户通过客户端（SDK或CLI），向Fabric的背书节点（endorser）发出调用链码的交易提案（proposal）。节点对提案进行包括ACL权限检查在内的各种检验，通过后则创建模拟执行这一交易的环境。

之后，节点和链码容器之间通过gRPC消息来交互，模拟执行交易并给出背书结论。两者之间采用ChaincodeMessage消息，基本结构如下：

message ChaincodeMessage {

    enum Type {
        UNDEFINED = 0;
        REGISTER = 1;
        REGISTERED = 2;
        INIT = 3;
        READY = 4;
        TRANSACTION = 5;
        COMPLETED = 6;
        ERROR = 7;
        GET_STATE = 8;
        PUT_STATE = 9;
        DEL_STATE = 10;
        INVOKE_CHAINCODE = 11;
        RESPONSE = 13;
        GET_STATE_BY_RANGE = 14;
        GET_QUERY_RESULT = 15;
        QUERY_STATE_NEXT = 16;
        QUERY_STATE_CLOSE = 17;
        KEEPALIVE = 18;
        GET_HISTORY_FOR_KEY = 19;
    }

    Type type = 1;
    google.protobuf.Timestamp timestamp = 2;
    bytes payload = 3;
    string txid = 4;
    SignedProposal proposal = 5;
    ChaincodeEvent chaincode_event = 6;
}

链码容器的shim层则是节点与链码交互的中间层。当链码的代码逻辑需要读写账本时，链码会通过shim层发送相应操作类型的ChaincodeMessage给节点，节点本地操作账本后返回响应消息。

客户端收到足够的背书节点的支持后，便可以将这笔交易发送给排序节点（orderer）进行排序，并最终写入区块链。

来源：我是码农，转载请保留出处和链接！

本文链接：http://www.54manong.com/?id=896

• 5.1　Hash算法与数字摘要2018-09-30 10:23
• 3.5　贸易管理2018-09-30 10:51
• 银行应用软件：零售银行业务中谁才是赢家2018-09-04 23:10
• 5.4　密钥衍生函数2018-09-15 15:15