@volr/react 0.1.67 → 0.1.68

package/dist/index.d.cts

@@ -823,4 +823,83 @@ declare function debugTransactionFailure(publicClient: PublicClient, failingWall
     analysis: string[];
 }>;
 
-export { type ApiResponse, type AuthRefreshResponseDto, type AuthResult, type BuildCallOptions, type ContractAnalysisResult, DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, type DepositAsset$1 as DepositAsset, type DepositConfig, type ERC20BalanceComparison, type Erc20Token$1 as Erc20Token, type EvmClient, type KeyStorageType, type MpcConnectionStep, type NetworkDto, type NetworkInfo, type PasskeyAdapterOptions, type PasskeyEnrollmentStep, type PrfInputDto, type SendBatchOverloads, type SendTxOptions, type SignerType, type SocialProvider, type TransactionDto, type TransactionStatus, type UseMpcConnectionReturn, type UsePasskeyEnrollmentReturn, type UseVolrAuthCallbackOptions, type UseVolrAuthCallbackReturn, type UseVolrLoginReturn, type UserDto, type VolrClient, type VolrConfig, type VolrContextValue, VolrProvider, type VolrUser, type WalletStateComparison, analyzeContractForEIP7702, buildCall, buildCalls, compareERC20Balances, compareWalletStates, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getWalletState, isEIP7702Delegated, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, useVolr, useVolrAuthCallback, useVolrContext, useVolrLogin };
+/**
+ * Passkey-specific error classes
+ */
+/**
+ * Error thrown when user cancels the passkey prompt
+ * This error should NOT trigger a retry
+ */
+declare class UserCancelledError extends Error {
+    readonly code = "USER_CANCELLED";
+    readonly isUserCancelled = true;
+    constructor(message?: string);
+}
+/**
+ * Error thrown when passkey is not found
+ */
+declare class PasskeyNotFoundError extends Error {
+    readonly code = "PASSKEY_NOT_FOUND";
+    constructor(message?: string);
+}
+/**
+ * Error thrown when PRF extension is not supported
+ */
+declare class PrfNotSupportedError extends Error {
+    readonly code = "PRF_NOT_SUPPORTED";
+    constructor(message?: string);
+}
+/**
+ * Check if an error is a user cancellation (should not retry)
+ */
+declare function isUserCancelledError(error: unknown): boolean;
+
+/**
+ * Platform compatibility check utilities
+ * Detects PRF extension support and provides guidance for cross-device authentication
+ */
+interface PlatformCheckResult {
+    /** Whether the current browser supports WebAuthn PRF extension */
+    prfSupported: boolean;
+    /** Whether cross-device authentication is available (QR code scanning) */
+    crossDeviceAvailable: boolean;
+    /** Human-readable message for users */
+    message?: string;
+    /** Platform name */
+    platform: string;
+    /** Browser name */
+    browser: string;
+}
+/**
+ * Check if the current browser/platform supports WebAuthn PRF extension
+ *
+ * PRF support matrix (as of 2024):
+ * - Chrome 109+: Supported on macOS, Windows, ChromeOS, Android
+ * - Safari 17.4+: Supported on macOS, iOS
+ * - Firefox 135+: Partial support
+ * - Edge: Follows Chrome
+ *
+ * Known issues:
+ * - iOS 17.0-18.3: PRF sync issues (recommended to use iOS 18.4+)
+ * - Windows Hello: May not support PRF (uses platform authenticator without hmac-secret)
+ * - Firefox Android: Not supported
+ */
+declare function checkPrfSupport(): PlatformCheckResult;
+/**
+ * Get a user-friendly message for passkey authentication guidance
+ *
+ * @param passkeyPlatform - The platform where the passkey was originally registered
+ * @returns User-friendly guidance message
+ */
+declare function getPasskeyAuthGuidance(passkeyPlatform?: string | null): string;
+/**
+ * Check if the browser supports the WebAuthn PRF extension
+ * This is a runtime check that attempts to detect actual PRF support
+ *
+ * Note: This function doesn't guarantee PRF will work - it only checks
+ * if the browser API supports the extension. The authenticator itself
+ * must also support the hmac-secret extension.
+ */
+declare function checkPrfExtensionAvailable(): Promise<boolean>;
+
+export { type ApiResponse, type AuthRefreshResponseDto, type AuthResult, type BuildCallOptions, type ContractAnalysisResult, DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, type DepositAsset$1 as DepositAsset, type DepositConfig, type ERC20BalanceComparison, type Erc20Token$1 as Erc20Token, type EvmClient, type KeyStorageType, type MpcConnectionStep, type NetworkDto, type NetworkInfo, type PasskeyAdapterOptions, type PasskeyEnrollmentStep, PasskeyNotFoundError, type PlatformCheckResult, type PrfInputDto, PrfNotSupportedError, type SendBatchOverloads, type SendTxOptions, type SignerType, type SocialProvider, type TransactionDto, type TransactionStatus, type UseMpcConnectionReturn, type UsePasskeyEnrollmentReturn, type UseVolrAuthCallbackOptions, type UseVolrAuthCallbackReturn, type UseVolrLoginReturn, UserCancelledError, type UserDto, type VolrClient, type VolrConfig, type VolrContextValue, VolrProvider, type VolrUser, type WalletStateComparison, analyzeContractForEIP7702, buildCall, buildCalls, checkPrfExtensionAvailable, checkPrfSupport, compareERC20Balances, compareWalletStates, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getPasskeyAuthGuidance, getWalletState, isEIP7702Delegated, isUserCancelledError, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, useVolr, useVolrAuthCallback, useVolrContext, useVolrLogin };

