长安链使用Golang编写智能合约教程（一）

已于 2024-07-17 10:16:45 修改
阅读量1.8k 收藏 21
点赞数 29
分类专栏： 长安链 文章标签： 智能合约 区块链
于 2024-05-26 13:22:16 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/djklsajdklsajdlk/article/details/139212541
版权

长安链是分2.1.+和2.3.+两个版本，本节面说的是2.1.+的版本

需要2.3.+版本的合约，请看教程（二）！

教程（二）我会写如何查历史数据

教程二：（长安链2.3.+的版本的智能合约编写）

教程三：（常见GO SDK的解释与使用）

编写前的注意事项：

1、运行一条带有Doker_GoVM的链

2、建议直接用官方的在线IDE去写合约，因为写完可以直接测，缺点只是调试不方便。

3、自己拉环境在本地写合约，编译时注意编译环境，官方有提醒你去Linux下去编译。

本教程使用官方的在线IDE去写合约

教程是基于官方文档写的，只是会多写一些解析步骤

1、首先新建一个合约

2、打开main.go文件（这是新增工程的默认存证模板）

package main

import (
	"encoding/json"
	"log"
	"strconv"

	"chainmaker/pb/protogo"
	"chainmaker/shim"
)

//FactContract 合约对象
type FactContract struct {
}

//Fact 存证对象,存证合约的数据内容
type Fact struct {
	FileHash string 
	FileName string 
	Time     int
}

//NewFact 新建存证对象
func NewFact(fileHash, fileName string, time int) *Fact {
	return &Fact{
		FileHash: fileHash,
		FileName: fileName,
		Time:     time,
	}
}

//InitContract 合约初始化方法
func (f *FactContract) InitContract(stub shim.CMStubInterface) protogo.Response {
	return shim.Success([]byte("Init Success"))
}

// UpgradeContract 合约升级方法
func (f *FactContract) UpgradeContract(stub shim.CMStubInterface) protogo.Response {
	return shim.Success([]byte("Upgrade Success"))
}

//InvokeContract 调用合约
func (f *FactContract) InvokeContract(stub shim.CMStubInterface) protogo.Response {

	//获取调用合约哪个方法
	method := string(stub.GetArgs()["method"])

	// 这里必须写成 switch {case "a": ... [case "b": ...[...]] default:...} 形式
	// 而且case后面的内容必须是字符串,不能是常量
	// 这里必须写成 switch {case "a": ... [case "b": ...[...]] default:...} 形式
	// 而且case后面的内容必须是字符串,不能是常量
	// 这里必须写成 switch {case "a": ... [case "b": ...[...]] default:...} 形式
	// 而且case后面的内容必须是字符串,不能是常量

	// 如果 method == "save", 执行FactContract的save方法
	// 如果 method == "findByFileHash", 执行FactContract的findByFileHash方法
	// 如果没有对应的 case 语句，返回错误
	switch method {
	case "save":
		return f.Save(stub)
	case "findByFileHash":
		return f.FindByFileHash(stub)
	default:
		return shim.Error("invalid method")
	}
}

//save 存证，把数据存储到链上
func (f *FactContract) Save(stub shim.CMStubInterface) protogo.Response {
	// 获取调用合约的全部参数
	params := stub.GetArgs()

	// 获取指定的参数
	fileHash := string(params["file_hash"])
	fileName := string(params["file_name"])
	timeStr := string(params["time"])

	if fileHash == "" || fileName == "" || timeStr == "" {
		//返回合约执行错误，以及错误信息
		return shim.Error("fileHash and fileName and time must not empty")
	}

	time, err := strconv.Atoi(timeStr)
	if err != nil {
		msg := "time is [" + timeStr + "] not int"
		// 打印日志，使用 stub.Log 打印的日志会在控制台的输出中显示
		stub.Log(msg + err.Error())
		//返回合约执行错误，以及错误信息
		return shim.Error(msg)
	}

	fact := NewFact(fileHash, fileName, time)

	// 序列化
	factBytes, err := json.Marshal(fact)
	if err != nil {
		msg := "marshal data fail"
		stub.Log(msg + err.Error())
		return shim.Error(msg)
	}

	//向链上发送事件,发送的事件会在控制台的事件中显示
	stub.EmitEvent("topic_vx", []string{fact.FileHash, fact.FileName})

	key := getHashKey(fact.FileHash)

	//把数据存到链上
	err = stub.PutStateFromKeyByte(key, factBytes)
	if err != nil {
		msg := "fail to save fact"
		stub.Log(msg + err.Error())
		return shim.Error(msg)
	}

	//打印日志，使用 stub.Log 打印的日志会在控制台的输出中显示
	stub.Log("[save] file hash:" + fact.FileHash)
	stub.Log("[save] file name:" + fact.FileName)

	// 返回执行成功
	return shim.Success([]byte(fact.FileName + fact.FileHash))

}

