쿠키 저장

쿠키 저장

SSR을 위해 지갑 상태를 쿠키에 지속시키는 wagmi 스토리지 어댑터입니다.

맥락

PolyArb에서는 쿠키 저장을 사용해 지갑 상태가 서버 사이드 렌더링을 통과해 유지되도록 합니다. 사용자가 MetaMask나 Gnosis Safe 같은 커넥터로 지갑을 연결하면, wagmi는 일반적으로 클라이언트 측 스토리지에 세션 상태를 보관합니다. 쿠키 저장 어댑터는 최소한의 지갑 상태(예: 활성 커넥터와 주소)를 HTTP 쿠키에 복제하여 서버에서 렌더링된 페이지가 초기 로드 시 계정 인식 UI를 읽고 렌더링할 수 있게 합니다. 이는 체감 성능을 개선하고 앱이 하이드레이트될 때 연결 끊긴 UI가 깜박이는 현상을 방지합니다.

작동 방식(개요)

• 클라이언트 세션 동안 wagmi는 일부 키를 localStorage 대신 또는 추가로 쿠키 저장 어댑터에 씁니다.
• 서버 사이드 렌더링 코드는 해당 쿠키를 읽어 로그인된 컴포넌트, 마스킹된 잔액 또는 커넥터별 UI를 렌더링할지 결정할 수 있습니다.
• 쿠키에는 비민감성의 최소한의 상태(커넥터 id, 축약된 주소)만 저장해야 합니다. 개인 키와 승인 서명은 절대 쿠키에 저장해서는 안 됩니다.

구현 노트

• 쿠키 저장은 wagmi용 어댑터 패턴입니다. 정확한 API는 wagmi 버전과 사용하는 프레임워크(Next.js, Remix 등)에 따라 다릅니다. 앱의 보안 모델에 맞게 secure, httpOnly(적절할 때), SameSite 및 path 속성을 사용하세요.
• Polymarket/PolyArb가 Polygon과 pUSD를 사용하기 때문에, 여기의 지갑 상태는 순수히 UX 상태입니다. 실제 서명과 온체인 작업은 여전히 지갑 커넥터를 통해 클라이언트 측에서 이루어집니다.
• Polymarket의 지리적 제한을 존중하고 쿠키 트릭으로 이를 우회하려고 시도하지 마세요. 쿠키에 KYC 민감 데이터를 저장하지 마십시오.

참고

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