React Native Verifier SDK v9.0.0 Migration Guide

Overview

This guide provides a comprehensive overview of the changes introduced in React Native Verifier SDK v9.0.0, including breaking changes, new features, and migration steps.

Key Features

• App to app verification: The React Native Verifier SDK can now be used to request credentials from another app on the same device using OID4VP. This allows you to build verification flows directly into your apps and have a holder app on the same device respond.
• Verify with Apple Wallet (iOS Only): The SDK can now request and verify a credential directly from an Apple Wallet using the Verify with Wallet API. Only available for iOS 16 and above.
• Improved reliability in contactless flows: Enhanced BLE performance delivers more consistent proximity credential exchanges and faster engagements.
• Status Lists Draft 14 Support: The SDK now supports the Token Status List Draft 14 specification while maintaining existing support for Draft 3.
• Stronger cryptography and standards alignment: Updated COSE algorithms (as per RFC 9864) strengthen cryptographic compatibility and ensure continued compliance with evolving standards.
• General stability and performance improvements: Multiple refinements reduce integration friction, increase consistency across mobile environments, and improve overall user experience.

For a detailed list of changes included in this release, refer to the SDK Changelog.

Breaking Changes

New Additions

Functions

Updated Function Signatures

• initialize(options?) — new InitializeOptions parameter:
  • loggerConfiguration?: LoggerConfiguration — logLevel, callbackLogLevel, optional logDir, optional callback
  • platformConfiguration?: PlatformConfiguration — tenantHost: string (required for requestMobileCredentials)

New initialize Options

• loggerConfiguration?: LoggerConfiguration — configure SDK logging: logLevel, callbackLogLevel, logDir, callback on log events.
• platformConfiguration?: PlatformConfiguration — set MATTR VII tenant host for remote credential requests.

New Types & Enums

• Online presentation (remote/app-to-app):
  • OnlinePresentationSessionResult — { sessionId, challenge?, mobileCredentialResponse?, error? }
  • OnlinePresentationResultError — { type: OnlinePresentationResultErrorType, message }
  • OnlinePresentationResultErrorType — SessionAborted | VerificationError | ResponseError | WalletUnavailable | Unknown
• Apple Wallet:
  • AppleWallet — object with requestMobileCredentials(challenge): Promise<Result<...>>
  • RequestMobileCredentialsWithAppleWalletError / RequestMobileCredentialsWithAppleWalletErrorType
• requestMobileCredentials options & errors:
  • RequestMobileCredentialsOptions — { request, applicationId, walletProviderId?, challenge }
  • RequestMobileCredentialsErrorType
  • RequestMobileCredentialsError
• handleDeepLink:
  • HandleDeepLinkOptions — { url: string }
• fetchAppleWalletConfiguration:
  • FetchAppleWalletConfigurationOptions — { request, applicationId, merchantId }
  • FetchAppleWalletConfigurationError / FetchAppleWalletConfigurationErrorType
• initialize:
  • InitializeOptions, LoggerConfiguration, PlatformConfiguration, LogLevel (Off | Error | Warn | Info | Debug | Verbose)
  • InitializeErrorType = SdkInitialized | StorageInitializedInBackground

New Error Values

Minimum Requirements

iOS

• iOS 15+ for core SDK functionality.

Android

• Android 7 / Nougat / API 24.
• The underlying Android Verifier SDK is built using Kotlin 2.0. This adds some intrinsic dependencies into your build tools.
  • Kotlin 2.0 is supported from AGP version 8.5.
  • AGP 8.5 is supported from Gradle version 8.7 and Android Studio Koala 2024.1.1.

Migration Steps

- await initialize();
+ const result = await initialize(options);
+ if (result.isErr()) {
+   // Handle error: result.error
+ }

- const response = await sendProximityPresentationRequest({ ..., skipStatusCheck: true });
+ const response = await sendProximityPresentationRequest({ ..., checkStatus: false });