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.
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:
| Chain | Token- und NFT-Endpunkte in der OpenAPI-Datei | Testnetz |
|---|---|---|
| Ethereum | transactions/erc20, transactions/erc721 | Sepolia |
| BNB Smart Chain | transactions/bep20, transactions/bep721 | BSC-Testnetz |
| Polygon | transactions/erc20, transactions/erc721 | Amoy |
| Arbitrum | transactions/erc20, transactions/erc721 | Arbitrum Sepolia |
| Tron | transactions/trc20, transactions/trc721, transactions/trc10 | Nile |
| Solana | transactions/SPL | Devnet |
| Bitcoin | transactions (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.
- Erstellen Sie eine Einzahlungsadresse. Auf EVM-Chains und Tron ist das
POST /api/v2/<chain>/addresses. Die Antwort enthält die Adresse. Übergeben Sie einpassword, 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. - Registrieren Sie einen Webhook für die Adresse.
POST /api/v2/<chain>/webhooksnimmt dieurldes Empfängers, die Adresse into, einentypewieERC20oderTRC20und optional einecontractaddresssowie einereferencemit bis zu 255 Zeichen entgegen. - Zahlen Sie aus. Eine Auszahlung eines ERC20-Tokens ist eine Anfrage:
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
gaspriceje 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:
| Feld | Warum es nötig ist |
|---|---|
chain und network | 0x-Adressen sind auf Ethereum, BNB Smart Chain, Polygon und Arbitrum gültig. Mainnet und Testnet sehen gleich aus. |
address im eigenen Format der Chain | Tron nutzt Base58-Adressen, die mit T beginnen. Die Hex-Form mit Präfix 41 taucht in rohen Node-Daten auf. |
contractaddress und type | Derselbe Token hat auf jeder Chain einen anderen Contract. |
txid | Der Schlüssel zur Deduplizierung von Webhook-Benachrichtigungen und für Abfragen. |
reference | Ihre Bestell- oder Kunden-ID, gesetzt beim Registrieren des Webhooks. |
| Betrag in der Basiseinheit der Chain | Die 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.
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.