En esta página
Resolución de problemas
Identifica primero la capa que falla: proveedor de cartera OneKey, transporte de hardware o codificación/decodificación QR. Registra método, código de error, versión de SDK o cartera y paso fallido.
Una dApp no encuentra OneKey
- Confirma que OneKey esté instalado y habilitado en el perfil de navegador que pruebas. Recarga la dApp tras instalarlo.
- Detecta el proveedor en código del navegador una vez disponible la página. No accedas a
windowdurante el renderizado del servidor. - Usa el proveedor de tu cadena. No supongas que un proveedor inyectado de otra cartera pertenece a OneKey.
- Sigue Inicio rápido para dApps o la guía de tu biblioteca de interfaz de cartera.
Se rechaza el acceso a cuentas o la firma
El rechazo es una decisión válida del usuario. Limpia el estado pendiente y permite que reintente explícitamente; no sigas abriendo avisos de permisos o firmas.
Si cambia la cuenta o red, actualiza el estado antes de crear la siguiente solicitud. Para Ethereum, consulta Acceder a cuentas y la API del proveedor.
Un dispositivo USB no aparece en la lista
- Comprueba que tu navegador admita WebUSB y que la página se sirva en un contexto seguro.
- Abre el selector USB desde una acción del usuario, como un botón Conectar, y elige el dispositivo previsto.
- Revisa el cable y cierra otra aplicación o pestaña que pueda estar usando el dispositivo.
- Repite el descubrimiento y gestiona un resultado vacío antes de llamar a un método del dispositivo.
Sigue Guía de WebUSB. Los requisitos difieren para móvil nativo y React Native BLE; las instrucciones USB del navegador no se aplican a todos los transportes.
Una solicitud espera indefinidamente
Comprueba si el SDK espera una respuesta de interfaz, como una elección de PIN o frase de contraseña, o una confirmación en el dispositivo. Registra los controladores antes de llamar y responde a la solicitud concreta según la guía de la API Core.
Ejecuta las operaciones del dispositivo en serie. Si el usuario cancela o se desconecta el transporte, limpia el estado pendiente de la interfaz e informa del resultado. No repitas automáticamente una firma ni una operación que modifique el dispositivo después de un resultado incierto.
Un método no es compatible
Verifica el método en la referencia de compatibilidad de dispositivos y cadenas y después revisa las versiones de SDK y firmware. La compatibilidad con una cadena, dispositivo o transporte no implica que todos sus métodos sean compatibles.
Una respuesta QR no se decodifica
Comprueba que uses el tipo de registro esperado y que hayas recibido todos los fragmentos de la respuesta QR multipartes. Asocia la respuesta con la solicitud original si el formato incluye un identificador. Consulta la guía QR de Ethereum y EVM.
Informar de un problema
Elige el repositorio responsable de la integración que falla:
| Problema | Dónde comunicarlo |
|---|---|
| Hardware SDK, transportes o este portal para desarrolladores | Incidencias del Hardware SDK |
| Proveedor de cartera inyectado | Incidencias de Cross-inpage provider |
| Comportamiento de la aplicación o extensión OneKey | Incidencias de la aplicación |
| Ayuda para usar un producto OneKey | Centro de ayuda de OneKey |
Incluye:
- El comportamiento esperado y el real.
- Una reproducción mínima con datos de prueba y pasos exactos.
- Versión de SDK/paquete, entorno, sistema operativo, transporte y, si corresponde, modelo y firmware del dispositivo.
- Nombre del método, código de error y mensaje sin datos sensibles.
No publiques frases de recuperación, claves privadas, PIN, frases de contraseña, credenciales, identificadores de sesión ni registros de cartera sin censurar. Ante una posible vulnerabilidad, sigue la política de seguridad del repositorio afectado en vez de divulgar detalles de explotación en una incidencia pública.