**版本：V6.3.2**  

## privacy 隐私交易合约  

目前主网不支持privacy合约，可在平行链运行。  
`cli privacy -h`  
```
Available Commands:
  enable      enable privacy address in wallet
  list_txs    List privacy transactions in wallet
  priv2priv   Create a privacy to privacy transaction
  priv2pub    Create a privacy to public transaction
  pub2priv    Create a public to privacy transaction
  rescanOpt   rescan Utxos in wallet and query rescan utxos status
  showau      Show Amount of UTXO
  showpai     Show privacy account information
  showpas     Show privacy account spend command
  showpk      Show privacy key by address
  showutxo4a  Show specified amount UTXOs
```
隐私交易合约不同于BTY主网账户体系，采用UTXO账户体系。  
***
## 前置操作 

## enable 使能钱包中的地址  
对于需要进行隐私交易的地址，需要先对其使能。  
`cli privacy enable -a "17mFjHjMHdtTU31QhFsLGcjNWxvGaVZcPH"-"1JeVN3q938vx8Pqcg7Kodmih8sWT5eQHHs"`  
```
{
    "results": [
        {
            "addr": "17mFjHjMHdtTU31QhFsLGcjNWxvGaVZcPH",
            "IsOK": true,
            "msg": ""
        },
        {
            "addr": "1JeVN3q938vx8Pqcg7Kodmih8sWT5eQHHs",
            "IsOK": true,
            "msg": ""
        }
    ]
}
```
-a后对多个地址操作时，以-分隔；或用all来使能本地钱包中所有的地址。  

需要向隐私合约转入供操作的代币：  
`cli token send_exec -e privacy -s COC -a 10000`   
签名并发送。  

## showpk 根据钱包地址查询隐私公钥   
`cli privacy showpk -a "1KoiQmaFg3DoZr84JehxrEWiR7SorSgbUx"`  
```
{
    "showSuccessful": true,
    "pubkeypair": "f52b540136a5c52cf032618627948773b94969a5ea994277fdcc3d9530003099e9dd7fb7cb4460172447b890e6e5a41319c4955462fbca65abfb373d5763aaf0"
}
```
***
## 交易相关  
## pub2priv 公开到隐私的交易  
本质是创建了一笔UTXO的交易。  
`cli privacy pub2priv -a 100 -e token -s COC -p 0065aa7868353e745990395e5c3519edc18cfb44541afcdd1188a585abc69590c2d0cdf0b94abe1ea7ded23efc92f11c4964a64505cfe3c6e7e5fb6dd62970ef`  
-p为目标隐私地址的公钥。  
**该交易使目标地址获得了指定数额的UTXO，可供后续花费。**  


## priv2priv 隐私到隐私的交易
`cli privacy priv2priv -a 15 -e coins -f 1KoiQmaFg3DoZr84JehxrEWiR7SorSgbUx -m 16 -p 241c7a688def4703b7e9cd3b7a89fba133ab350c608fb9aaa06eb328f1162b1deb441c2b435c3433715176191ccf9278b7d18fc175325065831c2e4c9f2f1b22 -s BTY`    
-m为UTXO混淆数量，默认为16  
-p为目标隐私地址的公钥。  
该交易需消耗1BTY为手续费。  

**该交易使目标地址获得了指定数额的UTXO，可供后续花费。**  

## priv2pub 隐私到公开的交易  
`cli privacy priv2pub -a 17 -e coins -f 1KoiQmaFg3DoZr84JehxrEWiR7SorSgbUx -m 17 -s BTY -t "1JeVN3q938vx8Pqcg7Kodmih8sWT5eQHHs" `  
由发送地址签名并发送。  
该交易需消耗1BTY为手续费。  

**该交易使目标地址的privacy合约中获得指定数额的代币。**  

可使用withdraw命令将这部分代币取回。  
`cli coins withdraw -a 17 -e privacy`
*** 
## 查询相关  

## showpai 根据地址查询隐私账户的信息  
`cli privacy showpai -a 1KoiQmaFg3DoZr84JehxrEWiR7SorSgbUx -s BTY -d 3`  
```
{
    "AvailableDetail": [
        {
            "Txhash": "0xef6269240bdae5bcdc8399844ab1791a5fead4441f3492e7c735f8ded359e32b",
            "Amount": "100.0000"
        }
    ],
    "AvailableAmount": "100.0000",
    "FrozenAmount": "0.0000",
    "TotalAmount": "100.0000"
}
```
-d为可选配置项：display mode.(0: display collect. 1:display available detail. 2:display frozen detail. 3:display all)  

