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

package/dist/hooks/useBalance.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Balance Hooks with TanStack Query
+ *
+ * Provides React hooks for fetching and managing wallet balances using TanStack Query.
+ *
+ * ## Single Source of Truth Architecture
+ *
+ * This module uses Zustand as the single source of truth for balances, with TanStack Query
+ * as the fetching and caching layer.
+ *
+ * ### Zustand Store (Single Source of Truth)
+ * - **Purpose**: Store and persist balances across app restarts
+ * - **Lifetime**: Persisted to MMKV storage (survives app restarts)
+ * - **Features**: Single source of truth, persistence, immediate availability on app restart
+ * - **Usage**: All balance reads should go through TanStack Query hooks, which read from Zustand
+ *
+ * ### TanStack Query (Fetching & Caching Layer)
+ * - **Purpose**: Balance fetching, caching, refetching, and stale time management
+ * - **Lifetime**: Runtime-only (cache cleared on app restart, but reads initial data from Zustand)
+ * - **Features**: Automatic refetching, stale time management, cache invalidation, optimistic updates
+ * - **Usage**: Always use TanStack Query hooks (`useBalance`, `useBalances`) for balance operations
+ *
+ * ### Data Flow:
+ * 1. On app start: TanStack Query reads initial data from Zustand (via `initialData`)
+ * 2. If data is stale or missing: TanStack Query fetches balance from worklet (via `fetchBalance()`)
+ * 3. After fetch: Balance is updated in Zustand store (single source of truth update)
+ * 4. TanStack Query cache is updated with the fetched data
+ * 5. Components re-render with fresh data from TanStack Query
+ *
+ * ### Sync Guarantees:
+ * - **Zustand is always the source of truth** - TanStack Query reads from and writes to Zustand
+ * - **No sync logic needed** - TanStack Query updates Zustand directly after fetch
+ * - **Initial data consistency** - TanStack Query uses Zustand's persisted data as `initialData`
+ * - **No race conditions** - All updates go through Zustand, ensuring consistency
+ *
+ * ### Important Notes:
+ * - **Always use TanStack Query hooks** for balance operations - they handle Zustand integration
+ * - **Zustand is the single source of truth** - TanStack Query is a fetching/caching layer on top
+ * - **Addresses remain in Zustand only** (derived/computed state, deterministic, no refetching needed)
+ * - **Updates happen automatically** in `fetchBalance()` - Zustand is updated after each successful fetch
+ */
+import type { BalanceFetchResult, TokenConfigProvider } from '../types';
+/**
+ * Balance query options
+ */
+export interface BalanceQueryOptions {
+    /** Whether the query is enabled */
+    enabled?: boolean;
+    /** Refetch interval in milliseconds (false to disable) */
+    refetchInterval?: number | false;
+    /** Stale time in milliseconds */
+    staleTime?: number;
+    /** Wallet identifier (defaults to activeWalletId) */
+    walletId?: string;
+}
+/**
+ * Parameters for balance operations
+ */
+export interface BalanceParams {
+    /** Network name */
+    network: string;
+    /** Account index */
+    accountIndex: number;
+    /** Token address (null for native token) */
+    tokenAddress: string | null;
+    /** Optional wallet identifier */
+    walletId?: string;
+}
+/**
+ * Parameters for refreshing balances
+ */
+export interface RefreshBalanceParams {
+    /** Network name (required for 'token' or 'network' type) */
+    network?: string;
+    /** Account index */
+    accountIndex: number;
+    /** Token address (required for 'token' type) */
+    tokenAddress?: string | null;
+    /** Refresh type: 'token' (single), 'wallet' (all for wallet), 'network' (all for network), 'all' (everything) */
+    type?: 'token' | 'wallet' | 'network' | 'all';
+    /** Wallet identifier (defaults to activeWalletId) */
+    walletId?: string;
+}
+/**
+ * Query key factory for balance queries
+ */
+export declare const balanceQueryKeys: {
+    all: readonly ["balances"];
+    byWallet: (walletId: string, accountIndex: number) => readonly ["balances", "wallet", string, number];
+    byNetwork: (network: string) => readonly ["balances", "network", string];
+    byWalletAndNetwork: (walletId: string, accountIndex: number, network: string) => readonly ["balances", "wallet", string, number, "network", string];
+    byToken: (walletId: string, accountIndex: number, network: string, tokenAddress: string | null) => readonly ["balances", "wallet", string, number, "network", string, "token", string];
+};
+/**
+ * Hook to fetch a single balance
+ *
+ * @param network - Network name
+ * @param accountIndex - Account index
+ * @param tokenAddress - Token address (null for native token)
+ * @param options - Query options (enabled, refetchInterval, identifier, etc.)
+ * @returns TanStack Query result with balance data
+ *
+ * @example
+ * ```tsx
+ * const { data: balance, isLoading, error } = useBalance('ethereum', 0, null)
+ *
+ * // With specific wallet identifier
+ * const { data: balance } = useBalance('ethereum', 0, null, { walletId: 'user@example.com' })
+ *
+ * if (isLoading) return <Loading />
+ * if (error) return <Error message={error.message} />
+ * if (balance?.success) {
+ *   return <Text>Balance: {balance.balance}</Text>
+ * }
+ * ```
+ */
+export declare function useBalance(network: string, accountIndex: number, tokenAddress: string | null, options?: BalanceQueryOptions): import("@tanstack/react-query").UseQueryResult<BalanceFetchResult, Error>;
+/**
+ * Hook to fetch all balances for a wallet across all networks
+ *
+ * @param accountIndex - Account index
+ * @param tokenConfigs - Token configurations
+ * @param options - Query options (including identifier)
+ * @returns TanStack Query result with all balances
+ */
+export declare function useBalancesForWallet(accountIndex: number, tokenConfigs: TokenConfigProvider, options?: BalanceQueryOptions): import("@tanstack/react-query").UseQueryResult<BalanceFetchResult[], Error>;
+/**
+ * Hook to fetch balances for multiple wallets
+ *
+ * This hook is designed to handle dynamic arrays of wallets without violating React's Rules of Hooks.
+ * It uses TanStack Query's useQueries which is specifically designed for this use case.
+ *
+ * @param wallets - Array of wallets with accountIndex and identifier
+ * @param tokenConfigs - Token configurations
+ * @param options - Query options (enabled, refetchInterval, etc.)
+ * @returns Array of TanStack Query results, one for each wallet
+ *
+ * @example
+ * ```tsx
+ * const wallets = [
+ *   { accountIndex: 0, identifier: 'user@example.com' },
+ *   { accountIndex: 1, identifier: 'channel-123' },
+ * ]
+ * const balanceQueries = useBalancesForWallets(wallets, tokenConfigs, { enabled: true })
+ *
+ * const isLoading = balanceQueries.some(q => q.isLoading)
+ * const hasError = balanceQueries.some(q => q.isError)
+ * ```
+ */
+export declare function useBalancesForWallets(wallets: Array<{
+    accountIndex: number;
+    identifier: string;
+}>, tokenConfigs: TokenConfigProvider, options?: BalanceQueryOptions): import("@tanstack/react-query").DefinedUseQueryResult<BalanceFetchResult[], Error>[];
+/**
+ * Hook to invalidate and refetch balances
+ *
+ * @returns Mutation function to refresh balances
+ *
+ * @example
+ * ```tsx
+ * const { mutate: refreshBalance } = useRefreshBalance()
+ *
+ * // Refresh single balance
+ * refreshBalance({ network: 'ethereum', accountIndex: 0, tokenAddress: null })
+ *
+ * // Refresh all balances for a wallet
+ * refreshBalance({ accountIndex: 0, type: 'wallet' })
+ * ```
+ */
+export declare function useRefreshBalance(): import("@tanstack/react-query").UseMutationResult<void, Error, RefreshBalanceParams, unknown>;

