查询¶
针对区块、交易、链参数和资源价格、当前网络、已连接节点,以及 USDT 余额的只读查询。
接受显式地址的查询一般无需鉴权。省略地址时默认作用于当前钱包的查询则需要鉴权:get-address 始终
上报活动钱包(因而始终需要鉴权),而 get-balance 和 get-usdt-balance 仅在未提供 --address
时需要鉴权。
账户、质押/资源、资产、合约、见证人和提案相关的查询位于各自的页面 (账户、质押与资源、TRC-10 资产、 智能合约、治理)。
网络与链¶
当前网络 —— current-network / CurrentNetwork¶
显示客户端当前连接的网络(MAIN、NILE、SHASTA 或 CUSTOM)。
java -jar build/libs/wallet-cli.jar --network nile current-network
CurrentNetwork
链参数 —— get-chain-parameters / GetChainParameters¶
返回链上治理参数及其当前取值。
java -jar build/libs/wallet-cli.jar --network nile get-chain-parameters
GetChainParameters
下次维护时间 —— get-next-maintenance-time / GetNextMaintenanceTime¶
返回下一个维护周期的时间戳(毫秒),即 SR/投票变更生效的时刻。
java -jar build/libs/wallet-cli.jar --network nile get-next-maintenance-time
GetNextMaintenanceTime
带宽价格 —— get-bandwidth-prices / GetBandwidthPrices¶
返回历史带宽价格表。
java -jar build/libs/wallet-cli.jar --network nile get-bandwidth-prices
GetBandwidthPrices
能量价格 —— get-energy-prices / GetEnergyPrices¶
返回历史能量价格表。
java -jar build/libs/wallet-cli.jar --network nile get-energy-prices
GetEnergyPrices
备注手续费 —— get-memo-fee / GetMemoFee¶
返回为交易附加备注所收取的手续费。
java -jar build/libs/wallet-cli.jar --network nile get-memo-fee
GetMemoFee
区块¶
查询区块 —— get-block / GetBlock¶
按编号返回区块;不给编号时返回最新区块。
java -jar build/libs/wallet-cli.jar --network nile get-block --number 1000000
--number(可选)—— 区块编号;默认为最新区块。
GetBlock [BlockNum]
不带参数时,返回当前区块。
按 ID 查询区块 —— get-block-by-id / GetBlockById¶
java -jar build/libs/wallet-cli.jar --network nile get-block-by-id --id 00000000000f4240...
--id(必填)—— 区块 ID(哈希)。
GetBlockById block_id
按 ID 或编号查询区块 —— get-block-by-id-or-num / GetBlockByIdOrNum¶
接受区块编号或区块 ID。
java -jar build/libs/wallet-cli.jar --network nile get-block-by-id-or-num --value 1000000
--value(必填)—— 区块编号或区块 ID。
GetBlockByIdOrNum [idOrNum] [true]
不带参数时,返回当前区块头。结尾加 true 则返回完整区块而非仅区块头。运行
GetBlockByIdOrNum help 查看所有形式。
查询最近 N 个区块 —— get-block-by-latest-num / GetBlockByLatestNum¶
java -jar build/libs/wallet-cli.jar --network nile get-block-by-latest-num --count 5
--count(必填)—— 要返回的最近区块数量。
GetBlockByLatestNum num
查询区块范围 —— get-block-by-limit-next / GetBlockByLimitNext¶
返回半开区间 [start, end) 内的区块。
java -jar build/libs/wallet-cli.jar --network nile get-block-by-limit-next \
--start 1000000 --end 1000005
--start(必填)、--end(必填,必须大于start)。
GetBlockByLimitNext start_block_number end_block_number
区块内交易数 —— get-transaction-count-by-block-num / GetTransactionCountByBlockNum¶
java -jar build/libs/wallet-cli.jar --network nile \
get-transaction-count-by-block-num --number 1000000
--number(必填)—— 区块编号。
GetTransactionCountByBlockNum number
交易¶
查询交易 —— get-transaction-by-id / GetTransactionById¶
返回某交易 ID 对应的交易体。
java -jar build/libs/wallet-cli.jar --network nile get-transaction-by-id --id <txid>
--id(必填)—— 交易 ID(哈希)。
GetTransactionById txid
查询交易信息 —— get-transaction-info-by-id / GetTransactionInfoById¶
返回交易的执行结果:手续费、能量/带宽消耗、合约结果和日志。用它来读取改变状态的合约调用的结果。
java -jar build/libs/wallet-cli.jar --network nile get-transaction-info-by-id --id <txid>
--id(必填)。
GetTransactionInfoById txid
区块内交易信息 —— GetTransactionInfoByBlockNum(仅 REPL)¶
返回某区块内每笔交易的执行结果。
GetTransactionInfoByBlockNum number
number(必填)—— 区块编号。
节点¶
列出节点 —— list-nodes / ListNodes¶
列出已连接节点所知的对等节点。
java -jar build/libs/wallet-cli.jar --network nile list-nodes
ListNodes
USDT¶
USDT 余额 —— get-usdt-balance / GetUSDTBalance¶
返回某地址的 USDT(TRC-20)余额。仅在 main、nile、shasta 上支持。
java -jar build/libs/wallet-cli.jar --network nile get-usdt-balance --address TXyz...
--address(可选)—— 默认为当前钱包的地址。
GetUSDTBalance [Address]
不带参数时,使用已登录账户的地址。
按 ID 查询 USDT 转账 —— GetUsdtTransferById(仅 REPL)¶
按交易 ID 在本地交易历史中查询此前记录的 USDT 转账。仅在 main、nile、shasta 上支持。
GetUsdtTransferById txId
txId(必填)—— 要在本地历史中查询的交易 ID。
编码转换器 —— EncodingConverter(仅 REPL)¶
交互式助手,用于在地址/数值的各种编码之间转换(例如 Base58Check ↔ 十六进制)。它提示输入,而非 接受参数。
EncodingConverter