Indirizzi ERC-20 su tutte le chain EVM

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.

Prova gratuita di 7 giorni — nessuna carta, nessun KYC per iniziare Non-custodial — le chiavi private restano sotto il tuo controllo I piani partono da 49€/mese (490€/anno) — visualizza piani e rate limit

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.

0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed 1 2 3
  1. Il prefisso 0x indica che il valore è esadecimale.
  2. I 40 caratteri esadecimali sono 20 byte: gli ultimi 20 byte dell'hash Keccak-256 della chiave pubblica.
  3. 42 caratteri in totale. L'alternanza di maiuscole e minuscole è il checksum EIP-55.
Anatomia di un indirizzo EVM. Ethereum, Polygon e Arbitrum condividono questa struttura.

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.

EndpointCosa fa
POST /api/v2/ethereum/addressesGenera un nuovo indirizzo Ethereum
POST /api/v2/ethereum/addresses/importImporta 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}/erc20Tutti i saldi in token del wallet
POST /api/v2/ethereum/webhooksRegistra un webhook per i depositi ERC-20 sull'indirizzo
POST /api/v2/ethereum/transactions/erc20Invia 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
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.

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

Il formato di indirizzo con prefisso 0x e 42 caratteri che Ethereum usa per ogni account, che contenga o no token ERC-20. Nel contesto lo si chiama indirizzo ERC-20 quando si parla specificamente dei token che contiene.

Un insieme di funzioni (transfer, approve, balanceOf e altre) che ogni contratto di token fungibile su Ethereum implementa, così wallet ed exchange possono supportare nuovi token senza codice dedicato per ciascuno.

balanceOf(address) è una funzione di sola lettura che ogni contratto ERC-20 espone. Chiamarla direttamente richiede una eth_call verso il contratto del token e la decodifica della risposta esadecimale. L'API Chaingateway restituisce direttamente il saldo decodificato.

Polygon è una blockchain, non un token, ma è compatibile con EVM. I token su Polygon implementano la stessa interfaccia ERC-20 dei token Ethereum, e un indirizzo Polygon usa lo stesso formato 0x.

Un'implementazione dello standard NFT ERC-721 ottimizzata per il gas, comune nelle collezioni coniate in lotti. Cambia la memorizzazione interna del contratto, non il formato dell'indirizzo: la proprietà si risolve sempre in un normale indirizzo 0x.

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