簡介

chaincode即用戶鏈碼，它提供了基于區塊鏈分布式賬本的狀態處理邏輯。
fabric中，chaincode默認運行在docker容器中。
peer通過調用docker api來創建和啟動chaincode容器。
chaincode容器啟動后跟peer之間創建gRPC連接，雙方通過發送ChaincodeMessage來進行交互通信。
chaincode容器利用core.chaincode.shim包提供的接口來向Peer發起請求。

chaincode典型結構

用戶只需關注Init()和Invoke()函數的實現，在其中利用shim.ChaincodeStubInterface結構實現跟賬本的交互邏輯。

package main

import (
    "errors"
    "fmt"
    "github.com/hyperledger/fabric/core/chaincode/shim"
)

type DemoChaincode struct { }

func (t *DemoChaincode) Init(stub shim.ChaincodeStubInterface) pb.Response {
    // more logics using stub here
    return stub.Success(nil)
}

func (t *DemoChaincode) Invoke(stub shim.ChaincodeStubInterface) pb.Response
    // more logics using stub here
    return stub.Success(nil)
}

func main() {
    err := shim.Start(new(DemoChaincode))
    if err != nil {
        fmt.Printf("Error starting DemoChaincode: %s", err)
    }
}

啟動過程

chaincode首先是個普通的golang程序，其main方法調用了shim層的Start方法。
首先會進行初始化，包括讀取默認配置，創建到Peer的gRPC連接。
主要包括NewChaincodeSupportClient和chaincodeSupportClient.Register兩個方法。
初始化完成后，創建有限狀態機結構（FSM，github.com/looplab/fsm）。
FSM會根據收到的消息和當前狀態來觸發狀態轉移，并執行提前設置的操作。
Peer側也利用了類似的FSM結構來管理消息響應。
之后，利用創建好的gRPC連接開始向Peer發送第一個gRPC消息：ChaincodeMessage_REGISTER，將自身注冊到Peer上。
注冊成功后開始消息處理循環，等待接收來自Peer的消息以及自身的狀態轉移(nextState)消息。

后續過程中，chaincode和Peer利用FSM完成一系列對消息的響應運作：
1、Peer收到來自鏈碼容器的ChaincodeMessage_REGISTER消息，將其注冊到本地的一個Handler結構，返回ChaincodeMessage_REGISTERD消息發給鏈碼容器。
之后更新狀態為established（已建立），并發送ChaincodeMessage_READY消息給鏈碼側，更新狀態為ready。
2、鏈碼側收到ChaincodeMessage_REGISTERD消息后，不進行任何操作，注冊成功，更新狀態為established(已建立）。
收到ChaincodeMessage_READY消息后更新狀態為ready。
3、Peer側發出ChaincodeMessage_INIT消息給鏈碼容器，準備觸發鏈碼側初始化操作。
4、鏈碼容器收到ChaincodeMessage_INIT消息，通過Handler.handleInit()方法進行初始化。
主要包括初始化所需的ChaincodeStub結構，以及調用鏈碼代碼中Init()方法。初始化成功后，返回ChaincodeMessage_COMPLETED消息給Peer。
此時鏈碼容器進入可被調用（Invoke)狀態。
5、鏈碼被調用時，Peer發出ChaincodeMessage_TRANSACTION消息給鏈碼。
6、鏈碼收到ChaincodeMessage_TRANSACTION消息，會調用Invoke()方法。
根據Invoke方法中用戶實現的邏輯，可以發出包括ChaincodeMessage_GET_HISTORY_FOR_KEY、ChaincodeMessage_GET_QUERY_RESULT、
ChaincodeMessage_GET_STATE、ChaincodeMessage_GET_STATE_BY_RANGE、ChaincodeMessage_QUERY_STATE_CLOSE、
ChaincodeMessage_QUERY_STATE_NEXT、ChaincodeMessage_INVOKE_CHAINCODE等消息給Peer側。
Peer側收到這些消息，進行相應處理，并回復ChaincodeMessage_RESPONSE消息。
最后鏈碼側會回復調用完成的消息ChaincodeMessage_COMPLETE給Peer側。
在上述過程中，Peer和鏈碼還會不定期發送ChaincodeMessage_KEEPALIVE消息給對方，以確保在線。

相關文檔

https://github.com/yeasy/hyperledger_code_fabric/blob/master/process/chaincode_start.md