Hyperledger Fabric 使用 CouchDB 和複雜智慧合約開發

丿風色幻想發表於2023-04-15

前言

在上個實驗中，我們已經實現了簡單智慧合約實現及客戶端開發，但該實驗中智慧合約只有基礎的增刪改查功能，且其中的資料管理功能與傳統 MySQL 比相差甚遠。本文將在前面實驗的基礎上，將 Hyperledger Fabric 的預設資料庫支援 LevelDB 改為 CouchDB 模式，以實現更復雜的資料檢索功能。此外，對上個實驗的簡單智慧合約進一步進行功能上和設計上的擴充套件，最終實現了智慧合約的分包、分頁查詢、多欄位富查詢、查詢交易歷史記錄等功能。

網路架構

本文網路結構直接將 Hyperledger Fabric無排序組織以Raft協議啟動多個Orderer服務、TLS組織執行維護Orderer服務中建立的 4-2_RunOrdererByCouncil 複製為 7_CouchDBAndComplexContract 並修改（建議直接將本案例倉庫 FabricLearn 下的 7_CouchDBAndComplexContract 目錄複製到本地執行），文中大部分命令在 Hyperledger Fabric定製聯盟鏈網路工程實踐中已有介紹因此不會詳細說明，預設情況下，所有操作皆在 7_CouchDBAndComplexContract 根目錄下執行。修改成功後網路共包含四個組織—— council 、 soft 、 web 、 hard ，其中 council 組織為網路提供 TLS-CA 服務，並且執行維護著三個 orderer 服務；其餘每個組織都執行維護著一個 peer 節點、一個 couchDB 服務、一個 admin 使用者和一個 user 使用者，實驗最終網路結構如下：

項	執行埠	說明
`council.ifantasy.net`	7050	council 組織的 CA 服務，為聯盟鏈網路提供 TLS-CA 服務
`orderer1.council.ifantasy.net`	7051	council 組織的 orderer1 服務
`orderer1.council.ifantasy.net`	7052	council 組織的 orderer1 服務的 admin 服務
`orderer2.council.ifantasy.net`	7054	council 組織的 orderer2 服務
`orderer2.council.ifantasy.net`	7055	council 組織的 orderer2 服務的 admin 服務
`orderer3.council.ifantasy.net`	7057	council 組織的 orderer3 服務
`orderer3.council.ifantasy.net`	7058	council 組織的 orderer3 服務的 admin 服務
`soft.ifantasy.net`	7250	soft 組織的 CA 服務，包含成員： peer1 、 admin1 、user1
`peer1.soft.ifantasy.net`	7251	soft 組織的 peer1 成員節點
`couchdb.soft.ifantasy.net`	7255	soft 組織的 couchdb 成員節點
`web.ifantasy.net`	7350	web 組織的 CA 服務，包含成員： peer1 、 admin1 、user1
`peer1.web.ifantasy.net`	7351	web 組織的 peer1 成員節點
`couchdb.web.ifantasy.net`	7355	web 組織的 couchdb 成員節點
`hard.ifantasy.net`	7450	hard 組織的 CA 服務，包含成員： peer1 、 admin1 、user1
`peer1.hard.ifantasy.net`	7451	hard 組織的 peer1 成員節點
`couchdb.hard.ifantasy.net`	7455	hard 組織的 couchdb 成員節點

新增CouchDB支援並啟動網路

新增CouchDB支援

首先，在 envpeer1soft 、 envpeer1soft 、 envpeer1soft 中新增 CouchDB 版本變數：

export COUCHDB_VERSION=3.2

然後，向 compose/docker-base.yaml 檔案新增基礎 CouchDB 映象：

couchdb-base:
    image: couchdb:${COUCHDB_VERSION}
    environment:
      - COUCHDB_USER=admin
      - COUCHDB_PASSWORD=adminpw
    networks:
      - ${DOCKER_NETWORKS}