## showau 查询UTOX的数量  
`cli privacy showau`  
```
{
    "amountDetail": [
        {
            "amount": 10,
            "count": 1
        },
        {
            "amount": 100,
            "count": 1
        }
    ]
}
```
## showutxo4a 根据指定金额查询钱包地址中的UTXO  

`cli privacy showutxo4a -a 100`  
```
[
    {
        "Txhash": "0xef6269240bdae5bcdc8399844ab1791a5fead4441f3492e7c735f8ded359e32b",
        "OnetimePubKey": "a0ca5d2d82233361ac82a3098d61e378069e134df5018827e8f138a4c0ba250d"
    }
]
```
  

## list_txs 查询钱包中指定地址的隐私交易  
`cli privacy list_txs  -a 1KoiQmaFg3DoZr84JehxrEWiR7SorSgbUx -c 1 -d 1`  
```
{
    "txDetails": [
        {
            "tx": {
                "execer": "privacy",
                "payload": {
                    "privacy2public": {
                        "tokenname": "BTY",
                        "amount": "1700000000",
                        "note": "",
                        "to": "1JeVN3q938vx8Pqcg7Kodmih8sWT5eQHHs",
                        "input": {
                            "keyinput": [
                                {
                                    "amount": "200000000",
                                    "utxoGlobalIndex": [
                                        {
                                            "txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                                            "outindex": 3
                                        },
                                        {
                                            "txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                                            "outindex": 2
                                        }
                                    ],
                                    "keyImage": "0xd1dcfeb83be78d4d6918a5cdceabdb1c11b9e9e10139c79a9b24c92879555f61"
                                },
                                {
                                    "amount": "1000000000",
                                    "utxoGlobalIndex": [
                                        {
                                            "txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                                            "outindex": 1
                                        },
                                        {
                                            "txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                                            "outindex": 6
                                        },
                                        {
                                            "txhash": "0x4bb6b0e7aee5edc559130ae261dd8523ccbd5ed87ccc65aa9b58bb90b2d4fe69",
                                            "outindex": 0
                                        }
                                    ],
                                    "keyImage": "0x8cf1bcde57e9a64b339f67d778f14da88581ddf4cb1bd180dd5c07645bf6cd68"
                                },
                                {
                                    "amount": "2000000000",
                                    "utxoGlobalIndex": [
                                        {
                                            "txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                                            "outindex": 5
                                        }
                                    ],
                                    "keyImage": "0x6199ac3df223f5b22f54326655b6f2d38db0d62ba09f3fc4590e643643d4ac8e"
                                }
                            ]
                        },
                        "output": {
                            "RpubKeytx": "0x04283fcf89fd6319bc8c7c14bc907b71a2e4d11d07effd5703ab2e47bb7fb23c",
                            "keyoutput": [
                                {
                                    "amount": "200000000",
                                    "onetimepubkey": "0x662c7df1a596aa9018986d946be3e9984c6188fc2620ffad622669c11280839c"
                                },
                                {
                                    "amount": "200000000",
                                    "onetimepubkey": "0xb3c2a28ac20f875bc2cc889c36b1e513f86c3b47d15cf3e9eb55de4f48814828"
                                },
                                {
                                    "amount": "1000000000",
                                    "onetimepubkey": "0x1236cbfd485981589752b20d30aa3c699203916cb4af34b147ff1b5e19f899d5"
                                }
                            ]
                        },
                        "assetExec": "coins"
                    },
                    "ty": 103
                },
                "rawpayload": " ",
                "signature": {
                    "ty": 5,
                    "pubkey": "0x731fb3ab7e47a046c3f927815d89497a93bf1d1e0631a35f1d1adfd3f9cff843",
                    "signature": " "
                },
                "fee": "1.0000",
                "expire": 1565601399,
                "nonce": 2234700166825889400,
                "to": "1FeyE6VDZ4FYgpK1n2okWMDAtPkwBuooQd",
                "from": "1FeyE6VDZ4FYgpK1n2okWMDAtPkwBuooQd",
                "hash": "0x6656dce3ef5a3ebcd012addc52bb1d6662f1581048989e291d6559c53f0b6d53"
            },
            "receipt": {
                "ty": 2,
                "tyName": "ExecOk",
                "logs": [
                    {
                        "ty": 2,
                        "tyName": "LogFee",
                        "log": {
                            "prev": {
                                "currency": 0,
                                "balance": "241300000000",
                                "frozen": "0",
                                "addr": "1FeyE6VDZ4FYgpK1n2okWMDAtPkwBuooQd"
                            },
                            "current": {
                                "currency": 0,
                                "balance": "241200000000",
                                "frozen": "0",
                                "addr": "1FeyE6VDZ4FYgpK1n2okWMDAtPkwBuooQd"
                            }
                        },
                        "rawLog": "0x0a2b10809ae7f48207222231466579453656445a34465967704b316e326f6b574d444174506b7742756f6f5164122b1080d88fc58207222231466579453656445a34465967704b316e326f6b574d444174506b7742756f6f5164"
                    },
                    {
                        "ty": 8,
                        "tyName": "LogExecDeposit",
                        "log": {
                            "execAddr": "1FeyE6VDZ4FYgpK1n2okWMDAtPkwBuooQd",
                            "prev": {
                                "currency": 0,
                                "balance": "0",
                                "frozen": "0",
                                "addr": "1JeVN3q938vx8Pqcg7Kodmih8sWT5eQHHs"
                            },
                            "current": {
                                "currency": 0,
                                "balance": "1700000000",
                                "frozen": "0",
                                "addr": "1JeVN3q938vx8Pqcg7Kodmih8sWT5eQHHs"
                            }
                        },
                        "rawLog": "0x0a2231466579453656445a34465967704b316e326f6b574d444174506b7742756f6f516412242222314a65564e337139333876783850716367374b6f646d6968387357543565514848731a2a1080e2cfaa062222314a65564e337139333876783850716367374b6f646d696838735754356551484873"
                    },
                    {
                        "ty": 501,
                        "tyName": "LogPrivacyInput",
                        "log": {
                            "keyinput": [
                                {
                                    "amount": "200000000",
                                    "utxoGlobalIndex": [
                                        {
                                            "txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                                            "outindex": 3
                                        },
                                        {
                                            "txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                                            "outindex": 2
                                        }
                                    ],
                                    "keyImage": "0xd1dcfeb83be78d4d6918a5cdceabdb1c11b9e9e10139c79a9b24c92879555f61"
                                },
                                {
                                    "amount": "1000000000",
                                    "utxoGlobalIndex": [
                                        {
                                            "txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                                            "outindex": 1
                                        },
                                        {
                                            "txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                                            "outindex": 6
                                        },
                                        {
                                            "txhash": "0x4bb6b0e7aee5edc559130ae261dd8523ccbd5ed87ccc65aa9b58bb90b2d4fe69",
                                            "outindex": 0
                                        }
                                    ],
                                    "keyImage": "0x8cf1bcde57e9a64b339f67d778f14da88581ddf4cb1bd180dd5c07645bf6cd68"
                                },
                                {
                                    "amount": "2000000000",
                                    "utxoGlobalIndex": [
                                        {
                                            "txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                                            "outindex": 5
                                        }
                                    ],
                                    "keyImage": "0x6199ac3df223f5b22f54326655b6f2d38db0d62ba09f3fc4590e643643d4ac8e"
                                }
                            ]
                        },
                        "rawLog": " "
                    },
                    {
                        "ty": 502,
                        "tyName": "LogPrivacyOutput",
                        "log": {
                            "RpubKeytx": "0x425459",
                            "keyoutput": [
                                {
                                    "amount": "200000000",
                                    "onetimepubkey": "0x662c7df1a596aa9018986d946be3e9984c6188fc2620ffad622669c11280839c"
                                },
                                {
                                    "amount": "200000000",
                                    "onetimepubkey": "0xb3c2a28ac20f875bc2cc889c36b1e513f86c3b47d15cf3e9eb55de4f48814828"
                                },
                                {
                                    "amount": "1000000000",
                                    "onetimepubkey": "0x1236cbfd485981589752b20d30aa3c699203916cb4af34b147ff1b5e19f899d5"
                                }
                            ]
                        },
                        "rawLog": "0x0a034254591227088084af5f1220662c7df1a596aa9018986d946be3e9984c6188fc2620ffad622669c11280839c1227088084af5f1220b3c2a28ac20f875bc2cc889c36b1e513f86c3b47d15cf3e9eb55de4f488148281228088094ebdc0312201236cbfd485981589752b20d30aa3c699203916cb4af34b147ff1b5e19f899d5"
                    }
                ]
            },
            "height": 2995030,
            "index": 1,
            "blocktime": 1565600804,
            "amount": "0.0000",
            "fromaddr": "1KoiQmaFg3DoZr84JehxrEWiR7SorSgbUx",
            "txhash": "0x6656dce3ef5a3ebcd012addc52bb1d6662f1581048989e291d6559c53f0b6d53",
            "actionname": "Privacy2Public"
        }
    ]
}
```
部分可选参数：  
`cli privacy list_txs -h`  
```
Flags:
  -a, --addr string         account address
  -c, --count int32         number of transactions, default 10 (default 10)
  -d, --direction int32     query direction (0: pre page, 1: next page), valid with seedtxhash param (default 1)
  -h, --help                help for list_txs
      --seedtxhash string   seed trasnaction hash
      --sendrecv int32      send or recv flag (0: send, 1: recv), default 0
      --token string        token name.(BTY supported) (default "BTY")
```
提供了-c查询数量，-d查询方向，指定起始查询哈希，指定发送或接收，指定查询symbol等配置项。  
该命令需有UTXO花费产生后可用。  


