Choose your platform & integrate.

What changed in 3.1

Guardian 3.1.0 migration

Android, iOS, and Flutter now share ten named checks and five statuses: clear, detected, unavailable, notConfigured, and unsupported. Required checks pass only when their status is clear. Android reports observable probe failures as unavailable; a false boolean alone does not prove a check passed.

Sentinel telemetry failures return a failure result on every platform. Network, URL, Client ID, and server failures do not trigger the local violation callback or close the host app when the result is ignored. Treat a failed or unavailable result as unverified when authorizing a sensitive action.

Failure categories: premiumRequired, invalidUrl, invalidConfiguration, networkUnavailable, invalidClientId, serverRejected, verificationFailed, and unexpected. An unknown Client ID uses invalidClientId when Sentinel returns a recognized error code.

Handle a telemetry result

val result = guardian.inspectAndMonitor() // Run on a worker thread
result.onSuccess { assessment -> handleVerifiedAssessment(assessment) }
result.onFailure { error ->
    when (error.sentinelFailureCode()) {
        SentinelFailureCode.NETWORK_UNAVAILABLE -> showOfflineState()
        SentinelFailureCode.INVALID_CLIENT_ID -> showConfigurationError()
        else -> logTelemetryFailure(error)
    }
}