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.
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.
Was sollte ich statt des Paymasters nutzen?
Abschnitt betitelt „Was sollte ich statt des Paymasters nutzen?“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.
Ist der Paymaster noch verfügbar?
Abschnitt betitelt „Ist der Paymaster noch verfügbar?“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.
| Endpunkt | Zweck |
|---|---|
POST /api/v2/tron/paymaster | Eine gesponserte Transaktionsanfrage erstellen |
GET /api/v2/tron/paymaster | Ihre Anfragen und deren Status auflisten |
GET /api/v2/tron/paymaster/{id} | Eine Anfrage lesen |
POST /api/v2/tron/paymaster/estimate | Energy, Bandwidth und Gebühr schätzen |
GET /api/v2/tron/paymaster/balance | Ihr verbleibendes Guthaben lesen |
Die Kosten vorab schätzen
Abschnitt betitelt „Die Kosten vorab schätzen“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.
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.
Eine gesponserte Anfrage erstellen
Abschnitt betitelt „Eine gesponserte Anfrage erstellen“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.
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" }}Eine Anfrage verfolgen
Abschnitt betitelt „Eine Anfrage verfolgen“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.
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.
Welche Option passt zu meiner Integration?
Abschnitt betitelt „Welche Option passt zu meiner Integration?“Die Tabelle vergleicht die Optionen danach, was sie brauchen und was sie kosten.
| Option | Was Sie brauchen | Kostenmodell | Status |
|---|---|---|---|
| Jede Adresse mit TRX aufladen | TRX in jeder Einzahlungsadresse | TRX wird pro Transaktion verbrannt | funktioniert, bindet TRX |
| TronFuel | der eigenständige TronFuel-Dienst außerhalb der Chaingateway-API | Energy wird gemietet, statt TRX zu verbrennen | empfohlen |
| Staken und delegieren | TRX, das Sie sperren können | das gestakte TRX liefert Ressourcen, statt verbrannt zu werden | funktioniert |
| Paymaster | Guthaben auf Ihrem Chaingateway-Konto | Gebühr wird vom Guthaben abgezogen | abgekü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.
Quellen
Abschnitt betitelt „Quellen“- Das TRON resource model definiert Energy, Bandwidth, Staking und Delegation.
- Das TRC20 protocol interface beschreibt die Contract-Funktionen, die ein Transfer aufruft.