@oobit/react-native-sdk 1.0.3 → 1.0.5

package/dist/index.d.ts

@@ -4,8 +4,12 @@
  */
 export { WidgetSDK } from './WidgetSDK';
 export type { WidgetSDKRef } from './WidgetSDK';
-export type { WidgetSDKConfig, WidgetEnvironment, DepositToken, WidgetMessageType, BaseWidgetMessage, WidgetMessage, WidgetReadyMessage, OpenWalletMessage, CardCreatedMessage, WidgetErrorMessage, WidgetCloseMessage, TransactionRequestedMessage, NativeMessageType, NativeMessage, NativeBackPressedMessage, NativeNavigateBackMessage, NativePlatformInfoMessage, NativeWalletOpenedMessage, } from './types';
+export type { WidgetSDKConfig, WidgetEnvironment, DepositToken, WidgetMessageType, BaseWidgetMessage, WidgetMessage, WidgetReadyMessage, OpenWalletMessage, CardCreatedMessage, WidgetErrorMessage, WidgetCloseMessage, TransactionRequestedMessage, RequestCardDetailsSessionMessage, NativeMessageType, NativeMessage, NativeBackPressedMessage, NativeNavigateBackMessage, NativePlatformInfoMessage, NativeWalletOpenedMessage, NativeCardDetailsSessionMessage, NativeBiometricFailedMessage, } from './types';
 export { WALLET_URLS, MessageTypes } from './types';
 export { WIDGET_URLS, getWidgetUrl } from './config';
 export { openNativeWallet, isWalletAvailable } from './walletUtils';
+export { authenticateWithBiometrics, isBiometricAvailable, getBiometryTypeLabel, BiometryTypes, } from './biometricUtils';
+export type { BiometricResult, BiometricAvailability } from './biometricUtils';
+export { generateSessionCredentials, generateRandomHexKey, hexToBase64, } from './cryptoUtils';
+export type { SessionCredentials } from './cryptoUtils';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,YAAY,EAEV,eAAe,EACf,iBAAiB,EACjB,YAAY,EAGZ,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAG3B,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGrD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,YAAY,EAEV,eAAe,EACf,iBAAiB,EACjB,YAAY,EAGZ,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,gCAAgC,EAGhC,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGrD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGpE,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG/E,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -4,7 +4,7 @@
  * Export all public components, types, and utilities
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isWalletAvailable = exports.openNativeWallet = exports.getWidgetUrl = exports.WIDGET_URLS = exports.MessageTypes = exports.WALLET_URLS = exports.WidgetSDK = void 0;
+exports.hexToBase64 = exports.generateRandomHexKey = exports.generateSessionCredentials = exports.BiometryTypes = exports.getBiometryTypeLabel = exports.isBiometricAvailable = exports.authenticateWithBiometrics = exports.isWalletAvailable = exports.openNativeWallet = exports.getWidgetUrl = exports.WIDGET_URLS = exports.MessageTypes = exports.WALLET_URLS = exports.WidgetSDK = void 0;
 var WidgetSDK_1 = require("./WidgetSDK");
 Object.defineProperty(exports, "WidgetSDK", { enumerable: true, get: function () { return WidgetSDK_1.WidgetSDK; } });
 // Export constants
