简介

iriscli 是IRIShub网络的命令行客户端。IRIShub用户可以使用iriscli发送交易和查询区块链数据。

工作目录

iriscli 默认工作目录是 $HOME/.iriscli,主要用于保存配置文件和数据。IRIShub “密钥”数据保存在iriscli的工作目录中。您还可以通过--home指定iriscli的工作目录。

连接全节点

--node用来指定所连接iris节点的rpc地址,交易和查询的消息都发送到监听这个端口的iris进程。默认值为tcp://localhost:26657

设置默认配置

iriscli config 命令可以交互式地配置一些公共参数的默认值,例如chain-id,home,fee 和 node。完成配置后,后续的iriscli命令可以省略对这些flag参数的指定。

$ iriscli config
> Where is your iriscli home directory? (Default: ~/.iriscli)
/root/my_cli_home
> Where is your validator node running? (Default: tcp://localhost:26657)
tcp://192.168.0.1:26657
Do you trust this node? [y/n]:y
> What is your chainID?
irishub
> Please specify default fee
0.3iris

全局标识

GET 请求

所有GET请求都有以下全局标识:

名称,速记 类型 必需 默认值 描述
--chain-id string "" tendermint节点的Chain ID
--height int 0 查询某个高度的区块链数据,如果是0,则返回最新的区块链数据
--help, -h string 打印帮助信息
--output string text 指定返回的格式 text或者json
--indent bool false 格式化json字符串
--ledger bool false 使用ledger设备
--node string tcp://localhost:26657 tendermint节点的rpc地址
--trust-node bool true 是否信任全节点返回的数据,如果不信任,客户端会验证查询结果的正确性

POST 请求

所有POST请求都有以下全局标识:

名称,速记 类型 必需 默认值 描述
--account-number int false 0 发起交易的账户的编号
--async bool false false 是否异步广播交易(不对交易进行任何验证,立即返回交易的hash,仅当commit为false时有效)
--commit bool false false 广播交易并等到交易被打包再返回
--chain-id string true "" tendermint节点的Chain ID
--dry-run bool false false 模拟执行交易,并返回消耗的gas--gas指定的值会被忽略
--fee string true "" 交易费(指定交易费的上限)
--from string false "" 发送交易的账户名称
--from-addr string false "" 签名地址,在generate-onlytrue的情况下有效
--gas int false 50000 交易的gas上限; 设置为"simulate"将自动计算相应的阈值
--gas-adjustment int false 1.5 gas调整因子,这个值降乘以模拟执行消耗的gas,计算的结果返回给用户; 如果--gas的值不是simulate,这个标志将被忽略
--generate-only bool false false 是否仅仅构建一个未签名的交易便返回
--help, -h string false 打印帮助信息
--indent bool false false 格式化json字符串
--json string false false 指定返回结果的格式,json或者text
--ledger bool false false 使用ledger设备
--memo string false "" 指定交易的memo字段
--node string false tcp://localhost:26657 tendermint节点的rpc地址
--print-response bool false false 是否打印交易返回结果,仅在async为true的情况下有效
--sequence int false 0 发起交易的账户的sequence
--trust-node bool false true 是否信任全节点返回的数据,如果不信任,客户端会验证查询结果的正确性

模块命令列表

子命令 描述
status 查询远程节点的状态
tx Tx子命令
tendermint Tendermint状态查询子命令
bank 用于查询帐户和转账等的Bank子命令
distribution 收益管理子命令
gov 治理和投票子命令
stake Staking 子命令
upgrade 软件升级子命令
service 服务子命令
guardian 特殊账户子命令
asset 资产管理子命令
rand 随机数子命令
keys 密钥管理子命令
params 查询治理参数子命令