Cookie storage

Storage par cookie

Un adaptateur de stockage wagmi qui persiste l'état du portefeuille dans des cookies pour le SSR.

Contexte

Sur PolyArb, nous utilisons le stockage par cookie afin que l'état du portefeuille survive au rendu côté serveur. Lorsqu'un utilisateur connecte un portefeuille via un connecteur tel que MetaMask ou un Gnosis Safe, wagmi conserve normalement l'état de session dans le stockage côté client. Un adaptateur de stockage par cookie reflète l'état minimal du portefeuille (par exemple, le connecteur actif et l'adresse) dans des cookies HTTP afin que les pages rendues côté serveur puissent lire et afficher une interface consciente du compte lors du chargement initial. Cela améliore la perception des performances et évite un flash d'interface déconnectée lors de l'hydratation de l'application.

Fonctionnement (haut niveau)

• Pendant une session client, wagmi écrit certaines clés dans l'adaptateur de stockage par cookie au lieu de, ou en plus de, localStorage.
• Le code de rendu côté serveur peut lire ces cookies et déterminer s'il doit rendre des composants connectés, des soldes masqués ou une interface spécifique au connecteur.
• Les cookies ne doivent contenir que des états minimaux non sensibles (identifiant du connecteur, adresse tronquée). Les clés privées et les signatures d'approbation ne doivent jamais être stockées dans des cookies.

Remarques d'implémentation

• Le stockage par cookie est un pattern d'adaptateur pour wagmi ; l'API exacte dépend de la version de wagmi et de votre framework (Next.js, Remix, etc.). Utilisez des attributs secure, httpOnly (lorsque cela est approprié), SameSite et path cohérents avec le modèle de sécurité de votre application.
• Parce que Polymarket/PolyArb utilisent Polygon et pUSD, l'état du portefeuille ici est purement d'UX ; la signature réelle et les opérations on-chain se déroulent toujours côté client via le connecteur de portefeuille.
• Respectez les restrictions géographiques de Polymarket et n'essayez jamais de les contourner par des astuces de cookies. N'enregistrez pas de données sensibles liées au KYC dans des cookies.

Voir aussi

• /glossary/CLOB
• /glossary/Relayer
• /glossary/pUSD