fabric go sdk是什么
fabric go sdk是什么
小编给大家分享一下fabric go sdk是什么，相信大部分人都还不怎么了解，因此分享这篇文章给大家参考一下，希望大家阅读完这篇文章后大有收获，下面让我们一起去了解一下吧！
fabric go sdk是Hyperledger Fabric官方提供的Go语言开发包，应用程序可以利用fabric go sdk与fabric网络进行交互并访问链码。本教程介绍如何使用fabric go sdk实现链码的安装、实例化、交易提交 和状态查询等操作。
本文把与Hyperledger fabric网络交互的baas、应用程序、客户端统称成为客户端，它们可以使用fabric go sdk和fabric区块链网络进行交互，fabric go sdk调用grpc可以与指定的peer和orderer进行通信，本文的目的是在BYFN搭建的fabric网络的基础之上，展示如何使用fabric go sdk操作链码：
1、fabric go sdk简介
fabric go sdk是Fabric官方的Go语言SDK，它的目录结构如下：
有2个目录需要注意一下，internal和third_party，它们两个包含了fabric go sdk依赖的一些代码，来自于fabric、fabric-ca，当使用到fabric的一些类型时，应当使用以下的方式，而不是直接导入fabric或者fabric-ca：
import"github.com/hyperledger/fabricgosdk/third_party/github.com/hyperledger/fabric/xxx"
pkg目录是fabric go sdk的主要实现，doc文档介绍了不同目录所提供的功能，以及给出了接口调用样例：
pkg/fabsdk：主package，主要用来生成fabsdk以及fabric go sdk中其他pkg使用的option context。
pkg/client/channel：主要用来调用、查询Fabric链码，或者注册链码事件。
pkg/client/resmgmt：主要用来Hyperledger fabric网络的管理，比如创建通道、加入通道，安装、实例化和升级链码。
pkg/client/event:配合channel模块来进行Fabric链码事件的注册和过滤。
pkg/client/ledger：主要用来实现Fabric账本的查询，查询区块、交易、配置等。
pkg/client/msp：主要用来管理fabric网络中的成员关系。
3、使用fabric go sdk的一般步骤
为client编写配置文件config.yaml
为client创建fabric sdk实例fabsdk
为client创建resource manage client，简称RC，RC用来进行管理操作的client， 比如通道的创建，链码的安装、实例化和升级等
为client创建channel client，简称CC，CC用来链码的调用、查询以及链码事件 的注册和取消注册
4、fabric go sdk配置文件config.yaml概述
client使用sdk与fabric网络交互，需要告诉sdk两类信息：
我是谁：即当前client的信息，包含所属组织、密钥和证书文件的路径等， 这是每个client专用的信息。
对方是谁：即fabric网络结构的信息，channel、org、orderer和peer等 的怎么组合起当前fabric网络的，这些结构信息应当与configytx.yaml中是一致的。这是通用配置，每个客户端都可以拿来使用。另外，这部分信息并不需要是完整fabric网络信息，如果当前client只和部分节点交互，那配置文件中只需要包含所使用到的网络信息。
5、使用go mod管理fabric go sdk项目的依赖
fabric go sdk目前本身使用go modules管理依赖，从go.mod可知，依赖的一些包指定了具体的版本， 如果你的项目依赖的版本和fabric go sdk依赖的版本不同，会产生编译问题。
因此建议项目也使用go moudles管理依赖，然后相同的软件包可以使用相同的版本，可以这样操作：
go mod init初始化好项目的go.mod文件。
编写代码，完成后运行go mod run，会自动下载依赖的项目，但版本可能与 fabric go sdk中的依赖版本不同，编译存在问题。
把go.mod中的内容复制到项目的go.mod中，然后保存，go mod会自动合并相同的依赖， 运行go mod tidy，会自动添加新的依赖或删除不需要的依赖。
6、创建fabric go sdk的入口实例
通过config.FromFile解析配置文件，然后通过fabsdk.New创建fabric go sdk的入口实例。
import"github.com/hyperledger/fabricgosdk/pkg/core/config"import"github.com/hyperledger/fabricgosdk/pkg/fabsdk"sdk,err:=fabsdk.New(config.FromFile(c.ConfigPath))iferr!=nil{log.Panicf("failedtocreatefabricsdk:%s",err)}
7、创建fabric go sdk的资源管理客户端
管理员账号才能进行Hyperledger fabric网络的管理操作，所以创建资源管理客户端一定要使用管理员账号。
通过fabsdk.WithOrg("Org1")和fabsdk.WithUser("Admin")指定Org1的Admin账户，使用sdk.Context创建clientProvider，然后通过resmgmt.New创建fabric go sdk资源管理客户端。
import"github.com/hyperledger/fabricgosdk/pkg/client/resmgmt"rcp:=sdk.Context(fabsdk.WithUser("Admin"),fabsdk.WithOrg("Org1"))rc,err:=resmgmt.New(rcp)iferr!=nil{log.Panicf("failedtocreateresourceclient:%s",err)}
8、创建fabric go sdk的通道客户端
使用用户账号创建fabric go sdk的通道客户端，以便进行fabric链码的调用和查询。使用sdk.ChannelContext创建channelProvider，需要指定channelID和用户User1，然后通过channel.New创建通道客户端，这个通道客户端就是调用channelID对应channel上链码的channel client。
import"github.com/hyperledger/fabricgosdk/pkg/client/channel"ccp:=sdk.ChannelContext(ChannelID,fabsdk.WithUser("User1"))cc,err:=channel.New(ccp)iferr!=nil{log.Panicf("failedtocreatechannelclient:%s",err)}
9、使用fabric go sdk的资源管理客户端安装链码
安装Fabric链码使用资源管理客户端的InstallCC接口，需要指定resmgmt.InstallCCRequest以及在哪些peers上面安装。resmgmt.InstallCCRequest指明了链码ID、链码路径、链码版本以及打包后的链码。
打包链码需要使用到链码路径CCPath和GoPath，GoPath即本机的$GOPATH，CCPath是相对于GoPath的相对路径，如果路径设置不对，会造成sdk找不到链码。
//packthechaincodeccPkg,err:=gopackager.NewCCPackage("github.com/hyperledger/fabric-samples/chaincode/chaincode_example02/go/","/Users/shitaibin/go")iferr!=nil{returnerrors.WithMessage(err,"packchaincodeerror")}//newrequestofinstallingchaincodereq:=resmgmt.InstallCCRequest{Name:c.CCID,Path:c.CCPath,Version:v,Package:ccPkg,}reqPeers:=resmgmt.WithTargetEndpoints("peer0.org1.example.com")resps,err:=rc.InstallCC(req,reqPeers)iferr!=nil{returnerrors.WithMessage(err,"installCCerror")}
10、使用fabric go sdk的资源管理客户端实例化链码
实例化链码需要使用fabric go sdk的资源管理客户端的InstantiateCC接口，需要通过ChannelID、 resmgmt.InstantiateCCRequest和peers，指明在哪个channel上实例化链码，请求包含了链码的ID、路径、版本，以及初始化参数和背书策略，背书策略可以通过cauthdsl.FromString生成。
//endorserpolicyorg1OrOrg2:="OR('Org1MSP.member','Org2MSP.member')"ccPolicy,err:=cauthdsl.FromString(org1OrOrg2)iferr!=nil{returnerrors.WithMessage(err,"genpolicyfromstringerror")}//newrequestargs:=packArgs([]string{"init","a","100","b","200"})req:=resmgmt.InstantiateCCRequest{Name:c.CCID,Path:c.CCPath,Version:v,Args:args,Policy:ccPolicy,}//sendrequestandhandleresponsereqPeers:=resmgmt.WithTargetEndpoints("peer0.org1.example.com")resp,err:=rc.InstantiateCC(ChannelID,req,reqPeers)iferr!=nil{returnerrors.WithMessage(err,"instantiatechaincodeerror")}
11、使用fabric go sdk的资源管理客户端升级链码
再fabric go sdk中，升级链码和实例化链码是非常相似的，不同点只在请求是resmgmt.UpgradeCCRequest，调用的接口是rc.UpgradeCC：
//endorserpolicyorg1AndOrg2:="AND('Org1MSP.member','Org2MSP.member')"ccPolicy,err:=c.genPolicy(org1AndOrg2)iferr!=nil{returnerrors.WithMessage(err,"genpolicyfromstringerror")}//newrequestargs:=packArgs([]string{"init","a","100","b","200"})req:=resmgmt.UpgradeCCRequest{Name:c.CCID,Path:c.CCPath,Version:v,Args:args,Policy:ccPolicy,}//sendrequestandhandleresponsereqPeers:=resmgmt.WithTargetEndpoints("peer0.org1.example.com")resp,err:=rc.UpgradeCC(ChannelID,req,reqPeers)iferr!=nil{returnerrors.WithMessage(err,"instantiatechaincodeerror")}
12、使用fabric go sdk的通道客户端调用链码
在fabric go sdk中，使用通道客户端的Execute接口调用链码，使用入参channel.Request和peers指明要让哪些peer上执行链码，进行背书。channel.Request指明了要调用的链码，以及链码内要Invoke的函数args，args是序列化的结果，序列化是自定义的，只要链码能够按相同的规则进行反序列化即可。
//newchannelrequestforinvokeargs:=packArgs([]string{"a","b","10"})req:=channel.Request{ChaincodeID:c.CCID,Fcn:"invoke",Args:args,}//sendrequestandhandleresponse//peersisneededreqPeers:=channel.WithTargetEndpoints("peer0.org1.example.com")resp,err:=cc.Execute(req,reqPeers)iferr!=nil{returnerrors.WithMessage(err,"invokechaincodeerror")}log.Printf("invokechaincodetx:%s",resp.TransactionID)
13、使用fabric go sdk的通道客户端查询链码
在fabric go sdk中，查询和调用链码是非常相似的，使用相同的channel.Request，指明了Invoke链码中的query函数，然后调用cc.Query进行查询操作，这样节点不会对请求进行背书：
//newchannelrequestforqueryreq:=channel.Request{ChaincodeID:c.CCID,Fcn:"query",Args:packArgs([]string{keys}),}//sendrequestandhandleresponsereqPeers:=channel.WithTargetEndpoints(peer)resp,err:=cc.Query(req,reqPeers)iferr!=nil{returnerrors.WithMessage(err,"querychaincodeerror")}log.Printf("querychaincodetx:%s",resp.TransactionID)log.Printf("result:%v",string(resp.Payload))
以上是“fabric go sdk是什么”这篇文章的所有内容，感谢各位的阅读！相信大家都有了一定的了解，希望分享的内容对大家有所帮助，如果还想学习更多知识，欢迎关注恰卡编程网行业资讯频道！