之後，向 compose/docker-compose.yaml 中的每個組織新增 CouchDB 容器：

couchdb.soft.ifantasy.net:
    container_name: couchdb.soft.ifantasy.net
    extends:
      file: docker-base.yaml
      service: couchdb-base
    ports:
      - 7255:5984

couchdb.web.ifantasy.net:
    container_name: couchdb.web.ifantasy.net
    extends:
      file: docker-base.yaml
      service: couchdb-base
    ports:
      - 7355:5984

couchdb.hard.ifantasy.net:
    container_name: couchdb.hard.ifantasy.net
    extends:
      file: docker-base.yaml
      service: couchdb-base
    ports:
      - 7455:5984

最後，修改 compose/docker-compose.yaml 中每個 peer 容器的儲存方式（以 peer1.soft.ifantasy.net 為例）：

  peer1.soft.ifantasy.net:
    container_name: peer1.soft.ifantasy.net
    extends:
      file: docker-base.yaml
      service: peer-base
    environment:
      - CORE_PEER_ID=peer1.soft.ifantasy.net
      - CORE_PEER_LISTENADDRESS=0.0.0.0:7251
      - CORE_PEER_ADDRESS=peer1.soft.ifantasy.net:7251
      - CORE_PEER_LOCALMSPID=softMSP
      - CORE_PEER_GOSSIP_EXTERNALENDPOINT=peer1.soft.ifantasy.net:7251
      - CORE_LEDGER_STATE_STATEDATABASE=CouchDB
      - CORE_LEDGER_STATE_COUCHDBCONFIG_COUCHDBADDRESS=couchdb.soft.ifantasy.net:5984   # 必須為容器內埠
      - CORE_LEDGER_STATE_COUCHDBCONFIG_USERNAME=admin
      - CORE_LEDGER_STATE_COUCHDBCONFIG_PASSWORD=adminpw
    volumes:
      - ${LOCAL_CA_PATH}/soft.ifantasy.net/registers/peer1:${DOCKER_CA_PATH}/peer
    ports:
      - 7251:7251
    depends_on:
      - couchdb.soft.ifantasy.net

注意，引數 CORE_LEDGER_STATE_COUCHDBCONFIG_COUCHDBADDRESS 後的服務埠必須為 couchdb 容器的內部埠，原因不得而知，完整程式碼見 FabricLearn 下的 7_CouchDBAndComplexContract/compose 目錄。

啟動實驗網路

在上述修改完成後，在 7_CouchDBAndComplexContract 目錄下按順序執行以下命令啟動基礎實驗網路：

設定DNS（如果未設定）： ./setDNS.sh
設定環境變數： source envpeer1soft
啟動CA網路： ./0_Restart.sh
註冊使用者： ./1_RegisterUser.sh
獲取使用者證照： ./2_EnrollUser.sh
配置通道： ./3_Configtxgen.sh

網路啟動成功後可見包含 couchdb 容器：

初始 docker 網路

合約開發

本節所用智慧合約由前一篇文章 Hyperledger Fabric 智慧合約開發及 fabric-sdk-go/fabric-gateway 使用示例改進(拆分)而來，在上篇文章的基礎上對合約進行分包分檔案處理，使專案具有更好的目錄結構。在實驗根目錄 7_CouchDBAndComplexContract 下建立目錄 project_contract 作為智慧合約根目錄，在 project_contract 下執行以下命令初始化 GO 模組：

go mod init github.com/wefantasy/FabricLearn/7_CouchDBAndComplexContract/project_contract

tools 層

tools 層主要用於編寫智慧合約通用工具，建立 tools/contract.go 工具類，主要包含以下函式：

ConstructResultByIterator : 根據 fabric 查詢結果 shim.StateQueryIteratorInterface 生成對應切片。

