Entry Point: ¿Qué es un Entry Point en el ámbito cripto?En las criptomonedas, un entry point puede referirse, en general, al contrato, la función o la interfaz mediante la que un usuario inicia una operación en unEntry Point: ¿Qué es un Entry Point en el ámbito cripto?En las criptomonedas, un entry point puede referirse, en general, al contrato, la función o la interfaz mediante la que un usuario inicia una operación en un
¿Qué es un Entry Point en el ámbito cripto?
En las criptomonedas, un entry point puede referirse, en general, al contrato, la función o la interfaz mediante la que un usuario inicia una operación en una blockchain.En la abstracción de cuentas, Entry Point suele referirse al contrato inteligente central EntryPoint definido por ERC-4337.El contrato EntryPoint coordina la validación, ejecución, pago del gas, despliegue de cuentas y liquidación de las operaciones enviadas por smart accounts.La especificación oficial ERC-4337 describe un sistema en el que los usuarios envían objetos llamados UserOperations en lugar de enviar transacciones ordinarias directamente desde cuentas de propiedad externa.
Participantes especiales de la red, llamados bundlers, reúnen estas UserOperations y las envían al contrato EntryPoint mediante una transacción blockchain normal.A continuación, EntryPoint comprueba si cada operación está autorizada, determina cómo se pagará el gas, llama a la smart account correspondiente y liquida el coste final del gas.EntryPoint no es una wallet, un token, una blockchain, una clave privada ni una red de criptomonedas independiente.Es una infraestructura compartida de contratos inteligentes que utilizan wallets de abstracción de cuentas, bundlers, fábricas de cuentas, paymasters y aplicaciones compatibles.¿Qué es ERC-4337?
ERC-4337 es un estándar de abstracción de cuentas que permite utilizar smart accounts programables sin necesidad de un nuevo tipo de transacción de Ethereum en la capa de consenso.Las cuentas de propiedad externa tradicionales utilizan reglas de firma y nonce definidas por el protocolo.Una smart account ERC-4337 puede utilizar código de contrato para definir su propia lógica de autorización.Esto puede permitir aprobaciones multifirma, claves de acceso, sistemas de recuperación, permisos de sesión, límites de gasto, acciones por lotes y otras funciones de wallet programables.ERC-4337 introduce un flujo independiente de UserOperations y, finalmente, liquida la actividad mediante transacciones normales incluidas en bloques.La descripción general de la abstracción de cuentas de Ethereum explica que ERC-4337 ofrece funciones de smart account sin cambiar las reglas básicas de consenso de Ethereum.
EntryPoint es el contrato on-chain compartido que conecta las distintas partes de este sistema.¿Por qué se llama EntryPoint?
El contrato se llama EntryPoint porque es la principal puerta de entrada de confianza por la que las operaciones ERC-4337 llegan a una smart account.Normalmente, una smart account compatible acepta llamadas de validación y ejecución de ERC-4337 solo desde una dirección EntryPoint en la que confía.Los bundlers no llaman a funciones arbitrarias de ejecución de la wallet como si fueran su titular.En su lugar, envían UserOperations a EntryPoint, que pide a cada smart account que valide su propia operación.Esta estructura separa a la parte que paga y envía la transacción blockchain de la cuenta que autoriza la acción subyacente.También proporciona a los bundlers una interfaz de contrato estandarizada para procesar distintos diseños de smart accounts.¿Cuál es la versión actual de EntryPoint?
A 16 de julio de 2026, el repositorio oficial de abstracción de cuentas identifica EntryPoint v0.9.0 como su versión más reciente.La página oficial de versiones de abstracción de cuentas indica que la dirección de EntryPoint v0.9 es
0x433709009B8330FDa32311DF1C2AFA402eD8D009
.Las notas de la versión describen v0.9 como compatible a nivel de ABI con EntryPoint v0.7 y v0.8 para las interfaces existentes de cuentas y paymasters, salvo que una implementación opte por utilizar las nuevas funciones.Aun así, los bundlers deben conocer la nueva versión antes de participar en su mempool de UserOperations.Las versiones anteriores de EntryPoint pueden seguir existiendo y procesando operaciones en redes cuya infraestructura todavía las admita.Una wallet debe utilizar un bundler, paymaster, factory e implementación de smart account compatibles con la misma versión de EntryPoint.Antes de cambiar de versión, los desarrolladores deberían verificar la dirección, la red, el bytecode desplegado, el hash del código, las notas de la versión y los informes de seguridad.¿Por qué hay varias versiones de EntryPoint?
EntryPoint se despliega como contrato inteligente, por lo que su código no se puede modificar sin más si el despliegue es inmutable.Por lo general, se introduce una nueva versión desplegando otro contrato EntryPoint en una nueva dirección determinista.Las wallets y la infraestructura pueden migrar después de revisar el nuevo contrato y añadir compatibilidad con su comportamiento.Este enfoque evita conceder a un único administrador poderes ilimitados para sustituir el código del singleton existente.También implica que, durante los periodos de migración, la infraestructura de abstracción de cuentas puede fragmentarse entre distintas versiones.Una UserOperation destinada a un EntryPoint no debe enviarse como si estuviera destinada a otra versión.La dirección de EntryPoint seleccionada se incluye en cálculos de seguridad importantes, como el hash de la operación.¿Qué es una UserOperation?
Una UserOperation es una solicitud estructurada que describe una acción que una smart account quiere realizar.A veces se abrevia como UserOp.Una UserOperation no es una transacción ordinaria de Ethereum, aunque un bundler acaba incluyéndola en una transacción ordinaria que envía a EntryPoint.Sus campos identifican la smart account, el nonce, los datos de ejecución, los límites de gas, los límites de comisiones, la firma, los datos opcionales de despliegue de la cuenta y la información opcional del paymaster.Las versiones actuales utilizan una representación empaquetada llamada
PackedUserOperation
al transmitir los datos on-chain.EntryPoint utiliza esta información para coordinar la validación, la ejecución y la liquidación del gas.Una UserOperation no pasa a ser válida simplemente porque sus datos tengan el formato correcto.La smart account, EntryPoint, las reglas del bundler y cualquier paymaster seleccionado deben aceptarla.Campos principales de una UserOperation
El campo
sender
identifica la smart account que validará y ejecutará la operación.El campo
nonce
ayuda a evitar repeticiones y puede admitir varios canales de operaciones ordenadas.Los campos de despliegue de la cuenta permiten crear una smart account aún no desplegada como parte de su primera operación.El campo
callData
describe la llamada que debe ejecutar la smart account.Los campos de gas establecen límites para la validación, la ejecución y otras tareas pagadas por la operación.Los campos de comisiones definen el precio máximo del gas y la comisión de prioridad que acepta la operación.Los campos del paymaster identifican un contrato opcional que acepta cubrir los costes del gas.El campo
signature
contiene datos de autorización que interpreta la lógica de validación de la smart account.La firma no tiene que ser una firma básica de una sola clave, ya que la smart account puede implementar otro método de autorización seguro.Cómo llega una UserOperation a EntryPoint
Primero, una wallet crea una UserOperation que describe la acción blockchain solicitada.La wallet obtiene el nonce correcto y estima los campos de gas necesarios para la operación.El sistema de autorización de la smart account firma o aprueba la operación de otro modo.La wallet la envía a un bundler mediante un método RPC de abstracción de cuentas.Antes de aceptarla, el bundler simula la lógica de validación.Las operaciones aceptadas pueden entrar en un mempool específico de UserOperations.El bundler selecciona un grupo de operaciones y las envía a EntryPoint en una sola transacción blockchain.EntryPoint valida y ejecuta las operaciones conforme a las reglas de ERC-4337.Tras la ejecución, EntryPoint paga al beneficiario elegido por el bundler con los fondos de gas cobrados a las cuentas o a los paymasters.¿Qué es un bundler?
Un bundler es un participante de la abstracción de cuentas que recopila, valida, agrupa y envía UserOperations.El bundler paga la comisión de transacción nativa de la red al enviar la transacción agrupada a la blockchain.Espera que EntryPoint le reembolse los costes de las operaciones con los depósitos de las smart accounts o los paymasters.Esto impone un requisito económico importante, ya que los bundlers deben rechazar las operaciones que podrían consumir gas sin pagarlo.Normalmente, un bundler simula una operación varias veces, a medida que cambia el estado de la blockchain entre su recepción inicial y el envío final.La interfaz JSON-RPC ERC-7769 estandarizada define métodos que las wallets y los bundlers pueden utilizar para intercambiar UserOperations y consultar su estado.
Un bundler no es el titular de la smart account y no debería poder autorizar una operación que la cuenta rechace.La función handleOps
La función principal de EntryPoint es
handleOps
.Acepta una matriz de UserOperations empaquetadas y una dirección de beneficiario.El bundler llama a esta función en la transacción que entrega un lote a la blockchain.EntryPoint procesa las operaciones mediante fases de validación y ejecución.Comprueba si es necesario desplegar la cuenta, verifica los nonces, calcula la prefinanciación necesaria, llama a la validación de la cuenta y del paymaster y confirma que hay fondos de gas suficientes.A continuación, llama a las smart accounts para que ejecuten las acciones solicitadas.Tras procesarlas, calcula los costes reales y transfiere las comisiones recaudadas al beneficiario.El beneficiario suele estar controlado por el bundler, pero la función del protocolo acepta la dirección que se elija para el pago.La validación y la ejecución son fases separadas
ERC-4337 separa la validación de la ejecución principal de la operación.Durante la validación, EntryPoint determina si la cuenta autoriza la operación y si se pueden pagar los costes de gas.Durante la ejecución, la smart account realiza las llamadas solicitadas.Esta distinción es importante porque una operación puede superar las comprobaciones de autorización y, aun así, fallar durante la llamada de la aplicación.Por ejemplo, una smart account puede autorizar correctamente una transferencia de tokens que después falla porque la cuenta no tiene el saldo de tokens necesario.La validación y la ejecución fallida consumen gas.Por tanto, se puede cobrar a la cuenta o al paymaster aunque no se complete la acción prevista de la aplicación.La función validateUserOp
Una smart account ERC-4337 implementa una función llamada
validateUserOp
.EntryPoint llama a esta función durante la validación.La cuenta recibe la operación empaquetada, su hash e información sobre los fondos de gas que faltan.La cuenta debe confirmar que quien llama es un EntryPoint de confianza.A continuación, debe aplicar sus propias reglas de autorización a la operación.Una cuenta sencilla podría verificar una firma criptográfica.Una cuenta más avanzada podría exigir varias firmas, una prueba de clave de acceso, un guardián de recuperación, un permiso de clave de sesión o una comprobación de la política de gasto.La cuenta también puede devolver un intervalo de validez que limite cuándo se puede incluir la UserOperation.Por qué la smart account debe confiar en el EntryPoint exacto
EntryPoint tiene permiso para llamar a rutas sensibles de validación y ejecución de una smart account.Por tanto, una smart account debería rechazar las llamadas de un contrato no fiable que se haga pasar por EntryPoint.Confiar en una dirección equivocada podría permitir que un contrato malicioso eludiera las suposiciones sobre la gestión de nonces, el cálculo del gas, la identidad de quien llama o el orden de ejecución.La implementación de una wallet debe definir cómo reconoce una versión de EntryPoint aprobada.Algunas cuentas utilizan una dirección fija, mientras que las cuentas actualizables o modulares pueden admitir un proceso de migración controlado.Añadir un EntryPoint nuevo debería considerarse una actualización sensible para la seguridad de la wallet, no un ajuste rutinario de interfaz.Hash de UserOperation y protección contra repeticiones
El hash de UserOperation vincula la operación a datos importantes utilizados en la autorización.El hash incluye la dirección de EntryPoint y el ID de la cadena de la blockchain.Así se impide que una operación válida destinada a un EntryPoint o una red se reutilice automáticamente en otro.La firma se excluye del hash subyacente de la operación para que la cuenta pueda validar los datos de autorización proporcionados con respecto a ese hash.Los diseños actuales de firmas de paymaster también pueden excluir una firma de paymaster independiente del hash, lo que permite generar en paralelo las firmas de la wallet y del paymaster.Los desarrolladores deben seguir las reglas exactas de hash de la versión de EntryPoint seleccionada.Una separación de dominios incorrecta puede crear riesgos de repetición o impedir la validación de operaciones legítimas.Gestión de nonces de EntryPoint
EntryPoint gestiona los nonces para impedir que se ejecute repetidamente la misma UserOperation.ERC-4337 utiliza un nonce de dos partes formado por una clave de 192 bits y un valor de secuencia de 64 bits.Cada clave puede representar un canal ordenado independiente para una smart account.Esto permite que una cuenta mantenga operaciones normales, operaciones administrativas u otras categorías sin obligar a que todas las acciones sigan una única secuencia global.La función
getNonce
devuelve el nonce actual de un emisor y una clave de nonce.Un bundler debería comprobar el nonce antes de aceptar una operación y volver a hacerlo antes de incluirla.La smart account puede aplicar restricciones adicionales a los nonces cuando lo requiera su modelo de seguridad.Despliegue contrafactual de una smart account
A menudo se puede calcular la dirección de una wallet ERC-4337 antes de desplegar el contrato de smart account.Esto se denomina dirección contrafactual.La wallet puede recibir criptoactivos en la dirección calculada antes de su primera operación de abstracción de cuentas.La primera UserOperation incluye información de despliegue de la cuenta que identifica una factory y los datos de inicialización.EntryPoint utiliza su helper SenderCreator para llamar a la factory y crear la smart account en la dirección esperada.La dirección desplegada debe coincidir con el campo
sender
de la UserOperation.Si la cuenta no existe y la operación no contiene datos de despliegue válidos, la validación falla.EntryPoint v0.9 e initCode
EntryPoint v0.9 cambia la forma de gestionar los datos de despliegue cuando la cuenta emisora ya existe.En el comportamiento anterior, se esperaba que
initCode
no estuviera vacío solo en la operación que desplegaba la cuenta.La versión 0.9 puede ignorar los datos de despliegue si el contrato del emisor ya existe y emitir un evento
IgnoredInitCode
.Esto permite que las cuentas aún no desplegadas preparen operaciones paralelas utilizando distintos canales de nonce.El código de la cuenta no debería suponer que unos datos de despliegue no vacíos demuestran siempre que la operación es la primera de la cuenta.Los desarrolladores que migren a v0.9 deberían revisar cualquier lógica que dependa de esta suposición anterior.Prefinanciación del gas
Un bundler paga la comisión de red de la transacción que llama a EntryPoint.Por tanto, EntryPoint debe confirmar que cada UserOperation puede reembolsar su coste máximo previsto.Durante la validación, calcula la prefinanciación necesaria mediante los límites de gas y los ajustes de comisiones de la operación.La smart account puede mantener un depósito en EntryPoint para este fin.Si el depósito de la cuenta no es suficiente, esta puede transferir moneda nativa adicional a EntryPoint durante la validación.Cuando un paymaster patrocina la operación, se utiliza el depósito del paymaster.Una prefinanciación insuficiente invalida la operación para su inclusión.Depósitos de EntryPoint
EntryPoint mantiene depósitos que se utilizan para pagar futuros costes de gas de UserOperations.Las smart accounts y los paymasters pueden añadir moneda nativa a estos depósitos.La función
depositTo
añade fondos para una cuenta o un paymaster determinados.La función
balanceOf
de EntryPoint muestra el depósito de gas de una entidad.La entidad autorizada puede utilizar
withdrawTo
para retirar un depósito disponible conforme a las reglas del contrato.Un depósito no genera rendimiento ni representa una inversión tokenizada.Es moneda nativa prefinanciada que se reserva para liquidar el gas de la abstracción de cuentas.¿Qué es un paymaster?
Un paymaster es un contrato inteligente opcional que acepta cubrir el coste del gas de determinadas UserOperations.Esto puede permitir que una aplicación subvencione la actividad de los usuarios o aplique otro sistema de comisiones.El paymaster deposita moneda nativa en EntryPoint.Durante la validación, EntryPoint llama a
validatePaymasterUserOp
para preguntar si el paymaster acepta asumir la responsabilidad de la operación.El paymaster puede evaluar la identidad de la cuenta, los datos de llamada, los límites temporales, la autorización firmada, las políticas de gasto u otras condiciones.Si devuelve datos de contexto, EntryPoint puede llamar a la función
postOp
del paymaster después de la ejecución.El paymaster sigue pagando el gas si la llamada de la aplicación de la cuenta revierte tras una validación correcta.Depósitos de paymaster frente a staking
El depósito y el stake de un paymaster tienen finalidades distintas.El depósito paga los costes de gas de las UserOperations.El stake queda bloqueado como parte de la defensa del sistema contra ataques de denegación de servicio y abusos de reputación.La función
addStake
bloquea el stake e incluye un plazo de espera para retirarlo.Antes de retirar el stake, el paymaster debe llamar a
unlockStake
y esperar a que transcurra ese plazo.La función
withdrawStake
libera un stake desbloqueado que cumpla los requisitos.Un depósito elevado no satisface automáticamente un requisito de staking.Un stake no sustituye al depósito necesario para pagar el gas patrocinado.Firmas de paymaster en EntryPoint v0.9
EntryPoint v0.9 añade compatibilidad con un valor
paymasterSignature
independiente.En los flujos anteriores, la wallet podía tener que esperar a recibir los datos completos del paymaster antes de firmar su UserOperation.El nuevo diseño permite generar en paralelo la firma de la wallet y la del paymaster cuando este admite la función.Con la codificación especificada, la firma independiente del paymaster no modifica el hash de UserOperation.Esto puede reducir los retrasos en los flujos de usuario con operaciones patrocinadas.Antes de utilizar esta función, las wallets, los paymasters y los bundlers deben comprender la codificación específica de la versión.Stakes y reputación en EntryPoint
La validación ERC-4337 puede involucrar a factories de cuentas, paymasters, agregadores de firmas y otros contratos.Las entidades maliciosas podrían intentar desperdiciar los recursos de los bundlers o hacer que las operaciones resulten inválidas después de entrar en el mempool.El staking permite a algunas entidades acceder a más almacenamiento durante la validación, a la vez que las expone a consecuencias reputacionales.Los bundlers pueden vigilar a las entidades que provocan repetidamente lotes inválidos o se comportan de forma abusiva.Las políticas de reputación off-chain concretas pueden variar entre implementaciones de bundler.El staking reduce ciertos incentivos para atacar, pero no demuestra que un paymaster o una factory sean de confianza.¿Qué es la simulación de UserOperations?
La simulación es el proceso off-chain que utiliza un bundler para prever si una UserOperation superará la validación de EntryPoint.El bundler realiza llamadas y trazas sobre el estado actual de la blockchain sin confirmar los cambios simulados.La simulación comprueba la creación de la cuenta, la validez del nonce, la autorización de la cuenta, la aprobación del paymaster, la financiación del gas y las restricciones del comportamiento de validación.Normalmente, el bundler simula la operación cuando la recibe por primera vez, de nuevo al seleccionarla para un lote y otra vez antes de enviarlo.Es necesario repetir la simulación porque otra transacción puede cambiar los saldos, depósitos, nonces, código de contrato u otros datos pertinentes.Una simulación correcta no garantiza que la ejecución de la aplicación vaya a tener éxito.Reglas de validación ERC-7562
La validación programable crea riesgos de denegación de servicio que no existen del mismo modo con las firmas de cuentas ordinarias.Una cuenta maliciosa podría hacer depender la validación de un estado inestable o consumir muchos recursos del bundler.Las reglas de validación ERC-7562 limitan los opcodes, el acceso al almacenamiento y otros comportamientos utilizados durante la validación pública de UserOperations en el mempool.
Los bundlers aplican estas reglas off-chain antes de incluir las operaciones.Las restricciones afectan a la validación, no a todas las acciones realizadas durante la ejecución principal de la cuenta.Una operación aceptada en un mempool privado o alternativo puede estar sujeta a políticas distintas de las del mempool compartido canónico.Ejecución de UserOperations
Una vez superada la validación, EntryPoint llama a la smart account para que ejecute la operación solicitada.La cuenta interpreta su
callData
conforme a su implementación.La operación puede llamar a un contrato, transferir criptoactivos o ejecutar un lote de varias acciones.EntryPoint no determina si la acción de la aplicación tiene sentido desde el punto de vista financiero.Coordina la autorización de la cuenta, el cálculo del gas y la ejecución conforme a las reglas del contrato.Una operación correctamente autorizada aún puede interactuar con un token malicioso, un contrato inseguro o una posición financiera desfavorable.La interfaz IAccountExecute
Una smart account puede implementar opcionalmente
IAccountExecute
.Esta interfaz proporciona una función
executeUserOp
que recibe la UserOperation empaquetada actual y su hash.EntryPoint puede llamar a esta función en lugar de llamar directamente a la cuenta con los datos de ejecución originales.Esto permite que la cuenta inspeccione más información de la UserOperation durante la ejecución.El método de ejecución exacto depende de la versión de EntryPoint y de las interfaces admitidas por la cuenta.La función getCurrentUserOpHash
EntryPoint v0.9 añade
getCurrentUserOpHash
.Esta función permite a un contrato consultar el hash de la UserOperation que se está ejecutando en ese momento.El valor solo está disponible dentro del marco de ejecución correspondiente.Fuera de la ejecución de una UserOperation, la función devuelve un valor cero conforme a la interfaz especificada.Esta función puede ayudar a contratos de terceros a vincular el comportamiento de ejecución con la UserOperation exacta que se está procesando.Los desarrolladores no deberían interpretar un resultado cero fuera del marco de ejecución como prueba de que quien llama es de confianza.Liquidación del gas y beneficiario
EntryPoint mide el gas asociado al procesamiento de cada UserOperation.Cobra a la cuenta o al paymaster responsable según el coste real y los límites de comisiones de la operación.Las comisiones recaudadas se envían al beneficiario indicado en la llamada del bundler a
handleOps
.Así se reembolsa a la entidad que envió y pagó la transacción blockchain.El valor prefinanciado que no se haya utilizado permanece en el depósito de EntryPoint de la cuenta o del paymaster.Los errores de estimación del gas pueden hacer que una operación sea rechazada, se quede sin gas o reserve más fondos de lo previsto.¿Puede una operación fallida interrumpir un lote?
Un fallo de validación puede hacer que se excluya una operación o provocar la reversión del envío del lote, según cuándo se detecte el problema y qué función de EntryPoint se utilice.Por eso los bundlers simulan repetidamente las operaciones antes de enviar el lote.Una vez superada la validación, la ejecución de la aplicación puede revertirse igualmente.Normalmente, una reversión de ejecución se registra como una UserOperation fallida, aunque el gas sigue siendo pagadero.Los bundlers deben construir los lotes con cuidado para que un cambio de estado no invalide inesperadamente una operación posterior.Las aplicaciones deberían consultar los recibos de UserOperations y los eventos de éxito, en lugar de suponer que la inclusión en un lote significa que la llamada solicitada se ha completado.Eventos de EntryPoint
EntryPoint emite eventos que permiten observar la actividad de las UserOperations.Un evento de UserOperation puede identificar el hash de la operación, el emisor, el paymaster, el nonce, el estado de éxito, el coste real del gas y el gas utilizado.Los eventos de despliegue de cuentas pueden identificar las smart accounts recién creadas y sus factories.Los eventos de depósito y retirada registran los cambios en los saldos de gas prefinanciados.Los eventos de stake registran la actividad de staking, desbloqueo y retirada.Las versiones más recientes pueden añadir eventos para comportamientos específicos de la versión, como los datos de despliegue ignorados o la inicialización EIP-7702.Los indexadores deben utilizar las definiciones de eventos correspondientes a la versión exacta de EntryPoint que estén siguiendo.EntryPoint y EIP-7702
EIP-7702 permite que una cuenta de propiedad externa autorice la delegación a código de contrato inteligente.Las versiones actuales de ERC-4337 pueden utilizar esta delegación para ofrecer funciones de abstracción de cuentas a una dirección existente.La especificación oficial EIP-7702 define el mecanismo de autorización a nivel de transacción.
Un bundler ERC-4337 puede incluir los datos de autorización necesarios al enviar un lote de UserOperations compatible.EntryPoint incluye el destino de delegación en la lógica de hash e inicialización pertinente.EIP-7702 no elimina la necesidad de proteger la implementación de cuenta delegada, el proceso de autorización y la integración con EntryPoint.Intervalos de validez en EntryPoint v0.9
Las smart accounts y los paymasters pueden limitar una UserOperation a un periodo de validez.En el comportamiento anterior de EntryPoint, estos límites se expresaban mediante marcas de tiempo.La versión 0.9 también admite intervalos de validez interpretados como números de bloque cuando se utiliza el indicador de codificación especificado.Esto puede ayudar a las aplicaciones cuyos permisos o acciones ya se definen en función de las alturas de bloque.Los bundlers deben entender la codificación y evitar incluir operaciones que aún no sean válidas o que probablemente caduquen antes de su inclusión.Despliegue determinista de EntryPoint
Los despliegues oficiales de EntryPoint utilizan técnicas deterministas de creación de contratos para que una misma versión pueda tener la misma dirección en redes compatibles admitidas.Esto puede simplificar la configuración de wallets y bundlers.La documentación del contrato EntryPoint explica que el repositorio oficial utiliza una sal fija de despliegue para despliegues locales y compatibles.
Que una dirección coincida no basta para demostrar su autenticidad, ya que otra red puede tener un código o historial de despliegue distintos.Los desarrolladores deberían verificar el bytecode y el hash del código en cada red compatible.EntryPoint frente a smart account
EntryPoint es una infraestructura compartida que utilizan muchas smart accounts.Una smart account es el contrato específico del usuario que guarda los activos y define las reglas de autorización.Normalmente, EntryPoint no guarda los saldos de tokens del usuario ni sustituye la dirección de la smart account.La smart account decide si una UserOperation está autorizada.EntryPoint aplica el marco común de procesamiento, nonce, despliegue, gas y liquidación.Una vulnerabilidad en una smart account puede afectar a esa cuenta aunque EntryPoint funcione correctamente.Una vulnerabilidad en una versión de EntryPoint ampliamente utilizada podría afectar a muchas cuentas y paymasters que confían en ella.EntryPoint frente a bundler
EntryPoint es un contrato on-chain.Un bundler es un participante off-chain que recibe UserOperations y envía una transacción a EntryPoint.El bundler realiza simulaciones y paga la comisión inicial de transacción de la red.EntryPoint lleva a cabo la validación y la liquidación on-chain con autoridad.Un bundler no puede hacer válida una firma inválida de una smart account.Sin embargo, un bundler puede retrasar o negarse a incluir una operación, por lo que las wallets pueden beneficiarse de tener acceso a más de una vía de envío compatible.EntryPoint frente a paymaster
EntryPoint procesa las operaciones y liquida sus costes de gas.Un paymaster acepta opcionalmente pagar esos costes para determinados usuarios o acciones.El paymaster define sus propias reglas de patrocinio dentro de las restricciones de validación de ERC-4337.Debe mantener un depósito suficiente y puede necesitar un stake.EntryPoint no obliga a un paymaster a patrocinar todas las operaciones válidas.Una interrupción del paymaster o el rechazo de una política pueden detener un flujo patrocinado aunque la smart account sea válida.EntryPoint frente a account factory
Una account factory despliega contratos de smart account.Cuando un emisor aún no desplegado incluye datos de creación válidos, EntryPoint llama a la factory mediante su mecanismo SenderCreator.La factory debe generar la dirección de cuenta esperada.También debe restringir las rutas de creación sensibles conforme a los requisitos de seguridad de ERC-4337.EntryPoint no decide la implementación, los titulares, los módulos ni las reglas de recuperación de la smart account.La factory y los datos de inicialización establecen esas propiedades.Ventajas del modelo EntryPoint
EntryPoint proporciona a los bundlers una interfaz compartida para muchos diseños de smart accounts.Permite que las cuentas definan autorizaciones programables en lugar de depender de un único modelo de firma fijo.Admite el despliegue contrafactual de cuentas como parte de la primera UserOperation.Permite a los paymasters patrocinar gas conforme a políticas programables.Permite agrupar varias acciones de usuario en una transacción subyacente.Separa la autorización del usuario de la cuenta que paga la comisión de transacción de la red.Puede desplegarse en redes compatibles sin exigir cambios en la capa de consenso.Limitaciones del modelo EntryPoint
EntryPoint introduce contratos, métodos RPC, simulaciones, campos de gas y roles de infraestructura adicionales.Una wallet debe coordinarse con un bundler compatible y, posiblemente, con un paymaster.Las distintas versiones de EntryPoint pueden fragmentar la liquidez, las herramientas y el soporte de mempool.La validación programable genera riesgos de denegación de servicio que requieren reglas off-chain estrictas.La estimación del gas es más compleja que la de una transacción básica de cuenta.Una operación patrocinada puede fallar si el paymaster no está disponible o rechaza la solicitud.La abstracción de cuentas mejora la flexibilidad de las wallets, pero no elimina el phishing, las aplicaciones maliciosas, las aprobaciones inseguras ni los errores de contratos inteligentes.Riesgos de seguridad de EntryPoint
EntryPoint es una dependencia compartida de gran valor porque las smart accounts y los paymasters le conceden autoridad especial.Un fallo en la validación, el cálculo del gas, los depósitos, el staking, la creación de cuentas o la ejecución podría tener efectos amplios.Los desarrolladores deberían utilizar despliegues oficiales auditados, en lugar de modificar a la ligera el contrato principal.Las wallets deben verificar la versión y la dirección de EntryPoint de confianza.Los bundlers deben aplicar de forma coherente las reglas de validación y reputación.Las cuentas y los paymasters deben verificar que las llamadas sensibles proceden del EntryPoint de confianza.Las factories deben verificar que las llamadas proceden del contrato SenderCreator correcto.Riesgos de firma y autorización
La abstracción de cuentas admite firmas flexibles, pero esa flexibilidad no garantiza una autorización segura.Un verificador de claves de acceso débil, un umbral multifirma incorrecto, una clave de sesión expuesta o un módulo de recuperación defectuoso pueden autorizar UserOperations no deseadas.La cuenta debe vincular la autorización al hash de operación, el ID de la cadena, EntryPoint, el nonce, el intervalo de validez y las llamadas previstas correctos.Las interfaces de wallet deberían mostrar claramente las llamadas incluidas en un lote antes de solicitar la aprobación.Una firma válida de una smart account puede autorizar varias acciones a la vez, incluidas aprobaciones y transferencias de tokens.Riesgos de los paymasters
Un paymaster puede aplicar reglas de patrocinio restrictivas o centralizadas.Puede dejar de patrocinar la actividad si su depósito es bajo, su servicio no está disponible o cambia su política.Un paymaster defectuoso puede perder su depósito debido a errores de validación o contabilidad.Un usuario malicioso puede intentar consumir los recursos del paymaster sin completar acciones útiles.Si se compromete el firmante de un paymaster, este puede aprobar operaciones fuera de la política prevista.Los usuarios no deberían suponer que el patrocinio del gas significa que una operación sea segura o esté libre de otros cargos.Riesgos de los bundlers
Un bundler puede censurar, retrasar, fijar precios incorrectos o descartar una UserOperation.También puede proporcionar estimaciones de gas inexactas o información de estado obsoleta.La validación on-chain protege la smart account, pero la experiencia de usuario puede fallar si el bundler seleccionado no es fiable.Las wallets deberían gestionar los tiempos de espera, la sustitución de operaciones, los cambios de comisiones y el envío a bundlers alternativos cuando sea posible.Los usuarios deberían verificar los recibos on-chain finales, en lugar de confiar únicamente en la respuesta pendiente del bundler.Riesgos de la estimación del gas
Una UserOperation separa varios límites de gas para la validación, la ejecución, las tareas del paymaster y la sobrecarga del bundler.Un límite demasiado bajo puede provocar fallos de validación o ejecución.Un límite innecesariamente alto puede requerir una prefinanciación mayor, aunque la liquidación final debería utilizar el coste real conforme a las reglas del protocolo.Los costes de datos específicos de la red pueden afectar a
preVerificationGas
.Los costes de autorización de EIP-7702 también pueden requerir cálculos adicionales que EntryPoint no puede observar directamente.Las wallets deberían utilizar un servicio RPC compatible con la red y la versión de EntryPoint seleccionadas.Reentrancia y llamadas externas
EntryPoint llama a smart accounts, factories, paymasters, agregadores de firmas y contratos de aplicaciones.Estas llamadas externas pueden ejecutar código arbitrario de contrato.Las implementaciones deben suponer que el código externo puede revertir, consumir gas o intentar una reentrancia.Las smart accounts y los módulos deberían proteger sus propios estados críticos durante la ejecución iniciada por EntryPoint.La lógica posterior a la operación de un paymaster no debería suponer que la acción solicitada por la cuenta se haya completado correctamente.Las extensiones personalizadas de abstracción de cuentas requieren un análisis de seguridad independiente, aunque utilicen un EntryPoint auditado.Cómo deberían integrar EntryPoint los desarrolladores
El primer paso es elegir una versión de EntryPoint compatible y verificar su despliegue oficial en cada red.El segundo es hacer que la smart account solo confíe en direcciones de EntryPoint aprobadas.El tercero es implementar
validateUserOp
con una gestión correcta de firmas, nonces, validez y fondos.El cuarto es utilizar las reglas correctas de empaquetado y hash de UserOperations.El quinto es probar los flujos de cuentas aún no desplegadas y ya desplegadas.El sexto es integrar un bundler compatible con la versión de EntryPoint seleccionada.El séptimo es probar la simulación de operaciones, su sustitución, los recibos de fallo y la estimación del gas.El octavo es revisar los permisos del paymaster, la factory, los módulos, las actualizaciones y la recuperación.El noveno es probar contratos maliciosos de validación y ejecución.El décimo es seguir las versiones oficiales, las auditorías y las directrices de migración.Cómo interactúan los usuarios con EntryPoint
La mayoría de los usuarios no llama manualmente a EntryPoint.Una wallet de smart account crea y envía la UserOperation en segundo plano.El usuario puede ver un hash de operación de abstracción de cuentas antes de que se cree la transacción blockchain subyacente.Tras la inclusión, un explorador de bloques puede mostrar una transacción que llama a
handleOps
en EntryPoint.Esa única transacción puede contener operaciones de varias smart accounts no relacionadas.El usuario debería comprobar el resultado de cada UserOperation, en lugar de suponer que todas las acciones del lote tuvieron el mismo resultado.Ejemplo de una transacción de EntryPoint
Supongamos que Alice utiliza una smart account y quiere aprobar un token y depositarlo en una bóveda cripto en una sola acción.Su wallet crea una UserOperation que contiene ambas llamadas.La lógica de autorización de la cuenta aprueba la operación mediante el método de autenticación configurado por Alice.Un paymaster acepta patrocinar el gas de red conforme a su política.La wallet envía la operación a un bundler compatible.El bundler simula la validación de la cuenta y del paymaster.A continuación, incluye la operación de Alice junto con otras UserOperations en una llamada a la función
handleOps
de EntryPoint.EntryPoint confirma el nonce, la autorización de la cuenta, la aprobación del paymaster y la disponibilidad del depósito de gas.La smart account ejecuta la aprobación del token y el depósito en la bóveda.EntryPoint carga el coste real del gas al depósito del paymaster y paga al beneficiario del bundler.Si la llamada a la bóveda revierte, la operación de Alice puede registrarse como fallida, aunque el gas consumido siga siendo pagadero.Errores frecuentes con EntryPoint
Un error frecuente es confundir EntryPoint con la smart account del usuario.Otro es enviar una UserOperation a un bundler compatible con otra versión de EntryPoint.Un tercer error es confiar en una dirección de EntryPoint sin verificar el código desplegado.Un cuarto es suponer que la inclusión en un lote demuestra que la llamada de la aplicación se ha completado correctamente.Un quinto es confundir un depósito de gas con el stake de un paymaster.Un sexto es no incluir el ID de la cadena y la dirección de EntryPoint en la lógica de autorización.Un séptimo es tratar una simulación correcta como garantía de que la ejecución tendrá éxito.Un octavo es permitir que las funciones sensibles de la cuenta acepten llamadas de cualquier contrato que afirme ser EntryPoint.Un noveno es suponer que una transacción patrocinada no puede cobrar tokens ni aplicar otra comisión.Un décimo es actualizar a un EntryPoint nuevo sin revisar el comportamiento específico de la versión y los informes de seguridad.Preguntas frecuentes
¿Qué es EntryPoint en ERC-4337?
EntryPoint es el contrato inteligente central que valida, ejecuta y liquida UserOperations para las wallets de abstracción de cuentas compatibles.¿EntryPoint es una wallet?
No. Es una infraestructura compartida que utilizan las wallets de smart accounts, los bundlers, las factories y los paymasters.¿EntryPoint es una criptomoneda?
No. EntryPoint es software de contrato inteligente y no necesita un token propio.¿Cuál es la versión más reciente de EntryPoint?
A 16 de julio de 2026, el repositorio oficial de abstracción de cuentas indica EntryPoint v0.9.0 como su versión más reciente.¿Cuál es la dirección de EntryPoint v0.9?
La versión oficial v0.9 indica
0x433709009B8330FDa32311DF1C2AFA402eD8D009
, pero los desarrolladores deben verificar la red, el código y la información oficial de seguridad antes de utilizarla.¿Pueden coexistir varias versiones de EntryPoint?
Sí. Las versiones antiguas y nuevas pueden coexistir mientras las wallets, los bundlers y los paymasters migran.¿Qué es una UserOperation?
Una UserOperation es una solicitud estructurada de abstracción de cuentas que contiene el emisor, el nonce, las llamadas, los ajustes de gas, la autorización y los datos opcionales de despliegue o patrocinio.¿Una UserOperation es una transacción de Ethereum?
No. Un bundler empaqueta una o varias UserOperations en una transacción blockchain ordinaria que envía a EntryPoint.¿Qué hace handleOps?
Valida y ejecuta un lote de UserOperations y paga al beneficiario seleccionado con los costes de gas recaudados.¿Quién llama a EntryPoint?
Normalmente, un bundler llama a EntryPoint al enviar on-chain un lote de UserOperations.¿Quién autoriza una UserOperation?
La smart account la autoriza mediante su propia lógica
validateUserOp
.¿Puede un bundler gastar fondos sin la aprobación de la cuenta?
Una smart account correctamente implementada rechaza las operaciones que no cumplen sus reglas de autorización.¿Qué es un depósito de EntryPoint?
Es moneda nativa prefinanciada en EntryPoint para pagar futuros costes de gas de UserOperations.¿Qué es un stake de EntryPoint?
Es moneda nativa bloqueada que utilizan determinadas entidades, en especial los paymasters, como parte de las protecciones contra ataques de denegación de servicio y para preservar la reputación.¿El depósito y el stake de un paymaster son lo mismo?
No. El depósito paga el gas, mientras que el stake queda bloqueado por separado y está sujeto a un plazo de desbloqueo.¿Qué es un paymaster?
Un paymaster es un contrato que acepta pagar el coste del gas de determinadas UserOperations.¿Un paymaster hace que todas las operaciones sean gratuitas?
No. Puede rechazar operaciones, aplicar criterios de elegibilidad o utilizar otro método para recuperar sus costes.¿Qué es la simulación de UserOperations?
Es el proceso off-chain que utilizan los bundlers para prever si una operación superará la validación de EntryPoint antes de enviarla.¿Una simulación correcta garantiza la ejecución?
No. La ejecución de la aplicación puede revertirse o el estado de la blockchain puede cambiar antes de la inclusión.¿Por qué se incluye la dirección de EntryPoint en el hash de la operación?
Ayuda a impedir que una autorización destinada a una versión de EntryPoint se repita mediante otro contrato.¿Por qué se incluye el ID de la cadena en el hash de la operación?
Ayuda a impedir que la misma operación firmada se repita automáticamente en otra red blockchain.¿Puede EntryPoint desplegar una smart account?
Puede coordinar el despliegue mediante los datos de creación de la cuenta y una factory cuando el emisor aún no exista.¿Qué es una smart account contrafactual?
Es una dirección de smart account calculada antes de desplegar el contrato de la cuenta.¿EntryPoint guarda los tokens de los usuarios?
Normalmente, los tokens están en la smart account del usuario, mientras que EntryPoint solo guarda depósitos y stakes relacionados con el procesamiento del gas.¿Una transacción de EntryPoint puede incluir a varios usuarios?
Sí. Un bundler puede incluir UserOperations de varias smart accounts no relacionadas en una transacción
handleOps
.¿Una UserOperation fallida puede consumir gas de todos modos?
Sí. La validación y una ejecución fallida consumen gas, y aun así se puede cobrar a la cuenta o al paymaster responsable.¿EntryPoint admite cuentas EIP-7702?
Las versiones actuales de EntryPoint admiten flujos compatibles de autorización EIP-7702 y de cuentas delegadas.¿Qué cambió en EntryPoint v0.9?
Entre los cambios principales figuran las firmas de paymaster en paralelo, los intervalos de validez por número de bloque, la gestión actualizada de los datos de despliegue, las consultas del hash de UserOperation actual y mejoras adicionales de observabilidad.¿Debería un proyecto desplegar su propio EntryPoint?
Las wallets de producción suelen utilizar un despliegue canónico revisado, mientras que los despliegues locales personalizados se utilizan principalmente para pruebas y desarrollo.¿Es seguro EntryPoint?
El contrato oficial se revisa exhaustivamente, pero la seguridad sigue dependiendo del despliegue y la versión exactos, así como de la smart account, el bundler, el paymaster, la factory, los módulos y el código de integración.Conclusión
EntryPoint es la puerta de entrada on-chain central de la abstracción de cuentas ERC-4337.Recibe UserOperations agrupadas, coordina la validación de smart accounts, despliega cuentas cuando es necesario, comprueba la financiación del gas, ejecuta las llamadas aprobadas y liquida las comisiones.Los bundlers envían operaciones a EntryPoint, mientras que las smart accounts conservan el control de sus propias reglas de autorización.Los paymasters pueden patrocinar gas mediante depósitos y la aceptación de operaciones conforme a políticas de validación programables.EntryPoint también gestiona canales de nonce, depósitos, stakes, eventos de operaciones y otras funciones compartidas de abstracción de cuentas.A 16 de julio de 2026, v0.9.0 es la versión más reciente que figura en el repositorio oficial de abstracción de cuentas.La compatibilidad entre versiones sigue exigiendo que todas las wallets, los bundlers, los paymasters, las factories y las implementaciones de cuentas utilicen el mismo despliegue de EntryPoint seleccionado.Los desarrolladores deben verificar la dirección y el bytecode, proteger las comprobaciones de llamadas de confianza, seguir las reglas exactas de hash, simular las operaciones y revisar todos los contratos conectados.Los usuarios deberían entender que el patrocinio del gas y las wallets programables mejoran la facilidad de uso, pero no eliminan el phishing, los fallos de ejecución, los riesgos de aprobación ni las vulnerabilidades de los contratos inteligentes.Comprender EntryPoint ayuda a los usuarios cripto a distinguir el contrato de procesamiento compartido de ERC-4337 de la smart account, el bundler, el paymaster y las acciones de las aplicaciones que lo rodean.También te puede interesar
ZK-Rollup
¿Qué es un ZK-Rollup? Un ZK-Rollup, también escrito como zkRollup o zero-knowledge rollup, es una solución de escalabilidad blockchain de capa 2 (Layer 2) que procesa numerosas transacciones off-chain
2026/10/13 17:17
ZK-Rollup-as-a-Service
¿Qué es ZK-Rollup-as-a-Service? ZK-Rollup-as-a-Service, a menudo abreviado como ZK-RaaS, es un modelo de infraestructura blockchain gestionada que ayuda a los proyectos cripto a lanzar y operar su pro
2026/10/13 17:17
zk-SNARK
¿Qué es un zk-SNARK? Un zk-SNARK es un sistema de pruebas criptográficas que permite a una parte demostrar que una afirmación es verdadera sin revelar la información privada que hay detrás de ella. El
2026/10/13 17:17
POPULAR
Criptomonedas de moda que están acaparando la atención del mercado
Volumen TOP
Las criptomonedas con mayor volumen de trading
Recién Añadidos
Criptomonedas recientemente listadas y disponibles para operar