wallet-cli vote status¶

你当前的投票、投票权与奖励概览。

用法¶

wallet-cli vote status [options]

说明¶

在一个只读视图中汇总“质押 → 投票 → 奖励”的完整状态，包括当前票数分配、各 SR 的奖励分配比例、投票权（TP 总量 / 已用 / 可用），以及当前可领取的奖励。

投票权（TP）——total = 已质押的 TRX；used = 已投出的票数；available = total − used。
APR / 分成比例——分成比例读取自链上。aprPct 是预留字段，恒为 null，因为当前实现没有 APR 数据源。SR 可以随时通过链上的 UpdateBrokerage 修改比例；如果比例从 80% 降为 0%，已投出的票将不再产生投票奖励。
0% 警告——如果有票投在分成比例为 0% 的 SR 上，文本输出会追加一行 ! 提示，json 则在 meta.warnings 中加入一条纯字符串，每个受影响的 SR 各一条。
可领取奖励——数据来源与 reward balance 相同；用 reward withdraw 领取。

选项¶

没有命令级选项；仅全局选项（--network / --account）。

示例¶

wallet-cli vote status --account main --network tron:3448148188

Label         main
Voting power  1,500 TP  (used 1,000 / available 500)
Claimable     12.345678 TRX

Current votes (2)
| Name         | Votes | APR | Reward ratio | Address                            |
| ------------ | ----- | --- | ------------ | ---------------------------------- |
| tronscan.org | 600   | —   | 80%          | TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g |
| binance.com  | 400   | —   | 0%           | TT5W8MPbYJih9R586kTszb4LoybzUvCYm2 |
! 400 votes on binance.com earn nothing — 0% reward ratio

wallet-cli vote status --account main --network tron:3448148188 -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"vote.status","data":{"address":"TQk...","votingPower":{"total":1500,"used":1000,"available":500},"claimableRewardSun":"12345678","votes":[{"witness":"TZ4...","name":"tronscan.org","count":600,"rewardRatioPct":80,"brokeragePct":20,"aprPct":null},{"witness":"TT5...","name":"binance.com","count":400,"rewardRatioPct":0,"brokeragePct":100,"aprPct":null}]},"meta":{"durationMs":16,"warnings":["400 votes on TT5... (binance.com) earn nothing: reward ratio is 0%"]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

输出¶

字段	类型	含义
`address`	string	被查询的账户
`votingPower.total` / `.used` / `.available`	number	TP 总量 / 已占用 / 可用
`claimableRewardSun`	string	当前可领取的奖励，单位 SUN
`votes[]`	array	当前的票数分配：`witness`、取自 URL 主机名的 `name`、`count`、可为 null 的 `rewardRatioPct` / `brokeragePct`，以及预留的 `aprPct`（恒为 `null`）

分成比例为零的警告以纯字符串形式出现在 meta.warnings 中——参见读取 meta.warnings。

退出码¶

0 成功 · 1 执行失败（rpc_error） · 2 用法错误（invalid_value）。

另请参见¶

vote cast · vote list · reward balance · stake info