¿Qué es account abstraction? ERC-4337 explicado

Account abstraction permite que un smart contract actúe como tu cuenta, en lugar de una sola clave privada. La cuenta puede definir sus propias reglas para firmar, pagar gas y ejecutar llamadas. ERC-4337 es el estándar que lo hace posible en Ethereum y otras cadenas EVM sin cambiar el protocolo.

Hoy, la mayoría de los usuarios de Ethereum tienen una cuenta de propiedad externa (EOA). Una EOA se controla con una sola clave privada, firma con un solo esquema y necesita ETH antes de poder hacer cualquier cosa. Si pierdes la clave, pierdes la cuenta. Account abstraction elimina estos límites. Dos estándares lo hacen posible: ERC-4337 para smart accounts con su propia dirección, y EIP-7702 para actualizar una EOA existente en el lugar. Ambos funcionan juntos.

¿Qué es account abstraction?

Account abstraction significa que las reglas de una cuenta viven en código, no en el protocolo. Una EOA estándar sigue reglas fijas: una firma ECDSA, un nonce y gas que paga el remitente en ETH. Con account abstraction, una smart account (la especificación de ERC-4337 la llama smart contract account) define su propia lógica de validación.

La especificación de ERC-4337 describe la idea como un modelo "que permite que cada cuenta proporcione su propia lógica de validación, ejecutada como código de smart contract, mientras el protocolo solo impone restricciones mínimas."

Ese único cambio abre funciones que las EOAs no pueden ofrecer:

• Gas patrocinado, donde una app paga la comisión para que un usuario nuevo no necesite ETH.
• Gas pagado en tokens, donde el usuario paga con un ERC-20 como USDC.
• Batching, donde varias llamadas se ejecutan juntas como una sola acción atómica.
• Session keys, donde una app o un agente recibe un permiso limitado que vence.
• Passkeys y otros firmantes, para que el usuario no necesite una frase semilla.
• Recuperación personalizada, donde las reglas de la propia cuenta deciden cómo recuperar el acceso.

¿Qué es ERC-4337?

ERC-4337 es el estándar de Ethereum para account abstraction que no requiere cambios en la capa de consenso. Vitalik Buterin y sus coautores lo propusieron en 2021, y el contrato EntryPoint se puso en marcha en la mainnet de Ethereum el 1 de marzo de 2023.

Las propuestas anteriores cambiaban el protocolo central de Ethereum. ERC-4337 evita eso. Agrega una pseudo-transacción llamada UserOperation, un mempool separado para esas operaciones y un contrato singleton llamado EntryPoint. Como todo se ubica por encima de la capa de consenso, funciona en cualquier cadena EVM donde se haya desplegado el EntryPoint.

Uno de los objetivos de la especificación es que los usuarios puedan prescindir de las EOAs. Una smart account puede firmar con una passkey o cualquier otro esquema, y solo el bundler necesita una EOA para enviar la transacción.

¿Cómo funciona ERC-4337?

Una transacción de ERC-4337 pasa por cinco pasos:

1. El usuario firma una UserOperation. La smart account decide qué cuenta como firma válida.
2. La app la envía a un bundler con eth_sendUserOperation.
3. El bundler la simula, la agrupa con otras UserOperations y envía una sola transacción que llama a handleOps en el EntryPoint.
4. El EntryPoint llama a validateUserOp en la smart account. Si hay un paymaster, también llama a validatePaymasterUserOp. Verifica que alguien pueda cubrir el gas.
5. El EntryPoint llama a la smart account para ejecutar la acción solicitada y luego reembolsa al bundler.

¿Qué es una UserOperation?

Una UserOperation es el objeto de pseudo-transacción que describe lo que el usuario quiere hacer. Incluye el remitente (la smart account), un nonce, los datos de la llamada, los límites de gas y los campos de comisión, una firma y campos opcionales de paymaster. A diferencia de una transacción normal, el código de la propia cuenta verifica la firma. Puede contener varias instrucciones. Lee nuestra guía de UserOperations para ver la lista completa de campos.

¿Qué hace un bundler?