## showpas 查询指定地址的UTXO花费情况  
`cli privacy showpas -a "1KoiQmaFg3DoZr84JehxrEWiR7SorSgbUx" -s BTY`  
```
Total Privacy spend amount is 132.0000
[
    {
        "Txhash": "6656dce3ef5a3ebcd012addc52bb1d6662f1581048989e291d6559c53f0b6d53",
        "Spend": [
            {
                "Txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                "OutIndex": 3,
                "Amount": "2.0000"
            },
            {
                "Txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                "OutIndex": 6,
                "Amount": "10.0000"
            },
            {
                "Txhash": "0xcc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
                "OutIndex": 5,
                "Amount": "20.0000"
            }
        ]
    },
    {
        "Txhash": "cc439a6049f44146522dad7dd8943d6b1d63ecef68d41497fa5dc9c323dc5b25",
        "Spend": [
            {
                "Txhash": "0xef6269240bdae5bcdc8399844ab1791a5fead4441f3492e7c735f8ded359e32b",
                "Amount": "100.0000"
            }
        ]
    }
]
```
该命令需有UTXO花费产生后可用。  

## rescanOpt 指定地址加载隐私UTXO  
`cli privacy rescanOpt -a all -f 0`  
```
"start rescan UTXO"  
```  
-f为0，指定地址开始加载导入地址的UTXO  
`cli privacy rescanOpt -a all -f 1`  
```
{
    "ShowRescanResults": [
        {
            "addr": "19S9wG9wgS2RhtZm1B5Zr24vexGYYK6QC7",
            "FlagString": "UtxoFlagNoScan"
        },
        {
            "addr": "1F5VPf3w2L3HEYoXP9g7TJNqyhCTUZZPmQ",
            "FlagString": "UtxoFlagNoScan"
        },
        {
            "addr": "1KoiQmaFg3DoZr84JehxrEWiR7SorSgbUx",
            "FlagString": "UtxoFlagNoScan"
        }
    ]
}
```
-f为1，显示目前地址的加载情况。 
***

  
## para 跨链合约  
使用para合约时，需先搭建一条平行链。参考平行链搭建文档完成搭建。以下以搭建的game链完成示例。  

