ERC20 Address: formato, balanceOf e come crearne una via API
Come funzionano internamente un indirizzo ERC-20 e balanceOf, come si applica a Polygon e Arbitrum, e come creare e monitorare indirizzi ERC-20 via REST invece che con JSON-RPC grezzo.
Una ERC20 address è lo stesso formato di indirizzo con prefisso 0x e 42 caratteri che Ethereum usa per ogni account — diventa una "ERC-20 address" a seconda del contesto ogni volta che quell'account contiene token costruiti secondo lo standard ERC-20. Poiché il formato è condiviso su ogni EVM chain, la stessa erc20 address che usi su Ethereum funziona invariata su Polygon e Arbitrum, anche se i token e i saldi a quell'indirizzo sono specifici per chain. Questa pagina copre il formato, la chiamata balanceOf che legge il saldo di un token, e la creazione di indirizzi tramite un'API.
Lo standard ERC-20, in breve
ERC-20 è lo standard token fungibile di Ethereum: un piccolo insieme di funzioni — transfer, approve, balanceOf e qualche altra — che ogni contratto token conforme implementa, motivo per cui wallet ed exchange possono supportare nuovi token ERC-20 senza lavoro di integrazione personalizzato per ogni token. La meccanica completa è nell'articolo sullo standard ERC20 token sul blog; questa pagina si concentra sul lato indirizzo: cos'è una erc20 address e come lavorarci in modo programmatico.
balanceOf: come si legge davvero un saldo ERC-20
Un saldo di token ERC-20 non è memorizzato nell'indirizzo stesso — è memorizzato all'interno dello smart contract del token, in una mapping indicizzata per indirizzo. balanceOf(address) è la funzione standard di sola lettura che ogni contratto ERC-20 espone per recuperare quel valore. Chiamarla direttamente significa codificare una chiamata JSON-RPC grezza eth_call contro il contratto del token e decodificare l'hex restituito. L'API di Chaingateway fa quella decodifica per te: gli endpoint di saldo e cronologia transazioni restituiscono numeri semplici, così "erc20 balanceof" smette di essere un problema di RPC grezzo e diventa una normale risposta API.
Lo stesso indirizzo su Polygon e Arbitrum
Polygon e Arbitrum sono entrambe EVM-compatibili, quindi un indirizzo Polygon e un indirizzo Arbitrum usano l'identico formato 0x di un indirizzo Ethereum, e possono di fatto essere lo stesso indirizzo se derivato dalla stessa chiave. È anche per questo che i token di Polygon sono token ERC-20 in ogni senso funzionale — è Polygon una rete di token ERC-20, non uno standard di indirizzo diverso — POL e i token nativi di Polygon implementano la stessa interfaccia di quelli di Ethereum. I contratti token differiscono per chain anche quando il formato di indirizzo non lo fa; un token distribuito su Ethereum necessita di una distribuzione separata (o di un bridge) per esistere su Polygon.
ERC-721 ed ERC-721A: uno standard diverso, lo stesso formato di indirizzo
ERC-721 è lo standard di token non fungibili di Ethereum — ogni ID di token è unico anziché intercambiabile, a differenza dei saldi fungibili di ERC-20. ERC-721A è un'implementazione molto diffusa e ottimizzata per il gas della stessa interfaccia ERC-721, popolare per collezioni NFT coniate a lotti; cambia il modo in cui il contratto memorizza i dati internamente, non l'aspetto dell'indirizzo di un possessore. Entrambi usano l'identico indirizzo 0x in stile erc20 per la proprietà. L'articolo sullo standard ERC721 token copre in profondità il lato NFT.
Crea e leggi indirizzi ERC-20 via REST
| Endpoint | Cosa fa |
|---|---|
POST /api/v2/ethereum/addresses | Genera un nuovo indirizzo Ethereum |
POST /api/v2/ethereum/addresses/import | Importa una private key perché l'API possa firmare per quell'indirizzo |
POST /api/v2/ethereum/webhooks | Registra un webhook per i depositi ERC-20 sull'indirizzo |
POST /api/v2/ethereum/transactions/erc20 | Invia un token ERC-20 dall'indirizzo |
Lo stesso formato di richiesta si applica con /polygon/ o /arbitrum/ al posto di /ethereum/ nel percorso, dato che tutte e tre le chain condividono il formato di indirizzo e l'interfaccia ERC-20.
Ti servono saldi ERC-20 senza decodificare a mano le chiamate balanceOf? Crea un account gratuito e interroga un indirizzo di testnet via REST — prova gratuita di 7 giorni, senza carta, senza KYC.
Domande frequenti: indirizzi ERC-20
Pronto a costruire su Ethereum, Polygon o Arbitrum?
Crea un account e interroga oggi stesso un saldo ERC-20 di testnet — prova gratuita di 7 giorni, senza carta, senza KYC. Riferimento completo nella documentazione della Ethereum API, oppure copri tutte e sette le chain con la blockchain API multichain.