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

Chaingateway V2.1 Beta: Testnets und Webhooks

Chaingateway V2.1 Beta vom 16. September 2024: Testnet-Unterstützung, neues Webhook-System, überarbeitetes Dashboard und Schritte zur Migration von V2.

Kapitel
C
Chaingateway Team
Blockchain-Experten

Geprüft von Maurice Sobiera

Chaingateway V2.1 ist die Neuentwicklung der Chaingateway-API und des Dashboards im Jahr 2024. Sie ergänzte Testnet-Unterstützung über den Header X-Network, ein neu gebautes Webhook-System und eine überarbeitete Benutzeroberfläche. Die Basis-URL der API wechselte von api.chaingateway.io/v2 zu app.chaingateway.io/api/v2. Dieser Hinweis listet die Änderungen und die Migrationsschritte aus der Beta-Ankündigung vom 16. September 2024 auf.

Update, 5. November 2026: V2.1 ist die aktuelle API. Seit dieser Version wurden Solana und Arbitrum ergänzt, Solana hat jedoch keine Webhooks. Der unten beschriebene Tron Paymaster ist veraltet. Krypto-Zahlungen für Tarife wurden im April 2025 umgestellt (siehe Neuer Zahlungsablauf). Die Endpunktliste steht in der OpenAPI-Datei.

Wie greife ich auf V2.1 zu?

V2.1 steht allen Kunden und Testnutzern unter app.chaingateway.io zur Verfügung. Sie wurde so entworfen, dass sie mit V2 kompatibel ist. Die meisten Integrationen brauchen deshalb nur eine neue Basis-URL. Die Migrationsschritte stehen am Ende dieses Hinweises.

Ist Ihre Testphase abgelaufen, legen Sie ein Konto an oder kontaktieren Sie uns, um die Testphase zu verlängern. Die Beta hatte außerdem eine Telegram-Community.

Was ist neu in V2.1?

Die Version enthielt diese Änderungen:

  1. Testnet-Unterstützung auf jeder Chain.
  2. Tron Paymaster, ein Gebührendienst für TRC-20-Transfers. Er ist inzwischen veraltet.
  3. API-Dokumentation mit Beispielen für Anfragen und Antworten.
  4. Ein überarbeitetes Entwicklerportal.
  5. Ein neu gestaltetes Dashboard.
  6. Sofortige Tarifwechsel bei Kartenzahlungen.
  7. Ein neu gebautes Webhook-System und eine neue Gebührenbehandlung.

Welche Testnetze werden unterstützt?

Fügen Sie einer Anfrage den Header X-Network: testnet hinzu, um das Testnetz einer Chain zu nutzen. Für das Mainnet senden Sie X-Network: mainnet oder lassen den Header weg. Alles, was Sie im Mainnet tun können, funktioniert auch im Testnetz. Das Netzwerk können Sie außerdem in der Kopfzeile des Dashboards wechseln.

ChainTestnetz in V2.1Referenz
EthereumSepoliaethereum.org: Netzwerke
TronNileTRON developer hub: Netzwerke
BNB Smart ChainBSC-TestnetBNB-Chain-Dokumentation
PolygonAmoyPolygon-Dokumentation
BitcoinTestnet3Bitcoin-Entwicklerbeispiele: Testen

Die aktuelle Liste, die auch Arbitrum Sepolia und das Solana-Devnet enthält, steht in der Dokumentation zu den unterstützten Netzwerken.

Kopfzeile des Chaingateway-Dashboards mit dem Banner „Sie sind im TESTNET-Modus“ und dem Testnet-Schalter

Was war der Tron Paymaster?

Paymaster war ein Dienst, der die Energy- und Bandwidth-Gebühren für TRC-20-Transfers bezahlte. So musste eine Wallet kein TRX halten. Er wurde getrennt vom Abo abgerechnet und kostete im Testnetz nichts. Paymaster ist veraltet. Nutzen Sie stattdessen TronFuel. Das alte Paymaster-Tutorial bleibt als Referenz erhalten.

Was hat sich bei Dokumentation und Dashboard geändert?

Die API-Dokumentation enthält mehr Beispiele für Anfragen und Antworten. Das Entwicklerportal erhielt eine neue Einstiegsanleitung und Tutorials zu den Kernfunktionen. Das Dashboard wurde neu gestaltet. Der Webhook-Monitor zeigt gesendete Nutzlasten und lässt sich nach Wert filtern.

Chaingateway-Dashboard mit Zählern für Anfragen und Transaktionen, einem Diagramm der Anfragen und einer Liste fehlgeschlagener Webhooks

Was hat sich bei der Abrechnung geändert?

Kunden, die per Karte über Stripe zahlen, können sofort auf einen höheren Tarif wechseln, statt auf den nächsten Abrechnungszyklus zu warten. Wenn Sie Ihre API-Limits erreichen, klicken Sie auf der Abrechnungsseite auf „Tarif ändern“. Die Limits steigen dann sofort. Die Rechnung zeigt nur die Preisdifferenz zwischen altem und neuem Tarif. Die Ankündigung sagte, dasselbe werde für Krypto-Zahlungen gelten. Diese kamen mit dem Zahlungsablauf vom April 2025.

Was hat sich technisch geändert?

Die API läuft auf einem neuen Technologie-Stack. Die Ankündigung wies darauf hin, dass einige Antworten leicht von V2 abweichen könnten. Nutzer wurden gebeten, Abweichungen dem Support zu melden.

Die Gebührenbehandlung wurde überarbeitet. Wenn Ihre Anfragen gasPrice, maxFeePerGas oder maxPriorityFeePerGas setzen, müssen Sie sie in V2.1 nicht mehr senden. Die Gas-Felder bleiben in der aktuellen OpenAPI-Definition optional.

Das Webhook-System wurde neu gebaut. Der Webhook-Dienst hatte in den Wochen vor dem Release Ausfälle, in denen einige Blöcke nicht verarbeitet wurden. Der Webhook-Monitor im Dashboard zeigt die gesendeten Nutzlasten. Webhooks werden nicht automatisch wiederholt. Fehlgeschlagene Benachrichtigungen werden pro Chain aufgelistet, etwa unter GET /api/v2/tron/webhooks/notifications/failed. Sie senden sie über den Retry-Endpunkt erneut.

Was war nach V2.1 geplant?

Die Ankündigung nannte drei Folgeschritte: Solana-Unterstützung, Paymaster für weitere Chains und Korrekturen an API-Antworten. Die Solana-Unterstützung ist inzwischen verfügbar. Statt Paymaster auszubauen, wurde er veraltet.

Wie migriere ich von V2 auf V2.1?

  1. Ändern Sie die Basis-URL von api.chaingateway.io/v2 zu app.chaingateway.io/api/v2.
  2. Optional, aber empfohlen: Ergänzen Sie das Präfix Bearer vor Ihrem API-Key, sodass der Header Authorization: Bearer <token> lautet.
  3. Testen Sie Ihre Integration gegen die neue URL.
  4. Solange Sie nicht vollständig migriert haben, verwalten Sie Ihr Abo im alten Dashboard.

Nutzerdaten, Adressen und API-Keys wurden während der Umstellung jede Minute von V2 nach V2.1 kopiert. In V2.1 erstellte Adressen können in V2 nicht verwendet werden. Webhooks wurden alle 10 Minuten kopiert und lösten während des Kopierens keine Benachrichtigungen aus. Wenn Sie Hilfe bei der Migration von Webhooks brauchen, kontaktieren Sie den Support.

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.