Lab d’abstraction de compte : comptes intelligents, ERC-4337, paymasters et EIP-7702 sur une chaîne locale
Ce lab donne à chaque étudiant sa propre chaîne de test locale, anvil de Foundry, avec un compte intelligent, un EntryPoint, un paymaster, un compteur à appeler et deux délégués EIP-7702 déjà déployés. Huit courts scripts montrent chacun une idée : un compte ordinaire à côté d’un compte intelligent, une UserOperation portée par un bundler, ce que refuse la validation, un paymaster qui paie pour un compte vide, une clé de session avec une limite de dépense, une délégation mise en place puis annulée, une délégation signée qui vide un compte, et le même paiement fait de trois façons. Chaque script remet la chaîne dans son état de départ : il affiche donc toujours la même chose.
Rien ici n’est de l’argent. La chaîne ne tourne que dans la copie de l’étudiant, les clés sont les clés de test publiques qu’affiche chaque guide de Foundry, et chaque copie n’a aucun accès à internet, à aucune chaîne publique ni à aucun autre étudiant. Il n’y est jamais question de cours d’une monnaie ni de spéculation.
Ce que les étudiants apprennent
Pourquoi une seule clé privée est fragile : une clé perdue bloque un compte ordinaire, une clé qui fuit le vide, et il doit payer son propre gas. Comment fonctionne ERC-4337 : un utilisateur signe une UserOperation, un bundler l’envoie à l’EntryPoint, qui valide toutes les opérations puis les exécute ; dans le lab, une opération fait passer un compteur de 0 à 1 pour un gas de 114672, et une mauvaise signature puis un nonce rejoué sont refusés avec AA24 et AA25. Comment un paymaster paie pour un compte sans ETH et refuse les inconnus et les opérations trop coûteuses, comment une clé de session paie deux fois une boutique puis est refusée à sa limite, et comment une délégation EIP-7702 donne du code à un compte ordinaire, affiché comme 0xef0100 suivi d’une adresse. Il convient aux cours de blockchain, de sécurité et de génie logiciel ; vérifiez la formulation exacte dans l’unité de votre propre organisme certificateur, aucune n’est citée ici.
Le lancer dans votre navigateur
Le lab démarre un seul service, chain, qui écrit les contrats, leur code compilé, aa.sh et les scripts dans son dossier personnel, lance anvil et déploie, sans rien télécharger. Il n’y a pas de page web : le terminal est le lab. Il n’a pas de cast à lui : il atteint le lab avec docker exec chain, suivi de la commande à lancer à l’intérieur.
- Ouvrir la page Conteneur. Ouvrez « Créer » dans la barre et choisissez « Lancer un conteneur ». Tout le monde peut ouvrir la page, et le lab Git et le lab SQL se lancent sans compte. Tous les autres labs demandent un compte gratuit : créez-en un, connectez-vous, puis appuyez sur « Démarrer ».
- Trouver le lab. La carte « Laboratoires d’exemple » liste tous les exemples. Trouvez Comptes intelligents : ERC-4337, paymasters et EIP-7702.
- Appuyer sur Démarrer. « Démarrer » le lance tel quel, en un clic. « Modifier le fichier d’abord » ouvre le fichier compose pour que vous puissiez le changer avant de démarrer.
- L’ouvrir. Sur la page du lab, appuyez sur « Ouvrir le terminal » et tapez docker exec chain ./steps/userop.sh pour voir une UserOperation signée, envoyée par le bundler et exécutée par l’EntryPoint. Les contrats sont dans src : docker exec chain cat src/SmartAccount.sol affiche le compte intelligent à lire. Les scripts écrivent en anglais.
Que demander aux étudiants de rendre
Quelques lignes sur un script qu’ils ont modifié et lancé, par exemple une clé de session avec une autre limite ou un paymaster avec un plafond plus bas, avec ce qu’il a affiché et une phrase ou deux, avec leurs propres mots, sur ce qu’ils ont appris. Rien n’est noté automatiquement : la phrase montre si c’était compris. Pour un travail plus poussé, demandez ce qu’un portefeuille aurait dû montrer avant la signature dans le script d’hameçonnage.
Une leçon de base sur ce lab
Smart Account Basics est une petite leçon qui se fait dans ce lab. L’étudiant y compare un compte ordinaire et un compte intelligent, envoie une UserOperation par le bundler, fait payer un compte vide par un paymaster, dépense avec une clé de session jusqu’à sa limite, et délègue un compte ordinaire avec EIP-7702.
Un compte personnel gratuit la reçoit dans le module Basics, qui se trouve sur « Accueil », et chaque établissement peut la copier depuis le dossier Basics de la Bibliothèque. Elle est volontairement petite : elle montre à un enseignant ce qu’est une leçon qui se fait dans un lab, et le lab fait le reste. Copiez-la dans un module à vous pour la modifier. Le module universitaire Comptes intelligents : l’abstraction de compte sur une chaîne locale se travaille dans le même lab.
Le code sur GitHub
Le fichier compose n’a pas de Dockerfile : il lance une seule image publique, celle de Foundry, figée sur une étiquette de version, avec son propre compte sans privilèges et 256 Mo de mémoire. L’image est sous licence MIT ou Apache-2.0 et n’est pas distribuée par nous. Le fichier écrit chaque contrat et chaque script à partir d’un texte fixe au démarrage. Le lab n’a pas de compilateur et ne télécharge rien : les contrats arrivent donc compilés par nous, à côté de leur source. Les limites sont honnêtes : l’EntryPoint est un modèle d’enseignement simplifié, qui a la forme du vrai mais aucune de ses protections, et le bundler est une fonction shell qui simule un lot puis l’envoie. EIP-7702 est réel, sur les règles Prague d’anvil. Rien n’est conservé quand le lab s’arrête.
En faire un travail
Indiquez dans la tâche ce qu’il faut rendre.
- Créer le lab. Dans votre module, ajoutez une tâche et choisissez la carte « Lab de conteneurs », puis « Dans un dépôt GitHub ». Indiquez https://github.com/mitsurutech/lab-aa-lab avec la branche main. Le fichier compose par défaut est compose.yaml. Faites d’abord un fork du dépôt si vous voulez le modifier, par exemple pour donner au paymaster un autre plafond ou à la clé de session une autre limite.
- Publier et l’essayer. « Publier » fige le commit qui vous a été montré : un changement ultérieur dans le dépôt ne modifie donc pas un lab que vous avez déjà proposé. Démarrez d’abord votre propre copie.
- Le distribuer. Attribuez-le comme n’importe quelle tâche, avec une échéance si vous le souhaitez, et indiquez dans la tâche ce qu’il faut faire et ce qu’il faut rendre.
- Noter ce qui est rendu. Ouvrez la copie d’un étudiant et le travail rendu, notez-le et renvoyez-le avec un motif s’il demande un complément.
Essayer ce lab, et ce qu’il coûte
Un compte personnel gratuit permet de suivre les leçons de base de ce lab, avec chaque mois assez de crédit gratuit pour suivre la plupart des leçons, sans carte. Pour une classe, un établissement a ses 365 premiers jours gratuits pour 50 élèves au plus, puis paie par élève et par an, tous les labs compris et les enseignants gratuits.
Questions fréquentes
- Est-ce que tout cela est de l’argent réel ?
- Non. La chaîne est anvil, une chaîne de test locale dans la copie de l’étudiant, et les clés sont les clés de test bien connues. Le lab ne peut atteindre ni internet ni aucune chaîne publique. N’utilisez jamais ces clés ailleurs.
- Pourquoi le terminal utilise-t-il docker exec chain ?
- Le terminal du lab contient quelques clients, mais pas cast. docker exec chain lance une commande dans le conteneur du lab, qui a anvil et cast.
- Est-ce le vrai EntryPoint et un vrai bundler ?
- Non. Le vrai EntryPoint, en version 0.7 ou 0.8, et un vrai bundler demandent des outils que le lab ne contient pas. L’EntryPoint du lab garde la même forme, la validation puis l’exécution puis le remboursement du bundler, et les mêmes codes d’erreur, et le bundler est une fonction shell dans aa.sh. Utilisez l’EntryPoint audité pour tout usage réel.
- Pourquoi chaque script affiche-t-il toujours la même chose ?
- Chaque script remet d’abord la chaîne dans l’instantané enregistré au déploiement des contrats, et chaque clé et chaque prix du gas sont fixes. Les scripts peuvent donc tourner dans n’importe quel ordre et afficher ce que disent les leçons.