Clés de session

Pourquoi un clic suffit

Quand vous activez le trading, votre portefeuille signe un message qui désigne une paire de clés créée dans votre navigateur et son expiration : RegisterSessionKeyV2 la première fois (il peut aussi indiquer qui vous a parrainé, un lien définitif), RegisterSessionKey pour chaque clé suivante. Le relayer le soumet et le contrat SessionKeyManager enregistre la clé pour votre compte. Dès lors, la clé de session signe vos ouvertures et vos clôtures, le relayer les soumet, et les contrats les acceptent comme venant de vous.

La clé est générée et utilisée dans un worker séparé du navigateur, et stockée chiffrée avec une clé que le navigateur garde non extractible, si bien que la clé brute ne se trouve jamais dans le stockage de la page. Le worker ne signe rien d’autre que des messages de trading pour votre compte sur ce déploiement.

Ce qu’une clé de session peut faire

• Ouvrir des positions sur votre compte, financées par votre solde disponible ou votre solde en file (OpenPosition).
• Clôturer des positions de votre compte (Close).
• Annuler vos ordres encore en file chez le relayer (CancelIntent).

Ce qu’une clé de session ne peut pas faire

• Retirer : chaque retrait demande la signature de votre propre portefeuille.
• Staker, déstaker ou réclamer des récompenses : ce sont aussi des signatures du portefeuille.
• Enregistrer ou révoquer des clés.

Dans le pire des cas, si une clé de session fuite : quelqu’un peut ouvrir et clôturer des positions sur votre compte, et pourrait perdre votre solde en trades, mais ne peut pas le sortir de l’exchange. Du code exécuté dans la page, comme une extension de navigateur malveillante, pourrait utiliser une clé déverrouillée pendant qu’il tourne ; révoquez donc les clés dont vous n’avez plus besoin.

Frais de builder

L’enregistrement que vous signez contient aussi une adresse de builder et les frais de builder maximaux que vous acceptez, que l’app laisse vides et à zéro. Une clé enregistrée via un autre frontend peut désigner ce frontend ; tant que le propriétaire l’approuve comme builder, les positions que la clé clôture lui versent le plus bas entre son taux et le maximum que vous avez signé, au plus 0.5% du PnL : sur votre gain si vous gagnez, sur le gain du LP si vous perdez. Voir Codes builder.

Expiration

Une clé est enregistrée pour 30 jours. Chaque ordre qu’elle signe porte sa propre échéance, à 1 heure, qui doit tomber dans la durée de vie de la clé. Un compte peut avoir au plus 8 clés actives ou en attente.

Révoquer

La fenêtre Sessions de trading de l’app liste toutes les clés de votre compte, signale celle de cet appareil, et révoque une clé ou toutes, y compris celles d’appareils que vous n’avez plus. La révocation se fait de deux façons :

• par une transaction de votre portefeuille vers le SessionKeyManager, qui demande un peu de HYPE pour le gas ;
• par un message signé que le relayer soumet gratuitement, pour jusqu’à 32 clés à la fois ou pour toutes. Cette voie sans gas est un ajout délibéré, pour que vous puissiez couper un appareil perdu même sans HYPE dans votre portefeuille.

Quand une clé est révoquée, chaque ordre en file qu’elle a signé est annulé, et tout ordre qu’elle a signé et qui atteint la chaîne plus tard est rejeté. Chaque message que l’exchange demande à votre portefeuille de signer figure sur la page Signatures officielles.