TRON-Energie-Miete über die API automatisieren
Wer eine Hot Wallet, die Auszahlungs-Engine einer Börse oder einen Contract betreibt, der TRC-20-Überweisungen im Namen von Nutzern auslöst, braucht TRON-Energie in dem Moment, in dem eine Transaktion rausgeht. Von Hand in einer Oberfläche nachzuladen skaliert nicht über eine Handvoll Überweisungen am Tag hinaus, und wer das Zeitfenster verpasst, verbrennt stattdessen TRX von der Absenderadresse, meist deutlich teurer als gemietete Energie. Die Lösung: die Miet-API aufrufen, kurz bevor Ihr Backend die Transaktion sendet, sodass die Energie ohne menschliches Eingreifen bereitsteht.
Was die API on-chain tut
TRON trennt Rechenarbeit (Energie) von Transaktionsgröße (Bandwidth). Eine normale USDT TRC-20-Überweisung braucht etwa 65,000 Energie, wenn der Empfänger bereits USDT hält, und rund 130,000, wenn sein USDT-Guthaben null ist, weil die erste eingehende Überweisung das Anlegen des Guthabeneintrags bezahlt; die Kosten hängen vom Empfänger ab, nicht vom Absender. Bandwidth liegt bei etwa 345 Bytes, so wenig, dass die meisten Konten es aus dem freien Tageskontingent decken.
Rufen Sie die Miet-API auf, stakt der Dienst eigenes TRX und delegiert die daraus entstehende Energie mit DelegateResourceContract aus Stake 2.0 an die Adresse, die Sie angeben. Die Delegierung ist an diese Adresse und an den Mietzeitraum gebunden; läuft er ab, holt der Dienst die Energie automatisch zurück.
Die Miete ist asynchron. Der Aufruf liefert sofort eine orderId und den Zustand PAID_BY_USER; die Delegierungstransaktion wird im Hintergrund gesendet und landet meist innerhalb weniger Sekunden. Behandeln Sie die erste Antwort als Bestätigung, dass die Bestellung angenommen und bezahlt ist, und fragen Sie dann die Bestelldetails ab, bis der Zustand ENERGY_DELEGATED ist.
Die Mietdauer wählen
period nimmt einen von vier Werten: 1h, 1d, 3d, 30d. Die Preise folgen dem On-Chain-Energiemarkt und bewegen sich im Tagesverlauf, die aktuellen Zahlen stehen deshalb auf der Preisseite. Stabil ist die Reihenfolge: 1h ist pro Aufruf am günstigsten, 30d am günstigsten, wenn man die Kosten auf viele Überweisungen von derselben Adresse umlegt.
Für ein ereignisgesteuertes System, das pro ausgehender Überweisung einmal mietet, ist 1h fast immer richtig: die niedrigsten absoluten Kosten, und die Energie wird Sekunden nach der Delegierung verbraucht. 1d und länger passen zu planbaren Batch-Jobs wie einer nächtlichen Auszahlung, bei der Sie einen großen Block einmal mieten, statt die API dutzendfach aufzurufen. Sendet eine Adresse dauerhaft mehr als 20 bis 30 Überweisungen pro Stunde, ist ein auf Ihr Volumen bemessener 1d-Block sauberer als Aufrufe pro Überweisung: mehr Vorabkosten, aber die API-Roundtrips und die Bestätigungslatenz verschwinden aus dem Hot Path.
Authentifizierung und Anfrage
Der Miet-Endpunkt:
GET https://api.tronenergyrent.com/place-energy-order
Eine einfache GET-Anfrage mit Query-Parametern. Authentifiziert wird über den Parameter apiKey, den Sie nach Registrierung und Aufladen des Kontos in Ihrem Dashboard erzeugen. Header-Authentifizierung oder einen JSON-Body gibt es für diesen Endpunkt nicht.
Die Parameter:
apiKey(erforderlich): Ihr API-Schlüssel aus dem Dashboard.period(erforderlich): die Mietdauer, einer der Werte1h,1d,3d,30d.energyAmount(erforderlich): wie viel Energie delegiert werden soll, mindestens15000. Für eine normale USDT-Überweisung an einen Empfänger, der bereits USDT hält, ist65000der sichere Wert; für die erste Überweisung an einen neuen USDT-Inhaber nehmen Sie130000.destinationAddress(erforderlich): die TRON-Adresse (base58check, beginnt mitT), die die Energie empfängt.preActivateDestinationAddress(optional, Standard0): auf1setzen, wenn die Zieladresse noch nie TRX empfangen hat und deshalb on-chain nicht aktiviert ist. Der Dienst sendet dann1.5 TRXaus Ihrem Guthaben, um die Adresse vor der Delegierung zu aktivieren. Bei einer bereits aktiven Adresse lassen Sie den Wert auf0, um die Zusatzkosten zu sparen.
Der HTTP-Status ist immer 200, ob die Bestellung geklappt hat oder nicht. Verzweigen Sie deshalb auf das Feld status im JSON-Body. Eine erfolgreiche Antwort:
{
"status": "SUCCESS",
"errorCode": null,
"errorDescription": null,
"requestId": "2651eacd-2428",
"payload": {
"orderId": "128de799-501e-44b2-8d6f-1fa825c2deed",
"totalPriceSun": 5662800,
"totalPriceTrx": 5.6628,
"state": "PAID_BY_USER"
}
}
Eine Fehlerantwort enthält status: "ERROR", einen maschinenlesbaren errorCode und eine lesbare errorDescription:
{
"status": "ERROR",
"errorCode": "INVALID_ENERGY_AMOUNT",
"errorDescription": "energyAmount is less than 15000",
"requestId": "71431087-4",
"payload": null
}
Loggen Sie die requestId in beiden Zweigen. Wenn Sie den Support einmal bitten müssen, eine Miete nachzuverfolgen, ist das die ID, nach der gesucht wird.
Der Lebenszyklus einer Bestellung
Das Feld state durchläuft eine kurze feste Abfolge:
PAID_BY_USER: Die Bestellung ist aus Ihrem Guthaben bezahlt, on-chain ist noch nichts passiert.WAITING_DELEGATION: Der Dienst hat die Bestellung aufgenommen und bereitet die Delegierungstransaktion vor.ENERGY_DELEGATED: Die Delegierung ist on-chain. Die Zieladresse hält die gemietete Energie und kann sie für die nächste ausgehende Transaktion ausgeben.ERROR_DELEGATION: Die Delegierung ist fehlgeschlagen. Selten, aber bei starker Netzwerklast möglich.CANCELLED: Die Bestellung wurde storniert und der Betrag Ihrem Guthaben zurückerstattet.
Den aktuellen Zustand liefert:
GET https://api.tronenergyrent.com/single-order-details?apiKey=YOUR_API_KEY&orderId=ORDER_ID
Die Antwort hat dieselbe Hülle aus status / errorCode / payload, mit dem aktuellen state im payload. Fragen Sie nach dem Aufgeben der Bestellung alle ein bis zwei Sekunden ab und senden Sie Ihre TRC-20-Überweisung erst, wenn Sie ENERGY_DELEGATED sehen. In der Praxis sind das meist ein oder zwei Abfragen.
Eine lauffähige Python-Integration
Ein minimales, aber produktionsnahes Muster: Es gibt die Miete auf, pollt, bis die Delegierung on-chain ist, und meldet einen klaren Fehler, wenn etwas schiefgeht.
import logging
import time
import requests
API_BASE = "https://api.tronenergyrent.com"
API_KEY = "your_api_key_here"
ENERGY_FOR_TRANSFER = 65_000 # use 130_000 if recipient has zero USDT balance
HTTP_TIMEOUT_SECS = 10
POLL_INTERVAL_SECS = 1
POLL_TIMEOUT_SECS = 30
def place_order(destination_address: str, period: str = "1h",
energy_amount: int = ENERGY_FOR_TRANSFER) -> dict:
resp = requests.get(
f"{API_BASE}/place-energy-order",
params={
"apiKey": API_KEY,
"period": period,
"energyAmount": energy_amount,
"destinationAddress": destination_address,
"preActivateDestinationAddress": 0,
},
timeout=HTTP_TIMEOUT_SECS,
)
resp.raise_for_status()
body = resp.json()
if body.get("status") != "SUCCESS":
raise RuntimeError(
f"place-energy-order failed: {body.get('errorCode')} "
f"({body.get('errorDescription')}) requestId={body.get('requestId')}"
)
return body["payload"]
def wait_for_delegation(order_id: str) -> dict:
deadline = time.monotonic() + POLL_TIMEOUT_SECS
while time.monotonic() < deadline:
resp = requests.get(
f"{API_BASE}/single-order-details",
params={"apiKey": API_KEY, "orderId": order_id},
timeout=HTTP_TIMEOUT_SECS,
)
resp.raise_for_status()
body = resp.json()
if body.get("status") != "SUCCESS":
raise RuntimeError(
f"single-order-details failed: {body.get('errorCode')} "
f"({body.get('errorDescription')})"
)
state = body["payload"]["state"]
if state == "ENERGY_DELEGATED":
return body["payload"]
if state == "ERROR_DELEGATION":
raise RuntimeError(f"Delegation failed for order {order_id}")
if state == "CANCELLED":
raise RuntimeError(f"Order {order_id} was cancelled")
time.sleep(POLL_INTERVAL_SECS)
raise TimeoutError(f"Order {order_id} did not reach ENERGY_DELEGATED in {POLL_TIMEOUT_SECS}s")
def rent_energy(destination_address: str) -> dict:
placed = place_order(destination_address)
logging.info(
"Order placed: id=%s priceSun=%s priceTrx=%s",
placed["orderId"], placed["totalPriceSun"], placed["totalPriceTrx"],
)
delegated = wait_for_delegation(placed["orderId"])
logging.info("Order delegated: id=%s", delegated["orderId"])
return delegated
Ein paar Punkte dazu. Die explizite Prüfung auf status == "SUCCESS" ist nötig, weil der HTTP-Status immer 200 ist und resp.raise_for_status() allein nichts über das Ergebnis sagt. Die Polling-Schleife hat einen harten Timeout, damit eine hängende Bestellung Ihre Überweisungs-Pipeline nicht endlos blockiert. Die Verzweigung auf state behandelt die drei Endzustände (ENERGY_DELEGATED, ERROR_DELEGATION, CANCELLED) ausdrücklich, statt sich auf ein pauschales „nicht erfolgreich“ zu verlassen.
Im Überweisungsablauf rufen Sie zuerst rent_energy() auf und senden dann die TRC-20-Überweisung. Die Reihenfolge zählt: Senden Sie zuerst, verbrennt die Transaktion TRX des Absenders, weil die Delegierung noch nicht angekommen ist.
Das Guthaben bemessen
Die Mietkosten werden von dem Guthaben abgezogen, das Sie in Ihrem Konto bei tronenergyrent.com vorhalten. Richten Sie eine Benachrichtigung oder ein automatisches Aufladen ein, wenn es unter eine Schwelle fällt; als Untergrenze eignet sich, was zwei Stunden Spitzenvolumen abdeckt. Das aktuelle Guthaben programmatisch abfragen:
GET https://api.tronenergyrent.com/account-info?apiKey=YOUR_API_KEY
Der Payload enthält Ihr aktuelles Guthaben und den Kontostand. Hängen Sie das an Ihr Monitoring, und ein leeres Guthaben überrascht Sie nie um 2 Uhr nachts. Die Mindestaufladung des Guthabens bei tronenergyrent.com beträgt 10 TRX.
Fehlerbehandlung in der Praxis
Drei Fehlerfälle kommen in Produktion am häufigsten vor. Die Fehlercodes stammen aus der echten API, Sie können sicher auf sie verzweigen.
INSUFFICIENT_BALANCE: Ihr Guthaben reicht nicht für die angeforderte Miete plus eine etwaige Voraktivierung. Nicht wiederholen, ein Retry ändert nichts. Fangen Sie den Fall gezielt ab und stoßen Sie eine Benachrichtigung oder das Aufladen an, mit derrequestIdin der Meldung.INVALID_ADDRESS: DiedestinationAddresshat die base58check-Dekodierung auf dem Server nicht bestanden. Baut Ihr System Adressen dynamisch zusammen, etwa aus Nutzereingaben, validieren Sie sie lokal, bevor Sie die API aufrufen. Die Python-Bibliothektronpybietet dafüris_address(); falsche Eingaben clientseitig abzulehnen ist schneller als der Roundtrip.INACTIVE_DESTINATION_ADDRESS_ERROR: Die Zieladresse wurde nie on-chain aktiviert, und Sie haben den Dienst nicht darum gebeten. Entweder schicken Sie der Adresse vorab einen kleinen TRX-Betrag von anderswo, oder Sie übergeben beim nächsten AufrufpreActivateDestinationAddress=1, und der Dienst aktiviert sie für1.5 TRX.
Ein subtilerer Fall: ORDER_IS_ALREADY_IN_PROGRESS kann zurückkommen, wenn mehrere Worker gleichzeitig Mieten für dieselbe Zieladresse aufgeben. Der Fix liegt auf Ihrer Seite, nicht in der API: ein verteiltes Lock (Redis eignet sich gut) mit der Zieladresse als Schlüssel, gehalten, bis die Delegierung abgeschlossen ist.
On-chain gegenprüfen
Für die meisten Integrationen reicht es, /single-order-details bis ENERGY_DELEGATED zu pollen. Wer doppelt absichern will, fragt zusätzlich die TRON Full Node ab, nachdem die Delegierung gelandet ist:
GET https://api.trongrid.io/v1/accounts/{destinationAddress}
Die Antwort enthält den aktuellen Ressourcenzustand der Adresse, einschließlich der von fremden Adressen delegierten Energie. Der genaue Feldname hängt von der aktuellen Stake-2.0-Sicht ab, sehen Sie also in der aktuellen TRON-HTTP-API-Dokumentation nach, wenn Sie das verdrahten. Als weiche Prüfung, die eine Warnung loggt statt die Überweisung zu blockieren, ist das ein nützlicher Frühwarner für den seltenen Fall, dass nach der Miet-API on-chain etwas anderes schiefgeht, und erspart Ihnen dann Stunden Debugging.