Un bundler es un servicio offchain que vigila el mempool de UserOperations, simula cada operación y agrupa las válidas en una sola transacción onchain. Paga el gas por adelantado y el EntryPoint se lo reembolsa. Los bundlers son los únicos actores de ERC-4337 que deben tener una EOA. Consulta qué es un bundler para ver cómo funcionan y compiten.

¿Qué hace el contrato EntryPoint?

El EntryPoint es un smart contract singleton en el que confían todas las cuentas y todos los bundlers. Ejecuta cada UserOperation en dos fases. En la fase de verificación comprueba la firma y confirma que hay fondos. En la fase de ejecución corre la llamada y reembolsa al bundler. Un único contrato compartido y auditado mantiene las mismas reglas para todos.

¿Qué hace un paymaster?

Un paymaster es un contrato opcional que paga el gas de una UserOperation. Permite que una app patrocine las comisiones, o que el usuario pague con un token ERC-20 en lugar de ETH. El EntryPoint le pide al paymaster que apruebe la operación antes de ejecutarla. Lee qué es un paymaster para conocer los tipos y las compensaciones de seguridad.

¿Qué hace un aggregator?

Un aggregator es un contrato opcional que verifica una sola firma combinada para muchas UserOperations a la vez. Como el bundle lleva una firma en lugar de muchas, ahorra calldata, lo que ayuda sobre todo en rollups. Los aggregators son una optimización. La mayoría de las cuentas no necesitan uno.

¿Qué versión del EntryPoint debes usar?

El EntryPoint tiene varias versiones publicadas. Cada una es un contrato distinto con su propia dirección, y una smart account se construye para una sola versión.

• v0.6: 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789
• v0.7: 0x0000000071727De22E5E9d8BAf0edAc6f37da032
• v0.8: 0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108, que agrega soporte nativo de EIP-7702

Las notas de versión de eth-infinitism también incluyen v0.9, que agrega paymasterSignature para que los paymasters firmen en paralelo. Nuestra API Bundler alojada admite v0.6, v0.7 y v0.8. Llama a eth_supportedEntryPoints en una cadena para ver la lista exacta. Construye las cuentas nuevas sobre v0.7 o v0.8, porque el FAQ del Bundler indica que se planea dejar de dar soporte a v0.6.

¿Qué es EIP-7702?

EIP-7702 es un cambio de protocolo que permite que una EOA establezca código en sí misma. Se activó en la mainnet de Ethereum con la actualización Pectra el 7 de mayo de 2025.

Agrega un nuevo tipo de transacción, 0x04, que lleva una lista de autorizaciones firmadas. Cada autorización escribe un indicador de delegación, 0xef0100 seguido de una dirección de contrato, en el código de la cuenta. Después, las llamadas a la EOA ejecutan el código de esa dirección.

La delegación es persistente. Se mantiene hasta que la cuenta firma una nueva autorización, y delegar a la dirección cero la borra. La EOA conserva su dirección, su saldo y su clave. Delega solo a código de contrato auditado, porque ese código se ejecuta con el saldo y el almacenamiento de la propia cuenta. Para profundizar, lee nuestra guía de EIP-7702.

¿Cuál es la diferencia entre ERC-4337 y EIP-7702?

ERC-4337 ejecuta smart accounts en sus propias direcciones, con un mempool, bundlers y paymasters. EIP-7702 actualiza una dirección existente en el lugar. No son rivales. EIP-7702 cambia lo que una cuenta puede ser, y ERC-4337 aporta la infraestructura para enviar y patrocinar sus operaciones.

Los dos estándares se conectan directamente. La especificación de ERC-4337 admite autorizaciones de EIP-7702. Una UserOperation puede incluir un campo eip7702Auth, y el bundler agrega esa autorización al authorizationList de la transacción que envía. El EntryPoint v0.8 también incluye la delegación en el hash de la UserOperation. Así, una EOA delegada puede usar bundlers y paymasters como cualquier otra smart account.

Elige EIP-7702 cuando tus usuarios ya tengan direcciones EOA, saldos e historial que quieras conservar. Elige una smart account independiente de ERC-4337 cuando la cuenta no deba depender de una sola clave ECDSA, por ejemplo una cuenta solo con passkey, o cuando la cadena no haya habilitado EIP-7702.

¿Qué son las smart accounts modulares?

