Salta ai contenuti

Reti blockchain e testnet supportate

Chaingateway supporta sette blockchain: Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum e Solana. Ognuna ha una mainnet e una testnet. Scegli la rete a ogni richiesta con l’header X-Network, che accetta il valore mainnet o testnet, mentre il segmento di percorso seleziona la chain, ad esempio /api/v2/tron/....

Selezione della rete: il segmento di percorso sceglie la chain, l'header X-Network sceglie mainnet o testnet Richiesta a /api/v2/{chain}/... chain: ethereum, tron, bsc, bitcoin, polygon,arbitrum o solana Header X-Network testnet, oppure mainnet (il valore predefinitose l'header manca) Risponde la rete ad es. Ethereum Sepolia o Ethereum mainnet
Due elementi selezionano la rete: il percorso e l'header.

Tutte le richieste vanno a https://app.chaingateway.io/api/v2/{chain}/.... La tabella elenca la rete corrispondente a ogni combinazione di chain e valore X-Network.

Tipo di reteBlockchainReteValore dell’header X-Network
MainnetEthereummainnetmainnet
TestnetEthereumsepoliatestnet
MainnetTronmainnetmainnet
TestnetTronniletestnet
MainnetBinance Smart Chainmainnetmainnet
TestnetBinance Smart Chaintestnettestnet
MainnetBitcoinmainnetmainnet
TestnetBitcointestnet3testnet
MainnetPolygonmainnetmainnet
TestnetPolygonamoytestnet
MainnetArbitrummainnetmainnet
TestnetArbitrumarbitrum sepoliatestnet
MainnetSolanamainnetmainnet
TestnetSolanadevnettestnet

Aggiungi l’header X-Network: testnet per eseguire una richiesta sulla rete di test. Rimuovi l’header, oppure invia mainnet, per usare la rete principale. Il file OpenAPI definisce l’header come opzionale con il valore predefinito mainnet, quindi una richiesta senza header viene eseguita sulla rete principale. La chiamata seguente legge l’ultimo blocco di Ethereum Sepolia.

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

Gli elenchi delle notifiche webhook sono limitati a una blockchain e a una rete, quindi invia lo stesso valore X-Network sia quando li leggi sia quando hai creato il webhook. Usa un solo token API per entrambe le reti e imposta l’header nella configurazione del client, così un ambiente di test non può raggiungere la mainnet per errore.

Le famiglie di endpoint sono simili, ma ogni chain ha un proprio modello di transazione, quindi alcuni parametri differiscono. La tabella riassume ciò che il file OpenAPI definisce per ciascuna chain.

BlockchainCoin nativa nell’APIStandard di tokenWebhookNote
EthereumETHERC20, ERC721sìgasprice e ricerche di proprietario e URI degli NFT
Binance Smart ChainBNBBEP20, BEP721sìstesso insieme di endpoint di Ethereum, sotto /bsc
PolygonMATICERC20, ERC721sìstesso insieme di endpoint di Ethereum, sotto /polygon
ArbitrumETHERC20, ERC721sìstesso insieme di endpoint di Ethereum, sotto /arbitrum
TronTRXTRC10, TRC20, TRC721sìstaking, delega di risorse, build e broadcast per transazioni firmate in autonomia
BitcoinBTCnessunosìi wallet contengono indirizzi, una transazione indica il wallet e una speed pari a fast, medium o slow
SolanaSOLSPLnola private key va in ogni richiesta di transazione

Solana non ha endpoint webhook. Per rilevare un deposito su Solana, interroga il saldo oppure elenca le transazioni. Sulle chain EVM e su Tron puoi invece creare un webhook.

L’API valida il formato di ogni indirizzo prima di elaborare una richiesta e risponde con lo stato 422 e il nome del campo in errors quando un formato è errato. I formati seguenti sono i pattern definiti dal file OpenAPI.

BlockchainFormato dell’indirizzo
Ethereum, BNB Smart Chain, Polygon, Arbitrum0x seguito da 40 caratteri esadecimali
TronT seguito da 33 caratteri alfanumerici
Bitcoininizia con bc1, tb1, 1 o 3, poi da 25 a 39 caratteri
Solanada 32 a 44 caratteri base58

Chiama GET /api/v2/{chain}/blocks/number per la chain e la rete che vuoi testare. L’endpoint esiste per tutte e sette le chain e restituisce il numero dell’ultimo blocco. Una risposta con ok: true mostra che il token, il percorso e l’header X-Network sono corretti. Una risposta 401 con Unauthenticated. indica un problema del token, mentre un 404 indica un percorso errato. Dopo ogni modifica della configurazione, esegui la chiamata una volta per la mainnet e una volta con X-Network: testnet.

Le coin di testnet provengono da faucet gestiti dalle community delle chain, non da Chaingateway. La documentazione per sviluppatori di ogni chain elenca faucet, explorer e parametri di rete aggiornati. Consulta quelle pagine prima di testare, perché le testnet vengono azzerate o sostituite di tanto in tanto.

La Guida rapida mostra una prima richiesta completa. L’API reference elenca ogni endpoint per chain, e Gestione wallet spiega come vengono gestiti indirizzi e chiavi su ciascuna rete.