Skip to content

T
test
Commit a5658b4b authored by 谢昇's avatar 谢昇
Browse files
Options

Update cli独立模块命令-2（token）.md

parent 364c402b
Hide whitespace changes
Inline Side-by-side
Showing with 342 additions and 2 deletions
cli独立模块命令-2（token）.md
View file @ a5658b4b
**版本：V6.2.0** **版本：V6.2.0**
...@@ -208,7 +208,347 @@ Flags: ...@@ -208,7 +208,347 @@ Flags:
*** ***
目前版本有两个接口只有rpc，未实现cli命令，包括： 目前版本有两个接口只有rpc，未实现cli命令，包括：
查询指定创建成功的token； 查询指定创建成功的token；
查询token相关的交易。 查询token相关的交易。
***
# trade trade合约
`cli trade -h`
```
Available Commands:
buy Create a buying token transaction
buy_limit Create a buy limit transaction
buy_order Show one's buying orders
revoke Create a revoke token transaction
revoke_buy Create a revoke buy limit transaction
sell Create a selling token transaction
sell_market Create a sell market transaction
sell_order Show one's token selling orders
status_buy_order Show one's buying orders of tokens
status_order Show one's orders with status
status_sell_order Show selling orders of the status
status_token_buy_order Show token buying orders of a status
status_token_sell_order Show token selling orders of a status
```
在下面查询相关接口中， 返回的卖单都一个一种格式， 买单也是一种格式， 只在第一个卖单或买单查询中列出其格式， 不重复
卖单买单状态
状态 1： TradeOrderStatusOnSale, 在售
状态 2： TradeOrderStatusSoldOut，售完
状态 3： TradeOrderStatusRevoked， 卖单被撤回
状态 4： TradeOrderStatusExpired， 订单超时(目前不支持订单超时)
状态 5： TradeOrderStatusOnBuy， 求购
状态 6： TradeOrderStatusBoughtOut， 购买完成
状态 7： TradeOrderStatusBuyRevoked， 买单被撤回
Buy/Sell ID 在创建交易时不需要带上前缀 “mavl-trade-sell-“ 或 ”mavl-trade-buy-“
要执行在trade中的交易，首先需要由token合约向trade合约转币：
`cli token send_exec -e trade -a 1000 -s COC `
签名并发送。
## 交易操作
***
## sell 挂卖
`cli trade sell -m 100 -p 0.1 -s COC -t 100 `
签名并发送
默认每手为0.01个token；
-m为最小购买手数；
-p为每手价格；
-t为出售的token总量。
## buy 购买指定卖单的token
购买前需要在trade合约中有足额的BTY
`cli coins send_exec -a 700 -e trade`
签名并发送。
购买指定卖单的token
`cli trade buy -c 200 -s aa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381 `
签名并发送。
## buy_limit 挂买
因为历史原因，挂买和挂卖的cli命令不对称。
`cli trade buy_limit -m 1 -p 0.1 -s COC -t 2 `
签名并发送。
参数定义与挂卖一致。
## sell_market 出售token给指定id的挂买单
`cli trade sell_market -b bba09b6aece714bcbdc66142414a8050d576d4b0c9b7e78b56c93637ae582634 -c 200 `
签名并发送。
## revoke 撤销挂卖
`cli trade revoke -s aa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381 `
挂单地址签名并发送。
## revoke_buy 撤销挂买
`cli trade revoke_buy -b bba09b6aece714bcbdc66142414a8050d576d4b0c9b7e78b56c93637ae582634 `
挂单地址签名并发送。
***
## 查询操作
***
## sell_order 根据地址及token标志查询挂卖单
`cli trade sell_order -s "1KbM8ewfmNzsp1j3GHKz5tGn28ouaAGZAG" -t COC`
```
{
"sellOrders": [
{
"tokenSymbol": "COC",
"owner": "1KbM8ewfmNzsp1j3GHKz5tGn28ouaAGZAG",
"amountPerBoardlot": "0.0100",
"minBoardlot": 100,
"pricePerBoardlot": "0.1000",
"totalBoardlot": 10000,
"tradedBoardlot": 0,
"buyID": "",
"status": 1,
"sellID": "mavl-trade-sell-aa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"txHash": "0xaa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"height": 2892103,
"key": "mavl-trade-sell-aa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"blockTime": 1565077079,
"isSellOrder": true
}
]
}
```
默认为0.01个每手，共100个token，故为10000手
## status_sell_order 根据地址及订单状态查询挂买单
`cli trade status_sell_order -a "1KbM8ewfmNzsp1j3GHKz5tGn28ouaAGZAG" -s onsale`
```
{
"sellOrders": [
{
"tokenSymbol": "COC",
"owner": "1KbM8ewfmNzsp1j3GHKz5tGn28ouaAGZAG",
"amountPerBoardlot": "0.0100",
"minBoardlot": 100,
"pricePerBoardlot": "0.1000",
"totalBoardlot": 10000,
"tradedBoardlot": 0,
"buyID": "",
"status": 1,
"sellID": "mavl-trade-sell-aa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"txHash": "0xaa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"height": 2892103,
"key": "mavl-trade-sell-aa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"blockTime": 1565077079,
"isSellOrder": true
}
]
}
```
-s的状态有onsale, soldout ，revoked三种
## status_token_sell_order 根据token标志及卖单状态查询指定卖单
`cli trade status_token_sell_order`
```
Flags:
-c, --count int32 order count (default 10)
-d, --direction int32 direction must be 0 (previous-page) or 1(next-page) (default 1)
-f, --from string start from sell id (not required)
-h, --help help for status_token_sell_order
-s, --status string sell order status (onsale, soldout or revoked)
-t, --token string token name
```
`cli trade status_token_sell_order -c 2 -d 1 -s onsale -t COC`
```
{
"sellOrders": [
{
"tokenSymbol": "COC",
"owner": "1KbM8ewfmNzsp1j3GHKz5tGn28ouaAGZAG",
"amountPerBoardlot": "0.0100",
"minBoardlot": 100,
"pricePerBoardlot": "0.1000",
"totalBoardlot": 10000,
"tradedBoardlot": 200,
"buyID": "",
"status": 1,
"sellID": "mavl-trade-sell-aa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"txHash": "0xaa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"height": 2892103,
"key": "mavl-trade-sell-aa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"blockTime": 1565077079,
"isSellOrder": true
}
]
}
```
-c为查询数量，默认为10；
-d为查询方向，默认为1，正向；
-f为查询起始id，非必需；
-s为卖单状态，包括onsale，soldout，revoked；
-t为token标志。
### buy_order 查询买单
`cli trade buy_order -t COC -b 1KbM8ewfmNzsp1j3GHKz5tGn28ouaAGZAG`
```
{
"buyOrders": [
{
"tokenSymbol": "COC",
"owner": "1KbM8ewfmNzsp1j3GHKz5tGn28ouaAGZAG",
"amountPerBoardlot": "0.0100",
"minBoardlot": 1,
"pricePerBoardlot": "0.1000",
"totalBoardlot": 200,
"tradedBoardlot": 0,
"buyID": "mavl-trade-buy-bba09b6aece714bcbdc66142414a8050d576d4b0c9b7e78b56c93637ae582634",
"status": 5,
"sellID": "",
"txHash": "0xbba09b6aece714bcbdc66142414a8050d576d4b0c9b7e78b56c93637ae582634",
"height": 2892613,
"key": "mavl-trade-buy-bba09b6aece714bcbdc66142414a8050d576d4b0c9b7e78b56c93637ae582634",
"blockTime": 1565079711,
"isSellOrder": false
}
]
}
```
## status_buy_order 查询指定地址的指定状态的买单
`cli trade status_buy_order -b "1KoiQmaFg3DoZr84JehxrEWiR7SorSgbUx" -s boughtout`
```
{
"buyOrders": [
{
"tokenSymbol": "COC",
"owner": "1KoiQmaFg3DoZr84JehxrEWiR7SorSgbUx",
"amountPerBoardlot": "0.0100",
"minBoardlot": 100,
"pricePerBoardlot": "0.1000",
"totalBoardlot": 200,
"tradedBoardlot": 200,
"buyID": "",
"status": 6,
"sellID": "mavl-trade-sell-aa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"txHash": "0x779f3f9351243a69e865604c77fdd4316eac98e9e559b0e7aeb3b2d9a034fcb7",
"height": 2892103,
"key": "0x779f3f9351243a69e865604c77fdd4316eac98e9e559b0e7aeb3b2d9a034fcb7",
"blockTime": 1565078298,
"isSellOrder": false
}
]
}
```
※ -s支持onbuy, boughtout or buyrevoked
## status_token_buy_order 根据token标志及卖单状态查询指定卖单
`cli trade status_token_buy_order -c 2 -d 1 -s boughtout -t COC`
```
{
"buyOrders": [
{
"tokenSymbol": "COC",
"owner": "1KoiQmaFg3DoZr84JehxrEWiR7SorSgbUx",
"amountPerBoardlot": "0.0100",
"minBoardlot": 100,
"pricePerBoardlot": "0.1000",
"totalBoardlot": 200,
"tradedBoardlot": 200,
"buyID": "",
"status": 6,
"sellID": "mavl-trade-sell-aa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"txHash": "0x779f3f9351243a69e865604c77fdd4316eac98e9e559b0e7aeb3b2d9a034fcb7",
"height": 2892103,
"key": "0x779f3f9351243a69e865604c77fdd4316eac98e9e559b0e7aeb3b2d9a034fcb7",
"blockTime": 1565078298,
"isSellOrder": false
},
{
"tokenSymbol": "COC",
"owner": "1KbM8ewfmNzsp1j3GHKz5tGn28ouaAGZAG",
"amountPerBoardlot": "0.0100",
"minBoardlot": 1,
"pricePerBoardlot": "0.1000",
"totalBoardlot": 200,
"tradedBoardlot": 200,
"buyID": "mavl-trade-buy-bba09b6aece714bcbdc66142414a8050d576d4b0c9b7e78b56c93637ae582634",
"status": 6,
"sellID": "",
"txHash": "0xbba09b6aece714bcbdc66142414a8050d576d4b0c9b7e78b56c93637ae582634",
"height": 2892613,
"key": "mavl-trade-buy-bba09b6aece714bcbdc66142414a8050d576d4b0c9b7e78b56c93637ae582634",
"blockTime": 1565079711,
"isSellOrder": false
}
]
}
```
参数定义与查询挂买一致，-s状态包括onbuy, boughtout or buyrevoked。
## status_order 查询指定地址的指定状态的所有买卖单，可指定配置查询
`cli trade status_order -h`
```
Flags:
-a, --address string user address
-c, --count int32 order count (default 10)
-d, --direction int32 direction must be 0 (previous-page) or 1(next-page) (default 1)
-f, --from string start from sell id (not required)
-h, --help help for status_order
-s, --status int32 order status (1: on, 2: done, 3: revoke)
```
`cli trade status_order -a "1KbM8ewfmNzsp1j3GHKz5tGn28ouaAGZAG" -s 1`
```
{
"orders": [
{
"tokenSymbol": "COC",
"owner": "1KbM8ewfmNzsp1j3GHKz5tGn28ouaAGZAG",
"amountPerBoardlot": "0.0100",
"minBoardlot": 100,
"pricePerBoardlot": "0.1000",
"totalBoardlot": 10000,
"tradedBoardlot": 200,
"buyID": "",
"status": 1,
"sellID": "mavl-trade-sell-aa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"txHash": "0xaa376e2b30cc07c4629460d9b520f8f39f003fb12cd87404574f3f9faddc7381",
"height": 2892103,
"key": "000000289210300005",
"blockTime": 1565077079,
"isSellOrder": true
},
{
"tokenSymbol": "COC",
"owner": "1KbM8ewfmNzsp1j3GHKz5tGn28ouaAGZAG",
"amountPerBoardlot": "0.0100",
"minBoardlot": 1,
"pricePerBoardlot": "0.1000",
"totalBoardlot": 200,
"tradedBoardlot": 0,
"buyID": "mavl-trade-buy-bba09b6aece714bcbdc66142414a8050d576d4b0c9b7e78b56c93637ae582634",
"status": 5,
"sellID": "",
"txHash": "0xbba09b6aece714bcbdc66142414a8050d576d4b0c9b7e78b56c93637ae582634",
"height": 2892613,
"key": "000000289261300001",
"blockTime": 1565079711,
"isSellOrder": false
}
]
}
```
※ -s后1: on, 2: done, 3: revoke
※ -c可选择输入，为显示的买卖单上限，默认为10；
-d可选择输入，显示查询的方向，默认为1，即正向，0代表反向。
# 冻结解冻 # 冻结解冻
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment