L’ERC-20 est l’interface standard des tokens fongibles sur Ethereum, définie dans l’EIP-20 par Fabian Vogelsteller et Vitalik Buterin le 19 novembre 2015 : six fonctions obligatoires, trois facultatives et deux événements que chaque contrat de token expose de la même manière. Le WETH en est l’exemple type, car le contrat WETH9 implémente au grand jour les neuf fonctions et les deux événements, alors que l’ETH natif n’en implémente aucun. D’où la règle : tout contrat capable de gérer un token ERC-20 sait gérer le WETH, et aucun ne sait gérer l’ETH directement.

Points clés
  • L'interface : totalSupply, balanceOf, transfer, transferFrom, approve et allowance sont obligatoires ; name, symbol et decimals sont facultatives ; Transfer et Approval sont les événements (EIP-20, Final).
  • L'ETH est arrivé en premier : le mainnet d'Ethereum a été lancé le 30 juillet 2015 et l'EIP-20 a été créée 112 jours plus tard. C'est pourquoi l'ETH n'a pas de contrat ERC-20 et pourquoi le WETH existe.
  • L'offre égale la réserve : totalSupply() de WETH9 renvoie le propre solde en ETH du contrat, soit 2 175 140,76 le 21 novembre 2026 (Ethereum RPC, bloc 26 464 782).
  • Des tokens perdus : au 20 juin 2024, au moins 83 656 418 $ de tokens ERC-20 avaient été perdus parce qu'ils avaient été envoyés à des contrats incapables de les gérer (ethereum.org).

Ce qu’est l’ERC-20

L’ERC-20 est une liste de fonctions et d’événements qu’un contrat de token doit exposer pour que les portefeuilles, les exchanges et les autres contrats puissent l’utiliser sans code sur mesure. ethereum.org qualifie de fongibles les tokens qu’elle couvre : chaque unité est identique à toutes les autres, en type comme en valeur. La norme ne dit ni ce que vaut un token, ni qui l’émet ; elle définit la façon dont ses soldes sont lus et déplacés.

ERC signifie Ethereum Request for Comments. Fabian Vogelsteller a proposé l’ERC-20 en novembre 2015, et le texte a été publié sous le nom d’EIP-20, dont le statut est Final (eips.ethereum.org). L’interface étant figée, un portefeuille affiche le solde de n’importe quel token ERC-20 en appelant balanceOf(), et un DEX échange n’importe quel token ERC-20 avec le même appel transferFrom().

Les neuf fonctions et les deux événements de l’ERC-20

L’interface ERC-20 compte neuf fonctions et deux événements, et WETH9 les implémente tous. Le tableau les liste avec leur rôle et la réponse du WETH sur le mainnet d’Ethereum (source vérifiée sur Sourcify et Etherscan, valeurs lues le 21 novembre 2026).

Fonction ou événement Obligatoire Rôle Dans WETH9
name() Facultative Nom lisible par un humain “Wrapped Ether”
symbol() Facultative Ticker “WETH”
decimals() Facultative Chiffres après la virgule 18
totalSupply() Oui Tokens en circulation Renvoie le solde en ETH du contrat
balanceOf(owner) Oui Solde d’une adresse Mapping public
transfer(to, value) Oui Envoie des tokens depuis l’appelant Appelle transferFrom() avec l’appelant comme expéditeur
transferFrom(from, to, value) Oui Déplace des tokens pour le compte d’un tiers Vérifie et réduit l’allowance
approve(spender, value) Oui Autorise une autre adresse à dépenser jusqu’à une limite Fixe l’allowance, émet Approval
allowance(owner, spender) Oui Montant approuvé restant Mapping public
Événement Transfer Oui Enregistré à chaque mouvement Émis par transferFrom()
Événement Approval Oui Enregistré à chaque approve Émis par approve()

L’EIP-20 classe name, symbol et decimals parmi les fonctions facultatives et précise que les autres contrats ne doivent pas compter sur leur présence. En pratique, presque tous les tokens les définissent, car les portefeuilles en ont besoin pour afficher un solde.

Pourquoi l’ETH n’est pas un token ERC-20

L’ETH n’est pas un token ERC-20, car c’est le coin natif du réseau et non l’état d’un contrat. Les soldes en ether sont inscrits dans les comptes d’Ethereum lui-même, se déplacent par de simples transactions et servent à payer le gas ; il n’existe aucun contrat ETH sur lequel appeler balanceOf() ou approve(). Le mainnet d’Ethereum a été lancé le 30 juillet 2015 (ethereum.org), et l’EIP-20 a été créée le 19 novembre 2015, soit 112 jours plus tard.

C’est cet écart qui explique le WETH. Un pool de DEX ou un marché de prêt est écrit pour l’interface ERC-20 et déplace les fonds avec transferFrom() ; l’ETH natif n’a pas cette fonction, le contrat ne peut donc pas le prélever. Le wrapping place l’ETH derrière cette interface, sur la même chaîne (pourquoi le WETH existe) : l’ETH ne quitte pas Ethereum, il change de norme.

Comment le WETH implémente l’ERC-20

