@solana/connector 0.1.6 → 0.1.7

package/dist/index.mjs

@@ -1,6 +1,6 @@
-export { EnhancedStorage, EnhancedStorageAdapter, SOLANA_CHAIN_IDS, address, base58ToSignatureBytes, chainIdToClusterId, chainIdToClusterType, clusterToChainId, copySignature, createConfig, createEnhancedStorageAccount, createEnhancedStorageCluster, createEnhancedStorageWallet, createKitSignersFromWallet, createMessageSignerFromWallet, createSignableMessage, createSolanaDevnet, createSolanaLocalnet, createSolanaMainnet, createSolanaTestnet, createTransactionSendingSignerFromWallet, detectMessageModification, formatSignature, freezeSigner, getAllExplorerUrls, getChainIdFromCluster, getChainIdFromClusterId, getChainIdFromClusterType, getChainIdFromConnection, getClusterIdFromChainId, getClusterTypeFromChainId, getClusterTypeFromConnection, getDefaultConfig, getDefaultMobileConfig, getLatestBlockhash, getSolanaExplorerUrl, getSolanaFmUrl, getSolscanUrl, getXrayUrl, isAccountAddress, isKitConnection, isKnownSolanaChain, isLegacyConnection, isSolanaChain, isUnifiedConfig, isWalletName, sendRawTransaction, signatureBytesToBase58, updateSignatureDictionary, validateKnownSolanaChain } from './chunk-QKVL45F6.mjs';
-export { AccountElement, UnifiedProvider as AppProvider, BalanceElement, ClusterElement, ConnectorProvider, DisconnectElement, TokenListElement, TransactionHistoryElement, UnifiedProvider, WalletListElement, useAccount, useBalance, useCluster, useConnector, useConnectorClient, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo } from './chunk-3STZXVXD.mjs';
-export { ClipboardErrorType, ConfigurationError, ConnectionError, ConnectorClient, ConnectorError, ConnectorErrorBoundary, Errors, NetworkError, PUBLIC_RPC_ENDPOINTS, TransactionError, TransactionSignerError, ValidationError, WalletErrorType, copyAddressToClipboard, copySignatureToClipboard, copyToClipboard, createGillTransactionSigner, createKitTransactionSigner, createTransactionSigner, formatAddress, formatNumber, formatSOL, formatTokenAmount, getAddressUrl, getBlockUrl, getChainIdForWalletStandard, getClusterChainId, getClusterExplorerUrl, getClusterName, getClusterRpcUrl, getClusterType, getDefaultRpcUrl, getNetworkDisplayName, getPolyfillStatus, getTokenUrl, getTransactionUrl, getUserFriendlyMessage, getWalletsRegistry, installPolyfills, isClipboardAvailable, isConfigurationError, isConnectionError, isConnectorError, isCryptoAvailable, isDevnet, isDevnetCluster, isLocalCluster, isLocalnet, isMainnet, isMainnetCluster, isNetworkError, isPolyfillInstalled, isTestnet, isTestnetCluster, isTransactionError, isTransactionSignerError, isValidationError, normalizeNetwork, toClusterId, toConnectorError, truncate, withErrorBoundary } from './chunk-VMSZJPR5.mjs';
+export { EnhancedStorage, EnhancedStorageAdapter, SOLANA_CHAIN_IDS, address, base58ToSignatureBytes, chainIdToClusterId, chainIdToClusterType, clusterToChainId, copySignature, createConfig, createEnhancedStorageAccount, createEnhancedStorageCluster, createEnhancedStorageWallet, createKitSignersFromWallet, createMessageSignerFromWallet, createSignableMessage, createSolanaDevnet, createSolanaLocalnet, createSolanaMainnet, createSolanaTestnet, createTransactionSendingSignerFromWallet, detectMessageModification, formatSignature, freezeSigner, getAllExplorerUrls, getChainIdFromCluster, getChainIdFromClusterId, getChainIdFromClusterType, getChainIdFromConnection, getClusterIdFromChainId, getClusterTypeFromChainId, getClusterTypeFromConnection, getDefaultConfig, getDefaultMobileConfig, getLatestBlockhash, getSolanaExplorerUrl, getSolanaFmUrl, getSolscanUrl, getXrayUrl, isAccountAddress, isKitConnection, isKnownSolanaChain, isLegacyConnection, isSolanaChain, isUnifiedConfig, isWalletName, sendRawTransaction, signatureBytesToBase58, updateSignatureDictionary, validateKnownSolanaChain } from './chunk-TQRJYZNK.mjs';
+export { AccountElement, UnifiedProvider as AppProvider, BalanceElement, ClusterElement, ConnectorProvider, DisconnectElement, TokenListElement, TransactionHistoryElement, UnifiedProvider, WalletListElement, clearSharedQueryCache, invalidateSharedQuery, useAccount, useBalance, useCluster, useConnector, useConnectorClient, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo } from './chunk-JK47EFJT.mjs';
+export { ClipboardErrorType, ConfigurationError, ConnectionError, ConnectorClient, ConnectorError, ConnectorErrorBoundary, Errors, NetworkError, PUBLIC_RPC_ENDPOINTS, TransactionError, TransactionSignerError, ValidationError, WalletErrorType, copyAddressToClipboard, copySignatureToClipboard, copyToClipboard, createGillTransactionSigner, createKitTransactionSigner, createTransactionSigner, formatAddress, formatBigIntBalance, formatBigIntUsd, formatLamportsToSolSafe, formatNumber, formatSOL, formatTokenAmount, formatTokenBalanceSafe, getAddressUrl, getBlockUrl, getChainIdForWalletStandard, getClusterChainId, getClusterExplorerUrl, getClusterName, getClusterRpcUrl, getClusterType, getDefaultRpcUrl, getNetworkDisplayName, getPolyfillStatus, getTokenUrl, getTransactionUrl, getUserFriendlyMessage, getWalletsRegistry, installPolyfills, isClipboardAvailable, isConfigurationError, isConnectionError, isConnectorError, isCryptoAvailable, isDevnet, isDevnetCluster, isLocalCluster, isLocalnet, isMainnet, isMainnetCluster, isNetworkError, isPolyfillInstalled, isTestnet, isTestnetCluster, isTransactionError, isTransactionSignerError, isValidationError, normalizeNetwork, toClusterId, toConnectorError, truncate, withErrorBoundary } from './chunk-APQGEW7S.mjs';
 export { LAMPORTS_PER_SOL, createSolanaClient, getExplorerLink, getPublicSolanaRpcUrl, lamportsToSol, prepareTransaction, solToLamports } from './chunk-QL3IT3TS.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/react.d.mts

