Wei

Wei è la più piccola unità indivisibile di Ether. 1 ETH = 10¹⁸ Wei = 1.000.000.000.000.000.000 Wei. Prende il nome da Wei Dai, il crittografo la cui proposta b-money del 1998 è uno degli antenati concettuali di Bitcoin e del più ampio ecosistema degli smart contract.

Gli smart contract su Ethereum eseguono tutta l’aritmetica del saldo in importi interi in Wei. Non c’è virgola mobile on-chain — ogni campo valore, calcolo del gas e saldo è un valore Wei intero senza segno a 256 bit. ETH e Gwei sono puramente etichette rivolte agli esseri umani; la EVM conosce solo Wei.

In JavaScript questo è importante perché Number.MAX_SAFE_INTEGER è circa 9 × 10¹⁵. Un saldo di 9 ETH è circa 9 × 10¹⁸ Wei — tre ordini di grandezza oltre il limite di precisione di Number. Le librerie di wallet in produzione usano BigInt per gli importi in Wei. Il nostro convertitore Wei / Gwei / ETH usa BigInt in tutta la sua implementazione così le conversioni sono eseguite senza perdita di precisione.

Perché proprio 18 decimali?I progettisti di Ethereum volevano una risoluzione frazionaria abbastanza grande che anche a prezzi del gas estremi il costo di una transazione sia comodamente esprimibile senza notazione scientifica, e abbastanza grande che la commissione pratica più piccola (attualmente qualche migliaio di Wei) sia ancora un numero intero. 18 decimali si trovano comodamente al di sotto del limite di 2²⁵⁶ — un campo valore sulla catena Ethereum può rappresentare fino a ~1,158 × 10⁷⁷ Wei, più Ether di quanti l’universo potrebbe plausibilmente contenere. I token ERC-20 ereditano la stessa convenzione dei 18 decimali per default per coerenza con il livello base, anche se i token sono liberi di scegliere i propri decimali (USDC usa 6, WBTC usa 8).

Importi pratici in Wei che vedrai in un wallet: una tipica transazione sulla mainnet a 30 Gwei di prezzo del gas con un trasferimento semplice da 21.000 gas costa 30 × 10⁹ × 21.000 = 6,3 × 10¹⁴ Wei = 0,00063 ETH. Un’interazione complessa con smart contract (swap su Uniswap, mint di NFT) potrebbe bruciare 200.000+ gas — dell’ordine di 10¹⁶ Wei. Leggere una transazione grezza in Etherscan mostra il campo valore come stringa decimale Wei per esattezza; il livello UI sopra lo renderizza come ETH con un toggle dell’unità. Correlato: Gwei, BigInt. Riferimento: Ethereum Yellow Paper.

Esempio pratico

Vuoi inviare 0,025 ETH da uno script. Converti in Wei: 0,025 × 10¹⁸ = 25.000.000.000.000.000 Wei — un intero a 17 cifre. JavaScript ingenuo: 0.025 * 1e18 valuta a 25000000000000000 ma memorizzarlo come Number normale perde precisione nell’aritmetica intermedia (prova 0.1 * 1e18 + 0.2 * 1e18 — ottieni 299999999999999970, sbagliato di 30 Wei). Il pattern corretto usa BigInt: ethers.parseEther("0.025") restituisce 25000000000000000n (un BigInt) che l’aritmetica preserva esattamente. Ora invia: a 25 Gwei di prezzo del gas per un trasferimento da 21.000 gas, commissione = 25n * 10n**9n * 21000n = 525000000000000n Wei = 0,000525 ETH. Totale che lascia il wallet: 25000000000000000n + 525000000000000n = 25525000000000000n Wei = 0,025525 ETH. Ogni passaggio rimane come Wei intero fino alla visualizzazione.

Quando e perché è importante

Tre classi di bug si riconducono alla gestione errata di Wei. Primo: aritmetica in virgola mobile sui valori ETH che arrotonda silenziosamente e causa che “invia 1,0 ETH” lasci 23 Wei bloccati nel wallet, rompendo successivi controlli del saldo. Secondo: confusione di unità (invio di Gwei dove era atteso Wei, sbagliato di 10⁹) — la transazione imbarazzante canonica è un trasferimento da $4.000 che ha pagato $4.000.000 di commissioni perché uno script ha moltiplicato il prezzo del gas per 10⁹ due volte. Terzo: copiare-incollare un campo valore esadecimale da una risposta RPC e analizzarlo come decimale — un valore di transazione di 0x4563918244F40000 è 5.000.000.000.000.000.000 Wei = 5 ETH, non 4.563.918.244.940.000 di qualsiasi cosa. Le regole difensive: mantenere tutti i valori come BigInt o BN.js ovunque vivano nel codice, etichettare ogni variabile con la sua unità (importoWei, non importo), e usare gli helper di ethers/viem (parseEther, formatEther) solo al confine della visualizzazione umana. Riferimento: ethers.js — Informazioni sulle unità.