Cookie storage

Cookie storage

Un adattatore di storage per wagmi che persiste lo stato del wallet nei cookie per SSR.

In contesto

Su PolyArb usiamo il cookie storage affinché lo stato del wallet sopravviva al rendering lato server. Quando un utente collega un wallet tramite un connector come MetaMask o un Gnosis Safe, wagmi normalmente conserva lo stato di sessione nello storage client-side. Un adattatore di cookie storage rispecchia lo stato minimo del wallet (per esempio, il connector attivo e l'indirizzo) nei cookie HTTP in modo che le pagine renderizzate dal server possano leggerli e mostrare un'interfaccia consapevole dell'account durante il caricamento iniziale della pagina. Questo migliora la percezione delle prestazioni ed evita un flash di interfaccia disconnessa quando l'app si idrata.

Come funziona (livello alto)

• Durante una sessione client wagmi scrive chiavi selezionate nell'adapter di cookie storage invece che, o in aggiunta a, localStorage.
• Il codice di rendering lato server può leggere quei cookie e determinare se renderizzare componenti per utenti loggati, saldi mascherati o interfacce specifiche per connector.
• I cookie dovrebbero memorizzare solo stato minimo non sensibile (id del connector, indirizzo troncato). Le chiavi private e le firme di approvazione non devono mai essere memorizzate nei cookie.

Note di implementazione

• Cookie storage è un pattern adapter per wagmi; l'API esatta dipende dalla versione di wagmi e dal tuo framework (Next.js, Remix, ecc.). Usa attributi secure, httpOnly (quando appropriato), SameSite e path coerenti con il modello di sicurezza della tua app.
• Poiché Polymarket/PolyArb usano Polygon e pUSD, lo stato del wallet qui è puramente stato UX; la firma effettiva e le operazioni on-chain avvengono comunque client-side tramite il connector del wallet.
• Rispetta le restrizioni geografiche di Polymarket e non cercare di aggirarle con trucchi sui cookie. Non memorizzare nei cookie dati sensibili relativi al KYC.

Vedi anche

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