Adresses ERC-20 sur toutes les chaînes EVM

Adresse ERC20 : format, balanceOf et création via l'API

Une adresse ERC20 est l'adresse de compte de 42 caractères, préfixée par 0x, qu'Ethereum utilise pour chaque wallet. Elle devient une adresse ERC-20 quand le compte détient des tokens qui suivent le standard ERC-20. La même chaîne fonctionne sur Polygon et Arbitrum, car ces réseaux sont compatibles EVM, mais les tokens et les soldes sont propres à chaque chaîne.

Essai gratuit de 7 jours — sans carte, sans KYC pour commencer Non-custodial — vos clés privées restent sous votre contrôle Les offres démarrent à 49 €/mois (490 €/an) — voir les offres et les limites de débit

Appeler balanceOf(address) sur le contrat du token renvoie un solde ERC-20. En REST, GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} renvoie le même chiffre, déjà décodé. Pour recevoir des tokens, partagez l'adresse. Pour en envoyer, il faut sa clé et un peu d'ETH pour payer le gas.

Cette page couvre le format de l'adresse, balanceOf, la même adresse sur Polygon et Arbitrum, et la création d'adresses en REST.

Qu'est-ce que le standard ERC-20 ?

ERC-20 est l'interface standard d'Ethereum pour les tokens fongibles. EIP-20 définit six fonctions, totalSupply, balanceOf, transfer, transferFrom, approve et allowance, ainsi que les événements Transfer et Approval. Tout contrat qui les implémente est un token conforme. Les wallets et les exchanges peuvent donc prendre en charge un nouveau token sans développement spécifique.

La présentation d'ERC-20 d'ethereum.org parcourt la même interface avec des exemples. Le fonctionnement complet est détaillé dans notre article sur le standard de token ERC20. Cette page reste du côté de l'adresse : ce qu'est une adresse ERC-20 et comment l'utiliser dans le code.

À quoi ressemble une adresse ERC-20 ?

Une adresse ERC-20 est l'adresse Ethereum ordinaire, par exemple 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed. C'est 0x suivi de 40 caractères hexadécimaux, soit 42 caractères au total. La documentation des comptes d'ethereum.org la décrit comme les 20 derniers octets du hachage Keccak-256 de la clé publique du compte.

Le nom n'apparaît que dans un contexte donné. Une adresse devient une « adresse ERC-20 » quand on parle des tokens qu'elle détient. Rien dans la chaîne ne l'indique comme compatible avec les tokens, et la même adresse sert pour l'ETH, pour chaque token ERC-20 et pour les NFT.

0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed 1 2 3
  1. Le préfixe 0x indique que la valeur est en hexadécimal.
  2. Les 40 caractères hexadécimaux représentent 20 octets : les 20 derniers octets du hachage Keccak-256 de la clé publique.
  3. 42 caractères au total. L'alternance de majuscules et de minuscules est le checksum EIP-55.
Anatomie d'une adresse EVM. Ethereum, Polygon et Arbitrum partagent cette structure.

Comment balanceOf lit-il un solde ERC-20 ?

balanceOf(address) est la fonction en lecture seule qui renvoie le solde de tokens d'une adresse. Le solde n'est pas stocké sur l'adresse. Il se trouve dans le smart contract du token, dans une table indexée par adresse, et balanceOf le consulte.

L'appeler directement oblige à encoder un eth_call JSON-RPC vers le contrat du token, puis à décoder l'hexadécimal renvoyé. Le résultat est un entier exprimé dans la plus petite unité du token, il faut donc lire aussi decimals(). Beaucoup de stablecoins utilisent 6 décimales, d'autres 18, et se tromper est une source fréquente d'erreurs d'un facteur un million.

L'API Chaingateway fait l'encodage et la gestion des décimales à votre place. Les endpoints de solde renvoient des nombres simples, et un problème de RPC brut devient une réponse REST ordinaire.

La même adresse ERC-20 est-elle valide sur Polygon et Arbitrum ?

Oui. Polygon et Arbitrum sont compatibles EVM, donc leurs adresses utilisent exactement le même format 0x. Une adresse dérivée de la même clé privée est la même chaîne sur Ethereum, Polygon et Arbitrum.

Les tokens détenus à cette adresse ne sont pas partagés. Un contrat de token déployé sur Ethereum n'existe pas sur Polygon tant que quelqu'un ne l'y déploie pas ou ne fait pas passer l'actif par un bridge. Les soldes sont donc propres à chaque chaîne, même quand l'adresse ne l'est pas. Les tokens sur Polygon suivent la même interface ERC-20, ce qui explique qu'un seul chemin de code puisse servir les trois chaînes.