`cli para -h`  
```
Available Commands:
  asset_transfer Create a asset transfer to para-chain transaction
  asset_txinfo   Get para chain cross asset transfer info
  asset_withdraw Create a asset withdraw to para-chain transaction
  blocks         Get blocks with main chain hash map between [start, end], the same in main
  buffer_block   Get para download-level block info
  config         parachain config cmd
  consens_done   Get para chain done height consensus info
  consens_status Get para chain heights' consensus status
  cross_transfer Create a cross asset transfer transaction
  height         query consensus height
  is_sync        query parachain is sync
  nodegroup      super node group manage cmd
  para_list      Get para chain info list by titles
  super_node     super node manage cmd
  transfer       Create a transfer transaction
  transfer_exec  Create a transfer to exec transaction
  withdraw       Create a withdraw transaction

```
***  
## asset_transfer 资产转移  
进行para资产转移前需在paracross合约中存有足额的资产。  
`cli para asset_transfer --paraName user.p.game. -a 10 -n test -t 12HKLEn6g4FH39yUbHh4EVJWcFo5CXg22d`  
签名并完成发送。  

paraName为目标平行链的标题，注意格式为最后有一点。-s后为资产标志，缺省为bty。

通过调用平行链的余额查询，查询余额。  
`cli asset balance -a 12HKLEn6g4FH39yUbHh4EVJWcFo5CXg22d --asset_exec paracross --asset_symbol coins.bty -e paracross --rpc_laddr="http://114.55.11.139:1195"`  
```
{
    "balance": "10.0000",
    "frozen": "0.0000",
    "addr": "12HKLEn6g4FH39yUbHh4EVJWcFo5CXg22d"
}
```
若未编译指定平行链专用的cli，因cli默认调用8801端口，需在调用时指定具体的调用端口，由--rpc_laddr= 指定。  
跨链转入的bty存在paracross合约中，名称更改为了coins.bty的格式。若转移的是主链token，则名称相应的为token.xxx  


