ERC-20 è l’interfaccia standard per i token fungibili su Ethereum, definita in EIP-20 da Fabian Vogelsteller e Vitalik Buterin il 19 novembre 2015: sei funzioni obbligatorie, tre facoltative e due eventi che ogni contratto token espone allo stesso modo. WETH è l’esempio da manuale, perché il contratto WETH9 implementa alla luce del sole tutte e nove le funzioni ed entrambi gli eventi, mentre l’ETH nativo non ne implementa nessuno. La regola che ne deriva: qualsiasi contratto in grado di gestire un token ERC-20 può gestire WETH, e nessuno può gestire direttamente ETH.

Punti chiave
  • L'interfaccia: totalSupply, balanceOf, transfer, transferFrom, approve e allowance sono obbligatorie; name, symbol e decimals sono facoltative; Transfer e Approval sono gli eventi (EIP-20, Final).
  • ETH è arrivato prima: la mainnet di Ethereum è stata lanciata il 30 luglio 2015 ed EIP-20 è stato creato 112 giorni dopo; per questo ETH non ha un contratto ERC-20 ed esiste WETH.
  • Offerta uguale alla riserva: totalSupply() di WETH9 restituisce il saldo in ETH del contratto stesso, 2.175.140,76 il 21 novembre 2026 (Ethereum RPC, blocco 26.464.782).
  • Token persi: al 20 giugno 2024 erano andati persi almeno 83.656.418 $ in token ERC-20, inviati a contratti che non sono in grado di gestirli (ethereum.org).

Che cos’è ERC-20

ERC-20 è un elenco di funzioni ed eventi che un contratto token deve esporre perché portafogli, exchange e altri contratti possano usarlo senza codice personalizzato. ethereum.org descrive i token a cui si applica come fungibili: ogni unità è identica a qualsiasi altra per tipo e valore. Lo standard non stabilisce quanto valga un token né chi lo emetta; stabilisce come se ne leggono e se ne spostano i saldi.

ERC sta per Ethereum Request for Comments. Fabian Vogelsteller ha proposto ERC-20 nel novembre 2015 e il testo è stato pubblicato come EIP-20, che oggi è in stato Final (eips.ethereum.org). Poiché l’interfaccia è fissa, un portafoglio mostra qualsiasi saldo ERC-20 chiamando balanceOf() e un DEX scambia qualsiasi token ERC-20 con la stessa chiamata transferFrom().

Le nove funzioni e i due eventi di ERC-20

L’interfaccia ERC-20 ha nove funzioni e due eventi, e WETH9 li implementa tutti. La tabella li elenca indicando cosa fa ciascuno e come risponde WETH sulla mainnet di Ethereum (sorgente verificata su Sourcify ed Etherscan, valori letti il 21 novembre 2026).

Funzione o evento Obbligatorio Cosa fa In WETH9
name() Facoltativo Nome leggibile «Wrapped Ether»
symbol() Facoltativo Ticker «WETH»
decimals() Facoltativo Cifre dopo la virgola 18
totalSupply() Sì Token esistenti Restituisce il saldo in ETH del contratto
balanceOf(owner) Sì Saldo di un indirizzo Mapping pubblico
transfer(to, value) Sì Invia token dal chiamante Chiama transferFrom() con il chiamante come mittente
transferFrom(from, to, value) Sì Sposta token per conto di qualcun altro Verifica e riduce l’allowance
approve(spender, value) Sì Consente a un altro indirizzo di spendere fino a un limite Imposta l’allowance, emette Approval
allowance(owner, spender) Sì Importo approvato residuo Mapping pubblico
Evento Transfer Sì Registrato a ogni movimento Emesso da transferFrom()
Evento Approval Sì Registrato a ogni approve Emesso da approve()

EIP-20 indica name, symbol e decimals come facoltative e precisa che gli altri contratti non devono darle per scontate. In pratica quasi tutti i token le impostano, perché ai portafogli servono per mostrare un saldo.

Perché ETH non è un token ERC-20

ETH non è un token ERC-20 perché è il coin nativo della rete, non lo stato di un contratto. I saldi di ether risiedono nei record degli account di Ethereum stesso, si spostano con semplici transazioni e pagano il gas; non esiste un contratto ETH su cui chiamare balanceOf() o approve(). La mainnet di Ethereum è stata lanciata il 30 luglio 2015 (ethereum.org) ed EIP-20 è stato creato il 19 novembre 2015, 112 giorni dopo.

Da questo scarto nasce WETH. Un pool DEX o un mercato di prestito è scritto per l’interfaccia ERC-20 e sposta i fondi con transferFrom(); l’ETH nativo non ha questa funzione, quindi il contratto non può prelevarlo. Il wrap porta ETH dietro l’interfaccia sulla stessa chain (perché WETH esiste): l’ETH non lascia Ethereum, cambia standard.

