Stellar开发中关于offer相关的总结

发表于 2018-03-19 更新于 2024-09-19

最近完工的 StellarBot v0.0.8 对核心进行了重写，由于之前赶比赛进度，一直没有在offer这块搞明白。这次花了大量的时间来研究orderbook和创建offer这两部分的重要参数。这篇文章就是对于之前研究的一个总结。（是不是现在就已经开始晕了？一会order一会offer的。）

本文将会根据 base/counter 为交易单位来总结，如果对于 base/counter 还不明白的，请先看我之前写的这篇文章，里面解释了这种单位的意思是怎样的。

Orderbook

GET /order_book?selling_asset_type={selling_asset_type}&selling_asset_code={selling_asset_code}&selling_asset_issuer={selling_asset_issuer}&buying_asset_type={buying_asset_type}&buying_asset_code={buying_asset_code}&buying_asset_issuer={buying_asset_issuer}&limit={limit}

上面的就是 Orderbook 的 REST API。我们可以看到这个接口有以下参数：

name	notes	description	example
`selling_asset_type`	required, string	Type of the Asset being sold	`native`
`selling_asset_code`	optional, string	Code of the Asset being sold	`USD`
`selling_asset_issuer`	optional, string	Account ID of the issuer of the Asset being sold	`GA2HGBJIJKI6O4XEM7CZWY5PS6GKSXL6D34ERAJYQSPYA6X6AI7HYW36`
`buying_asset_type`	required, string	Type of the Asset being bought	`credit_alphanum4`
`buying_asset_code`	optional, string	Code of the Asset being bought	`BTC`
`buying_asset_issuer`	optional, string	Account ID of the issuer of the Asset being bought	`GD6VWBXI6NY3AOOR55RLVQ4MNIDSXE5JSAVXUTF35FRRI72LYPI3WL6Z`
`limit`	optional, string	Limit the number of items returned	`20`

（该表格来自 https://www.stellar.org/developers/horizon/reference/endpoints/orderbook-details.html）

官方给的这张表格，感觉太不好理解了，以下是我总结出来的参数和 base/counter 的对应关系：

再结合着实际的数据来看一下（接口返回数据与钱包数据的对应图）：

注意 Orderbook 接口返回的数据里，买卖单的 amount 是不同货币的》

提交 Offer 的各种参数

在 Stellar 系统里把单个订单称作 offer，这就跟之前的 orderbook 感觉跟别扭。这样的命名别扭会一直贯穿整个开发过程，所以我直接在我的代码里用了 order 代替 offer。

管理订单的接口文档在这里可以看到，我摘录过来相关的参数表格如下：

Field	Type	Description
offer_id	number	Offer ID.
amount	string	Amount of asset to be sold.
buying_asset_code	string	The code of asset to buy.
buying_asset_issuer	string	The issuer of asset to buy.
buying_asset_type	string	Type of asset to buy (native / alphanum4 / alphanum12)
price	string	Price to buy a buying_asset
price_r	Object	n: price numerator, d: price denominator
selling_asset_code	string	The code of asset to sell.
selling_asset_issuer	string	The issuer of asset to sell.
selling_asset_type	string	Type of asset to sell (native / alphanum4 / alphanum12)