Lưu trữ cookie

Lưu trữ cookie

Một wagmi storage adapter lưu trạng thái ví vào cookie để hỗ trợ SSR.

Trong bối cảnh

Trên PolyArb chúng tôi sử dụng lưu trữ cookie để trạng thái ví tồn tại qua server-side rendering. Khi người dùng kết nối ví qua một connector như MetaMask hoặc Gnosis Safe, wagmi thường giữ trạng thái phiên trong bộ nhớ phía client. Một cookie storage adapter phản chiếu trạng thái ví tối thiểu (ví dụ, connector đang hoạt động và địa chỉ) vào cookie HTTP để các trang render trên server có thể đọc và hiển thị UI nhận biết tài khoản trong lần tải trang ban đầu. Điều này cải thiện cảm nhận về hiệu năng và tránh hiện tượng flash của UI bị ngắt kết nối khi ứng dụng của bạn hydrate.

Cách hoạt động (tổng quan)

• Trong phiên client wagmi ghi một số khóa chọn lọc vào cookie storage adapter thay vì, hoặc bổ sung cho, localStorage.
• Mã server-side rendering có thể đọc những cookie đó và quyết định có nên render các thành phần đã đăng nhập, che các số dư, hoặc UI theo connector hay không.
• Cookie chỉ nên lưu trạng thái tối thiểu, không nhạy cảm (id connector, địa chỉ đã rút gọn). Khóa riêng tư và chữ ký phê duyệt tuyệt đối không được lưu trong cookie.

Ghi chú triển khai

• Cookie storage là một pattern adapter cho wagmi; API chính xác phụ thuộc vào phiên bản wagmi và framework bạn dùng (Next.js, Remix, v.v.). Sử dụng các thuộc tính secure, httpOnly (khi phù hợp), SameSite và path phù hợp với mô hình bảo mật của ứng dụng.
• Vì Polymarket/PolyArb sử dụng Polygon và pUSD, trạng thái ví ở đây chỉ là trạng thái UX; thao tác ký và các hoạt động on-chain thực sự vẫn diễn ra phía client thông qua connector ví.
• Tôn trọng các hạn chế địa lý của Polymarket và không bao giờ cố gắng né tránh chúng bằng thủ thuật cookie. Không lưu dữ liệu nhạy cảm KYC trong cookie.

Xem thêm

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