Fabric:使用GoLand+Fabric-SDK-Go操作Fabric网络

遇到bug, 未完待续!!!

写在最前

前序博客已经介绍了使用命令的方式在Fabric上创建通道以及部署执行链码的方法，但这个过程太繁琐，尤其是当Fabric网络中peer节点和组织Org过多时，需要频繁的更改环境变量。
Hyperledger Fabric官方提供了Fabric-sdk-go(也有针对其他语言的sdk)使开发人员能够与Fabric网络进行交互，并且可基于此构建区块链技术的应用程序。本篇博客主要介绍Fabric-sdk-go的简单使用。

基本环境

本机操作系统为MAC系统，和Fabric运行在虚拟机中。Fabric的具体运行环境为：
操作系统：Ubuntu 16.04
版本：Hyperledger Fabric: V2.5.4

1 GoLand连接虚拟机

要使用ssh方式连虚拟机之前，需要在两个系统上安装ssh服务。无论是在MAC上安装ssh，还是在Ubuntu系统上安装ssh，网络上资料都很多，这里不在赘述。

1.1 在MAC上使用ssh连接虚拟机

为了保证后续能顺利使用Goland连接虚拟机，这里先在MAC上使用ssh连接虚拟机。首先要保证本机系统上和虚拟机上的Ubuntu系统上的ssh服务都是开启状态。接着本机系统的终端上尝试连接虚拟机，具体指令如下：

ssh sherry@172.16.8.129

其中@前的部分为Ubuntu系统的用户名。@后面的ip地址可以在Ubuntu系统上通过ifconfig命令进行查询，具体如下：
在这里插入图片描述
上述命令运行成功之后，将可以在MAC的终端上操作Ubuntu系统。具体如下：

1.2 GoLand连接Fabric网络

1.2.1 启动Fabric网络

Fabric-sdk-go不能创建Fabric网络，所以Fabric网络的创建过程仍然在Ubuntu系统中来创建。为了简便，使用fabric-samples提供的测试网络test-network，其创建如下。

sudo ./network.sh up
docker ps -a

其结果如下：
在这里插入图片描述

1.2.2 Goland连接Fabric网络

使用Goland连接Fabric网络需要完成以下几件事情：

Goland连接虚拟机。
在Goland中，打开Tools->Deployment->configuration进入Deployment界面，这里要新建一个SFTP部署。具体如下：
connecton

其中ssh configuration的配置界面如下：
在Goland中配置Fabric网络文件映射目录。
这里的Deployment path即为Ubuntu系统上Fabric网络的相对路径地址(根路径为/home/sherry)。而local path即为Deployment path中的文件在本地系统上的映射地址。
接着启动ssh连接。具体如下：

之后便可以在Goland中操作Ubuntu系统了。具体如下：
接着为了能在GoLand中修改链码及编写代码。先将Fabric网络中的文件映射到本地系统上。具体如下：

Tips:在文件同步时可能会出错，可以先在Ubuntu系统上更改Fabric网络文件的权限，再重新进行同步。

2 使用Fabri-SDK-GO操作网络

2.1 准备工作

在Ubuntu系统上搭建finance网络。具体搭建过程可以参考博客：https://blog.csdn.net/yeshang_lady/article/details/134113296
修改Goland的ssh部署。将finance网络所在的Ubuntu目录映射到GoLand的Fabric_GOPATH目录上，并将finance网络的所有文件下载到Fabric_GOPATH目录上。
准备链码文件。在Fabric_GOPATH上创建usersChaincode/chaincode目录来保存链码文件asset-transfer.go。asset-transfer.go文件参考博客：https://blog.csdn.net/yeshang_lady/article/details/134801201
配置相关包。在Fabric_GOPATH/userChaincode/下执行如下代码(在GoLand->Terminal->local中执行)：

go mod init
vim go.mod #这里要修改go.mod文件，将go语言版本修改为1.21
go get github.com/hyperledger/fabric-contract-api-go/contractapi
go get github.com/hyperledger/fabric-sdk-go
GO111MODULE=on go mod vendor

为了保证Fabric-sdk-go的顺利执行，进入如下vendor/github.com/hyperledger目录，git命令下载fabric-sdk-go源文件。具体如下：

git clone https://github.com/hyperledger/fabric-sdk-go.git

在这里插入图片描述
如果不进行这一步操作，后续使用fabric-sdk-go创建客户端的时候会可能会遇到如下错误：
..\vendor\github.com\hyperledger\fabric-sdk-go\internal\github.com\hyperledger\fabric\discovery\client\api.go:47:38: undefined: discovery.ChaincodeCall

在Fabric_GOPATH\usersChaincode下创建sdkInit目录并创建start.go文件。后续所有与Fabric-SDK-GO操作相关的代码都存放在该文件中。
在Fabric_GOPATH\usersChaincode下闯将main.go文件作为主函数所在的文件。

2.2 实例化Fabri SDK

在实例化Fabric SDK之前，需要在Fabric_GOPATH/usersChaincode下生成config.yaml文件。finance网络对应的config.yaml文件如下(Fabric-sdk-go中给了一些样例文件可以参考)：