Come WETH implementa ERC-20

WETH implementa ERC-20 con due funzioni aggiuntive che lo collegano all’ETH nativo. deposit() prende gli ETH inviati con la chiamata e accredita al mittente la stessa quantità di WETH; withdraw() brucia WETH e restituisce la stessa quantità di ETH. Entrambe emettono i propri eventi, Deposit e Withdrawal, accanto ai Transfer e Approval standard. Come appaiono un wrap e un unwrap dal lato dell’utente è spiegato nella sezione cos’è WETH.

Tre dettagli della sorgente di WETH9, compilata con solc 0.4.19 e verificata su Etherscan da dicembre 2017, ne fanno l’implementazione di riferimento a cui tutti rimandano:

  • Offerta uguale alla riserva: totalSupply() non conta nulla: restituisce il saldo in ETH del contratto, 2.175.140,76 il 21 novembre 2026, quindi offerta e copertura non possono divergere.
  • Nessun proprietario: non c’è alcuna funzione di amministrazione, nessuna pausa e nessun percorso di aggiornamento; nessun indirizzo può coniare WETH senza depositare ETH, né congelare un saldo.
  • Approvazione illimitata: quando l’allowance è impostata al valore massimo (uint(-1)), transferFrom() salta il decremento, quindi uno spender approvato per il massimo non la esaurisce mai.

In un portafoglio il risultato sono due saldi distinti sullo stesso indirizzo: l’ETH nativo e il token WETH. Un portafoglio in autocustodia che supporta più reti, come WETH Wallet, mostra WETH su Ethereum e WETH su Base come due asset separati, perché ciascuno è un contratto ERC-20 diverso.

Decimali: come vengono memorizzati gli importi ERC-20

I contratti ERC-20 memorizzano ogni importo come numero intero di unità base e usano decimals() per indicare dove va la virgola. EIP-20 porta l’esempio di 8 decimali: il numero memorizzato si divide per 100.000.000 per ottenere l’importo che vede l’utente. La tabella confronta tre token letti sulla mainnet di Ethereum il 21 novembre 2026.

Token decimals() Unità base in 1 token Equivale a
WETH 18 10^18 1 ETH in wei
WBTC 8 10^8 1 BTC in satoshi
USDC 6 10^6 Un dollaro in milionesimi

WETH coincide esattamente con ETH: 18 decimali, quindi 1 WETH corrisponde a 10^18 unità base così come 1 ETH a 10^18 wei, e un wrap non arrotonda mai. I token che rappresentano altri asset adottano la precisione di quell’asset; WBTC segue gli 8 decimali di Bitcoin (WETH vs WBTC mette a confronto i due wrapper).

Approve e transferFrom: perché le app chiedono un’autorizzazione

Un’app Le chiede di approvare un token perché ERC-20 non dà a un contratto alcun modo di prelevare token se il loro proprietario non ha prima impostato un’allowance. Il flusso ha due passaggi: approve(spender, amount) registra il limite, e in seguito il contratto dell’app chiama transferFrom() per spostare fino a quell’importo. Per questo il primo swap di un token su un DEX inizia con una transazione di approvazione separata.

EIP-20 segnala un punto debole noto: portare un’allowance da un valore diverso da zero a un altro può permettere a uno spender di usare entrambi gli importi, se agisce nel frattempo, quindi le interfacce dovrebbero prima riportare l’allowance a 0. Le allowance restano in vigore finché non vengono modificate, ed è per questo che conviene revocare quelle inutilizzate; i dettagli sono in approvazioni e allowance di WETH.

Cosa non può fare ERC-20

  • Non può pagare il gas: le commissioni di rete si pagano in ETH, mai in un token ERC-20, WETH compreso; un portafoglio che detiene solo token non può inviarli.
  • Non può avvisare un contratto che ha ricevuto token: un semplice transfer() verso un contratto che non ha modo di farli uscire li lascia bloccati; al 20 giugno 2024 erano andati persi così almeno 83.656.418 $ (ethereum.org), e per risolvere il problema sono stati proposti standard come ERC-223 ed ERC-1363.
  • Non può dimostrare che un token è autentico: qualsiasi contratto può restituire il nome «Wrapped Ether»; solo l’indirizzo identifica il vero WETH, riportato nella sezione indirizzi dei contratti.
  • Non può spostare token tra reti: WETH su Ethereum e WETH su Arbitrum sono due contratti ERC-20 con offerte separate; passare dall’uno all’altro è un’operazione di bridge.
  • Non copre gli NFT: i token unici seguono altri standard, come ERC-721; ERC-20 riguarda solo unità intercambiabili.

FAQ su ERC-20

No. ETH è il coin nativo di Ethereum e non ha un contratto token; è stato lanciato il 30 luglio 2015, prima che esistesse lo standard ERC-20. WETH è la forma ERC-20 di ETH.