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

Mehrere Blockchains mit einer REST-API integrieren

Mehrere Blockchains über eine REST-API integrieren: Netzwerke, Token-Endpunkte je Chain, Ein- und Auszahlungsablauf und die Unterschiede, die bestehen bleiben.

Kapitel
C
Chaingateway Team
Blockchain-Experten

Geprüft von Maurice Sobiera

Mehrere Blockchains zu integrieren heißt, dass ein Backend über eine einzige Schnittstelle mit mehreren Chains spricht. Es braucht dafür nicht je Chain eine eigene Client-Bibliothek. Mit Chaingateway rufen Sie REST-Endpunkte mit einem Bearer-Token auf. Dasselbe Muster deckt Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron, Bitcoin und Solana ab, innerhalb der Grenzen, die jede Chain setzt.

Welche Blockchains und Token-Standards deckt die API ab?

Die API deckt sieben Chains ab, und jede hat ein Testnetz. Mit dem Header X-Network: testnet wechseln Sie ins Testnetz. Die Seite unterstützte Netzwerke listet die Testnetze. Token-Transfers haben pro Chain einen Endpunkt:

ChainToken- und NFT-Endpunkte in der OpenAPI-DateiTestnetz
Ethereumtransactions/erc20, transactions/erc721Sepolia
BNB Smart Chaintransactions/bep20, transactions/bep721BSC-Testnetz
Polygontransactions/erc20, transactions/erc721Amoy
Arbitrumtransactions/erc20, transactions/erc721Arbitrum Sepolia
Trontransactions/trc20, transactions/trc721, transactions/trc10Nile
Solanatransactions/SPLDevnet
Bitcointransactions (nur native Währung)Testnet3

Jeder Pfad beginnt mit /api/v2/<chain>/. Die vollständige Liste steht in der OpenAPI-Datei.

Wie baut man darauf einen Ein- und Auszahlungsdienst?

Ein Ablauf im Stil einer Verwahrung hat drei Teile: eine Adresse je Kunde, einen Webhook je Adresse und einen Auszahlungsaufruf. Jeder Teil ist eine Anfrage. Jeder Teil hat auf jeder unterstützten Chain dieselbe Form.

  1. Erstellen Sie eine Einzahlungsadresse. Auf EVM-Chains und Tron ist das POST /api/v2/<chain>/addresses. Die Antwort enthält die Adresse. Übergeben Sie ein password, damit der Schlüssel verschlüsselt gespeichert wird. Ohne Passwort enthält die Antwort den privaten Schlüssel, und Sie müssen ihn selbst speichern.
  2. Registrieren Sie einen Webhook für die Adresse. POST /api/v2/<chain>/webhooks nimmt die url des Empfängers, die Adresse in to, einen type wie ERC20 oder TRC20 und optional eine contractaddress sowie eine reference mit bis zu 255 Zeichen entgegen.
  3. Zahlen Sie aus. Eine Auszahlung eines ERC20-Tokens ist eine Anfrage:
Terminal window
curl -X POST https://app.chaingateway.io/api/v2/ethereum/transactions/erc20 \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"from": "0xHotWalletAddress",
"to": "0xCustomerAddress",
"contractaddress": "0xTokenContract",
"amount": 100,
"password": "hot-wallet-password"
}'

Auf BNB Smart Chain ersetzen Sie ethereum/transactions/erc20 durch bsc/transactions/bep20. Auf Tron nutzen Sie tron/transactions/trc20. Er nimmt dieselben Felder entgegen, abgesehen von den Gas-Einstellungen. Solana ist anders: solana/transactions/SPL verlangt den privatekey des Absenders und akzeptiert kein Wallet-Passwort. Der Artikel zu persönlichen Secrets erklärt, wie Sie die eingehenden Benachrichtigungen prüfen.

Was passiert, wenn eine Anfrage fehlschlägt?

Die API liefert einen JSON-Body mit status, ok und message. Ein 401 mit der Meldung „Wrong password provided“ bedeutet, dass das Wallet-Passwort nicht passt.

Ein 422 trägt die eigene Fehlermeldung des Nodes, zum Beispiel insufficient funds for gas * price + value. Der chainspezifische Teil ist der Grund. Ein ERC20-Transfer auf Ethereum braucht ETH für Gas auf der Absenderadresse. Ein TRC20-Transfer braucht Energy und Bandwidth oder TRX zum Verbrennen. Prüfen Sie die Guthaben, bevor Sie es erneut versuchen. Ein Wiederholen behebt eine fehlende Gebühr nicht.

Fehlgeschlagene Webhook-Benachrichtigungen werden nicht automatisch erneut gesendet. Listen Sie sie mit GET /api/v2/<chain>/webhooks/notifications/failed auf und senden Sie jede über den Retry-Endpunkt erneut. Eine erneut gesendete Benachrichtigung kann nach anderen eintreffen. Machen Sie den Empfänger deshalb idempotent über die txid.

Was bleibt zwischen den Chains verschieden?

Einiges bleibt verschieden, und die API verbirgt es nicht:

  • Gebühren: Ethereum, BNB Smart Chain, Polygon und Arbitrum nutzen Gas, mit einem Endpunkt gasprice je Chain. Tron nutzt Energy und Bandwidth.
  • Webhooks: alle Chains außer Solana.
  • Wallets: Bitcoin arbeitet mit benannten Wallets, die mehrere Adressen halten. Sie entstehen über POST /api/v2/bitcoin/wallets.
  • Vermögenswerte: Derselbe Token auf zwei Chains sind zwei getrennte Vermögenswerte. Die API überbrückt zwischen ihnen nicht.

Mit welcher Chain sollten Sie anfangen?

Beginnen Sie mit der Chain, die Ihre Kunden bereits nutzen. Weitere Chains ergänzen Sie, indem Sie dieselben Handler wiederverwenden. Auszahlungsformulare von Börsen nennen das Netzwerk, zum Beispiel ERC-20, BEP-20 oder TRC-20. Fragen Sie Ihre ersten Kunden, in welchem Netzwerk sie USDT halten, bevor Sie die zweite Integration bauen.

Was sollten Sie je Chain speichern?

Ein Dienst über mehrere Chains braucht die Chain in jedem Datensatz. Dieselbe Zeichenkette kann auf mehreren Chains gültig sein. Speichern Sie mindestens diese Felder:

FeldWarum es nötig ist
chain und network0x-Adressen sind auf Ethereum, BNB Smart Chain, Polygon und Arbitrum gültig. Mainnet und Testnet sehen gleich aus.
address im eigenen Format der ChainTron nutzt Base58-Adressen, die mit T beginnen. Die Hex-Form mit Präfix 41 taucht in rohen Node-Daten auf.
contractaddress und typeDerselbe Token hat auf jeder Chain einen anderen Contract.
txidDer Schlüssel zur Deduplizierung von Webhook-Benachrichtigungen und für Abfragen.
referenceIhre Bestell- oder Kunden-ID, gesetzt beim Registrieren des Webhooks.
Betrag in der Basiseinheit der ChainDie Dezimalstellen unterscheiden sich je Token. Rechnen Sie nur in der Anzeige um.

Legen Sie eine eindeutige Constraint auf (chain, network, txid) fest. Gleichen Sie regelmäßig gegen eine zweite Quelle ab, etwa die Liste der fehlgeschlagenen Benachrichtigungen und einen Block-Explorer.

Wie fangen Sie an?

Beginnen Sie im Testnetz. Legen Sie eine Adresse auf Sepolia und eine auf Nile an. Registrieren Sie für jede einen Webhook, senden Sie einen Testtransfer und prüfen Sie, dass Ihr Empfänger beide Benachrichtigungen verarbeitet. Die 7-tägige Testphase braucht weder Karte noch KYC.

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.