Indirizzo ERC20: formato, balanceOf e creazione via API
Un indirizzo ERC20 è l'indirizzo di account di 42 caratteri, con prefisso 0x, che Ethereum usa per ogni wallet. Diventa un indirizzo ERC-20 quando l'account contiene token conformi allo standard ERC-20. La stessa stringa funziona su Polygon e Arbitrum perché sono compatibili con EVM, ma token e saldi sono specifici di ciascuna chain.
Il saldo ERC-20 si ottiene chiamando balanceOf(address) sul contratto del token. Via REST, GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} restituisce lo stesso valore già decodificato. Per ricevere token basta condividere l'indirizzo. Per inviarli servono la sua chiave e un po' di ETH per pagare il gas della transazione.
Questa pagina tratta il formato dell'indirizzo, balanceOf, lo stesso indirizzo su Polygon e Arbitrum e la creazione di indirizzi via REST.
Che cos'è lo standard ERC-20?
ERC-20 è l'interfaccia standard di Ethereum per i token fungibili. EIP-20 definisce sei funzioni (totalSupply, balanceOf, transfer, transferFrom, approve e allowance) più gli eventi Transfer e Approval. Ogni contratto che le implementa è un token conforme. Wallet ed exchange possono quindi supportare un nuovo token senza lavoro dedicato per ciascuno.
La panoramica ERC-20 di ethereum.org illustra la stessa interfaccia con esempi. Il funzionamento completo è nel nostro articolo sullo standard token ERC20. Questa pagina resta sul lato dell'indirizzo: cos'è un indirizzo ERC-20 e come usarlo nel codice.
Che aspetto ha un indirizzo ERC-20?
Un indirizzo ERC-20 è il normale indirizzo Ethereum, per esempio 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed. È 0x più 40 caratteri esadecimali, in tutto 42 caratteri. La documentazione sugli account di ethereum.org lo descrive come gli ultimi 20 byte dell'hash Keccak-256 della chiave pubblica dell'account.
Il nome compare solo nel contesto. Un indirizzo diventa un «indirizzo ERC-20» quando si parla dei token che contiene. Nulla nella stringa lo segnala come adatto ai token, e lo stesso indirizzo funziona per ETH, per ogni token ERC-20 e per gli NFT.
- Il prefisso 0x indica che il valore è esadecimale.
- I 40 caratteri esadecimali sono 20 byte: gli ultimi 20 byte dell'hash Keccak-256 della chiave pubblica.
- 42 caratteri in totale. L'alternanza di maiuscole e minuscole è il checksum EIP-55.
Come legge balanceOf un saldo ERC-20?
balanceOf(address) è la funzione di sola lettura che restituisce il saldo in token di un indirizzo. Il saldo non è memorizzato nell'indirizzo. Si trova nello smart contract del token, in una mappa indicizzata per indirizzo, e balanceOf lo consulta.
Chiamarla direttamente significa codificare una chiamata JSON-RPC eth_call verso il contratto del token e decodificare l'esadecimale restituito. Il risultato è un intero nell'unità minima del token, quindi bisogna leggere anche decimals(). Molte stablecoin usano 6 decimali, altre 18, e sbagliare è una causa frequente di errori di un fattore un milione.
L'API Chaingateway si occupa di codifica e decimali. Gli endpoint dei saldi restituiscono numeri semplici, quindi un problema di RPC grezzo diventa una normale risposta REST.
Lo stesso indirizzo ERC-20 è valido su Polygon e Arbitrum?
Sì. Polygon e Arbitrum sono compatibili con EVM, quindi i loro indirizzi usano lo stesso formato 0x. Un indirizzo derivato dalla stessa chiave privata è la stessa stringa su Ethereum, Polygon e Arbitrum.
I token a quell'indirizzo, invece, non sono condivisi. Un contratto token distribuito su Ethereum non esiste su Polygon finché qualcuno non lo distribuisce lì o non fa il bridge dell'asset. I saldi sono quindi specifici di ogni chain, anche quando l'indirizzo è lo stesso. I token su Polygon seguono la stessa interfaccia ERC-20, ed è per questo che un unico percorso di codice può servire tutte e tre le chain.
ERC-721 ed ERC-721A: standard diverso, stesso formato di indirizzo
ERC-721 è lo standard di Ethereum per i token non fungibili. Ogni ID token è unico, a differenza dei saldi intercambiabili di ERC-20. EIP-721 ne specifica l'interfaccia.
ERC-721A è un'implementazione della stessa interfaccia ottimizzata per il gas, diffusa nelle collezioni coniate in lotti. Cambia il modo in cui il contratto salva i dati internamente, non l'aspetto dell'indirizzo di chi li possiede. Entrambi gli standard usano lo stesso indirizzo 0x per la proprietà. L'articolo sullo standard token ERC721 approfondisce il lato NFT.
Crea e leggi indirizzi ERC-20 via REST
Sei route coprono il ciclo di vita degli indirizzi in un'integrazione di pagamento.
| Endpoint | Cosa fa |
|---|---|
POST /api/v2/ethereum/addresses | Genera un nuovo indirizzo Ethereum |
POST /api/v2/ethereum/addresses/import | Importa una chiave privata, così l'API può firmare per quell'indirizzo |
GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} | Saldo di un singolo token ERC-20, già decodificato |
GET /api/v2/ethereum/balances/{address}/erc20 | Tutti i saldi in token del wallet |
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 |
La stessa forma di richiesta vale con /polygon/ o /arbitrum/ al posto di /ethereum/ nel percorso, perché le tre chain condividono il formato dell'indirizzo e l'interfaccia ERC-20.
Leggi un saldo ERC-20 senza eth_call
L'indirizzo di contratto qui sotto è USDT su Ethereum mainnet. Aggiungi X-Network: testnet per interrogare invece un token su testnet.
curl https://app.chaingateway.io/api/v2/ethereum/balances/0xYourAddress/erc20/0xdAC17F958D2ee523a2206206994597C13D831ec7 \
-H "Authorization: Bearer YOUR_API_KEY"Come si valida un indirizzo ERC-20 prima dell'invio?
Confronta prima di tutto la stringa con ^0x[a-fA-F0-9]{40}$, che scarta lunghezze errate e caratteri estranei. Se l'indirizzo mescola maiuscole e minuscole, verifica anche il checksum EIP-55. Una sola lettera sbagliata fa fallire il controllo.
Un controllo di formato non dice quale rete si aspetta il destinatario, perché lo stesso indirizzo è valido su ogni chain EVM. Chiedi la rete in modo esplicito. Non accettare mai l'indirizzo di un contratto token come destinazione. Il validatore di indirizzi esegue nel browser i controlli di formato e checksum su un singolo indirizzo.
Fonti
- EIP-20: Token Standard
- ERC-20 token standard (ethereum.org)
- Ethereum accounts (ethereum.org)
- ERC-55: Mixed-case checksum address encoding
Verificato il 5 novembre 2026.
Ti servono i saldi ERC-20 senza decodificare a mano le chiamate balanceOf? Crea un account gratuito e interroga un indirizzo su testnet via REST. Prova di 7 giorni, senza carta, senza KYC.
FAQ: indirizzi ERC-20
Pronto a costruire su Ethereum, Polygon o Arbitrum?
Crea un account e interroga oggi stesso un saldo ERC-20 su testnet. Prova di 7 giorni, senza carta, senza KYC. Il riferimento completo è nella documentazione della Ethereum API. Per coprire tutte e sette le chain c'è la blockchain API multichain.
Verificato da Maurice Sobiera Come scriviamo queste pagine