## asset_txinfo 根据哈希查询资产转移交易  
`cli para asset_txinfo -s 0x82eebee5ad865f42c71794b7842d5cab777f4f01267e4be3d40f3859dfae6f23`
```
{
    "from": "19kCYYJnvdsXLUxY5DqKL3yCiweNMzeMxE",
    "to": "1B1qDTmQYF48aARKeGY7PNsQtg8nznPp6B",
    "txHash": "0x82eebee5ad865f42c71794b7842d5cab777f4f01267e4be3d40f3859dfae6f23",
    "amount": 100000000,
    "exec": "coins",
    "symbol": "BTY",
    "height": 4753337,
    "commitDoneHeight": 4753339,
    "paraHeight": 3506,
    "success": true
}
```

## asset_withdraw 取回资产 
进行平行链资产取回前，需在平行链的paracross合约中有足额的备转移资产。   
`cli para asset_withdraw -a 1 --ptitle user.p.game. -t 1xUdxvnZoBpnWwnUSuNQN9ts3mWi1MZrc`
签名并发送。  
从平行链取回一样需要输入指定的ptitle。取回后的资产存放于paracross合约中。  
执行平行链资产取回，需要对应的平行链开启共识。未开启共识的平行链无法取回。  

## blocks 根据高度返回获取平行链和对应主链区块哈希  
`cli para blocks -e 10000 -s 9999 --rpc_laddr="http://114.55.11.139:1195"`  
```
{
    "items": [
        {
            "height": 9999,
            "blockHash": "0x69d1fe567f5f72397bc85f9547697f358e4c499a24b4aa86ceed0b59f03a1a0a",
            "mainHeight": 3847377,
            "mainHash": "0x882086a3324a2046755b53d6c0426c7087aa8c58728947e7cdd6846f1baf0e9d"
        },
        {
            "height": 10000,
            "blockHash": "0x9559671bdfbbc876eba722449f5a64d457b9f462db9af2a16d9d55da51201211",
            "mainHeight": 3847577,
            "mainHash": "0x7ef088ccb85b775f5482f47ee35e37ec93a99c766c4f325258b097cccb81db0a"
        }
    ]
}
```
调用时需调用对应平行链端口。返回信息中返回平行链及主链的对应高度和区块哈希。  

## buffer_block 根据高度获取指定平行链区块的信息  
`cli para buffer_block -t -1 --rpc_laddr="http://114.55.11.139:1195"`   
```
{
    "height": 11472,
    "mainHash": "0x9a990c48aaf76409dd0f8c9eb6b6bf4356eb32494906f80e6d8521d4c055a88a",
    "mainHeight": 3981201,
    "parentMainHash": "0x567d344f3be247c13c70d8212459f53b5f8d8356189a6092cdccd366913a1898",
    "blockTime": 1574306182,
    "txs": [
        "0xccfa6a51a8d29beb27c24e1b533ee6e82f179f3aa594ca0d22e263ec4478ab51",
        "0x8f80fe47b42039339fe5d43cb275f303053095edf6449e62a515e741f3f4f7c8",
        "0x3b6695b7189f907ef63877b5e6736898ca16748db1e835c601810f9302a213b1",
        "0x9c63c65c912a8e05d9945ab87182d6e76231b45366416ae090989fadeea012f7",
        "0x5ef453dfd914c7f1b5341b4fe4bc8841cddf50fc809f03e57b98c6c01061f810",
        "0xeafb4b6aa67e3915383d4a017ed65020850f19082561ccda3da644569c447215",
        "0x89e4825d05aa72160b054ee98905d8a8b58cfb7749f9371bebb41266a18f1311",
        "0xc3dcb74d9bb3c4c473134e65b46654f33233fcfb09d082170055e624dc195188",
        "0x557ee0e9a461e1354fc5a2aff5cd2bc34fc1301f42aad5cbd76789546b67f67b",
        "0xac48f9c5c8ef047f39b197f075e9c39dda3f5c1bea19392d7ee0995d93b14f51",
        "0x314d3e212c403de04eb5374df1dbe0cdd7bb500c59d04f8899f8ac4a3072bac0",
        "0xec73cc9e128101bc2c0c8a44311906c25c61cc6df4090fef7d894e7f3dec56c9"
    ]
}
```
-t为指定平行链高度，-1代表最新高度。 

## config 配置 
平行链配置项，目前只支持自共识配置。  
`cli para config stages -h `  
```
Available Commands:
  all         Get para chain self consensus stages
  cancel      cancel for config cmd
  new         apply for para chain's self consensus stages cmd
  one         query para chain one self consensus stage
  query       show self consensus stage apply info
  vote        vote for config cmd
```  
需在平行链已配置超级节点后可使用。  

