Qu’est-ce qu’ERC-20 ?

ERC-20 est un standard d’interface pour les tokens fongibles sur Ethereum. Il s’adresse à un type de programme en chaîne chargé d’enregistrer les soldes et de traiter les opérations : un contrat de token. ERC est l’abréviation d’Ethereum Request for Comments, la catégorie des standards et conventions de couche applicative d’Ethereum ; 20 est le numéro de cette proposition. ERC-20 définit comment un contrat de token doit répondre aux consultations de solde et d’émission totale, comment il doit traiter transferts et autorisations, et quels enregistrements d’opération il doit émettre pour que les applications les lisent — ses événements —, afin que portefeuilles et autres applications puissent se connecter à différents tokens de façon comparable.

« Fongible » signifie que des quantités égales d’un même token sont interchangeables dans la comptabilité du contrat. Une unité enregistrée par un contrat donné ne devient pas, par exemple, d’un autre type simplement parce qu’elle provient d’une autre adresse. Ce qu’ERC-20 uniformise, c’est la manière d’opérer sur ces unités, pas leur prix, leur usage ni leur fiabilité.

Une interface commune règle les écarts d’intégration

Si chaque contrat de token employait des noms de fonction et des paramètres différents, un portefeuille devrait apprendre un nouveau jeu de méthodes de consultation et de transfert pour chaque token ajouté, et les applications en chaîne auraient du mal à réutiliser du code existant.

ERC-20 définit un ensemble d’interfaces communes. Un portefeuille peut lire les soldes de différents tokens avec la même méthode de consultation, une application peut demander un transfert selon la convention, et les services de données peuvent lire les événements de transfert et d’autorisation dans un format uniforme.

Le standard lui-même ne crée pas de token. Un développeur doit encore écrire ou adopter un contrat précis et le déployer sur le réseau. Chaque contrat peut enregistrer sa propre émission, ses soldes de comptes et des règles supplémentaires : deux tokens ERC-20 peuvent donc employer un code différent et détenir des droits d’administration entièrement différents.

Soldes, totaux et unités d’affichage

Un contrat ERC-20 enregistre les quantités de tokens en nombres entiers. balanceOf sert à consulter le solde d’une adresse, et totalSupply à consulter l’émission totale que le contrat déclare.

Les décimales visibles dans une interface proviennent généralement d’une règle d’affichage, et non du fait que le contrat stockerait réellement une fraction. Le champ optionnel decimals indique au portefeuille de combien de rangs décaler l’entier vers la gauche. Si un contrat enregistre 1 000 000 unités minimales et que decimals vaut 6, une interface affiche normalement 1 token.

Cela ne modifie pas la quantité en chaîne et ne change pas automatiquement la valeur d’un token. Le standard d’origine classe comme informations optionnelles le champ de nom name, le champ de code de cotation symbol et le champ de décimales d’affichage decimals ; noms et codes de cotation peuvent en outre se répéter. Identifier un token ERC-20 de façon fiable exige de vérifier à la fois le réseau et l’adresse du contrat, et pas seulement une icône ou un code de cotation.

Comment se déroule un transfert direct

Lorsqu’un détenteur transfère des tokens depuis son propre solde vers une autre adresse, il appelle généralement transfer en fournissant l’adresse du destinataire et une quantité exprimée en unité minimale.

À l’exécution, le contrat contrôle ses propres règles. Dans le cas de base, un solde insuffisant fait échouer l’opération ; une implémentation peut aussi ajouter une suspension, des listes, des frais de transfert ou d’autres restrictions. En cas de succès, le contrat met à jour ses soldes internes et émet un événement Transfer, permettant aux portefeuilles, explorateurs de blocs et services de données de reconnaître cette variation.

L’événement Transfer est un indice important pour lire les changements, mais le solde final est toujours déterminé par l’état du contrat. Une application doit aussi confirmer que la transaction a bien été inscrite sur le bon réseau, et que l’événement provient de la bonne adresse de contrat.

L’autorisation permet à une application de transférer une quantité limitée pour toi

ERC-20 prend aussi en charge un enchaînement « autoriser d’abord, faire exécuter ensuite par une autre adresse ou un contrat ». Il sert couramment aux échanges décentralisés, au prêt ou à d’autres opérations où un contrat doit recevoir des tokens.