//findByFileHash 根据文件哈希从链上查找数据
func (f *FactContract) FindByFileHash(stub shim.CMStubInterface) protogo.Response {
	// 获取调用合约的全部参数
	params := stub.GetArgs()

	// 获取指定参数
	fileHash := string(params["file_hash"])

	// 查询结果
	key := getHashKey(fileHash)
	result, err := stub.GetStateFromKeyByte(key)
	if err != nil {
		msg := "failed to call get_state"
		// 打印日志，使用 stub.Log 打印的日志会在控制台的输出中显示
		stub.Log(msg + err.Error())
		//返回合约执行错误，以及错误信息
		return shim.Error(msg)
	}

	// 反序列化
	var fact Fact
	err = json.Unmarshal(result, &fact)
	if err != nil {
		msg := "unmarshal data fail"
		stub.Log(msg + err.Error())
		return shim.Error(msg)
	}

	// 记录日志
	stub.Log("[find_by_file_hash] file hash:" + fact.FileHash)
	stub.Log("[find_by_file_hash] file name:" + fact.FileName)

	// 返回执行成功
	return shim.Success(result)

}

func getHashKey(hash string) string {
	return "fact_hash" + hash
}

func main() {

	//运行合约
	err := shim.Start(new(FactContract))
	if err != nil {
		log.Fatal(err)
	}
}

3、模板解析

17行：Fact结构体就是要存在区块链中的，根据你自己的需要去变更结构体的字段

//Fact 存证对象,存证合约的数据内容
type Fact struct {
    FileHash string 
    FileName string 
    Time     int
}

 24行：新建存证对象，根据Fact 结构体的变化而变化

//NewFact 新建存证对象

func NewFact(fileHash, fileName string, time int) *Fact {
    return &Fact{
        FileHash: fileHash,
        FileName: fileName,
        Time:     time,
    }
}

InitContract、UpgradeContract、InvokeContract  三个方法解析

  • InitContract、UpgradeContract：这是合约默认必须要有的方法，不要动。如果你在13行把对应合约对象的名称改了，对应你在方法名前的名称也要改成一致。
  • InvokeContract：这里是合约方法、根据你写了几个方法，依葫芦画瓢，继续补充就行。

//InitContract 合约初始化方法
func (f *FactContract) InitContract(stub shim.CMStubInterface) protogo.Response {
    return shim.Success([]byte("Init Success"))
}

// UpgradeContract 合约升级方法
func (f *FactContract) UpgradeContract(stub shim.CMStubInterface) protogo.Response {
    return shim.Success([]byte("Upgrade Success"))
}

//InvokeContract 调用合约
func (f *FactContract) InvokeContract(stub shim.CMStubInterface) protogo.Response {

//获取调用合约哪个方法
    method := string(stub.GetArgs()["method"])
    switch method {
    case "save":
        return f.Save(stub)
    case "findByFileHash":
        return f.FindByFileHash(stub)
    default:
        return shim.Error("invalid method")
    }
}

存证方法

以下大部分依葫芦画瓢就好了，重点关注以下内容：

  • 105行：key := getHashKey(fact.FileHash)  这是模板自定义的方法，在字符串前拼接一段字符，不必理会；
  • 108行：err = stub.PutStateFromKeyByte(key, factBytes)，这就是最重要的将数据上链的方法！   其中 key相当于id值，你之后查的话就要根据key去查。（别忘了模板中在105行给key前加了一段字符，你查的时候也要加上）      关于上链的方法官方还提供了其他几种。
  • stub.Log  ：都是可以输出在控制台上的，方便调试排查错误，可写可不写；
  • 120行，返回值要遵从官方的这个格式。

