Fragen und Antworten
Was Integratoren vor der ersten Bestellung fragen — nach Gruppen und knapp beantwortet. Wo eine Antwort zum Vertrag gehört und nicht zu unserer Gewohnheit, sagt die API-Dokumentation dasselbe ausführlich.
Energie und Preis
Was ist TRON-Energie?
Eine Netzwerkressource, die die Ausführung von Smart Contracts bezahlt. Liegt genug Energie auf der Absender-Wallet, verbrennt ein USDT-Transfer so gut wie kein TRX.
Warum ist das billiger als Verbrennen?
Verbrennen bepreist Energie zum Protokollsatz, ~210 sun je Einheit — eine Zahl, die sich nie bewegt. Wir beziehen delegierte Energie in Menge und verkaufen sie zu einem Bruchteil dieses Satzes; der gerade geltende Preis steht auf der Preisseite.
Alle Preise ansehen →
Was, wenn ich das 4-Minuten-Fenster verpasse?
In mode A bleibt die Belastung: Die Energie wurde geliefert, und bezahlt wird die Lieferung. In mode B senden wir nach dem Schließen des Fensters gar nichts mehr, die Position scheitert also und die Reservierung kommt vollständig zurück. Das Zeitfenster kommt mit jeder Bestellung — bauen Sie Ihren Ablauf darum herum.
Kostet ein verpasstes Sendefenster in beiden Modi dasselbe?
Nein. In mode A wurde die Energie geliefert, also bleibt die Belastung — und in mode C ebenso, wo es keinen Transfer zu erwarten gibt und die Position beim Schließen des Fensters einfach verfällt. In mode B senden wir nach dem Schließen des Fensters gar nichts mehr: ein verspätet abgeschickter Transfer träfe auf eine Wallet, von der die delegierte Energie längst abgezogen ist, und würde Ihr TRX verbrennen. Die Position schließt als failed mit broadcast_window_missed, die Reservierung kommt vollständig zurück, und die dafür gekaufte Energie ist unser Verlust.
Geld und Erstattungen
Wie bezahle ich?
Vorausbezahltes Serviceguthaben, geführt in TRX: TRX an Ihre persönliche Adresse senden, für Leistungen ausgeben. Preise werden beim Anlegen der Bestellung fixiert.
Welchen Token darf ich an meine Einzahlungsadresse schicken?
TRX, und nur TRX. An eine Einzahlungsadresse gesendetes USDT wird nicht automatisch gutgeschrieben: Wir übernehmen kein Wechselkursrisiko und betreiben keinen Umtausch, also wird so etwas beiseitegelegt, damit ein Mensch es ansieht, und ob es gutgeschrieben wird, entscheiden wir von Fall zu Fall. Den falschen Token geschickt? Schreiben Sie uns, und schicken Sie nicht noch mehr.
Wann kann ich eine Einzahlung ausgeben?
Nach 3 Bestätigungen — etwa zehn Sekunden. Danach steht das Guthaben in drei Teilen da: der Gesamtbetrag, der für laufende Bestellungen reservierte Teil und der verfügbare. Eine Bestellung entsteht aus dem verfügbaren Teil, nie aus dem Gesamtbetrag.
Kann ich eine Bestellung stornieren?
Nur bevor der Einkauf beginnt; danach lautet die Antwort order_not_cancelable, denn die Energie ist bereits gekauft. Eine stornierte Bestellung gibt ihre Reservierung vollständig frei und belastet nichts.
Wie ist es mit Erstattungen?
Freigaben laufen von selbst und brauchen nie ein Ticket. Die Regel ist eine: Energie, die wir nicht geliefert haben, wird nicht berechnet, und die Reservierung kehrt als Serviceguthaben auf Ihr Konto zurück — eine gescheiterte Lieferung, eine vor Beginn des Einkaufs stornierte Bestellung, der nicht ausgegebene Teil eines Auto-refill-Tages. Gelieferte Energie wird berechnet, genutzt oder nicht.
Sicherheit und Schlüssel
Welche Schlüssel brauchen Sie?
Keine. Mode A sieht Ihre Transaktion nie. Mode B nimmt eine, die Sie bereits signiert haben, und wir können kein Byte daran ändern.
Akzeptieren Sie einen Multisig-Absender?
In mode B nicht: Die Transaktion muss genau eine Signatur des Eigentümers tragen, mit Permission_id 0. Der Schlüsselsatz eines Multisig-Kontos lebt im Netz und ändert sich ohne unser Wissen, also können wir nicht versprechen, dass das Senden angenommen wird. In mode A erreicht uns nichts davon, wie Sie signieren — den Transfer senden Sie selbst.
Was speichern Sie, und wie lange?
In mode B wird Ihre signierte Transaktion verschlüsselt gehalten und 7 Tage, nachdem die Bestellung einen Endstatus erreicht hat, gelöscht. Bestellungen, Buchungen und Einzahlungen bleiben: Das ist Buchhaltung, und sie aufzubewahren sind wir verpflichtet. Sonst liegt hier nichts von Ihnen — keine privaten Schlüssel, keine Seed-Phrasen, keine Verwahrung Ihrer Mittel.
Anbindung
Gibt es Limits?
120 Bestellungen pro Minute je Schlüssel, bis zu 500 Transfers je Sammelbestellung. Über dem Limit bekommen Sie Retry-After, kein stilles Verwerfen.
Was heißt completed eigentlich?
Dass die Energie geliefert wurde — nicht, dass Ihr Transfer raus ist. Die Verpflichtung ist die Lieferung, und daran schließt die Bestellung: in mode A kann completed eintreffen, bevor Sie überhaupt etwas gesendet haben. Achten Sie darauf, dass send_before in der Bestellung erscheint, und nicht auf das Wort ready: Wer alle zwei Sekunden abfragt, sieht ready womöglich nie.
Wie funktioniert Idempotenz?
Ein Idempotency-Key ist an die rohen Bytes des Body gebunden, mit dem er ankam. Derselbe Schlüssel und ein Byte für Byte gleicher Body geben dieselbe Bestellung zurück; derselbe Schlüssel mit einem anderen Body ist ein Konflikt; eine von der Prüfung abgewiesene Anfrage verbraucht den Schlüssel nicht, sie darf also mit demselben Schlüssel wiederholt werden, sobald der Body stimmt. Serialisieren Sie den Body einmal und senden Sie genau diese Bytes erneut — eine andere Schlüsselreihenfolge oder ein Leerzeichen mehr ist schon ein anderer Body.
Kann ich eine Adresse prüfen, ohne etwas zu bezahlen?
Ja, und es ist kostenlos. GET /v1/address-check sagt, was wir über eine Wallet wissen, und POST /v1/estimate bepreist bis zu 500 Empfänger nach denselben Regeln, die eine Bestellung anwenden würde — einschließlich, welche davon der Token-Vertrag auf der schwarzen Liste führt. Keines von beiden reserviert etwas und keines belastet etwas.
Ihr Konto
Kann sich eine Wallet selbst aufgefüllt halten?
Ja — eine Auto-refill-Regel: eine Adresse plus ein Tagesbudget. Energie füllt sich nach jedem Transfer nach; das Budget ist eine harte Tagesobergrenze.
Worauf sollte ich balance.low setzen?
Die Zahl ist Ihre eigene Einstellung — balance_low_threshold_trx in PATCH /v1/settings; balance.low ist das Ereignis, das daran hängt. Das brauchbare Maß ist ungefähr Ihr Umsatz eines Tages: Dann kommt die Warnung einen Tag, bevor Bestellungen anfangen, insufficient_balance zu bekommen — und nicht anstelle der ersten Ablehnung. Deutlich niedriger, und das Ereignis ist eine Nachricht im Nachhinein; deutlich höher, und es ist Rauschen. Null schaltet es ab.
Gibt es eine Sandbox oder ein Mindestvolumen?
Kein Mindestvolumen, kein Abo und nichts für Leerlauf zu zahlen. Eine Sandbox gibt es ebenso wenig: Die Basis-URL ist die produktive, und eine andere existiert nicht. Die Auskunfts-Endpunkte, eine Schätzung und ein Webhook-Test kosten nichts, sodass sich der größte Teil einer Anbindung bauen lässt, bevor es eine einzige Bestellung gibt.