@@ -1,15 +1,16 @@
-import { h as UnifiedConfig, d as ConnectorConfig, M as MobileWalletAdapterConfig, i as ClusterType, A as AccountInfo, V as ClipboardResult, Q as SolanaClient } from './wallet-standard-shim-Dx7H8Ctf.mjs';
-export { b as ConnectorErrorBoundary, C as ConnectorProvider, c as ConnectorSnapshot, e as ConnectorState, D as DefaultConfigOptions, E as ExtendedConnectorConfig, U as UnifiedConfigOptions, W as WalletInfo, g as WalletStandardAccount, f as WalletStandardWallet, u as useConnector, a as useConnectorClient, w as withErrorBoundary } from './wallet-standard-shim-Dx7H8Ctf.mjs';
+import { h as UnifiedConfig, d as ConnectorConfig, M as MobileWalletAdapterConfig, i as ClusterType, A as AccountInfo, V as ClipboardResult, Q as SolanaClient } from './wallet-standard-shim-D4CYG5sU.mjs';
+export { b as ConnectorErrorBoundary, C as ConnectorProvider, c as ConnectorSnapshot, e as ConnectorState, D as DefaultConfigOptions, E as ExtendedConnectorConfig, U as UnifiedConfigOptions, W as WalletInfo, g as WalletStandardAccount, f as WalletStandardWallet, u as useConnector, a as useConnectorClient, w as withErrorBoundary } from './wallet-standard-shim-D4CYG5sU.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, PropsWithChildren } from 'react';
 import { SolanaCluster, SolanaClusterId } from '@wallet-ui/core';
 export { SolanaCluster, SolanaClusterId } from '@wallet-ui/core';
-import { j as TransactionSigner, b as TransactionSignerCapabilities } from './transaction-signer-D9d8nxwb.mjs';
+import { j as TransactionSigner, b as TransactionSignerCapabilities } from './transaction-signer-CpGEvp7S.mjs';
 import { TransactionModifyingSigner } from '@solana/signers';
 import { TransactionMessage, TransactionMessageWithFeePayer, TransactionMessageWithBlockhashLifetime } from '@solana/kit';
 export { Wallet, WalletAccount } from '@wallet-standard/base';
 import '@solana/addresses';
 import '@solana/keys';
+import '@solana-mobile/wallet-standard-mobile';
 import '@solana/transaction-messages';
 import '@solana/web3.js';
 
@@ -511,6 +512,25 @@ interface TokenBalance {
     /** Token logo URL if known */
     logo?: string;
 }
