Wei vs Gwei : quelle unité utiliser et quand

En bref.Wei est l’unité atomique indivisible d’Ethereum (1 ETH = 10¹⁸ Wei) ; Gwei est l’unité de prix du gas (1 Gwei = 10⁹ Wei = 10⁻⁹ ETH). Utilisez Wei dans les contrats intelligents et les données de transaction brutes, Gwei pour exprimer les prix du gas, et ETH pour les soldes affichés aux utilisateurs.

Ethereum dispose de trois dénominations dans l’usage quotidien. ETH est l’unité lisible par l’humain. Wei est l’unité atomique indivisible en bas de la pile. Gwei se situe au milieu et existe pour une raison pratique : c’est la bonne taille pour exprimer les prix du gas.

La feuille de conversion

1 ETH = 10⁹ Gwei = 10¹⁸ Wei
1 Gwei = 10⁹ Wei = 10⁻⁹ ETH

Convertissez n’importe quelle valeur dans les deux sens via notre convertisseur Wei / Gwei / ETH, qui utilise des mathématiques BigInt partout.

Quand utiliser Wei

• Code de contrat intelligent.Solidity stocke tous les soldes sous forme d’entiers Wei. Il n’y a pas de virgule flottante on-chain ; chaque opération arithmétique doit produire des Wei entiers.
• Lecture d’objets de transaction bruts. Le champ valued’une transaction est exprimé en Wei. Les explorateurs de blocs (Etherscan, etc.) l’affichent en ETH pour la lisibilité, mais le nombre sous-jacent est en Wei.
• Réponses de l’API RPC. La plupart des champs JSON-RPC retournent des chaînes Wei. eth_getBalanceretourne une valeur Wei hexadécimale, pas une valeur ETH.

Quand utiliser Gwei

• Prix du gas.Universellement. “25 Gwei de gas” est l’unité naturelle ; “25 000 000 000 Wei de gas” ou “0,000000025 ETH de gas” seraient tous deux illisibles sur un écran de portefeuille.
• Quotes de base fee + priority fee EIP-1559. Les deux sont exprimées en Gwei. Le Gas Tracker d’Etherscan affiche tout en Gwei. MetaMask, Rabby et chaque autre portefeuille affichent le gas en Gwei.
• Outils d’estimation des frais réseau.Si vous construisez une interface qui dit “frais estimés : 0,0042 ETH”, la multiplication sous-jacente est unités-de-gas × Gwei-par-gas, converti en ETH pour l’affichage.

Quand n’utiliser ni l’un ni l’autre — utilisez ETH

Pour les soldes, les transferts et tout montant destiné aux utilisateurs, utilisez ETH. Les montants Wei de l’ordre de 10¹⁸ sont illisibles ; les montants Gwei de l’ordre de 10⁹ sont à peine mieux. ETH avec 4 à 6 décimales est l’unité naturelle pour “combien ça a coûté”.

Pourquoi le problème BigInt est important

Le type Number de JavaScript utilise la double précision IEEE 754, ce qui donne environ 15 à 17 chiffres décimaux significatifs. 1 ETH = 10¹⁸ Wei nécessite 19chiffres pour être représenté. Donc :

• Stocker un solde de 9 ETH ou plus dans Number perd de la précision.
• Des calculs comme “0,1 ETH + 0,2 ETH = 0,3 ETH” ne se convertissent pas proprement en Wei via Number.
• La conversion naïve Number(weiString) arrondit silencieusement.

Les bibliothèques de production (ethers.js, viem, web3.js) utilisent toutes BigInt ou une classe de type bigint personnalisé pour les montants Wei. Notre convertisseur Wei / Gwei / ETHutilise BigInt tout au long de la conversion, de sorte qu’une valeur comme 123 456 789 012 345 678 Wei convertit vers 0,123456789012345678 ETH et revient sans perdre un seul chiffre.

Le modèle mental

Pensez-y comme les dollars et les cents — mais avec deux unités intermédiaires entre la plus petite et la plus grande. Wei est le centime (atomique, rien de plus petit). Gwei est le dollar (l’unité dans laquelle les prix sont exprimés). ETH est le billet de mille dollars (l’unité dans laquelle les soldes sont rapportés).

Essayez de faire des calculs de prix du gas en Wei : difficile. Essayez d’écrire un contrat intelligent en ETH : impossible (pas de virgule flottante). Chaque unité a son domaine. Ne les mélangez pas.

La conclusion honnête

Pour les prix du gas, Gwei. Pour le code on-chain, Wei. Pour les soldes et les montants destinés aux utilisateurs, ETH. Les trois coexistent pour de bonnes raisons. Convertissez via notre convertisseurquand vous passez de l’un à l’autre ; ne faites pas confiance à votre propre arithmétique mentale au-delà de ~12 zéros.

Chiffres clés

• 1 ETH = 10¹⁸ Wei = 1 000 000 000 000 000 000 Wei — 18 zéros, l’empreinte complète uint256 de chaque solde.
• 1 Gwei = 10⁹ Wei = 1 000 000 000 Wei ; 1 ETH = 10⁹ Gwei.
• Number.MAX_SAFE_INTEGER = 2⁵³−1 ≈ 9,007 × 10¹⁵, ce qui signifie que JS Number peut représenter jusqu’à ~0,009 ETH en Wei sans perte de précision ; tout ce qui est plus grand s’arrondit silencieusement.
• Prix du gas typiques (2024-2026) : base fee 5-50 Gwei dans des conditions normales, 100-500 Gwei lors des pics de mint NFT, >1000 Gwei lors de la congestion de l’ère 2021.
• Coût de transfert ETH standard : 21 000 gas × Gwei actuel. À 30 Gwei, c’est 630 000 Gwei = 0,00063 ETH.
• Autres unités nommées (rarement utilisées) : 1 Kwei = 10³ Wei (Babbage), 1 Mwei = 10⁶ Wei (Lovelace), 1 Twei = 10¹² Wei (Micro/Szabo).
• Ajustement de la base fee EIP-1559 : changement maximum de 12,5 % par bloc (~12 s) ; converge vers la demande en ~6 blocs.

Matrice de décision

Sources

• Ethereum Yellow Paper (Wood, révision Berlin) — Annexe C définit Wei et les dénominations — ethereum.github.io/yellowpaper.
• EIP-1559 — Changement du marché des frais pour la chaîne ETH 1.0 — eips.ethereum.org/EIPS/eip-1559.