Laboratorio de abstracción de cuentas: cuentas inteligentes, ERC-4337, paymasters y EIP-7702 en una cadena local
Este laboratorio da a cada alumno una cadena de pruebas local y propia, anvil de Foundry, con una cuenta inteligente, un EntryPoint, un paymaster, un contador al que llamar y dos delegados EIP-7702 ya desplegados. Ocho scripts cortos muestran una idea cada uno: una cuenta normal junto a una cuenta inteligente, una UserOperation llevada por un bundler, lo que rechaza la validación, un paymaster que paga por una cuenta vacía, una clave de sesión con límite de gasto, una delegación que se pone y se deshace, una delegación firmada que vacía una cuenta, y el mismo pago hecho de tres maneras. Cada script devuelve la cadena a como empezó, así que imprime siempre lo mismo, en inglés.
Aquí nada es dinero. La cadena solo funciona dentro de la copia del alumno, las claves son las claves de prueba públicas que imprime cualquier guía de Foundry, y ninguna copia tiene salida a internet, a ninguna cadena pública ni a ningún otro alumno. No aparecen precios de monedas ni compraventa en ninguna parte.
Qué aprenden los alumnos
Por qué una sola clave privada es frágil: perderla bloquea una cuenta normal, filtrarla la vacía, y además tiene que pagar su propio gas. Cómo funciona ERC-4337: un usuario firma una UserOperation, un bundler la envía al EntryPoint, que valida todas las operaciones y después las ejecuta; en el laboratorio una operación lleva un contador de 0 a 1 con gas 114672, y una firma mala y un nonce repetido se rechazan con AA24 y AA25. Cómo un paymaster paga por una cuenta sin ETH y rechaza a desconocidos y operaciones caras, cómo una clave de sesión paga dos veces a una tienda y se rechaza en su límite, y cómo una delegación EIP-7702 da código a una cuenta normal, que se ve como 0xef0100 y una dirección. Sirve para cursos de blockchain, seguridad e ingeniería del software; consulta en la unidad de tu propio organismo certificador la redacción exacta, aquí no se cita ninguna.
Ejecútalo en tu navegador
El laboratorio inicia un solo servicio, chain, que escribe los contratos, su código compilado, aa.sh y los scripts en su carpeta de inicio, arranca anvil y despliega, sin descargar nada. No hay página web: el terminal es el laboratorio. No tiene cast propio, así que llega al laboratorio con docker exec chain, seguido del comando que se ejecuta dentro.
- Abre la página Contenedor. Abre «Crear» en la barra y elige «Ejecutar un contenedor». Cualquiera puede abrir la página, y el laboratorio de Git y el de SQL se inician sin cuenta. Todos los demás laboratorios necesitan una cuenta gratuita: crea una, inicia sesión y pulsa «Iniciar».
- Busca el laboratorio. La tarjeta «Laboratorios de ejemplo» lista todos los ejemplos. Busca Smart accounts: ERC-4337, paymasters and EIP-7702.
- Pulsa «Iniciar». «Iniciar» lo ejecuta tal cual, con una sola pulsación. «Editar el archivo primero» abre el archivo compose para que lo cambies antes de iniciarlo.
- Ábrelo. En la página del laboratorio, pulsa «Abrir terminal» y escribe docker exec chain ./steps/userop.sh para ver una UserOperation firmada, enviada por el bundler y ejecutada por el EntryPoint. Los contratos están en src, así que docker exec chain cat src/SmartAccount.sol muestra la cuenta inteligente para leerla.
Qué pedir a los alumnos que entreguen
Unas líneas sobre un script que hayan cambiado y ejecutado, por ejemplo una clave de sesión con otro límite o un paymaster con un tope más bajo, con lo que imprimió y una o dos frases, con sus propias palabras, sobre lo que aprendieron. Nada se califica automáticamente: la frase muestra si se entendió. Para un trabajo más avanzado, pide que expliquen qué debería haber mostrado una cartera antes de la firma en el script de phishing.
Una lección básica sobre este laboratorio
Smart Account Basics es una lección pequeña que se hace en este laboratorio. En ella el alumno compara una cuenta normal con una cuenta inteligente, envía una UserOperation por el bundler, hace que un paymaster pague por una cuenta vacía, gasta con una clave de sesión hasta su límite y delega una cuenta normal con EIP-7702.
Las cuentas personales gratuitas la tienen en el módulo Basics, que está en Inicio, y cada centro puede copiarla de la carpeta Basics de la Biblioteca. Es pequeña a propósito: muestra a un docente lo que es una lección que se hace en un laboratorio, y el laboratorio hace el resto. Cópiala en un módulo tuyo para cambiarla. El módulo universitario Cuentas inteligentes: abstracción de cuentas en una cadena local se hace en el mismo laboratorio.
El código en GitHub
El archivo compose no tiene Dockerfile: ejecuta una sola imagen pública, la propia de Foundry, fijada a una etiqueta de versión, con su propia cuenta sin privilegios y 256 MB de memoria. La imagen tiene licencia MIT o Apache-2.0 y no la distribuimos nosotros. El archivo escribe cada contrato y cada script a partir de un texto fijo al arrancar. El laboratorio no tiene compilador ni descarga nada, así que los contratos llegan compilados por nosotros, junto a su código fuente. Los límites son honestos: el EntryPoint es un modelo didáctico simplificado con la forma del real y ninguna de sus protecciones, y el bundler es una función de shell que simula un lote y luego lo envía. EIP-7702 es real, con las reglas Prague de anvil. No se conserva nada cuando el laboratorio se detiene.
Ponlo como tarea
Indica en la tarea qué entregar.
- Crea el laboratorio. En tu módulo añade una tarea y elige la tarjeta «Laboratorio de contenedores», y después «En un repositorio de GitHub». Indica https://github.com/mitsurutech/lab-aa-lab con la rama main. El archivo compose es el predeterminado, compose.yaml. Haz un fork del repositorio antes si quieres modificarlo, por ejemplo para dar al paymaster otro tope o a la clave de sesión otro límite.
- Publica y pruébalo. «Publicar» fija el commit que te mostraron, así que un cambio posterior en el repositorio no altera un laboratorio que ya has asignado. Inicia primero tu propia copia.
- Asígnalo. Asígnalo como cualquier tarea, con una fecha de entrega si quieres, e indica en la tarea qué hacer y qué entregar.
- Califica lo entregado. Abre la copia de un alumno y el trabajo que ha entregado, califícalo y devuélvelo con un motivo si necesita más.
Prueba este laboratorio, y lo que cuesta
Con una cuenta personal gratuita puedes seguir las lecciones básicas de este laboratorio, con crédito gratuito suficiente cada mes para seguir la mayoría de las lecciones y sin tarjeta. Para una clase, un centro tiene gratis sus primeros 365 días, hasta 50 alumnos, y después paga por alumno y año, con todos los laboratorios incluidos y el profesorado gratis.
Preguntas frecuentes
- ¿Algo de esto es dinero real?
- No. La cadena es anvil, una cadena de pruebas local dentro de la copia del propio alumno, y las claves son las conocidas claves de prueba. El laboratorio no llega a internet ni a ninguna cadena pública. No uses nunca esas claves en ningún otro sitio.
- ¿Por qué el terminal usa docker exec chain?
- El terminal del laboratorio lleva algunos clientes, pero no cast. docker exec chain ejecuta un comando dentro del contenedor del laboratorio, que sí tiene anvil y cast.
- ¿Es el EntryPoint real y un bundler de verdad?
- No. El EntryPoint real, versión 0.7 o 0.8, y un bundler de verdad necesitan herramientas que el laboratorio no lleva. El EntryPoint del laboratorio conserva la misma forma, validación, luego ejecución y luego el pago al bundler, y los mismos códigos de error, y el bundler es una función de shell en aa.sh. Usa el EntryPoint auditado para cualquier cosa real.
- ¿Por qué cada script imprime siempre lo mismo?
- Cada script devuelve primero la cadena a la instantánea que se guardó al desplegar los contratos, y cada clave y cada precio del gas son fijos. Así los scripts se pueden ejecutar en cualquier orden e imprimen lo que dicen las lecciones.