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
| Palabra | Qué significa |
|---|---|
| UserOperation | una petición firmada de lo que debe hacer una cuenta inteligente |
| Bundler | un servidor que envía UserOperations a la cadena |
| EntryPoint | el único contrato que comprueba y ejecuta UserOperations |
| Validación | la fase en la que la cuenta dice sí o no |
| Ejecución | la fase en la que la cuenta hace su llamada |
| Depósito | ETH 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
- El usuario firma una UserOperation para su cuenta inteligente.
- Un bundler reúne UserOperations y las envía al EntryPoint en una transacción normal, llamando a handleOps.
- El EntryPoint pide a cada cuenta que valide su operación.
- 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
docker exec chain ./steps/userop.shSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Ejemplo: lo que imprimió el laboratorio
| Paso | Lo que imprimió el laboratorio |
|---|---|
| Cuenta antes (count before) | 0 |
| Nonce en el EntryPoint | 0 |
| Hash que firmó Alex | 0x8806a321... (64 cifras hexadecimales) |
| Transacción handleOps | gas usado 133003 |
| UserOperationEvent | success 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
docker exec chain ./steps/refused.shSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Tres intentos, tres respuestas
| Intento | Lo que imprimió el bundler |
|---|---|
| Firmada por Mallory, no por Alex | simulation failed, not sent: AA24 signature error |
| Firmada por Alex | sent handleOps, success true |
| La misma operación otra vez | simulation 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
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
docker exec chain grep -n "AA[0-9]" src/EntryPoint.solSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.