@solana/connector 0.1.7 → 0.1.8

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-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';
+export { EnhancedStorage, EnhancedStorageAdapter, SOLANA_CHAIN_IDS, address, chainIdToClusterId, chainIdToClusterType, clusterToChainId, copySignature, createEnhancedStorageAccount, createEnhancedStorageCluster, createEnhancedStorageWallet, createSignableMessage, createSolanaDevnet, createSolanaLocalnet, createSolanaMainnet, createSolanaTestnet, formatSignature, getAllExplorerUrls, getChainIdFromCluster, getChainIdFromClusterId, getChainIdFromClusterType, getChainIdFromConnection, getClusterIdFromChainId, getClusterTypeFromChainId, getClusterTypeFromConnection, getDefaultConfig, getDefaultMobileConfig, getLatestBlockhash, getSolanaExplorerUrl, getSolanaFmUrl, getSolscanUrl, getXrayUrl, isAccountAddress, isKitConnection, isKnownSolanaChain, isLegacyConnection, isSolanaChain, isWalletName, parseConfigOptions, sendRawTransaction, validateConfigOptions, validateKnownSolanaChain } from './chunk-G575OAT4.mjs';
+export { AccountElement, AppProvider, BalanceElement, ClusterElement, ConnectorProvider, DisconnectElement, SkeletonShine, TokenListElement, TransactionHistoryElement, UnifiedProvider, WalletListElement, clearSharedQueryCache, clearTokenCaches, getBalanceQueryKey, getTokensQueryKey, getTransactionsQueryKey, getWalletAssetsQueryKey, invalidateSharedQuery, useAccount, useBalance, useCluster, useConnector, useConnectorClient, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo } from './chunk-TTOKQAPX.mjs';
+export { ClipboardErrorType, ConnectorClient, ConnectorErrorBoundary, PUBLIC_RPC_ENDPOINTS, TransactionSignerError, 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, getWalletsRegistry, installPolyfills, isClipboardAvailable, isCryptoAvailable, isDevnet, isDevnetCluster, isLocalCluster, isLocalnet, isMainnet, isMainnetCluster, isPolyfillInstalled, isTestnet, isTestnetCluster, isTransactionSignerError, normalizeNetwork, ready, toClusterId, truncate, withErrorBoundary } from './chunk-6F6M6L7R.mjs';
+export { ConfigurationError, ConnectionError, ConnectorError, Errors, LAMPORTS_PER_SOL, NetworkError, TransactionError, ValidationError, base58ToSignatureBytes, createKitSignersFromWallet, createMessageSignerFromWallet, createSolanaClient, createTransactionSendingSignerFromWallet, detectMessageModification, freezeSigner, getExplorerLink, getPublicSolanaRpcUrl, getUserFriendlyMessage, isConfigurationError, isConnectionError, isConnectorError, isFailure, isNetworkError, isSuccess, isTransactionError, isValidationError, lamportsToSol, prepareTransaction, signatureBytesToBase58, solToLamports, toConnectorError, tryCatch, tryCatchSync, updateSignatureDictionary } from './chunk-J7DHGLW6.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/react.d.mts

@@ -1,10 +1,10 @@
-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 { d as ConnectorConfig, M as MobileWalletAdapterConfig, h as ClusterType, A as AccountInfo, T as ClipboardResult, s as SolanaClient } from './standard-shim-CT49DM5l.mjs';
+export { b as ConnectorErrorBoundary, C as ConnectorProvider, c as ConnectorSnapshot, e as ConnectorState, D as DefaultConfigOptions, E as ExtendedConnectorConfig, W as WalletInfo, g as WalletStandardAccount, f as WalletStandardWallet, u as useConnector, a as useConnectorClient, w as withErrorBoundary } from './standard-shim-CT49DM5l.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-CpGEvp7S.mjs';
+import { a as TransactionSigner, v as TransactionSignerCapabilities } from './transaction-signer-T-KVQFi8.mjs';
 import { TransactionModifyingSigner } from '@solana/signers';
 import { TransactionMessage, TransactionMessageWithFeePayer, TransactionMessageWithBlockhashLifetime } from '@solana/kit';
 export { Wallet, WalletAccount } from '@wallet-standard/base';
@@ -14,17 +14,23 @@ import '@solana-mobile/wallet-standard-mobile';
 import '@solana/transaction-messages';
 import '@solana/web3.js';
 
