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
| Mot | Ce que ça veut dire | Exemple |
|---|---|---|
| Clé de session | une clé limitée qu’un compte intelligent accepte pour un temps | |
| Cible | l’adresse qu’une clé de session peut payer ou appeler | |
| Limite de dépense | le maximum qu’une clé de session peut dépenser au total | |
| Expiration | le moment après lequel une clé de session ne marche plus | valable jusqu’au |
| Révoquer | retirer 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
docker exec chain ./steps/session.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é
| Essai | Signé par | Résultat |
|---|---|---|
| Paiement 1, 0.004 ETH à la boutique | Clé de session de l’application | envoyé, success true |
| Paiement 2, 0.004 ETH à la boutique | Clé de session de l’application | envoyé, success true |
| Paiement 3, 0.004 ETH à la boutique | Clé de session de l’application | AA24, limite de 0.01 ETH dépassée |
| 0.001 ETH à Mallory | Clé de session de l’application | AA24, mauvaise cible |
| 0.004 ETH à la boutique | Une clé expirée en 1970 | AA24, 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
docker exec chain sed -n 45,53p src/SmartAccount.solAffiché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
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.