types

package
Version: v1.67.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 27, 2022 License: BSD-3-Clause Imports: 5 Imported by: 1

README

exchange合约

前言

这是一个基于chain33开发的去中心化交易所合约,不收任何手续费,用于满足一小部分人群或者其他特定业务场景中,虚拟资产之间得交换。

使用

合约提供了类似中心化交易所健全的查询接口,所有得接口设计都基于用户的角度去出发 合约接口,在线构造交易和查询接口分别复用了框架中的CreateTransaction和Query接口,详情请参考 CreateTransaction接口Query接口

查询方法名称 功能
QueryMarketDepth 获取指定交易资产的市场深度
QueryHistoryOrderList 实时获取指定交易对已经成交的订单信息
QueryOrder 根据orderID订单号查询具体的订单信息
QueryOrderList 根据用户地址和订单状态(ordered,completed,revoked),实时地获取相应相应的订单详情

可参照exchange_test.go中得相关测试用例,构建limitOrder或者revokeOrder交易进行相关测试

注意事项

合约撮合规则如下:

序号 规则
1 以市场价成交
2 买单高于市场价,按价格由低往高撮合
3 卖单低于市场价,按价格由高往低进行撮合
4 价格相同按先进先出的原则进行撮合
5 出于系统安全考虑,最大撮合深度为100单,单笔挂单最小为1e8,就是一个bty

表结构说明

表名 主键 索引 用途 说明
depth price nil 动态记录市场深度 主键price是复合主键由{leftAsset}:{rightAsset}:{op}:{price}构成
order orderID market_order,addr_status 实时动态维护更新市场上的挂单 market_order是复合索引由{leftAsset}:{rightAsset}:{op}:{price}:{orderID},addr_status是复合索引由{addr}:{status},当订单成交或者撤回时,该条订单记录和索引会从order表中自动删除
history index name,addr_status 实时记录某资产交易对下面最新完成的订单信息(revoked状态的交易也会记录) name是复合索引由{leftAsset}:{rightAsset}构成, addr_status是复合索引由{addr}:{status}

表中相关参数说明

参数名 说明
leftAsset 交易对左边资产名称
rightAsset 交易对右边资产名称
op 买卖操作 1为买,2为卖
status 挂单状态,0 ordered, 1 completed,2 revoked
price 挂单价格,占位16 %016d,为了兼容不同架构的系统,这里设计为整型,由原有浮点型乘以1e8。 比如某交易对在中心化交易所上面是0.25,这里就变成25000000,price取值范围为1<=price<=1e16的整数
orderID 单号,由系统自动生成,整型,占位22 %022d
index 系统自动生成的index,占位22 %022d

Documentation

The Go Gopher

There is no documentation for this package.

Source Files

Directories

Path Synopsis
Package commands implement dapp client commands
Package commands implement dapp client commands
cmd

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL