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。
报价接口的作用是让用户在下单前锁定价格预期。