-interface UnifiedProviderProps {
+interface AppProviderProps {
     children: ReactNode;
-    config?: UnifiedConfig;
+    /** ConnectorKit configuration */
     connectorConfig?: ConnectorConfig;
+    /** Mobile Wallet Adapter configuration */
     mobile?: MobileWalletAdapterConfig;
+    /** Optional additional providers to wrap around children */
     providers?: Array<{
         component: ComponentType<PropsWithChildren>;
         props?: Record<string, unknown>;
     }>;
 }
-declare function UnifiedProvider({ children, config, connectorConfig, mobile, providers }: UnifiedProviderProps): react_jsx_runtime.JSX.Element;
+declare function AppProvider({ children, connectorConfig, mobile, providers }: AppProviderProps): react_jsx_runtime.JSX.Element;
+/** @deprecated Use `AppProvider` instead */
+declare const UnifiedProvider: typeof AppProvider;
+/** @deprecated Use `AppProviderProps` instead */
+type UnifiedProviderProps = AppProviderProps;
 
 /**
  * @solana/connector - useCluster hook
@@ -496,6 +502,24 @@ interface UseTransactionPreparerReturn {
  */
 declare function useTransactionPreparer(): UseTransactionPreparerReturn;
 
+/**
+ * Generate the query key for balance data.
+ * Use this to invalidate the balance cache externally.
+ *
+ * Note: Balance and tokens share the same underlying cache (wallet-assets).
+ *
+ * @param rpcUrl - The RPC URL being used
+ * @param address - The wallet address
+ * @returns The query key string, or null if params are invalid
+ *
+ * @example
+ * ```tsx
+ * // Invalidate balance after sending a transaction
+ * const key = getBalanceQueryKey(rpcUrl, address);
+ * if (key) invalidateSharedQuery(key);
+ * ```
+ */
+declare function getBalanceQueryKey(rpcUrl: string | null, address: string | null): string | null;
 interface TokenBalance {
     /** Token mint address */
     mint: string;
@@ -611,6 +635,35 @@ interface UseBalanceReturn {
  */
 declare function useBalance(options?: UseBalanceOptions): UseBalanceReturn;
 
+/**
+ * Options for generating the transactions query key
+ */
+interface TransactionsQueryKeyOptions {
+    rpcUrl: string;
+    address: string;
+    clusterId: SolanaClusterId;
+    limit?: number;
+    fetchDetails?: boolean;
+}
+/**
+ * Generate the query key for transactions data.
+ * Use this to invalidate the transactions cache externally.
+ *
+ * @param options - Query key options
+ * @returns The query key string, or null if required params are missing
+ *
+ * @example
+ * ```tsx
+ * // Invalidate transactions after sending a new transaction
+ * const key = getTransactionsQueryKey({
+ *   rpcUrl: 'https://api.mainnet-beta.solana.com',
+ *   address: 'ABC123...',
+ *   clusterId: 'solana:mainnet',
+ * });
+ * if (key) invalidateSharedQuery(key);
+ * ```
+ */
+declare function getTransactionsQueryKey(options: TransactionsQueryKeyOptions): string | null;
 interface TransactionInfo {
     /** Transaction signature */
     signature: string;
@@ -739,6 +792,24 @@ interface UseTransactionsReturn {
  */
 declare function useTransactions(options?: UseTransactionsOptions): UseTransactionsReturn;
 
+/**
+ * Generate the query key for tokens data.
+ * Use this to invalidate the tokens cache externally.
+ *
+ * Note: Balance and tokens share the same underlying cache (wallet-assets).
+ *
+ * @param rpcUrl - The RPC URL being used
+ * @param address - The wallet address
+ * @returns The query key string, or null if params are invalid
+ *
+ * @example
+ * ```tsx
+ * // Invalidate tokens after receiving new tokens
+ * const key = getTokensQueryKey(rpcUrl, address);
+ * if (key) invalidateSharedQuery(key);
+ * ```
+ */
+declare function getTokensQueryKey(rpcUrl: string | null, address: string | null): string | null;
 interface Token {
     /** Token mint address */
     mint: string;
@@ -807,6 +878,10 @@ interface UseTokensReturn {
     /** Total number of token accounts */
     totalAccounts: number;
 }
+/**
+ * Clear all token caches. Called on disconnect/session end.
+ */
+declare function clearTokenCaches(): void;
 /**
  * Hook for fetching wallet token holdings.
  * Fetches metadata (name, symbol, icon) from Solana Token List API and USD prices from CoinGecko.
@@ -872,6 +947,23 @@ declare function invalidateSharedQuery(key: string): void;
  */
 declare function clearSharedQueryCache(): void;
 
+/**
+ * Generate the query key for wallet assets.
+ * Use this to invalidate the cache externally.
+ *
+ * @param rpcUrl - The RPC URL being used
+ * @param address - The wallet address
+ * @returns The stringified query key, or null if params are invalid
+ *
+ * @example
+ * ```tsx
+ * // Invalidate wallet assets after a transaction
+ * const key = getWalletAssetsQueryKey(rpcUrl, address);
+ * if (key) invalidateSharedQuery(key);
+ * ```
+ */
+declare function getWalletAssetsQueryKey(rpcUrl: string | null, address: string | null): string | null;
+
 interface DisconnectElementProps {
     /** Display variant */
     variant?: 'button' | 'menuitem' | 'link';
@@ -1299,4 +1391,13 @@ 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 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 };
+/**
+ * Shine overlay component for skeleton loading states.
+ * Injects CSS styles once and provides the animated shine effect.
+ */
+declare function SkeletonShine(): react_jsx_runtime.JSX.Element;
+declare namespace SkeletonShine {
+    var displayName: string;
+}
+
+export { AccountElement, type AccountElementProps, type AccountElementRenderProps, AccountInfo, AppProvider, type AppProviderProps, BalanceElement, type BalanceElementProps, type BalanceElementRenderProps, ClusterElement, type ClusterElementProps, type ClusterElementRenderProps, ClusterType, ConnectorConfig, DisconnectElement, type DisconnectElementProps, MobileWalletAdapterConfig, SkeletonShine, type Token, type TokenBalance, TokenListElement, type TokenListElementProps, type TokenListElementRenderProps, TransactionHistoryElement, type TransactionHistoryElementProps, type TransactionHistoryElementRenderProps, type TransactionInfo, type TransactionPrepareOptions, type TransactionsQueryKeyOptions, 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, type WalletDisplayInfo, WalletListElement, type WalletListElementProps, type WalletListElementRenderProps, type WalletListElementWalletProps, clearSharedQueryCache, clearTokenCaches, getBalanceQueryKey, getTokensQueryKey, getTransactionsQueryKey, getWalletAssetsQueryKey, invalidateSharedQuery, useAccount, useBalance, useCluster, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo };

package/dist/react.d.ts

@@ -1,10 +1,10 @@
-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 { d as ConnectorConfig, M as MobileWalletAdapterConfig, h as ClusterType, A as AccountInfo, T as ClipboardResult, s as SolanaClient } from './standard-shim-D9guL5fz.js';
+export { b as ConnectorErrorBoundary, C as ConnectorProvider, c as ConnectorSnapshot, e as ConnectorState, D as DefaultConfigOptions, E as ExtendedConnectorConfig, W as WalletInfo, g as WalletStandardAccount, f as WalletStandardWallet, u as useConnector, a as useConnectorClient, w as withErrorBoundary } from './standard-shim-D9guL5fz.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-CpGEvp7S.js';
+import { a as TransactionSigner, v as TransactionSignerCapabilities } from './transaction-signer-T-KVQFi8.js';
 import { TransactionModifyingSigner } from '@solana/signers';
 import { TransactionMessage, TransactionMessageWithFeePayer, TransactionMessageWithBlockhashLifetime } from '@solana/kit';
 export { Wallet, WalletAccount } from '@wallet-standard/base';
@@ -14,17 +14,23 @@ import '@solana-mobile/wallet-standard-mobile';
 import '@solana/transaction-messages';
 import '@solana/web3.js';
 
-interface UnifiedProviderProps {
+interface AppProviderProps {
     children: ReactNode;
-    config?: UnifiedConfig;
+    /** ConnectorKit configuration */
     connectorConfig?: ConnectorConfig;
+    /** Mobile Wallet Adapter configuration */
     mobile?: MobileWalletAdapterConfig;
+    /** Optional additional providers to wrap around children */
     providers?: Array<{
         component: ComponentType<PropsWithChildren>;
         props?: Record<string, unknown>;
     }>;
 }
-declare function UnifiedProvider({ children, config, connectorConfig, mobile, providers }: UnifiedProviderProps): react_jsx_runtime.JSX.Element;
+declare function AppProvider({ children, connectorConfig, mobile, providers }: AppProviderProps): react_jsx_runtime.JSX.Element;
+/** @deprecated Use `AppProvider` instead */
+declare const UnifiedProvider: typeof AppProvider;
+/** @deprecated Use `AppProviderProps` instead */
+type UnifiedProviderProps = AppProviderProps;
 
 /**
  * @solana/connector - useCluster hook
@@ -496,6 +502,24 @@ interface UseTransactionPreparerReturn {
  */
 declare function useTransactionPreparer(): UseTransactionPreparerReturn;
 
+/**
+ * Generate the query key for balance data.
+ * Use this to invalidate the balance cache externally.
+ *
+ * Note: Balance and tokens share the same underlying cache (wallet-assets).
+ *
+ * @param rpcUrl - The RPC URL being used
+ * @param address - The wallet address
+ * @returns The query key string, or null if params are invalid
+ *
+ * @example
+ * ```tsx
+ * // Invalidate balance after sending a transaction
+ * const key = getBalanceQueryKey(rpcUrl, address);
+ * if (key) invalidateSharedQuery(key);
+ * ```
+ */
+declare function getBalanceQueryKey(rpcUrl: string | null, address: string | null): string | null;
 interface TokenBalance {
     /** Token mint address */
     mint: string;
@@ -611,6 +635,35 @@ interface UseBalanceReturn {
  */
 declare function useBalance(options?: UseBalanceOptions): UseBalanceReturn;
 
+/**
+ * Options for generating the transactions query key
+ */
+interface TransactionsQueryKeyOptions {
+    rpcUrl: string;
+    address: string;
+    clusterId: SolanaClusterId;
+    limit?: number;
+    fetchDetails?: boolean;
+}
+/**
+ * Generate the query key for transactions data.
+ * Use this to invalidate the transactions cache externally.
+ *
+ * @param options - Query key options
+ * @returns The query key string, or null if required params are missing
+ *
+ * @example
+ * ```tsx
+ * // Invalidate transactions after sending a new transaction
+ * const key = getTransactionsQueryKey({
+ *   rpcUrl: 'https://api.mainnet-beta.solana.com',
+ *   address: 'ABC123...',
+ *   clusterId: 'solana:mainnet',
+ * });
+ * if (key) invalidateSharedQuery(key);
+ * ```
+ */
+declare function getTransactionsQueryKey(options: TransactionsQueryKeyOptions): string | null;
 interface TransactionInfo {
     /** Transaction signature */
     signature: string;
@@ -739,6 +792,24 @@ interface UseTransactionsReturn {
  */
 declare function useTransactions(options?: UseTransactionsOptions): UseTransactionsReturn;
 
+/**
+ * Generate the query key for tokens data.
+ * Use this to invalidate the tokens cache externally.
+ *
+ * Note: Balance and tokens share the same underlying cache (wallet-assets).
+ *
+ * @param rpcUrl - The RPC URL being used
+ * @param address - The wallet address
+ * @returns The query key string, or null if params are invalid
+ *
+ * @example
+ * ```tsx
+ * // Invalidate tokens after receiving new tokens
+ * const key = getTokensQueryKey(rpcUrl, address);
+ * if (key) invalidateSharedQuery(key);
+ * ```
+ */
+declare function getTokensQueryKey(rpcUrl: string | null, address: string | null): string | null;
 interface Token {
     /** Token mint address */
     mint: string;
@@ -807,6 +878,10 @@ interface UseTokensReturn {
     /** Total number of token accounts */
     totalAccounts: number;
 }
+/**
+ * Clear all token caches. Called on disconnect/session end.
+ */
+declare function clearTokenCaches(): void;
 /**
  * Hook for fetching wallet token holdings.
  * Fetches metadata (name, symbol, icon) from Solana Token List API and USD prices from CoinGecko.
@@ -872,6 +947,23 @@ declare function invalidateSharedQuery(key: string): void;
  */
 declare function clearSharedQueryCache(): void;
 
+/**
+ * Generate the query key for wallet assets.
+ * Use this to invalidate the cache externally.
+ *
+ * @param rpcUrl - The RPC URL being used
+ * @param address - The wallet address
+ * @returns The stringified query key, or null if params are invalid
+ *
+ * @example
+ * ```tsx
+ * // Invalidate wallet assets after a transaction
+ * const key = getWalletAssetsQueryKey(rpcUrl, address);
+ * if (key) invalidateSharedQuery(key);
+ * ```
+ */
+declare function getWalletAssetsQueryKey(rpcUrl: string | null, address: string | null): string | null;
+
 interface DisconnectElementProps {
     /** Display variant */
     variant?: 'button' | 'menuitem' | 'link';
@@ -1299,4 +1391,13 @@ 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 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 };
+/**
+ * Shine overlay component for skeleton loading states.
+ * Injects CSS styles once and provides the animated shine effect.
+ */
+declare function SkeletonShine(): react_jsx_runtime.JSX.Element;
+declare namespace SkeletonShine {
+    var displayName: string;
+}
+
+export { AccountElement, type AccountElementProps, type AccountElementRenderProps, AccountInfo, AppProvider, type AppProviderProps, BalanceElement, type BalanceElementProps, type BalanceElementRenderProps, ClusterElement, type ClusterElementProps, type ClusterElementRenderProps, ClusterType, ConnectorConfig, DisconnectElement, type DisconnectElementProps, MobileWalletAdapterConfig, SkeletonShine, type Token, type TokenBalance, TokenListElement, type TokenListElementProps, type TokenListElementRenderProps, TransactionHistoryElement, type TransactionHistoryElementProps, type TransactionHistoryElementRenderProps, type TransactionInfo, type TransactionPrepareOptions, type TransactionsQueryKeyOptions, 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, type WalletDisplayInfo, WalletListElement, type WalletListElementProps, type WalletListElementRenderProps, type WalletListElementWalletProps, clearSharedQueryCache, clearTokenCaches, getBalanceQueryKey, getTokensQueryKey, getTransactionsQueryKey, getWalletAssetsQueryKey, invalidateSharedQuery, useAccount, useBalance, useCluster, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo };

package/dist/react.js

@@ -1,121 +1,145 @@
 'use strict';
 
-var chunkZ22V3D4E_js = require('./chunk-Z22V3D4E.js');
-var chunkVA6LKXCQ_js = require('./chunk-VA6LKXCQ.js');
+var chunkK3BNIGPX_js = require('./chunk-K3BNIGPX.js');
+var chunkFTXIXM43_js = require('./chunk-FTXIXM43.js');
 
 
 
 Object.defineProperty(exports, "AccountElement", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.AccountElement; }
+  get: function () { return chunkK3BNIGPX_js.AccountElement; }
 });
 Object.defineProperty(exports, "AppProvider", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.UnifiedProvider; }
+  get: function () { return chunkK3BNIGPX_js.AppProvider; }
 });
 Object.defineProperty(exports, "BalanceElement", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.BalanceElement; }
+  get: function () { return chunkK3BNIGPX_js.BalanceElement; }
 });
 Object.defineProperty(exports, "ClusterElement", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.ClusterElement; }
+  get: function () { return chunkK3BNIGPX_js.ClusterElement; }
 });
 Object.defineProperty(exports, "ConnectorProvider", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.ConnectorProvider; }
+  get: function () { return chunkK3BNIGPX_js.ConnectorProvider; }
 });
 Object.defineProperty(exports, "DisconnectElement", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.DisconnectElement; }
+  get: function () { return chunkK3BNIGPX_js.DisconnectElement; }
+});
+Object.defineProperty(exports, "SkeletonShine", {
+  enumerable: true,
+  get: function () { return chunkK3BNIGPX_js.SkeletonShine; }
 });
 Object.defineProperty(exports, "TokenListElement", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.TokenListElement; }