// 根據查詢結果生成切片
func ConstructResultByIterator[T interface{}](resultsIterator shim.StateQueryIteratorInterface) ([]*T, error) {
    var txs []*T
    for resultsIterator.HasNext() {
        queryResult, err := resultsIterator.Next()
        if err != nil {
            return nil, err
        }
        var tx T
        err = json.Unmarshal(queryResult.Value, &tx)
        if err != nil {
            return nil, err
        }
        txs = append(txs, &tx)
    }
    fmt.Println("select result length: ", len(txs))
    return txs, nil
}

SelectByQueryString : 根據 couchdb 查詢字串完成查詢操作，並返回對應切片。

// 根據查詢字串查詢
func SelectByQueryString[T interface{}](ctx contractapi.TransactionContextInterface, queryString string) ([]*T, error) {
    resultsIterator, err := ctx.GetStub().GetQueryResult(queryString)
    if err != nil {
        return nil, err
    }
    defer resultsIterator.Close()

    return ConstructResultByIterator[T](resultsIterator)
}

SelectByQueryStringWithPagination : 根據 couchdb 查詢字串分頁查詢，並返回對應切片。

// 根據擦查詢字串分頁查詢
func SelectByQueryStringWithPagination[T interface{}](ctx contractapi.TransactionContextInterface, queryString string, pageSize int32, bookmark string) (*model.PaginatedQueryResult[T], error) {
    resultsIterator, responseMetadata, err := ctx.GetStub().GetQueryResultWithPagination(queryString, pageSize, bookmark)
    if err != nil {
        return nil, err
    }
    defer resultsIterator.Close()
    var txs []T
    for resultsIterator.HasNext() {
        queryResult, err := resultsIterator.Next()
        if err != nil {
            return nil, err
        }
        var tx T
        err = json.Unmarshal(queryResult.Value, &tx)
        if err != nil {
            return nil, err
        }
        txs = append(txs, tx)
    }
    return &model.PaginatedQueryResult[T]{
        Records:             txs,
        FetchedRecordsCount: responseMetadata.FetchedRecordsCount,
        Bookmark:            responseMetadata.Bookmark,
    }, nil
}

SelectHistoryByIndex : 獲得交易建立之後的所有變化（區塊鏈賬本）。

// 獲得交易建立之後的所有變化.
func SelectHistoryByIndex[T interface{}](ctx contractapi.TransactionContextInterface, index string) ([]model.HistoryQueryResult[T], error) {
    resultsIterator, err := ctx.GetStub().GetHistoryForKey(index)
    if err != nil {
        return nil, err
    }
    defer resultsIterator.Close()

    var records []model.HistoryQueryResult[T]
    for resultsIterator.HasNext() {
        response, err := resultsIterator.Next()
        if err != nil {
            return nil, err
        }

        var tx T
        if len(response.Value) > 0 {
            err = json.Unmarshal(response.Value, &tx)
            if err != nil {
                return nil, err
            }
        }
        record := model.HistoryQueryResult[T]{
            TxId:      response.TxId,
            Record:    tx,
            IsDelete:  response.IsDelete,
        }
        records = append(records, record)
    }
    return records, nil
}

model 層

model層主要用於申明合約所用資料結構，其中 model/project.go 內容如下：

package model

type Project struct {
Table        string `json:"table" form:"table"` //  資料庫標記
ID           string `json:"ID"`                 // 專案唯一ID
Name         string `json:"Name"`               // 專案名稱
Username     string `json:"username"`           // 專案主要負責人
Organization string `json:"Organization"`       // 專案所屬組織
Category     string `json:"Category"`           // 專案所屬類別
Url          string `json:"Url"`                // 專案介紹地址
Describes    string `json:"Describes"`          // 專案描述
}

func (o *Project) Index() string {
o.Table = "project"
return o.ID
}

func (o *Project) IndexKey() string {
return "table~ID~name"
}

func (o *Project) IndexAttr() []string {
return []string{o.Table, o.ID, o.Name}
}

