跳到主要内容

AutoEnergy 工作原理

AutoEnergy 只负责一件事：在订阅活跃期间持续为地址委托能量，并按其交付的服务从您的 TRONAgg 余额扣费。本页介绍委托循环、完整生命周期、计费模型、所有自动关闭触发条件，以及计费保证。

委托循环​

订阅活跃期间，地址上始终保持一份完整的常驻委托——覆盖永远领先您的转账一步：

  1. 激活时在地址上停放约 131,000 能量。 这足以覆盖任意一笔 TRC-20 转账（包括发往首次收款地址的重型转账），因此第一笔转账即刻被覆盖、无需预热。这份常驻委托由激活费覆盖——不会另行收费。
  2. 转账消耗已委托的能量。 交易消耗委托而非燃烧钱包中的 TRX，您的发送方式毫无变化。
  3. 委托在数秒内刷新。 转账刚一完成，已消耗的委托即被回收，新的能量随即落到地址上——两者都可在任意 TRON 浏览器中看到。转账本身在链上确认后恰好计费一次，按其消耗的覆盖等级计价（标准 65k、重型 131k）。

净效果：每笔转账按其能量等级付费，永远不存在「突发转账烧掉 TRX」的覆盖空窗。

生命周期​

订阅在三种状态之间流转：

subscribe → active → closed
              ↑          |
              └── reactivate ──┘
状态含义
pending_activation已创建、已扣激活费，正在建立委托。过渡状态。
active能量持续委托给该地址；逐笔与每日计费生效。
closed已停止委托。历史记录保留。可重新激活或软删除。

订阅​

当您订阅一个地址时，TRONAgg 会：

  1. 校验地址（格式错误的地址会被拒绝）。
  2. 检查入门门槛——您的余额必须能覆盖激活费 + 一次每日费 + 一次 131k 转账。这是一道保护，确保新订阅能够实际运行，而非实际扣除的全部金额。
  3. 扣取激活费（一次性）。
  4. 停放常驻委托——约 131,000 能量在数秒内落到地址上（见委托循环）。

一个地址同一时间只能持有一个有效订阅。对已有有效订阅的地址再次订阅会返回 409 address_busy。若您此前关闭过该地址上的订阅，再次订阅会返回 409 address_exists——请先重新激活或删除已关闭的那个。

活跃​

活跃期间，地址按委托循环保持能量就绪：常驻约 131k 委托，每笔转账后数秒内刷新。计费方式见 计费。

重新激活​

已关闭的订阅可以重新激活。重新激活会再次扣取激活费、重置计数器（如 tx_used_total）并恢复委托。对未关闭的订阅执行重新激活会返回 409 not_reactivatable。

关闭​

关闭会停止委托。链上拆除为尽力而为——以 TRONAgg 自身的状态为准，因此即便拆除滞后，订阅也会可靠地标记为已关闭。已关闭的订阅会连同历史保留在列表中，直到您删除它。

删除​

删除会软删除一个已关闭的订阅：它从列表中消失，历史记录保留，该地址可作为全新订阅再次添加。只有已关闭的订阅可被删除——删除有效订阅会返回 409 not_deletable。

计费​

所有费用均从您的 TRONAgg 余额扣除，并出现在 账单流水 中。共有三类费用：

费用账本 kind何时发生
激活autoenergy_activate订阅时及每次重新激活时各一次
每日订阅autoenergy_daily订阅活跃的每一天；首笔每日费在激活约 24 小时后到期
逐笔转账autoenergy_unit地址每发生一笔转账，按能量等级（65k 或 131k）计价

所有金额均可由管理员配置——请通过 GET /pricing 获取当前价格。

能量等级。 逐笔费用分为两个等级之一：

  • 65k — 收款方已持有该代币的标准 TRC-20 转账。
  • 131k — 更重的转账（如首次收款），消耗约两倍能量。

每条用量记录都会记下其等级、计费单位数、计费金额，以及所覆盖转账的链上 used_tx_id。

设置​

三项设置决定订阅何时自动关闭。它们均为可选，可随时通过 PATCH /subscriptions/{address} 修改。

设置取值默认作用
idle_hours24、48、7224空闲该小时数后自动关闭。
quota_max_tx整数 ≥ 1，或 nullnull（无上限）累计计费转账达到该数值后自动关闭。
expire_at未来的 ISO-8601 时间，或 nullnull（无到期）到该时间自动关闭。

执行 PATCH 时，未提供的字段保持不变；显式传入 null 会清除上限或到期时间。

自动关闭触发条件​

订阅会因以下任一原因自动关闭。原因通过订阅上的 close_reason 暴露：

close_reason触发条件
idle在配置的 idle_hours 窗口内无任何活动。
quotatx_used_total 达到 quota_max_tx。
expired已过 expire_at 时间。
insufficient_balance您的 TRONAgg 余额已无法覆盖应扣费用。
daily_cap触及内部每日安全上限。
manual您主动关闭（图形界面、机器人或 API）。
admin由 TRONAgg 运营人员关闭。

任何自动关闭之后，您都可以 重新激活（再次扣激活费、重置计数器）或 删除 该订阅。

计费保证​

用量检测由 TRONAgg 负责，无需您做任何事。该地址每一笔符合条件的转账都会被检测并恰好计费一次——不漏计、不重复计费——费用随后即出现在您的账单流水中。

计费以委托被消耗为准：费用在链上交易确认并关联后才会记录，因此它会在转账后很快出现在您的流水中——绝不提前，也绝不重复。