目录
1.fabric-sdk-go的介绍
Fabric SDK Go是用于与Hyperledger Fabric网络进行交互的Go语言软件开发工具包(SDK)。它提供了一组功能强大的API和工具,使开发人员能够构建基于Fabric的应用程序、执行交易、查询状态、管理身份等。以下是一些Fabric SDK Go的关键特性:
1)身份管理
Fabric SDK Go提供了身份管理功能,允许开发人员管理和使用与Fabric网络相关的身份。它支持使用X.509证书、密钥和其他身份凭证来进行身份验证,并提供了用于创建和管理身份的API。
2)通道和链码交互
使用Fabric SDK Go,开发人员可以创建和管理与Fabric网络中的通道和链码的交互。它提供了通道客户端(Channel Client)和链码客户端(Chaincode Client)的API,使开发人员能够执行交易、查询状态、注册链码事件等操作。
3)交易执行和背书
Fabric SDK Go允许开发人员构建并执行交易。它提供了一组API,用于构建交易提案、指定背书节点、执行交易,并获取交易结果。开发人员可以灵活地选择背书节点,并使用事务命名空间来隔离不同的交易。
4)事件监听
开发人员可以使用Fabric SDK Go监听Fabric网络中的交易事件。它提供了注册链码事件的API,使开发人员能够定义回调函数来处理特定链码的事件。这样,应用程序可以实时接收和处理与链码相关的事件通知。
5)错误处理和调试
Fabric SDK Go提供了丰富的错误处理和调试功能,以帮助开发人员诊断和解决问题。它提供了错误代码和详细错误信息,以及用于输出调试日志的选项。
6)配置和连接管理
Fabric SDK Go允许开发人员配置和管理与Fabric网络的连接。它提供了灵活的配置选项,包括节点、通道、链码的定义和连接参数。
7)加密和安全性
Fabric SDK Go支持使用加密算法和安全通信协议与Fabric网络进行通信。它使用TLS(Transport Layer Security)协议来确保与网络节点之间的安全通信,并提供对数据的加密和解密功能。
8)插件和扩展性
Fabric SDK Go具有可扩展的插件架构,允许开发人员根据需要添加自定义功能。它提供了一组扩展点和接口,以便开发人员可以实现自定义的身份验证、交易处理、事件处理等功能。
2.confi.yaml配置文件
config.yaml是Fabric SDK Go中用于配置连接到Fabric网络的配置文件。它定义了节点、通道、链码和身份等相关信息,以及连接选项和加密设置。以下是config.yaml文件的一些常见配置项:
1)client
organization:指定客户端所属的组织。
credentialStore:指定用于存储用户身份凭证的位置。
2)channels
mychannel:定义一个通道,包括通道的名称、链码事件监听器、背书策略等配置。
3)organizations
Org1:定义组织Org1的相关信息,如名称、MSP(成员服务提供者)等。
4)orderers
oederer.example.com:定义排序服务节点的相关信息,如名称、GRPCURL等。
5)peers
peer0.org1.example.com:定义组织Org1中的对等节点的相关信息,如名称、GRPCURL等。
6)certificateAuthorities
ca.example.com:定义证书颁发机构(CA)的相关信息,如名称、URL等。
7)entityMatchers
peer:定义用于匹配对等节点的实体匹配器。
8)tlsCerts
path:指定TLS证书的路径。
3.使用go mod管理项目依赖
fabric go sdk目前本身使用go modules管理依赖
go mod init初始化好项目的go.mod文件。
编写代码,完成后运行go mod run,会自动下载依赖的项目,但版本可能与 fabric go sdk中的依赖版本不同,编译存在问题。
把go.mod中的内容复制到项目的go.mod中,然后保存,go mod会自动合并相同的依赖, 运行go mod tidy,会自动添加新的依赖或删除不需要的依赖。
4.准备工作
安装Go语言环境:确保你的计算机上已经安装了Go语言环境。你可以从Go官方网站(Go 编程语言)下载相应版本
设置GOPATH:在你的计算机上设置GOPATH环境变量,用于存放Go项目和依赖包的路径。
1.win+R输入cmd
2.go env
5.创建fabric-sdk-go入口实例
import (
"github.com/hyperledger/fabric-sdk-go/pkg/fabsdk"
)
sdk, err := fabsdk.New(configProvider) // 使用configProvider创建SDK实例
if err != nil {
// 处理错误
}
defer sdk.Close() // 在使用完SDK后关闭
6.创建客户端
import (
"github.com/hyperledger/fabric-sdk-go/pkg/client/channel"
)
clientContext := sdk.ChannelContext(channelID, fabsdk.WithUser("user1")) // 使用指定用户创建客户端上下文
channelClient, err := channel.New(clientContext) // 创建通道客户端
if err != nil {
// 处理错误
}
7.将peer节点加入通道
import (
"github.com/hyperledger/fabric-sdk-go/pkg/client/channel"
)
err = channelClient.JoinChannel(channel.WithRetry(retry.DefaultChannelOpts), channel.WithOrdererEndpoint(ordererEndpoint)) // 将peer节点加入通道
if err != nil {
// 处理错误
}
8.安装链码
import (
"github.com/hyperledger/fabric-sdk-go/pkg/client/channel"
)
installRequest := channel.InstallProposalRequest{
ChaincodeID: chaincodeID,
ChaincodePath: chaincodePath,
ChaincodeVersion: chaincodeVersion,
}
_, err = channelClient.InstallChaincode(installRequest) // 安装链码
if err != nil {
// 处理错误
}
9.实例化链码
import (
"github.com/hyperledger/fabric-sdk-go/pkg/client/channel"
)
instantiateRequest := channel.InstantiateProposalRequest{
ChaincodeID: chaincodeID,
Fcn: "init",
Args: [][]byte{[]byte("arg1"), []byte("arg2")},
}
_, err = channelClient.InstantiateChaincode(instantiateRequest) // 实例化链码
if err != nil {
// 处理错误
}
10.升级链码
import (
"github.com/hyperledger/fabric-sdk-go/pkg/client/channel"
)
upgradeRequest := channel.UpgradeProposalRequest{
ChaincodeID: chaincodeID,
Fcn: "upgrade",
Args: [][]byte{[]byte("arg1"), []byte("arg2")},
}
_, err = channelClient.UpgradeChaincode(upgradeRequest) // 升级链码
if err != nil {
// 处理错误
}
11.调用链码
import (
"github.com/hyperledger/fabric-sdk-go/pkg/client/channel"
)
request := channel.Request{
ChaincodeID: chaincodeID,
Fcn: "myFunction",
Args: [][]byte{[]byte("arg1"), []byte("arg2")},
}
response, err := channelClient.Execute(request) // 调用链码
if err != nil {
// 处理错误
}
12.查询链码
import (
"github.com/hyperledger/fabric-sdk-go/pkg/client/channel"
)
queryRequest := channel.Request{
ChaincodeID: chaincodeID,
Fcn: "query",
Args: [][]byte{[]byte("arg1")},
}
response, err := channelClient.Query(queryRequest) // 查询链码
if err != nil {
// 处理错误
}
13.代码示例
package main
import (
"fmt"
"github.com/hyperledger/fabric-sdk-go/pkg/client/channel"
"github.com/hyperledger/fabric-sdk-go/pkg/core/config"
"github.com/hyperledger/fabric-sdk-go/pkg/fabsdk"
)
const (
channelID = "mychannel"
chaincodeID = "mychaincode"
chaincodePath = "github.com/chaincode/path"
chaincodeVersion = "1.0"
ordererEndpoint = "orderer.example.com"
)
func main() {
// 创建Fabric SDK实例
sdk, err := fabsdk.New(config.FromFile("config.yaml"))
if err != nil {
fmt.Printf("Failed to create SDK: %s\n", err)
return
}
defer sdk.Close()
// 创建通道客户端
clientContext := sdk.ChannelContext(channelID, fabsdk.WithUser("user1"))
channelClient, err := channel.New(clientContext)
if err != nil {
fmt.Printf("Failed to create channel client: %s\n", err)
return
}
// 将peer节点加入通道
err = channelClient.JoinChannel(channel.WithRetry(retry.DefaultChannelOpts), channel.WithOrdererEndpoint(ordererEndpoint))
if err != nil {
fmt.Printf("Failed to join channel: %s\n", err)
return
}
// 安装链码
installRequest := channel.InstallProposalRequest{
ChaincodeID: chaincodeID,
ChaincodePath: chaincodePath,
ChaincodeVersion: chaincodeVersion,
}
_, err = channelClient.InstallChaincode(installRequest)
if err != nil {
fmt.Printf("Failed to install chaincode: %s\n", err)
return
}
// 实例化链码
instantiateRequest := channel.InstantiateProposalRequest{
ChaincodeID: chaincodeID,
Fcn: "init",
Args: [][]byte{[]byte("arg1"), []byte("arg2")},
}
_, err = channelClient.InstantiateChaincode(instantiateRequest)
if err != nil {
fmt.Printf("Failed to instantiate chaincode: %s\n", err)
return
}
// 调用链码
request := channel.Request{
ChaincodeID: chaincodeID,
Fcn: "myFunction",
Args: [][]byte{[]byte("arg1"), []byte("arg2")},
}
response, err := channelClient.Execute(request)
if err != nil {
fmt.Printf("Failed to execute chaincode: %s\n", err)
return
}
fmt.Printf("Chaincode response: %s\n", string(response.Payload))
// 查询链码
queryRequest := channel.Request{
ChaincodeID: chaincodeID,
Fcn: "query",
Args: [][]byte{[]byte("arg1")},
}
response, err = channelClient.Query(queryRequest)
if err != nil {
fmt.Printf("Failed to query chaincode: %s\n", err)
return
}
fmt.Printf("Chaincode query response: %s\n", string(response.Payload))
}