其中 Index 函式用於標識模型的唯一主鍵； IndexKey 函式用於標識自建索引的欄位，其中命名方式必須與欄位申明的結構體標記 json 一致（大小寫）；IndexAttr 用於構造具體的索引。model/user.go 申明瞭使用者的欄位資訊：

package model

// User  使用者表
type User struct {
Table    string `json:"table" form:"table"`       //  資料庫標記
Username string `json:"username" form:"username"` //使用者賬戶
Name     string `json:"name" form:"name"`         //真實姓名
Email    string `json:"email" form:"email"`       //  郵箱
Phone    string `json:"phone" form:"phone"`       //  手機
}

func (o *User) Index() string {
o.Table = "user"
return o.Username
}

func (o *User) IndexKey() string {
return "table~username~name"
}

func (o *User) IndexAttr() []string {
return []string{o.Table, o.Username, o.Name}
}

model/base.go 申明瞭基於 CouchDB 的富查詢結果模型：

package model

import "time"

// 歷史查詢結果
type HistoryQueryResult[T interface{}] struct {
Record    T         `json:"record"`
TxId      string    `json:"txId"`
Timestamp time.Time `json:"timestamp"`
IsDelete  bool      `json:"isDelete"`
}

// 分頁查詢結果
type PaginatedQueryResult[T interface{}] struct {
Records             []T    `json:"records"`
FetchedRecordsCount int32  `json:"fetchedRecordsCount"`
Bookmark            string `json:"bookmark"`
}

contract 層

contract 層用於實現智慧合約的核心邏輯（本示例為 model 的增刪改查），由於結合了 CouchDB ，所以相比上個實驗需要更復雜的實現。以 contract/project.go 為例進行介紹，由於程式碼太長在此就不再貼上（完整程式碼參考 project.go），其中主要功能及實現方式如下：

插入資料（ Insert ）：先使用 ctx.GetStub().PutState(tx.Index(), txb) 方法插入資料，然後呼叫ctx.GetStub().CreateCompositeKey(tx.IndexKey(), tx.IndexAttr()) 方法為該資料建立 CouchDB 索引，最後呼叫 ctx.GetStub().PutState(indexKey, value) 將索引存入鏈上。
更新資料（ Update ）：先使用 indexKey, err := ctx.GetStub().CreateCompositeKey(otx.IndexKey(), otx.IndexAttr()) 得到舊資料的索引，再呼叫 ctx.GetStub().DelState(indexKey) 刪除舊資料的索引，然後呼叫 ctx.GetStub().PutState(tx.Index(), txb) 更新資料，最後分別呼叫 ctx.GetStub().CreateCompositeKey(tx.IndexKey(), tx.IndexAttr()) 和 ctx.GetStub().PutState(indexKey, value) 建立新資料索引並存入鏈上。
刪除資料（ Delete ）：先使用 ctx.GetStub().DelState(anstx.Index()) 刪除舊資料，再呼叫 indexKey, err := ctx.GetStub().CreateCompositeKey(tx.IndexKey(), tx.IndexAttr()) 得到舊資料索引，最後透過 ctx.GetStub().DelState(indexKey) 刪除舊資料索引。
讀取指定index的記錄（ SelectByIndex ）：使用形如 {"selector":{"ID":"%s", "table":"project"}} 的 CouchDB 查詢語法根據索引查詢資料。
讀取所有資料（ SelectAll ）：使用形如 {"selector":{"table":"project"}} 的 CouchDB 查詢語法查詢所有相關資料。
按某索引查詢所有資料（ SelectBySome ）：使用形如 {"selector":{"%s":"%s", "table":"project"}} 的 CouchDB 查詢語法根據索引查詢資料。
富分頁查詢所有資料（ SelectAllWithPagination ）：使用形如 {"selector":{"table":"project"}} 的 CouchDB 查詢語法呼叫上述分頁查詢資料工具 tools.SelectByQueryStringWithPagination 來查詢資料。
按關鍵字富分頁查詢所有資料 SelectBySomeWithPagination ）：使用形如 {"selector":{"%s":"%s","table":"project"}} 的 CouchDB 查詢語法呼叫上述分頁查詢資料工具 tools.SelectByQueryStringWithPagination 來查詢資料。
按某索引查詢資料歷史（ SelectHistoryByIndex ）：呼叫上述歷史資料查詢工具 tools.SelectHistoryByIndex 來查詢資料。

