wallet-cli contract set-user-resource-percent

设置一次调用的能量中由调用方承担的比例。

用法

wallet-cli contract set-user-resource-percent <address> <percent>
                                              [--dry-run | (--sign-only | --build-only) [--expiration <ms>] | --wait [--wait-timeout <ms>]]
                                              [--permission-id <n>] [options]

说明

设置 consume_user_resource_percent：一次调用的能量中由调用方支付的百分比。其余部分由部署者承担，而部署者一侧又受 contract set-origin-energy-limit 和其质押能量的双重限制。

100 表示调用方全额支付、部署者不作任何补贴——这也让 origin_energy_limit 失去意义。0 表示在上述上限之内全部由部署者支付。该值是 0–100 的整数，在本地校验。

这个数字是调用方的份额，与链上字段本身的语义方向一致；本 CLI 不会把它反过来解释。

仅限 TRON——调用方 / 部署者的能量分摊在 EVM 上没有对应物；该网络会以 family_mismatch 失败。

只有合约的部署者才能执行此操作；当前值见 contract info。设置在交易确认后立即生效。

该命令默认在交易提交后返回（stage: "submitted"），不会等待确认。使用 --wait 可阻塞至交易确认或失败。命令需要一个账户；仅在需要签名的模式下，才必须通过 --password-stdin 提供 master password。--dry-run 和 --build-only 不会解锁钱包，因此无需密码。仅观察账户无法签名，会返回 watch_only_no_signer。

Ledger 的 TRON 应用无法解析这一治理类合约。Ledger 账户可以做试运行或构建，但签名模式会在与设备交互之前就以 ledger_unsupported 失败。

选项

选项	说明
<address>	必填。 要配置的合约；你必须是它的部署者
<percent>	必填。 由调用方承担的能量比例，0–100 的整数
--dry-run	只构建和估算，不签名/不广播；与 --sign-only / --build-only 互斥
--sign-only	只签名不广播，输出已签名的 hex；与 --dry-run / --build-only 互斥；配合 --expiration 使用
--build-only	构建并估算，输出未签名的 hex；与 --dry-run / --sign-only 互斥；配合 --expiration 使用
--expiration <ms>	交易过期时间（毫秒），最大 86400000（24 小时）；仅可与 --sign-only 或 --build-only 同用；省略时使用节点默认值（约 60 秒）
--permission-id <n>	用于签名的权限组（0=owner，1=witness，2-9=active）；默认 0
--wait / --wait-timeout <ms>	广播后轮询直到已确认/失败（上限默认取配置 waitTimeoutMs，内置 60000）
--password-stdin	从 stdin（fd 0）读取 master password

此外还有全局选项。

示例

示例中的 $PW 是你的 master password（来自环境变量、密码管理器等），通过 --password-stdin 从 stdin 传入。

调用方承担全部能量开销：

echo "$PW" | wallet-cli contract set-user-resource-percent TQ5nJ8mV...4wRe 100 --network tron:3448148188 --wait --password-stdin

✅ User pay ratio set
  Contract   TQ5nJ8mV...4wRe
  Deployer   TQkXm4vN...5Zt7Uw (main)
  User pays  100%
  TxID       8b2...
  Block      57,882,388
  Fee        0 TRX  (289 bandwidth)
  Status     success

echo "$PW" | wallet-cli contract set-user-resource-percent TQ5nJ8mV...4wRe 100 --network tron:3448148188 --wait --password-stdin -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"contract.set-user-resource-percent","data":{"kind":"contract-set-user-resource-percent","stage":"confirmed","txId":"8b2...","confirmed":true,"blockNumber":57882388,"failed":false,"contractAddress":"TQ5nJ8mV...","deployerAddress":"TQkXm4vN...","consumeUserResourcePercent":100,"feeSun":0,"energyUsed":0,"netUsed":289,"energyFeeSun":0,"netFeeSun":0,"resource":{"netUsage":289,"netFeeSun":0,"energyUsage":0,"energyFeeSun":0}},"meta":{"durationMs":6470,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

输出

data 随阶段而变：

阶段	字段
默认（提交）	kind: "contract-set-user-resource-percent"、stage: "submitted"、txId、contractAddress、deployerAddress、consumeUserResourcePercent
--wait（已确认）	同上，另加 stage: "confirmed"、confirmed（boolean）、blockNumber、返回时的扁平结算字段（feeSun、energyUsed、netUsed、energyFeeSun、netFeeSun）、它们面向治理命令的兼容视图 resource（netUsage、netFeeSun、energyUsage、energyFeeSun），以及 failed

consumeUserResourcePercent 即当前生效的值——调用方的份额。

退出码

0 已提交（早退模式下为已构建/已签名） · 1 执行失败（contract_not_found——没有这个合约、not_contract_deployer、watch_only_no_signer、ledger_unsupported、auth_failed） · 2 用法错误（invalid_value——地址格式非法，或百分比不在 0–100 之间）。

另请参见

contract set-origin-energy-limit · contract info · 能量与带宽 · 脚本安全

---