package/dist/hooks/useBalance.js

@@ -0,0 +1,442 @@
+/**
+ * Balance Hooks with TanStack Query
+ *
+ * Provides React hooks for fetching and managing wallet balances using TanStack Query.
+ *
+ * ## Single Source of Truth Architecture
+ *
+ * This module uses Zustand as the single source of truth for balances, with TanStack Query
+ * as the fetching and caching layer.
+ *
+ * ### Zustand Store (Single Source of Truth)
+ * - **Purpose**: Store and persist balances across app restarts
+ * - **Lifetime**: Persisted to MMKV storage (survives app restarts)
+ * - **Features**: Single source of truth, persistence, immediate availability on app restart
+ * - **Usage**: All balance reads should go through TanStack Query hooks, which read from Zustand
+ *
+ * ### TanStack Query (Fetching & Caching Layer)
+ * - **Purpose**: Balance fetching, caching, refetching, and stale time management
+ * - **Lifetime**: Runtime-only (cache cleared on app restart, but reads initial data from Zustand)
+ * - **Features**: Automatic refetching, stale time management, cache invalidation, optimistic updates
+ * - **Usage**: Always use TanStack Query hooks (`useBalance`, `useBalances`) for balance operations
+ *
+ * ### Data Flow:
+ * 1. On app start: TanStack Query reads initial data from Zustand (via `initialData`)
+ * 2. If data is stale or missing: TanStack Query fetches balance from worklet (via `fetchBalance()`)
+ * 3. After fetch: Balance is updated in Zustand store (single source of truth update)
+ * 4. TanStack Query cache is updated with the fetched data
+ * 5. Components re-render with fresh data from TanStack Query
+ *
+ * ### Sync Guarantees:
+ * - **Zustand is always the source of truth** - TanStack Query reads from and writes to Zustand
+ * - **No sync logic needed** - TanStack Query updates Zustand directly after fetch
+ * - **Initial data consistency** - TanStack Query uses Zustand's persisted data as `initialData`
+ * - **No race conditions** - All updates go through Zustand, ensuring consistency
+ *
+ * ### Important Notes:
+ * - **Always use TanStack Query hooks** for balance operations - they handle Zustand integration
+ * - **Zustand is the single source of truth** - TanStack Query is a fetching/caching layer on top
+ * - **Addresses remain in Zustand only** (derived/computed state, deterministic, no refetching needed)
+ * - **Updates happen automatically** in `fetchBalance()` - Zustand is updated after each successful fetch
+ */
+import { useQuery, useQueries, useMutation, useQueryClient } from '@tanstack/react-query';
+import { AccountService } from '../services/accountService';
+import { BalanceService } from '../services/balanceService';
+import { getWalletStore } from '../store/walletStore';
+import { getWorkletStore } from '../store/workletStore';
+import { resolveWalletId } from '../utils/storeHelpers';
+import { convertBalanceToString } from '../utils/balanceUtils';
+import { ACCOUNT_METHOD_GET_BALANCE, ACCOUNT_METHOD_GET_TOKEN_BALANCE, NATIVE_TOKEN_KEY, DEFAULT_QUERY_STALE_TIME_MS, DEFAULT_QUERY_GC_TIME_MS, } from '../utils/constants';
+import { logError } from '../utils/logger';
+import { validateWalletParams } from '../utils/validation';
+/**
+ * Query key factory for balance queries
+ */
+export const balanceQueryKeys = {
+    all: ['balances'],
+    byWallet: (walletId, accountIndex) => ['balances', 'wallet', walletId, accountIndex],
+    byNetwork: (network) => ['balances', 'network', network],
+    byWalletAndNetwork: (walletId, accountIndex, network) => ['balances', 'wallet', walletId, accountIndex, 'network', network],
+    byToken: (walletId, accountIndex, network, tokenAddress) => ['balances', 'wallet', walletId, accountIndex, 'network', network, 'token', tokenAddress || NATIVE_TOKEN_KEY],
+};
+/**
+ * Check if a query should be enabled
+ */
+function isQueryEnabled(enabledOption, isInitialized, additionalCondition = true) {
+    return (enabledOption !== false) && isInitialized && additionalCondition;
+}
+/**
+ * Validate and parse a balance query key structure
+ *
+ * @param queryKey - Query key array from balanceQueryKeys.byToken()
+ * @returns Validated query key components
+ * @throws Error if query key structure is invalid
+ */
+function validateQueryKeyStructure(queryKey) {
+    // Validate queryKey structure before destructuring
+    if (!Array.isArray(queryKey) || queryKey.length < 8) {
+        throw new Error(`Invalid queryKey structure: ${JSON.stringify(queryKey)}`);
+    }
+    const [, , , accountIdx, , network, , tokenAddress] = queryKey;
+    // Validate types instead of using assertions
+    if (typeof accountIdx !== 'number' || accountIdx < 0) {
+        throw new Error(`Invalid accountIndex in queryKey: ${accountIdx}`);
+    }
+    if (typeof network !== 'string' || network.length === 0) {
+        throw new Error(`Invalid network in queryKey: ${network}`);
+    }
+    if (tokenAddress !== NATIVE_TOKEN_KEY && (typeof tokenAddress !== 'string' || tokenAddress.length === 0)) {
+        throw new Error(`Invalid tokenAddress in queryKey: ${tokenAddress}`);
+    }
+    return {
+        accountIndex: accountIdx,
+        network,
+        tokenAddress: tokenAddress === NATIVE_TOKEN_KEY ? null : tokenAddress,
+    };
+}
+/**
+ * Fetch balance for a specific token (native or ERC20)
+ *
+ * @param network - Network name
+ * @param accountIndex - Account index
+ * @param tokenAddress - Token address (null for native token)
+ * @param walletId - Optional wallet identifier (defaults to activeWalletId)
+ * @returns Promise with balance fetch result
+ */
+async function fetchBalance(network, accountIndex, tokenAddress, walletId) {
+    validateWalletParams(network, accountIndex, tokenAddress);
+    const workletStore = getWorkletStore();
+    if (!workletStore.getState().isInitialized) {
+        return {
+            success: false,
+            network,
+            accountIndex,
+            tokenAddress,
+            balance: null,
+            error: 'Wallet not initialized',
+        };
+    }
+    try {
+        const isNative = tokenAddress === null;
+        const methodName = isNative ? ACCOUNT_METHOD_GET_BALANCE : ACCOUNT_METHOD_GET_TOKEN_BALANCE;
+        const methodArg = isNative ? null : tokenAddress;
+        const balanceResult = await AccountService.callAccountMethod(network, accountIndex, methodName, methodArg);
+        // Convert to string (handles BigInt values)
+        const balance = convertBalanceToString(balanceResult);
+        // Update Zustand store (single source of truth)
+        // IMPORTANT: Zustand is the single source of truth for balances.
+        // TanStack Query is a fetching/caching layer that reads from and updates Zustand.
+        // This update ensures balances are persisted and available immediately on app restart.
+        const targetWalletId = resolveWalletId(walletId);
+        BalanceService.updateBalance(accountIndex, network, tokenAddress, balance, targetWalletId);
+        BalanceService.updateLastBalanceUpdate(network, accountIndex, targetWalletId);
+        return {
+            success: true,
+            network,
+            accountIndex,
+            tokenAddress,
+            balance,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const tokenInfo = tokenAddress ? `:${tokenAddress}` : '';
+        const balanceType = tokenAddress ? 'token' : 'native';
+        logError(`Failed to fetch ${balanceType} balance for ${network}:${accountIndex}${tokenInfo}:`, error);
+        return {
+            success: false,
+            network,
+            accountIndex,
+            tokenAddress,
+            balance: null,
+            error: errorMessage,
+        };
+    }
+}
+/**
+ * Hook to fetch a single balance
+ *
+ * @param network - Network name
+ * @param accountIndex - Account index
+ * @param tokenAddress - Token address (null for native token)
+ * @param options - Query options (enabled, refetchInterval, identifier, etc.)
+ * @returns TanStack Query result with balance data
+ *
+ * @example
+ * ```tsx
+ * const { data: balance, isLoading, error } = useBalance('ethereum', 0, null)
+ *
+ * // With specific wallet identifier
+ * const { data: balance } = useBalance('ethereum', 0, null, { walletId: 'user@example.com' })
+ *
+ * if (isLoading) return <Loading />
+ * if (error) return <Error message={error.message} />
+ * if (balance?.success) {
+ *   return <Text>Balance: {balance.balance}</Text>
+ * }
+ * ```
+ */
+export function useBalance(network, accountIndex, tokenAddress, options) {
+    const workletStore = getWorkletStore();
+    const walletStore = getWalletStore();
+    // Check if wallet is initialized
+    const isInitialized = workletStore.getState().isInitialized;
+    // Get walletId from options or activeWalletId
+    const activeWalletId = walletStore.getState().activeWalletId;
+    const walletId = options?.walletId || activeWalletId || '__temporary__';
+    // Get initial data from Zustand (single source of truth)
+    // This ensures balances are available immediately on app restart before refetch
+    const initialBalance = BalanceService.getBalance(accountIndex, network, tokenAddress, walletId);
+    const initialData = initialBalance !== null
+        ? {
+            success: true,
+            network,
+            accountIndex,
+            tokenAddress,
+            balance: initialBalance,
+        }
+        : undefined;
+    return useQuery({
+        queryKey: balanceQueryKeys.byToken(walletId, accountIndex, network, tokenAddress),
+        queryFn: () => fetchBalance(network, accountIndex, tokenAddress, walletId),
+        enabled: isQueryEnabled(options?.enabled, isInitialized),
+        refetchInterval: options?.refetchInterval,
+        staleTime: options?.staleTime ?? DEFAULT_QUERY_STALE_TIME_MS,
+        gcTime: DEFAULT_QUERY_GC_TIME_MS,
+        // Use Zustand as initial data source (single source of truth)
+        initialData,
+    });
+}
+/**
+ * Build query keys for all tokens across all networks
+ */
+function buildBalanceQueryKeys(walletId, accountIndex, tokenConfigs) {
+    const tokenConfigsObj = typeof tokenConfigs === 'function' ? tokenConfigs() : tokenConfigs;
+    const networks = Object.keys(tokenConfigsObj);
+    return networks.flatMap((network) => {
+        const networkTokens = tokenConfigsObj[network];
+        if (!networkTokens)
+            return [];
+        const tokens = [networkTokens.native, ...networkTokens.tokens];
+        return tokens.map((token) => balanceQueryKeys.byToken(walletId, accountIndex, network, token.address));
+    });
+}
+/**
+ * Fetch balances for all query keys
+ */
+async function fetchBalancesForQueryKeys(queryKeys, walletId) {
+    return Promise.all(queryKeys.map(async (queryKey) => {
+        const validated = validateQueryKeyStructure(queryKey);
+        return fetchBalance(validated.network, validated.accountIndex, validated.tokenAddress, walletId);
+    }));
+}
+/**
+ * Hook to fetch all balances for a wallet across all networks
+ *
+ * @param accountIndex - Account index
+ * @param tokenConfigs - Token configurations
+ * @param options - Query options (including identifier)
+ * @returns TanStack Query result with all balances
+ */
+export function useBalancesForWallet(accountIndex, tokenConfigs, options) {
+    const workletStore = getWorkletStore();
+    const isInitialized = workletStore.getState().isInitialized;
+    // Resolve walletId from options or store
+    const walletId = resolveWalletId(options?.walletId);
+    // Create query keys for all tokens (with walletId)
+    const queryKeys = buildBalanceQueryKeys(walletId, accountIndex, tokenConfigs);
+    // Get initial data from Zustand (single source of truth)
+    // Build initial data array from persisted balances
+    const initialData = (() => {
+        const tokenConfigsObj = typeof tokenConfigs === 'function' ? tokenConfigs() : tokenConfigs;
+        const networks = Object.keys(tokenConfigsObj);
+        const initialBalances = [];
+        let hasAnyInitialData = false;
+        for (const network of networks) {
+            const networkTokens = tokenConfigsObj[network];
+            if (!networkTokens)
+                continue;
+            const tokens = [networkTokens.native, ...networkTokens.tokens];
+            for (const token of tokens) {
+                const balance = BalanceService.getBalance(accountIndex, network, token.address, walletId);
+                if (balance !== null) {
+                    hasAnyInitialData = true;
+                    initialBalances.push({
+                        success: true,
+                        network,
+                        accountIndex,
+                        tokenAddress: token.address,
+                        balance,
+                    });
+                }
+                else {
+                    // Include placeholder for missing balances to maintain structure
+                    initialBalances.push({
+                        success: false,
+                        network,
+                        accountIndex,
+                        tokenAddress: token.address,
+                        balance: null,
+                        error: 'Balance not available',
+                    });
+                }
+            }
+        }
+        // Only return initial data if we have at least one persisted balance
+        return hasAnyInitialData ? initialBalances : undefined;
+    })();
+    return useQuery({
+        queryKey: [...balanceQueryKeys.byWallet(walletId, accountIndex), 'all'],
+        queryFn: () => fetchBalancesForQueryKeys(queryKeys, walletId),
+        enabled: isQueryEnabled(options?.enabled, isInitialized, queryKeys.length > 0),
+        refetchInterval: options?.refetchInterval,
+        staleTime: options?.staleTime ?? DEFAULT_QUERY_STALE_TIME_MS,
+        gcTime: DEFAULT_QUERY_GC_TIME_MS,
+        // Use Zustand as initial data source (single source of truth)
+        initialData,
+    });
+}
+/**
+ * Hook to fetch balances for multiple wallets
+ *
+ * This hook is designed to handle dynamic arrays of wallets without violating React's Rules of Hooks.
+ * It uses TanStack Query's useQueries which is specifically designed for this use case.
+ *
+ * @param wallets - Array of wallets with accountIndex and identifier
+ * @param tokenConfigs - Token configurations
+ * @param options - Query options (enabled, refetchInterval, etc.)
+ * @returns Array of TanStack Query results, one for each wallet
+ *
+ * @example
+ * ```tsx
+ * const wallets = [
+ *   { accountIndex: 0, identifier: 'user@example.com' },
+ *   { accountIndex: 1, identifier: 'channel-123' },
+ * ]
+ * const balanceQueries = useBalancesForWallets(wallets, tokenConfigs, { enabled: true })
+ *
+ * const isLoading = balanceQueries.some(q => q.isLoading)
+ * const hasError = balanceQueries.some(q => q.isError)
+ * ```
+ */
+export function useBalancesForWallets(wallets, tokenConfigs, options) {
+    const workletStore = getWorkletStore();
+    const isInitialized = workletStore.getState().isInitialized;
+    return useQueries({
+        queries: wallets.map((wallet) => {
+            const { accountIndex, identifier } = wallet;
+            // Create query keys for all tokens (with walletId)
+            const queryKeys = buildBalanceQueryKeys(identifier, accountIndex, tokenConfigs);
+            // Get initial data from Zustand (single source of truth)
+            const initialData = (() => {
+                const tokenConfigsObj = typeof tokenConfigs === 'function' ? tokenConfigs() : tokenConfigs;
+                const networks = Object.keys(tokenConfigsObj);
+                const initialBalances = [];
+                let hasAnyInitialData = false;
+                for (const network of networks) {
+                    const networkTokens = tokenConfigsObj[network];
+                    if (!networkTokens)
+                        continue;
+                    const tokens = [networkTokens.native, ...networkTokens.tokens];
+                    for (const token of tokens) {
+                        const balance = BalanceService.getBalance(accountIndex, network, token.address, identifier);
+                        if (balance !== null) {
+                            hasAnyInitialData = true;
+                            initialBalances.push({
+                                success: true,
+                                network,
+                                accountIndex,
+                                tokenAddress: token.address,
+                                balance,
+                            });
+                        }
+                        else {
+                            // Include placeholder for missing balances to maintain structure
+                            initialBalances.push({
+                                success: false,
+                                network,
+                                accountIndex,
+                                tokenAddress: token.address,
+                                balance: null,
+                                error: 'Balance not available',
+                            });
+                        }
+                    }
+                }
+                // Only return initial data if we have at least one persisted balance
+                return hasAnyInitialData ? initialBalances : undefined;
+            })();
+            return {
+                queryKey: [...balanceQueryKeys.byWallet(identifier, accountIndex), 'all'],
+                queryFn: () => fetchBalancesForQueryKeys(queryKeys, identifier),
+                enabled: isQueryEnabled(options?.enabled, isInitialized, queryKeys.length > 0),
+                refetchInterval: options?.refetchInterval,
+                staleTime: options?.staleTime ?? DEFAULT_QUERY_STALE_TIME_MS,
+                gcTime: DEFAULT_QUERY_GC_TIME_MS,
+                // Use Zustand as initial data source (single source of truth)
+                initialData,
+            };
+        }),
+    });
+}
+/**
+ * Invalidate balance queries based on refresh type
+ */
+async function invalidateBalanceQueries(queryClient, params, walletId) {
+    const { network, accountIndex, tokenAddress, type = 'token' } = params;
+    switch (type) {
+        case 'all':
+            await queryClient.invalidateQueries({ queryKey: balanceQueryKeys.all });
+            break;
+        case 'wallet':
+            await queryClient.invalidateQueries({
+                queryKey: balanceQueryKeys.byWallet(walletId, accountIndex),
+            });
+            break;
+        case 'network':
+            if (network) {
+                await queryClient.invalidateQueries({
+                    queryKey: balanceQueryKeys.byNetwork(network),
+                });
+            }
+            break;
+        case 'token':
+        default:
+            if (network && tokenAddress !== undefined) {
+                await queryClient.invalidateQueries({
+                    queryKey: balanceQueryKeys.byToken(walletId, accountIndex, network, tokenAddress),
+                });
+            }
+            break;
+    }
+}
+/**
+ * Hook to invalidate and refetch balances
+ *
+ * @returns Mutation function to refresh balances
+ *
+ * @example
+ * ```tsx
+ * const { mutate: refreshBalance } = useRefreshBalance()
+ *
+ * // Refresh single balance
+ * refreshBalance({ network: 'ethereum', accountIndex: 0, tokenAddress: null })
+ *
+ * // Refresh all balances for a wallet
+ * refreshBalance({ accountIndex: 0, type: 'wallet' })
+ * ```
+ */
+export function useRefreshBalance() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (params) => {
+            // Resolve walletId from params or store
+            const walletId = resolveWalletId(params.walletId);
+            // Invalidate queries based on type
+            await invalidateBalanceQueries(queryClient, params, walletId);
+            // Refetch the invalidated queries
+            await queryClient.refetchQueries();
+        },
+    });
+}
+//# sourceMappingURL=useBalance.js.map