# Copyright SecureKey Technologies Inc. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
version: 1.0.0
client:organization: org1 #此应用程序的所有者logging:level: infocryptoconfig:path: ${GOPATH}/src/Fabric_GOPATH/organizationscredentialStore:path: "/tmp/state-store"cryptoStore:path: /tmp/mspBCCSP:security:enabled: truedefault:provider: "SW"hashAlgorithm: "SHA2"softVerify: truelevel: 256tlsCerts:systemCertPool: trueclient:key:path: ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org1.finance.com/users/Admin@org1.finance.com/tls/client.keycert:path: ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org1.finance.com/users/Admin@org1.finance.com/tls/client.crtchannels:channel1:peers:peer0.org1.finance.com:endorsingPeer: truechaincodeQuery: trueledgerQuery: trueeventSource: truepeer1.org1.finance.com:endorsingPeer: truechaincodeQuery: trueledgerQuery: trueeventSource: truepeer0.org2.finance.com:endorsingPeer: truechaincodeQuery: trueledgerQuery: trueeventSource: truepolicies:queryChannelConfig:minResponses: 1maxTargets: 1retryOpts:attempts: 5initialBackoff: 500msmaxBackoff: 5sbackoffFactor: 2.0selection:SortingStrategy: BlockHeightPriorityBalancer: RoundRobinBlockHeightLagThreshold: 5eventService:resolverStrategy: MinBlockHeightbalancer: RoundRobinblockHeightLagThreshold: 4reconnectBlockHeightLagThreshold: 8peerMonitorPeriod: 6s
organizations:org1:mspid: Org1MSPcryptoPath:  ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org1.finance.com/users/Admin@org1.finance.com/msppeers:- peer0.org1.finance.com- peer1.org1.finance.comcertificateAuthorities:- ca.org1.finance.comorg2:mspid: Org2MSPcryptoPath:  ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org2.finance.com/users/Admin@org2.finance.com/msppeers:- peer0.org2.finance.comcertificateAuthorities:- ca.org2.finance.com
orderers:orderer.finance.com:url: orderer.finance.com:7050grpcOptions:ssl-target-name-override: orderer.finance.comkeep-alive-time: 0skeep-alive-timeout: 20skeep-alive-permit: falsefail-fast: falseallow-insecure: falsetlsCACerts:path: ${GOPATH}/src/Fabric_GOPATH/organizations/ordererOrganizations/finance.com/tlsca/tlsca.finance.com-cert.pem
peers:-defaults:grpcOptions:keep-alive-time: 0skeep-alive-timeout: 20skeep-alive-permit: falsefail-fast: falseallow-insecure: falsepeer0.org1.finance.com:url: peer0.org1.finance.com:7051grpcOptions:ssl-target-name-override: peer0.org1.finance.comtlsCACerts:path: ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org1.finance.com/tlsca/tlsca.org1.finance.com-cert.pempeer1.org1.finance.com:url: peer1.org1.finance.com:8051grpcOptions:ssl-target-name-override: peer1.org1.finance.comtlsCACerts:path: ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org1.finance.com/tlsca/tlsca.org1.finance.com-cert.pempeer0.org2.finance.com:url: peer0.org2.finance.com:9051grpcOptions:ssl-target-name-override: peer0.org2.finance.comtlsCACerts:path: ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org2.finance.com/tlsca/tlsca.org2.finance.com-cert.pemcertificateAuthorities:ca.org1.finance.com:url: https://ca.org1.finance.com:7054grpcOptions:ssl-target-name-override: ca.org1.finance.comtlsCACerts:path: ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org1.finance.com/tlsca/tlsca.org1.finance.com-cert.pemclient:key:path: ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org1.finance.com/users/Admin@org1.finance.com/tls/client.keycert:path: ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org1.finance.com/users/Admin@org1.finance.com/tls/client.crtregistrar:enrollId: adminenrollSecret: adminpwcaName: ca.org1.finance.comca.org2.finance.com:url: https://ca.org2.finance.com:9054grpcOptions:ssl-target-name-override: ca.org2.finance.comtlsCACerts:path: ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org2.finance.com/tlsca/tlsca.org2.finance.com-cert.pemclient:key:path: ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org2.finance.com/users/Admin@org2.finance.com/tls/client.keycert:path: ${GOPATH}/src/Fabric_GOPATH/organizations/peerOrganizations/org2.finance.com/users/Admin@org2.finance.com/tls/client.crtregistrar:enrollId: adminenrollSecret: adminpwcaName: ca.org2.finance.com

在start.go文件中添加如下代码：

/*代码的import部分会自己生成，这里为了节省空间就不在展示了*/
package sdkInit
func SetupSDK(configFile string, initialized bool) (*fabsdk.FabricSDK, error) {if initialized {return nil, fmt.Errorf("Fabric SDK已经实例化")}sdk, err := fabsdk.New(config.FromFile(configFile))if err != nil {return nil, fmt.Errorf("实例化Fabric SDK失败: %v", err)}fmt.Println("Fabric SDK初始化成功")return sdk, nil
}

在main.go中添加如下代码，具体如下:

const (configFile  = "config.yaml"initialized = false
)
func main() {sdk, err := sdkInit.SetupSDK(configFile, initialized)if err != nil {fmt.Println(err.Error())return}defer sdk.Close() //
}