API blockchain o nodo: quale scegliere
Un nodo sincronizza e conserva l'intera catena. Un'API blockchain ospita i nodi e aggiunge dati decodificati e webhook. Costi, compromessi e quando scegliere.
Verificato da Maurice Sobiera
Un nodo blockchain è un software che sincronizza, valida e conserva una blockchain e risponde a richieste di basso livello su di essa. Un’API blockchain è un servizio ospitato che gestisce nodi al posto tuo e restituisce JSON decodificato, spesso con webhook. Scegli un nodo per il controllo totale e un’API per far partire i pagamenti senza gestire infrastruttura.
Di che cosa hai bisogno per interagire con una blockchain?
Ogni applicazione che legge saldi, invia transazioni o reagisce ai depositi ha bisogno di una connessione a un nodo. Prendi un deposito su un exchange: un utente vede un indirizzo Tron e invia 100 TRX. L’exchange deve sapere che il trasferimento è arrivato. Può scansionare da solo ogni nuovo blocco, oppure può chiedere a un servizio di chiamarlo quando un indirizzo riceve fondi. La lettura di un saldo funziona allo stesso modo. Quando cerchi un indirizzo su un explorer come Etherscan, l’explorer ha preso quel numero da un nodo.
Che cosa serve per far girare un nodo proprio?
Installi un client, attendi la sincronizzazione iniziale e mantieni la macchina aggiornata, con backup e monitoraggio. L’hardware dipende dalla catena. Per Ethereum, la documentazione ufficiale sui nodi indica come minimo 2 core CPU, 16 GB di RAM, un SSD NVMe da 2 TB e 25 Mbit/s di banda (verificato il 5 novembre 2026). Questi numeri cambiano con le release dei client e con la crescita della catena, e la pagina stessa osserva che il requisito del disco sarà probabilmente superato entro il 2027. Un nodo Ethereum richiede due programmi, un client di esecuzione e un client di consenso (ethereum.org). Le altre catene hanno requisiti propri: un full node Bitcoin e un full node Tron richiedono ciascuno un proprio client, un proprio disco e un proprio tempo di sincronizzazione.
Un nodo restituisce dati grezzi. Sull’interfaccia JSON-RPC di Ethereum le quantità sono stringhe esadecimali. Una richiesta di saldo restituisce qualcosa come 0x2386f26fc10000, che equivale a 10^16 wei, cioè 0,01 ETH, e il tuo codice deve convertirlo. I trasferimenti di token sono voci di log che si decodificano con l’ABI del contratto.
Rilevare i depositi è la parte più difficile. I nodi Ethereum possono inviare eventi tramite una sottoscrizione WebSocket, ma una connessione caduta lascia un vuoto che si colma scansionando i blocchi. Uno scanner scritto da te deve fare quanto segue:
- Recuperare ogni nuovo blocco, o i log che corrispondono all’evento
Transferdel token. - Confrontare il destinatario di ogni trasferimento con la tua lista di indirizzi dei clienti.
- Attendere abbastanza conferme e gestire i blocchi che vengono sostituiti durante una riorganizzazione della catena.
- Memorizzare l’ultimo numero di blocco elaborato, così un riavvio non salta blocchi.
- Ripetere tutto questo per ogni catena supportata, perché ciascuna ha un proprio client e un proprio formato dei dati.
Per Tron, la documentazione sulle sottoscrizioni agli eventi descrive il percorso dei plugin, che anche quello va gestito da te.
In che cosa un’API blockchain fa diversamente?
Gestisce i nodi, decodifica i dati e li espone come endpoint JSON. Con Chaingateway, un webhook sostituisce la scansione dei blocchi. Questa richiesta registra un URL che viene chiamato quando un dato indirizzo riceve un token TRC20:
curl -X POST https://app.chaingateway.io/api/v2/tron/webhooks \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "to": "TWrTTVizHkF3LxTiWE9vCnhWC7CBpNXe22", "url": "https://example.com/hooks/deposit", "type": "TRC20", "reference": "order-1042" }'I webhook esistono per Tron, Ethereum, BNB Smart Chain, Polygon, Arbitrum e Bitcoin. Solana non ne ha, quindi su Solana interroghi le transazioni.
Che cosa succede quando un webhook fallisce?
Le notifiche fallite non vengono ritentate automaticamente. Compaiono in un elenco che leggi con GET /api/v2/<chain>/webhooks/notifications/failed. Poi chiami POST /api/v2/<chain>/webhooks/notifications/{id}/retry per ciascuna voce. Una notifica che fallisce di nuovo torna nell’elenco. Ogni notifica memorizzata riporta l’ID della transazione, il tipo (per esempio TRC20), l’indirizzo del contratto, mittente, destinatario, numero di blocco e il numero di tentativi.
Due conseguenze per il tuo server ricevente. Deve rispondere in fretta con uno stato di successo, e deve gestire lo stesso evento che arriva due volte, per esempio dopo un reinvio manuale. Usa l’ID della transazione come chiave per la deduplicazione.
Quale conviene: nodo o API?
Nessuno dei due vince in generale. La tabella mostra dove differiscono.
| Nodo proprio | API blockchain | |
|---|---|---|
| Configurazione | Installare il client, sincronizzare, proteggere il server | Creare un account e un token |
| Hardware e manutenzione | A tuo carico: disco, patch, aggiornamenti del client, monitoraggio | Del provider |
| Formato dei dati | Grezzo (quantità esadecimali, log codificati) | JSON decodificato |
| Notifiche di deposito | Le costruisci tu | Webhook, dove l’API li supporta |
| Controllo | Totale: versione del client, configurazione, nessun limite condiviso | Limitato a ciò che l’API espone |
| Costo | Server e ore di ingegneria | Prezzo del piano, a consumo o mensile |
| Gestione dei guasti | Il tuo team | Infrastruttura del provider, ma ne dipendi |
Scegli un nodo se ti servono metodi che un’API non espone, se devi controllare la versione del client, o se hai ragioni normative per tenere tutta l’infrastruttura in casa. Scegli un’API se il tuo prodotto è altro rispetto all’infrastruttura. I team che impiegano già ingegneri blockchain a volte usano comunque un’API per le catene in cui non sono specializzati.
Come si inizia con Chaingateway?
Crea un account per la prova gratuita di 7 giorni, che non richiede carta né KYC, e usa la testnet aggiungendo X-Network: testnet alle tue richieste. I piani partono da 49 € al mese.
Come scriviamo questi articoli
Pronto a costruirlo da solo? Ottieni la tua API key — prova di 7 giorni, senza carta — oppure consulta Blockchain API per il riferimento completo degli endpoint.