Ethereum API: ERC-20-Transfers mit einem REST-Aufruf

JSON-RPC ist das native Protokoll jeder Ethereum-Node, und für manche Aufgaben (Consensus-Tooling, eigenes Indexing) wollen Sie diesen Zugriffsgrad. Unser Guide zum Umgang mit Nodes via JSON-RPC zeigt, wie das in PHP, Python und JavaScript aussieht.

Die Round-Trips zu zählen macht den Punkt deutlich. Ein Token-Transfer über rohes JSON-RPC berührt mindestens vier Methoden – eth_gasPrice, eth_estimateGas, eth_getTransactionCount und eth_sendRawTransaction – mit ABI-Encoding und Transaktionssignierung dazwischen.

Für Zahlungen zahlt sich die Abstraktion aus. In Chaingateways Transaktions-Request sind Gas-Limit, Gas-Preis und Nonce optionale Felder – lassen Sie sie weg, füllt die API sie aus, wenn sie die Transaktion baut und broadcastet; übergeben Sie sie explizit, wenn Sie Kontrolle wollen. Ihre Seite des Austauschs ist ein HTTP-Request, den Sie in jeder Sprache mit einer Standardbibliothek schreiben können.

Pflegen Sie heute eine web3.js-Integration, hier der ehrliche Vergleich. Ein ERC-20-Transfer über die Bibliothek sieht ungefähr so aus:

// web3.js gegen Ihren eigenen RPC-Endpoint
const { Web3 } = require("web3");
const web3 = new Web3("https://your-rpc-endpoint");

const token = new web3.eth.Contract(ERC20_ABI, "0xdAC17F958D2ee523a2206206994597C13D831ec7");
const data = token.methods.transfer(recipient, amountInBaseUnits).encodeABI();

const tx = {
  from: sender,
  to: token.options.address,
  data,
  gas: await web3.eth.estimateGas({ from: sender, to: token.options.address, data }),
  gasPrice: await web3.eth.getGasPrice(),
  nonce: await web3.eth.getTransactionCount(sender),
};

const signed = await web3.eth.accounts.signTransaction(tx, PRIVATE_KEY);
await web3.eth.sendSignedTransaction(signed.rawTransaction);

Über das, was ins Snippet passt, hinaus, besitzt dieser Code eine ABI-Datei, wandelt menschliche Beträge von Hand in Basiseinheiten um (verrechnen Sie die Dezimalstellen, senden Sie ein Millionstel der beabsichtigten Summe oder das Millionenfache davon), und hält einen rohen Private Key im Anwendungsspeicher. Die REST-Version ist das einzelne POST oben: Betrag als Dezimal-String, Dezimalstellen server-seitig gehandhabt, Key verschlüsselt hinter einem Passwort ruhend.

Die Migration braucht kein Rewrite-Wochenende. Beide Stile sind schlichte Aufrufe, lassen Sie sie also nebeneinander laufen: Routen Sie neue Zahlungs-Flows über REST, lassen Sie eigene Contract-Interaktionen auf web3.js, und ziehen Sie die Bibliothek zurück, wo sie ihre Komplexität nicht mehr verdient. Teams, die web3.js nur für Transfers und Guthaben-Checks nutzten, entfernen die Abhängigkeit meist ganz.

Jede Ethereum-Transaktion verbrennt Gas, bezahlt in ETH von der sendenden Adresse, nie vom Empfänger. Eine Wallet mit Tausenden USDT, aber null ETH, kann kein einziges Token senden, weil der ERC-20-Contract keine Möglichkeit hat, seine eigenen Ausführungskosten zu decken. Token empfangen kostet den Empfänger nichts.

Dieses Detail bringt mehr ERC-20-Integrationen zu Fall als jedes andere. Kommen Ihre API-getriebenen Transfers aus einer Treasury-Wallet, braucht diese Wallet ein ETH-Guthaben neben ihren Token, und es aufzufüllen gehört auf die Ops-Checkliste neben Zertifikatserneuerungen.

Wie viel Gas kostet

Ein einfacher ETH-Transfer kostet exakt 21.000 Gas – eine Protokollkonstante. Ein ERC-20-Transfer führt Contract-Code aus und kostet ein Vielfaches davon, wobei die genaue Zahl je Token-Contract variiert. Der Preis pro Einheit schwimmt mit der Nachfrage: Seit dem London-Upgrade 2021 teilt sich die Gebühr in eine Basisgebühr, die das Netzwerk verbrennt, und ein Priority-Tip an den Block-Proposer, und beide steigen bei Überlastung. Die praktische Folge: Derselbe USDT-Transfer kostet an einem ruhigen Sonntag Cent-Beträge und deutlich mehr während eines populären Mints.

