Pier命令行¶
pier命令有多组子命令，其作用是与应用链或中继链交互，pier命令描述如下：
NAME:
Pier - Manipulate the crosschain node
USAGE:
pier [global options] command [command options] [arguments...]
VERSION:
0.0.0
COMMANDS:
appchain Command about appchain in bitxhub
client Command about appchain in pier
id Get appchain id
init Initialize pier local configuration
interchain Query interchain info
p2p Command about p2p
rule Command about rule
start Start a long-running daemon process
version Show version about ap
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--repo value Pier repository path
--tls enable tls between pier and bitxhub or not
--help, -h show help
--version, -v print the version
参数解释¶
--repo：可选参数，指定pier节点配置文件所在目录，如果不指定，默认使用$HOME/.bitxhub目录。--tls：可选参数，用于pier节点与bitxhub进行tls加密传输。如果不指定，默认为false。
GLOBAL OPTIONS:
--repo value Pier repository path
--tls enable tls between pier and bitxhub or not
--help, -h show help
--version, -v print the version
子命令描述¶
pier appchain¶
pier appchain命令用于中继模式下，跨链网关Pier向中继链bitXHub实现应用链相关信息的注册、更新、变更等操作。
用法¶
NAME:
Pier appchain - Command about appchain in bitxhub
USAGE:
Pier appchain command [command options] [arguments...]
COMMANDS:
register Register appchain in bitxhub
update update appchain in bitxhub
freeze freeze appchain in bitxhub
activate activate appchain in bitxhub
logout logout appchain in bitxhub
get Get appchain info
OPTIONS:
--help, -h show help
具体描述¶
pier appchain具体描述与使用示例参考中继模式管理。
pier client¶
pier client命令用于直连模式的应用链管理。
用法¶
NAME:
Pier client - Command about appchain in pier
USAGE:
Pier client command [command options] [arguments...]
COMMANDS:
register Register appchain in pier
update Update appchain in pier
audit Audit appchain in pier
get Get appchain info
rule register appchain validation rule
OPTIONS:
--help, -h show help
具体描述¶
pier appchain具体描述与使用示例参考直连模式管理。
pier id¶
pier id命令用于获取所绑定的应用链地址。
用法¶
具体描述¶
样例：
pier init¶
pier init命令用于初始化pier相关配置。如生成公私钥、ca证书等。
用法¶
具体描述¶
样例：
# 初始化pier1相关配置，配置文件目录为$HOME/.pier1
$ pier --repo $HOME/.pier1 init
├── api //直连模式下的api信息
├── certs
│ └── ca.pem
├── key.json
├── node.priv
└── pier.toml
pier interchain¶
pier interchain命令用于查询应用链的跨链交易信息。
用法¶
NAME:
Pier interchain - Query interchain info
USAGE:
Pier interchain command [command options] [arguments...]
COMMANDS:
ibtp Query ibtp by id
OPTIONS:
--key value Specific key.json path
--help, -h show help
具体描述¶
参数解释
--key：必选参数指定pier的key.json文件。
子命令
样例：
pier --repo $HOME/.pier1 interchain --key $HOME/.pier1/key.json ibtp --id 0xfF8199Fae48C808b45667DA0CcaAEe839B1a10Cb-0x23Fb0E7eF676467563d37D820F1b1Fddb0f9a2E1-1
# 控制台输出
INFO[16:52:41.917] Establish connection with bitxhub localhost:60013 successfully module=rpcx
Tx hash: 0x82d3434e0a295B22A8e55884FEdd137d19e8cBDc32d5B593AD6D9AFB5cf59600
tx:<from:<RawAddress:[255 129 153 250 228 140 128 139 69 102 125 160 204 170 238 131 155 26 16 203] Address:"" > to:<RawAddress:[0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 10] Address:"" > timestamp:1638435054429909000 transaction_hash:<RawHash:[130 211 67 78 10 41 91 34 168 229 88 132 254 221 19 125 25 232 203 220 50 213 181 147 173 109 154 251 92 245 150 0] Hash:"" > IBTP:<from:"0xfF8199Fae48C808b45667DA0CcaAEe839B1a10Cb" to:"0x23Fb0E7eF676467563d37D820F1b1Fddb0f9a2E1" index:1 timestamp:1638435054428680000 proof:"k\206\262s\3774\374\341\235k\200N\377Z?WG\255\244\352\242/\035I\300\036R\335\267\207[K" payload:"\022\221\001\n*0x5bFe03Dbd09817d4957693f672cc31A133Bb6084\022*0xA5dD12E27Ee5E79cE0B50adb376414351C8eea5f\032\020interchainCharge\"\001A\"\001B\"\002102\000:\022interchainRollbackB\001AB\00210" > nonce:4 signature:"T)\313\333~\316f\372.\010\235\234\222J\314@<\202\260\243\367b\035\016\366\326y\3515\020\222\256$\010\314\035/\271H\217|~\302\233\353b\275\267ir\t\242\376\224\307q\217l\232\037DP\n\317\000" extra:"1" > tx_meta:<block_hash:"\326{90^\355a\236\342\235i\302\374+\352VI\030\242\211\335x\371w\221>(\254%o\212\222" block_height:14 >
pier p2p¶
pier p2p命令用于直连模式下pier网络通信的pid。
用法¶
NAME:
Pier p2p - Command about p2p
USAGE:
Pier p2p command [command options] [arguments...]
COMMANDS:
id get pier unique id in p2p network
具体描述¶
样例：
# 初始化pier1相关配置，配置文件目录为$HOME/.pier1
$ pier --repo $HOME/.pier1 p2p id
#控制台输出
QmNpQvh8Lm7gwt3sDqwJ1pgNn6taJLqdgtRVyZWhsD5bND
pier rule¶
pier rule命令用于中继模式下pier向中继链部署应用链验证规则。
用法¶
NAME:
Pier rule - Command about rule
USAGE:
Pier rule command [command options] [arguments...]
COMMANDS:
deploy Deploy validation rule
具体描述¶
pier rule具体描述与使用示例参考直连模式管理的部署验证规则模块。
pier start¶
pier start命令用于启动pier。
用法¶
具体描述¶
样例：
$ pier --repo $HOME/.pier1 start
# 控制台输出
Pier version: dev-release-1.6-1b5b79f
App build date: 2021-12-01T17:50:14
System version: darwin/amd64
Golang version: go1.15.13
INFO[17:07:29.150] Establish connection with bitxhub localhost:60013 successfully module=app
2021-12-02T17:07:29.171+0800 [DEBUG] plugin: starting plugin: path=/bin/sh args="[sh -c /Users/liruoxin/testRelay/release1.6/eth1/plugins/eth-client]"
2021-12-02T17:07:29.178+0800 [DEBUG] plugin: plugin started: path=/bin/sh pid=74023
2021-12-02T17:07:29.178+0800 [DEBUG] plugin: waiting for RPC address: path=/bin/sh
2021-12-02T17:07:29.283+0800 [DEBUG] plugin.sh: 2021-12-02T17:07:29.283+0800 [DEBUG] client: plugin address: network=unix address=/var/folders/xr/pnhf9j6n2k5_fysm6s0xkgt00000gn/T/plugin718241634
2021-12-02T17:07:29.283+0800 [DEBUG] plugin: using plugin: version=4
2021-12-02T17:07:29.284+0800 [TRACE] plugin.stdio: waiting for stdio data
2021-12-02T17:07:29.287+0800 [DEBUG] plugin.sh: 2021-12-02T17:07:29.287+0800 [INFO ] client: Basic appchain info: broker address=0xFb23Af09e3E8D83fd5575De9558920Bf351F05E8 ethereum node ip=ws://127.0.0.1:8546
2021-12-02T17:07:29.416+0800 [DEBUG] plugin.sh: 2021-12-02T17:07:29.416+0800 [INFO ] client: ContractABI: addr=0x5bfe03dbd09817d4957693f672cc31a133bb6084 name=transfer.abi
Client Type: ethereum
Pprof on localhost:44555
…………
pier version¶
pier version命令用于查询版本号。
用法¶
具体描述¶
样例：