Skip to content

TRON 能量租赁

TRON Energy Lease 允许用户为指定地址请求能量,先获取报价,再创建租赁订单,等待能量服务商履约,并在成功后获得链上 txid

用户侧 API

所需 scope:

text
tron:lease

获取报价

bash
curl -X POST https://api.open4x.com/v1/apps/tron/quote \
  -H "X-API-Key: sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "receiver": "TAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "energy": 65000,
    "duration_seconds": 3600
  }'

创建租赁订单

bash
curl -X POST https://api.open4x.com/v1/apps/tron/lease \
  -H "X-API-Key: sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "receiver": "TAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "energy": 65000,
    "duration_seconds": 3600,
    "quote_id": "quote_xxx",
    "max_cost": 0.05
  }'

初始响应:

json
{
  "status": "pending",
  "order_id": "lease_xxx",
  "message": "Lease order accepted, waiting for provider fulfillment"
}

查询订单

http
GET /v1/apps/tron/leases
GET /v1/apps/tron/leases/:id

服务商 API

能量服务商使用 provider key 鉴权:

text
/v1/provider/tron/leases/pending
/v1/provider/tron/leases/:id
/v1/provider/tron/leases/:id/accept
/v1/provider/tron/leases/:id/complete
/v1/provider/tron/leases/:id/fail

服务商只应接收自己能在指定时效和容量内完成的订单。

校验和退款

平台记录服务商事件、txid、校验 payload、完成时间和退款状态。若服务商履约失败或订单超时,平台会进入退款流程。

动态定价

TRON 定价需要考虑:

  • 请求能量数量。
  • 租赁时长。
  • 服务商容量。
  • TRX 销毁量压力。
  • 当前网络情况。
  • 用户传入的 max_cost

报价接口的作用是让用户在下单前锁定价格预期。