Aller au contenu

Réseaux pris en charge et testnets

Chaingateway prend en charge sept blockchains : Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum et Solana. Chacune dispose d’un mainnet et d’un testnet. Vous choisissez le réseau pour chaque requête avec l’en-tête X-Network, qui prend la valeur mainnet ou testnet, et le segment de chemin sélectionne la chaîne, par exemple /api/v2/tron/....

Sélection du réseau : le segment de chemin choisit la chaîne, l'en-tête X-Network choisit mainnet ou testnet Requête vers /api/v2/{chain}/... chain : ethereum, tron, bsc, bitcoin, polygon,arbitrum ou solana En-tête X-Network testnet, ou mainnet (valeur par défaut sil'en-tête est absent) Le réseau répond p. ex. Ethereum Sepolia ou Ethereum mainnet
Deux entrées sélectionnent le réseau : le chemin et l'en-tête.

Toutes les requêtes vont vers https://app.chaingateway.io/api/v2/{chain}/.... Le tableau liste le réseau associé à chaque combinaison de chaîne et de valeur X-Network.

Type de réseauBlockchainRéseauValeur de l’en-tête X-Network
MainnetEthereummainnetmainnet
TestnetEthereumsepoliatestnet
MainnetTronmainnetmainnet
TestnetTronniletestnet
MainnetBinance Smart Chainmainnetmainnet
TestnetBinance Smart Chaintestnettestnet
MainnetBitcoinmainnetmainnet
TestnetBitcointestnet3testnet
MainnetPolygonmainnetmainnet
TestnetPolygonamoytestnet
MainnetArbitrummainnetmainnet
TestnetArbitrumarbitrum sepoliatestnet
MainnetSolanamainnetmainnet
TestnetSolanadevnettestnet

Ajoutez l’en-tête X-Network: testnet pour exécuter une requête sur le réseau de test. Retirez l’en-tête, ou envoyez mainnet, pour utiliser le réseau principal. Le fichier OpenAPI définit l’en-tête comme optionnel avec la valeur par défaut mainnet : une requête sans lui s’exécute donc sur le réseau principal. L’appel suivant lit le dernier bloc d’Ethereum Sepolia.

Fenêtre de terminal
curl --request GET \
--url https://app.chaingateway.io/api/v2/ethereum/blocks/number \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'X-Network: testnet'

Les listes de notifications de webhook sont limitées à une blockchain et à un réseau : envoyez donc la même valeur X-Network pour les lire que lors de la création du webhook. Utilisez un seul token API pour les deux réseaux et définissez l’en-tête dans la configuration du client, afin qu’un environnement de test ne puisse pas atteindre le mainnet par erreur.

Quelles différences existe-t-il entre les chaînes ?

Section intitulée « Quelles différences existe-t-il entre les chaînes ? »

Les familles d’endpoints se ressemblent, mais chaque chaîne a son propre modèle de transaction, de sorte que certains paramètres diffèrent. Le tableau résume ce que le fichier OpenAPI définit pour chaque chaîne.

BlockchainCoin natif dans l’APIStandards de tokenWebhooksRemarques
EthereumETHERC20, ERC721ouigasprice et recherches du propriétaire et de l’URI des NFT
Binance Smart ChainBNBBEP20, BEP721ouimême ensemble d’endpoints qu’Ethereum, sous /bsc
PolygonMATICERC20, ERC721ouimême ensemble d’endpoints qu’Ethereum, sous /polygon
ArbitrumETHERC20, ERC721ouimême ensemble d’endpoints qu’Ethereum, sous /arbitrum
TronTRXTRC10, TRC20, TRC721ouistaking, délégation de ressources, construction et diffusion de transactions auto-signées
BitcoinBTCaucunouiles wallets contiennent des adresses, une transaction nomme le wallet et une speed valant fast, medium ou slow
SolanaSOLSPLnonla clé privée figure dans chaque requête de transaction

Solana n’a aucun endpoint de webhook. Pour détecter un dépôt sur Solana, interrogez le solde ou listez les transactions. Sur les chaînes EVM et sur Tron, vous pouvez créer un webhook à la place.

À quoi ressemblent les adresses sur chaque chaîne ?

Section intitulée « À quoi ressemblent les adresses sur chaque chaîne ? »

L’API valide le format de chaque adresse avant de traiter une requête, et elle répond par le statut 422 avec le nom du champ dans errors lorsqu’un format est incorrect. Les formats ci-dessous sont les modèles que définit le fichier OpenAPI.

BlockchainFormat d’adresse
Ethereum, BNB Smart Chain, Polygon, Arbitrum0x suivi de 40 caractères hexadécimaux
TronT suivi de 33 caractères alphanumériques
Bitcoincommence par bc1, tb1, 1 ou 3, puis 25 à 39 caractères
Solana32 à 44 caractères base58

Appelez GET /api/v2/{chain}/blocks/number pour la chaîne et le réseau que vous voulez tester. L’endpoint existe pour les sept chaînes et renvoie le numéro du dernier bloc. Une réponse avec ok: true montre que votre token, le chemin et l’en-tête X-Network sont corrects. Une réponse 401 avec Unauthenticated. pointe vers le token, et un 404 vers un chemin erroné. Exécutez l’appel une fois pour le mainnet et une fois avec X-Network: testnet après avoir modifié la configuration.

Où obtenir des coins de testnet et des explorateurs ?

Section intitulée « Où obtenir des coins de testnet et des explorateurs ? »

Les coins de testnet proviennent de faucets gérés par les communautés des chaînes, pas par Chaingateway. La documentation développeur de chaque chaîne liste les faucets, les explorateurs et les paramètres réseau actuels. Consultez ces pages avant de tester, car les testnets sont réinitialisés ou remplacés de temps en temps.

Le démarrage rapide montre une première requête complète. La référence API liste chaque endpoint par chaîne, et Gestion des wallets explique comment les adresses et les clés sont gérées sur chaque réseau.