Zum Inhalt springen

TRC20-Gebühren sponsern: TronFuel, Paymaster

Gebühren-Sponsoring bedeutet, dass ein Dritter die Energy und Bandwidth bezahlt, die eine TRON-Transaktion verbraucht, sodass das sendende Wallet kein TRX braucht. Wir empfehlen dafür TronFuel. Der Chaingateway-Paymaster erledigte dieselbe Aufgabe innerhalb der API und ist abgekündigt. Bestehende Integrationen funktionieren weiter, neue sollten ihn nicht nutzen.

Optionen, um TRC20-Token von einer Adresse ohne TRX zu senden: Energy mit TronFuel mieten, TRX staken und Ressourcen delegieren oder den abgekündigten Paymaster nutzen TRC20-Transfer von einer Adresse ohneTRX scheitert mit Status 422, balance is notsufficient Empfohlen: TronFuel mietet Energy, ein eigener Dienst Alternative: staken und delegieren POST /api/v2/tron/freeze und /delegate Abgekündigt: Paymaster-Endpunkte nur für bestehende Integrationen
Für neue Integrationen wählen Sie die zweite oder dritte Option.

Warum kann ein TRON-Wallet mit Token, aber ohne TRX sie nicht senden?

Abschnitt betitelt „Warum kann ein TRON-Wallet mit Token, aber ohne TRX sie nicht senden?“

Ein TRC20-Transfer ist ein Smart-Contract-Aufruf. TRON berechnet dafür Energy und Bandwidth. Eine Adresse bezahlt diese Ressourcen entweder, indem sie TRX verbrennt, oder indem sie Ressourcen nutzt, die sie gestakt hat oder die ihr delegiert wurden. Der Token selbst zahlt nie.

Daraus ergibt sich eine Situation, auf die früher oder später jede TRON-Integration stößt. Ein Kunde zahlt USDT auf eine frisch erstellte Adresse ein. Die Adresse hält jetzt Token und sonst nichts. Diese Token weiterzusenden schlägt mit dem Status 422 und der Meldung balance is not sufficient fehl, weil kein TRX die Ressourcenkosten deckt. Jede Einzahlungsadresse im Voraus mit TRX auszustatten funktioniert, bindet aber TRX in Adressen, die womöglich nie verwendet werden.

Das Sponsern der Gebühr löst das von der anderen Seite. Ein Dritter bezahlt die Ressourcenkosten, und das Wallet sendet seine Token, ohne je TRX zu halten.

TronFuel empfehlen wir dafür heute. Der Dienst mietet Energy in großen Mengen von Stakern, statt TRX zu verbrennen, und daher kommt die Ersparnis gegenüber einem einfachen Burn. Den Hintergrund beschreibt TRC-20-Transaktionsgebühren auf TRON erklärt.

TronFuel ist ein eigenständiger Dienst. Er hat keinen Endpunkt innerhalb der Chaingateway-API, deshalb beschreibt diese Dokumentation nicht, wie man ihn aufruft. Die eigene Dokumentation finden Sie über den Link oben.

Der Chaingateway-Paymaster erledigte innerhalb der API dieselbe Aufgabe: Er übernahm Bandwidth und Energy, damit ein Wallet vor dem Senden von TRC20-Token kein TRX brauchte. Die Kosten stellte er gegen ein Guthaben auf Ihrem Konto in Rechnung.

Der Dienst ist abgekündigt. Integrationen, die die Paymaster-Endpunkte bereits aufrufen, funktionieren weiter, und die Endpunkte sind aus diesem Grund unten dokumentiert. Bauen Sie keine neuen Integrationen darauf auf.

EndpunktZweck
POST /api/v2/tron/paymasterEine gesponserte Transaktionsanfrage erstellen
GET /api/v2/tron/paymasterIhre Anfragen und deren Status auflisten
GET /api/v2/tron/paymaster/{id}Eine Anfrage lesen
POST /api/v2/tron/paymaster/estimateEnergy, Bandwidth und Gebühr schätzen
GET /api/v2/tron/paymaster/balanceIhr verbleibendes Guthaben lesen

Wie viel Energy und Bandwidth eine Transaktion braucht, hängt vom Transaktionstyp und vom aufgerufenen Contract ab. Der Betrag ist also nicht fix. POST /api/v2/tron/paymaster/estimate nimmt denselben Body wie die eigentliche Anfrage entgegen und liefert zurück, was die Transaktion kosten würde.

Terminal-Fenster
curl --request POST\
--url https://app.chaingateway.io/api/v2/tron/paymaster/estimate\
--header 'Accept: application/json'\
--header 'Content-Type: application/json'\
--header 'Authorization: Bearer YOUR_API_TOKEN'\
--data '{
"type": "TRC20",
"from": "TLkkCeNdJKPNUwucdro84WjswkzM62LCTH",
"to": "TUwmZghA7u2GxGxKaxM1mkCmsTF4wHs4vp",
"contractaddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"amount": "1"
}'
{
"status": 200,
"ok": true,
"message": "Successfully estimated the fees",
"data": {
"energy_consumption": 32000,
"bandwidth_consumption": 368,
"paymaster_fee": 0.15
}
}

Die Gebühr wird vom Guthaben abgezogen, sobald die Anfrage abgewickelt ist. Reicht das Guthaben nicht aus, schlägt die Anfrage fehl. GET /api/v2/tron/paymaster/balance liefert, was übrig ist.

type akzeptiert TRX, TRC10, TRC20 und TRC721. Zusammen mit from, to und amount ist es erforderlich. Für TRC20 und TRC721 geben Sie zusätzlich contractaddress an, für TRC721 und TRC10 die tokenid. Das Signieren funktioniert wie überall sonst in der API: password für eine passwortgeschützte Chaingateway-Adresse, sonst privatekey. Eine optionale callback_url erhält das Ergebnis.

