Ethereum : ETH, frais de gas et tokens ERC-20 expliqués
Ethereum est une blockchain publique qui exécute des smart contracts et règle deux types de valeur : l'ETH, sa monnaie native, et les tokens construits selon des standards comme ERC-20. Chaque transaction paie du gas en ETH, et les blocs sont produits dans des slots fixes de 12 secondes en proof of stake.
Pour accepter des paiements en Ethereum, il faut une adresse, un moyen de détecter les dépôts et, pour les paiements sortants, de l'ETH qui couvre le gas. L'API Chaingateway fournit les trois en REST : il n'y a aucune node à synchroniser ni web3.js dans votre code. Cette page explique comment fonctionnent le gas, les tokens et la finalité.
Pour l'intégration elle-même, l'API Ethereum de Chaingateway envoie et reçoit de l'ETH et des tokens ERC-20. Faire tourner votre propre node à la place est comparé sur la page node Ethereum.
Qu'est-ce qu'Ethereum règle : de l'ETH ou des tokens ?
Les deux. Ethereum règle l'ETH lui-même et les tokens qui vivent dans des smart contracts sur la même chaîne. ERC-20 est le standard de token derrière l'USDT, l'USDC, le DAI et des milliers d'autres actifs. EIP-20 définit une interface de contrat commune (balanceOf, transfer, approve) qui permet à n'importe quel wallet ou exchange de travailler de la même façon avec tout token conforme.
ERC-721 et ERC-1155 étendent le même modèle de contrat aux actifs non fongibles et multi-tokens. Notre guide du standard de token ERC-20 détaille le format, et le guide de l'adresse ERC-20 explique la différence entre une adresse et un contrat de token.
Qui paie le gas d'une transaction Ethereum ?
L'adresse émettrice paie, en ETH, jamais le destinataire. Un simple transfert d'ETH coûte 21 000 unités de gas, un montant fixe. Un transfert ERC-20 exécute du code de contrat, donc il coûte un multiple de ce montant, et le multiple varie selon le token.
Depuis la mise à jour London (EIP-1559), le prix par unité de gas se divise en des frais de base que le réseau brûle et un pourboire de priorité pour le proposeur du bloc. Les deux montent quand le réseau est chargé. La documentation sur le gas d'ethereum.org donne un exemple chiffré : avec des frais de base de 10 gwei et un pourboire de 2 gwei, un simple transfert coûte 21 000 x 12 gwei, soit 252 000 gwei ou 0,000252 ETH.
Un wallet qui détient des tokens mais pas d'ETH ne peut pas les envoyer, car le contrat du token ne peut pas payer sa propre exécution. Recevoir ne coûte rien au destinataire. Le gas compte quand les fonds ressortent, y compris quand un wallet de trésorerie balaie les dépôts des adresses clients.
Dans l'API Chaingateway, la limite de gas, le prix du gas et les plafonds de frais EIP-1559 (maxFeePerGas, maxPriorityFeePerGas) sont des champs facultatifs d'une requête de transaction. Omettez-les et l'API les fixe quand elle construit et diffuse votre transaction. Passez-les quand vous voulez figer les frais.
Combien de temps avant qu'une transaction Ethereum soit finale ?
Environ 13 minutes, même si l'inclusion dans un bloc prend en général de quelques secondes à une minute. Ethereum fonctionne en proof of stake depuis le Merge. D'après ethereum.org, le temps est divisé en slots de 12 secondes et en epochs de 32 slots, et un validateur est désigné pour proposer un bloc à chaque slot.
Un bloc est finalisé quand les deux tiers de l'ETH staké ont voté pour lui sur deux points de contrôle, ce qui prend environ deux epochs, soit 12,8 minutes. La finalité signifie que le bloc ne peut plus être annulé, sauf si un attaquant détruit au moins un tiers de tout l'ETH staké.
La plupart des applications créditent les dépôts de montant ordinaire après l'inclusion plus quelques blocs, et réservent l'attente complète aux gros montants. Le webhook de dépôt vous donne l'événement on-chain. Où placer le seuil de crédit est une décision de politique, dans votre propre code.
Envoyer et recevoir de l'Ethereum en REST
Webhooks
Enregistrez une URL de callback et recevez une notification HTTPS, signée par un en-tête X-Signature, quand un dépôt est réglé. La livraison n'a pas de renvoi automatique intégré : les notifications échouées sont listées par GET /api/v2/ethereum/webhooks/notifications/failed et peuvent être renvoyées d'un seul appel.
Transactions simples
Envoyez de l'ETH et des tokens ERC-20 avec la limite de gas, le prix du gas et le nonce comme champs facultatifs de la requête. Indiquez le destinataire, le token et le montant, et l'API complète le reste, ou fixez vous-même les champs de frais quand vous voulez garder la main.
Gestion sécurisée des adresses
Le format d'adresse est validé à chaque requête, et les clés existantes entrent par POST /api/v2/ethereum/addresses/import, protégées par mot de passe et stockées chiffrées. L'architecture est non-custodial.
Requêtes décodées
Les transactions reviennent en JSON lisible via GET /api/v2/ethereum/transactions/{txid}/decoded, donc votre application lit des champs structurés au lieu d'analyser la sortie brute d'un contrat.
Démarrer en trois étapes
Créez un compte et copiez votre clé API depuis le tableau de bord. L'essai de 7 jours démarre sans carte bancaire ni KYC.
Appelez GET /api/account pour confirmer que la clé fonctionne, puis créez une adresse ou importez-en une existante avec POST /api/v2/ethereum/addresses/import.
Ajoutez l'en-tête X-Network: testnet, alimentez l'adresse depuis un faucet Sepolia public et envoyez un transfert ERC-20 de test. Enregistrez un webhook, puis retirez l'en-tête : le même code tourne sur le mainnet.
La même requête fonctionne-t-elle sur Polygon et Arbitrum ?
Oui, avec un chemin différent. Le schéma de requête ERC-20 qu'utilise Ethereum se répète sur les autres chaînes EVM que couvre l'API. /api/v2/polygon/transactions/erc20 et /api/v2/arbitrum/transactions/erc20 prennent les mêmes champs que la route d'Ethereum, et BNB Smart Chain utilise /api/v2/bsc/transactions/bep20.
Le code écrit pour Ethereum se porte sur Polygon ou Arbitrum en modifiant le chemin, ce qui compte quand le gas du mainnet rend un petit transfert non rentable. La liste complète des chaînes se trouve dans la vue d'ensemble de l'API blockchain.
Sources
- Gas and fees (ethereum.org)
- Proof-of-stake et Gasper (ethereum.org)
- EIP-1559 : Fee market change
- ERC-20 : Token Standard
Vérifié le 5 novembre 2026.
Questions fréquentes
Prêt à construire sur Ethereum ?
Créez un compte sur app.chaingateway.io/register et envoyez un transfert ERC-20 Sepolia pendant l'essai. La référence complète des endpoints se trouve dans la documentation de l'API Ethereum, et les plans et limites de débit ont leur propre page.