Le WETH implémente l’ERC-20 avec deux fonctions supplémentaires qui le relient à l’ETH natif. deposit() prend l’ETH envoyé avec l’appel et crédite le même montant de WETH à l’expéditeur ; withdraw() brûle du WETH et renvoie le même montant d’ETH. Chacune émet son propre événement, Deposit et Withdrawal, en plus des événements standard Transfer et Approval. Le wrap et l’unwrap vus du côté de l’utilisateur sont décrits dans la section qu’est-ce que le WETH.

Trois détails de la source de WETH9, compilée avec solc 0.4.19 et vérifiée sur Etherscan depuis décembre 2017, en font l’implémentation de référence que l’on cite :

  • L’offre égale la réserve : totalSupply() ne compte rien ; elle renvoie le solde en ETH du contrat, soit 2 175 140,76 le 21 novembre 2026, si bien que l’offre et la couverture ne peuvent pas diverger.
  • Pas de propriétaire : il n’y a ni fonction d’administration, ni pause, ni chemin de mise à niveau ; aucune adresse ne peut frapper du WETH sans déposer d’ETH, ni geler un solde.
  • Approbation illimitée : lorsqu’une allowance est fixée à la valeur maximale (uint(-1)), transferFrom() ne la décrémente pas, si bien qu’un dépensier approuvé pour le maximum n’en manque jamais.

Dans un portefeuille, on obtient donc deux soldes distincts sur la même adresse : l’ETH natif et le token WETH. Un portefeuille auto-conservé multiréseau, comme WETH Wallet, affiche le WETH sur Ethereum et le WETH sur Base comme deux actifs distincts, car chacun est un contrat ERC-20 différent.

Décimales : comment les montants ERC-20 sont stockés

Les contrats ERC-20 stockent chaque montant sous forme de nombre entier d’unités de base et indiquent avec decimals() où placer la virgule. L’EIP-20 prend l’exemple de 8 décimales : il faut diviser le nombre stocké par 100 000 000 pour obtenir le montant affiché à l’utilisateur. Le tableau compare trois tokens, avec des valeurs lues sur le mainnet d’Ethereum le 21 novembre 2026.

Token decimals() Unités de base dans 1 token Équivalent
WETH 18 10^18 1 ETH en wei
WBTC 8 10^8 1 BTC en satoshis
USDC 6 10^6 Un dollar en millionièmes

Le WETH correspond exactement à l’ETH : 18 décimales, donc 1 WETH représente 10^18 unités de base, tout comme 1 ETH représente 10^18 wei, et un wrap n’arrondit jamais. Les tokens qui représentent d’autres actifs reprennent la précision de cet actif ; le WBTC suit les 8 décimales de Bitcoin (WETH vs WBTC compare les deux wrappers).

Approve et transferFrom : pourquoi les apps demandent une autorisation

Une app vous demande d’approuver un token parce que l’ERC-20 ne donne à un contrat aucun moyen de prendre des tokens tant que leur propriétaire n’a pas fixé d’allowance. Le processus se déroule en deux étapes : approve(spender, amount) enregistre la limite, puis le contrat de l’app appelle transferFrom() pour déplacer jusqu’à ce montant. C’est pourquoi le premier swap d’un token sur un DEX commence par une transaction d’approbation distincte.

L’EIP-20 signale une faiblesse connue : faire passer une allowance d’une valeur non nulle à une autre peut permettre à un dépensier d’utiliser les deux montants s’il agit entre-temps, et les interfaces doivent donc d’abord remettre l’allowance à 0. Une allowance reste en vigueur tant qu’elle n’est pas modifiée, d’où l’intérêt de révoquer celles qui ne servent plus ; tous les détails sont dans Approbations et allowances WETH.

Ce que l’ERC-20 ne permet pas

  • Payer le gas : les frais de réseau se paient en ETH, jamais avec un token ERC-20, WETH compris ; un portefeuille qui ne détient que des tokens ne peut pas les envoyer.
  • Signaler à un contrat qu’il a reçu des tokens : un simple transfer() vers un contrat qui n’a aucun moyen de faire sortir des tokens les y bloque ; au moins 83 656 418 $ ont été perdus de cette façon au 20 juin 2024 (ethereum.org), et des normes comme l’ERC-223 et l’ERC-1363 ont été proposées pour y remédier.
  • Prouver qu’un token est authentique : n’importe quel contrat peut renvoyer le nom « Wrapped Ether » ; seule l’adresse identifie le vrai WETH, listée dans la section adresses de contrats.
  • Déplacer des tokens d’un réseau à l’autre : le WETH sur Ethereum et le WETH sur Arbitrum sont deux contrats ERC-20 avec des offres distinctes ; passer de l’un à l’autre est une opération de bridge.
  • Couvrir les NFT : les tokens uniques suivent d’autres normes, comme l’ERC-721 ; l’ERC-20 ne couvre que des unités interchangeables.

FAQ ERC-20

Non. L'ETH est le coin natif d'Ethereum et n'a pas de contrat de token ; il a été lancé le 30 juillet 2015, avant que la norme ERC-20 n'existe. Le WETH est la forme ERC-20 de l'ETH.