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/....
Quels réseaux puis-je atteindre avec l’API ?
Section intitulée « Quels réseaux puis-je atteindre avec l’API ? »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éseau | Blockchain | Réseau | Valeur de l’en-tête X-Network |
|---|---|---|---|
| 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 |
Comment passer du mainnet au testnet ?
Section intitulée « Comment passer du mainnet au testnet ? »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.
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.
| Blockchain | Coin natif dans l’API | Standards de token | Webhooks | Remarques |
|---|---|---|---|---|
| Ethereum | ETH | ERC20, ERC721 | oui | gasprice et recherches du propriétaire et de l’URI des NFT |
| Binance Smart Chain | BNB | BEP20, BEP721 | oui | même ensemble d’endpoints qu’Ethereum, sous /bsc |
| Polygon | MATIC | ERC20, ERC721 | oui | même ensemble d’endpoints qu’Ethereum, sous /polygon |
| Arbitrum | ETH | ERC20, ERC721 | oui | même ensemble d’endpoints qu’Ethereum, sous /arbitrum |
| Tron | TRX | TRC10, TRC20, TRC721 | oui | staking, délégation de ressources, construction et diffusion de transactions auto-signées |
| Bitcoin | BTC | aucun | oui | les wallets contiennent des adresses, une transaction nomme le wallet et une speed valant fast, medium ou slow |
| Solana | SOL | SPL | non | la 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.
| Blockchain | Format d’adresse |
|---|---|
| Ethereum, BNB Smart Chain, Polygon, Arbitrum | 0x suivi de 40 caractères hexadécimaux |
| Tron | T suivi de 33 caractères alphanumériques |
| Bitcoin | commence par bc1, tb1, 1 ou 3, puis 25 à 39 caractères |
| Solana | 32 à 44 caractères base58 |
Comment vérifier qu’un réseau est joignable ?
Section intitulée « Comment vérifier qu’un réseau est joignable ? »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.
- Ethereum : aperçu des réseaux avec testnets et faucets.
- TRON : documentation des réseaux pour le mainnet et le testnet Nile.
- BNB Smart Chain : documentation développeur et liste des endpoints JSON-RPC.
- Polygon : référence des endpoints RPC pour Amoy.
- Arbitrum : informations sur la chaîne pour Arbitrum One et Arbitrum Sepolia.
- Bitcoin : guide de test pour testnet et regtest.
- Solana : documentation des clusters pour le devnet.
Où en savoir plus ?
Section intitulée « Où en savoir plus ? »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.