Interoperabilità blockchain: cosa fanno e non fanno le API
Le blockchain non si leggono a vicenda. Come ponti e protocolli spostano asset tra catene, e cosa un'API blockchain risolve e cosa no per gli sviluppatori.
Verificato da Maurice Sobiera
L’interoperabilità blockchain è la capacità di blockchain separate di scambiarsi asset o dati. La maggior parte delle catene non può leggere lo stato delle altre, quindi per spostare valore tra di esse serve un bridge o un protocollo cross-chain. Un’API blockchain non fornisce questo. Le offre un’unica interfaccia verso più catene, così ognuna può essere integrata nello stesso modo.
Perché le blockchain non riescono a parlarsi?
Ogni catena valida solo i propri dati. Uno smart contract su Ethereum non può verificare se una transazione è avvenuta su Tron, perché le due reti usano regole di consenso, formati di indirizzo e strutture dati diversi. Un asset che lascia la sua catena deve quindi essere rappresentato sulla catena di destinazione da qualcosa che quella catena possa verificare. È questo il problema di fiducia dell’interoperabilità.
Come si spostano gli asset tra catene?
Tramite bridge e protocolli di messaggistica cross-chain. La documentazione di Ethereum sui bridge distingue due modelli di fiducia:
| Modello | Come funziona | Compromesso |
|---|---|---|
| Bridge fidato | Un insieme esterno di verificatori (un gruppo multi-firma, un sistema MPC o una rete di oracoli) conferma gli eventi sulla catena di origine | Veloce e flessibile, ma Lei dipende dalla sicurezza dei verificatori |
| Bridge trustless | Il bridge si affida ai validatori delle catene collegate | Ipotesi di sicurezza più forti, ma minore capacità di trasferire dati complessi |
La stessa pagina avverte dei rischi: difetti negli smart contract, asset wrapped che portano rischio sistemico e rischio di controparte. Afferma che i bridge sono responsabili dei primi tre attacchi più grandi nella DeFi. Un disegno diverso è il protocollo Inter-Blockchain Communication (IBC), in cui le catene verificano lo stato l’una dell’altra tramite light client. È usato tra le catene Cosmos e richiede che entrambe le catene lo supportino.
Nessuno di questi è una funzione di un’API REST. Se deve spostare USDT da Ethereum a Tron, usa un bridge o un exchange, e si fida di quel servizio.
Che cosa fa un’API blockchain per l’interoperabilità?
Elimina, lato applicazione, le differenze di integrazione tra le catene. Ogni catena ha il proprio software di nodo, formato degli indirizzi e codifica. L’API di Chaingateway usa lo stesso stile di richiesta, la stessa autenticazione e la stessa struttura di risposta (status, ok, message, data) sulle catene supportate. Un monitor dei depositi per USDT su due catene richiede lo stesso codice con due parametri cambiati. La prima richiesta controlla un indirizzo su Ethereum:
curl -X POST https://app.chaingateway.io/api/v2/ethereum/webhooks \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "to": "0x922815dFbEa128eAeaAAa185508fe078bECeFBBE", "contractaddress": "0xdac17f958d2ee523a2206206994597c13d831ec7", "type": "ERC20", "url": "https://example.com/hooks/deposit", "reference": "user-77-eth" }'La seconda controlla un indirizzo Tron per la versione TRC20 dello stesso token. Cambiano solo la catena nel percorso, i formati degli indirizzi, l’indirizzo del contratto e il type:
curl -X POST https://app.chaingateway.io/api/v2/tron/webhooks \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "to": "TWrTTVizHkF3LxTiWE9vCnhWC7CBpNXe22", "contractaddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "type": "TRC20", "url": "https://example.com/hooks/deposit", "reference": "user-77-tron" }'Entrambe le notifiche arrivano allo stesso URL con gli stessi campi: ID della transazione, tipo, indirizzo del contratto, mittente, destinatario, numero di blocco. Il Suo codice si diversifica in base a type, non sul protocollo del nodo della catena. I webhook esistono per Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron e Bitcoin. Non ce ne sono per Solana. I webhook non vengono ritentati automaticamente, e questo vale su ogni catena.
Quali differenze restano tra le catene supportate?
L’API segue la struttura di ciascuna catena dove le catene differiscono. La tabella elenca ciò che il file OpenAPI mostra per catena:
| Famiglia di catene | Indirizzi e wallet | Endpoint legati alle commissioni | Webhook |
|---|---|---|---|
| Ethereum, BNB Smart Chain, Polygon, Arbitrum | POST .../addresses, .../addresses/import | GET .../gasprice | Sì |
| Tron | POST .../addresses, .../addresses/import | Freeze, unfreeze, delegate, undelegate, parametri di catena | Sì |
| Bitcoin | POST .../wallets | nessuno elencato | Sì |
| Solana | POST .../addresses | nessuno elencato | No |
Gli endpoint delle commissioni di Tron riguardano energy e bandwidth, che Tron usa al posto di un prezzo del gas. Le ragioni stanno nelle catene, non nell’API, e nessun wrapper può eliminarle.
Che cosa non risolve un’API blockchain?
Non sposta asset tra catene e non fa in modo che una catena verifichi un’altra. Inoltre nasconde solo le differenze di accesso, non quelle economiche. Tron addebita risorse (energy e bandwidth) dove Ethereum addebita gas. I tempi di conferma differiscono per catena, un saldo USDT su Ethereum è un asset diverso da un saldo USDT su Tron, e un token bridged è un terzo asset. La Sua applicazione deve comunque registrare su quale catena vive ciascun saldo.
Le versioni precedenti di questo articolo suggerivano che le API blockchain avrebbero sbloccato l’adozione di massa facendo passare dati tra catene. Quell’affermazione non era sostenibile, e il trasferimento di dati cross-chain è compito dei protocolli di bridging descritti sopra.
Che cosa chiedere prima di usare un bridge?
La lista dei rischi nella pagina dei bridge di Ethereum offre le domande. Per il rischio sugli smart contract, chieda se il bridge è stato sottoposto ad audit e come ha gestito incidenti passati. Per il rischio sistemico, chieda se emette asset wrapped e cosa li garantisce. Per il rischio di controparte, chieda chi gestisce i verificatori e cosa succede se smettono. Verifichi limiti e commissioni, e invii prima un importo piccolo.
L’exchange è l’altra via. Deposita su una catena e preleva su un’altra, quindi è l’exchange a sostenere il rischio cross-chain, e Lei sostiene il rischio dell’exchange. Nessuna delle due vie fa parte dell’API. Registri ogni trasferimento, inclusi gli ID delle transazioni su entrambe le catene, così che un trasferimento bloccato possa essere ricostruito.
Come progettare per più catene?
Memorizzi la catena con ogni indirizzo, transazione e saldo. Tratti lo stesso token su due catene come due asset. Scelga deliberatamente la catena per ogni flusso del cliente, e la mostri nell’interfaccia così gli utenti non inviano token alla rete sbagliata. Testi ogni catena prima sulla sua testnet: aggiunga X-Network: testnet a una richiesta. Infine decida come gestire le notifiche webhook fallite, perché l’API le elenca ma non le reinvia da sola.
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.