长安链智能合约的开发、编译、安装、调用、查询(二)

作者&＃xff1a;明神特烦恼
公众号&＃xff1a;明神特烦恼

智能合约是区块链与业务关联度最大的部分&＃xff0c;合约的友好性、安全性、执行效率也是优秀的智能合约引擎的重要指标&＃xff0c;长安链的支持多种语言的智能合约&＃xff0c;包括go、rust、solidity、c&＃43;&＃43;等。本节使用go语言开发智能合约&＃xff0c;使用tinygo进行合约编译、使用go sdk 安装、调用、查询智能合约。

官方参考文档&＃xff1a; https://docs.chainmaker.org.cn/dev/%E6%99%BA%E8%83%BD%E5%90%88%E7%BA%A6.html

1&＃xff09;合约模板

    学习智能合约的开发&＃xff0c;通常需要有Demo来学习API的使用方式&＃xff0c;项目组织方式。在长安链学习过程中也是如此&＃xff0c;所以第一步获取合约模块。
1.1&＃xff09;拉取镜像&＃xff1a;docker pull chainmakerofficial/chainmaker-go-contract:1.1.1
长安链为我们提供合约开发的镜像&＃xff0c;内部包含合约模板。

1.2&＃xff09;启动并进入容器&＃xff1a; docker run -it --name chainmaker-go-contract -v ${PWD}:/home chainmakerofficial/chainmaker-go-contract:1.1.1 bash
启动chainmaker-go-contract容器并进入&＃xff0c;同时将当前目录挂载到容器的 /home目录下

1.3) 解压并分析合约模板
cp /home
tar xzvf contract_go_template.tar.gz

• 目录结构&＃xff1a;
  其中业务逻辑在main.go中&＃xff0c;//export注释的方法被编译器识别&＃xff0c;用于外部访问。
  
• 合约逻辑
  save方法支持传入三个参数file_hash、file_name、time&＃xff0c;以file_hash为索引存入区块链世界状态。
  findByFileHash方法支持传入一个参数file_hash&＃xff0c;以file_hash为检索条件进行世界状态检索并返回。
• 合约逻辑可任意修改&＃xff0c;只要后续调用指定export的方法名即可

2&＃xff09;编译合约

按照官方参考文档方式 在chainmaker-go-contract容器中执行./build.sh
生成main.wasm文件

3&＃xff09;安装、调用、查询合约

1. 下载go sdk代码

git clone --recursive https://git.chainmaker.org.cn/chainmaker/chainmaker-sdk-go.git

2. 拷贝crypto-config文件

rm -rf chainmaker-sdk-go/testdata/crypto-config
cp -r chainmaker-go/build/crypto-config chainmaker-sdk-go/testdata/

3. 编写测试用例
   可基于sdk_user_contract_claim_test.go文件进行修改。
   1&＃xff09;创建文件hash_test.go


package chainmaker_sdk_goimport ("chainmaker.org/chainmaker-go/common/random/uuid""chainmaker.org/chainmaker-sdk-go/pb/protogo/common""fmt""github.com/stretchr/testify/require""testing""time"
)var (hashContractName &＃61; "myhash001"hashVersion &＃61; "1.0.0"hashByteCodePath &＃61; "./testdata/hash-cc/main.wasm"
)func TestUserContractHash(t *testing.T) {fmt.Println("&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61; create client &＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;")client, err :&＃61; createClientWithCertBytes()require.Nil(t, err)fmt.Println("&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61; create admin1 &＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;")admin1, err :&＃61; createAdmin(orgId1)require.Nil(t, err)fmt.Println("&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61; create admin2 &＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;")admin2, err :&＃61; createAdmin(orgId2)require.Nil(t, err)fmt.Println("&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61; create admin3 &＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;")admin3, err :&＃61; createAdmin(orgId3)require.Nil(t, err)fmt.Println("&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61; create admin4 &＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;")admin4, err :&＃61; createAdmin(orgId4)require.Nil(t, err)fmt.Println("&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61; 创建合约 &＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;")testUserContractHashCreate(t, client, admin1, admin2, admin3, admin4, true, true)fmt.Println("&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61; 调用合约 &＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;")fileHash, err :&＃61; testUserContractHashInvoke(client, "save", true)require.Nil(t, err)fmt.Println("&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61; 执行合约查询接口 &＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;")//txId :&＃61; "1cbdbe6106cc4132b464185ea8275d0a53c0261b7b1a470fb0c3f10bd4a57ba6"//fileHash &＃61; txId[len(txId)/2:]params :&＃61; map[string]string{"file_hash": fileHash,}testUserContractHashQuery(t, client, "find_by_file_hash", params)
}func testUserContractHashCreate(t *testing.T, client *ChainClient,admin1, admin2, admin3, admin4 *ChainClient, withSyncResult bool, isIgnoreSameContract bool) {resp, err :&＃61; createUserContract(client, admin1, admin2, admin3, admin4,hashContractName, hashVersion, hashByteCodePath, common.RuntimeType_GASM, []*common.KeyValuePair{}, withSyncResult)if !isIgnoreSameContract {require.Nil(t, err)}fmt.Printf("CREATE claim contract resp: %&＃43;v\n", resp)
}func testUserContractHashInvoke(client *ChainClient,method string, withSyncResult bool) (string, error) {//curTime :&＃61; fmt.Sprintf("%d", CurrentTimeMillisSeconds())curTime :&＃61; time.Now().Format("2006-01-02 15:04:05")fileHash :&＃61; uuid.GetUUID()params :&＃61; map[string]string{"time": "123","file_hash": fileHash,"file_name": fmt.Sprintf("file_%s", curTime),}err :&＃61; invokeUserContract(client, hashContractName, method, "", params, withSyncResult)//err :&＃61; invokeUserContractStepByStep(client, claimContractName, method, "", params, withSyncResult)if err !&＃61; nil {return "", err}return fileHash, nil
}func testUserContractHashQuery(t *testing.T, client *ChainClient,method string, params map[string]string) {resp, err :&＃61; client.QueryContract(hashContractName, method, params, -1)require.Nil(t, err)fmt.Printf("QUERY claim contract resp: %&＃43;v\n", resp)
}

2&＃xff09;执行TestUserContractHash Test方法

    这里使用的是默认配置文件&＃xff0c;如果需要改变端口、连接数、TLS使能等等&＃xff0c;需要修改chainmaker-sdk-go/testdata/sdk_config.yml