package/dist/index.d.ts

@@ -823,4 +823,83 @@ declare function debugTransactionFailure(publicClient: PublicClient, failingWall
     analysis: string[];
 }>;
 
-export { type ApiResponse, type AuthRefreshResponseDto, type AuthResult, type BuildCallOptions, type ContractAnalysisResult, DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, type DepositAsset$1 as DepositAsset, type DepositConfig, type ERC20BalanceComparison, type Erc20Token$1 as Erc20Token, type EvmClient, type KeyStorageType, type MpcConnectionStep, type NetworkDto, type NetworkInfo, type PasskeyAdapterOptions, type PasskeyEnrollmentStep, type PrfInputDto, type SendBatchOverloads, type SendTxOptions, type SignerType, type SocialProvider, type TransactionDto, type TransactionStatus, type UseMpcConnectionReturn, type UsePasskeyEnrollmentReturn, type UseVolrAuthCallbackOptions, type UseVolrAuthCallbackReturn, type UseVolrLoginReturn, type UserDto, type VolrClient, type VolrConfig, type VolrContextValue, VolrProvider, type VolrUser, type WalletStateComparison, analyzeContractForEIP7702, buildCall, buildCalls, compareERC20Balances, compareWalletStates, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getWalletState, isEIP7702Delegated, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, useVolr, useVolrAuthCallback, useVolrContext, useVolrLogin };
+/**
+ * Passkey-specific error classes
+ */
+/**
+ * Error thrown when user cancels the passkey prompt
+ * This error should NOT trigger a retry
+ */
+declare class UserCancelledError extends Error {
+    readonly code = "USER_CANCELLED";
+    readonly isUserCancelled = true;
+    constructor(message?: string);
+}
+/**
+ * Error thrown when passkey is not found
+ */
+declare class PasskeyNotFoundError extends Error {
+    readonly code = "PASSKEY_NOT_FOUND";
+    constructor(message?: string);
+}
+/**
+ * Error thrown when PRF extension is not supported
+ */
+declare class PrfNotSupportedError extends Error {
+    readonly code = "PRF_NOT_SUPPORTED";
+    constructor(message?: string);
+}
+/**
+ * Check if an error is a user cancellation (should not retry)
+ */
+declare function isUserCancelledError(error: unknown): boolean;
+
+/**
+ * Platform compatibility check utilities
+ * Detects PRF extension support and provides guidance for cross-device authentication
+ */
+interface PlatformCheckResult {
+    /** Whether the current browser supports WebAuthn PRF extension */
+    prfSupported: boolean;
+    /** Whether cross-device authentication is available (QR code scanning) */
+    crossDeviceAvailable: boolean;
+    /** Human-readable message for users */
+    message?: string;
+    /** Platform name */
+    platform: string;
+    /** Browser name */
+    browser: string;
+}
+/**
+ * Check if the current browser/platform supports WebAuthn PRF extension
+ *
+ * PRF support matrix (as of 2024):
+ * - Chrome 109+: Supported on macOS, Windows, ChromeOS, Android
+ * - Safari 17.4+: Supported on macOS, iOS
+ * - Firefox 135+: Partial support
+ * - Edge: Follows Chrome
+ *
+ * Known issues:
+ * - iOS 17.0-18.3: PRF sync issues (recommended to use iOS 18.4+)
+ * - Windows Hello: May not support PRF (uses platform authenticator without hmac-secret)
+ * - Firefox Android: Not supported
+ */
+declare function checkPrfSupport(): PlatformCheckResult;
+/**
+ * Get a user-friendly message for passkey authentication guidance
+ *
+ * @param passkeyPlatform - The platform where the passkey was originally registered
+ * @returns User-friendly guidance message
+ */
+declare function getPasskeyAuthGuidance(passkeyPlatform?: string | null): string;
+/**
+ * Check if the browser supports the WebAuthn PRF extension
+ * This is a runtime check that attempts to detect actual PRF support
+ *
+ * Note: This function doesn't guarantee PRF will work - it only checks
+ * if the browser API supports the extension. The authenticator itself
+ * must also support the hmac-secret extension.
+ */
+declare function checkPrfExtensionAvailable(): Promise<boolean>;
+
+export { type ApiResponse, type AuthRefreshResponseDto, type AuthResult, type BuildCallOptions, type ContractAnalysisResult, DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, type DepositAsset$1 as DepositAsset, type DepositConfig, type ERC20BalanceComparison, type Erc20Token$1 as Erc20Token, type EvmClient, type KeyStorageType, type MpcConnectionStep, type NetworkDto, type NetworkInfo, type PasskeyAdapterOptions, type PasskeyEnrollmentStep, PasskeyNotFoundError, type PlatformCheckResult, type PrfInputDto, PrfNotSupportedError, type SendBatchOverloads, type SendTxOptions, type SignerType, type SocialProvider, type TransactionDto, type TransactionStatus, type UseMpcConnectionReturn, type UsePasskeyEnrollmentReturn, type UseVolrAuthCallbackOptions, type UseVolrAuthCallbackReturn, type UseVolrLoginReturn, UserCancelledError, type UserDto, type VolrClient, type VolrConfig, type VolrContextValue, VolrProvider, type VolrUser, type WalletStateComparison, analyzeContractForEIP7702, buildCall, buildCalls, checkPrfExtensionAvailable, checkPrfSupport, compareERC20Balances, compareWalletStates, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getPasskeyAuthGuidance, getWalletState, isEIP7702Delegated, isUserCancelledError, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, useVolr, useVolrAuthCallback, useVolrContext, useVolrLogin };

