Plus facile à lire avec un fond crème, une teinte, plus de contraste ou un texte plus grand ? Choisissez vos couleurs et votre texte, une fois pour toutes les pages.

Leçon gratuite

ERC-4337 : UserOperations et bundlers

Après cette leçon: Je peux suivre une UserOperation, de sa signature jusqu’à l’événement de l’EntryPoint.

Leçon de 70 min3 commandesLab d’abstraction de compte : comptes intelligents, ERC-4337, paymasters et EIP-7702 sur une chaîne locale

Une transaction que votre compte vérifie lui-même

ERC-4337 est la norme qui apporte les comptes intelligents à Ethereum sans changer les règles de la chaîne. Au lieu d’une transaction, vous signez une UserOperation, et un bundler la porte jusqu’à un contrat appelé l’EntryPoint.

La plupart des nouveaux comptes intelligents fonctionnent ainsi. Connaître ce parcours vous permet de lire n’importe lequel.

À la fin de cette leçon

Remarque

Je peux suivre une UserOperation, de sa signature jusqu’à l’événement de l’EntryPoint.

Mots-clés

MotCe que ça veut dire
UserOperationune demande signée de ce que doit faire un compte intelligent
Bundlerun serveur qui envoie les UserOperations à la chaîne
EntryPointle contrat unique qui vérifie et exécute les UserOperations
Validationla phase où le compte répond oui ou non
Exécutionla phase où le compte fait son appel
Dépôtl’ETH que garde l’EntryPoint pour payer le gas

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Qui fait quoi dans ERC-4337

  1. L’utilisateur signe une UserOperation pour son compte intelligent.
  2. Un bundler rassemble des UserOperations et les envoie à l’EntryPoint dans une transaction ordinaire, en appelant handleOps.
  3. L’EntryPoint demande à chaque compte de valider son opération.
  4. Il exécute ensuite chaque opération et rembourse le bundler sur le dépôt du compte.

Le bundler avance le gas de la transaction, donc il veut être remboursé.

Ce que contient une UserOperation

Une UserOperation nomme l’expéditeur, son compte intelligent. Elle contient un nonce, le callData à exécuter et trois limites de gas. Elle contient aussi le prix maximal par unité de gas, un paymaster facultatif et une signature.

Le compte signe un hachage de tous les champs sauf la signature. Ce hachage couvre aussi l’adresse de l’EntryPoint et l’identifiant de la chaîne : on ne peut donc pas le rejouer ailleurs.

Envoyer une UserOperation par le bundler

Commande
docker exec chain ./steps/userop.sh

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Exemple travaillé : ce que le labo a affiché

ÉtapeCe que le labo a affiché
Compteur avant0
Nonce dans l’EntryPoint0
Hachage signé par Alex0x8806a321... (64 chiffres hexadécimaux)
Transaction handleOpsgas utilisé 133003
UserOperationEventsuccess true, gas 114672, coût 0.000114672 ETH
Compteur après1

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

D’abord la validation, puis l’exécution

L’EntryPoint valide toutes les opérations d’un lot avant d’en exécuter une seule. La validation contrôle le nonce, demande au compte de vérifier la signature et prélève le coût maximal de l’opération.

Si une opération échoue à la validation, tout le lot est annulé et le bundler paie pour rien. Un bundler simule donc le lot d’abord et écarte toute opération qui échouerait.

Voir ce que refuse la validation

Commande
docker exec chain ./steps/refused.sh

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Trois essais, trois réponses

EssaiCe que le bundler a affiché
Signée par Mallory, pas par Alexsimulation failed, not sent: AA24 signature error
Signée par Alexsent handleOps, success true
La même opération une seconde foissimulation failed, not sent: AA25 invalid account nonce

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Erreur fréquente

Attention

On croit souvent qu’un bundler peut modifier ce que l’utilisateur a demandé. C’est impossible. La signature couvre chaque champ, donc toute modification fait échouer la validation avec AA24, et le compte n’agit jamais.

Rembourser le bundler

Avant l’exécution, l’EntryPoint prélève le coût maximal de l’opération : toutes les limites de gas additionnées, multipliées par les frais les plus élevés. Après l’exécution, il facture ce qui a vraiment servi et laisse le reste dans le dépôt du compte.

preVerificationGas paie le bundler pour un travail que l’EntryPoint ne sait pas mesurer. S’il est trop bas, le bundler y perd : dans le labo, il finit 0.000018331 ETH en dessous.

À vous : le coût maximal

Code: python
GWEI = 10 ** 9
gaz_appel = 100000
gaz_verif = 100000
gaz_pre = 21000
frais_max = 1 * GWEI

maximum = (gaz_appel + gaz_verif + gaz_pre) * frais_max
utilise = 114672 * GWEI
print("prélevé d’abord :", maximum, "wei")
print("vraiment utilisé :", utilise, "wei")
print("reste dans le dépôt :", maximum - utilise, "wei")
# Passez gaz_appel à 50000. Combien est prélevé d’abord ?

L’EntryPoint du labo est un modèle

Le vrai EntryPoint, en version 0.7 ou 0.8, compacte ses champs de gas et permet plusieurs suites de nonces. Il peut aussi rappeler un paymaster après l’exécution. Ses règles de validation, ERC-7562, arrêtent une opération qui passe la simulation puis échoue sur la chaîne.

Le labo garde la forme et laisse ces détails de côté. Son bundler est une fonction shell qui simule, puis envoie. Lisez ses codes d’erreur.

Lister les codes d’erreur de l’EntryPoint

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

À propos de ce labo et de sa source: Lab d’abstraction de compte : comptes intelligents, ERC-4337, paymasters et EIP-7702 sur une chaîne locale

Vous enseignez à une classe ? Proposez ce module à vos étudiants avec un guide de l'enseignant, des devoirs corrigés et un laboratoire pour chaque étudiant.