Cookie storage

Cookie storage

Ein wagmi-Storage-Adapter, der den Wallet-Zustand für SSR in Cookies persistiert.

Im Kontext

Auf PolyArb verwenden wir Cookie Storage, damit der Wallet-Zustand das serverseitige Rendering überlebt. Wenn ein Nutzer eine Wallet über einen Connector wie MetaMask oder eine Gnosis Safe verbindet, speichert wagmi normalerweise die Sitzungsdaten im Client-Speicher. Ein Cookie-Storage-Adapter spiegelt den minimalen Wallet-Zustand (zum Beispiel den aktiven Connector und die Adresse) in HTTP-Cookies, sodass die serverseitig gerenderten Seiten kontobewusste UI beim initialen Seitenaufruf lesen und anzeigen können. Das verbessert die gefühlte Performance und vermeidet ein Aufblitzen einer als „getrennt“ wirkenden UI beim Hydrieren der App.

Funktionsweise (grober Überblick)

• Während einer Clientsitzung schreibt wagmi ausgewählte Schlüssel in den Cookie-Storage-Adapter statt oder zusätzlich zu localStorage.
• Serverseitiger Rendering-Code kann diese Cookies lesen und entscheiden, ob angemeldete Komponenten, maskierte Kontostände oder connector-spezifische UI gerendert werden.
• Cookies sollten nur nicht-sensible, minimale Zustandsdaten speichern (Connector-ID, gekürzte Adresse). Private Keys und Signaturen für Approvals dürfen niemals in Cookies abgelegt werden.

Implementationshinweise

• Cookie Storage ist ein Adapter-Pattern für wagmi; die genaue API hängt von der wagmi-Version und Ihrem Framework ab (Next.js, Remix usw.). Verwenden Sie sichere, gegebenenfalls httpOnly-, SameSite- und path-Attribute, die mit dem Sicherheitsmodell Ihrer App übereinstimmen.
• Da Polymarket/PolyArb Polygon und pUSD verwenden, ist der Wallet-Zustand hier rein UX-bezogen; tatsächliche Signaturen und On-Chain-Operationen erfolgen weiterhin clientseitig über den Wallet-Connector.
• Beachten Sie die Geo-Einschränkungen von Polymarket und versuchen Sie niemals, diese durch Cookie-Tricks zu umgehen. Speichern Sie keine KYC-sensitiven Daten in Cookies.

Siehe auch

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