Fabric-sdk-go操作Chaincode

合集 - 区块链(36)

1.Gossip in Hyperledger Fabric2023-10-092.Ubuntu18.04安装Fabric2019-11-08

3.Fabric-sdk-go操作Chaincode2020-06-14

4.[比特币]比特币中的密码学原理2020-08-285.一文读懂区块链（二）2020-07-166.一文读懂区块链（一）2020-07-167.chaincode中使用第三方库2020-06-278.[比特币]比特币中的匿名性2020-08-289.[比特币]比特币引发的思考2020-08-2810.[比特币]比特币中的分叉2020-08-2811.[比特币]比特币中的挖矿难度2020-08-2812.[比特币]比特币中的网络2020-08-2813.[比特币]比特币的实现2020-08-2814.[比特币]比特币中的共识协议2020-08-2815.[比特币]比特币中的数据结构2020-08-2816.Merkle Tree 简介2023-09-2717.Fabric 2.x 智能合约开发记录2023-09-1018.Fabric区块链浏览器（3）2023-08-3019.基于密码学的身份混淆系统 -- idmix2023-08-2320.Fabric区块链浏览器（2）2023-08-2221.Fabric区块链浏览器（1）2023-08-1522.Hyperledger Fabric系统链码介绍2023-06-0823.跟着文档学Fabric：获取通道配置2022-11-1924.从源码中解析fabric区块数据结构（一）2022-10-2625.Fabric升级示例2021-05-1126.Fabric网络升级（四）2021-04-2627.Fabric网络升级（三）2021-04-2628.Fabric网络升级（二）2021-04-2629.Fabric网络升级（一）2021-04-2630.Fabric网络升级（总）2021-04-2631.根据TxID获取上链数据2020-12-0932.PoW、PoS、DPoS和PBFT简介2023-11-0133.RPC连接btcd网络2024-07-0334.BTC交易流程2024-07-0335.MerkleTree in BTC2024-07-0436.BTC 地址2024-07-23

收起

因为工作的需要，最近了解了下如何通过sdk来操作Chaincode，本文是sdk使用时的一些操作总结。

在fabric网络启动过程中，一般分为“启动网络 -> 创建通道 -> 加入通道 -> 安装链码 -> 实例化链码 -> 调用链码”。本文以fabric-sdk-go项目中的end_to_end.go为例，介绍如何通过fabric-sdk-go来使用链码。

创建sdk实例

使用sdk的第一步是创建sdk实例：

sdk, err := fabsdk.New(configOpt, sdkOpts...)
if err != nil {
	t.Fatalf("Failed to create new SDK: %s", err)
}
defer sdk.Close()

创建通道并安装链码

在end_to_end.go中，这一步是通过createChannelAndCC()来实现的。

首先是使用提供的身份凭证来创建事务用于之后的操作：

clientContext := sdk.Context(fabsdk.WithUser(orgAdmin), fabsdk.WithOrg(ordererOrgName))

接着使用上一步创建的事务来创建一个资源管理客户端（resmgmt.Client）：

resMgmtClient, err := resmgmt.New(clientContext)

接着createChannel()创建通道。在创建通道时，需要使用该组织的管理员用户创建，主要用到GetSigningIdentity()和SaveChannel()方法：

func createChannel(t *testing.T, sdk *fabsdk.FabricSDK, resMgmtClient *resmgmt.Client) {
	mspClient, err := mspclient.New(sdk.Context(), mspclient.WithOrg(orgName))
	if err != nil {
		t.Fatal(err)
	}
	adminIdentity, err := mspClient.GetSigningIdentity(orgAdmin)
	if err != nil {
		t.Fatal(err)
	}
	req := resmgmt.SaveChannelRequest{ChannelID: channelID,
		ChannelConfigPath: integration.GetChannelConfigTxPath(channelID + ".tx"),
		SigningIdentities: []msp.SigningIdentity{adminIdentity}}
	txID, err := resMgmtClient.SaveChannel(req, resmgmt.WithRetry(retry.DefaultResMgmtOpts), resmgmt.WithOrdererEndpoint("orderer.example.com"))
	require.Nil(t, err, "error should be nil")
	require.NotEmpty(t, txID, "transaction ID should be populated")
}

加入通道

通道创建成功后，需要将将组织添加到通道中，主要用到JoinChannel()：

adminContext := sdk.Context(fabsdk.WithUser(orgAdmin), fabsdk.WithOrg(orgName))
 
// Org resource management client
orgResMgmt, err := resmgmt.New(adminContext)
......
 
	// Org peers join channel
err = orgResMgmt.JoinChannel(channelID, resmgmt.WithRetry(retry.DefaultResMgmtOpts), resmgmt.WithOrdererEndpoint("orderer.example.com")) 
......

创建链码

完成上述的操作，接下来就是链码相关的操作了。

与命令行下的链码操作不同，sdk安装链码时并不需要事先将链码程序放到背书节点，而是在调用InstallCCRequest()时再将本地的链码打包安装到背书节点：

func createCC(t *testing.T, orgResMgmt *resmgmt.Client) {
    // Packing the example cc from local
    // argv[0]: cc path in local
    // argv[1]: GOPATH
	ccPkg, err := packager.NewCCPackage("github.com/example_cc", integration.GetDeployPath())
	......
	// Install example cc to org peers
	installCCReq := resmgmt.InstallCCRequest{Name: ccID, Path: "github.com/example_cc", Version: "0", Package: ccPkg}
	_, err = orgResMgmt.InstallCC(installCCReq, resmgmt.WithRetry(retry.DefaultResMgmtOpts))
	......
	// Set up chaincode policy
	ccPolicy := cauthdsl.SignedByAnyMember([]string{"Org1MSP"})
	// Org resource manager will instantiate 'example_cc' on channel
	resp, err := orgResMgmt.InstantiateCC(
		channelID,
		resmgmt.InstantiateCCRequest{Name: ccID, Path: "github.com/example_cc", Version: "0", Args: integration.ExampleCCInitArgs(), Policy: ccPolicy},
		resmgmt.WithRetry(retry.DefaultResMgmtOpts),
	)
	......
}

链码调用

链码调用，这里推荐使用Execute()：

func executeCC(t *testing.T, client *channel.Client) {
	_, err := client.Execute(channel.Request{ChaincodeID: ccID, Fcn: "invoke", Args: integration.ExampleCCDefaultTxArgs()},
		channel.WithRetry(retry.DefaultChannelOpts))
	if err != nil {
		t.Fatalf("Failed to move funds: %s", err)
	}
}

示例

这个例子是使用sdk操作fabric-samples中的fabcar链码，其中省略了创建和加入通道的操作。

执行go run main.go后，输出结果如下：

本作品采用署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)进行许可。