命令参考

每个命令和子命令都有独立页面。大多数页面采用相同结构（用法 · 说明 · 选项 · 示例 · 输出 · 退出码 · 另请参见）；带位置参数的命令另有「参数」一节，少数简单命令则省略「说明」。命令组页面列出其下的所有子命令及相应链接。

哪些命令能在哪些网络上运行

wallet-cli 支持两个链家族——TRON 和 EVM，而 --network 选中的是某个家族里的某一个网络。命令分为三类：

• 通用命令——在两个家族上都是同一条命令，只是与家族相关的部分各按家族命名：account balance / info / portfolio、block、tx send / broadcast / status / info / sign、token（全部五条）、contract call / send / deploy、chain node / prices、message sign、typed-data sign。
• 仅 TRON——该命令实现的是 TRON 协议特性，EVM 上没有对应物：account history / activate / set、chain params、contract info / clear-abi / create2 / set-origin-energy-limit / set-user-resource-percent、tx approvals / multisig，以及 stake、vote、reward、proposal、witness、permission、asset、exchange、gasfree 这几组里的每一条命令。在 EVM 网络上运行它们，会在任何节点调用之前就以 family_mismatch 失败。
• 本地命令——完全不涉及网络：create、import、use、current、list、derive、rename、backup、delete、change-password、config、networks、contact、encoding、address。其中一部分仍然接受 --network，但它只是一个显示选择器（打印哪个家族的地址，keystore 导出取哪把密钥）；无论如何都不会访问节点。

单个参数也是按家族划分的。--help 会给它们打上 (TRON only) / (EVM only) 标记，把其中之一用在另一个家族上属于用法错误——invalid_option，退出码 2。

钱包与账户

命令	页面
create	create.md
import（命令组）	import/index.md
import mnemonic	import/mnemonic.md （仅支持交互式）
import private-key	import/private-key.md （仅支持交互式）
import keystore	import/keystore.md （仅支持交互式）
import ledger	import/ledger.md
import watch	import/watch.md
list	list.md
use	use.md
current	current.md
derive	derive.md
rename	rename.md
backup	backup.md
delete	delete.md
change-password	change-password.md

交易

命令	页面
tx（命令组）	tx/index.md
tx send	tx/send.md
tx broadcast	tx/broadcast.md
tx status	tx/status.md
tx info	tx/info.md
tx sign	tx/sign.md
tx approvals	tx/approvals.md
tx multisig	tx/multisig.md

链上查询

命令	页面
account（命令组）	account/index.md
account balance	account/balance.md
account info	account/info.md
account history	account/history.md
account portfolio	account/portfolio.md
account activate	account/activate.md
account set	account/set.md
block	block.md
chain（命令组）	chain/index.md
chain params	chain/params.md
chain prices	chain/prices.md
chain node	chain/node.md

账户权限

命令	页面
permission（命令组）	permission/index.md
permission show	permission/show.md
permission update	permission/update.md

token 与合约

命令	页面
token（命令组）	token/index.md
token balance	token/balance.md
token info	token/info.md
token add	token/add.md
token list	token/list.md
token remove	token/remove.md
contact（命令组）	contact/index.md
contact add	contact/add.md
contact list	contact/list.md
contact remove	contact/remove.md
contract（命令组）	contract/index.md
contract call	contract/call.md
contract send	contract/send.md
contract deploy	contract/deploy.md
contract info	contract/info.md
contract clear-abi	contract/clear-abi.md
contract set-origin-energy-limit	contract/set-origin-energy-limit.md
contract set-user-resource-percent	contract/set-user-resource-percent.md
contract create2	contract/create2.md
gasfree（命令组）	gasfree/index.md
gasfree info	gasfree/info.md
gasfree transfer	gasfree/transfer.md
gasfree trace	gasfree/trace.md

质押、投票与奖励

命令	页面
stake（命令组）	stake/index.md
stake freeze	stake/freeze.md
stake unfreeze	stake/unfreeze.md
stake withdraw	stake/withdraw.md
stake cancel-unfreeze	stake/cancel-unfreeze.md
stake delegate	stake/delegate.md
stake undelegate	stake/undelegate.md
stake info	stake/info.md
stake delegated	stake/delegated.md
vote（命令组）	vote/index.md
vote cast	vote/cast.md
vote list	vote/list.md
vote status	vote/status.md
reward（命令组）	reward/index.md
reward balance	reward/balance.md
reward withdraw	reward/withdraw.md

