ethers.js vs viem en 2026: qué cambia al elegir o migrar
Versiones, dependencias y un caso de migración: ethers lanza un error con una transacción revertida y viem devuelve el recibo sin lanzarlo.

Cuando un usuario pulsa «Confirmar» en una aplicación sobre Ethereum, el código recorre varios pasos antes de mostrar un resultado: prepara la llamada al contrato a partir de su ABI, pide la firma a la wallet, envía la transacción a un nodo RPC, espera a que se incluya en un bloque y traduce el recibo a un mensaje. ethers.js y viem son las dos bibliotecas de TypeScript con las que se escribe ese recorrido, y cada una define cómo se representa cada paso y qué ocurre cuando alguno falla.
Para una aplicación nueva en TypeScript, viem es hoy la opción coherente con el resto del ecosistema: wagmi 3 la exige como dependencia y Hardhat 3 ofrece un toolbox basado en ella. Para una aplicación que ya funciona con ethers v6, el riesgo de migrar no está en reescribir las llamadas, sino en que las dos bibliotecas no reaccionan igual ante los mismos hechos. La espera del recibo en ethers lanza una excepción si la transacción se revierte, y la de viem devuelve el recibo con el estado reverted, de modo que una migración que traduce línea a línea puede mostrar como completada una operación que falló en la red.
Qué versiones están vigentes y quién depende de cada una
ethers v6 se publicó en febrero de 2023, y su última versión es la 6.17.0, del 18 de junio de 2026; la v5 sigue disponible en npm con la etiqueta legacy-v5 (5.8.0). viem publicó su versión 2.0 en enero de 2024 y la línea 2 sigue recibiendo versiones: entre el 26 de octubre y el 8 de noviembre de 2026 aparecieron seis versiones, de la 2.57.12 a la 2.57.17. La 3.0 está en preparación con la etiqueta next de npm (3.0.0-next.14, de octubre), así que todavía no es una versión estable para producción.
Las dependencias del ecosistema inclinan la balanza en los proyectos nuevos. wagmi 3.7, la biblioteca de hooks de React para conectar wallets, declara viem 2.x como dependencia obligatoria, y el toolbox de Hardhat 3 basado en viem exige viem 2.47.6 o posterior. Un frontend con wagmi ya carga viem; añadir ethers para las llamadas a contratos supone mantener dos modelos de datos y dos jerarquías de errores en el mismo paquete.
Proveedor y firmante frente a clientes y acciones
ethers organiza el código alrededor de objetos con estado: un Provider que habla con el nodo, un Signer que firma y un Contract que combina ABI, dirección y uno de los anteriores, de modo que contract.withdraw(amount) prepara, firma y envía en una sola llamada. viem separa un cliente público, que lee, de un cliente de wallet, que firma, y expone cada operación como una acción con parámetros explícitos: readContract, simulateContract, writeContract o waitForTransactionReceipt. El código resultante es más largo en las llamadas simples y más fácil de seguir cuando una operación combina simulación, firma y espera, porque cada paso devuelve un valor que el siguiente recibe.
El tipado es la otra diferencia de diseño. viem infiere nombres de funciones, argumentos y tipos de retorno a partir del ABI si este se declara con as const o en línea, mediante la biblioteca ABIType, y su documentación de TypeScript exige TypeScript 5.0.4 o posterior. Un nombre de función mal escrito o un argumento de tipo incorrecto aparece al compilar. La inferencia compara el código con el ABI declarado, no con el contrato desplegado: si la dirección apunta a otra versión del contrato, el compilador no puede saberlo, y esa comprobación corresponde a las pruebas contra la red.
Cuando una transacción revertida aparece como completada
Pensemos, como ejemplo hipotético, en una aplicación que permite retirar fondos de un depósito con un botón. La versión en ethers v6 envía la transacción con contract.withdraw(amount), espera con await tx.wait() y muestra «Retirada completada» si no hay excepción; el bloque catch muestra el error. Ese código cubre el caso en que la transacción se incluye en un bloque pero se revierte, porque wait() comprueba el recibo y, si su estado es 0, lanza un error CALL_EXCEPTION con el mensaje «transaction execution reverted».
El equipo migra a viem y traduce cada línea: writeContract envía la transacción y devuelve su hash, y waitForTransactionReceipt espera el recibo. La estructura try/catch se conserva, pero el comportamiento cambia. En viem 2.57.17, waitForTransactionReceipt resuelve con el recibo sin comprobar su estado, y el formateador de recibos traduce el valor 0x0 a status: 'reverted'; la promesa solo se rechaza por un tiempo de espera agotado o un error al consultar el nodo. Si otro usuario retira entre el envío y la inclusión y el saldo del depósito ya no alcanza, la transacción se incluye, se revierte, consume gas y la interfaz migrada muestra «Retirada completada».
La corrección es pequeña una vez identificada: comprobar si receipt.status es 'reverted' y tratarlo como un error, o encapsular la espera en una función que reproduzca el comportamiento anterior. Lo difícil es encontrarla antes de producción. Una migración entre bibliotecas necesita pruebas de cada resultado posible del flujo (firma rechazada, transacción revertida, transacción reemplazada desde la wallet, nodo sin respuesta) y no solo del caso correcto. viem cubre además el reemplazo: waitForTransactionReceipt detecta si la transacción se sustituyó por otra con el mismo nonce y clasifica el motivo como cancelled, replaced o repriced, otro resultado para el que la interfaz necesita un mensaje propio.
Simular antes de enviar no reserva el estado
La documentación de writeContract advierte que la acción no valida si la escritura va a funcionar y recomienda llamar antes a simulateContract, que ejecuta la llamada sin difundirla y devuelve el resultado o el motivo del rechazo; ethers ofrece la misma comprobación con staticCall sobre el método del contrato. Simular sirve para mostrar un error comprensible antes de pedir la firma, por ejemplo un saldo insuficiente, en lugar de un fallo genérico de estimación de gas en la wallet.
La simulación refleja el estado del bloque consultado, no el del bloque en que se incluirá la transacción. En el caso de la retirada, la simulación pasa y la transacción se revierte después porque el estado cambió entre las dos lecturas. Simular y comprobar el recibo son dos controles distintos, uno antes de la firma y otro después de la inclusión, y ninguno sustituye al otro.
Tamaño del paquete: qué medir antes de citar una cifra
Una cifra de kilobytes sin versión, imports ni bundler no permite comparar ethers y viem. viem está organizado en acciones independientes que el tree-shaking puede eliminar si no se importan, y el resultado final depende también de los conectores de wallet y de la configuración del bundler. La cifra que interesa a un producto es el JavaScript que llega al navegador en la página donde se firma, medido con el mismo bundler y las mismas operaciones en las dos versiones: conectar la wallet, leer un saldo y enviar una transacción.
ethers.js vs viem: el coste de migrar está en el manejo de errores
viem resuelve bien dos problemas reales: detecta al compilar los errores de llamada contra el ABI declarado y hace explícito cada paso del flujo, lo que facilita tratar por separado la simulación, la firma, la inclusión y el reemplazo. Para un frontend nuevo con React y wagmi, usar otra biblioteca para los contratos añade una dependencia sin ventaja clara. ethers v6 sigue mantenida, con una versión publicada en junio de 2026, y una aplicación que funciona con ella no gana seguridad por migrar: gana tipos y coherencia con wagmi, a cambio de revisar cada punto en el que el código depende de cómo ethers lanza sus errores.
Si la migración se hace, el orden importa: primero un inventario de los errores que consume la interfaz, después pruebas que provoquen cada uno contra una red local y solo entonces la sustitución de llamadas. La llegada de viem 3 no cambia este criterio; mientras siga en la etiqueta next, un proyecto en producción se escribe sobre la línea 2.
Nuestro equipo construye el frontend y los smart contracts de aplicaciones descentralizadas, desde un MVP hasta su operación, y la guía sobre cómo crear una dApp recorre el resto de decisiones del producto. Si estás valorando una migración, cuéntanos qué flujos tiene la aplicación y qué errores muestra hoy a sus usuarios.
- ethers.js v6.17.0 release (GitHub)
- ethers.js v6 source: TransactionResponse.wait (provider.ts)
- ethers.js v6 documentation
- viem 2.57.17 release (GitHub)
- viem source: waitForTransactionReceipt
- viem source: transaction receipt formatter
- viem: TypeScript
- viem: writeContract
- wagmi 3.7.11 on npm
- @nomicfoundation/hardhat-toolbox-viem 5.0.7 on npm
Preguntas frecuentes
¿Tienes un proyecto blockchain en mente?
De la idea al producto, estrategia y tecnología deben avanzar juntas.