ERC-721 et ERC-721A : un autre standard, le même format d'adresse

ERC-721 est le standard de tokens non fongibles d'Ethereum. Chaque identifiant de token est unique, contrairement aux soldes interchangeables d'ERC-20. EIP-721 en spécifie l'interface.

ERC-721A est une implémentation optimisée en gas de la même interface, courante pour les collections créées par lots. Elle change la façon dont le contrat stocke ses données en interne, pas l'aspect de l'adresse d'un détenteur. Les deux standards utilisent la même adresse 0x pour la propriété. L'article sur le standard de token ERC721 traite le côté NFT en détail.

Créer et lire des adresses ERC-20 en REST

Six routes couvrent le cycle de vie des adresses dans une intégration de paiement.

EndpointCe qu'il fait
POST /api/v2/ethereum/addressesGénérer une nouvelle adresse Ethereum
POST /api/v2/ethereum/addresses/importImporter une clé privée pour que l'API puisse signer pour cette adresse
GET /api/v2/ethereum/balances/{address}/erc20/{contract_address}Solde d'un token ERC-20, déjà décodé
GET /api/v2/ethereum/balances/{address}/erc20Tous les soldes de tokens du wallet
POST /api/v2/ethereum/webhooksEnregistrer un webhook pour les dépôts ERC-20 sur l'adresse
POST /api/v2/ethereum/transactions/erc20Envoyer un token ERC-20 depuis l'adresse

La même forme de requête s'applique avec /polygon/ ou /arbitrum/ à la place de /ethereum/ dans le chemin, puisque les trois chaînes partagent le format d'adresse et l'interface ERC-20.

Lire un solde ERC-20 sans eth_call

L'adresse de contrat ci-dessous est celle de l'USDT sur le mainnet Ethereum. Ajoutez X-Network: testnet pour interroger plutôt un token de testnet.

cURL
curl https://app.chaingateway.io/api/v2/ethereum/balances/0xYourAddress/erc20/0xdAC17F958D2ee523a2206206994597C13D831ec7 \
  -H "Authorization: Bearer YOUR_API_KEY"

Comment valider une adresse ERC-20 avant d'envoyer ?

Comparez d'abord la chaîne à l'expression ^0x[a-fA-F0-9]{40}$, qui rejette les mauvaises longueurs et les caractères parasites. Si l'adresse mélange majuscules et minuscules, vérifiez aussi le checksum EIP-55. Une seule lettre erronée fait alors échouer le contrôle.

Un contrôle de format ne dit pas quel réseau le destinataire attend, car la même adresse est valide sur toutes les chaînes EVM. Demandez le réseau explicitement. N'acceptez jamais l'adresse d'un contrat de token comme destination. Le validateur d'adresses exécute les contrôles de format et de checksum dans le navigateur pour une adresse isolée.

Besoin de soldes ERC-20 sans décoder à la main les appels balanceOf ? Créez un compte gratuit et interrogez une adresse de testnet en REST. Essai de 7 jours, sans carte, sans KYC.

FAQ : adresses ERC-20

Le format d'adresse de 42 caractères préfixé par 0x qu'Ethereum utilise pour tous ses comptes, que ceux-ci détiennent ou non des tokens ERC-20. On parle d'adresse ERC-20 quand la discussion porte précisément sur les tokens qu'elle détient.

Un ensemble de fonctions, dont transfer, approve et balanceOf, que tout contrat de token fongible sur Ethereum implémente. Les wallets et les exchanges peuvent ainsi prendre en charge de nouveaux tokens sans code spécifique à chacun.

balanceOf(address) est une fonction en lecture seule que tout contrat ERC-20 expose. L'appeler directement suppose un eth_call vers le contrat du token et le décodage de la réponse hexadécimale. L'API Chaingateway renvoie directement le solde décodé.

Polygon est une blockchain, pas un token, mais elle est compatible EVM. Les tokens qui y vivent implémentent la même interface ERC-20 que ceux d'Ethereum, et une adresse Polygon a exactement le même format 0x.

Une implémentation de la norme NFT ERC-721 optimisée en gas, courante pour les collections créées par lots. Elle modifie le stockage interne du contrat, pas le format d'adresse : la propriété reste associée à une adresse 0x standard.

Prêt à construire sur Ethereum, Polygon ou Arbitrum ?

Créez un compte et interrogez dès aujourd'hui un solde ERC-20 de testnet. Essai de 7 jours, sans carte, sans KYC. La référence complète se trouve dans la documentation de l'API Ethereum. L'API blockchain multi-chaînes couvre les sept chaînes.

Relu par Maurice Sobiera Comment nous rédigeons ces pages