治理

命令	页面
proposal（命令组）	proposal/index.md
proposal list	proposal/list.md
proposal show	proposal/show.md
proposal create	proposal/create.md
proposal approve	proposal/approve.md
proposal delete	proposal/delete.md
witness（命令组）	witness/index.md
witness create	witness/create.md
witness update	witness/update.md
witness set-brokerage	witness/set-brokerage.md

TRC10 资产与链上交易所

命令	页面
asset（命令组）	asset/index.md
asset issue	asset/issue.md
asset update	asset/update.md
asset participate	asset/participate.md
asset unfreeze	asset/unfreeze.md
asset info	asset/info.md
asset list	asset/list.md
exchange（命令组）	exchange/index.md
exchange create	exchange/create.md
exchange inject	exchange/inject.md
exchange withdraw	exchange/withdraw.md
exchange trade	exchange/trade.md
exchange show	exchange/show.md
exchange list	exchange/list.md

签名

命令	页面
message（命令组）	message/index.md
message sign	message/sign.md
typed-data（命令组）	typed-data/index.md
typed-data sign	typed-data/sign.md

本地命令

命令	页面
encoding（命令组）	encoding/index.md
encoding convert	encoding/convert.md
address（命令组）	address/index.md
address generate	address/generate.md
config	config.md
networks	networks.md

全局选项（所有命令通用）

-o, --output <text|json>   result format (default: config.defaultOutput, built-in text)
--network <string>         network id or alias, e.g. nile, sepolia, bsc, eip155:11155111
                           (falls back to config.defaultNetwork)
--account <string>         accountId, label, or address (wallet-bound commands; falls back to active);
                           an address is only valid on its own chain, use accountId or label to cross
                           chains; read-only commands accept any address of that chain, signing
                           commands require you to hold it
--timeout <number>         per node, service, or device call timeout, ms (default: config.timeoutMs, built-in 60000)
-v, --verbose              extra diagnostic output
-h, --help / -V, --version

schema 中启用了广播后轮询的命令支持 --wait / --wait-timeout <ms>（时间上限默认取配置 waitTimeoutMs，内置 60000）。提前退出模式同样因命令而异：构建交易的命令可能提供 --dry-run / --sign-only / --build-only，而像 tx broadcast 这样只负责提交的命令既不重新构建也不签名，因此没有 --sign-only / --build-only。

费用参数和多签参数是按家族划分的，因此它们不是全局选项：

参数	家族	出现在哪里
权限组与过期时间——见下	TRON	会签名、或能输出未签名 hex 的 TRON 交易构建命令；不含 tx broadcast 和 GasFree
--fee-limit <sun>	TRON	会消耗能量的那些命令：tx send、contract send / deploy
--gas-limit <n> / --max-fee <gwei> / --priority-fee <gwei> / --nonce <n>	EVM	tx send、contract send / deploy

上述 TRON 交易构建命令接受两个多签相关参数：用于签名的权限组（0=owner，1=witness，2-9=active）和交易过期时间。后者可在离线构建或签名时延长收集联署签名的窗口。跨家族命令会将这两个参数标记为 (TRON only)；在 EVM 上使用时会返回 invalid_option。EVM 交易只有一个签名，因此不需要这两个参数。

同时提供三种提前退出模式的命令要求它们互斥；--expiration 也只能与 --sign-only 或 --build-only 一起使用。违反任一规则都属于用法错误，退出码为 2。具体错误码和字段名取决于校验位置：治理类写操作返回 invalid_value；模式互斥属于对象级校验，因此字段名显示为 --input——invalid --input: choose at most one of --dry-run, --sign-only, --build-only；--expiration 的校验直接作用于该字段，因此错误会明确指出它——invalid --expiration: only valid with --sign-only or --build-only。其他命令中的同类冲突返回 invalid_option。脚本应按退出码分支，不要依赖错误码字符串；参见 machine-interface。

---