Was die API für Sie erledigt

Gas-Limit, Gas-Preis und die EIP-1559-Caps (maxFeePerGas, maxPriorityFeePerGas) sind optionale Request-Felder – lassen Sie sie weg, füllt die API sie aus, wenn sie Ihre Transaktion baut, oder pinnen Sie sie pro Request, wenn Sie die Kontrolle wollen. Zwei Dinge bleiben Ihre Verantwortung: ETH auf sendenden Wallets zu halten, und zu entscheiden, wo kleine Transfers ökonomisch Sinn ergeben – nähern sich Mainnet-Gebühren dem Transferbetrag, ist derselbe Aufruf auf Polygon oder Arbitrum nur eine Pfadänderung entfernt.

Empfangen ist kostenlos

Eine Deposit-Adresse braucht kein ETH, um Token anzunehmen. Gas wird erst zu Ihrem Problem, wenn Gelder rausgehen – auch beim Fegen von Kunden-Deposits in eine Treasury-Wallet, was selbst eine ausgehende Transaktion von jeder Deposit-Adresse ist.

Seit dem Wechsel zu Proof of Stake ist Ethereums Timing fest statt statistisch. Blöcke kommen in Zwölf-Sekunden-Slots, 32 Slots bilden eine Epoche von 6,4 Minuten, und ein Block ist nach etwa zwei Epochen final – nennen wir es 13 Minuten –, sobald zwei Drittel des gestakten ETH ihn attestiert haben (Protokollparameter Stand Mitte 2026). Final bedeutet, dass das Netzwerk den Block nicht zurücknehmen kann, ohne einen großen Anteil des gesamten gestakten ETH zu zerstören, was ihn in eine andere Kategorie als Bitcoins probabilistische Abwicklung stellt.

Für die Zahlungslogik liest sich die Zeitlinie so: Ein Transfer ist typischerweise innerhalb von Sekunden bis einer Minute in einem Block enthalten; jeder weitere Slot fügt Sicherheit hinzu; nach etwa 13 Minuten ist er im strengen Sinne final. Die meisten Anwendungen schreiben Deposits deutlich vor Finalität gut – Inklusion plus eine Handvoll Blöcke deckt Alltagsbeträge ab –, während Börsen große Abhebungen üblicherweise bis zur Finalisierung halten. Der Deposit-Webhook gibt Ihnen das On-Chain-Event; wo Sie die Gutschrift-Grenze setzen, ist eine Policy-Zeile in Ihrer Config, nicht in unserer.

USDT, USDC, DAI und die anderen etablierten Token funktionieren sofort, mit Beträgen in Token-Einheiten statt rohen Basiseinheiten. Launchen Sie Ihr eigenes ERC-20? Liefern Sie die Contract-Adresse, und derselbe Endpoint sendet es. Kein Listing-Prozess, kein Warten. Hintergrund zum Standard selbst steht in unserem ERC-20-Token-Guide.

• Es ist die am weitesten verbreitete Smart-Contract-Plattform, seit 2015 bewährt.
• Das DeFi-Ökosystem ist das größte aller Chains, mit Tausenden dApps zum Integrieren.
• Die Gas-Bepreisung ist dynamisch, basierend auf Netzwerknachfrage; Sie können die Gebührenfelder der API überlassen oder pro Request mit den EIP-1559-Parametern deckeln.
• Scaling-Arbeit geht weiter, und Polygon und Arbitrum sind über dieselbe API verfügbar, wenn Mainnet-Gebühren beißen.

Das ERC-20-Routenmuster wiederholt sich über EVM-Netzwerke: /api/v2/polygon/transactions/erc20, /api/v2/arbitrum/transactions/erc20, und /api/v2/bsc/transactions/bep20 für BNB Smart Chain. Für Ethereum geschriebener Code portiert durch Editieren des Pfads. Wird Mainnet-Gas für kleine Transfers zu teuer, ist der Umzug zu Polygon eine Ein-Zeilen-Änderung. Die vollständige Chain-Liste steht in der Blockchain-API-Übersicht.

Die obigen Bausteine decken die meisten Produktionsmuster ab, die wir sehen: Checkout-Flows, die USDT oder USDC annehmen, Börsen, die Deposits gutschreiben und Abhebungen im großen Maßstab verarbeiten, Token-Projekte, die per Airdrop oder Vesting-Plan verteilen, und Abo-Geschäfte, die jeden Monat in Stablecoins abrechnen. Alle reduzieren sich auf dieselben zwei Aufrufe: eine Transaktion senden, einen Webhook empfangen.

Stablecoin-Checkout für einen Web-Shop

