@volr/react 0.1.90 → 0.1.92

package/dist/index.d.cts

@@ -96,9 +96,11 @@ declare class APIClient {
 /**
  * PRF Input DTO
  * Input parameters for WebAuthn PRF extension
+ *
+ * Note: origin is NOT included for cross-domain wallet support.
+ * WebAuthn's rpId binding provides domain security.
  */
 interface PrfInputDto {
-    origin: string;
     projectId: string;
     credentialId: string;
     salt?: Uint8Array;
@@ -109,6 +111,8 @@ interface PrfInputDto {
  */
 interface UserDto {
     id: string;
+    projectId: string;
+    projectName: string;
     email: string;
     accountId?: string;
     evmAddress?: `0x${string}`;
@@ -198,6 +202,8 @@ interface DepositConfig {
  */
 interface VolrUser {
     id?: string;
+    projectId?: string;
+    projectName?: string;
     email?: string;
     accountId?: string;
     evmAddress?: `0x${string}`;
@@ -999,4 +1005,140 @@ declare function getPasskeyAuthGuidance(passkeyPlatform?: string | null): string
  */
 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 SiweSession, type SiweSessionStatus, 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 };
+/**
+ * Passkey migration (headless)
+ * Cross-domain wallet migration using postMessage
+ */
+
+interface MigrationRequestParams {
+    /** APIClient instance */
+    client: APIClient;
+    /** Target domain to migrate to */
+    targetOrigin: string;
+}
+interface MigrationRequestResult {
+    /** Migration token from backend */
+    migrationToken: string;
+    /** Target origin confirmed by backend */
+    targetOrigin: string;
+    /** Token expiration timestamp */
+    expiresAt: number;
+}
+interface MigrationCompleteParams {
+    /** APIClient instance */
+    client: APIClient;
+    /** Base URL for API calls */
+    baseUrl: string;
+    /** Project API key */
+    apiKey: string;
+    /** User ID */
+    userId: string;
+    /** Project ID */
+    projectId: string;
+    /** Migration token from source domain */
+    migrationToken: string;
+    /** Master seed from source domain (decrypted) */
+    masterSeed: Uint8Array;
+    /**
+     * WebAuthn rpId for this domain
+     * @default window.location.hostname
+     */
+    rpId?: string;
+    /** Relying Party Name */
+    rpName?: string;
+    /** User email (for WebAuthn displayName) */
+    userEmail?: string | null;
+}
+interface MigrationCompleteResult {
+    /** New credential ID */
+    credentialId: string;
+    /** New blob URL */
+    blobUrl: string;
+    /** rpId used for registration */
+    rpId: string;
+}
+interface MigrationSeedRequest {
+    type: 'VOLR_MIGRATION_SEED_REQUEST';
+    migrationToken: string;
+}
+interface MigrationSeedResponse {
+    type: 'VOLR_MIGRATION_SEED_RESPONSE';
+    masterSeed: number[];
+    userId: string;
+    projectId: string;
+}
+interface MigrationError {
+    type: 'VOLR_MIGRATION_ERROR';
+    code: string;
+    message: string;
+}
+type MigrationMessage = MigrationSeedRequest | MigrationSeedResponse | MigrationError;
+/**
+ * Request migration token from backend
+ * Called on the source domain to initiate migration
+ */
+declare function requestMigration(params: MigrationRequestParams): Promise<MigrationRequestResult>;
+/**
+ * Open target domain popup for migration
+ * Called on the source domain after getting migration token
+ *
+ * @param targetOrigin - Target domain URL
+ * @param migrationToken - Token from requestMigration
+ * @param migrationPath - Path on target domain for migration (default: /wallet/migrate)
+ * @returns Window reference to the popup
+ */
+declare function openMigrationPopup(targetOrigin: string, migrationToken: string, migrationPath?: string): Window | null;
+/**
+ * Handle seed request from target domain
+ * Called on source domain when popup requests the master seed
+ *
+ * @param masterSeed - Decrypted master seed
+ * @param userId - User ID
+ * @param projectId - Project ID
+ * @param targetOrigin - Target origin (for postMessage security)
+ * @param popup - Reference to the popup window
+ */
+declare function sendSeedToPopup(masterSeed: Uint8Array, userId: string, projectId: string, targetOrigin: string, popup: Window): void;
+/**
+ * Listen for seed requests from target domain
+ * Set up message listener on source domain
+ *
+ * @param allowedOrigins - List of allowed target origins
+ * @param getMasterSeed - Callback to get decrypted master seed (may trigger WebAuthn)
+ * @param getUserInfo - Callback to get user info
+ * @returns Cleanup function to remove listener
+ */
+declare function listenForSeedRequests(allowedOrigins: string[], getMasterSeed: () => Promise<Uint8Array>, getUserInfo: () => {
+    userId: string;
+    projectId: string;
+}): () => void;
+/**
+ * Request master seed from source domain
+ * Called on target domain (in popup)
+ *
+ * @param sourceOrigin - Source domain origin
+ * @param migrationToken - Migration token
+ * @param timeout - Timeout in milliseconds (default: 60000)
+ * @returns Master seed and user info from source domain
+ */
+declare function requestSeedFromOpener(sourceOrigin: string, migrationToken: string, timeout?: number): Promise<{
+    masterSeed: Uint8Array;
+    userId: string;
+    projectId: string;
+}>;
+/**
+ * Complete migration on target domain
+ * Creates new passkey, encrypts master seed, and registers with backend
+ */
+declare function completeMigration(params: MigrationCompleteParams): Promise<MigrationCompleteResult>;
+/**
+ * Get all user credentials from backend
+ */
+declare function getUserCredentials(client: APIClient): Promise<Array<{
+    rpId: string;
+    credentialId: string;
+    platform: string | null;
+    createdAt: 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 MigrationCompleteParams, type MigrationCompleteResult, type MigrationError, type MigrationMessage, type MigrationRequestParams, type MigrationRequestResult, type MigrationSeedRequest, type MigrationSeedResponse, type MpcConnectionStep, type NetworkDto, type NetworkInfo, type PasskeyAdapterOptions, type PasskeyEnrollmentStep, PasskeyNotFoundError, type PlatformCheckResult, type PrfInputDto, PrfNotSupportedError, type SendBatchOverloads, type SendTxOptions, type SignerType, type SiweSession, type SiweSessionStatus, 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, completeMigration, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getPasskeyAuthGuidance, getUserCredentials, getWalletState, isEIP7702Delegated, isUserCancelledError, listenForSeedRequests, normalizeHex, normalizeHexArray, openMigrationPopup, requestMigration, requestSeedFromOpener, sendSeedToPopup, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, useVolr, useVolrAuthCallback, useVolrContext, useVolrLogin };

package/dist/index.d.ts

@@ -96,9 +96,11 @@ declare class APIClient {
 /**
  * PRF Input DTO
  * Input parameters for WebAuthn PRF extension
+ *
+ * Note: origin is NOT included for cross-domain wallet support.
+ * WebAuthn's rpId binding provides domain security.
  */
 interface PrfInputDto {
-    origin: string;
     projectId: string;
     credentialId: string;
     salt?: Uint8Array;
@@ -109,6 +111,8 @@ interface PrfInputDto {
  */
 interface UserDto {
     id: string;
+    projectId: string;
+    projectName: string;
     email: string;
     accountId?: string;
     evmAddress?: `0x${string}`;
@@ -198,6 +202,8 @@ interface DepositConfig {
  */
 interface VolrUser {
     id?: string;
+    projectId?: string;
+    projectName?: string;
     email?: string;
     accountId?: string;
     evmAddress?: `0x${string}`;
@@ -999,4 +1005,140 @@ declare function getPasskeyAuthGuidance(passkeyPlatform?: string | null): string
  */
 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 SiweSession, type SiweSessionStatus, 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 };
+/**
+ * Passkey migration (headless)
+ * Cross-domain wallet migration using postMessage
+ */
+
+interface MigrationRequestParams {
+    /** APIClient instance */
+    client: APIClient;
+    /** Target domain to migrate to */
+    targetOrigin: string;
+}
+interface MigrationRequestResult {
+    /** Migration token from backend */
+    migrationToken: string;
+    /** Target origin confirmed by backend */
+    targetOrigin: string;
+    /** Token expiration timestamp */
+    expiresAt: number;
+}
+interface MigrationCompleteParams {
+    /** APIClient instance */
+    client: APIClient;
+    /** Base URL for API calls */
+    baseUrl: string;
+    /** Project API key */
+    apiKey: string;
+    /** User ID */
+    userId: string;
+    /** Project ID */
+    projectId: string;
+    /** Migration token from source domain */
+    migrationToken: string;
+    /** Master seed from source domain (decrypted) */
+    masterSeed: Uint8Array;
+    /**
+     * WebAuthn rpId for this domain
+     * @default window.location.hostname
+     */
+    rpId?: string;
+    /** Relying Party Name */
+    rpName?: string;
+    /** User email (for WebAuthn displayName) */
+    userEmail?: string | null;
+}
+interface MigrationCompleteResult {
+    /** New credential ID */
+    credentialId: string;
+    /** New blob URL */
+    blobUrl: string;
+    /** rpId used for registration */
+    rpId: string;
+}
+interface MigrationSeedRequest {
+    type: 'VOLR_MIGRATION_SEED_REQUEST';
+    migrationToken: string;
+}
+interface MigrationSeedResponse {
+    type: 'VOLR_MIGRATION_SEED_RESPONSE';
+    masterSeed: number[];
+    userId: string;
+    projectId: string;
+}
+interface MigrationError {
+    type: 'VOLR_MIGRATION_ERROR';
+    code: string;
+    message: string;
+}
+type MigrationMessage = MigrationSeedRequest | MigrationSeedResponse | MigrationError;
+/**
+ * Request migration token from backend
+ * Called on the source domain to initiate migration
+ */
+declare function requestMigration(params: MigrationRequestParams): Promise<MigrationRequestResult>;
+/**
+ * Open target domain popup for migration
+ * Called on the source domain after getting migration token
+ *
+ * @param targetOrigin - Target domain URL
+ * @param migrationToken - Token from requestMigration
+ * @param migrationPath - Path on target domain for migration (default: /wallet/migrate)
+ * @returns Window reference to the popup
+ */
+declare function openMigrationPopup(targetOrigin: string, migrationToken: string, migrationPath?: string): Window | null;
+/**
+ * Handle seed request from target domain
+ * Called on source domain when popup requests the master seed
+ *
+ * @param masterSeed - Decrypted master seed
+ * @param userId - User ID
+ * @param projectId - Project ID
+ * @param targetOrigin - Target origin (for postMessage security)
+ * @param popup - Reference to the popup window
+ */
+declare function sendSeedToPopup(masterSeed: Uint8Array, userId: string, projectId: string, targetOrigin: string, popup: Window): void;
+/**
+ * Listen for seed requests from target domain
+ * Set up message listener on source domain
+ *
+ * @param allowedOrigins - List of allowed target origins
+ * @param getMasterSeed - Callback to get decrypted master seed (may trigger WebAuthn)
+ * @param getUserInfo - Callback to get user info
+ * @returns Cleanup function to remove listener
+ */
+declare function listenForSeedRequests(allowedOrigins: string[], getMasterSeed: () => Promise<Uint8Array>, getUserInfo: () => {
+    userId: string;
+    projectId: string;
+}): () => void;
+/**
+ * Request master seed from source domain
+ * Called on target domain (in popup)
+ *
+ * @param sourceOrigin - Source domain origin
+ * @param migrationToken - Migration token
+ * @param timeout - Timeout in milliseconds (default: 60000)
+ * @returns Master seed and user info from source domain
+ */
+declare function requestSeedFromOpener(sourceOrigin: string, migrationToken: string, timeout?: number): Promise<{
+    masterSeed: Uint8Array;
+    userId: string;
+    projectId: string;
+}>;
+/**
+ * Complete migration on target domain
+ * Creates new passkey, encrypts master seed, and registers with backend
+ */
+declare function completeMigration(params: MigrationCompleteParams): Promise<MigrationCompleteResult>;
+/**
+ * Get all user credentials from backend
+ */
+declare function getUserCredentials(client: APIClient): Promise<Array<{
+    rpId: string;
+    credentialId: string;
+    platform: string | null;
+    createdAt: 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 MigrationCompleteParams, type MigrationCompleteResult, type MigrationError, type MigrationMessage, type MigrationRequestParams, type MigrationRequestResult, type MigrationSeedRequest, type MigrationSeedResponse, type MpcConnectionStep, type NetworkDto, type NetworkInfo, type PasskeyAdapterOptions, type PasskeyEnrollmentStep, PasskeyNotFoundError, type PlatformCheckResult, type PrfInputDto, PrfNotSupportedError, type SendBatchOverloads, type SendTxOptions, type SignerType, type SiweSession, type SiweSessionStatus, 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, completeMigration, createGetNetworkInfo, createPasskeyAdapter, debugTransactionFailure, defaultIdempotencyKey, diagnoseTransactionFailure, getERC20Balance, getPasskeyAuthGuidance, getUserCredentials, getWalletState, isEIP7702Delegated, isUserCancelledError, listenForSeedRequests, normalizeHex, normalizeHexArray, openMigrationPopup, requestMigration, requestSeedFromOpener, sendSeedToPopup, uploadBlobViaPresign, useDepositListener, useInternalAuth, useMpcConnection, usePasskeyEnrollment, useVolr, useVolrAuthCallback, useVolrContext, useVolrLogin };