¿Te resulta más fácil leer con fondo crema, un tono de color, más contraste o un texto más grande? Elige tus colores y tu texto una sola vez, para todas las páginas.

Lección gratuita

Cómo funciona ERC-4337: UserOperations y bundlers

Después de esta lección: Puedo seguir una UserOperation desde la firma hasta el evento del EntryPoint.

Lección de 70 min3 comandosLaboratorio de abstracción de cuentas: cuentas inteligentes, ERC-4337, paymasters y EIP-7702 en una cadena local

Una transacción que tu cuenta comprueba

ERC-4337 es el estándar que da cuentas inteligentes a Ethereum sin cambiar las reglas de la propia cadena. En lugar de una transacción, firmas una UserOperation, y un bundler la lleva a un contrato llamado EntryPoint.

Así funcionan la mayoría de las cuentas inteligentes nuevas, de modo que si conoces el flujo puedes leer cualquiera.

Al terminar esta lección

Nota

Puedo seguir una UserOperation desde la firma hasta el evento del EntryPoint.

Palabras clave

PalabraQué significa
UserOperationuna petición firmada de lo que debe hacer una cuenta inteligente
Bundlerun servidor que envía UserOperations a la cadena
EntryPointel único contrato que comprueba y ejecuta UserOperations
Validaciónla fase en la que la cuenta dice sí o no
Ejecuciónla fase en la que la cuenta hace su llamada
DepósitoETH que guarda el EntryPoint para pagar el gas

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Quién hace qué en ERC-4337

  1. El usuario firma una UserOperation para su cuenta inteligente.
  2. Un bundler reúne UserOperations y las envía al EntryPoint en una transacción normal, llamando a handleOps.
  3. El EntryPoint pide a cada cuenta que valide su operación.
  4. Después ejecuta todas las operaciones y devuelve al bundler lo que pagó, con el depósito de la cuenta.

El bundler paga antes el gas de la transacción, así que quiere recuperarlo.

Qué lleva una UserOperation

Una UserOperation nombra al remitente, su cuenta inteligente. Lleva un nonce, el callData que se ejecuta y tres límites de gas. También lleva lo máximo que pagará por unidad de gas, un paymaster opcional y una firma.

La cuenta firma un hash de todos los campos menos la firma. El hash cubre además la dirección del EntryPoint y el id de la cadena, así que no se puede repetir en otro sitio.

Envía una UserOperation por el bundler

Comando
docker exec chain ./steps/userop.sh

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Ejemplo: lo que imprimió el laboratorio

PasoLo que imprimió el laboratorio
Cuenta antes (count before)0
Nonce en el EntryPoint0
Hash que firmó Alex0x8806a321... (64 cifras hexadecimales)
Transacción handleOpsgas usado 133003
UserOperationEventsuccess true, gas 114672, coste 0.000114672 ETH
Cuenta después (count after)1

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Primero validación, después ejecución

El EntryPoint valida todas las operaciones de un lote antes de ejecutar ninguna. La validación comprueba el nonce, pide a la cuenta que compruebe la firma y toma lo máximo que podría costar la operación.

Si una operación falla la validación, se revierte el lote entero y el bundler paga por nada útil. Por eso un bundler simula antes el lote y descarta cualquier operación que fuera a fallar.

Mira lo que rechaza la validación

Comando
docker exec chain ./steps/refused.sh

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Tres intentos, tres respuestas

IntentoLo que imprimió el bundler
Firmada por Mallory, no por Alexsimulation failed, not sent: AA24 signature error
Firmada por Alexsent handleOps, success true
La misma operación otra vezsimulation failed, not sent: AA25 invalid account nonce

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Un error frecuente

Advertencia

Mucha gente cree que un bundler puede cambiar lo que pidió el usuario. No puede. La firma cubre todos los campos, así que cualquier cambio hace fallar la validación con AA24, y la cuenta nunca actúa.

Devolverle el gas al bundler

Antes de la ejecución, el EntryPoint toma lo máximo que podría costar la operación: todos los límites de gas sumados, por la tarifa más alta. Después de ejecutar cobra lo que se usó de verdad y deja el resto en el depósito de la cuenta.

preVerificationGas paga al bundler el trabajo que el EntryPoint no puede medir. Si es demasiado bajo, el bundler pierde: en el laboratorio acabó 0.000018331 ETH abajo.

Pruébalo: lo máximo que podría costar

Código: python
GWEI = 10 ** 9
call_gas = 100000
verify_gas = 100000
pre_gas = 21000
max_fee = 1 * GWEI

most = (call_gas + verify_gas + pre_gas) * max_fee
used = 114672 * GWEI
print("se toma primero:", most, "wei")
print("usado de verdad:", used, "wei")
print("queda en el depósito:", most - used, "wei")
# Cambia call_gas a 50000. ¿Cuánto se toma primero ahora?

El EntryPoint del laboratorio es un modelo didáctico

El EntryPoint real, versión 0.7 o 0.8, empaqueta sus campos de gas y permite varias secuencias de nonce. Además puede volver a llamar a un paymaster tras la ejecución. Sus reglas de validación, ERC-7562, frenan una operación que pasa la simulación y falla en la cadena.

El laboratorio conserva la forma y deja eso fuera. Su bundler es una función de shell que simula y luego envía. Lee sus códigos de error.

Lista los códigos de error del EntryPoint

Comando
docker exec chain grep -n "AA[0-9]" src/EntryPoint.sol

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Sobre este laboratorio y su código: Laboratorio de abstracción de cuentas: cuentas inteligentes, ERC-4337, paymasters y EIP-7702 en una cadena local

¿Enseñas a una clase? Asigna este módulo a tus alumnos con guía del profesor, tareas con corrección automática y un laboratorio para cada alumno.