Host Mode - 持续 Energy 管理

Host Mode 是一套自动化的 Energy 管理系统，持续为 TRON 地址提供用于 USDT (TRC-20) 转账的 Energy，按周期进行 Energy 代理，并在地址消耗 Energy 后自动重新代理。

概述

地址进入 Host Mode 后，系统会向其代理 Energy 并监控该地址的 USDT 转账。转账消耗所代理的 Energy 后，系统会回收该 Energy 并自动代理新的周期——只要该地址仍有剩余周期（或处于无限模式）。

核心特性

• 自动 Energy 补给：每个周期自动代理 Energy，无需人工干预
• 自动重新代理：USDT 转账消耗 Energy 后，自动代理下一个周期
• 周期计费体系：按代理周期付费
• 无限模式：持续运行，直至手动停止

工作原理

1. 添加地址：将地址注册到 Host Mode（/apiv2/time/add）。
2. 购买周期：订购固定数量的周期（/apiv2/time/order）或启用无限模式（/apiv2/time/infinitystart）。此操作将激活该地址。
3. 代理：为当前周期向该地址代理 Energy。
4. 消耗：当该地址发起 USDT 转账并消耗 Energy 时，系统回收该 Energy 并代理下一个周期。
5. 完成：当所有订购的周期消耗完毕后，地址将自动停止。在无限模式下，它将持续运行直至手动停止。

周期与定价

• 1 个周期 = 1 次代理：每次代理为 131,000 Energy，消耗一个周期。
• 按量付费：订购周期不会预先扣费。每个周期仅在其 Energy 实际代理时扣费，因此首次扣费发生在模式开启后、发起第一笔转账前。
• 周期价格：一次激活中的首次代理费用为 4 TRX。后续每次代理中，若上一笔转账消耗的 Energy 小于或等于 65,000，则费用为 2 TRX；若消耗超过该值，则费用为 4 TRX。所谓“激活”，是指某个没有未完成订单且无有效代理的地址被开启后所开始的运行期。在运行期间购买更多周期属于同一激活周期的延续。停止该地址则意味着激活结束——再次开启地址将重新开始计算，因此首次代理费用将再次为 4 TRX。订购周期时返回的 amount 仅为预估值，并非最终总额。
• 每日最低消费（自 2026-08-29 起生效）：若某个地址在一个 UTC 自然日内的花费低于 8 TRX，差额将在该日结束时扣除。两项例外情况：该规则不适用于每日转账达到或超过 3 笔的地址；若模式开启时间为 UTC 16:00 或更晚，则首日不适用该规则——此类地址将从次日开始执行。
• 代理有效期：自 Energy 代理时刻起算滚动 24 小时。若在该时间窗口内未发生转账，Energy 将被回收，下一个周期将顺延代理至次日，并按 4 TRX 的费率扣费。
• 闲置停机：在连续闲置 2 天（即连续两个 24 小时周期结束均未发生转账）后，系统将自动关闭该模式并终止未完成的订单。
• 已付费周期内的额外转账：在 Energy 被回收前的数秒内发起的第二笔转账会复用相同的 Energy。这不会开启新周期，也不会扣减剩余周期，但会根据其实际消耗按相应费率单独计费。两次转账之间建议预留约一分钟间隔以避免此情况。
• Bandwidth：若地址缺少 Bandwidth，将随 Energy 一并代理最多 400 Bandwidth。此项免费并已包含在周期价格中。
• 无限模式：周期在手动停止地址前无上限。上述所有规则依然适用——每次代理实时计费，每日最低消费和闲置停机规则同样生效。

适用场景

• 频繁进行 USDT 转账的活跃交易者
• 未质押 TRX 获取自用 Energy 的用户
• 需要地址始终保持可用 Energy 且无需手动充值的业务系统

管理接口

• Time Add — 将地址添加到 Host Mode（并注册回调 URL）
• Time Order — 购买指定数量的周期（激活地址）
• Time Infinity Start — 启用无限（无限制）模式
• Time Stop — 停止 Host Mode 并关闭未完成的订单
• Time Delete — 从 Host Mode 中移除地址
• Time Status — 查询地址、运行模式及周期数量

身份验证

每个请求均需满足以下条件：

1. API 密钥 — 在 JSON 请求体（api_key）或 X-API-KEY 请求头中传递。
2. IP 白名单 — 请求 IP 必须包含在为该 API 密钥配置的白名单中。

所有接口均返回统一的 JSON 格式：

{ "code": 0, "msg": "…", "data": { } }

code = 0 表示成功；负数 code 表示发生错误（详见 msg）。

回调（Webhooks）

为地址注册 callback_url（通过 /apiv2/time/add）后，每次向该地址代理 Energy 时，系统都会向指定 URL 发送通知。回调内容包含代理交易哈希、当前周期的扣费金额（charged，TRX，必含），以及该次转账 Energy 消耗的费率档位（energy_used：65k 或 131k，仅在周期是由转账触发产生时提供，否则省略该参数）。具体的请求格式请参阅 Time Add → Callbacks。

最佳实践

1. 核验地址：在添加地址前，请确保地址正确且已在 TRON 网络上激活。
2. 保持充足余额：费用在代理 Energy 时实时扣除，而非订购时扣除。
3. 从小额开始：在启用无限模式前，建议先订购少量周期进行测试。
4. 监控状态：使用 Time Status 接口密切监控地址状态、周期数量及实际支出。
5. 预留转账间隔：同一地址的转账之间建议间隔约一分钟，避免第二笔转账复用正在被回收的 Energy。
6. 及时停用闲置地址：未使用的地址在自动停机前仍会产生每日最低消费。
7. 保护 API 密钥：切勿在客户端代码中泄露 API 密钥；请保持 IP 白名单处于最新状态。

快速入门

1. 获取 API 密钥并将服务器 IP 加入白名单。
2. 使用 /apiv2/time/add 添加地址。
3. 使用 /apiv2/time/order 订购周期，或使用 /apiv2/time/infinitystart 启用无限模式。
4. 使用 /apiv2/time/status 监控状态。