## height 查询当前平行链的链高度及共识高度  
`cli para height --rpc_laddr="http://114.55.11.139:1195"`  
```
{
    "title": "user.p.game.",
    "chainHeight": 11497,
    "consensHeight": 11495,
    "consensBlockHash": "0x1e6e2099752d9f80d8295542aef6404711324198ed2988f29687af0d06830c0a"
}
```

## consens_status 根据高度查询平行链共识状态  
`cli para consens_status -g 10000  --paraName user.p.game.`  
```
{
    "status": 1,
    "title": "user.p.game.",
    "height": 10000,
    "mainHeight": 3847577,
    "mainHash": "0x7ef088ccb85b775f5482f47ee35e37ec93a99c766c4f325258b097cccb81db0a",
    "commitAddrs": [
        "1JRNjdEqp4LJ5fqycUBm9ayCKSeeskgMKR",
        "1KSBd17H7ZK8iT37aJztFB22XGwsPTdwE4",
        "1MCftFynyvG2F4ED5mdHYgziDxx6vDrScs"
    ],
    "commitBlockHash": [
        "0x9559671bdfbbc876eba722449f5a64d457b9f462db9af2a16d9d55da51201211",
        "0x9559671bdfbbc876eba722449f5a64d457b9f462db9af2a16d9d55da51201211",
        "0x9559671bdfbbc876eba722449f5a64d457b9f462db9af2a16d9d55da51201211"
    ]
}
```
注意这里需要输入的是paraName这个参数。  

## is_sync 查询当前平行链是否同步至最高  
`cli para is_sync --rpc_laddr="http://114.55.11.139:1195"`  
返回true or false。  


## nodegroup 平行链超级节点相关配置  
后面详述超级节点相关操作及配置。  

## para_list 查询当前主链下所有开启共识的平行链相关信息  
`cli para para_list`  
```
{
    "titles": [
        {
            "totalNodes": 4,
            "totalCommit": 3,
            "mostSameCommit": 3,
            "title": "user.p.game.",
            "height": 11498
        },
        {
            "totalNodes": 1,
            "totalCommit": 1,
            "mostSameCommit": 1,
            "title": "user.p.issuance.",
            "height": 6063
        },
        {
            "totalNodes": 5,
            "totalCommit": 4,
            "mostSameCommit": 4,
            "title": "user.p.magic.",
            "height": 1802,
            "txResult": "3166"
        },
        {
            "totalNodes": 4,
            "totalCommit": 3,
            "mostSameCommit": 3,
            "title": "user.p.para.",
            "height": 89778
        },
        {
            "totalNodes": 1,
            "totalCommit": 1,
            "mostSameCommit": 1,
            "title": "user.p.testuwallet.",
            "height": 11572
        }
    ]
}
```

## super_node 超级节点相关配置  
后面详述超级节点相关配置。  

## transfer 转账  
para转账是将平行链paracross中的资产转移到其他地址。  
`cli para transfer  -a 1.1 -s coins.bty -t 1Ka7EPFRqs3v9yreXG6qA4RQbNmbPJCZPj --rpc_laddr="http://114.55.11.139:1195"`  
可通过资产查询接口查看余额。  
`cli asset balance -a 1Ka7EPFRqs3v9yreXG6qA4RQbNmbPJCZPj --asset_exec paracross --asset_symbol coins.bty -e paracross --rpc_laddr="http://114.55.11.139:1195"`  
```
{
    "balance": "1.1000",
    "frozen": "0.0000",
    "addr": "1Ka7EPFRqs3v9yreXG6qA4RQbNmbPJCZPj"
}
```
## transfer_exec 向执行器转账  
同主链一样，向具体的执行器转账。  
`cli send para transfer_exec -a 0.2 -e trade -s coins.bty  --rpc_laddr="http://114.55.11.139:1195"`  
查询余额  
`cli asset balance -a 12HKLEn6g4FH39yUbHh4EVJWcFo5CXg22d --asset_exec paracross --asset_symbol coins.bty -e trade --rpc_laddr="http://114.55.11.139:1195"`  
```
{
    "balance": "0.2000",
    "frozen": "0.0000",
    "addr": "12HKLEn6g4FH39yUbHh4EVJWcFo5CXg22d"
}
```

## withdraw 取回资产  
同主链一样，从具体的执行器取回资产到paracross合约。  
`cli para withdraw -a 0.1 -s coins.bty -e trade  --rpc_laddr="http://114.55.11.139:1195"`  