contract/user.go 為 model/user.go 的核心操作邏輯，此示例只包含簡單的功能，完整原始碼參考 user.go。

main 主函式

主函式完整程式碼如下所示：

package main

import (
        "github.com/hyperledger/fabric-contract-api-go/contractapi"
        "github.com/wefantasy/FabricLearn/7_CouchDBAndComplexContract/project_contract/contract"
)

func main() {
        chaincode, err := contractapi.NewChaincode(&contract.UserContract{}, &contract.ProjectContract{})
        if err != nil {
                panic(err)
        }

        if err := chaincode.Start(); err != nil {
                panic(err)
        }
}

多智慧合約只需在 main 的 contractapi.NewChaincode 函式中按順序申明即可。在智慧合約編寫完畢後使用 go mod vendor 來打包依賴，上述工作完成後 project_contract 目錄結構及解釋如下所示：

project_contract
├── contract            // 智慧合約核心邏輯
│   ├── project.go
│   └── user.go
├── go.mod
├── go.sum
├── main.go             // 智慧合約入口函式
├── model               // 申明資料模型
│   ├── base.go         // 申明分頁等資料結構
│   ├── project.go
│   └── user.go
├── tools               // 工具目錄
│   └── contract.go     // 智慧合約通用工具，查詢歷史/分頁查詢等
└── vendor              // 依賴目錄

合約部署和測試

如無特殊說明，以下命令預設執行於實驗根目錄 7_CouchDBAndComplexContract 下：

合約打包

source envpeer1soft
peer lifecycle chaincode package basic.tar.gz --path project_contract --label basic_1

三組織安裝

 source envpeer1soft
 peer lifecycle chaincode install basic.tar.gz
 peer lifecycle chaincode queryinstalled
 source envpeer1web
 peer lifecycle chaincode install basic.tar.gz
 peer lifecycle chaincode queryinstalled
 source envpeer1hard
 peer lifecycle chaincode install basic.tar.gz
 peer lifecycle chaincode queryinstalled

三組織批准

export CHAINCODE_ID=basic_1:22e38a78d2ddfe9c3cbeff91140ee209c901adcc24cd2b11f863a53abcdc825a
source envpeer1soft
peer lifecycle chaincode approveformyorg -o orderer1.council.ifantasy.net:7051 --tls --cafile $ORDERER_CA  --channelID testchannel --name basic --version 1.0 --sequence 1 --waitForEvent --package-id $CHAINCODE_ID
peer lifecycle chaincode queryapproved -C testchannel -n basic --sequence 1
source envpeer1web
peer lifecycle chaincode approveformyorg -o orderer3.council.ifantasy.net:7057 --tls --cafile $ORDERER_CA  --channelID testchannel --name basic --version 1.0 --sequence 1 --waitForEvent --package-id $CHAINCODE_ID
peer lifecycle chaincode queryapproved -C testchannel -n basic --sequence 1
source envpeer1hard
peer lifecycle chaincode approveformyorg -o orderer2.council.ifantasy.net:7054 --tls --cafile $ORDERER_CA  --channelID testchannel --name basic --version 1.0 --sequence 1 --waitForEvent --package-id $CHAINCODE_ID
peer lifecycle chaincode queryapproved -C testchannel -n basic --sequence 1

注意：由於我們有兩個智慧合約，且每個智慧合約都包含 InitLedger 函式來初始化資料，所以在這裡以及後續鏈碼操作中需要刪除 --init-required 引數（因為合約不需要初始化）。