package/dist/hooks/useBalance.js.map

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

package/dist/hooks/useWallet.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Hook to interact with wallet data (addresses and account methods)
+ *
+ * PURPOSE: Use this hook for wallet operations AFTER the wallet has been initialized.
+ * This hook provides access to wallet addresses and account methods.
+ *
+ * When to use which hook:
+ * - **App initialization state**: Use `useWdkApp()` to check if app is ready
+ * - **Wallet lifecycle** (create, load, import, delete): Use `useWalletManager()`
+ * - **Wallet operations** (addresses, account methods): Use this hook (`useWallet()`)
+ * - **Balance fetching**: Use `useBalance()` hook with TanStack Query
+ *
+ * @example
+ * ```tsx
+ * // First, check if app is ready
+ * const { isReady } = useWdkApp()
+ * if (!isReady) return <LoadingScreen />
+ *
+ * // Then use wallet operations
+ * const { addresses, getAddress, callAccountMethod } = useWallet()
+ *
+ * // Use specific wallet (automatically switches if needed)
+ * const { addresses, getAddress } = useWallet({ walletId: 'user@example.com' })
+ *
+ * // Note: For creating temporary wallets, use useWalletManager().createTemporaryWallet()
+ * ```
+ */
+export interface UseWalletResult {
+    addresses: Record<string, Record<number, string>>;
+    walletLoading: Record<string, boolean>;
+    isInitialized: boolean;
+    isSwitchingWallet: boolean;
+    switchingToWalletId: string | null;
+    switchWalletError: Error | null;
+    isTemporaryWallet: boolean;
+    getNetworkAddresses: (network: string) => Record<number, string>;
+    isLoadingAddress: (network: string, accountIndex?: number) => boolean;
+    getAddress: (network: string, accountIndex?: number) => Promise<string>;
+    callAccountMethod: <T = unknown>(network: string, accountIndex: number, methodName: string, args?: unknown) => Promise<T>;
+}
+export declare function useWallet(options?: {
+    walletId?: string;
+}): UseWalletResult;