Una smart account modular divide sus funciones en módulos en lugar de un solo contrato fijo. Un módulo de validación decide quién puede firmar, por ejemplo una passkey o una session key. Un módulo de ejecución agrega acciones nuevas. Los hooks agregan controles, como límites de gasto. Puedes agregar o quitar módulos sin cambiar la dirección de la cuenta.

Dos estándares ERC definen cómo se conectan los módulos: ERC-6900, "Modular Smart Contract Accounts", y ERC-7579, "Minimal Modular Smart Accounts". Ambos se basan en ERC-4337. Nuestro Modular Account v2 sigue ERC-6900.

¿Qué puedes construir con account abstraction?

Account abstraction elimina los pasos que hacen difíciles las apps onchain para los usuarios nuevos.

• Onboarding sin gas. Un usuario nuevo empieza sin ETH y tu app patrocina las primeras transacciones.
• Gas en stablecoins. Los usuarios pagan las comisiones con el token que ya tienen.
• Flujos de un clic. Una aprobación y un swap se ejecutan como un solo batch atómico, así que si algo falla se revierten ambos.
• Juegos y agentes. Una session key permite que un juego o un agente de IA actúe dentro de los límites que definas, sin acceso a toda la cuenta.
• Cuentas con passkey. Los usuarios inician sesión con la passkey de su dispositivo y nunca manejan una frase semilla.
• Recuperación. La cuenta puede agregar guardianes u otras reglas para recuperar el acceso.

¿Cómo respalda Alchemy account abstraction?

Operamos la infraestructura de ERC-4337 y de EIP-7702, para que puedas lanzar un solo flujo para smart accounts nuevas y EOAs existentes.

Bundler

Nuestro Bundler es una API Bundler de ERC-4337 alojada, construida sobre Rundler, nuestro bundler open source en Rust. Admite EntryPoint v0.6, v0.7 y v0.8. Revisa el soporte de funciones por cadena para las cadenas que necesites.

Gas Manager

Gas Manager permite que tu app pague el gas de los usuarios bajo las reglas que definas en una política. Recomendamos Gas Sponsorship mediante Bundler Sponsored Operations, donde pasas un ID de política en un header y no agregas campos de paymaster. Usa el Onchain Paymaster cuando necesites pagos de gas en ERC-20 o un paymaster dentro del flujo. Consulta el FAQ de Gas Manager para ver planes y límites.

Modular Account v2

Modular Account v2 es nuestra smart account recomendada. Sigue ERC-6900, fue auditada por ChainLight y Quantstamp, y admite session keys, passkeys, allowlists, límites de gasto y vencimientos mediante módulos.

Wallet APIs

Las Wallet APIs son la capa de transacciones que se ubica encima. Envían llamadas desde una smart account con patrocinio, batching, reintentos y session keys. Traes tu propio firmante, como Privy, Turnkey o cualquier firmante compatible con viem.

Soporte de EIP-7702

Las Wallet APIs también admiten EIP-7702. Las cuentas EIP-7702 nuevas delegan en Modular Account v2 por defecto, así que una EOA obtiene el mismo batching, patrocinio y session keys sin una dirección nueva.

¿Cómo las propuestas anteriores llevaron a ERC-4337?

Los desarrolladores intentaron construir account abstraction mucho antes de ERC-4337.

• EIP-2938, de 2020, propuso account abstraction en la capa de consenso. Desde entonces fue retirada.
• EIP-3074, también de 2020, agregó los opcodes AUTH y AUTHCALL para que una EOA pudiera delegar el control a un contrato. EIP-7702 la reemplazó.
• ERC-4337, de 2021, tomó otro camino. Mantuvo todos los cambios por encima de la capa de consenso, así que pudo lanzarse sin un hard fork.

Más tarde, EIP-7702 llevó código a la propia EOA, y la especificación de ERC-4337 ahora lo admite. Consulta EIP-3074 vs EIP-7702 vs ERC-4337 para una comparación lado a lado.

¿Cómo empezar con account abstraction?

1. Elige el tipo de cuenta. Usa una smart account de ERC-4337 como Modular Account v2 para usuarios nuevos, o delegación EIP-7702 para EOAs existentes.
2. Elige un firmante. Funcionan las passkeys, un firmante embebido o una EOA existente.
3. Envía tu primera UserOperation a través de un bundler y adjunta una política de patrocinio si quieres que los usuarios no paguen gas.
4. Confirma que tus cadenas de destino admiten lo que necesitas en la tabla de soporte de funciones.

