Almacenamiento en cookies

Almacenamiento en cookies

Un adaptador de almacenamiento de wagmi que persiste el estado de la wallet en cookies para SSR.

En contexto

En PolyArb usamos el almacenamiento en cookies para que el estado de la wallet sobreviva al renderizado del lado del servidor. Cuando un usuario conecta una wallet mediante un conector como MetaMask o una Gnosis Safe, wagmi normalmente guarda el estado de la sesión en almacenamiento del cliente. Un adaptador de almacenamiento en cookies refleja el estado mínimo de la wallet (por ejemplo, el conector activo y la dirección) en cookies HTTP para que las páginas renderizadas por el servidor puedan leerlo y mostrar una interfaz consciente de la cuenta durante la carga inicial. Esto mejora la percepción de rendimiento y evita un parpadeo de interfaz desconectada cuando la aplicación se hidrata.

Cómo funciona (alto nivel)

• Durante una sesión de cliente, wagmi escribe claves seleccionadas en el adaptador de almacenamiento en cookies en lugar de, o además de, localStorage.
• El código de renderizado del lado del servidor puede leer esas cookies y determinar si debe renderizar componentes para usuarios logueados, saldos enmascarados o interfaz específica del conector.
• Las cookies deben almacenar solo estado mínimo no sensible (id del conector, dirección truncada). Las claves privadas y las firmas de aprobación nunca deben almacenarse en cookies.

Notas de implementación

• El almacenamiento en cookies es un patrón de adaptador para wagmi; la API exacta depende de la versión de wagmi y de tu framework (Next.js, Remix, etc.). Usa atributos secure, httpOnly (cuando corresponda), SameSite y path consistentes con el modelo de seguridad de tu aplicación.
• Debido a que Polymarket/PolyArb usan Polygon y pUSD, el estado de la wallet aquí es puramente estado de UX; la firma real y las operaciones on-chain siguen ocurriendo del lado del cliente a través del conector de la wallet.
• Respeta las restricciones geográficas de Polymarket y nunca intentes eludirlas mediante trucos con cookies. No almacenes datos sensibles de KYC en cookies.

Véase también

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