Mejores prácticas de integración de billeteras

25 prácticas para una experiencia de usuario de billetera segura y resiliente.

1. Conexión diferida (Lazy-connect): Solicita la billetera solo cuando el usuario inicie una acción de firma (Conceptos básicos de billetera).

2. Mostrar insignia del clúster: Devnet vs mainnet debe ser obvio en la cabecera.

3. Validar coincidencia de red RPC y billetera: La falta de coincidencia causa fallos de simulación opacos.

4. Usar descubrimiento de Wallet Standard: Soporta múltiples billeteras, nunca codifiques una marca.

5. Proveedores solo del lado del cliente: Envuelve los proveedores de billetera en límites "use client" de Next.js.

6. Restablecer el estado de la aplicación al desconectar: Limpia las cachés indexadas por la clave pública.

7. Simular antes de firmar: Reduce las aprobaciones fallidas y el desperdicio de tarifas.

8. Manejar el texto de rechazo: Los usuarios cancelan; muestra una reintentación amigable, no errores.

9. Deshabilitar doble envío: Debouncea los botones de envío durante la confirmación.

10. Exponer desconexión: Acción siempre visible en el menú de cuenta.

11. autoConnect con UI de carga: Evita el destello de contenido desconectado (Autoconexión y UX de sesión).

12. Nunca almacenar secretos en localStorage: Solo claves públicas y preferencias.

13. SIWS con enlace de dominio: Los mensajes de autenticación fuera de la cadena deben incluir el origen y la fecha de caducidad.

14. Verificar firmas en el lado del servidor: Comprobación ed25519 antes de emitir sesiones.

15. Tiempos de espera de billetera de hardware: Más largos que los valores predeterminados de la billetera de software.

16. Probar Phantom y Solflare: Mínimo dos adaptadores en QA.

17. MWA móvil en dispositivos reales: Los emuladores omiten casos extremos de intención.

18. Truncar direcciones: Muestra los primeros/últimos cuatro caracteres; botón de copia para el completo.

19. Registrar el nombre del adaptador en herramientas de soporte: Ayuda a reproducir errores específicos de la billetera.

20. Mantener las versiones del adaptador + kit alineadas: Sigue el lockfile de create-solana-dapp.

21. No bloquear contenido de solo lectura: Las lecturas RPC funcionan sin conexión.

22. Vistas previas de transacciones: Resume los deltas de tokens cuando sea posible.

23. Tarifas de prioridad en mainnet: Las transacciones del usuario necesitan presupuesto de cómputo durante la congestión.

24. Modales accesibles: Trampa de enfoque y navegación por teclado para la UI de conexión.

25. Documentar requisitos de billetera: Página de ayuda que enumera las billeteras y navegadores compatibles.

Preguntas frecuentes

Relacionado

• Conceptos básicos de billetera - ejemplos introductorios
• Mejores prácticas de @solana/kit - capa de cliente
• UX de transacciones - confirmaciones

Versiones de la pila: Esta página fue escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 y LiteSVM 0.6.x.