***  
## node 平行链超级节点相关  
配置平行链超级节点，需要在配置文件中配置挖矿地址：  
#验证账户，验证节点需要配置自己的账户，并且钱包导入对应种子，非验证节点留空   
authAccount="1KSBd17H7ZK8iT37aJztFB22XGwsPTdwE4"  

超级节点组申请：  
nodegroup相关命令：  
`cli para nodegroup -h`  
```
Available Commands:
  addrs       Query super node group's current addrs by title
  apply       apply for para chain's super node group
  approve     approve for para chain's super node group application
  list        query super node group apply list by status
  modify      modify for para chain's super node group parameters
  quit        quit for para chain's super node group application
  status      query super node group apply status by title
```

## apply 申请超级节点账户组  
平行链开链后，需要申请第一批超级节点账户组。  
`cli para nodegroup apply -a 13H84ZwW36bHqvxTrSENmFaa5zqsfBL8Fn -c 0 --paraName user.p.tank. --rpc_laddr="http://localhost:8901"`  
-c为申请超级节点抵押的主链币数量，需大于等于后续审批阶段要求的数量。目前可以设置为0。
-a后为申请的账户组地址，多个时用,分隔。  

## list 查询超级节点账户组申请状态  
`cli para nodegroup list -s 1`  
```
{
    "ids": [
        {
            "id": "0xefdb14372362d382592d7e1ea0ee3460d0a9122301dda171c26a9128747bd334",
            "status": 1,
            "title": "user.p.tank.",
            "targetAddrs": "13H84ZwW36bHqvxTrSENmFaa5zqsfBL8Fn",
            "fromAddr": "13H84ZwW36bHqvxTrSENmFaa5zqsfBL8Fn",
            "height": 4140014
        }
    ]
}
```
-s后为申请状态，status:1:apply,2:approve,3:quit，根据状态查询  

## quit 取消超级节点账户组申请  
`clip para nodegroup quit -i 0xefdb14372362d382592d7e1ea0ee3460d0a9122301dda171c26a9128747bd334  --rpc_laddr="http://localhost:8901" --paraName user.p.tank.`  
根据查询得到的申请id来取消申请。  

## modify 修改超级节点账户组申请的抵押金额  
`cli para nodegroup modify -c 1 --rpc_laddr="http://localhost:8901" --paraName user.p.super.`  


## approve 审批超级节点账户组申请  
`cli para nodegroup approve -c 0 --id 0x937e04945863ebf6241bef20e19e4d1ceb014a7235ce97725b3abf1137535786  --rpc_laddr="http://localhost:8901" --paraName user.p.tank.`  
针对id进行审批。-c为抵押的主链币数量，申请者不能低于该数量。签名需由管理员签名完成。因为该交易需在主链和平行链都执行成功，所以该管理员需在主链和平行链都配置。  

查询完成申请的超级节点状态：  
`cli para nodegroup list -s 2`  
```
{
    "ids": [
        {
            "id": "0x215d2184e8709caf6a2a11aa4d1de55337e1eef83297a60259dbe627ddb312af",
            "status": 2,
            "title": "user.p.magic.",
            "targetAddrs": "1Prx7vUMqqhWN6iaE4iijdxKZbAwLzfweC,1KpZCQqZF1mNAghWUmC3Y7FR9Uoa8gj3XK",
            "coinsFrozen": 1000000000,
            "fromAddr": "1Prx7vUMqqhWN6iaE4iijdxKZbAwLzfweC",
            "height": 1850156
        },
        {
            "id": "0x886a5c040e99fd3783f7ca2b38367809a50b33d0c8a52970ce56001fed2cb144",
            "status": 2,
            "title": "user.p.super.",
            "targetAddrs": "13H84ZwW36bHqvxTrSENmFaa5zqsfBL8Fn",
            "fromAddr": "13H84ZwW36bHqvxTrSENmFaa5zqsfBL8Fn",
            "height": 4141281
        },
        {
            "id": "0x937e04945863ebf6241bef20e19e4d1ceb014a7235ce97725b3abf1137535786",
            "status": 2,
            "title": "user.p.tank.",
            "targetAddrs": "13H84ZwW36bHqvxTrSENmFaa5zqsfBL8Fn",
            "fromAddr": "13H84ZwW36bHqvxTrSENmFaa5zqsfBL8Fn",
            "height": 4140879
        }
    ]
}
```

## addrs 根据平行链名称查询超级节点账户组  
`cli para nodegroup addrs --paraName user.p.super.`  
```
{
    "key": "mavl-paracross-nodes-title-user.p.super.",
    "value": "[13H84ZwW36bHqvxTrSENmFaa5zqsfBL8Fn]"
}
```

## status 根据平行链名称查询超级节点账户组状态 
`cli para nodegroup status --paraName user.p.super.`  
```
{
    "id": "0x886a5c040e99fd3783f7ca2b38367809a50b33d0c8a52970ce56001fed2cb144",
    "status": 2,
    "title": "user.p.super.",
    "targetAddrs": "13H84ZwW36bHqvxTrSENmFaa5zqsfBL8Fn",
    "fromAddr": "13H84ZwW36bHqvxTrSENmFaa5zqsfBL8Fn",
    "height": 4141281
}
```

超级节点操作：  
`cli para super_node -h`  
``` 
Available Commands:
  addr_status Get node current status:10:joined,11:quited from nodegroup
  cancel      super node cancel join or quit action by id cmd
  id_list     Get node apply id list info by status
  id_status   Get node id current vote status:1:joining,2:quiting,3:closed,4:canceled
  join        super node apply for join nodegroup cmd
  quit        super node apply for quit nodegroup cmd
  vote        nodegroup nodes vote for new join node cmd
```

## addr_status 根据地址查询地址在超级节点组的状态  
`cli para super_node addr_status -a 13H84ZwW36bHqvxTrSENmFaa5zqsfBL8Fn --paraName user.p.super.`  
```
{
    "addr": "13H84ZwW36bHqvxTrSENmFaa5zqsfBL8Fn",
    "proposalId": "0x886a5c040e99fd3783f7ca2b38367809a50b33d0c8a52970ce56001fed2cb144-0",
    "status": 10,
    "title": "user.p.super."
}
```
其中：  
status:10:joined,11:quited  

## join 申请加入超级节点组  
`cli para super_node join -a 1EKWC81hrPFPK3rfGiD4g9cQ1o9ohR62Sa -c 0 --rpc_laddr="http://localhost:8901" --paraName user.p.super.`  
-c同上，为超级节点抵押的主链币，可设为0。  

## id_list 根据状态查询超级节点申请信息 
`cli para super_node id_list -s 1 --paraName user.p.super.`  
```
{
    "ids": [
        {
            "id": "0x1eafc50600d4dab5e941f6761b1a685c2991bc1ba63471ecb7a34397b9c31405",
            "status": 1,
            "title": "user.p.super.",
            "targetAddr": "1EKWC81hrPFPK3rfGiD4g9cQ1o9ohR62Sa",
            "votes": {},
            "fromAddr": "1EKWC81hrPFPK3rfGiD4g9cQ1o9ohR62Sa",
            "height": 4153693
        }
    ]
}
```
-s为指定的status:0:all,1:joining,2:quiting,3:closed,4:canceled  

## id_status  根据id查询超级节点申请信息  
`cli para super_node id_status --id 0x1eafc50600d4dab5e941f6761b1a685c2991bc1ba63471ecb7a34397b9c31405 --paraName user.p.super.`  
```
{
    "id": "0x1eafc50600d4dab5e941f6761b1a685c2991bc1ba63471ecb7a34397b9c31405",
    "status": 1,
    "title": "user.p.super.",
    "targetAddr": "1EKWC81hrPFPK3rfGiD4g9cQ1o9ohR62Sa",
    "votes": {},
    "fromAddr": "1EKWC81hrPFPK3rfGiD4g9cQ1o9ohR62Sa",
    "height": 4153693
}
```

## cancel 取消申请加入或退出  
`cli para super_node cancel -i 0x1eafc50600d4dab5e941f6761b1a685c2991bc1ba63471ecb7a34397b9c31405  --rpc_laddr="http://localhost:8901" --paraName user.p.super.`  
可以取消join加入和quit退出的申请。  

## vote 对申请加入的账号投票  
`cli para super_node vote -v 1 -i 0xa64bb366b1bea81814e844b149379b339a743cc01d0074545dfc98e5d2d8ec63  --rpc_laddr="http://localhost:8901" --paraName user.p.super.`  
-v为投票的值，1位赞成，2为反对。  
投票需由超级节点账户组内地址完成。  

## quit 退出超级节点账户组申请   
`cli para super_node quit -a 1EKWC81hrPFPK3rfGiD4g9cQ1o9ohR62Sa  --rpc_laddr="http://localhost:8901" --paraName user.p.super.`
可以由任何地址提出，由超级节点账户组进行投票。  

***  
配置相关  
## config   
`cli para config stages -h`  
```
Available Commands:
  all         Get para chain self consensus stages
  cancel      cancel for config cmd
  new         apply for para chain's self consensus stages cmd
  one         query para chain one self consensus stage
  query       show self consensus stage apply info
  vote        vote for config cmd
```
目前支持自共识查询  
















