wallet-cli stake delegated

代理明细与最大可代理额度。

用法

wallet-cli stake delegated [--direction out|in] [--resource energy|bandwidth]
                           [--to <address>] [options]

说明

以只读方式列出资源代理，支持两个方向：out（默认）显示当前账户代理给其他地址的资源以及 最大可代理额度（Max delegatable）；in 显示其他地址代理给当前账户的资源。最大可代理额度仅适用于 出向记录。--to 可将出向结果筛选到单个接收方。

锁定时间在两个方向下含义不同。 两者读取同一个链上到期字段，但：

• out → Locked until：这是你设置的锁定——到期前你无法收回（可随时收回时显示 not locked）；
• in → Guaranteed until：代理方在此时间前无法收回资源；none — reclaimable anytime 表示 代理方可以随时收回。

json 输出在两个方向上都保留原始的 lockedUntil 时间戳——机器层不做视角转换。

选项

选项	说明
--direction <out\|in>	out = 代理给别人（默认）；in = 别人代理给我
--resource <energy\|bandwidth>	只看单一资源类型（默认两者都看）
--to <string>	只看代理给该接收方的记录（仅出向）

此外还有全局选项。

示例

出向（默认）——包含 最大可代理额度（Max delegatable）：

wallet-cli stake delegated --direction out --account main --network nile

Label      main
Direction  out (delegated to others)

Max delegatable
  Energy     900 TRX
  Bandwidth  300 TRX

Delegations (2)
  Receiver                            Resource   Amount   Locked until
  TF9yB7bAL2oBbonYaMvGTqoXxExS14x73c  energy     500 TRX  2026-07-08 08:00 (in ~3 day(s))
  TNDHPk1LMLZTap8tMWfxUBy4MgArnWeSVP  bandwidth  100 TRX  not locked

wallet-cli stake delegated --direction out --account main --network nile -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"stake.delegated","data":{"address":"TP2Zs9qKScTMs8jDYV3SAHQ5pqgKY1NQ5V","direction":"out","canDelegateMaxSun":{"energy":"900000000","bandwidth":"300000000"},"delegations":[{"receiver":"TF9yB7bAL2oBbonYaMvGTqoXxExS14x73c","resource":"energy","amountSun":"500000000","lockedUntil":1783468800000},{"receiver":"TNDHPk1LMLZTap8tMWfxUBy4MgArnWeSVP","resource":"bandwidth","amountSun":"100000000","lockedUntil":null}]},"meta":{"durationMs":28,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

入向（--direction in）——锁定列变成 Guaranteed until，且没有 Max delegatable：

wallet-cli stake delegated --direction in --account main --network nile

Label      main
Direction  in (delegated to me)

Delegations (1)
  From                                Resource  Amount   Guaranteed until
  TF9yB7bAL2oBbonYaMvGTqoXxExS14x73c  energy    500 TRX  2026-07-08 08:00 (in ~3 day(s))

输出

字段	类型	含义
address	string	被查询的账户
direction	string	out / in
canDelegateMaxSun	object	{energy, bandwidth}，均为 SUN 字符串——仍可代理出去的最大额度（仅 out）
delegations[]	array	每项含：receiver（out）或 from（in）、resource、amountSun（字符串）、lockedUntil（epoch 毫秒或 null）

退出码

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

另请参见

stake delegate · stake undelegate · stake info

---