La documentación de Wallet APIs explica cada paso con código. Si escribes tu propia smart account, implementa validateUserOp para la versión del EntryPoint que uses.

Preguntas frecuentes

¿Qué es account abstraction?

Account abstraction permite que un smart contract actúe como tu cuenta en lugar de una sola clave privada. El código de la cuenta decide quién puede firmar, quién paga el gas y qué puede ejecutar. Eso hace posibles el gas patrocinado, el batching, las passkeys y las session keys. En Ethereum, ERC-4337 lo logra sin cambios de protocolo, y EIP-7702 lo lleva a las EOAs existentes.

¿Qué es ERC-4337?

ERC-4337 es el estándar de Ethereum para account abstraction que no requiere cambios en la capa de consenso. Los usuarios firman UserOperations y las envían a un mempool separado. Los bundlers las agrupan en una sola transacción hacia el contrato EntryPoint, que valida y ejecuta cada una. Los paymasters pueden pagar el gas en nombre del usuario.

¿ERC-4337 requiere un hard fork?

No. ERC-4337 funciona con smart contracts y una red de bundlers offchain sobre la cadena existente, así que opera en Ethereum y en cualquier cadena EVM donde se haya desplegado el EntryPoint. EIP-7702 es distinto. Es un cambio de protocolo que se activó con la actualización Pectra el 7 de mayo de 2025.

¿Cuál es la diferencia entre ERC-4337 y EIP-7702?

ERC-4337 ejecuta smart accounts en sus propias direcciones mediante UserOperations y bundlers. EIP-7702 permite que una EOA existente delegue en código de contrato en el lugar, así que la dirección no cambia. Son complementarios, y la especificación de ERC-4337 acepta autorizaciones de EIP-7702 dentro de las UserOperations.

¿EIP-7702 reemplaza a ERC-4337?

No. EIP-7702 actualiza una EOA, pero no ofrece un mempool, bundlers ni paymasters. Eso sigue viniendo de ERC-4337 o de un relayer. Una EOA delegada puede enviar UserOperations a través de un bundler y usar un paymaster, que es como se combinan los dos estándares en la práctica.

¿Qué es una UserOperation?

Una UserOperation es la pseudo-transacción que ERC-4337 usa en lugar de una transacción normal. Contiene el remitente, el nonce, los datos de la llamada, los campos de gas, la firma y datos opcionales del paymaster. Un bundler recoge las UserOperations de un mempool separado y las envía onchain al contrato EntryPoint.

¿Necesito un bundler y un paymaster?

Necesitas un bundler para enviar UserOperations, porque solo un bundler puede enviarlas onchain. El paymaster es opcional. Úsalo cuando quieras patrocinar el gas o dejar que los usuarios paguen con un token ERC-20. Sin paymaster, la smart account paga el gas con su propio depósito en el EntryPoint.

¿Qué versión del EntryPoint debo usar?

Construye las cuentas nuevas sobre EntryPoint v0.7 o v0.8. La versión v0.8 agrega soporte nativo de EIP-7702. Nuestra API Bundler alojada admite v0.6, v0.7 y v0.8, y el FAQ del Bundler indica que se planea dejar de dar soporte a v0.6. Llama a eth_supportedEntryPoints en tu cadena para confirmar la lista.

¿Alchemy admite ERC-4337 y EIP-7702?

Sí. Operamos una API Bundler de ERC-4337 alojada, construida sobre nuestro Rundler open source, Gas Manager para el patrocinio de gas y Wallet APIs con Modular Account v2 como smart account por defecto. Las Wallet APIs también admiten EIP-7702, así que una EOA puede delegar en el código de Modular Account v2.

¿Qué tan usado es account abstraction?

La adopción cambia rápido, así que una cifra fija queda desactualizada. Consulta una fuente en vivo. BundleBear es un panel público que sigue la actividad de smart accounts en distintas cadenas, incluidas las UserOperations de ERC-4337 y las autorizaciones de EIP-7702, y se actualiza de forma continua.