wagmi cookie storage — Cookie storage · PolyArb

Cookie storage

SSR のためにウォレット状態をクッキーに永続化する wagmi のストレージアダプタ。

In context

PolyArb では、サーバーサイドレンダリングをまたいでもウォレット状態が維持されるように cookie storage を使用します。ユーザーが MetaMask や Gnosis Safe のようなコネクタを介してウォレットを接続すると、通常 wagmi はクライアント側のストレージにセッション状態を保持します。cookie storage アダプタは最小限のウォレット状態（例えばアクティブなコネクタやアドレス）を HTTP クッキーに反映し、サーバー側でレンダリングされたページが初回ロード時にアカウント対応の UI を読み取って表示できるようにします。これにより体感パフォーマンスが向上し、アプリがハイドレートされる際の切断済み UI のフラッシュを避けられます。

How it works (high level)

クライアントセッション中、wagmi は選択したキーを localStorage の代わりに、または併用して cookie storage アダプタに書き込みます。
サーバーサイドレンダリングのコードはそれらのクッキーを読み、ログイン済みコンポーネント、マスクされた残高、またはコネクタ固有の UI をレンダリングするかどうかを判断できます。
クッキーには非機密で最小限の状態（コネクタ id、切り詰めたアドレス）だけを保存するべきです。秘密鍵や承認署名をクッキーに保存してはいけません。

Implementation notes

Cookie storage は wagmi に対するアダプタパターンです。正確な API は wagmi のバージョンや使用しているフレームワーク（Next.js、Remix など）に依存します。アプリのセキュリティモデルに合わせて secure、httpOnly（適切な場合）、SameSite、path 属性を適切に設定してください。
Polymarket/PolyArb は Polygon と pUSD を使用しているため、ここでのウォレット状態は純粋に UX の状態です。実際の署名やオンチェーン操作は引き続きウォレットコネクタを通じてクライアント側で行われます。
Polymarket の地理的制限を尊重し、クッキートリックで回避しようとしないでください。KYC に敏感なデータをクッキーに保存してはいけません。