wagmi cookie storage — Cookie storage · PolyArb

Cookie storage

一個用於 SSR 的 wagmi 儲存適配器，將錢包狀態持久化到 cookies。

In context

在 PolyArb，我們使用 cookie storage，使錢包狀態能夠在伺服器端渲染期間保存。當使用者透過像是 MetaMask 或 Gnosis Safe 之類的 connector 連接錢包時，wagmi 通常會在用戶端儲存會話狀態。cookie storage 適配器會將必要的最小錢包狀態（例如啟用的 connector 與位址）鏡像到 HTTP cookies，讓伺服器渲染的頁面在初次載入時就能讀取並呈現具帳戶感知的介面。這能提升感知上的效能，並避免應用在 hydrate 時出現短暫的斷線介面閃爍。

How it works (high level)

在用戶端會話期間，wagmi 將選定的鍵寫入 cookie storage 適配器，而不是或同時也寫入 localStorage。
伺服器端渲染程式碼可以讀取那些 cookies，並決定是否呈現已登入的元件、遮罩後的餘額或特定 connector 的 UI。
Cookies 應只儲存非敏感且最小的狀態（connector id、截短後的位址）。私鑰與簽名授權資料絕不可儲存在 cookies 中。

Implementation notes

Cookie storage 是對 wagmi 的一種適配器模式；確切的 API 取決於 wagmi 的版本與你使用的框架（Next.js、Remix 等）。請根據應用的安全模型使用 secure、httpOnly（在適當情況下）、SameSite 與 path 屬性。
因為 Polymarket/PolyArb 使用 Polygon 與 pUSD，這裡的錢包狀態純粹為使用者體驗（UX）狀態；實際的簽名與鏈上操作仍由錢包 connector 在用戶端執行。
尊重 Polymarket 的地域限制，切勿嘗試透過 cookie 技巧繞過這些限制。不要在 cookies 中儲存任何 KYC 敏感資料。