Der Kunde wählt „mit USDT bezahlen“, und Ihr Backend weist eine Deposit-Adresse für die Bestellung zu – eine Adresse pro Rechnung, sodass Zuordnung nie vom Abgleich nach Beträgen abhängt. Zeigen Sie die Adresse mit dem Betrag an, warten Sie dann auf den Webhook. Kommt die Benachrichtigung, kippen Sie die Bestellung auf „Zahlung erkannt“, sodass der Käufer schnell eine Reaktion sieht; schreiben Sie gut, sobald die Transaktion die von Ihrer Policy verlangte Tiefe hat (der Finalitäts-Abschnitt oben liefert die Zahlen). Ein Randfall gehört von Tag eins in den Code: Wallets, die Gebühren vom eingegebenen Betrag abziehen, erzeugen leichte Unterzahlungen, und Ihre Toleranz dafür sollte ein Config-Wert sein, kein Support-Ticket.

Abhebungen für eine Trading-Plattform

Nutzer fordern Auszahlungen an; Ihre Aufgabe ist es, viele ERC-20-Transfers zuverlässig zu senden. Reihen Sie jede Abhebung in Ihrer Datenbank mit einer Status-Spalte ein, arbeiten Sie die Queue dann mit POST /api/v2/ethereum/transactions/erc20 ab – ein Request pro Auszahlung, die Antwort speichern, bevor es zur nächsten geht. Die Regel, die Auditoren glücklich macht: Ein getimeouteter HTTP-Aufruf ist keine fehlgeschlagene Transaktion. Verifizieren Sie gegen Ihre Aufzeichnungen und GET /api/v2/ethereum/transactions, das jede über die API erstellte Transaktion listet, bevor Sie irgendetwas erneut senden, oder Sie zahlen jemanden doppelt. Überwachen Sie auch das ETH-Guthaben der Treasury-Wallet, da jeder ausgehende Transfer Gas verbrennt, und alarmieren Sie deutlich, bevor es leer läuft, statt erst wenn die Queue stockt.

Es gibt hier zwei Fehlerebenen: HTTP-Fehler von der API, und On-Chain-Bedingungen, die Ihre Logik absorbieren muss.

Die HTTP-Seite folgt Konventionen. Ein 401 bedeutet, dass der Key fehlt oder ungültig ist – ein Config-Problem, kein Retry-Kandidat. Andere 4xx-Antworten sagen, dass der Request falsch ist: eine fehlerhafte Adresse, ein unbekannter Contract, ein fehlendes Feld. Loggen Sie den Response-Body und korrigieren Sie den Aufrufer. Retries mit Backoff gehören ausschließlich zu 5xx-Antworten und Netzwerk-Timeouts.

Die Chain-Seite ist, wo sich Payments-Code sein Geld verdient. Ein Transfer aus einer Wallet ohne genug ETH für Gas scheitert, selbst wenn das Token-Guthaben reichlich ist – überwachen Sie Gas-Guthaben proaktiv, statt sie in einer Fehlermeldung leer vorzufinden. Überlastung kann Inklusion verzögern; das ist eine Verzögerung, kein Fehlschlag, und Ihre UI sollte die beiden unterscheiden. Und die Regel aus dem Abhebungs-Walkthrough sei wiederholt, weil sie vor dem teuersten Fehler in diesem Bereich schützt: Senden Sie einen Transfer nie erneut, nur weil die HTTP-Antwort nie ankam. Bestätigen Sie zuerst, dass es wirklich nicht passierte.

Bauen Sie für Deposits eine Reconciliation-Gewohnheit auf. GET /api/v2/ethereum/webhooks/notifications listet, was zugestellt wurde; ein nächtlicher Diff gegen Ihr Ledger fängt alles, was ein Bug oder Ausfall verschluckte, während die Korrektur noch günstig ist.

Fügen Sie X-Network: testnet zu jedem Request hinzu, und er läuft auf dem Testnetzwerk. Routen, Request-Bodies und Response-Formate bleiben identisch zu Mainnet, was bedeutet, dass Ihre Integrationstests den echten Code-Pfad ausüben statt Mocks. Füllen Sie eine Test-Wallet aus einem öffentlichen Faucet, führen Sie Transfers aus, empfangen Sie Webhooks – der gesamte Loop kostet nichts.

Strukturieren Sie es so, dass der Header aus der Konfiguration kommt: Staging setzt ihn, Produktion nicht, und es gibt keinen Code-Unterschied zwischen beiden. Geben Sie Staging auch eine separate Callback-URL, sonst landen Test-Deposits in Ihrem Produktions-Webhook-Handler. Live gehen ist dann das Entfernen eines Headers, bewusst anti-klimaktisch.