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

package/dist/hooks/useWallet.js

@@ -0,0 +1,193 @@
+import { useCallback, useEffect, useState, useMemo } from 'react';
+import { useShallow } from 'zustand/react/shallow';
+import { AccountService } from '../services/accountService';
+import { AddressService } from '../services/addressService';
+import { WalletSetupService } from '../services/walletSetupService';
+import { WalletSwitchingService } from '../services/walletSwitchingService';
+import { getWalletStore } from '../store/walletStore';
+import { getWorkletStore } from '../store/workletStore';
+import { isOperationInProgress } from '../utils/operationMutex';
+import { log, logError } from '../utils/logger';
+// Stable empty objects to prevent creating new objects on every render
+const EMPTY_ADDRESSES = {};
+const EMPTY_WALLET_LOADING = {};
+/**
+ * Check if wallet switching should be skipped
+ */
+function shouldSkipWalletSwitch(requestedWalletId, activeWalletId, isSwitchingWallet, switchingToWalletId) {
+    // Skip if no walletId provided or walletId matches activeWalletId
+    if (!requestedWalletId || requestedWalletId === activeWalletId) {
+        return true;
+    }
+    // Skip if already switching to this wallet
+    if (isSwitchingWallet && switchingToWalletId === requestedWalletId) {
+        return true;
+    }
+    // Skip if switching to a different wallet (wait for current switch to complete)
+    if (isSwitchingWallet && switchingToWalletId !== requestedWalletId) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if the requested wallet is a temporary wallet
+ */
+function isTemporaryWalletId(walletId) {
+    return walletId === '__temporary__';
+}
+/**
+ * Normalize error to Error instance
+ */
+function normalizeErrorToError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+export function useWallet(options) {
+    const workletStore = getWorkletStore();
+    const walletStore = getWalletStore();
+    // Switching state
+    const [isSwitchingWallet, setIsSwitchingWallet] = useState(false);
+    const [switchingToWalletId, setSwitchingToWalletId] = useState(null);
+    const [switchWalletError, setSwitchWalletError] = useState(null);
+    const [isTemporaryWallet, setIsTemporaryWallet] = useState(false);
+    // Get activeWalletId from stores
+    const activeWalletId = walletStore((state) => state.activeWalletId);
+    // Determine target walletId
+    const targetWalletId = options?.walletId || activeWalletId;
+    // Subscribe to wallet state for target wallet
+    // useShallow ensures stable references when content doesn't change
+    // We select the specific wallet's data directly from the store
+    // Use stable empty objects to prevent new object creation on every render
+    const walletState = walletStore(useShallow((state) => {
+        const walletId = options?.walletId || state.activeWalletId;
+        if (!walletId) {
+            return {
+                addresses: EMPTY_ADDRESSES,
+                walletLoading: EMPTY_WALLET_LOADING,
+            };
+        }
+        const addresses = state.addresses[walletId];
+        const walletLoading = state.walletLoading[walletId];
+        return {
+            addresses: addresses || EMPTY_ADDRESSES,
+            walletLoading: walletLoading || EMPTY_WALLET_LOADING,
+        };
+    }));
+    const isInitialized = workletStore((state) => state.isInitialized);
+    // Automatic wallet switching logic
+    useEffect(() => {
+        const requestedWalletId = options?.walletId;
+        // Skip if switching should be skipped
+        if (shouldSkipWalletSwitch(requestedWalletId, activeWalletId, isSwitchingWallet, switchingToWalletId)) {
+            setIsTemporaryWallet(false);
+            return;
+        }
+        // Skip until WdkAppProvider has registered SecureStorage (runs synchronously on mount)
+        if (!WalletSetupService.isSecureStorageInitialized()) {
+            log('[useWallet] SecureStorage not initialized yet, skipping wallet switch');
+            return;
+        }
+        // Check if another operation is in progress (via mutex)
+        if (isOperationInProgress()) {
+            log('[useWallet] Operation in progress, skipping wallet switch');
+            return;
+        }
+        // Handle temporary wallet identifier
+        if (isTemporaryWalletId(requestedWalletId)) {
+            setIsTemporaryWallet(true);
+            return;
+        }
+        let cancelled = false;
+        const switchWallet = async () => {
+            setIsSwitchingWallet(true);
+            setSwitchingToWalletId(requestedWalletId);
+            setSwitchWalletError(null);
+            try {
+                // Use WalletSwitchingService for wallet switching logic (has mutex protection)
+                await WalletSwitchingService.switchToWallet(requestedWalletId, {
+                    autoStartWorklet: false,
+                });
+                if (!cancelled) {
+                    setIsTemporaryWallet(false);
+                }
+            }
+            catch (error) {
+                if (!cancelled) {
+                    const err = normalizeErrorToError(error);
+                    logError('[useWallet] Failed to switch wallet:', error);
+                    setSwitchWalletError(err);
+                    // Don't update activeWalletId if switch failed
+                }
+            }
+            finally {
+                if (!cancelled) {
+                    setIsSwitchingWallet(false);
+                    setSwitchingToWalletId(null);
+                }
+            }
+        };
+        switchWallet();
+        // Cleanup function to cancel in-flight operations
+        return () => {
+            cancelled = true;
+        };
+    }, [options?.walletId, activeWalletId, isSwitchingWallet, switchingToWalletId]);
+    // useShallow already provides stable references when content doesn't change
+    // We can use walletState.addresses and walletState.walletLoading directly
+    // No need to create new objects - useShallow handles reference stability
+    const addresses = walletState.addresses;
+    const walletLoading = walletState.walletLoading;
+    // Get all addresses for a specific network
+    // Use addresses directly from walletState (stable reference from useShallow)
+    const getNetworkAddresses = useCallback((network) => {
+        return addresses[network] || {};
+    }, [addresses]);
+    // Check if an address is loading
+    // Use walletLoading directly from walletState (stable reference from useShallow)
+    const isLoadingAddress = useCallback((network, accountIndex = 0) => {
+        return walletLoading[`${network}-${accountIndex}`] || false;
+    }, [walletLoading]);
+    // Get a specific address (from cache or fetch)
+    const getAddress = useCallback(async (network, accountIndex = 0) => {
+        const walletId = targetWalletId || '__temporary__';
+        return AddressService.getAddress(network, accountIndex, walletId);
+    }, [targetWalletId]);
+    // Call a method on a wallet account
+    const callAccountMethod = useCallback(async (network, accountIndex, methodName, args) => {
+        const walletId = targetWalletId || '__temporary__';
+        return AccountService.callAccountMethod(network, accountIndex, methodName, args, walletId);
+    }, [targetWalletId]);
+    // Memoize the entire result object to ensure stable reference
+    // useShallow already provides stable references for addresses and walletLoading
+    // We memoize the result object to prevent creating new objects on every render
+    const result = useMemo(() => ({
+        // State (reactive) - useShallow ensures stable references
+        addresses,
+        walletLoading,
+        isInitialized,
+        // Switching state
+        isSwitchingWallet,
+        switchingToWalletId,
+        switchWalletError,
+        isTemporaryWallet,
+        // Computed helpers
+        getNetworkAddresses,
+        isLoadingAddress,
+        // Actions
+        getAddress,
+        callAccountMethod,
+    }), [
+        addresses,
+        walletLoading,
+        isInitialized,
+        isSwitchingWallet,
+        switchingToWalletId,
+        switchWalletError,
+        isTemporaryWallet,
+        getNetworkAddresses,
+        isLoadingAddress,
+        getAddress,
+        callAccountMethod,
+    ]);
+    return result;
+}
+//# sourceMappingURL=useWallet.js.map

package/dist/hooks/useWallet.js.map

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

package/dist/hooks/useWalletManager.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Wallet Manager Hook
+ *
+ * Consolidated hook for wallet setup, initialization, and lifecycle management.
+ * This is the ONLY hook for wallet lifecycle operations.
+ *
+ * PURPOSE: Use this hook for wallet setup/auth flows (creating new wallets,
+ * loading existing wallets, checking if wallet exists, deleting wallets, getting mnemonic).
+ *
+ * When to use which hook:
+ * - **App initialization state**: Use `useWdkApp()` to check if app is ready
+ * - **Wallet lifecycle** (create, load, import, delete): Use this hook (`useWalletManager()`)
+ * - **Wallet operations** (addresses, account methods): Use `useWallet()` AFTER initialization
+ * - **Balance fetching**: Use `useBalance()` hook with TanStack Query
+ *
+ * **Wallet Switching**: Use `useWallet({ walletId })` to switch wallets.
+ *
+ * @example
+ * ```tsx
+ * // Check if app is ready first
+ * const { isReady } = useWdkApp()
+ *
+ * // Then use wallet manager for lifecycle operations
+ * // networkConfigs is optional - it will be retrieved from workletStore if not provided
+ * const {
+ *   createWallet,
+ *   initializeWallet,
+ *   initializeFromMnemonic,
+ *   hasWallet,
+ *   deleteWallet,
+ *   getMnemonic,
+ *   createTemporaryWallet,
+ *   isInitializing,
+ *   error
+ * } = useWalletManager('user@example.com')
+ *
+ * // Create new wallet (persistent, requires biometrics)
+ * // networkConfigs can be passed here or retrieved from store
+ * await createWallet('user@example.com', networkConfigs)
+ *
+ * // Initialize wallet (create new or load existing)
+ * await initializeWallet({ createNew: true })
+ *
+ * // Load existing wallet (requires biometric authentication)
+ * await initializeWallet({ createNew: false })
+ *
+ * // Import from mnemonic
+ * await initializeFromMnemonic('word1 word2 ... word12')
+ *
+ * // Create temporary wallet for previewing addresses (no biometrics, not saved)
+ * await createTemporaryWallet()
+ *
+ * // Get mnemonic (requires biometric authentication if not cached)
+ * const mnemonic = await getMnemonic()
+ *
+ * // Delete wallet
+ * await deleteWallet()
+ * ```
+ */
+import type { NetworkConfigs } from '../types';
+import type { WalletInfo } from '../store/walletStore';
+export type { WalletInfo };
+export interface UseWalletManagerResult {
+    /** Initialize wallet - either create new or load existing */
+    initializeWallet: (options?: {
+        createNew?: boolean;
+        walletId?: string;
+    }) => Promise<void>;
+    /** Initialize wallet from mnemonic seedphrase */
+    initializeFromMnemonic: (mnemonic: string, walletId?: string) => Promise<void>;
+    /** Check if wallet exists */
+    hasWallet: (walletId?: string) => Promise<boolean>;
+    /** Delete wallet */
+    deleteWallet: (walletId?: string) => Promise<void>;
+    /** Get mnemonic phrase (requires biometric authentication if not cached) */
+    getMnemonic: (walletId?: string) => Promise<string | null>;
+    /** Create a temporary wallet for previewing addresses (no biometrics, not saved) */
+    createTemporaryWallet: () => Promise<void>;
+    /** Whether initialization is in progress */
+    isInitializing: boolean;
+    /** Error message if any */
+    error: string | null;
+    /** Clear error state */
+    clearError: () => void;
+    /** Clear active wallet ID (useful when switching users or logging out) */
+    clearActiveWallet: () => void;
+    /** List of all known wallets */
+    wallets: WalletInfo[];
+    /** Currently active wallet identifier */
+    activeWalletId: string | null;
+    /** Create a new wallet with the given walletId (adds to list) */
+    createWallet: (walletId: string, networkConfigs?: NetworkConfigs) => Promise<void>;
+    /** Refresh the wallet list */
+    refreshWalletList: (knownIdentifiers?: string[]) => Promise<void>;
+    /** Whether wallet list operation is in progress */
+    isWalletListLoading: boolean;
+    /** Wallet list error message if any */
+    walletListError: string | null;
+}
+export declare function useWalletManager(walletId?: string, networkConfigs?: NetworkConfigs): UseWalletManagerResult;