+  get: function () { return chunkK3BNIGPX_js.TokenListElement; }
 });
 Object.defineProperty(exports, "TransactionHistoryElement", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.TransactionHistoryElement; }
+  get: function () { return chunkK3BNIGPX_js.TransactionHistoryElement; }
 });
 Object.defineProperty(exports, "UnifiedProvider", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.UnifiedProvider; }
+  get: function () { return chunkK3BNIGPX_js.UnifiedProvider; }
 });
 Object.defineProperty(exports, "WalletListElement", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.WalletListElement; }
+  get: function () { return chunkK3BNIGPX_js.WalletListElement; }
 });
 Object.defineProperty(exports, "clearSharedQueryCache", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.clearSharedQueryCache; }
+  get: function () { return chunkK3BNIGPX_js.clearSharedQueryCache; }
+});
+Object.defineProperty(exports, "clearTokenCaches", {
+  enumerable: true,
+  get: function () { return chunkK3BNIGPX_js.clearTokenCaches; }
+});
+Object.defineProperty(exports, "getBalanceQueryKey", {
+  enumerable: true,
+  get: function () { return chunkK3BNIGPX_js.getBalanceQueryKey; }
+});
+Object.defineProperty(exports, "getTokensQueryKey", {
+  enumerable: true,
+  get: function () { return chunkK3BNIGPX_js.getTokensQueryKey; }
+});
+Object.defineProperty(exports, "getTransactionsQueryKey", {
+  enumerable: true,
+  get: function () { return chunkK3BNIGPX_js.getTransactionsQueryKey; }
+});
+Object.defineProperty(exports, "getWalletAssetsQueryKey", {
+  enumerable: true,
+  get: function () { return chunkK3BNIGPX_js.getWalletAssetsQueryKey; }
 });
 Object.defineProperty(exports, "invalidateSharedQuery", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.invalidateSharedQuery; }
