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

Clés de session et limites de dépense

Après cette leçon: Je peux vérifier si une clé de session peut faire un paiement en respectant ses limites.

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

Laisser un jeu dépenser un peu, pas tout

Une clé de session est une seconde clé, plus faible, qu’un compte intelligent accepte pour peu de temps et pour une tâche étroite. Un jeu peut payer de petites choses sans vous faire signer chaque fois, et sans jamais détenir votre clé principale.

Si la clé de session fuit, les dégâts s’arrêtent à sa limite.

À la fin de cette leçon

Remarque

Je peux vérifier si une clé de session peut faire un paiement en respectant ses limites.

Mots-clés

MotCe que ça veut direExemple
Clé de sessionune clé limitée qu’un compte intelligent accepte pour un temps
Ciblel’adresse qu’une clé de session peut payer ou appeler
Limite de dépensele maximum qu’une clé de session peut dépenser au total
Expirationle moment après lequel une clé de session ne marche plusvalable jusqu’au
Révoquerretirer sa permission à une clé

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

Une clé de session a des règles

Le propriétaire ajoute une clé de session au compte avec ses règles : quelle adresse elle peut payer, combien au total, et jusqu’à quand. Le compte garde ces règles et le montant déjà dépensé.

Quand une UserOperation est signée par une clé de session plutôt que par le propriétaire, validateUserOp contrôle ces règles. Si une règle échoue, la validation échoue et rien ne s’exécute.

Payer une boutique avec une clé de session

Commande
docker exec chain ./steps/session.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é

EssaiSigné parRésultat
Paiement 1, 0.004 ETH à la boutiqueClé de session de l’applicationenvoyé, success true
Paiement 2, 0.004 ETH à la boutiqueClé de session de l’applicationenvoyé, success true
Paiement 3, 0.004 ETH à la boutiqueClé de session de l’applicationAA24, limite de 0.01 ETH dépassée
0.001 ETH à MalloryClé de session de l’applicationAA24, mauvaise cible
0.004 ETH à la boutiqueUne clé expirée en 1970AA24, expirée

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

Les contrôles, un par un

Lisez checkSession dans le labo. Elle refuse quand l’heure dépasse validUntil ou quand l’appel n’est pas execute. Elle refuse aussi quand la cible n’est pas celle autorisée, ou quand la dépense plus ce paiement dépasse la limite.

C’est seulement quand tous les contrôles passent qu’elle ajoute le paiement à la dépense et répond 0, ce qui veut dire oui.

Lire le contrôle de la clé de session

Commande
docker exec chain sed -n 45,53p src/SmartAccount.sol

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

À vous : un total face à une limite

Code: python
limite = 10            # en millièmes d’ETH
depense = 0
paiements = [4, 4, 4, 1]

for montant in paiements:
    if depense + montant > limite:
        print(montant, "refusé, la dépense reste à", depense)
    else:
        depense = depense + montant
        print(montant, "accepté, dépense totale", depense)
# Ajoutez un paiement de 2 à la fin. Est-il accepté ?

Erreur fréquente

Attention

On compare souvent chaque paiement à la limite, un par un. Trois paiements de 0.004 ETH semblent tous corrects face à 0.01 ETH. Or la limite porte sur le total : le compte doit donc se souvenir de ce qui a été dépensé.

Choisir des règles de session sûres

Donnez à chaque clé de session les règles les plus étroites qui suffisent : une seule cible, une petite limite, une expiration courte. Un plafond par paiement ajoute une seconde ligne de défense.

Laissez le propriétaire révoquer une clé à tout moment. Les vrais comptes utilisent pour cela des modules, comme les modules de permissions ERC-7579, avec la même idée que la version simple du 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.