提交鏈碼

source envpeer1soft
peer lifecycle chaincode commit -o orderer2.council.ifantasy.net:7054 --tls --cafile $ORDERER_CA --channelID testchannel --name basic --version 1.0 --sequence 1 --peerAddresses peer1.soft.ifantasy.net:7251 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE --peerAddresses peer1.web.ifantasy.net:7351 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE

初始化鏈碼資料並測試

source envpeer1soft
peer chaincode invoke -o orderer1.council.ifantasy.net:7051 --tls --cafile $ORDERER_CA --channelID testchannel --name basic --peerAddresses peer1.soft.ifantasy.net:7251 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE --peerAddresses peer1.web.ifantasy.net:7351 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE -c '{"Args":["UserContract:InitLedger"]}'
peer chaincode invoke -o orderer1.council.ifantasy.net:7051 --tls --cafile $ORDERER_CA --channelID testchannel --name basic --peerAddresses peer1.soft.ifantasy.net:7251 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE --peerAddresses peer1.web.ifantasy.net:7351 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE -c '{"Args":["ProjectContract:InitLedger"]}'

peer chaincode invoke -o orderer1.council.ifantasy.net:7051 --tls --cafile $ORDERER_CA --channelID testchannel --name basic --peerAddresses peer1.soft.ifantasy.net:7251 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE --peerAddresses peer1.web.ifantasy.net:7351 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE -c '{"Args":["UserContract:GetAllUsers"]}'
peer chaincode invoke -o orderer1.council.ifantasy.net:7051 --tls --cafile $ORDERER_CA --channelID testchannel --name basic --peerAddresses peer1.soft.ifantasy.net:7251 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE --peerAddresses peer1.web.ifantasy.net:7351 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE -c '{"Args":["ProjectContract:SelectAll"]}'
peer chaincode invoke -o orderer1.council.ifantasy.net:7051 --tls --cafile $ORDERER_CA --channelID testchannel --name basic --peerAddresses peer1.soft.ifantasy.net:7251 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE --peerAddresses peer1.web.ifantasy.net:7351 --tlsRootCertFiles $CORE_PEER_TLS_ROOTCERT_FILE -c '{"Args":["ProjectContract:SelectBySome", "name", "工作室聯盟鏈管理系統"]}'

注意，在多合約的情況下呼叫鏈碼，需要在所呼叫的合約函式前指定所屬合約，如 ProjectContract:SelectBySome ,其它合約示例呼叫方式大致一樣，在此不再贅述。此外由於 CouchDB 自帶了資料庫管理介面，則可以透過本例中任意一個 CouchDB 的服務地址來訪問鏈上資料，如 http://192.168.27.72:7355/_utils/#login （虛擬機器IP為 192.168.27.72 ，soft 組織的 CouchDB 埠 7355），輸入docker中配置的賬戶admin密碼adminpw即可進入系統：
登陸介面
合約資料
至此，本實驗基本完成。

可能存在的問題

peer lifecycle chaincode install 時遇到錯誤：

Error creating tx-manage chaincode: Error compiling schema for DataContract [SelectBySomeWithPagination]. Return schema invalid. Object has no key 'PaginatedQueryResult[github.com'
panic: Error creating tx-manage chaincode: Error compiling schema for DataContract [SelectBySomeWithPagination]. Return schema invalid. Object has no key 'PaginatedQueryResult[github.com'

goroutine 1 [running]:
log.Panicf({0xa24b02?, 0x1?}, {0xc00014ff50?, 0x407679?, 0x404c71?})
        /usr/local/go/src/log/log.go:392 +0x67
main.main()
        /chaincode/input/src/main.go:201 +0x8e

原因及解決方法：所用 docker fabric 2.4 映象的 Golang 版本太低不支援泛型，需要刪除並重新安裝 docker fabric 2.4 （儘管 tag 一樣，但映象內容會更新）。

智慧合約呼叫時遇到錯誤：