package/dist/index.js

@@ -9478,6 +9478,52 @@ var PUBKEY_CRED_PARAMS = [
 ];
 var ATTESTATION = "direct";
 
+// src/errors/passkey-errors.ts
+var UserCancelledError = class _UserCancelledError extends Error {
+  constructor(message) {
+    super(message || "User cancelled the passkey authentication");
+    this.code = "USER_CANCELLED";
+    this.isUserCancelled = true;
+    this.name = "UserCancelledError";
+    Object.setPrototypeOf(this, _UserCancelledError.prototype);
+  }
+};
+var PasskeyNotFoundError = class _PasskeyNotFoundError extends Error {
+  constructor(message) {
+    super(message || "Passkey not found. Please re-enroll your passkey.");
+    this.code = "PASSKEY_NOT_FOUND";
+    this.name = "PasskeyNotFoundError";
+    Object.setPrototypeOf(this, _PasskeyNotFoundError.prototype);
+  }
+};
+var PrfNotSupportedError = class _PrfNotSupportedError extends Error {
+  constructor(message) {
+    super(
+      message || "WebAuthn PRF extension is not supported by this browser or device. Please use a browser that supports WebAuthn PRF extension."
+    );
+    this.code = "PRF_NOT_SUPPORTED";
+    this.name = "PrfNotSupportedError";
+    Object.setPrototypeOf(this, _PrfNotSupportedError.prototype);
+  }
+};
+function isUserCancelledError(error) {
+  if (error instanceof UserCancelledError) {
+    return true;
+  }
+  if (error instanceof Error) {
+    if (error.name === "NotAllowedError") {
+      return true;
+    }
+    if (error.isUserCancelled === true) {
+      return true;
+    }
+    if (error.message.includes("cancelled") || error.message.includes("denied")) {
+      return true;
+    }
+  }
+  return false;
+}
+
 // src/adapters/passkey.ts
 function createPasskeyAdapter(options = {}) {
   const rpId = options.rpId || (typeof window !== "undefined" ? window.location.hostname : "localhost");
@@ -9606,16 +9652,18 @@ function createPasskeyAdapter(options = {}) {
         console.error("[PasskeyAdapter] Error name:", error?.name);
         console.error("[PasskeyAdapter] Error message:", error?.message);
         if (error?.name === "NotAllowedError") {
-          throw new Error(
-            "[PasskeyAdapter] User cancelled the passkey prompt or authentication was denied. Please try again and complete the authentication."
+          throw new UserCancelledError(
+            "User cancelled the passkey prompt or authentication was denied."
           );
-        } else if (error?.name === "NotFoundError" || error?.name === "InvalidStateError") {
-          throw new Error(
-            "[PasskeyAdapter] No passkey found matching the provided credentialId. This may happen if the passkey was deleted or the credentialId is incorrect. Please re-enroll your passkey."
+        }
+        if (error?.name === "NotFoundError" || error?.name === "InvalidStateError") {
+          throw new PasskeyNotFoundError(
+            "No passkey found matching the provided credentialId. This may happen if the passkey was deleted or the credentialId is incorrect."
           );
-        } else if (error?.name === "NotSupportedError") {
-          throw new Error(
-            "[PasskeyAdapter] WebAuthn PRF extension is not supported by this browser or device. Please use a browser that supports WebAuthn PRF extension (Chrome 108+, Edge 108+, Safari 16.4+)."
+        }
+        if (error?.name === "NotSupportedError") {
+          throw new PrfNotSupportedError(
+            "WebAuthn PRF extension is not supported by this browser or device. Please use a browser that supports WebAuthn PRF extension (Chrome 108+, Edge 108+, Safari 16.4+)."
           );
         }
         throw new Error(
@@ -18069,7 +18117,14 @@ async function resolveSigner(input) {
     return { signer: explicitSigner, activeProvider: null };
   }
   if (provider) {
-    await provider.ensureSession({ interactive: true, force: true });
+    try {
+      await provider.ensureSession({ interactive: true });
+    } catch (error) {
+      if (isUserCancelledError(error)) {
+        throw error;
+      }
+      throw error;
+    }
     const signerContext = {
       provider,
       chainId,
@@ -18088,7 +18143,14 @@ async function resolveSigner(input) {
       credentialId: user.credentialId
     });
     await setProvider(restoredProvider);
-    await restoredProvider.ensureSession({ interactive: true, force: true });
+    try {
+      await restoredProvider.ensureSession({ interactive: true });
+    } catch (error) {
+      if (isUserCancelledError(error)) {
+        throw error;
+      }
+      throw error;
+    }
     const signerContext = {
       provider: restoredProvider,
       chainId,
@@ -18893,6 +18955,16 @@ function detectPlatform() {
   }
   return "Unknown";
 }
+function buildDisplayName(userEmail, userEvmAddress, userId) {
+  if (userEmail) {
+    return userEmail;
+  }
+  if (userEvmAddress) {
+    const short = `${userEvmAddress.slice(0, 6)}...${userEvmAddress.slice(-4)}`;
+    return `Volr (${short})`;
+  }
+  return userId || "Volr Wallet";
+}
 async function enrollPasskey(params) {
   const {
     client,
@@ -18931,7 +19003,7 @@ async function enrollPasskey(params) {
     credentialId: tempCredentialId
   };
   const prfSalt = deriveWrapKey(tempPrfInput);
-  const displayName = userEmail || userEvmAddress || userId;
+  const displayName = buildDisplayName(userEmail, userEvmAddress, userId);
   const publicKeyCredentialCreationOptions = {
     challenge: challenge2,
     rp: {
@@ -19509,6 +19581,159 @@ async function debugTransactionFailure(publicClient, failingWallet, workingWalle
     analysis
   };
 }
+
+// src/utils/platform-check.ts
+function detectPlatform2() {
+  if (typeof navigator === "undefined") return "Unknown";
+  const ua = navigator.userAgent;
+  const platform = navigator.platform || "";
+  if (/iPhone|iPad|iPod/.test(ua) || platform === "MacIntel" && navigator.maxTouchPoints > 1) {
+    return "iOS";
+  }
+  if (/Android/.test(ua)) {
+    return "Android";
+  }
+  if (/Mac/.test(platform)) {
+    return "macOS";
+  }
+  if (/Win/.test(platform)) {
+    return "Windows";
+  }
+  if (/CrOS/.test(ua)) {
+    return "ChromeOS";
+  }
+  if (/Linux/.test(platform)) {
+    return "Linux";
+  }
+  return "Unknown";
+}
+function detectBrowser() {
+  if (typeof navigator === "undefined") return "Unknown";
+  const ua = navigator.userAgent;
+  if (/Edg/.test(ua)) return "Edge";
+  if (/Chrome/.test(ua) && !/Chromium/.test(ua)) return "Chrome";
+  if (/Safari/.test(ua) && !/Chrome/.test(ua)) return "Safari";
+  if (/Firefox/.test(ua)) return "Firefox";
+  if (/Opera|OPR/.test(ua)) return "Opera";
+  return "Unknown";
+}
+function checkPrfSupport() {
+  const platform = detectPlatform2();
+  const browser = detectBrowser();
+  if (typeof navigator === "undefined" || !navigator.credentials) {
+    return {
+      prfSupported: false,
+      crossDeviceAvailable: false,
+      message: "WebAuthn is not supported in this environment.",
+      platform,
+      browser
+    };
+  }
+  let prfSupported = false;
+  let message;
+  switch (platform) {
+    case "iOS":
+      if (browser === "Safari") {
+        prfSupported = true;
+      } else {
+        prfSupported = true;
+      }
+      break;
+    case "Android":
+      if (browser === "Chrome" || browser === "Edge") {
+        prfSupported = true;
+      } else if (browser === "Firefox") {
+        prfSupported = false;
+        message = "Firefox on Android does not support passkey encryption. Please use Chrome.";
+      } else {
+        prfSupported = true;
+      }
+      break;
+    case "macOS":
+      if (browser === "Safari" || browser === "Chrome" || browser === "Edge") {
+        prfSupported = true;
+      } else if (browser === "Firefox") {
+        prfSupported = false;
+        message = "Firefox may not support passkey encryption. Please use Safari or Chrome.";
+      } else {
+        prfSupported = true;
+      }
+      break;
+    case "Windows":
+      if (browser === "Chrome" || browser === "Edge") {
+        prfSupported = true;
+        message = "If your device does not support passkey encryption, you can use your mobile device by scanning a QR code.";
+      } else {
+        prfSupported = false;
+        message = "Please use Chrome or Edge for passkey encryption support.";
+      }
+      break;
+    case "ChromeOS":
+      prfSupported = true;
+      break;
+    case "Linux":
+      if (browser === "Chrome" || browser === "Edge") {
+        prfSupported = true;
+        message = "If your device does not support passkey encryption, you can use your mobile device by scanning a QR code.";
+      } else {
+        prfSupported = false;
+        message = "Please use Chrome for passkey encryption support.";
+      }
+      break;
+    default:
+      prfSupported = false;
+      message = "Unknown platform. Passkey encryption may not be supported.";
+  }
+  const crossDeviceAvailable = true;
+  return {
+    prfSupported,
+    crossDeviceAvailable,
+    message,
+    platform,
+    browser
+  };
+}
+function getPasskeyAuthGuidance(passkeyPlatform) {
+  const { platform: currentPlatform, prfSupported } = checkPrfSupport();
+  if (prfSupported && (!passkeyPlatform || passkeyPlatform === currentPlatform)) {
+    return "";
+  }
+  if (passkeyPlatform && passkeyPlatform !== currentPlatform) {
+    const platformDisplayName = getPlatformDisplayName(passkeyPlatform);
+    return `Your passkey was registered on ${platformDisplayName}. You can use your ${platformDisplayName} device to authenticate by scanning a QR code.`;
+  }
+  if (!prfSupported) {
+    return "This device may not support passkey encryption. You can use your mobile device by scanning a QR code.";
+  }
+  return "";
+}
+function getPlatformDisplayName(platform) {
+  const displayNames = {
+    iOS: "iPhone/iPad",
+    Android: "Android",
+    macOS: "Mac",
+    Windows: "Windows PC",
+    ChromeOS: "Chromebook",
+    Linux: "Linux"
+  };
+  return displayNames[platform] || platform;
+}
+async function checkPrfExtensionAvailable() {
+  if (typeof PublicKeyCredential === "undefined") {
+    return false;
+  }
+  if ("getClientCapabilities" in PublicKeyCredential) {
+    try {
+      const capabilities = await PublicKeyCredential.getClientCapabilities();
+      if (capabilities && typeof capabilities.extensions?.prf === "boolean") {
+        return capabilities.extensions.prf;
+      }
+    } catch {
+    }
+  }
+  const { prfSupported } = checkPrfSupport();
+  return prfSupported;
+}
 /*! Bundled license information:
 
 @noble/hashes/esm/utils.js:
@@ -19523,6 +19748,6 @@ async function debugTransactionFailure(publicClient, failingWallet, workingWalle
   (*! noble-curves - MIT License (c) 2022 Paul Miller (paulmillr.com) *)
 */
 
-export { DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, VolrProvider, analyzeContractForEIP7702, buildCall, buildCalls, compareERC20Balances, compareWalletStates, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getWalletState, isEIP7702Delegated, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, useVolr, useVolrAuthCallback, useVolrContext, useVolrLogin };
+export { DEFAULT_EXPIRES_IN_SEC, DEFAULT_MODE, PasskeyNotFoundError, PrfNotSupportedError, UserCancelledError, VolrProvider, analyzeContractForEIP7702, buildCall, buildCalls, checkPrfExtensionAvailable, checkPrfSupport, compareERC20Balances, compareWalletStates, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getPasskeyAuthGuidance, getWalletState, isEIP7702Delegated, isUserCancelledError, normalizeHex, normalizeHexArray, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, useVolr, useVolrAuthCallback, useVolrContext, useVolrLogin };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map