Wei

Wei es la unidad más pequeña e indivisible de Ether. 1 ETH = 10¹⁸ Wei = 1 000 000 000 000 000 000 Wei. Nombrado en honor a Wei Dai, el criptógrafo cuya propuesta b-money de 1998 es uno de los antecedentes conceptuales de Bitcoin y del ecosistema más amplio de contratos inteligentes.

Los contratos inteligentes en Ethereum realizan toda la aritmética de saldos en cantidades enteras de Wei. No hay punto flotante en la cadena — cada campo de valor, cálculo de gas y saldo es un valor Wei de entero sin signo de 256 bits. ETH y Gwei son etiquetas puramente orientadas al usuario; la EVM solo conoce Wei.

En JavaScript esto importa porque Number.MAX_SAFE_INTEGER es aproximadamente 9 × 10¹⁵. Un saldo de 9 ETH es aproximadamente 9 × 10¹⁸ Wei — tres órdenes de magnitud por encima del umbral de precisión de Number. Las bibliotecas de billeteras en producción usan BigInt para las cantidades en Wei. Nuestro conversor Wei / Gwei / ETH usa BigInt en toda su extensión para que las conversiones sean exactas sin pérdida de precisión.

¿Por qué 18 decimales específicamente? Los diseñadores de Ethereum querían una resolución fraccionaria lo suficientemente grande como para que incluso con precios de gas extremos, el coste de una transacción sea cómodamente expresable sin notación científica, y lo suficientemente grande como para que la tarifa práctica mínima (actualmente unos pocos miles de Wei) siga siendo un número entero. 18 decimales también está cómodamente por debajo del techo de 2²⁵⁶ — un campo de valor en la cadena Ethereum puede representar hasta ~1,158 × 10⁷⁷ Wei, más Ether del que el universo podría contener. Los tokens ERC-20 heredan la misma convención de 18 decimales por defecto para mantener coherencia con la capa base, aunque los tokens pueden elegir sus propios decimales (USDC usa 6, WBTC usa 8).

Cantidades prácticas de Wei que verás en una billetera: una transacción típica en la red principal a un precio de gas de 30 Gwei con una transferencia simple de 21 000 de gas cuesta 30 × 10⁹ × 21 000 = 6,3 × 10¹⁴ Wei = 0,00063 ETH. Una interacción compleja con un contrato inteligente (swap de Uniswap, mint de NFT) podría consumir más de 200 000 de gas — del orden de 10¹⁶ Wei. Leer una transacción en bruto en Etherscan muestra el campo de valor como una cadena Wei decimal para mayor exactitud; la capa de interfaz de usuario la renderiza como ETH con un selector de unidades. Relacionado: Gwei, BigInt. Referencia: Papel Amarillo de Ethereum.

Ejemplo práctico

Quieres enviar 0,025 ETH desde un script. Convierte a Wei: 0,025 × 10¹⁸ = 25 000 000 000 000 000 Wei — un entero de 17 dígitos. JavaScript ingenuo: 0.025 * 1e18 evalúa a 25000000000000000 pero almacenarlo como un Number normal pierde precisión en la aritmética intermedia (prueba 0.1 * 1e18 + 0.2 * 1e18 — obtienes 299999999999999970, con 30 Wei de error). El patrón correcto usa BigInt: ethers.parseEther("0.025") devuelve 25000000000000000n (un BigInt) que la aritmética preserva exactamente. Ahora envía: a un precio de gas de 25 Gwei para una transferencia de 21 000 de gas, comisión = 25n * 10n**9n * 21000n = 525000000000000n Wei = 0,000525 ETH. Total que sale de la billetera: 25000000000000000n + 525000000000000n = 25525000000000000n Wei = 0,025525 ETH. Cada paso permanece como Wei entero hasta la visualización.

Cuándo y por qué importa

Tres clases de errores tienen su origen en el manejo incorrecto de Wei. Primero: la aritmética de punto flotante en valores ETH que redondea silenciosamente y hace que “enviar 1,0 ETH” deje 23 Wei atascados en la billetera, rompiendo las comprobaciones de saldo posteriores. Segundo: confusión de unidades (enviando Gwei donde se esperaba Wei, con un error de 10⁹) — la transacción embarazosa canónica es una transferencia de 4 000 dólares que pagó 4 000 000 dólares en comisiones porque un script multiplicó el precio del gas por 10⁹ dos veces. Tercero: copiar y pegar un campo de valor hexadecimal de una respuesta RPC y analizarlo como decimal — un valor de transacción de 0x4563918244F40000 es 5 000 000 000 000 000 000 Wei = 5 ETH, no 4 563 918 244 940 000 de nada. Las reglas defensivas: mantener todos los valores como BigInt o BN.js dondequiera que vivan en el código, etiquetar cada variable con su unidad (amountWei, no amount) y usar los helpers de ethers/viem (parseEther, formatEther) solo en el límite de visualización al usuario. Referencia: ethers.js — Acerca de las unidades.