wagmi cookie storage — Imbakan ng cookie · PolyArb

Cookie storage

Isang wagmi storage adapter na nagpapanatili ng estado ng wallet sa cookies para sa SSR.

In context

Sa PolyArb ginagamit namin ang cookie storage upang ang estado ng wallet ay magpatuloy sa server-side rendering. Kapag kumokonekta ang isang user ng wallet sa pamamagitan ng connector tulad ng MetaMask o isang Gnosis Safe, karaniwang iniimbak ng wagmi ang session state sa client-side storage. Ang cookie storage adapter ay nire-replicate ang minimal na estado ng wallet (halimbawa, ang active connector at address) sa mga HTTP cookie para mabasa at maire-render ng server-rendered na mga pahina ang account-aware na UI sa unang pag-load. Pinapabuti nito ang perceived performance at iniiwasan ang biglaang pagpapalit mula sa naka-disconnect na UI kapag nag-hydrate ang app.

How it works (high level)

Sa panahon ng client session nagsusulat ang wagmi ng piling mga key sa cookie storage adapter sa halip na, o bilang karagdagan sa, localStorage.
Maaaring basahin ng server-side rendering code ang mga cookies na iyon at tukuyin kung magre-render ng logged-in na mga component, masked balances, o connector-specific na UI.
Dapat mag-imbak ang cookies lamang ng hindi-sensitibong, minimal na estado (connector id, pinaikling address). Ang mga private key at approval signatures ay hindi kailanman dapat itago sa cookies.

Implementation notes

Ang cookie storage ay isang adapter pattern para sa wagmi; ang eksaktong API ay nakadepende sa bersyon ng wagmi at sa iyong framework (Next.js, Remix, atbp.). Gumamit ng secure, httpOnly (kung angkop), SameSite at path attributes na pare-pareho sa security model ng iyong app.
Dahil gumagamit ang Polymarket/PolyArb ng Polygon at pUSD, ang estado ng wallet dito ay purong UX state; ang aktwal na pag-sign at mga on-chain operation ay nangyayari pa rin sa client-side sa pamamagitan ng wallet connector.
Igalang ang geo restrictions ng Polymarket at huwag subukang lampasan ang mga ito gamit ang mga trick sa cookie. Huwag mag-imbak ng KYC-sensitive na data sa cookies.