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

news2024/12/27 12:35:05

编写前的注意事项：

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)
	}
}

4、在官方模板上新增一个查询历史记录的方法

注意：

1、之前的合约是根据Key ，去进行存证、取证的。这个key和数据库中的唯一主键不同，在区块链中，你可以通过key 去多次存证，比如说你可以存  {key：1 ，value：2}，{key：1 ，value：3}，{key：1 ，value：4}

2、假设你用存证方法，存储了1中说的三条数据，你调用取证方法，只会返回最近最新的一条数据{key：1 ，value：4}，这是因为联盟链中 有一个状态数据库和一个历史数据库，取证方法调用的是GetStateFromKeyByte（）方法，他只会去状态数据库中查。

3、如果你想要查询出当时存证时输入key=1的所有存证记录，那么就要调用NewHistoryKvIterForKey（）方法，官方的存证合约并没有这个方法，现在进行一步步补充。

我去，长安链时是分2.1.+和2.3.+两个版本，上面说的是2.1.+

算了，不写了，我用的是2.3.+   ，抽时间写个2.3.+的教程

 

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1697078.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

010-Linux磁盘介绍

010-Linux磁盘介绍

文章目录 1、名词 2、类型 3、尺寸 4、接口/协议/总线 5、命名 6、分区方式 MBR分区 GPT分区 1、名词 磁盘是计算机主要的存储介质，可以存储大量的二进制数据，并且断电后也能保持数据不丢失。早期计算机使用的磁盘是软磁盘（Floppy D…
阅读更多...
牛客网刷题 | BC99 正方形图案

牛客网刷题 | BC99 正方形图案

目前主要分为三个专栏，后续还会添加： 专栏如下： C语言刷题解析 C语言系列文章 我的成长经历 感谢阅读！ 初来乍到，如有错误请指出，感谢！ 描述 KiKi学习了循环&am…
阅读更多...
CST初级教程 六

CST初级教程 六

本篇教程将以差分线为例，实例讲解参数化建模及参数扫描。 一 Project创建 点击New and Recent，再点击New Template 点击MICROVAVES & RF/OTICAL，然后在选中Circuit & Components。 点击对话框中Next按钮，在弹出对话框…
阅读更多...
C语言中的七种常用排序

C语言中的七种常用排序

今天&#xff0c;为大家整理了C语言中几种常用的排序&#xff0c;以及他们在实际中的运用&#xff08;有Bug请在下方评论&#xff09;&#xff1a; 一.桶排序 #include <stdio.h> int main() {int book[1001],i,j,t,n;for(i0;i<1000;i)book[i]0;scanf("%d"…
阅读更多...
B树与B+树区别

B树与B+树区别

B树和B树是常见的数据库索引结构&#xff0c;都具有相较于二叉树层级较少&#xff0c;查找效率高的特点&#xff0c;它们之间有以下几个主要区别&#xff1a; 1.节点存储数据的方式不同 B树的叶子结点和非叶子节点都会存储数据&#xff0c;指针和数据共同保存在同一节点中B树…
阅读更多...
MySQL的索引, 到底怎么创建?

MySQL的索引, 到底怎么创建?

