← Blog
10 Min. Lesezeit
|
Veröffentlicht
|
Aktualisiert

Blockchain-APIs in Web3-Anwendungen

Was eine Blockchain-API in Web3-Anwendungen leistet: Chain-Daten lesen, Transaktionen senden, Events melden und warum Smart Contracts Orakel brauchen.

Kapitel
C
Chaingateway Team
Blockchain-Experten

Geprüft von Maurice Sobiera

Eine Blockchain-API ist eine Web-Schnittstelle, mit der eine Anwendung Blockchain-Daten lesen und Transaktionen senden kann, ohne einen eigenen Node zu betreiben. In einer Web3-Anwendung steht sie zwischen der Benutzeroberfläche und der Chain. Smart Contracts können Web-APIs nicht selbst aufrufen. Daten von außerhalb der Chain erreichen sie deshalb über Orakel.

Dieser Artikel trennt die beiden Richtungen, in denen APIs und Blockchains zusammenwirken, und erklärt, wo jede davon eingesetzt wird.

Was leistet eine Blockchain-API in einer Web3-Anwendung?

Eine Blockchain-API gibt einer Anwendung drei Dinge: Sie liest Chain-Daten, sie sendet Transaktionen und sie meldet Events. Ohne sie müsste Ihr Backend einen Node betreiben, ihn synchron halten und Blöcke selbst parsen.

AufgabeBeispielSo funktioniert es
LesenSaldo einer Adresse, Transaktionen in einem BlockEine Anfrage an einen Node oder an einen API-Anbieter
SchreibenEinen Token-Transfer sendenDie Transaktion wird mit einem privaten Schlüssel signiert und dann ins Netzwerk übertragen
BenachrichtigenDem Backend melden, dass eine Einzahlung eingegangen istEin Webhook oder Polling des Nodes

Chaingateway ist eine solche API. Ihre Endpunkte für Wallets, Transfers und Webhooks listet die OpenAPI-Datei. Webhooks gibt es für Bitcoin, Ethereum, BNB Smart Chain, Polygon, Arbitrum und Tron. Solana hat keine Webhooks. Eine Solana-Anwendung muss deshalb abfragen.

Warum kann ein Smart Contract keine Web-API aufrufen?

Ein Smart Contract kann keine Web-API aufrufen, weil jeder Node ihn ausführen muss und dabei zum selben Ergebnis kommen soll. Die Dokumentation von Ethereum hält fest, dass das Einbeziehen externer Daten Determinismus unmöglich machen würde. Eine Preis-API könnte verschiedenen Nodes unterschiedliche Werte liefern. Die Nodes wären dann nicht mehr einig über den Zustand der Chain (ethereum.org: Orakel).

Das ist eine Eigenschaft des Designs. Sie hängt weder von der Programmiersprache der Chain noch von einer bestimmten API ab. Daraus folgt: Daten müssen erst durch eine Transaktion auf die Chain gebracht werden, bevor ein Contract sie nutzen kann.

Wie gelangen Off-Chain-Daten in einen Smart Contract?

Off-Chain-Daten erreichen einen Contract über ein Orakel. Ein Orakel ist eine Anwendung, die externe Informationen beschafft, prüft und an Smart Contracts übermittelt. Ein Kreditprotokoll, das den Preis eines Assets braucht, oder ein Contract, der von Wetter- oder Flugdaten abhängt, benötigt ein solches Orakel.

Die Ethereum-Dokumentation beschreibt zwei gängige Muster:

  • Publish-Subscribe: Das Orakel veröffentlicht einen Datenfeed, und Contracts lesen ihn. Das passt zu Daten, die sich oft ändern, etwa Token-Preisen.
  • Request-Response: Ein Contract fordert bestimmte Daten an, und das Orakel antwortet in einem Callback. Das passt zu großen Datensätzen, von denen ein Contract nur einen kleinen Teil braucht. Der Anfragende zahlt für die Abfrage und das Gas des Callbacks.

Ein Orakel, das eine einzige Partei betreibt, ist ein Single Point of Failure. Fällt diese Partei aus, wird gehackt oder liefert falsche Daten, handelt der Contract mit falschen Daten. Dieselbe Dokumentation beschreibt dezentrale Orakel-Dienste, bei denen mehrere Teilnehmer die Daten abstimmen, bevor sie den Contract erreichen. Dezentralisierung ist ein Spektrum. Sie müssen trotzdem entscheiden, wie sehr Sie dem gewählten Orakel vertrauen.

