wallet-cli permission show¶
显示账户的权限结构。
用法¶
wallet-cli permission show [options]
说明¶
以只读方式查看账户的各个权限组,包括 owner、witness(仅超级代表拥有)以及最多 8 个 active 组。
每组都会显示阈值和密钥(地址及权重),active 组还会显示解码后的可执行操作列表。建议在执行
permission update 前查看当前结构,也可以在签名前检查联署人的权限配置。
默认读取当前账户;--account 可覆盖它,并且也接受直接传入地址,因此你可以查看链上任意账户。
读懂输出——text 版式对应 TronScan 的权限页面,每个权限组一张"标签 / 取值"卡片:
- Permission Name——链上的
permission_name及其 id(active 组会标注active)。名称是在permission update创建该组时指定的;它只是一个助记名,在链上没有任何含义。从未修改过的账户会显示链上默认结构:一个owner组和一个active组,各自以账户自身地址作为唯一密钥,阈值为1。 - Operation(s)——仅 active 组有。在链上这是一张 32 字节的位图(每个合约类型占一位);text 会把它解码成人类可读的操作名(
Transfer TRX、Vote……)并给出总数。这套标签与 TronScan 权限页面所显示的一致。JSON 则在operations中保留机器可读的合约类型名,并附带原始的operationsHex。 - Threshold——一笔交易要对该权限组有效所需的签名权重之和。
- Authorized To——该组的密钥,以
Address / Weight形式列出。本地钱包持有的软件账户或 Ledger 密钥会标注(this wallet: <label>),便于确认本地可用的签名权重;这也是permission update判断账户锁定风险的依据。
选项¶
没有本命令特有的选项;只有全局选项(--network,以及 --account——它同样接受直接传入地址)。
示例¶
从未改动过的账户会显示链上的默认结构——active 组覆盖全部常规操作类型:
wallet-cli permission show --account solo --network nile
Account solo (TDWjkQ5EoUSoRNhhw6cDfa72YN8WuV5d8a)
Permission Name owner (id 0)
Threshold 1
Authorized To Address Weight
TDWjkQ5EoUSoRNhhw6cDfa72YN8WuV5d8a 1 (this wallet: solo)
Permission Name active (id 2, active)
Operation(s) Activate Account · Transfer TRX · Transfer TRC10 · Vote for TRC10 [unused]
Vote · Apply to Become a SR Candidate · Issue TRC10 · Update SR Info
Participate in TRC10 Issuance · Update Account Name · TRX Stake (1.0)
TRX Unstake (1.0) · Claim Voting Rewards · Unstake TRC10
Update TRC10 Parameters · Create Proposal · Approve Proposal
Cancel Proposal · Set Account Id · Custom Contract · Create Smart Contract
Trigger Smart Contract · Get Contract · Update Contract Parameters
Create Bancor Transaction · Inject Assets into Bancor Transaction
Withdraw Assets from Bancor Transaction · Execute Bancor Transaction
Update Contract Energy Limit · Clear Contract ABI
Update SR Commission Ratio · Market Sell Asset · Market Cancel Order
TRX Stake (2.0) · TRX Unstake (2.0) · Withdraw Unstaked TRX
Delegate Resources · Reclaim Resources · Cancel Unstake (39 total)
Threshold 1
Authorized To Address Weight
TDWjkQ5EoUSoRNhhw6cDfa72YN8WuV5d8a 1 (this wallet: solo)
多签账户——这里 owner 组是 2-of-3,另有一个限定范围的 finance active 组负责日常转账。本钱包只持有其中一个密钥(main);另外两个由外部联署人持有,因此没有标注:
wallet-cli permission show --account main --network nile
Account main (TP2Zs9qKScTMs8jDYV3SAHQ5pqgKY1NQ5V)
Permission Name owner (id 0)
Threshold 2
Authorized To Address Weight
TP2Zs9qKScTMs8jDYV3SAHQ5pqgKY1NQ5V 1 (this wallet: main)
TF9yB7bAL2oBbonYaMvGTqoXxExS14x73c 1
TNDHPk1LMLZTap8tMWfxUBy4MgArnWeSVP 1
Permission Name finance (id 2, active)
Operation(s) Transfer TRX · Transfer TRC10 · Trigger Smart Contract (3 total)
Threshold 2
Authorized To Address Weight
TP2Zs9qKScTMs8jDYV3SAHQ5pqgKY1NQ5V 1 (this wallet: main)
TF9yB7bAL2oBbonYaMvGTqoXxExS14x73c 1
TNDHPk1LMLZTap8tMWfxUBy4MgArnWeSVP 1
wallet-cli permission show --account main --network nile -o json
{"schema":"wallet-cli.result.v1","success":true,"command":"permission.show","data":{"address":"TP2Zs9qKScTMs8jDYV3SAHQ5pqgKY1NQ5V","owner":{"id":0,"name":"owner","threshold":2,"keys":[{"address":"TP2Zs9qKScTMs8jDYV3SAHQ5pqgKY1NQ5V","weight":1,"local":"main"},{"address":"TF9yB7bAL2oBbonYaMvGTqoXxExS14x73c","weight":1,"local":null},{"address":"TNDHPk1LMLZTap8tMWfxUBy4MgArnWeSVP","weight":1,"local":null}]},"witness":null,"actives":[{"id":2,"name":"finance","threshold":2,"operations":["TransferContract","TransferAssetContract","TriggerSmartContract"],"operationLabels":["Transfer TRX","Transfer TRC10","Trigger Smart Contract"],"operationsHex":"0600008000000000000000000000000000000000000000000000000000000000","unknownOperationIds":[],"keys":[{"address":"TP2Zs9qKScTMs8jDYV3SAHQ5pqgKY1NQ5V","weight":1,"local":"main"},{"address":"TF9yB7bAL2oBbonYaMvGTqoXxExS14x73c","weight":1,"local":null},{"address":"TNDHPk1LMLZTap8tMWfxUBy4MgArnWeSVP","weight":1,"local":null}]}]},"meta":{"durationMs":21,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}
输出¶
| 字段 | 类型 | 含义 |
|---|---|---|
address |
string | 被查询的账户 |
owner |
object | owner 组 {id, name, threshold, keys[]} |
witness |
object | null | 超级代表的 witness 组 {id, name, threshold, keys[]},否则为 null |
actives[] |
array | active 组列表,每项为 {id, name, threshold, operations[], operationLabels[], operationsHex, unknownOperationIds[], keys[]} |
…operations[] |
string[] | 该 active 组可执行的合约类型名称 |
…operationLabels[] |
string[] | 已知操作 id 对应的可读标签 |
…operationsHex |
string | 原始的 32 字节操作位图,hex 形式 |
…unknownOperationIds[] |
number[] | 本版本无法映射到已知合约类型的置位;全部操作都已知时为空 |
…keys[] |
array | 组内密钥:{address, weight, local}——本地持有时 local 是钱包标签,否则为 null |
退出码¶
0 成功 · 1 执行失败(not_found——该地址未激活或链上不存在;rpc_error) · 2 用法错误(invalid_value)。
另请参见¶
permission update · tx sign · tx approvals · 安全