Terminal-Fenster
curl --request POST\
--url https://app.chaingateway.io/api/v2/tron/paymaster\
--header 'Accept: application/json'\
--header 'Content-Type: application/json'\
--header 'Authorization: Bearer YOUR_API_TOKEN'\
--data '{
"type": "TRC20",
"from": "TLkkCeNdJKPNUwucdro84WjswkzM62LCTH",
"to": "TUwmZghA7u2GxGxKaxM1mkCmsTF4wHs4vp",
"contractaddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"amount": "1",
"password": "test123",
"callback_url": "https://example.com/callback"
}'

Die Antwort ist kein Transaktions-Hash, sondern die ID der Anfrage:

{
"status": 200,
"ok": true,
"message": "Successfully created paymaster request",
"data": {
"id": "9c72d676-8180-4cd2-a406-f0f1cd097506"
}
}

Fragen Sie GET /api/v2/tron/paymaster/{id} mit dieser ID ab, oder listen Sie alle Anfragen mit GET /api/v2/tron/paymaster auf. Das Feld status durchläuft pending, solange die Anfrage wartet, processing, solange die Transaktion unterwegs ist, und completed, sobald sie abgewickelt wurde. Ein Fehlschlag lautet failed - [reason], wobei der Grund nach dem Bindestrich ausgeschrieben steht. Der resultierende Transaktions-Hash erscheint im Datensatz, sobald die Transaktion abgeschlossen ist.

{
"id": "9cfbfcaf-68b2-47e9-bf55-5b6b4875e84d",
"type": "TRC20",
"from": "THG9nncwASg3ub5rvVquocAHwwQbnKZxpH",
"to": "TPUjdnMrS7XDUFp5W6zgh4QDCW34nXa2x1",
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"amount": "200",
"token_id": null,
"transaction_hash": "80a223e0cb20ef692fbd23d3cbaf3cc1dfa2b9667aaef70c7da8ca8f707ec28b",
"status": "success",
"used_credits": "2.178413",
"callback_url": "https://api.chaingateway.io/receiver/webhooks/tron",
"created_at": "2024-09-11T15:28:57.000000Z"
}

Kann ich TRX staken, statt pro Transaktion zu zahlen?

Abschnitt betitelt „Kann ich TRX staken, statt pro Transaktion zu zahlen?“

Wenn das TRX ohnehin Ihnen gehört, können Sie es einmal staken. Die Ressourcen verwenden Sie dann wieder, statt pro Transaktion zu zahlen. POST /api/v2/tron/freeze stakt TRX für Energy oder Bandwidth. POST /api/v2/tron/delegate gibt diese Ressourcen an eine andere Adresse weiter. POST /api/v2/tron/undelegate und POST /api/v2/tron/unfreeze machen beide Schritte rückgängig. Eine einzelne gestakte Adresse kann die dahinterliegenden Einzahlungsadressen versorgen.

Das passt zu einem Zahlungsfluss mit vielen empfangenden Adressen.

Die vier Staking-Endpunkte teilen sich dieselbe Body-Form. Die Felder address, amount und resource sind Pflicht, und resource ist BANDWIDTH oder ENERGY. delegate und undelegate fügen den Pflicht-Parameter receiver hinzu. Wie überall in der API signieren Sie mit password oder privatekey.

Terminal-Fenster
curl --request POST\
--url https://app.chaingateway.io/api/v2/tron/freeze\
--header 'Accept: application/json'\
--header 'Content-Type: application/json'\
--header 'Authorization: Bearer YOUR_API_TOKEN'\
--data '{
"address": "TLkkCeNdJKPNUwucdro84WjswkzM62LCTH",
"amount": 100,
"resource": "ENERGY",
"password": "test123"
}'

Ein erfolgreicher Aufruf gibt data.result: true und die txid der Staking-Transaktion zurück. Für die Delegation gelten zwei Regeln aus der OpenAPI-Datei: Das Guthaben muss gestakt sein, bevor es delegiert werden kann, und der Empfänger muss sich von der Besitzeradresse unterscheiden. Ein fehlgeschlagener Aufruf liefert den Status 422 mit der Meldung des Nodes, etwa no frozenBalance(Energy), wenn Sie mehr entstaken, als Sie gestakt haben, oder delegated Resource does not exist, wenn Sie etwas undelegieren, das nie delegiert wurde. Das Ressourcenmodell von TRON dokumentiert, wie gestaktes TRX zu Energy und Bandwidth wird.

Die Tabelle vergleicht die Optionen danach, was sie brauchen und was sie kosten.

OptionWas Sie brauchenKostenmodellStatus
Jede Adresse mit TRX aufladenTRX in jeder EinzahlungsadresseTRX wird pro Transaktion verbranntfunktioniert, bindet TRX
TronFuelder eigenständige TronFuel-Dienst außerhalb der Chaingateway-APIEnergy wird gemietet, statt TRX zu verbrennenempfohlen
Staken und delegierenTRX, das Sie sperren könnendas gestakte TRX liefert Ressourcen, statt verbrannt zu werdenfunktioniert
PaymasterGuthaben auf Ihrem Chaingateway-KontoGebühr wird vom Guthaben abgezogenabgekündigt

Prüfen Sie das TRX-Guthaben einer Adresse vor dem Senden mit GET /api/v2/tron/balances/{address}. Eine Adresse ohne TRX und ohne delegierte Ressourcen scheitert mit der oben genannten Meldung balance is not sufficient.

Den Transfer selbst behandelt TRC20-Token-Transaktionen auf TRON erstellen.