Welche API braucht man für welche Aufgabe?

Die Antwort hängt von der Richtung des Datenflusses ab.

RichtungProblemWerkzeug
Chain zur AnwendungSalden lesen, Transfers senden, Einzahlungen meldenBlockchain-API oder eigener Node
Außenwelt zum ContractEinem Contract einen Preis, einen Score oder einen Wetterwert gebenOrakel
Contract zur AußenweltNach einem On-Chain-Event eine Aktion auslösenEvent-Logs, die ein Dienst liest, oder ein Orakel

Ein Zahlungssystem nutzt nur die erste Zeile. Ein Nutzer zahlt an eine Adresse, ein Webhook erreicht Ihr Backend, und Ihr Backend schreibt das Guthaben in der eigenen Datenbank gut. Ein Orakel ist dabei nicht beteiligt. Wie Sie die Arbeit zwischen Chain und Datenbank aufteilen, zeigt Blockchain vs. Datenbank.

Wie liest eine Anwendung Events aus einem Contract?

Eine Anwendung liest Contract-Events über Logs. Wenn ein Contract ein Event auslöst, speichert der Node es im Transaktions-Receipt. Die Methode eth_getLogs der Ethereum-JSON-RPC-API, die der JSON-RPC-2.0-Spezifikation folgt, liefert die Logs, die einem Filter entsprechen. Das ist der übliche Weg, Token-Transfers zu finden.

Ein Filter auf ERC-20-Transfer-Events eines Tokens in einem Blockbereich sieht so aus:

{
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [{
"fromBlock": "0x10d4f00",
"toBlock": "0x10d4f0a",
"address": "0xTokenContract",
"topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
}],
"id": 1
}

Das erste Topic ist der Hash der Event-Signatur Transfer(address,address,uint256). Die anderen Topics enthalten die indizierten Argumente, hier Absender und Empfänger. Der Betrag steht als Hex-Zahl im Feld data jedes Logs.

Blockbereiche sind wichtig. Viele Anbieter begrenzen den Bereich oder die Anzahl der Ergebnisse eines einzelnen eth_getLogs-Aufrufs. Ein Scanner muss deshalb blockweise durch die Chain paginieren. Eine Blockchain-API, die diese Logs für Sie decodiert oder als Webhooks zustellt, entfernt diesen Code. Sie ändert aber nichts an deren Bedeutung: Ein Log in einem Block, der später reorganisiert wird, verschwindet mit diesem Block.

Welche Grenzen haben Blockchain-APIs?

Eine API ändert nichts an der Funktionsweise der Chain. Eine Transaktion ist erst final, wenn die Chain das bestätigt. Eine API kann sie früher als ausstehend oder bestätigt melden. Behandeln Sie eine Einzahlung erst als abgeschlossen, wenn die Finalitätsregeln der Chain erfüllt sind.

Fehlgeschlagene Webhook-Zustellungen werden nicht automatisch wiederholt. Chaingateway listet sie im Endpunkt für fehlgeschlagene Benachrichtigungen jeder Chain auf, zum Beispiel GET /api/v2/tron/webhooks/notifications/failed. Sie senden sie über den Retry-Endpunkt erneut. Ein Backend, das Webhooks verarbeitet, sollte außerdem idempotent sein. So bucht eine erneut gesendete Benachrichtigung kein Guthaben doppelt.

Eine gehostete API schafft zudem eine Abhängigkeit vom Anbieter. Wenn Sie direkten Protokollzugriff brauchen, können Sie weiterhin einen Node betreiben und ihn über JSON-RPC ansprechen.

So entstehen diese Artikel

Möchten Sie das selbst umsetzen? API-Key erhalten — 7 Tage kostenlos testen, keine Karte nötig — oder werfen Sie einen Blick auf Blockchain-API für die vollständige Endpoint-Referenz.

C
Chaingateway Team
Blockchain-Experten

Das Chaingateway-Team hat es sich zur Aufgabe gemacht, die Blockchain-Integration für Entwickler weltweit zu vereinfachen.