@@ -18,4 +18,15 @@ Object.defineProperty(exports, "getWidgetUrl", { enumerable: true, get: function
 var walletUtils_1 = require("./walletUtils");
 Object.defineProperty(exports, "openNativeWallet", { enumerable: true, get: function () { return walletUtils_1.openNativeWallet; } });
 Object.defineProperty(exports, "isWalletAvailable", { enumerable: true, get: function () { return walletUtils_1.isWalletAvailable; } });
+// Export biometric utilities
+var biometricUtils_1 = require("./biometricUtils");
+Object.defineProperty(exports, "authenticateWithBiometrics", { enumerable: true, get: function () { return biometricUtils_1.authenticateWithBiometrics; } });
+Object.defineProperty(exports, "isBiometricAvailable", { enumerable: true, get: function () { return biometricUtils_1.isBiometricAvailable; } });
+Object.defineProperty(exports, "getBiometryTypeLabel", { enumerable: true, get: function () { return biometricUtils_1.getBiometryTypeLabel; } });
+Object.defineProperty(exports, "BiometryTypes", { enumerable: true, get: function () { return biometricUtils_1.BiometryTypes; } });
+// Export crypto utilities (for advanced usage)
+var cryptoUtils_1 = require("./cryptoUtils");
+Object.defineProperty(exports, "generateSessionCredentials", { enumerable: true, get: function () { return cryptoUtils_1.generateSessionCredentials; } });
+Object.defineProperty(exports, "generateRandomHexKey", { enumerable: true, get: function () { return cryptoUtils_1.generateRandomHexKey; } });
+Object.defineProperty(exports, "hexToBase64", { enumerable: true, get: function () { return cryptoUtils_1.hexToBase64; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AA8BlB,mBAAmB;AACnB,iCAAoD;AAA3C,oGAAA,WAAW,OAAA;AAAE,qGAAA,YAAY,OAAA;AAClC,mCAAqD;AAA5C,qGAAA,WAAW,OAAA;AAAE,sGAAA,YAAY,OAAA;AAElC,0BAA0B;AAC1B,6CAAoE;AAA3D,+GAAA,gBAAgB,OAAA;AAAE,gHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAiClB,mBAAmB;AACnB,iCAAoD;AAA3C,oGAAA,WAAW,OAAA;AAAE,qGAAA,YAAY,OAAA;AAClC,mCAAqD;AAA5C,qGAAA,WAAW,OAAA;AAAE,sGAAA,YAAY,OAAA;AAElC,0BAA0B;AAC1B,6CAAoE;AAA3D,+GAAA,gBAAgB,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAE5C,6BAA6B;AAC7B,mDAK0B;AAJxB,4HAAA,0BAA0B,OAAA;AAC1B,sHAAA,oBAAoB,OAAA;AACpB,sHAAA,oBAAoB,OAAA;AACpB,+GAAA,aAAa,OAAA;AAIf,+CAA+C;AAC/C,6CAIuB;AAHrB,yHAAA,0BAA0B,OAAA;AAC1B,mHAAA,oBAAoB,OAAA;AACpB,0GAAA,WAAW,OAAA"}

package/dist/types.d.ts

@@ -12,67 +12,81 @@ export interface DepositToken {
     iconUrl: string | null;
     networkName: string;
 }
-export type WidgetMessageType = 'widget:ready' | 'widget:open-wallet' | 'widget:card-created' | 'widget:error' | 'widget:close' | 'widget:transaction-requested' | 'widget:token-expired';
+export type WidgetMessageType = "widget:ready" | "widget:open-wallet" | "widget:card-created" | "widget:error" | "widget:close" | "widget:transaction-requested" | "widget:token-expired" | "widget:request-card-details-session";
 /**
  * Native Message Types
  * Messages sent from the native app to the web widget
  */
-export type NativeMessageType = 'native:platform-info' | 'native:wallet-opened' | 'native:back-pressed' | 'native:navigate-back';
+export type NativeMessageType = "native:platform-info" | "native:wallet-opened" | "native:back-pressed" | "native:navigate-back" | "native:card-details-session" | "native:biometric-failed";
 export interface NativeBackPressedMessage {
-    type: 'native:back-pressed';
+    type: "native:back-pressed";
     timestamp: number;
 }
 export interface NativeNavigateBackMessage {
-    type: 'native:navigate-back';
+    type: "native:navigate-back";
     timestamp: number;
 }
 export interface NativePlatformInfoMessage {
-    type: 'native:platform-info';
+    type: "native:platform-info";
     payload: {
         platform: string;
         walletAvailable: boolean;
     };
 }
 export interface NativeWalletOpenedMessage {
-    type: 'native:wallet-opened';
+    type: "native:wallet-opened";
     payload: {
         success: boolean;
     };
 }
-export type NativeMessage = NativeBackPressedMessage | NativeNavigateBackMessage | NativePlatformInfoMessage | NativeWalletOpenedMessage;
+export interface NativeCardDetailsSessionMessage {
+    type: "native:card-details-session";
+    payload: {
+        sessionId: string;
+        secretKey: string;
+    };
+}
+export interface NativeBiometricFailedMessage {
+    type: "native:biometric-failed";
+    payload: {
+        reason: "cancelled" | "failed" | "not_available" | "not_enrolled";
+        message?: string;
+    };
+}
+export type NativeMessage = NativeBackPressedMessage | NativeNavigateBackMessage | NativePlatformInfoMessage | NativeWalletOpenedMessage | NativeCardDetailsSessionMessage | NativeBiometricFailedMessage;
 export interface BaseWidgetMessage {
     type: WidgetMessageType;
     timestamp: number;
 }
 export interface WidgetReadyMessage extends BaseWidgetMessage {
-    type: 'widget:ready';
+    type: "widget:ready";
 }
 export interface OpenWalletMessage extends BaseWidgetMessage {
-    type: 'widget:open-wallet';
+    type: "widget:open-wallet";
     payload: {
-        platform: 'ios' | 'android';
+        platform: "ios" | "android";
     };
 }
 export interface CardCreatedMessage extends BaseWidgetMessage {
-    type: 'widget:card-created';
+    type: "widget:card-created";
     payload: {
         cardId: string;
-        cardType: 'virtual' | 'physical';
+        cardType: "virtual" | "physical";
         last4: string;
     };
 }
 export interface WidgetErrorMessage extends BaseWidgetMessage {
-    type: 'widget:error';
+    type: "widget:error";
     payload: {
         code: string;
         message: string;
     };
 }
 export interface WidgetCloseMessage extends BaseWidgetMessage {
-    type: 'widget:close';
+    type: "widget:close";
 }
 export interface TransactionRequestedMessage extends BaseWidgetMessage {
-    type: 'widget:transaction-requested';
+    type: "widget:transaction-requested";
     payload: {
         token: DepositToken;
         cryptoAmount: string;
@@ -81,18 +95,24 @@ export interface TransactionRequestedMessage extends BaseWidgetMessage {
     };
 }
 export interface TokenExpiredMessage extends BaseWidgetMessage {
-    type: 'widget:token-expired';
+    type: "widget:token-expired";
     payload?: {
         reason?: string;
     };
 }
-export type WidgetMessage = WidgetReadyMessage | OpenWalletMessage | CardCreatedMessage | WidgetErrorMessage | WidgetCloseMessage | TransactionRequestedMessage | TokenExpiredMessage;
+export interface RequestCardDetailsSessionMessage extends BaseWidgetMessage {
+    type: "widget:request-card-details-session";
+    payload: {
+        publicKey: string;
+    };
+}
+export type WidgetMessage = WidgetReadyMessage | OpenWalletMessage | CardCreatedMessage | WidgetErrorMessage | WidgetCloseMessage | TransactionRequestedMessage | TokenExpiredMessage | RequestCardDetailsSessionMessage;
 /**
  * Widget environment configuration
  * - 'development': Uses development/staging widget URL
  * - 'production': Uses production widget URL
  */
-export type WidgetEnvironment = 'development' | 'production';
+export type WidgetEnvironment = "development" | "production";
 /**
  * SDK Configuration
  */
@@ -140,9 +160,12 @@ export declare const MessageTypes: {
     readonly CLOSE: "widget:close";
     readonly TRANSACTION_REQUESTED: "widget:transaction-requested";
     readonly TOKEN_EXPIRED: "widget:token-expired";
+    readonly REQUEST_CARD_DETAILS_SESSION: "widget:request-card-details-session";
     readonly PLATFORM_INFO: "native:platform-info";
     readonly WALLET_OPENED: "native:wallet-opened";
     readonly BACK_PRESSED: "native:back-pressed";
     readonly NAVIGATE_BACK: "native:navigate-back";
+    readonly CARD_DETAILS_SESSION: "native:card-details-session";
+    readonly BIOMETRIC_FAILED: "native:biometric-failed";
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -10,12 +10,12 @@ exports.MessageTypes = exports.WALLET_URLS = void 0;
  */
 exports.WALLET_URLS = {
     ios: {
-        passkit: 'shoebox://', // Apple Wallet deep link
-        fallback: 'https://wallet.apple.com',
+        passkit: "shoebox://", // Apple Wallet deep link
+        fallback: "https://wallet.apple.com",
     },
     android: {
-        googlePay: 'https://pay.google.com/gp/w/home/wallet',
-        fallback: 'https://wallet.google.com',
+        googlePay: "https://pay.google.com/gp/w/home/wallet",
+        fallback: "https://wallet.google.com",
     },
 };
 /**
@@ -27,17 +27,20 @@ exports.WALLET_URLS = {
  */
 exports.MessageTypes = {
     // Widget → Native
-    READY: 'widget:ready',
-    OPEN_WALLET: 'widget:open-wallet',
-    CARD_CREATED: 'widget:card-created',
-    ERROR: 'widget:error',
-    CLOSE: 'widget:close',
-    TRANSACTION_REQUESTED: 'widget:transaction-requested',
-    TOKEN_EXPIRED: 'widget:token-expired',
+    READY: "widget:ready",
+    OPEN_WALLET: "widget:open-wallet",
+    CARD_CREATED: "widget:card-created",
+    ERROR: "widget:error",
+    CLOSE: "widget:close",
+    TRANSACTION_REQUESTED: "widget:transaction-requested",
+    TOKEN_EXPIRED: "widget:token-expired",
+    REQUEST_CARD_DETAILS_SESSION: "widget:request-card-details-session",
     // Native → Widget
-    PLATFORM_INFO: 'native:platform-info',
-    WALLET_OPENED: 'native:wallet-opened',
-    BACK_PRESSED: 'native:back-pressed',
-    NAVIGATE_BACK: 'native:navigate-back',
+    PLATFORM_INFO: "native:platform-info",
+    WALLET_OPENED: "native:wallet-opened",
+    BACK_PRESSED: "native:back-pressed",
+    NAVIGATE_BACK: "native:navigate-back",
+    CARD_DETAILS_SESSION: "native:card-details-session",
+    BIOMETRIC_FAILED: "native:biometric-failed",
 };
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAyJH;;GAEG;AACU,QAAA,WAAW,GAAG;IACzB,GAAG,EAAE;QACH,OAAO,EAAE,YAAY,EAAE,yBAAyB;QAChD,QAAQ,EAAE,0BAA0B;KACrC;IACD,OAAO,EAAE;QACP,SAAS,EAAE,yCAAyC;QACpD,QAAQ,EAAE,2BAA2B;KACtC;CACO,CAAC;AAEX;;;;;;GAMG;AACU,QAAA,YAAY,GAAG;IAC1B,kBAAkB;IAClB,KAAK,EAAE,cAAc;IACrB,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,qBAAqB;IACnC,KAAK,EAAE,cAAc;IACrB,KAAK,EAAE,cAAc;IACrB,qBAAqB,EAAE,8BAA8B;IACrD,aAAa,EAAE,sBAAsB;IACrC,kBAAkB;IAClB,aAAa,EAAE,sBAAsB;IACrC,aAAa,EAAE,sBAAsB;IACrC,YAAY,EAAE,qBAAqB;IACnC,aAAa,EAAE,sBAAsB;CAC7B,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA2LH;;GAEG;AACU,QAAA,WAAW,GAAG;IACzB,GAAG,EAAE;QACH,OAAO,EAAE,YAAY,EAAE,yBAAyB;QAChD,QAAQ,EAAE,0BAA0B;KACrC;IACD,OAAO,EAAE;QACP,SAAS,EAAE,yCAAyC;QACpD,QAAQ,EAAE,2BAA2B;KACtC;CACO,CAAC;AAEX;;;;;;GAMG;AACU,QAAA,YAAY,GAAG;IAC1B,kBAAkB;IAClB,KAAK,EAAE,cAAc;IACrB,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,qBAAqB;IACnC,KAAK,EAAE,cAAc;IACrB,KAAK,EAAE,cAAc;IACrB,qBAAqB,EAAE,8BAA8B;IACrD,aAAa,EAAE,sBAAsB;IACrC,4BAA4B,EAAE,qCAAqC;IACnE,kBAAkB;IAClB,aAAa,EAAE,sBAAsB;IACrC,aAAa,EAAE,sBAAsB;IACrC,YAAY,EAAE,qBAAqB;IACnC,aAAa,EAAE,sBAAsB;IACrC,oBAAoB,EAAE,6BAA6B;IACnD,gBAAgB,EAAE,yBAAyB;CACnC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oobit/react-native-sdk",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "React Native SDK for integrating Oobit crypto payments into wallet apps",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -39,15 +39,13 @@
     "url": "git+https://github.com/oobit-tech/react-native-SDK.git"
   },
   "peerDependencies": {
+    "expo-intent-launcher": ">=6.0.0",
     "expo-linking": ">=6.0.0",
     "react": ">=18.0.0",
     "react-native": ">=0.70.0",
-    "react-native-webview": ">=13.0.0"
-  },
-  "peerDependenciesMeta": {
-    "expo-intent-launcher": {
-      "optional": true
-    }
+    "react-native-webview": ">=13.0.0",
+    "react-native-biometrics": ">=3.0.0",
+    "react-native-quick-crypto": ">=0.7.0"
   },
   "devDependencies": {
     "@types/react": "~19.1.0",
@@ -58,6 +56,8 @@
     "expo-linking": "~8.0.8",
     "react": "19.1.0",
     "react-native": "0.81.5",
+    "react-native-biometrics": "^3.0.1",
+    "react-native-quick-crypto": "^0.7.9",
     "react-native-webview": "13.15.0",
     "typescript": "~5.9.2"
   },

package/src/WidgetSDK.tsx

@@ -11,10 +11,24 @@ import React, {
   useRef,
   useState,
 } from "react";
-import { ActivityIndicator, BackHandler, Linking, Platform, StyleSheet, View } from "react-native";
+import {
+  ActivityIndicator,
+  BackHandler,
+  Linking,
+  Platform,
+  StyleSheet,
+  View,
+} from "react-native";
 import { WebView, WebViewMessageEvent } from "react-native-webview";
+import { authenticateWithBiometrics } from "./biometricUtils";
 import { getWidgetUrl } from "./config";
-import { WidgetMessage, WidgetSDKConfig } from "./types";
+import { generateSessionCredentials } from "./cryptoUtils";
+import {
+  NativeBiometricFailedMessage,
+  NativeCardDetailsSessionMessage,
+  WidgetMessage,
+  WidgetSDKConfig,
+} from "./types";
 import { isWalletAvailable, openNativeWallet } from "./walletUtils";
 
 export interface WidgetSDKRef {
@@ -117,6 +131,10 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
             onError?.("TOKEN_EXPIRED", "Access token has expired");
             break;
 
+          case "widget:request-card-details-session":
+            handleCardDetailsRequest(message);
+            break;
+
           default:
             console.warn("[WidgetSDK] Unknown message type:", message);
         }
@@ -178,7 +196,8 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
     const handleTransactionRequested = (message: WidgetMessage) => {
       if (message.type !== "widget:transaction-requested") return;
 
-      const { token, cryptoAmount, depositAddress, depositAddressTag } = message.payload;
+      const { token, cryptoAmount, depositAddress, depositAddressTag } =
+        message.payload;
       console.log("[WidgetSDK] Transaction requested:", {
         token,
         cryptoAmount,
@@ -186,7 +205,89 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
         depositAddressTag,
       });
 
-      onTransactionRequested?.(token, cryptoAmount, depositAddress, depositAddressTag);
+      onTransactionRequested?.(
+        token,
+        cryptoAmount,
+        depositAddress,
+        depositAddressTag
+      );
+    };
+
+    /**
+     * Handle card details session request from widget
+     * 1. Show biometric prompt for user authentication
+     * 2. Generate cryptographically linked sessionId + secretKey pair
+     * 3. Send credentials back to widget for API call and decryption
+     */
+    const handleCardDetailsRequest = async (message: WidgetMessage) => {
+      if (message.type !== "widget:request-card-details-session") return;
+
+      const { publicKey } = message.payload;
+      console.log(
+        "[WidgetSDK] Card details requested, initiating biometric auth..."
+      );
+
+      // Step 1: Authenticate with biometrics
+      const biometricResult = await authenticateWithBiometrics(
+        "Authenticate to view card details"
+      );
+
+      if (!biometricResult.success) {
+        console.log(
+          "[WidgetSDK] Biometric auth failed:",
+          biometricResult.error
+        );
+
+        const failedMessage: NativeBiometricFailedMessage = {
+          type: "native:biometric-failed",
+          payload: {
+            reason: biometricResult.error?.reason || "failed",
+            message: biometricResult.error?.message,
+          },
+        };
+
+        sendMessageToWidget(failedMessage);
+        return;
+      }
+
+      // Step 2: Generate session credentials
+      try {
+        console.log(
+          "[WidgetSDK] Biometric auth successful, generating session credentials..."
+        );
+
+        const { secretKeyHex, sessionId } = await generateSessionCredentials(
+          publicKey
+        );
+
+        console.log("[WidgetSDK] Session credentials generated successfully");
+
+        // Step 3: Send credentials to widget
+        const sessionMessage: NativeCardDetailsSessionMessage = {
+          type: "native:card-details-session",
+          payload: {
+            sessionId,
+            secretKey: secretKeyHex,
+          },
+        };
+
+        sendMessageToWidget(sessionMessage);
+      } catch (error) {
+        console.error(
+          "[WidgetSDK] Failed to generate session credentials:",
+          error
+        );
+
+        const failedMessage: NativeBiometricFailedMessage = {
+          type: "native:biometric-failed",
+          payload: {
+            reason: "failed",
+            message: "Failed to generate secure session",
+          },
+        };
+
+        sendMessageToWidget(failedMessage);
+      }
     };
 
     /**
@@ -286,8 +387,8 @@ const styles = StyleSheet.create({
   },
   loadingOverlay: {
     ...StyleSheet.absoluteFillObject,
-    backgroundColor: 'rgba(255, 255, 255, 0.9)',
-    justifyContent: 'center',
-    alignItems: 'center',
+    backgroundColor: "rgba(255, 255, 255, 0.9)",
+    justifyContent: "center",
+    alignItems: "center",
   },
 });

package/src/biometricUtils.ts

@@ -0,0 +1,189 @@
+/**
+ * Biometric Authentication Utilities
+ *
+ * Provides cross-platform biometric authentication for card details access.
+ * Supports Face ID, Touch ID, and Android biometrics.
+ *
+ * @requires react-native-biometrics - npm install react-native-biometrics
+ */
+
+import ReactNativeBiometrics, { BiometryTypes, type BiometryType } from 'react-native-biometrics';
+
+/**
+ * Result of a biometric authentication attempt
+ */
+export interface BiometricResult {
+  /** Whether authentication was successful */
+  success: boolean;
+  /** Error details if authentication failed */
+  error?: {
+    reason: 'cancelled' | 'failed' | 'not_available' | 'not_enrolled';
+    message?: string;
+  };
+}
+
+/**
+ * Information about biometric capabilities on the device
+ */
+export interface BiometricAvailability {
+  /** Whether any biometric authentication is available */
+  available: boolean;
+  /** The type of biometry available (FaceID, TouchID, Biometrics, or null) */
+  biometryType: BiometryType | null;
+}
+
+// Singleton instance of ReactNativeBiometrics
+const rnBiometrics = new ReactNativeBiometrics({
+  allowDeviceCredentials: false, // Only allow biometric, not PIN/password fallback
+});
+
+/**
+ * Checks if biometric authentication is available on the device
+ *
+ * @returns Object containing availability status and biometry type
+ */
+export async function isBiometricAvailable(): Promise<BiometricAvailability> {
+  try {
+    const { available, biometryType } = await rnBiometrics.isSensorAvailable();
+
+    return {
+      available,
+      biometryType: biometryType || null,
+    };
+  } catch (error) {
+    console.error('[BiometricUtils] Error checking biometric availability:', error);
+    return {
+      available: false,
+      biometryType: null,
+    };
+  }
+}
+
+/**
+ * Prompts the user for biometric authentication
+ *
+ * This function should be called before generating session credentials
+ * for viewing card details. It ensures proper user verification before
+ * accessing sensitive payment card information.
+ *
+ * @param promptMessage - Message to display in the biometric prompt
+ * @returns Result indicating success or failure with reason
+ *
+ * @example
+ * ```typescript
+ * const result = await authenticateWithBiometrics('Authenticate to view card details');
+ * if (result.success) {
+ *   // Proceed with generating session credentials
+ * } else {
+ *   // Handle failure based on result.error.reason
+ * }
+ * ```
+ */
+export async function authenticateWithBiometrics(
+  promptMessage: string = 'Authenticate to view card details'
+): Promise<BiometricResult> {
+  try {
+    // First check if biometrics are available
+    const { available, biometryType } = await rnBiometrics.isSensorAvailable();
+
+    if (!available) {
+      console.log('[BiometricUtils] Biometrics not available on device');
+      return {
+        success: false,
+        error: {
+          reason: 'not_available',
+          message: 'Biometric authentication is not available on this device',
+        },
+      };
+    }
+
+    // Check if biometrics are enrolled
+    const { keysExist } = await rnBiometrics.biometricKeysExist();
+
+    // Note: Even without keys, simplePrompt should work for basic authentication
+    // The keysExist check is more for cryptographic operations
+
+    console.log(
+      `[BiometricUtils] Attempting biometric auth. Type: ${biometryType}, Keys exist: ${keysExist}`
+    );
+
+    // Perform the biometric authentication
+    const { success, error } = await rnBiometrics.simplePrompt({
+      promptMessage,
+      cancelButtonText: 'Cancel',
+    });
+
+    if (success) {
+      console.log('[BiometricUtils] Biometric authentication successful');
+      return { success: true };
+    }
+
+    // Handle various failure reasons
+    console.log('[BiometricUtils] Biometric authentication failed:', error);
+
+    // Parse the error message to determine the reason
+    const errorMessage = error || 'Authentication failed';
+    let reason: NonNullable<BiometricResult['error']>['reason'] = 'failed';
+
+    if (
+      errorMessage.toLowerCase().includes('cancel') ||
+      errorMessage.toLowerCase().includes('user cancel')
+    ) {
+      reason = 'cancelled';
+    } else if (
+      errorMessage.toLowerCase().includes('not enrolled') ||
+      errorMessage.toLowerCase().includes('no fingerprint') ||
+      errorMessage.toLowerCase().includes('no face')
+    ) {
+      reason = 'not_enrolled';
+    } else if (
+      errorMessage.toLowerCase().includes('not available') ||
+      errorMessage.toLowerCase().includes('not supported')
+    ) {
+      reason = 'not_available';
+    }
+
+    return {
+      success: false,
+      error: {
+        reason,
+        message: errorMessage,
+      },
+    };
+  } catch (error) {
+    console.error('[BiometricUtils] Biometric authentication error:', error);
+
+    const errorMessage =
+      error instanceof Error ? error.message : 'Unknown error occurred';
+
+    return {
+      success: false,
+      error: {
+        reason: 'failed',
+        message: errorMessage,
+      },
+    };
+  }
+}
+
+/**
+ * Gets a user-friendly description of the biometric type
+ *
+ * @param biometryType - The biometry type from the device
+ * @returns Human-readable string for the biometry type
+ */
+export function getBiometryTypeLabel(biometryType: BiometryType | null): string {
+  switch (biometryType) {
+    case BiometryTypes.FaceID:
+      return 'Face ID';
+    case BiometryTypes.TouchID:
+      return 'Touch ID';
+    case BiometryTypes.Biometrics:
+      return 'Biometrics';
+    default:
+      return 'Biometric Authentication';
+  }
+}
+
+// Re-export BiometryTypes for convenience
+export { BiometryTypes };