+  get: function () { return chunkK3BNIGPX_js.invalidateSharedQuery; }
 });
 Object.defineProperty(exports, "useAccount", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useAccount; }
+  get: function () { return chunkK3BNIGPX_js.useAccount; }
 });
 Object.defineProperty(exports, "useBalance", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useBalance; }
+  get: function () { return chunkK3BNIGPX_js.useBalance; }
 });
 Object.defineProperty(exports, "useCluster", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useCluster; }
+  get: function () { return chunkK3BNIGPX_js.useCluster; }
 });
 Object.defineProperty(exports, "useConnector", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useConnector; }
+  get: function () { return chunkK3BNIGPX_js.useConnector; }
 });
 Object.defineProperty(exports, "useConnectorClient", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useConnectorClient; }
+  get: function () { return chunkK3BNIGPX_js.useConnectorClient; }
 });
 Object.defineProperty(exports, "useGillSolanaClient", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useGillSolanaClient; }
+  get: function () { return chunkK3BNIGPX_js.useGillSolanaClient; }
 });
 Object.defineProperty(exports, "useGillTransactionSigner", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useGillTransactionSigner; }
+  get: function () { return chunkK3BNIGPX_js.useGillTransactionSigner; }
 });
 Object.defineProperty(exports, "useKitTransactionSigner", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useKitTransactionSigner; }
