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
| Mot | Ce que ça veut dire |
|---|---|
| UserOperation | une demande signée de ce que doit faire un compte intelligent |
| Bundler | un serveur qui envoie les UserOperations à la chaîne |
| EntryPoint | le contrat unique qui vérifie et exécute les UserOperations |
| Validation | la phase où le compte répond oui ou non |
| Exécution | la phase où le compte fait son appel |
| Dépôt | l’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
- L’utilisateur signe une UserOperation pour son compte intelligent.
- Un bundler rassemble des UserOperations et les envoie à l’EntryPoint dans une transaction ordinaire, en appelant handleOps.
- L’EntryPoint demande à chaque compte de valider son opération.
- 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
docker exec chain ./steps/userop.shAffiché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é
| Étape | Ce que le labo a affiché |
|---|---|
| Compteur avant | 0 |
| Nonce dans l’EntryPoint | 0 |
| Hachage signé par Alex | 0x8806a321... (64 chiffres hexadécimaux) |
| Transaction handleOps | gas utilisé 133003 |
| UserOperationEvent | success true, gas 114672, coût 0.000114672 ETH |
| Compteur après | 1 |
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
docker exec chain ./steps/refused.shAffiché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
| Essai | Ce que le bundler a affiché |
|---|---|
| Signée par Mallory, pas par Alex | simulation failed, not sent: AA24 signature error |
| Signée par Alex | sent handleOps, success true |
| La même opération une seconde fois | simulation 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
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
docker exec chain grep -n "AA[0-9]" src/EntryPoint.solAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.