//save 存证，把数据存储到链上
func (f *FactContract) Save(stub shim.CMStubInterface) protogo.Response {
    // 获取调用合约的全部参数
    params := stub.GetArgs()

    // 获取指定的参数
    fileHash := string(params["file_hash"])
    fileName := string(params["file_name"])
    timeStr := string(params["time"])

    if fileHash == "" || fileName == "" || timeStr == "" {
        //返回合约执行错误，以及错误信息
        return shim.Error("fileHash and fileName and time must not empty")
    }

    time, err := strconv.Atoi(timeStr)
    if err != nil {
        msg := "time is [" + timeStr + "] not int"
        // 打印日志，使用 stub.Log 打印的日志会在控制台的输出中显示
        stub.Log(msg + err.Error())
        //返回合约执行错误，以及错误信息
        return shim.Error(msg)
    }

    fact := NewFact(fileHash, fileName, time)

    // 序列化
    factBytes, err := json.Marshal(fact)
    if err != nil {
        msg := "marshal data fail"
        stub.Log(msg + err.Error())
        return shim.Error(msg)
    }

    //向链上发送事件,发送的事件会在控制台的事件中显示
    stub.EmitEvent("topic_vx", []string{fact.FileHash, fact.FileName})

    key := getHashKey(fact.FileHash)

    //把数据存到链上
    err = stub.PutStateFromKeyByte(key, factBytes)
    if err != nil {
        msg := "fail to save fact"
        stub.Log(msg + err.Error())
        return shim.Error(msg)
    }

    //打印日志，使用 stub.Log 打印的日志会在控制台的输出中显示
    stub.Log("[save] file hash:" + fact.FileHash)
    stub.Log("[save] file name:" + fact.FileName)

    // 返回执行成功
    return shim.Success([]byte(fact.FileName + fact.FileHash))

}

取证方法

以下大部分依葫芦画瓢就好了，重点关注以下内容：

  • 133行：这里就是去拼接了字符串
  • 134行：取证的方法：stub.GetStateFromKeyByte(key)  ，返回的result是byte[ ]类型
  • 145行：反序列化
  • 157行：返回值遵从官方规范。

//findByFileHash 根据文件哈希从链上查找数据
func (f *FactContract) FindByFileHash(stub shim.CMStubInterface) protogo.Response {
    // 获取调用合约的全部参数
    params := stub.GetArgs()

    // 获取指定参数
    fileHash := string(params["file_hash"])

    // 查询结果
    key := getHashKey(fileHash)
    result, err := stub.GetStateFromKeyByte(key)
    if err != nil {
        msg := "failed to call get_state"
        // 打印日志，使用 stub.Log 打印的日志会在控制台的输出中显示
        stub.Log(msg + err.Error())
        //返回合约执行错误，以及错误信息
        return shim.Error(msg)
    }

    // 反序列化
    var fact Fact
    err = json.Unmarshal(result, &fact)
    if err != nil {
        msg := "unmarshal data fail"
        stub.Log(msg + err.Error())
        return shim.Error(msg)
    }

    // 记录日志
    stub.Log("[find_by_file_hash] file hash:" + fact.FileHash)
    stub.Log("[find_by_file_hash] file name:" + fact.FileName)

    // 返回执行成功
    return shim.Success(result)

}

其他

这就是前面说的拼接字符串的方法，他在hash前加了“fact_hash”

func getHashKey(hash string) string {
    return "fact_hash" + hash
}

2、代码入口包名必须为main  （注意事项在注释中）

// sdk代码中，有且仅有一个main()方法
func main() {  
   // main()方法中，下面的代码为必须代码，不建议修改main()方法当中的代码
   // 其中，FactContract为用户实现合约的具体名称
	err := sandbox.Start(new(FactContract))
	if err != nil {
		log.Fatal(err)
	}
}

