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/....
Welche Netzwerke erreiche ich mit der API?
Abschnitt betitelt „Welche Netzwerke erreiche ich mit der API?“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.
| Netzwerktyp | Blockchain | Netzwerk | X-Network-Header-Wert |
|---|---|---|---|
| Mainnet | Ethereum | mainnet | mainnet |
| Testnet | Ethereum | sepolia | testnet |
| Mainnet | Tron | mainnet | mainnet |
| Testnet | Tron | nile | testnet |
| Mainnet | Binance Smart Chain | mainnet | mainnet |
| Testnet | Binance Smart Chain | testnet | testnet |
| Mainnet | Bitcoin | mainnet | mainnet |
| Testnet | Bitcoin | testnet3 | testnet |
| Mainnet | Polygon | mainnet | mainnet |
| Testnet | Polygon | amoy | testnet |
| Mainnet | Arbitrum | mainnet | mainnet |
| Testnet | Arbitrum | arbitrum sepolia | testnet |
| Mainnet | Solana | mainnet | mainnet |
| Testnet | Solana | devnet | testnet |
Wie wechsle ich zwischen Mainnet und Testnet?
Abschnitt betitelt „Wie wechsle ich zwischen Mainnet und Testnet?“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.
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.
Was unterscheidet die Chains?
Abschnitt betitelt „Was unterscheidet die Chains?“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.
| Blockchain | Native Coin in der API | Token-Standards | Webhooks | Hinweise |
|---|---|---|---|---|
| Ethereum | ETH | ERC20, ERC721 | ja | gasprice sowie Abfragen von NFT-Besitzer und URI |
| Binance Smart Chain | BNB | BEP20, BEP721 | ja | derselbe Endpunktsatz wie bei Ethereum, unter /bsc |
| Polygon | MATIC | ERC20, ERC721 | ja | derselbe Endpunktsatz wie bei Ethereum, unter /polygon |
| Arbitrum | ETH | ERC20, ERC721 | ja | derselbe Endpunktsatz wie bei Ethereum, unter /arbitrum |
| Tron | TRX | TRC10, TRC20, TRC721 | ja | Staking, Ressourcen-Delegation, Erstellen und Broadcasten selbst signierter Transaktionen |
| Bitcoin | BTC | keine | ja | Wallets enthalten Adressen, eine Transaktion nennt das Wallet und eine speed von fast, medium oder slow |
| Solana | SOL | SPL | nein | der 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.
Wie sehen Adressen auf jeder Chain aus?
Abschnitt betitelt „Wie sehen Adressen auf jeder Chain aus?“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.
| Blockchain | Adressformat |
|---|---|
| Ethereum, BNB Smart Chain, Polygon, Arbitrum | 0x gefolgt von 40 Hexadezimalzeichen |
| Tron | T gefolgt von 33 alphanumerischen Zeichen |
| Bitcoin | beginnt mit bc1, tb1, 1 oder 3, danach 25 bis 39 Zeichen |
| Solana | 32 bis 44 Base58-Zeichen |
Wie prüfe ich, ob ein Netzwerk erreichbar ist?
Abschnitt betitelt „Wie prüfe ich, ob ein Netzwerk erreichbar ist?“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.
Wo bekomme ich Testnet-Coins und Explorer?
Abschnitt betitelt „Wo bekomme ich Testnet-Coins und Explorer?“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.
- Ethereum: Netzwerkübersicht mit Testnets und Faucets.
- TRON: Netzwerkdokumentation für das Mainnet und das Nile-Testnet.
- BNB Smart Chain: Entwicklerdokumentation und Liste der JSON-RPC-Endpunkte.
- Polygon: RPC-Endpunkt-Referenz für Amoy.
- Arbitrum: Chain-Informationen für Arbitrum One und Arbitrum Sepolia.
- Bitcoin: Testanleitung für Testnet und Regtest.
- Solana: Cluster-Dokumentation für Devnet.
Wo kann ich mehr lesen?
Abschnitt betitelt „Wo kann ich mehr lesen?“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.