智能合约开发

仙女233333
256 阅读4分钟

概述

本项目为go示例合约，实现了对key/value对的增删查改的功能

开发环境

go版本：不限
IDE：goland或Idea

  • 在拥有智能合约开发环境后，基于gotest合约demo，进行go语言开发。 Demo目录如图

image.png

image.png

编写合约

对合约的编写主要是在example/gotest/src里

  • state.go state.go存放合约使用的存储定义和数据结构定义。
    主要是set存数据和get取数据，对于要存储的数据类型、对应的key都可以自行定义。
    例如：Dome中定义了item结构体，存储item和取出item方法。

image.png

storage.Set 传入[]byte类型的key , value. Demo里saveitem方法将item转化为json格式作为value进行存储 , 可根据自己的需求进行变换。
storage.Get 传入[]byte类型的key, 返回value.
关于storage的方法还有Range，Remove(删除)， 详情查看std/imports.go

  • msg.go msg.go存放合约接收消息的定义。
    根据合约需求定义不同的结构体类型, 里面必须定义InstantiateMsg, ExecuteMsg。
    MigrateMsg QueryMsg 每个结构体里的内容也是根据需求自定义，但需要对应后面的执行。
    示例：

image.png

例如，想对合约一次传入2个Item，可以这样定义：

image.png

  • contract.go contract.go存放合约各方法的实现
    合约结构体必须包含Instantiate合约方法，用于合约初始化时执行相应逻辑

image.png Migrate 升级合约

image.png

合约结构体必须包含Execute合约方法，用于合约执行时处理收到相应消息类型

image.png

Execute函数相当于一个分流器，根据传入的参数去执行不同的函数，每类消息里的case需要跟msg.go里的定义相对应，下面要执行的函数根据业务需求来写，需要返回的结构体对的response。

Demo中的executeCreatea函数示例：

func executeCreate(deps *std.Deps, _ types.Env, _ types.MessageInfo, create *Create) (*types.Response, error) {
err := SaveItem(deps.Storage, create.Item)
if err != nil {
return nil, err
}
return &types.Response{}, nil
}

合约调用合约写法:
设置和调用合约所需操作的数据结构

image.png
示例操作

image.png

合约结构体必须包含Query合约方法，用于合约查询时处理收到相应消息类型。

image.png

Query函数与Execute类似，根据传入的参数去执行不同的函数，每类消息里的case需要跟msg.go里的定义相对应，下面要执行的函数根据业务需求来写，需要返回的结构体对的response。

合约本质上是对链存储的操作。
image.png
合约操作原语包含对Storage的增删查改，Storage的定义如上所示。
常用接口如下：
1.func (s ExternalStorage) Get(key []byte) (value []byte) {} ：数据查询接口
2.func (s ExternalStorage) Range(start, end []byte, order Order) (iter Iterator) {} ：范围查询接口 3.func (s ExternalStorage) Set(key, value []byte) {} ： 数据存储接口
4.func (s ExternalStorage) Remove(key []byte) {} ：数据删除接口

合约与链的交互
获取链相关信息

Env：定义了此合约运行所在的区块链环境的状态，必须只包含受信任的数据 - Tx 本身中没有尚未验证的数据。Env在传递到wasm合约之前由json转换为byte切片。

包含：Block （区块信息，含有高度、时间、链ID）
Contract（合约信息，含合约地址）
Transaction（交易信息,含有唯一链的事务标识符，以供查询）

获取当前区块高度：

env.Block.Height

获取区块生成时间：

env.Block.Time

MessageInfo： 包含执行者的地址和一起发送到合同的资金金额的信息。
获取交易发送者地址：

types.MessageInfo.Sender

Response: 当instantiate/execute/migrate成功时的返回值。

包含：Message（直接来自contract，是对操作的请求。）
Data
Attributes（日志事件的属性）
Events（事件）

其中messages用于跨模块与跨合约操作，Attributes用于写日志，data用于返回值供链使用
示例如下： 跨合约调用

func (r Response) AddWasmMsg(contractName string, msg []byte) Response {
	m := CosmosMsg{
		Wasm: &WasmMsg{
			Execute: &ExecuteMsg{
				ContractAddr: contractName,
				Msg:          msg,
			},
		},
	}
	sm := NewSubMsg(m)
	r.Messages = append(r.Messages, sm)
	return r
}

将合约的EventAttribute打印到Attributes

func (r Response) AddAttribute(key string, value string) Response {
   m := EventAttribute{
   	key,
   	value,
   }
   r.Attributes = append(r.Attributes, m)
   return r
}

将b返回给链，链可以获取到b进行其他操作

func (r Response) SetData(b []byte) Response {
 r.Data = b
 return r
}

Deps：传递给contract的可变入口点的依赖。

包含：Storage（提供对数据持久化层的读写访问）
Api（Api提供对常见实用工具的访问，如地址解析和验证。）
Querier（用于查询其他合同的信息。）

编译合约

1. 编译生成json文件

image.png

点击执行小绿三角，执行完毕后可以查看xx_tinyjson.go是否生成更新

2.编译合约

进入Makefile文件，执行gotest语句，或者在终端输入该条指令执行。[注：${CURDIR)换成当前目录]

image.png 根据网络情况稍等一段时间后，合约编译完成结果如下所示：

image.png

编译完成的文件默认在gotest下，目录下，扩展名wasm

image.png

avatar
文章
阅读
粉丝