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/....
Quali reti posso raggiungere con l’API?
Sezione intitolata “Quali reti posso raggiungere con l’API?”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 rete | Blockchain | Rete | Valore dell’header 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 |
Come passo da mainnet a testnet?
Sezione intitolata “Come passo da mainnet a testnet?”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.
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.
Cosa cambia tra le chain?
Sezione intitolata “Cosa cambia tra le chain?”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.
| Blockchain | Coin nativa nell’API | Standard di token | Webhook | Note |
|---|---|---|---|---|
| Ethereum | ETH | ERC20, ERC721 | sì | gasprice e ricerche di proprietario e URI degli NFT |
| Binance Smart Chain | BNB | BEP20, BEP721 | sì | stesso insieme di endpoint di Ethereum, sotto /bsc |
| Polygon | MATIC | ERC20, ERC721 | sì | stesso insieme di endpoint di Ethereum, sotto /polygon |
| Arbitrum | ETH | ERC20, ERC721 | sì | stesso insieme di endpoint di Ethereum, sotto /arbitrum |
| Tron | TRX | TRC10, TRC20, TRC721 | sì | staking, delega di risorse, build e broadcast per transazioni firmate in autonomia |
| Bitcoin | BTC | nessuno | sì | i wallet contengono indirizzi, una transazione indica il wallet e una speed pari a fast, medium o slow |
| Solana | SOL | SPL | no | la 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.
Che formato hanno gli indirizzi su ogni chain?
Sezione intitolata “Che formato hanno gli indirizzi su ogni chain?”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.
| Blockchain | Formato dell’indirizzo |
|---|---|
| Ethereum, BNB Smart Chain, Polygon, Arbitrum | 0x seguito da 40 caratteri esadecimali |
| Tron | T seguito da 33 caratteri alfanumerici |
| Bitcoin | inizia con bc1, tb1, 1 o 3, poi da 25 a 39 caratteri |
| Solana | da 32 a 44 caratteri base58 |
Come verifico che una rete sia raggiungibile?
Sezione intitolata “Come verifico che una rete sia raggiungibile?”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.
Dove trovo coin di testnet ed explorer?
Sezione intitolata “Dove trovo coin di testnet ed explorer?”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.
- Ethereum: panoramica delle reti con testnet e faucet.
- TRON: documentazione delle reti per mainnet e testnet Nile.
- BNB Smart Chain: documentazione per sviluppatori e elenco degli endpoint JSON-RPC.
- Polygon: riferimento degli endpoint RPC per Amoy.
- Arbitrum: informazioni sulla chain per Arbitrum One e Arbitrum Sepolia.
- Bitcoin: guida ai test per testnet e regtest.
- Solana: documentazione dei cluster per devnet.
Dove posso leggere di più?
Sezione intitolata “Dove posso leggere di più?”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.