+/**
+ * Options for useBalance hook
+ */
+interface UseBalanceOptions {
+    /** Whether the hook is enabled (default: true) */
+    enabled?: boolean;
+    /** Whether to auto-refresh balance (default: true) */
+    autoRefresh?: boolean;
+    /** Refresh interval in milliseconds (default: 30000) */
+    refreshInterval?: number;
+    /** Time in ms to consider data fresh (default: 0) */
+    staleTimeMs?: number;
+    /** Time in ms to keep cache after unmount (default: 300000) */
+    cacheTimeMs?: number;
+    /** Whether to refetch on mount (default: 'stale') */
+    refetchOnMount?: boolean | 'stale';
+    /** Override the Solana client from provider */
+    client?: SolanaClient | null;
+}
 interface UseBalanceReturn {
     /** SOL balance in SOL (not lamports) */
     solBalance: number;
@@ -524,14 +544,27 @@ interface UseBalanceReturn {
     isLoading: boolean;
     /** Error if balance fetch failed */
     error: Error | null;
-    /** Refetch balance */
-    refetch: () => Promise<void>;
+    /** Refetch balance, optionally with an abort signal */
+    refetch: (options?: {
+        signal?: AbortSignal;
+    }) => Promise<void>;
+    /** Abort any in-flight balance fetch */
+    abort: () => void;
     /** Last updated timestamp */
     lastUpdated: Date | null;
 }
 /**
  * Hook for fetching wallet balance (SOL and tokens).
  *
+ * Features:
+ * - Automatic request deduplication across components
+ * - Shared data with useTokens (single RPC query)
+ * - Token-2022 support
+ * - Shared polling interval (ref-counted)
+ * - Configurable auto-refresh behavior
+ * - Abort support for in-flight requests
+ * - Optional client override
+ *
  * @example Basic usage
  * ```tsx
  * function Balance() {
@@ -542,6 +575,23 @@ interface UseBalanceReturn {
  * }
  * ```
  *
+ * @example With options
+ * ```tsx
+ * function Balance() {
+ *   const { formattedSol, refetch, abort } = useBalance({
+ *     autoRefresh: false,  // Disable polling
+ *     staleTimeMs: 10000,  // Consider data fresh for 10s
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {formattedSol}
+ *       <button onClick={() => refetch()}>Refresh</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
  * @example With token balances
  * ```tsx
  * function TokenBalances() {
@@ -559,7 +609,7 @@ interface UseBalanceReturn {
  * }
  * ```
  */
-declare function useBalance(): UseBalanceReturn;
+declare function useBalance(options?: UseBalanceOptions): UseBalanceReturn;
 
 interface TransactionInfo {
     /** Transaction signature */
@@ -573,7 +623,7 @@ interface TransactionInfo {
     /** Error message if failed */
     error?: string;
     /** Transaction type (if detected) */
-    type: 'sent' | 'received' | 'swap' | 'nft' | 'stake' | 'program' | 'unknown';
+    type: 'sent' | 'received' | 'swap' | 'nft' | 'stake' | 'program' | 'tokenAccountClosed' | 'unknown';
     /** Direction for transfers */
     direction?: 'in' | 'out';
     /** Amount in SOL (for transfers) */
@@ -594,8 +644,32 @@ interface TransactionInfo {
     formattedTime: string;
     /** Explorer URL */
     explorerUrl: string;
+    /** Swap from token (only for swap transactions) */
+    swapFromToken?: {
+        mint: string;
+        symbol?: string;
+        icon?: string;
+    };
+    /** Swap to token (only for swap transactions) */
+    swapToToken?: {
+        mint: string;
+        symbol?: string;
+        icon?: string;
+    };
+    /** Primary program ID involved in the transaction (best-effort) */
+    programId?: string;
+    /** Friendly name for the primary program if known */
+    programName?: string;
+    /** All program IDs involved in the transaction (best-effort) */
+    programIds?: string[];
+    /** Parsed instruction types (best-effort, only available for some programs in `jsonParsed` mode) */
+    instructionTypes?: string[];
+    /** Number of top-level instructions in the transaction message (best-effort) */
+    instructionCount?: number;
 }
 interface UseTransactionsOptions {
+    /** Whether the hook is enabled (default: true) */
+    enabled?: boolean;
     /** Number of transactions to fetch */
     limit?: number;
     /** Whether to auto-refresh */
@@ -604,6 +678,21 @@ interface UseTransactionsOptions {
     refreshInterval?: number;
     /** Fetch full transaction details (slower but more info) */
     fetchDetails?: boolean;
+    /**
+     * Max concurrent `getTransaction` RPC calls when `fetchDetails` is true.
+     * Lower this if you see throttling on public RPCs.
+     *
+     * @default 6
+     */
+    detailsConcurrency?: number;
+    /** Time in ms to consider data fresh (default: 0) */
+    staleTimeMs?: number;
+    /** Time in ms to keep cache after unmount (default: 300000) */
+    cacheTimeMs?: number;
+    /** Whether to refetch on mount (default: 'stale') */
+    refetchOnMount?: boolean | 'stale';
+    /** Override the Solana client from provider */
+    client?: SolanaClient | null;
 }
 interface UseTransactionsReturn {
     /** List of transactions */
@@ -616,8 +705,12 @@ interface UseTransactionsReturn {
     hasMore: boolean;
     /** Load more transactions */
     loadMore: () => Promise<void>;
-    /** Refetch transactions */
-    refetch: () => Promise<void>;
+    /** Refetch transactions, optionally with an abort signal */
+    refetch: (options?: {
+        signal?: AbortSignal;
+    }) => Promise<void>;
+    /** Abort any in-flight transaction fetch */
+    abort: () => void;
     /** Last updated timestamp */
     lastUpdated: Date | null;
 }
@@ -671,8 +764,12 @@ interface Token {
     isFrozen: boolean;
     /** Owner address */
     owner: string;
+    /** Which token program (token or token-2022) */
+    programId?: 'token' | 'token-2022';
 }
 interface UseTokensOptions {
+    /** Whether the hook is enabled (default: true) */
+    enabled?: boolean;
     /** Whether to include zero balance tokens */
     includeZeroBalance?: boolean;
     /** Whether to auto-refresh */
@@ -683,6 +780,14 @@ interface UseTokensOptions {
     fetchMetadata?: boolean;
     /** Include native SOL balance */
     includeNativeSol?: boolean;
+    /** Time in ms to consider data fresh (default: 0) */
+    staleTimeMs?: number;
+    /** Time in ms to keep cache after unmount (default: 300000) */
+    cacheTimeMs?: number;
+    /** Whether to refetch on mount (default: 'stale') */
+    refetchOnMount?: boolean | 'stale';
+    /** Override the Solana client from provider */
+    client?: SolanaClient | null;
 }
 interface UseTokensReturn {
     /** List of tokens */
@@ -691,8 +796,12 @@ interface UseTokensReturn {
     isLoading: boolean;
     /** Error if fetch failed */
     error: Error | null;
-    /** Refetch tokens */
-    refetch: () => Promise<void>;
+    /** Refetch tokens, optionally with an abort signal */
+    refetch: (options?: {
+        signal?: AbortSignal;
+    }) => Promise<void>;
+    /** Abort any in-flight token fetch */
+    abort: () => void;
     /** Last updated timestamp */
     lastUpdated: Date | null;
     /** Total number of token accounts */
@@ -702,6 +811,15 @@ interface UseTokensReturn {
  * Hook for fetching wallet token holdings.
  * Fetches metadata (name, symbol, icon) from Solana Token List API and USD prices from CoinGecko.
  *
+ * Features:
+ * - Automatic request deduplication across components
+ * - Shared data with useBalance (single RPC query)
+ * - Token-2022 support
+ * - Shared polling interval (ref-counted)
+ * - Configurable auto-refresh behavior
+ * - Abort support for in-flight requests
+ * - Optional client override
+ *
  * @example Basic usage
  * ```tsx
  * function TokenList() {
@@ -722,9 +840,38 @@ interface UseTokensReturn {
  *   );
  * }
  * ```
+ *
+ * @example With options
+ * ```tsx
+ * function TokenList() {
+ *   const { tokens, refetch, abort } = useTokens({
+ *     autoRefresh: true,
+ *     refreshInterval: 30000,
+ *     includeNativeSol: true,
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {tokens.map(token => (
+ *         <div key={token.mint}>{token.symbol}: {token.formatted}</div>
+ *       ))}
+ *       <button onClick={() => refetch()}>Refresh</button>
+ *     </div>
+ *   );
+ * }
+ * ```
  */
 declare function useTokens(options?: UseTokensOptions): UseTokensReturn;
 
+/**
+ * Invalidate a query, causing it to refetch on next access
+ */
+declare function invalidateSharedQuery(key: string): void;
+/**
+ * Clear all cached queries (useful for logout/disconnect)
+ */
+declare function clearSharedQueryCache(): void;
+
 interface DisconnectElementProps {
     /** Display variant */
     variant?: 'button' | 'menuitem' | 'link';
@@ -1032,6 +1179,20 @@ interface TransactionHistoryElementRenderProps {
 interface TransactionHistoryElementProps {
     /** Number of transactions to display */
     limit?: number;
+    /**
+     * Fetch full transaction details (slower, but enables richer parsing like token icons + swap detection).
+     *
+     * Passed through to `useTransactions({ fetchDetails })`.
+     * @default true
+     */
+    fetchDetails?: boolean;
+    /**
+     * Max concurrent `getTransaction` RPC calls when `fetchDetails` is true.
+     *
+     * Passed through to `useTransactions({ detailsConcurrency })`.
+     * @default 6
+     */
+    detailsConcurrency?: number;
     /** Show transaction status */
     showStatus?: boolean;
     /** Show transaction time */
@@ -1062,6 +1223,11 @@ interface TransactionHistoryElementProps {
  * <TransactionHistoryElement limit={10} showLoadMore />
  * ```
  *
+ * @example Throttle-safe details fetching (recommended for public RPCs)
+ * ```tsx
+ * <TransactionHistoryElement limit={10} fetchDetails detailsConcurrency={4} />
+ * ```
+ *
  * @example Custom item render
  * ```tsx
  * <TransactionHistoryElement
@@ -1073,7 +1239,7 @@ interface TransactionHistoryElementProps {
  * />
  * ```
  */
-declare function TransactionHistoryElement({ limit, showStatus, showTime, className, variant, showLoadMore, showSkeleton, render, renderItem, }: TransactionHistoryElementProps): react_jsx_runtime.JSX.Element;
+declare function TransactionHistoryElement({ limit, fetchDetails, detailsConcurrency, showStatus, showTime, className, variant, showLoadMore, showSkeleton, render, renderItem, }: TransactionHistoryElementProps): react_jsx_runtime.JSX.Element;
 declare namespace TransactionHistoryElement {
     var displayName: string;
 }
@@ -1133,4 +1299,4 @@ declare namespace TokenListElement {
     var displayName: string;
 }
 
-export { AccountElement, type AccountElementProps, type AccountElementRenderProps, AccountInfo, UnifiedProvider as AppProvider, BalanceElement, type BalanceElementProps, type BalanceElementRenderProps, ClusterElement, type ClusterElementProps, type ClusterElementRenderProps, ClusterType, ConnectorConfig, DisconnectElement, type DisconnectElementProps, MobileWalletAdapterConfig, type Token, type TokenBalance, TokenListElement, type TokenListElementProps, type TokenListElementRenderProps, TransactionHistoryElement, type TransactionHistoryElementProps, type TransactionHistoryElementRenderProps, type TransactionInfo, type TransactionPrepareOptions, UnifiedConfig, UnifiedProvider, type UnifiedProviderProps, type UseAccountReturn, type UseBalanceReturn, type UseClusterReturn, type UseGillSolanaClientReturn, type UseGillTransactionSignerReturn, type UseKitTransactionSignerReturn, type UseSolanaClientReturn, type UseTokensOptions, type UseTokensReturn, type UseTransactionPreparerReturn, type UseTransactionSignerReturn, type UseTransactionsOptions, type UseTransactionsReturn, type UseWalletInfoReturn, WalletListElement, type WalletListElementProps, type WalletListElementRenderProps, type WalletListElementWalletProps, useAccount, useBalance, useCluster, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo };
+export { AccountElement, type AccountElementProps, type AccountElementRenderProps, AccountInfo, UnifiedProvider as AppProvider, BalanceElement, type BalanceElementProps, type BalanceElementRenderProps, ClusterElement, type ClusterElementProps, type ClusterElementRenderProps, ClusterType, ConnectorConfig, DisconnectElement, type DisconnectElementProps, MobileWalletAdapterConfig, type Token, type TokenBalance, TokenListElement, type TokenListElementProps, type TokenListElementRenderProps, TransactionHistoryElement, type TransactionHistoryElementProps, type TransactionHistoryElementRenderProps, type TransactionInfo, type TransactionPrepareOptions, UnifiedConfig, UnifiedProvider, type UnifiedProviderProps, type UseAccountReturn, type UseBalanceOptions, type UseBalanceReturn, type UseClusterReturn, type UseGillSolanaClientReturn, type UseGillTransactionSignerReturn, type UseKitTransactionSignerReturn, type UseSolanaClientReturn, type UseTokensOptions, type UseTokensReturn, type UseTransactionPreparerReturn, type UseTransactionSignerReturn, type UseTransactionsOptions, type UseTransactionsReturn, type UseWalletInfoReturn, WalletListElement, type WalletListElementProps, type WalletListElementRenderProps, type WalletListElementWalletProps, clearSharedQueryCache, invalidateSharedQuery, useAccount, useBalance, useCluster, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo };

package/dist/react.d.ts

@@ -1,15 +1,16 @@
-import { h as UnifiedConfig, d as ConnectorConfig, M as MobileWalletAdapterConfig, i as ClusterType, A as AccountInfo, V as ClipboardResult, Q as SolanaClient } from './wallet-standard-shim--YcrQNRt.js';
-export { b as ConnectorErrorBoundary, C as ConnectorProvider, c as ConnectorSnapshot, e as ConnectorState, D as DefaultConfigOptions, E as ExtendedConnectorConfig, U as UnifiedConfigOptions, W as WalletInfo, g as WalletStandardAccount, f as WalletStandardWallet, u as useConnector, a as useConnectorClient, w as withErrorBoundary } from './wallet-standard-shim--YcrQNRt.js';
+import { h as UnifiedConfig, d as ConnectorConfig, M as MobileWalletAdapterConfig, i as ClusterType, A as AccountInfo, V as ClipboardResult, Q as SolanaClient } from './wallet-standard-shim-DiMvGjOk.js';
+export { b as ConnectorErrorBoundary, C as ConnectorProvider, c as ConnectorSnapshot, e as ConnectorState, D as DefaultConfigOptions, E as ExtendedConnectorConfig, U as UnifiedConfigOptions, W as WalletInfo, g as WalletStandardAccount, f as WalletStandardWallet, u as useConnector, a as useConnectorClient, w as withErrorBoundary } from './wallet-standard-shim-DiMvGjOk.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, PropsWithChildren } from 'react';
 import { SolanaCluster, SolanaClusterId } from '@wallet-ui/core';
 export { SolanaCluster, SolanaClusterId } from '@wallet-ui/core';
-import { j as TransactionSigner, b as TransactionSignerCapabilities } from './transaction-signer-D9d8nxwb.js';
+import { j as TransactionSigner, b as TransactionSignerCapabilities } from './transaction-signer-CpGEvp7S.js';
 import { TransactionModifyingSigner } from '@solana/signers';
 import { TransactionMessage, TransactionMessageWithFeePayer, TransactionMessageWithBlockhashLifetime } from '@solana/kit';
 export { Wallet, WalletAccount } from '@wallet-standard/base';
 import '@solana/addresses';
 import '@solana/keys';
+import '@solana-mobile/wallet-standard-mobile';
 import '@solana/transaction-messages';
 import '@solana/web3.js';
 
@@ -511,6 +512,25 @@ interface TokenBalance {
     /** Token logo URL if known */
     logo?: string;
 }
+/**
+ * Options for useBalance hook
+ */
+interface UseBalanceOptions {
+    /** Whether the hook is enabled (default: true) */
+    enabled?: boolean;
+    /** Whether to auto-refresh balance (default: true) */
+    autoRefresh?: boolean;
+    /** Refresh interval in milliseconds (default: 30000) */
+    refreshInterval?: number;
+    /** Time in ms to consider data fresh (default: 0) */
+    staleTimeMs?: number;
+    /** Time in ms to keep cache after unmount (default: 300000) */
+    cacheTimeMs?: number;
+    /** Whether to refetch on mount (default: 'stale') */
+    refetchOnMount?: boolean | 'stale';
+    /** Override the Solana client from provider */
+    client?: SolanaClient | null;
+}
 interface UseBalanceReturn {
     /** SOL balance in SOL (not lamports) */
     solBalance: number;
@@ -524,14 +544,27 @@ interface UseBalanceReturn {
     isLoading: boolean;
     /** Error if balance fetch failed */
     error: Error | null;
-    /** Refetch balance */
-    refetch: () => Promise<void>;
+    /** Refetch balance, optionally with an abort signal */
+    refetch: (options?: {
+        signal?: AbortSignal;
+    }) => Promise<void>;
+    /** Abort any in-flight balance fetch */
+    abort: () => void;
     /** Last updated timestamp */
     lastUpdated: Date | null;
 }
 /**
  * Hook for fetching wallet balance (SOL and tokens).
  *
+ * Features:
+ * - Automatic request deduplication across components
+ * - Shared data with useTokens (single RPC query)
+ * - Token-2022 support
+ * - Shared polling interval (ref-counted)
+ * - Configurable auto-refresh behavior
+ * - Abort support for in-flight requests
+ * - Optional client override
+ *
  * @example Basic usage
  * ```tsx
  * function Balance() {
@@ -542,6 +575,23 @@ interface UseBalanceReturn {
  * }
  * ```
  *
+ * @example With options
+ * ```tsx
+ * function Balance() {
+ *   const { formattedSol, refetch, abort } = useBalance({
+ *     autoRefresh: false,  // Disable polling
+ *     staleTimeMs: 10000,  // Consider data fresh for 10s
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {formattedSol}
+ *       <button onClick={() => refetch()}>Refresh</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
  * @example With token balances
  * ```tsx
  * function TokenBalances() {
@@ -559,7 +609,7 @@ interface UseBalanceReturn {
  * }
  * ```
  */
-declare function useBalance(): UseBalanceReturn;
+declare function useBalance(options?: UseBalanceOptions): UseBalanceReturn;
 
 interface TransactionInfo {
     /** Transaction signature */
@@ -573,7 +623,7 @@ interface TransactionInfo {
     /** Error message if failed */
     error?: string;
     /** Transaction type (if detected) */
-    type: 'sent' | 'received' | 'swap' | 'nft' | 'stake' | 'program' | 'unknown';
+    type: 'sent' | 'received' | 'swap' | 'nft' | 'stake' | 'program' | 'tokenAccountClosed' | 'unknown';
     /** Direction for transfers */
     direction?: 'in' | 'out';
     /** Amount in SOL (for transfers) */
@@ -594,8 +644,32 @@ interface TransactionInfo {
     formattedTime: string;
     /** Explorer URL */
     explorerUrl: string;
+    /** Swap from token (only for swap transactions) */
+    swapFromToken?: {
+        mint: string;
+        symbol?: string;
+        icon?: string;
+    };
+    /** Swap to token (only for swap transactions) */
+    swapToToken?: {
+        mint: string;
+        symbol?: string;
+        icon?: string;
+    };
+    /** Primary program ID involved in the transaction (best-effort) */
+    programId?: string;
+    /** Friendly name for the primary program if known */
+    programName?: string;
+    /** All program IDs involved in the transaction (best-effort) */
+    programIds?: string[];
+    /** Parsed instruction types (best-effort, only available for some programs in `jsonParsed` mode) */
+    instructionTypes?: string[];
+    /** Number of top-level instructions in the transaction message (best-effort) */
+    instructionCount?: number;
 }
 interface UseTransactionsOptions {
+    /** Whether the hook is enabled (default: true) */
+    enabled?: boolean;
     /** Number of transactions to fetch */
     limit?: number;
     /** Whether to auto-refresh */
@@ -604,6 +678,21 @@ interface UseTransactionsOptions {
     refreshInterval?: number;
     /** Fetch full transaction details (slower but more info) */
     fetchDetails?: boolean;
+    /**
+     * Max concurrent `getTransaction` RPC calls when `fetchDetails` is true.
+     * Lower this if you see throttling on public RPCs.
+     *
+     * @default 6
+     */
+    detailsConcurrency?: number;
+    /** Time in ms to consider data fresh (default: 0) */
+    staleTimeMs?: number;
+    /** Time in ms to keep cache after unmount (default: 300000) */
+    cacheTimeMs?: number;
+    /** Whether to refetch on mount (default: 'stale') */
+    refetchOnMount?: boolean | 'stale';
+    /** Override the Solana client from provider */
+    client?: SolanaClient | null;
 }
 interface UseTransactionsReturn {
     /** List of transactions */
@@ -616,8 +705,12 @@ interface UseTransactionsReturn {
     hasMore: boolean;
     /** Load more transactions */
     loadMore: () => Promise<void>;
-    /** Refetch transactions */
-    refetch: () => Promise<void>;
+    /** Refetch transactions, optionally with an abort signal */
+    refetch: (options?: {
+        signal?: AbortSignal;
+    }) => Promise<void>;
+    /** Abort any in-flight transaction fetch */
+    abort: () => void;
     /** Last updated timestamp */
     lastUpdated: Date | null;
 }
@@ -671,8 +764,12 @@ interface Token {
     isFrozen: boolean;
     /** Owner address */
     owner: string;
+    /** Which token program (token or token-2022) */
+    programId?: 'token' | 'token-2022';
 }
 interface UseTokensOptions {
+    /** Whether the hook is enabled (default: true) */
+    enabled?: boolean;
     /** Whether to include zero balance tokens */
     includeZeroBalance?: boolean;
     /** Whether to auto-refresh */
@@ -683,6 +780,14 @@ interface UseTokensOptions {
     fetchMetadata?: boolean;
     /** Include native SOL balance */
     includeNativeSol?: boolean;
+    /** Time in ms to consider data fresh (default: 0) */
+    staleTimeMs?: number;
+    /** Time in ms to keep cache after unmount (default: 300000) */
+    cacheTimeMs?: number;
+    /** Whether to refetch on mount (default: 'stale') */
+    refetchOnMount?: boolean | 'stale';
+    /** Override the Solana client from provider */
+    client?: SolanaClient | null;
 }
 interface UseTokensReturn {
     /** List of tokens */
@@ -691,8 +796,12 @@ interface UseTokensReturn {
     isLoading: boolean;
     /** Error if fetch failed */
     error: Error | null;
-    /** Refetch tokens */
-    refetch: () => Promise<void>;
+    /** Refetch tokens, optionally with an abort signal */
+    refetch: (options?: {
+        signal?: AbortSignal;
+    }) => Promise<void>;
+    /** Abort any in-flight token fetch */
+    abort: () => void;
     /** Last updated timestamp */
     lastUpdated: Date | null;
     /** Total number of token accounts */
@@ -702,6 +811,15 @@ interface UseTokensReturn {
  * Hook for fetching wallet token holdings.
  * Fetches metadata (name, symbol, icon) from Solana Token List API and USD prices from CoinGecko.
  *
+ * Features:
+ * - Automatic request deduplication across components
+ * - Shared data with useBalance (single RPC query)
+ * - Token-2022 support
+ * - Shared polling interval (ref-counted)
+ * - Configurable auto-refresh behavior
+ * - Abort support for in-flight requests
+ * - Optional client override
+ *
  * @example Basic usage
  * ```tsx
  * function TokenList() {
@@ -722,9 +840,38 @@ interface UseTokensReturn {
  *   );
  * }
  * ```
+ *
+ * @example With options
+ * ```tsx
+ * function TokenList() {
+ *   const { tokens, refetch, abort } = useTokens({
+ *     autoRefresh: true,
+ *     refreshInterval: 30000,
+ *     includeNativeSol: true,
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {tokens.map(token => (
+ *         <div key={token.mint}>{token.symbol}: {token.formatted}</div>
+ *       ))}
+ *       <button onClick={() => refetch()}>Refresh</button>
+ *     </div>
+ *   );
+ * }
+ * ```
  */
 declare function useTokens(options?: UseTokensOptions): UseTokensReturn;
 
+/**
+ * Invalidate a query, causing it to refetch on next access
+ */
+declare function invalidateSharedQuery(key: string): void;
+/**
+ * Clear all cached queries (useful for logout/disconnect)
+ */
+declare function clearSharedQueryCache(): void;
+
 interface DisconnectElementProps {
     /** Display variant */
     variant?: 'button' | 'menuitem' | 'link';
@@ -1032,6 +1179,20 @@ interface TransactionHistoryElementRenderProps {
 interface TransactionHistoryElementProps {
     /** Number of transactions to display */
     limit?: number;
+    /**
+     * Fetch full transaction details (slower, but enables richer parsing like token icons + swap detection).
+     *
+     * Passed through to `useTransactions({ fetchDetails })`.
+     * @default true
+     */
+    fetchDetails?: boolean;
+    /**
+     * Max concurrent `getTransaction` RPC calls when `fetchDetails` is true.
+     *
+     * Passed through to `useTransactions({ detailsConcurrency })`.
+     * @default 6
+     */
+    detailsConcurrency?: number;
     /** Show transaction status */
     showStatus?: boolean;
     /** Show transaction time */
@@ -1062,6 +1223,11 @@ interface TransactionHistoryElementProps {
  * <TransactionHistoryElement limit={10} showLoadMore />
  * ```
  *
+ * @example Throttle-safe details fetching (recommended for public RPCs)
+ * ```tsx
+ * <TransactionHistoryElement limit={10} fetchDetails detailsConcurrency={4} />
+ * ```
+ *
  * @example Custom item render
  * ```tsx
  * <TransactionHistoryElement
@@ -1073,7 +1239,7 @@ interface TransactionHistoryElementProps {
  * />
  * ```
  */
-declare function TransactionHistoryElement({ limit, showStatus, showTime, className, variant, showLoadMore, showSkeleton, render, renderItem, }: TransactionHistoryElementProps): react_jsx_runtime.JSX.Element;
+declare function TransactionHistoryElement({ limit, fetchDetails, detailsConcurrency, showStatus, showTime, className, variant, showLoadMore, showSkeleton, render, renderItem, }: TransactionHistoryElementProps): react_jsx_runtime.JSX.Element;
 declare namespace TransactionHistoryElement {
     var displayName: string;
 }
@@ -1133,4 +1299,4 @@ declare namespace TokenListElement {
     var displayName: string;
 }
 
-export { AccountElement, type AccountElementProps, type AccountElementRenderProps, AccountInfo, UnifiedProvider as AppProvider, BalanceElement, type BalanceElementProps, type BalanceElementRenderProps, ClusterElement, type ClusterElementProps, type ClusterElementRenderProps, ClusterType, ConnectorConfig, DisconnectElement, type DisconnectElementProps, MobileWalletAdapterConfig, type Token, type TokenBalance, TokenListElement, type TokenListElementProps, type TokenListElementRenderProps, TransactionHistoryElement, type TransactionHistoryElementProps, type TransactionHistoryElementRenderProps, type TransactionInfo, type TransactionPrepareOptions, UnifiedConfig, UnifiedProvider, type UnifiedProviderProps, type UseAccountReturn, type UseBalanceReturn, type UseClusterReturn, type UseGillSolanaClientReturn, type UseGillTransactionSignerReturn, type UseKitTransactionSignerReturn, type UseSolanaClientReturn, type UseTokensOptions, type UseTokensReturn, type UseTransactionPreparerReturn, type UseTransactionSignerReturn, type UseTransactionsOptions, type UseTransactionsReturn, type UseWalletInfoReturn, WalletListElement, type WalletListElementProps, type WalletListElementRenderProps, type WalletListElementWalletProps, useAccount, useBalance, useCluster, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo };
+export { AccountElement, type AccountElementProps, type AccountElementRenderProps, AccountInfo, UnifiedProvider as AppProvider, BalanceElement, type BalanceElementProps, type BalanceElementRenderProps, ClusterElement, type ClusterElementProps, type ClusterElementRenderProps, ClusterType, ConnectorConfig, DisconnectElement, type DisconnectElementProps, MobileWalletAdapterConfig, type Token, type TokenBalance, TokenListElement, type TokenListElementProps, type TokenListElementRenderProps, TransactionHistoryElement, type TransactionHistoryElementProps, type TransactionHistoryElementRenderProps, type TransactionInfo, type TransactionPrepareOptions, UnifiedConfig, UnifiedProvider, type UnifiedProviderProps, type UseAccountReturn, type UseBalanceOptions, type UseBalanceReturn, type UseClusterReturn, type UseGillSolanaClientReturn, type UseGillTransactionSignerReturn, type UseKitTransactionSignerReturn, type UseSolanaClientReturn, type UseTokensOptions, type UseTokensReturn, type UseTransactionPreparerReturn, type UseTransactionSignerReturn, type UseTransactionsOptions, type UseTransactionsReturn, type UseWalletInfoReturn, WalletListElement, type WalletListElementProps, type WalletListElementRenderProps, type WalletListElementWalletProps, clearSharedQueryCache, invalidateSharedQuery, useAccount, useBalance, useCluster, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo };