@spacesops/wdk-react-native-core 1.0.0-beta.40

package/dist/services/walletSetupService.js

@@ -0,0 +1,535 @@
+import { getWorkletStore, getCachedCredentials, setCachedCredentials, clearCredentialsCache as clearWorkletCredentialsCache } from '../store/workletStore';
+import { WorkletLifecycleService } from './workletLifecycleService';
+import { DEFAULT_MNEMONIC_WORD_COUNT } from '../utils/constants';
+import { log, logError } from '../utils/logger';
+/**
+ * Wallet setup service
+ * Handles creating new wallets and loading existing wallets with biometric authentication
+ * Caches credentials in ephemeral memory to avoid repeated biometric prompts
+ *
+ * ## Biometric Authentication Lifecycle
+ *
+ * ### When Biometric Authentication is Required
+ *
+ * 1. **Creating a new wallet** (`createNewWallet`)
+ *   - Always requires biometric authentication before wallet creation
+ *   - Ensures only authorized users can create wallets
+ *   - Credentials are cached after successful authentication
+ *
+ * 2. **Loading existing wallet** (`loadExistingWallet`)
+ *   - Requires biometric authentication if credentials are not cached
+ *   - If credentials are in cache, authentication is skipped (better UX)
+ *   - Cache is checked first before prompting for biometrics
+ *
+ * 3. **Importing wallet from mnemonic** (`initializeFromMnemonic`)
+ *   - Always requires biometric authentication before import
+ *   - Ensures only authorized users can import wallets
+ *   - Credentials are cached after successful authentication
+ *
+ * ### Credential Caching Behavior
+ *
+ * - **Cache Location**: Ephemeral memory only (Map<string, CachedCredentials>)
+ *   - Cache is keyed by `identifier` (user email/ID) for multi-wallet support
+ *   - Cache persists for the lifetime of the app session
+ *   - Cache is cleared when app is terminated (not persisted to disk)
+ *
+ * - **Cache Contents**:
+ *   - `encryptionKey`: Cached after first retrieval (most sensitive, requires biometrics)
+ *   - `encryptedSeed`: Cached after first retrieval
+ *   - `encryptedEntropy`: Cached after first retrieval
+ *
+ * - **Cache Benefits**:
+ *   - Avoids repeated biometric prompts during the same app session
+ *   - Improves UX for operations that need credentials multiple times
+ *   - Reduces security surface (fewer biometric prompts = fewer attack vectors)
+ *
+ * ### When Cache is Cleared
+ *
+ * Cache is automatically cleared in the following scenarios:
+ *
+ * 1. **Explicit cache clearing** (`clearCredentialsCache`)
+ *   - Called when wallet data is corrupted or invalid
+ *   - Called during wallet deletion
+ *   - Can be called manually for security (e.g., on logout)
+ *
+ * 2. **App termination**
+ *   - Cache is in-memory only, so it's cleared when app closes
+ *   - Next app launch will require biometric authentication again
+ *
+ * 3. **Wallet deletion** (`deleteWallet`)
+ *   - Cache for the deleted wallet identifier is cleared
+ *   - Other wallet caches remain intact
+ *
+ * ### Security Considerations
+ *
+ * - **Cache Lifetime**: Ephemeral (in-memory only, cleared on app termination)
+ * - **Cache Scope**: Per-identifier (multi-wallet support)
+ * - **Cache Invalidation**: Manual via `clearCredentialsCache()` or automatic on app termination
+ * - **Biometric Prompt Frequency**:
+ *   - First access per app session: Always required
+ *   - Subsequent accesses in same session: Cached (no prompt)
+ *   - After app restart: Always required again
+ *
+ * ### Best Practices
+ *
+ * 1. **Clear cache on logout**: Call `clearCredentialsCache(identifier)` when user logs out
+ * 2. **Clear cache on errors**: Clear cache if decryption fails (may indicate corrupted data)
+ * 3. **Don't persist cache**: Cache is intentionally in-memory only for security
+ * 4. **Handle cache misses**: Always handle the case where cache is empty (will prompt for biometrics)
+ *
+ * ### Example Usage
+ *
+ * ```typescript
+ * // Create new wallet (always requires biometrics)
+ * await WalletSetupService.createNewWallet(networkConfigs, walletId)
+ *
+ * // Load existing wallet (biometrics only if not cached)
+ * const credentials = await WalletSetupService.loadExistingWallet(walletId)
+ *
+ * // Clear cache (e.g., on logout)
+ * WalletSetupService.clearCredentialsCache(walletId)
+ * ```
+ */
+export class WalletSetupService {
+    /**
+     * Set the secureStorage singleton instance
+     * Called by WdkAppProvider during initialization
+     * Also exposed publicly for testing purposes
+     *
+     * @param secureStorage - SecureStorage instance to use
+     * @param allowOverwrite - If false, warns when overwriting existing instance (default: true)
+     */
+    static setSecureStorage(secureStorage, allowOverwrite = true) {
+        if (this.secureStorageInstance && !allowOverwrite) {
+            log('⚠️ SecureStorage already set. This may indicate multiple WdkAppProviders are mounted.', {
+                hasExisting: !!this.secureStorageInstance
+            });
+        }
+        else if (this.secureStorageInstance) {
+            log('⚠️ SecureStorage being overwritten. This may indicate multiple WdkAppProviders are mounted.');
+        }
+        this.secureStorageInstance = secureStorage;
+        log('✅ SecureStorage singleton set in WalletSetupService');
+    }
+    /**
+     * Get the secureStorage singleton instance
+     * Throws error if not initialized (should only happen if called before WdkAppProvider mounts)
+     */
+    static getSecureStorage() {
+        if (!this.secureStorageInstance) {
+            throw new Error('SecureStorage not initialized. Ensure WdkAppProvider is mounted.');
+        }
+        return this.secureStorageInstance;
+    }
+    /**
+     * Check if secureStorage is initialized
+     * Useful for testing or debugging
+     */
+    static isSecureStorageInitialized() {
+        return this.secureStorageInstance !== null;
+    }
+    /**
+     * Get cache key for walletId
+     */
+    static getCacheKey(walletId) {
+        return walletId || 'default';
+    }
+    /**
+     * Cache credentials after retrieval
+     */
+    static cacheCredentials(walletId, encryptionKey, encryptedSeed, encryptedEntropy) {
+        const cacheKey = this.getCacheKey(walletId);
+        const existing = getCachedCredentials(cacheKey) || {};
+        // Use workletStore functions for all credential caching
+        setCachedCredentials(cacheKey, {
+            ...existing,
+            ...(encryptionKey && { encryptionKey }),
+            ...(encryptedSeed && { encryptedSeed }),
+            ...(encryptedEntropy && { encryptedEntropy }),
+        });
+        log('Credentials cached', { hasWalletId: !!walletId });
+    }
+    /**
+     * Generic helper to retrieve a credential value (checks cache first, then secureStorage)
+     */
+    static async getCredential(walletId, credentialType, fetchFn, cacheKey) {
+        const secureStorage = this.getSecureStorage();
+        const cacheKeyStr = this.getCacheKey(walletId);
+        const cached = getCachedCredentials(cacheKeyStr);
+        if (cached?.[cacheKey]) {
+            const logMessage = credentialType === 'encryptionKey'
+                ? '✅ Encryption key retrieved from cache (no biometrics needed)'
+                : `✅ ${credentialType} retrieved from cache`;
+            log(logMessage);
+            return cached[cacheKey];
+        }
+        if (credentialType === 'encryptionKey') {
+            log('Encryption key not in cache, fetching from secureStorage...');
+        }
+        const value = await fetchFn(walletId);
+        if (value) {
+            // Cache it for future use
+            if (credentialType === 'encryptionKey') {
+                this.cacheCredentials(walletId, value);
+            }
+            else if (credentialType === 'encryptedSeed') {
+                this.cacheCredentials(walletId, undefined, value);
+            }
+            else {
+                this.cacheCredentials(walletId, undefined, undefined, value);
+            }
+        }
+        return value;
+    }
+    /**
+     * Validate that encrypted data can be decrypted with the encryption key
+     * Attempts to initialize WDK with the provided credentials to verify compatibility
+     *
+     * @param networkConfigs - Network configurations for worklet
+     * @param encryptionKey - Encryption key to test
+     * @param encryptedSeed - Encrypted seed to test
+     * @param encryptedEntropy - Optional encrypted entropy to test
+     * @throws Error if validation fails (decryption fails)
+     */
+    static async validateEncryptionCompatibility(networkConfigs, encryptionKey, encryptedSeed, encryptedEntropy) {
+        const store = getWorkletStore();
+        // Ensure worklet is started
+        if (!store.getState().isWorkletStarted) {
+            await WorkletLifecycleService.startWorklet(networkConfigs);
+        }
+        const wasInitialized = store.getState().isInitialized;
+        const previousEncryptionKey = store.getState().encryptionKey;
+        const previousEncryptedSeed = store.getState().encryptedSeed;
+        try {
+            // Attempt to initialize WDK with the credentials
+            // This will fail if the encryption key cannot decrypt the seed
+            await WorkletLifecycleService.initializeWDK({
+                encryptionKey,
+                encryptedSeed,
+            });
+            log('✅ Encryption compatibility validation passed');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const isDecryptionError = errorMessage.toLowerCase().includes('decryption failed') ||
+                errorMessage.toLowerCase().includes('failed to decrypt');
+            if (isDecryptionError) {
+                log('❌ Encryption compatibility validation failed - decryption error detected');
+                throw new Error(`Failed to validate encryption compatibility: The encryption key cannot decrypt the encrypted seed. ` +
+                    `This indicates corrupted or mismatched wallet data. Error: ${errorMessage}`);
+            }
+            throw error;
+        }
+        finally {
+            // Restore previous state if wallet was already initialized
+            // Only restore if we're not overwriting with the same credentials
+            if (wasInitialized &&
+                (previousEncryptionKey !== encryptionKey || previousEncryptedSeed !== encryptedSeed)) {
+                try {
+                    if (previousEncryptionKey && previousEncryptedSeed) {
+                        await WorkletLifecycleService.initializeWDK({
+                            encryptionKey: previousEncryptionKey,
+                            encryptedSeed: previousEncryptedSeed,
+                        });
+                    }
+                    else {
+                        WorkletLifecycleService.reset();
+                    }
+                }
+                catch (restoreError) {
+                    log('⚠️ Failed to restore previous wallet state after validation, resetting', restoreError);
+                    WorkletLifecycleService.reset();
+                }
+            }
+        }
+    }
+    /**
+     * Create a new wallet
+     * Generates entropy, encrypts it, and stores credentials securely
+     * Requires biometric authentication to ensure authorized wallet creation
+     */
+    static async createNewWallet(networkConfigs, walletId) {
+        const store = getWorkletStore();
+        const secureStorage = this.getSecureStorage();
+        // Step 1: Require biometric authentication before creating wallet
+        log('🔐 Creating new wallet - biometric authentication required...');
+        try {
+            const authenticated = await secureStorage.authenticate();
+            if (!authenticated) {
+                throw new Error('Biometric authentication required to create wallet');
+            }
+        }
+        catch (error) {
+            // Re-throw authentication errors so they can be properly handled by the UI
+            // This includes AuthenticationError from secure storage
+            log('❌ Biometric authentication failed', error);
+            throw error;
+        }
+        // Step 2: Start worklet
+        if (!store.getState().isWorkletStarted) {
+            await WorkletLifecycleService.startWorklet(networkConfigs);
+        }
+        // Step 3: Generate entropy and encrypt
+        const result = await WorkletLifecycleService.generateEntropyAndEncrypt(DEFAULT_MNEMONIC_WORD_COUNT);
+        // Step 4: Validate encryption compatibility before saving to keychain
+        log('🔍 Validating encryption compatibility before saving to keychain...');
+        try {
+            await this.validateEncryptionCompatibility(networkConfigs, result.encryptionKey, result.encryptedSeedBuffer, result.encryptedEntropyBuffer);
+        }
+        catch (error) {
+            log('❌ Encryption validation failed - aborting wallet creation', error);
+            // Reset worklet state on validation failure
+            WorkletLifecycleService.reset();
+            throw error;
+        }
+        // Step 5: Store credentials securely with walletId for multi-wallet support
+        try {
+            await secureStorage.setEncryptionKey(result.encryptionKey, walletId);
+            await secureStorage.setEncryptedSeed(result.encryptedSeedBuffer, walletId);
+            await secureStorage.setEncryptedEntropy(result.encryptedEntropyBuffer, walletId);
+        }
+        catch (error) {
+            // Clean up any partial writes (deleteWallet is idempotent)
+            try {
+                await secureStorage.deleteWallet(walletId);
+                log('[WalletSetupService] Cleaned up partial wallet creation after storage failure');
+            }
+            catch (cleanupError) {
+                logError('[WalletSetupService] Failed to cleanup partial wallet creation:', cleanupError);
+            }
+            throw error;
+        }
+        this.cacheCredentials(walletId, result.encryptionKey, result.encryptedSeedBuffer, result.encryptedEntropyBuffer);
+        log('✅ New wallet created and stored securely');
+        return {
+            encryptionKey: result.encryptionKey,
+            encryptedSeed: result.encryptedSeedBuffer,
+        };
+    }
+    /**
+     * Load existing wallet from secure storage
+     * Checks cache first, only requires biometric authentication if not cached
+     */
+    static async loadExistingWallet(walletId) {
+        const secureStorage = this.getSecureStorage();
+        const cacheKey = this.getCacheKey(walletId);
+        const cached = getCachedCredentials(cacheKey);
+        // Check if all required credentials are cached
+        if (cached?.encryptionKey && cached?.encryptedSeed) {
+            log('✅ Wallet loaded from cache (no biometrics needed)');
+            return {
+                encryptionKey: cached.encryptionKey,
+                encryptedSeed: cached.encryptedSeed,
+            };
+        }
+        log('🔓 Loading existing wallet - biometric authentication required...');
+        // Get encrypted seed first (doesn't require biometrics)
+        const encryptedSeed = await secureStorage.getEncryptedSeed(walletId);
+        // Try to get encryption key from cache first
+        let encryptionKey = cached?.encryptionKey;
+        // If not in cache, get from secureStorage (will trigger biometrics)
+        if (!encryptionKey) {
+            log('Encryption key not in cache, fetching from secureStorage...');
+            try {
+                const allEncrypted = await secureStorage.getAllEncrypted(walletId);
+                encryptionKey = allEncrypted.encryptionKey || undefined;
+            }
+            catch (error) {
+                throw error;
+            }
+        }
+        else {
+            log('Using cached encryption key (no biometrics needed)');
+        }
+        if (!encryptionKey) {
+            throw new Error('Encryption key not found. Authentication may have failed or wallet does not exist.');
+        }
+        if (!encryptedSeed) {
+            throw new Error('Encrypted seed not found. Authentication may have failed or wallet does not exist.');
+        }
+        // Cache credentials for future use
+        this.cacheCredentials(walletId, encryptionKey, encryptedSeed);
+        log('✅ Wallet loaded successfully from secure storage');
+        return {
+            encryptionKey,
+            encryptedSeed,
+        };
+    }
+    /**
+     * Check if a wallet exists
+     */
+    static async hasWallet(walletId) {
+        const secureStorage = this.getSecureStorage();
+        const result = await secureStorage.hasWallet(walletId);
+        return result;
+    }
+    /**
+     * Initialize WDK from an existing mnemonic phrase
+     * Converts mnemonic to encrypted seed and entropy, stores them securely, and initializes WDK
+     * Requires biometric authentication to ensure authorized wallet import
+     */
+    static async initializeFromMnemonic(networkConfigs, mnemonic, walletId) {
+        const store = getWorkletStore();
+        const secureStorage = this.getSecureStorage();
+        // Step 1: Require biometric authentication before importing wallet
+        log('🔐 Importing wallet from mnemonic - biometric authentication required...');
+        try {
+            const authenticated = await secureStorage.authenticate();
+            if (!authenticated) {
+                throw new Error('Biometric authentication required to import wallet');
+            }
+        }
+        catch (error) {
+            // Re-throw authentication errors so they can be properly handled by the UI
+            // This includes AuthenticationError from secure storage
+            log('❌ Biometric authentication failed', error);
+            throw error;
+        }
+        // Step 2: Start worklet
+        if (!store.getState().isWorkletStarted) {
+            await WorkletLifecycleService.startWorklet(networkConfigs);
+        }
+        // Step 3: Get seed and entropy from mnemonic
+        const result = await WorkletLifecycleService.getSeedAndEntropyFromMnemonic(mnemonic);
+        // Step 4: Validate encryption compatibility before saving to keychain
+        log('🔍 Validating encryption compatibility before saving to keychain...');
+        try {
+            await this.validateEncryptionCompatibility(networkConfigs, result.encryptionKey, result.encryptedSeedBuffer, result.encryptedEntropyBuffer);
+        }
+        catch (error) {
+            log('❌ Encryption validation failed - aborting wallet import', error);
+            // Reset worklet state on validation failure
+            WorkletLifecycleService.reset();
+            throw error;
+        }
+        // Step 5: Store credentials securely with walletId for multi-wallet support
+        try {
+            await secureStorage.setEncryptionKey(result.encryptionKey, walletId);
+            await secureStorage.setEncryptedSeed(result.encryptedSeedBuffer, walletId);
+            await secureStorage.setEncryptedEntropy(result.encryptedEntropyBuffer, walletId);
+        }
+        catch (error) {
+            // Clean up any partial writes (deleteWallet is idempotent)
+            try {
+                await secureStorage.deleteWallet(walletId);
+                log('[WalletSetupService] Cleaned up partial wallet import after storage failure');
+            }
+            catch (cleanupError) {
+                logError('[WalletSetupService] Failed to cleanup partial wallet import:', cleanupError);
+            }
+            throw error;
+        }
+        this.cacheCredentials(walletId, result.encryptionKey, result.encryptedSeedBuffer, result.encryptedEntropyBuffer);
+        // Step 6: Initialize WDK with the credentials
+        await WorkletLifecycleService.initializeWDK({
+            encryptionKey: result.encryptionKey,
+            encryptedSeed: result.encryptedSeedBuffer,
+        });
+        log('✅ Wallet imported from mnemonic and stored securely');
+        return {
+            encryptionKey: result.encryptionKey,
+            encryptedSeed: result.encryptedSeedBuffer,
+            encryptedEntropy: result.encryptedEntropyBuffer,
+        };
+    }
+    /**
+     * Initialize WDK with wallet credentials
+     */
+    static async initializeWDK(networkConfigs, credentials) {
+        const store = getWorkletStore();
+        // Ensure worklet is started
+        if (!store.getState().isWorkletStarted) {
+            log('Starting worklet...');
+            await WorkletLifecycleService.startWorklet(networkConfigs);
+            log('Worklet started');
+        }
+        // Initialize WDK
+        await WorkletLifecycleService.initializeWDK(credentials);
+    }
+    /**
+     * Complete wallet initialization flow
+     * Either creates a new wallet or loads an existing one
+     */
+    static async initializeWallet(networkConfigs, options) {
+        // Remove the early return check - WorkletLifecycleService.initializeWDK() will handle
+        // checking if credentials match (it already has the correct logic to skip if same credentials)
+        let credentials;
+        if (options.createNew) {
+            credentials = await this.createNewWallet(networkConfigs, options.walletId);
+        }
+        else {
+            credentials = await this.loadExistingWallet(options.walletId);
+        }
+        // Initialize WDK with credentials
+        await this.initializeWDK(networkConfigs, credentials);
+    }
+    /**
+     * Delete wallet and clear all data
+     *
+     * @param identifier - Optional identifier for multi-wallet support. If provided, deletes wallet for that identifier.
+     *                    If not provided, deletes the default wallet.
+     */
+    static async deleteWallet(walletId) {
+        const secureStorage = this.getSecureStorage();
+        // Clear secure storage for the specified walletId
+        await secureStorage.deleteWallet(walletId);
+        // Reset store state
+        WorkletLifecycleService.reset();
+        // Clear credentials cache
+        this.clearCredentialsCache(walletId);
+    }
+    /**
+     * Get encryption key (checks cache first, then secureStorage with biometrics)
+     */
+    static async getEncryptionKey(walletId) {
+        const secureStorage = this.getSecureStorage();
+        return this.getCredential(walletId, 'encryptionKey', async (id) => {
+            const allEncrypted = await secureStorage.getAllEncrypted(id);
+            return allEncrypted.encryptionKey || null;
+        }, 'encryptionKey');
+    }
+    /**
+     * Get encrypted seed (checks cache first, then secureStorage)
+     */
+    static async getEncryptedSeed(walletId) {
+        const secureStorage = this.getSecureStorage();
+        return this.getCredential(walletId, 'encryptedSeed', (id) => secureStorage.getEncryptedSeed(id), 'encryptedSeed');
+    }
+    /**
+     * Get encrypted entropy (checks cache first, then secureStorage)
+     */
+    static async getEncryptedEntropy(walletId) {
+        const secureStorage = this.getSecureStorage();
+        return this.getCredential(walletId, 'encryptedEntropy', (id) => secureStorage.getEncryptedEntropy(id), 'encryptedEntropy');
+    }
+    /**
+     * Get mnemonic phrase from wallet
+     * Retrieves encrypted entropy and encryption key, then decrypts to get mnemonic
+     *
+     * @param walletId - Optional walletId for multi-wallet support
+     * @returns Promise<string | null> - The mnemonic phrase or null if not found
+     */
+    static async getMnemonic(walletId) {
+        const encryptedEntropy = await this.getEncryptedEntropy(walletId);
+        const encryptionKey = await this.getEncryptionKey(walletId);
+        if (!encryptedEntropy || !encryptionKey) {
+            return null;
+        }
+        const result = await WorkletLifecycleService.getMnemonicFromEntropy(encryptedEntropy, encryptionKey);
+        return result.mnemonic || null;
+    }
+    /**
+     * Clear all cached credentials
+     * Should be called on logout or app background for security
+     */
+    static clearCredentialsCache(walletId) {
+        clearWorkletCredentialsCache(walletId ? this.getCacheKey(walletId) : undefined);
+        log('Credentials cache cleared', { walletId });
+    }
+}
+/**
+ * SecureStorage singleton instance
+ * Set by WdkAppProvider during initialization
+ */
+WalletSetupService.secureStorageInstance = null;
+//# sourceMappingURL=walletSetupService.js.map

package/dist/services/walletSetupService.js.map

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

package/dist/services/walletSwitchingService.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Wallet Switching Service
+ *
+ * Handles wallet switching operations: checking wallet existence, loading credentials,
+ * and initializing WDK with the new wallet.
+ *
+ * Architecture:
+ * - This service is the single source of truth for wallet switching logic
+ * - Used by useWallet hook for automatic wallet switching
+ * - Can be used by other components that need to switch wallets programmatically
+ */
+/**
+ * Wallet Switching Service
+ *
+ * Provides methods for switching between wallets.
+ */
+export declare class WalletSwitchingService {
+    /**
+     * Switch to a wallet by identifier
+     *
+     * This method:
+     * 1. Checks if the wallet exists (fail fast)
+     * 2. Ensures worklet is started
+     * 3. Loads credentials for the wallet
+     * 4. Initializes WDK with the credentials
+     * 5. Updates activeWalletId in the store
+     *
+     * @param walletId - Wallet identifier to switch to
+     * @param options - Optional configuration
+     * @param options.autoStartWorklet - If true, start worklet if not started (default: false)
+     * @throws Error if wallet doesn't exist or switching fails
+     *
+     * @example
+     * ```typescript
+     * await WalletSwitchingService.switchToWallet('user@example.com')
+     * ```
+     */
+    static switchToWallet(walletId: string, options?: {
+        autoStartWorklet?: boolean;
+    }): Promise<void>;
+    /**
+     * Check if a wallet can be switched to
+     *
+     * @param walletId - Wallet identifier to check
+     * @returns Promise resolving to true if wallet exists and can be switched to
+     */
+    static canSwitchToWallet(walletId: string): Promise<boolean>;
+}