[notice] 2022-11-13T12:13:49.502557Z nonode@nohost <0.286.0> -------- rexi_server : started servers
[notice] 2022-11-13T12:13:49.504490Z nonode@nohost <0.290.0> -------- rexi_buffer : started servers
[warning] 2022-11-13T12:13:49.530610Z nonode@nohost <0.298.0> -------- creating missing database: _nodes
[info] 2022-11-13T12:13:49.530670Z nonode@nohost <0.299.0> -------- open_result error {not_found,no_db_file} for _nodes
[error] 2022-11-13T12:13:49.537681Z nonode@nohost <0.304.0> -------- CRASH REPORT Process  (<0.304.0>) with 2 neighbors crashed with reason: no match of right hand value {error,enospc} at couch_bt_engine:init/2(line:154) <= 
……

原因及解決方法：可能是 docker volume 把硬碟佔滿了，使用 docker volume rm $(docker volume ls -qf dangling=true) 清除所有再重試
使用

遇到錯誤：

# github.com/hyperledger/fabric-sdk-go/internal/github.com/hyperledger/fabric/discovery/client
/root/go/pkg/mod/github.com/hyperledger/fabric-sdk-go@v1.0.0/internal/github.com/hyperledger/fabric/discovery/client/api.go:47:38: undefined: discovery.ChaincodeCall
/root/go/pkg/mod/github.com/hyperledger/fabric-sdk-go@v1.0.0/internal/github.com/hyperledger/fabric/discovery/client/client.go:83:63: undefined: discovery.ChaincodeInterest
/root/go/pkg/mod/github.com/hyperledger/fabric-sdk-go@v1.0.0/internal/github.com/hyperledger/fabric/discovery/client/client.go:120:65: undefined: discovery.ChaincodeCall
/root/go/pkg/mod/github.com/hyperledger/fabric-sdk-go@v1.0.0/internal/github.com/hyperledger/fabric/discovery/client/client.go:124:23: undefined: discovery.ChaincodeInterest
/root/go/pkg/mod/github.com/hyperledger/fabric-sdk-go@v1.0.0/internal/github.com/hyperledger/fabric/discovery/client/client.go:229:105: undefined: discovery.ChaincodeCall
/root/go/pkg/mod/github.com/hyperledger/fabric-sdk-go@v1.0.0/internal/github.com/hyperledger/fabric/discovery/client/client.go:247:64: undefined: discovery.ChaincodeCall
/root/go/pkg/mod/github.com/hyperledger/fabric-sdk-go@v1.0.0/internal/github.com/hyperledger/fabric/discovery/client/client.go:604:48: undefined: discovery.ChaincodeInterest
/root/go/pkg/mod/github.com/hyperledger/fabric-sdk-go@v1.0.0/internal/github.com/hyperledger/fabric/discovery/client/client.go:620:35: undefined: discovery.ChaincodeCall

原因及解決方法： github.com/hyperledger/fabric-sdk-go 需要指定 20220117 版本，將 go.mod 檔案對應依賴替換如下：

github.com/hyperledger/fabric-sdk-go v1.0.1-0.20220117114400-c848d119936b。

遇到錯誤：

Error compiling schema for ****[**]. Return schema invalid. Object has no key 'Wrapper[[]<part of module name>'

原因及解決方法：智慧合約返回值不支援泛型，將智慧合約返回值換成 interface{} 即可。

查詢歷史記錄出現遇到錯誤：

Error: could not assemble transaction: ProposalResponsePayloads do not match (base64):

原因及解決方法：鏈碼輸出（返回）資料中不要使用地址傳遞（推薦值傳遞），因為地址都是動態分配，每次取到的值都不一樣，造成共識失敗。

遇到錯誤：

Failed to evaluate: Multiple errors occurred: - Transaction processing for endorser [localhost:7451]: Chaincode status Code: (500) UNKNOWN. Description: Error handling success response. Value did not match schema:\n1. return: Invalid type. Expected: array, given: string - Transaction processing for endorser [localhost:7251]: Chaincode status Code: (500) UNKNOWN. Description: Error handling success response. Value did not match schema:\n1. return: Invalid type. Expected: array, given: string

原因及解決方法：鏈碼返回值不能為 []byte ，這是一個 fabric 的 bug，對於複雜返回型別建議直接返回字串 string

Hyperledger Fabric 智慧合約開發及 fabric-sdk-go/fabric-gateway 使用示例
2022-06-11
GoGateway
2.06 hyperledger fabric智慧合約
2018-12-10
Hyperledger Fabric Node.js 智慧合約鏈碼開發
2018-12-30
Node.js
Hyperledger Fabric Node.js 智慧合約即鏈碼開發
2018-12-30
Node.js
Hyperledger Fabric 2.x 自定義智慧合約
2022-02-16
Hyperledger Fabric 2.x 動態更新智慧合約
2022-07-12
Hyperledger Fabric 中智慧合約的基本元件概述
2022-12-02
元件
區塊鏈Hyperledger Fabric 2.x 自定義智慧合約
2022-07-12
區塊鏈
在HyperLedger Fabric中啟用CouchDB作為State Database
2017-07-01
Database
Fabric 2.x 智慧合約開發記錄
2023-09-10
區塊鏈100講：Hyperledger Fabric 中的鏈碼（智慧合約）
2018-12-01
區塊鏈
Hyperledger Fabric（Hyperledger Fabric模型）
2018-08-29
模型
Hyperledger Fabric開發（二）：建立網路
2018-03-01
區塊鏈開發Hyperledger Fabric入門
2018-10-06
區塊鏈
智慧合約開發神器-Remix
2017-11-29
REM
HyperLedger Fabric ChainCode開發——shim.ChaincodeStubInterface用法
2017-08-14
AI
SET智慧合約量化系統開發|秒合約量化開發搭建
2023-05-09
FDF智慧合約DAPP複利系統技術開發
2023-03-15
APP
Hyperledger Fabric 核心概念
2022-07-12
智慧合約Dapp專案如何開發構建？智慧合約開發原始碼示例
2023-04-04
APP原始碼
智慧合約系統開發原理介紹丨智慧合約開發原始碼詳情
2024-03-15
原始碼
Dapp 合約代幣系統開發智慧合約
2023-04-07
APP
智慧合約開發環境搭建及Hello World合約
2018-05-15
開發環境
以太坊智慧合約開發：讓合約接受轉賬
2017-12-10
HyperLedger/Fabric SDK使用Docker容器映象快
2021-09-09
Docker
ChainDesk :從 0 到 1-Hyperledger Fabric 開發精要（一）
2019-02-18
AI
Hyperledger fabric-SDK-GO客戶端開發篇（六）
2020-12-27
Go客戶端
區塊鏈智慧合約開發
2024-03-14
區塊鏈
雜湊競猜遊戲系統技術開發丨雜湊遊戲Solidity智慧合約
2023-03-29
遊戲Solid
使用 Cursor 和 Devbox 快速開發基於 Rust 的 WASM 智慧合約
2024-10-22
devRustASM
【Hyperledger Fabric】Fabric 2.2 手動安裝
2023-09-26
Hyperledger Fabric和FISCO BCOS技術對比
2020-10-27
Hyperledger Fabric on SAP Cloud Platform
2018-09-27
CloudPlatform
中移鏈合約常用開發介紹（三）工程化開發智慧合約
2023-04-21
搭建智慧合約開發環境Remix IDE及使用
2018-06-21
開發環境REMIDE
ptahDAO智慧合約模式系統開發
2023-03-16
模式
DApp智慧合約系統開發
2024-03-14
APP
馬蹄鏈合約互助迴圈複利模式開發流程丨智慧合約dapp系統開發程式設計示例
2023-03-09
模式APP程式設計