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.
- 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.