Saltar al contenido principal
Version: Guardian v0.5.3

Configuración del proveedor

Opción A: Proveedor + Hook (recomendado)​

Envuelve la raíz de tu app con GuardianProvider. Esto inicializa el SDK y lo expone a todos los componentes hijos mediante el hook useGuardian.

App.tsx
import { GuardianProvider } from '@surtai/guardian-rn';

export default function App() {
return (
<GuardianProvider
collectLocation={true}
>
<Navigation />
</GuardianProvider>
);
}

El SDK no maneja ninguna clave de API. El contexto de cliente y de transacción provienen de un JWT de corta duración que genera tu backend. Consulta Verificar transacciones para más detalles.

Props del proveedor​

PropTipoPredeterminadoDescripción
logLevel'debug' | 'info' | 'warn' | 'error' | 'none''warn'Nivel de registro del SDK. Se aplica en iOS. Android lo ignora y registra en el nivel INFO.
collectLocationbooleanfalseHabilita la recopilación GPS (requiere permisos)
collectWifiInfobooleanfalseHabilita los detalles de red WiFi (solo Android)
collectSimCardInfobooleanfalseHabilita la información de SIM/operador (solo Android)
collectCameraInfobooleanfalseHabilita la cantidad de cámaras (solo Android)

Opción B: API imperativa​

Si prefieres no usar el contexto de React, llama a initialize() directamente al iniciar la app:

index.ts
import { GuardianSDK } from '@surtai/guardian-rn';

GuardianSDK.initialize({
logLevel: 'warn',
collectLocation: true,
});

Hook useGuardian​

const {
isInitialized, // boolean - true after SDK is ready
verify, // (jwt: string, options?: VerifyOptions) => Promise<VerificationResult>
collect, // (jwt?: string, options?: VerifyOptions) => Promise<CollectResult>
} = useGuardian();
aviso

useGuardian() debe llamarse dentro de un <GuardianProvider>. Llamarlo fuera lanza un error.

Solución de problemas​

ErrorCausaSolución
verification_failed con not_initialized en el mensaje (iOS)verify() llamado antes de que el SDK esté listoUsa GuardianProvider o llama a initialize() al iniciar
Error del hook useGuardianHook usado fuera del proveedorEnvuelve el árbol de componentes con <GuardianProvider>
verification_failedLa solicitud a Surt falló. Un JWT faltante, malformado o expirado es una de las causas. En Android el mensaje contiene el estado HTTP.Solicita un JWT nuevo a tu backend para cada llamada y pásalo a verify()

verify() y collect() rechazan con error.code igual a verification_failed, collect_failed o sdk_error. Consulta Códigos de error para saber cómo leer el detalle.