Trois rôles interviennent :

• le détenteur possède les tokens et décide d’autoriser ou non ;
• la partie autorisée peut être une autre adresse ou une application en chaîne ;
• le destinataire est l’adresse vers laquelle les tokens sont finalement transférés, et peut différer de la partie autorisée.

Le détenteur appelle approve pour fixer un plafond d’autorisation. allowance sert à consulter le reliquat ; la partie autorisée appelle transferFrom pour déplacer des tokens dans la limite du solde et du plafond restant. En cas d’autorisation réussie, le contrat émet un événement Approval.

Une autorisation ne signifie pas que les tokens sont déjà sortis, mais elle laisse à la partie autorisée une marge d’action ultérieure. Si le plafond est élevé ou n’est pas révoqué à temps, dès lors que l’application autorisée présente une faille, passe sous le contrôle d’un tiers ou se comporte autrement que prévu, elle peut déplacer des tokens dans les limites accordées. L’utilisateur doit vérifier l’adresse autorisée, le contrat du token et le plafond, plutôt que de s’en remettre au nom affiché sur la page d’une application.

À quoi faire attention en modifiant un plafond d’autorisation

La conception d’origine d’ERC-20 permet d’appeler approve à nouveau pour écraser l’ancien plafond par une nouvelle valeur. Si l’ancien plafond n’a pas été utilisé et que le détenteur le remplace directement par une autre valeur non nulle, la partie autorisée peut dépenser l’ancien plafond avant que la transaction de modification ne prenne effet, puis continuer avec le nouveau : au total, davantage que le nouveau plafond que le détenteur comptait laisser.

La spécification ERC-20 recommande aux interfaces clientes de ramener d’abord à 0 le plafond de la même partie autorisée, puis de fixer la nouvelle valeur une fois la transaction de remise à zéro confirmée. Il s’agit d’une recommandation de compatibilité portant sur le déroulement d’une modification d’autorisation ; cela ne signifie pas que tous les portefeuilles adoptent la même interaction, et cela ne remplace pas l’appréciation du contrat autorisé.

Révoquer une autorisation consiste généralement aussi à ramener le plafond à 0 et à soumettre une transaction en chaîne. Se contenter de déconnecter le portefeuille d’un site ne modifie normalement pas automatiquement un plafond déjà inscrit dans le contrat du token.

L’interface commune du standard de base

Du point de vue de l’utilisateur, on peut répartir les interfaces de base en trois groupes :

• consultation : lire l’émission totale, le solde d’une adresse et le plafond d’autorisation restant ;
• opération : transfert direct par le détenteur, mise en place d’une autorisation, ou transfert effectué par la partie autorisée ;
• événements : consigner la réussite des transferts et des autorisations, pour que les applications externes mettent à jour leurs données.

Nom, code de cotation et décimales relèvent des informations d’affichage optionnelles. Le standard exige en outre que l’appelant sache traiter le cas d’une opération renvoyant false, sans présumer que chaque appel soit nécessairement réussi ou signale automatiquement une erreur. En intégration réelle, une application doit faire face aux différentes implémentations déjà déployées, et pas seulement vérifier l’existence d’un nom de fonction.

Quelles capacités ne relèvent pas du standard de base

ERC-20 ne définit pas uniformément la façon dont un token doit créer son émission initiale, et n’exige pas qu’un contrat continue de frapper ou prenne en charge la destruction. Frappe, destruction, suspension, gel, listes, frais de transaction, droits de vote, mises à niveau et rôles d’administration peuvent chacun être ajoutés séparément par une implémentation donnée, ou ne pas exister du tout.

Le standard ne définit pas non plus :

• si l’émission a un plafond, et qui peut la modifier ;
• si un token correspond à des réserves, des biens, des services ou d’autres droits hors chaîne ;
• le prix d’un token, sa liquidité ou ses lieux de négociation ;
• si un administrateur peut suspendre, geler ou mettre à niveau le contrat ;
• si un token homonyme sur un autre réseau relève du même dispositif d’émission.

Lire totalSupply ne donne donc que le total actuellement déclaré par le contrat, sans dire à lui seul s’il y aura de nouvelles émissions. Voir le même symbol ne prouve pas davantage que deux contrats représentent le même token.

