types

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