Zum Inhalt springen

Unterstützte Netzwerke und Testnets

Chaingateway unterstützt sieben Blockchains: Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum und Solana. Jede hat ein Mainnet und ein Testnet. Das Netzwerk wählen Sie pro Anfrage mit dem Header X-Network, der den Wert mainnet oder testnet hat, und das Pfadsegment wählt die Chain, zum Beispiel /api/v2/tron/....

Netzwerkauswahl: Das Pfadsegment wählt die Chain, der Header X-Network wählt Mainnet oder Testnet Anfrage an /api/v2/{chain}/... chain: ethereum, tron, bsc, bitcoin, polygon,arbitrum oder solana Header X-Network testnet oder mainnet (Standard, wenn derHeader fehlt) Das Netzwerk antwortet z. B. Ethereum Sepolia oder Ethereum Mainnet
Zwei Angaben wählen das Netzwerk: der Pfad und der Header.

Alle Anfragen gehen an https://app.chaingateway.io/api/v2/{chain}/.... Die Tabelle nennt das Netzwerk hinter jeder Kombination aus Chain und X-Network-Wert.

NetzwerktypBlockchainNetzwerkX-Network-Header-Wert
MainnetEthereummainnetmainnet
TestnetEthereumsepoliatestnet
MainnetTronmainnetmainnet
TestnetTronniletestnet
MainnetBinance Smart Chainmainnetmainnet
TestnetBinance Smart Chaintestnettestnet
MainnetBitcoinmainnetmainnet
TestnetBitcointestnet3testnet
MainnetPolygonmainnetmainnet
TestnetPolygonamoytestnet
MainnetArbitrummainnetmainnet
TestnetArbitrumarbitrum sepoliatestnet
MainnetSolanamainnetmainnet
TestnetSolanadevnettestnet

Fügen Sie den Header X-Network: testnet hinzu, um eine Anfrage im Testnetz auszuführen. Entfernen Sie den Header oder senden Sie mainnet, um das Hauptnetz zu nutzen. Die OpenAPI-Datei definiert den Header als optional mit dem Standardwert mainnet, eine Anfrage ohne ihn läuft also im Hauptnetz. Der nächste Aufruf liest den neuesten Block von Ethereum Sepolia.

Terminal-Fenster
curl --request GET \
--url https://app.chaingateway.io/api/v2/ethereum/blocks/number \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'X-Network: testnet'

Listen von Webhook-Benachrichtigungen gelten für eine Blockchain und ein Netzwerk. Senden Sie deshalb beim Lesen denselben X-Network-Wert wie beim Erstellen des Webhooks. Verwenden Sie einen API-Token für beide Netzwerke und setzen Sie den Header in der Client-Konfiguration, damit eine Testumgebung das Mainnet nicht versehentlich erreicht.

Die Endpunktfamilien ähneln sich, aber jede Chain hat ein eigenes Transaktionsmodell, daher unterscheiden sich einige Parameter. Die Tabelle fasst zusammen, was die OpenAPI-Datei für jede Chain definiert.

BlockchainNative Coin in der APIToken-StandardsWebhooksHinweise
EthereumETHERC20, ERC721jagasprice sowie Abfragen von NFT-Besitzer und URI
Binance Smart ChainBNBBEP20, BEP721jaderselbe Endpunktsatz wie bei Ethereum, unter /bsc
PolygonMATICERC20, ERC721jaderselbe Endpunktsatz wie bei Ethereum, unter /polygon
ArbitrumETHERC20, ERC721jaderselbe Endpunktsatz wie bei Ethereum, unter /arbitrum
TronTRXTRC10, TRC20, TRC721jaStaking, Ressourcen-Delegation, Erstellen und Broadcasten selbst signierter Transaktionen
BitcoinBTCkeinejaWallets enthalten Adressen, eine Transaktion nennt das Wallet und eine speed von fast, medium oder slow
SolanaSOLSPLneinder Private Key steht in jeder Transaktionsanfrage

Solana hat keine Webhook-Endpunkte. Um eine Einzahlung auf Solana zu erkennen, fragen Sie das Guthaben regelmäßig ab oder listen Transaktionen auf. Auf den EVM-Chains und auf Tron können Sie stattdessen einen Webhook erstellen.

Die API prüft das Format jeder Adresse, bevor sie eine Anfrage verarbeitet, und antwortet mit Status 422 und dem Feldnamen in errors, wenn ein Format falsch ist. Die folgenden Formate sind die Muster, die die OpenAPI-Datei definiert.

BlockchainAdressformat
Ethereum, BNB Smart Chain, Polygon, Arbitrum0x gefolgt von 40 Hexadezimalzeichen
TronT gefolgt von 33 alphanumerischen Zeichen
Bitcoinbeginnt mit bc1, tb1, 1 oder 3, danach 25 bis 39 Zeichen
Solana32 bis 44 Base58-Zeichen

Rufen Sie GET /api/v2/{chain}/blocks/number für die Chain und das Netzwerk auf, die Sie testen möchten. Der Endpunkt existiert für alle sieben Chains und liefert die neueste Blocknummer. Eine Antwort mit ok: true zeigt, dass Token, Pfad und Header X-Network stimmen. Eine 401-Antwort mit Unauthenticated. weist auf den Token hin, ein 404 auf einen falschen Pfad. Führen Sie den Aufruf nach einer Konfigurationsänderung einmal für das Mainnet und einmal mit X-Network: testnet aus.

Testnet-Coins stammen von Faucets, die die Chain-Communities betreiben, nicht von Chaingateway. Die Entwicklerdokumentation jeder Chain listet aktuelle Faucets, Explorer und Netzwerkparameter auf. Prüfen Sie diese Seiten vor dem Testen, denn Testnets werden von Zeit zu Zeit zurückgesetzt oder ersetzt.

Der Schnellstart zeigt eine vollständige erste Anfrage. Die API-Referenz listet jeden Endpunkt pro Chain auf, und Wallet-Verwaltung erklärt, wie Adressen und Schlüssel in jedem Netzwerk behandelt werden.