Contrats de token et ETH natif

ETH est l’actif natif du réseau Ethereum, utilisé pour payer les frais de gas que le réseau prélève pour exécuter les transactions, et il est enregistré directement par le protocole. Un token ERC-20 a en revanche un contrat intelligent qui tient ses soldes et ses règles d’opération.

Les deux peuvent être transférés entre adresses, mais le chemin d’appel n’est pas le même. Un transfert ordinaire d’ETH n’exige pas d’appeler un contrat ERC-20, et ETH n’est pas lui-même un token ERC-20. Certaines applications utilisent un contrat pour représenter ETH sous une forme ERC-20, afin de se connecter à des programmes n’acceptant que l’interface ERC-20 ; cela introduit un autre contrat et ses règles, de sorte que les deux enregistrements ne peuvent pas être considérés directement comme un même objet.

La compatibilité d’interface ne garantit pas un comportement identique

« Prendre en charge ERC-20 » indique généralement seulement qu’un portefeuille ou une application sait appeler les interfaces de base. Un token donné peut malgré tout se comporter différemment :

• des frais supplémentaires sont prélevés lors du transfert, de sorte que la quantité reçue est inférieure à la quantité saisie ;
• un administrateur peut suspendre les transferts, geler des adresses ou changer l’implémentation ;
• certains anciens contrats ne renvoient pas les résultats comme une application s’y attend ;
• des champs d’affichage sont absents, dupliqués ou fournis par une source non fiable ;
• une logique supplémentaire fait échouer un transfert ordinaire dans certaines conditions.

ERC-20 fournit donc un langage commun, pas des règles métier uniformes. Juger si un token peut être intégré en sécurité exige de contrôler l’adresse de contrat concernée, le code ou les informations de vérification, les droits d’administration et les résultats réels d’un appel.

FAQ

Tous les tokens Ethereum sont-ils des ERC-20 ?

Non. Ethereum dispose aussi de standards destinés aux tokens à numéro distinct ou à d’autres usages, et des interfaces personnalisées peuvent exister. ERC-20 sert principalement les tokens enregistrés par quantité, dont les unités égales sont interchangeables.

Tous les tokens utilisent-ils 18 décimales ?

Non. decimals est un champ d’affichage optionnel et différents tokens peuvent employer des valeurs différentes. Une application devrait lire et traiter correctement le réglage du contrat concerné avant de calculer ou d’afficher des quantités.

Déconnecter le portefeuille d’un site révoque-t-il l’autorisation ?

Généralement non. La déconnexion empêche le site de continuer à demander des opérations au portefeuille via la session en cours, mais le plafond en chaîne reste enregistré par le contrat du token. Révoquer exige généralement de ramener ce plafond à 0 et de faire inscrire la transaction avec succès sur le réseau.

Recevoir un token ERC-20 prouve-t-il qu’il est authentique ?

Non. N’importe qui peut déployer un contrat au nom ou au code de cotation similaire. Il faut vérifier le réseau, l’adresse du contrat et des sources d’information fiables ; la compatibilité avec le standard ne prouve ni l’identité de l’émetteur, ni des réserves, ni une valeur.

D’autres blockchains peuvent-elles utiliser directement ce standard ?

ERC-20 est un standard de couche applicative d’Ethereum. D’autres réseaux capables d’exécuter des contrats intelligents de style Ethereum peuvent adopter une interface similaire, mais les adresses de contrat et l’état sont indépendants sur chaque réseau. Un déplacement entre chaînes implique en général aussi un pont ou un autre dispositif d’émission, que l’interface ERC-20 n’accomplit pas automatiquement.

Concepts associés

Poursuis avec standard de token, token crypto, contrat intelligent et frais de gas, ou reviens au glossaire des cryptomonnaies.

Sources

• ERC-20 : Token Standard — exigences de base en matière de consultation, transfert, autorisation, valeurs de retour et événements.
• Ethereum.org : présentation d’ERC-20 — objet du standard, fonctions courantes et modalités d’intégration par portefeuilles et applications.
• EIP-1 : objet et catégories des Ethereum Improvement Proposals — sens d’EIP et d’ERC, portée et processus des standards.