+  get: function () { return chunkK3BNIGPX_js.useKitTransactionSigner; }
 });
 Object.defineProperty(exports, "useSolanaClient", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useSolanaClient; }
+  get: function () { return chunkK3BNIGPX_js.useSolanaClient; }
 });
 Object.defineProperty(exports, "useTokens", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useTokens; }
+  get: function () { return chunkK3BNIGPX_js.useTokens; }
 });
 Object.defineProperty(exports, "useTransactionPreparer", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useTransactionPreparer; }
+  get: function () { return chunkK3BNIGPX_js.useTransactionPreparer; }
 });
 Object.defineProperty(exports, "useTransactionSigner", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useTransactionSigner; }
+  get: function () { return chunkK3BNIGPX_js.useTransactionSigner; }
 });
 Object.defineProperty(exports, "useTransactions", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useTransactions; }
+  get: function () { return chunkK3BNIGPX_js.useTransactions; }
 });
 Object.defineProperty(exports, "useWalletInfo", {
   enumerable: true,
-  get: function () { return chunkZ22V3D4E_js.useWalletInfo; }
+  get: function () { return chunkK3BNIGPX_js.useWalletInfo; }
 });
 Object.defineProperty(exports, "ConnectorErrorBoundary", {
   enumerable: true,
-  get: function () { return chunkVA6LKXCQ_js.ConnectorErrorBoundary; }
+  get: function () { return chunkFTXIXM43_js.ConnectorErrorBoundary; }
 });
 Object.defineProperty(exports, "withErrorBoundary", {
   enumerable: true,
-  get: function () { return chunkVA6LKXCQ_js.withErrorBoundary; }
+  get: function () { return chunkFTXIXM43_js.withErrorBoundary; }
 });
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map

package/dist/react.mjs

@@ -1,4 +1,4 @@
-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 { ConnectorErrorBoundary, withErrorBoundary } from './chunk-APQGEW7S.mjs';
+export { AccountElement, AppProvider, BalanceElement, ClusterElement, ConnectorProvider, DisconnectElement, SkeletonShine, TokenListElement, TransactionHistoryElement, UnifiedProvider, WalletListElement, clearSharedQueryCache, clearTokenCaches, getBalanceQueryKey, getTokensQueryKey, getTransactionsQueryKey, getWalletAssetsQueryKey, invalidateSharedQuery, useAccount, useBalance, useCluster, useConnector, useConnectorClient, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo } from './chunk-TTOKQAPX.mjs';
+export { ConnectorErrorBoundary, withErrorBoundary } from './chunk-6F6M6L7R.mjs';
 //# sourceMappingURL=react.mjs.map
 //# sourceMappingURL=react.mjs.map