目录 前言 MySQL的数据结构 索引是一把双刃剑 索引创建原则 如何给一个列挑选索引? 索引列的基数, 要尽量小 索引列的类型尽量小 索引长字符串的前缀 不要对索引列进行计算操作或者函数计算. 不要老想着查询, 想想插入该怎么办? 避免索引冗余和重复 前言 今天在…
阅读更多...
【二叉树】：LeetCode：100.相同的数(分治）

【二叉树】：LeetCode：100.相同的数(分治）

&#x1f381;个人主页&#xff1a;我们的五年 &#x1f50d;系列专栏&#xff1a;初阶初阶结构刷题 &#x1f389;欢迎大家点赞&#x1f44d;评论&#x1f4dd;收藏⭐文章 1.问题描述&#xff1a; 2.问题分析&#xff1a; 二叉树是区分结构的&#xff0c;即左右子树是不一…
阅读更多...
上5个B端系统的设计规范，让你的开发比着葫芦画瓢。

上5个B端系统的设计规范，让你的开发比着葫芦画瓢。

B端系统设计规范在企业级系统开发中起着重要的作用&#xff0c;具体包括以下几个方面&#xff1a; 统一风格和布局&#xff1a;设计规范能够统一系统的风格和布局&#xff0c;使不同功能模块的界面看起来一致&#xff0c;提升用户的使用体验和学习成本。通过统一的设计规范&am…
阅读更多...
模型驱动架构设计方法及应用

模型驱动架构设计方法及应用

引言 模型驱动架构&#xff08;Model Driven Architecture&#xff0c;MDA&#xff09;是一种软件开发方法论&#xff0c;它强调使用一系列抽象层次的模型&#xff0c;并利用模型之间的转换来实现从需求到设计、直至代码生成的全过程。MDA的核心思想是在软件开发过程中强调使用…
阅读更多...
druid 1.2.14，application.yaml配置文件中，如何进行数据库加密配置

druid 1.2.14，application.yaml配置文件中，如何进行数据库加密配置

步骤一&#xff1a;先生成加密的密码&#xff1a; 步骤二&#xff1a;配置application.yaml文件&#xff1a; spring:datasource:driver-class-name: com.mysql.cj.jdbc.Drivertype: com.alibaba.druid.pool.DruidDataSourcedruid:username: rootpassword: aPJ35saFz6ASmnmNt…
阅读更多...
CentOS 7.9部署宝塔面板超详细

CentOS 7.9部署宝塔面板超详细

CentOS7 部署宝塔面板 Linux的宝塔面板搭建起来非常轻松&#xff0c;也可以用一句话来形容&#xff0c;如果喝水一样简单&#xff0c;只需一条命令剩下的交给时间&#xff0c;几分钟就能部署好&#xff0c;然后就可以直接进行登录&#xff0c;直接可以安装LNMP、LAMP平台&…
阅读更多...
数据结构与算法（Java版） | 详解十大经典排序算法之一：希尔排序

数据结构与算法（Java版） | 详解十大经典排序算法之一：希尔排序

接下来&#xff0c;我来给大家讲解第四种排序算法&#xff0c;即希尔排序。 简单插入排序所存在的问题 在上篇文章中&#xff0c;我已经给大家讲解完插入排序了&#xff0c;虽说是讲完了&#xff0c;但在这里我还是想请大家开动脑筋思考一下&#xff0c;就是咱们讲解的插入排…
阅读更多...
SDK崩溃后怎么打开已有工程

SDK崩溃后怎么打开已有工程

1.进到SDK里面&#xff0c;保留&#xff1a;platform、bsp和工程包&#xff08;这里是C&#xff09;&#xff0c;其他都删掉 2.windows窗口运行sdk 3.导入sdk工程
阅读更多...
基于springboot+vue的4S店车辆管理系统

基于springboot+vue的4S店车辆管理系统

开发语言&#xff1a;Java框架&#xff1a;springbootJDK版本&#xff1a;JDK1.8服务器&#xff1a;tomcat7数据库&#xff1a;mysql 5.7&#xff08;一定要5.7版本&#xff09;数据库工具&#xff1a;Navicat11开发软件&#xff1a;eclipse/myeclipse/ideaMaven包&#xff1a;…
阅读更多...
人工智能场景下的网络负载均衡技术

人工智能场景下的网络负载均衡技术

AI技术驱动智能应用井喷&#xff0c;智能算力增速远超通用算力。IDC预测&#xff0c;未来五年&#xff0c;我国智能算力规模年复合增长率将超50%&#xff0c;开启数据中心算力新纪元。随着需求激增&#xff0c;数据中心或智算网络亟需扩容、增速、减时延&#xff0c;确保网络稳…
阅读更多...
数据结构（三）栈 队列 数组

数据结构（三）栈 队列 数组

2024年5月26日一稿（王道P78） 栈 基本概念 基本操作 顺序存储结构 基本操作 共享栈
阅读更多...
数据库管理-第194期 网络加速RDMA初探（20240526）

数据库管理-第194期 网络加速RDMA初探（20240526）

数据库管理194期 2024-05-26 数据库管理-第194期 网络加速RDMA初探&#xff08;20240526&#xff09;1 概念2 发展3 使用总结 数据库管理-第194期 网络加速RDMA初探&#xff08;20240526&#xff09; 作者&#xff1a;胖头鱼的鱼缸&#xff08;尹海文&#xff09; Oracle ACE A…
阅读更多...
PLSQL连接Linux Oracle21c

PLSQL连接Linux Oracle21c

PLSQL连接Linux Oracle21c 一、安装PLsql 下载官网 https://www.allroundautomations.com/registered-plsqldev/ 二、Oracle Instant Client下载 使用plsql连接oracle的时候是需要本地先安装oracle客户端&#xff0c;英文名就是Oracle Instant Client。 官方下载地址&…
阅读更多...
RedHat9 | DNS剖析-配置辅助DNS服务器

RedHat9 | DNS剖析-配置辅助DNS服务器

一、实验环境 1、辅助域名DNS服务器 DNS通过划分为若干个区域进行管理&#xff0c;每一个区域由1台或多台DNS服务器负责解析&#xff0c;如果仅仅采用1台DNS服务器&#xff0c;在DNS服务器出现故障后&#xff0c;用户将无法完成解析。 辅助DNS服务器的优点 容灾备份&#x…
阅读更多...
PaddleSeg训练推理及模型转换全流程

PaddleSeg训练推理及模型转换全流程

文章目录 1、数据准备1.1 数据标注1.2 数据导出1.3 标签较验1.4 数据集整理1.5 标签可视化 2、 模型训练3、模型验证4、模型推理5、模型导出6、导出文件的推理7、将模型转换成onnx8、使用onnx进行推理 本文记录一下使用paddleseg进行语议分割模型对人体进行分割的使用流程。事实…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023