FAFU_kyp
关注
专栏目录
使用golang与智能合约进行交互
西京刀客
06-23 819
Go和以太坊智能合约交互，是使用了以太坊的JSON-RPC接口，即把所有读取写入请求转换成RPC请求，发送给以太坊节点，并等待回应。这和之前转账是完全一致的，只不过交互的地址从EOA变成了合约而已。
长安链GO语言智能合约编写与编译
h363659487的博客
06-23 1436
长安链GO语言智能合约编写、编译、压缩方法
智能合约模拟调用的具体应用：在golang中查询uniswap v3智能合约上某代币的价格
海豹姥爷的博客
03-16 2220
合约的方法如果是public view的，那么通过golang代码可以直接调用，步骤大致为：1、使用合约的ABI生成.go文件接口2、使用以太坊节点链接初始化以太坊客户端；3、以以太坊客户端和uniswap合约地址为参数，实例化uniswap合约4、直接调用uniswap的“查询价格”的方法，传入代币地址和数量等参数，获取价格。
区块链以太坊 - Go调用合约
qq_42908175的博客
05-06 1014
对于详细的学习步骤，推荐大家学习这个教程。https://goethereumbook.org/zh/smart-contract-deploy/
使用go与智能合约交互之abi调用
外柏叁布道者
07-28 1001
让我们一起学习一下如何使用abi的方式进行智能合约的调用
人工智能-项目实践-区块链-Blockchain demo based on golang 基于golang编写的区块链公链
01-03
人工智能-项目实践-区块链-Blockchain demo based on golang 基于golang编写的区块链公链 主要模块： 命令调度模块 UTXO交易生成模块 密码学加解密模块 区块生成、验证模块 数据持久化模块 P2P网络通讯模块 日志...
使用Golang qt后端以Golang编写的Neovim GUI-Golang开发
05-26
GoNeovim是用Go编写的Neovim GUI，对Go使用Qt绑定。 该存储库是从原始Gonvim派生出来的，用于维护和增强。 功能所有功能都是可选的。 您可以使用i GoNeovim是用Go编写的Neovim GUI，对Go使用Qt绑定。 该存储库是从...
Go-使用Golang编写的URL短链接服务
08-14
使用Golang编写的URL短链接服务。Shortme的特点 相同的URL对应成不同的短链接 提供了short和expand的api。expand的api通过HTTP的307状态码进行重定向 黑名单。避免一些不是特别好的短链接，比如fuck, stupid等；
SCBlog:一个使用Golang编写的个人博客程序
05-07
Golang语言编写到博客程序 作者博客： 程序说明 本程序使用Golang开发，为作者自用博客程序 安装说明 安装Golang 安装Git 安装MongoDB 获取所使用的第三方库 go get github.com/astaxie/beego go get github....
长安链GO语言智能合约环境搭建及使用
h363659487的博客
06-22 1450
长安链GO语言智能合约环境搭建及部署合约、调用合约、查询合约方法介绍
长安链使用Golang编写智能合约教程（三）
最新发布
目前专注区块链相关技术的学习与分享
05-29 1144
长安链使用Golang编写智能合约教程 SDK详细解析
在本地以太坊私链上，使用go调用智能合约，获取事件日志
qq_37575994的博客
10-19 3208
在本地搭建以太坊私链，使用go语言调用智能合约，并记录事件日志
Go 语言与智能合约调用
GitChat
11-26 1539
2017年由于比特币的疯狂上涨，让大家见识到了其背后技术区块链的能量。比特币是区块链的第一个产品，代表了区块链1.0时代的到来。而以太坊则代表了区块链2.0时代的到来，以太坊比比特币的改进地方就是在区块链上还可以编程！这个区块链上运行的代码我们给它叫做智能合约！而基于以太坊平台的 ICO 模式，更是让人热血沸腾。同时由于以太坊的 Geth 是基于 Go 编写的，那么 Go 语言名正言顺的成为了区块...
【智能合约】Go语言调用智能合约 | geth
面向生活编程
08-07 1万+
目录1. 获取abi文件：合约的接口2. 安装abigen工具：用来生成go文件，3. remix连接私有链4. 合约部署5. 初始化私有链节点创世块6. 合约部署7. 调用8. gcc编译器安装 1. 获取abi文件：合约的接口 Application Binary Interface 在remix工具中编译合约后，会有个abi，点复制，然后新建一个xx.abi文件，把赋值的粘贴到里面 注意：代码变了，重新编译后abi也会变，所以一定要用最新的abi 也可以通过solc生成abi： solc --bin
使用Go语言与Ethereum智能合约进行交互
博客
08-01 6770
原文：Interacting with Ethereum Smart Contracts using Go) 作者：[zupzup] 翻译：Diwei 译者注：本文主要介绍使用Go语言与Ethereum智能合约进行交互。以下为译文尽管最近出现了麻烦，但Ethereum仍然是区块链空间中实现智能合约最重要的系统，而且这种情况似乎不太可能很快改变。在我看来，技术本身具有很大的潜力，从...
go简单连接智能合约
hch2002的博客
07-03 1282
go调用智能合约
长安链--智能合约的开发、编译、安装、调用、查询(二)
菜鸟的博客
06-11 5120
作者：明神特烦恼 智能合约是区块链与业务关联度最大的部分，合约的友好性、安全性、执行效率也是优秀的智能合约引擎的重要指标，长安链的支持多种语言的智能合约，包括go、rust、solidity、c++等。本节使用go语言开发智能合约，使用tinygo进行合约编译、使用go sdk 安装、调用、查询智能合约。 官方参考文档： https://docs.chainmaker.org.cn/dev/%E6%99%BA%E8%83%BD%E5%90%88%E7%BA%A6.html 1.开发智能合约 1）合约模板
长安链从零到一部署-chainmaker-v2.3.2
热门推荐
茶余饭后
01-13 1万+
如何通过长安链快速部署区块链系统 文章目录长安链从零到一源码部署一、环境及概念1.1、环境依赖1.2、相关概念二、环境安装2.1、配置sudo权限2.2、修改源2.3、安装git2.4、安装golang2.5、安装docker2.6、安装GLIBC_2.18【若运行时找不到glibc2.1.8则安装】2.7、安装GCC7.3+【若运行时gcc版本过低则安装】三、单机部署3.1、下载源码3.2、编译证书管理工具3.3、证书及配置文件生成3.4、编译及安装包制作3.5、启动3.6、查看启动情况四、智能合约开发4
使用golang编写server
07-28
使用Golang编写一个简单的HTTP服务器可以有多种方式。下面是两种常见的实现方式： 第一种方式是使用`http.HandleFunc`函数和一个处理函数来实现。代码如下所示： ```go package main import ( "fmt" "net/http" ) func indexHandler(w http.ResponseWriter, r *http.Request) { fmt.Fprintf(w, "hello world") } func main() { http.HandleFunc("/", indexHandler) http.ListenAndServe(":8000", nil) } ``` 在这个例子中，我们定义了一个`indexHandler`函数来处理根路径的请求。当有请求到达时，`indexHandler`函数会将"hello world"作为响应写入到`http.ResponseWriter`中。 第二种方式是使用自定义的处理器类型和`http.Handle`函数来实现。代码如下所示： ```go package main import ( "fmt" "net/http" ) type indexHandler struct { content string } func (ih *indexHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) { fmt.Fprintf(w, ih.content) } func main() { http.Handle("/", &indexHandler{content: "hello world!"}) http.ListenAndServe(":8001", nil) } ``` 在这个例子中，我们定义了一个`indexHandler`类型，并实现了`ServeHTTP`方法。当有请求到达时，`ServeHTTP`方法会将`indexHandler`的`content`字段作为响应写入到`http.ResponseWriter`中。 无论是哪种方式，我们都需要使用`http.ListenAndServe`函数来启动服务器。这个函数会监听指定的地址，并将请求交给指定的处理器来处理。 希望这个例子能帮助你理解如何使用Golang编写一个简单的HTTP服务器。 #### 引用[.reference_title] - *1* *2* *3* [golang http Server介绍](https://blog.csdn.net/zrg3699/article/details/122280399)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^insertT0,239^v3^insert_chatgpt"}} ] [.reference_item] [ .reference_list ]
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值