@solana/connector 0.1.6 → 0.1.8

package/dist/{wallet-standard-shim--YcrQNRt.d.ts → standard-shim-CT49DM5l.d.mts}

@@ -1,10 +1,11 @@
-import { c as TransactionActivity, d as TransactionActivityStatus } from './transaction-signer-D9d8nxwb.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React, { ReactNode, Component, ErrorInfo } from 'react';
+import { w as TransactionActivity, x as TransactionActivityStatus } from './transaction-signer-T-KVQFi8.mjs';
 import { SolanaClusterId, SolanaCluster } from '@wallet-ui/core';
-import { Wallet, WalletAccount } from '@wallet-standard/base';
+import { Wallet, WalletAccount, IdentifierArray } from '@wallet-standard/base';
 import { Address } from '@solana/addresses';
-import React, { ReactNode, Component, ErrorInfo } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Signature } from '@solana/keys';
+import { AuthorizationCache, ChainSelector, SolanaMobileWalletAdapterWallet } from '@solana-mobile/wallet-standard-mobile';
 import { DevnetUrl, MainnetUrl, TestnetUrl, Rpc, SolanaRpcApi, RpcSubscriptions, SolanaRpcSubscriptionsApi } from '@solana/kit';
 
 /**
@@ -201,6 +202,11 @@ interface ConnectorConfig {
      * @example '/cdn-cgi/image/width=64,quality=75/' // Cloudflare Image Resizing
      */
     imageProxy?: string;
+    /**
+     * Optional mapping from program IDs to human-readable program names.
+     * Used to enrich transaction history (e.g. showing `Jupiter` instead of a raw program address).
+     */
+    programLabels?: Record<string, string>;
     /**
      * CoinGecko API configuration for token price fetching.
      * Configure API key for higher rate limits and retry behavior for 429 responses.
@@ -424,6 +430,11 @@ interface DefaultConfigOptions {
      * @example '/cdn-cgi/image/width=64,quality=75/' // Cloudflare Image Resizing
      */
     imageProxy?: string;
+    /**
+     * Optional mapping from program IDs to human-readable program names.
+     * Used to enrich transaction history (e.g. showing `Jupiter` instead of a raw program address).
+     */
+    programLabels?: Record<string, string>;
     /**
      * CoinGecko API configuration for token price fetching.
      * Configure API key for higher rate limits and retry behavior for 429 responses.
@@ -458,6 +469,11 @@ interface ExtendedConnectorConfig extends ConnectorConfig {
      * This prevents direct image fetching which can leak user IPs to untrusted hosts.
      */
     imageProxy?: string;
+    /**
+     * Optional mapping from program IDs to human-readable program names.
+     * Used to enrich transaction history (e.g. showing `Jupiter` instead of a raw program address).
+     */
+    programLabels?: Record<string, string>;
     /**
      * CoinGecko API configuration for token price fetching.
      */
@@ -483,6 +499,19 @@ declare function getDefaultMobileConfig(options: {
     cluster: "devnet" | "mainnet" | "testnet" | "mainnet-beta";
 };
 
+/** Configuration for registerMwa - defined locally as the package doesn't export this type */
+interface RegisterMwaConfig {
+    appIdentity: {
+        name: string;
+        uri?: string;
+        icon?: string;
+    };
+    authorizationCache: AuthorizationCache;
+    chains: IdentifierArray;
+    chainSelector: ChainSelector;
+    remoteHostAuthority?: string;
+    onWalletNotFound: (mobileWalletAdapter: SolanaMobileWalletAdapterWallet) => Promise<void>;
+}
 declare global {
     interface Window {
         __connectorClient?: ConnectorClient;
@@ -500,10 +529,10 @@ interface MobileWalletAdapterConfig {
         icon?: string;
     };
     remoteHostAuthority?: string;
-    chains?: readonly string[];
-    authorizationCache?: unknown;
-    chainSelector?: unknown;
-    onWalletNotFound?: (wallet: unknown) => Promise<void>;
+    chains?: RegisterMwaConfig['chains'];
+    authorizationCache?: AuthorizationCache;
+    chainSelector?: ChainSelector;
+    onWalletNotFound?: (wallet: SolanaMobileWalletAdapterWallet) => Promise<void>;
 }
 declare function ConnectorProvider({ children, config, mobile, }: {
     children: ReactNode;
@@ -513,249 +542,6 @@ declare function ConnectorProvider({ children, config, mobile, }: {
 declare function useConnector(): ConnectorSnapshot;
 declare function useConnectorClient(): ConnectorClient | null;
 
-/**
- * @solana/connector - Network utilities
- *
- * Utilities for translating between different Solana network naming conventions.
- * Ensures compatibility with WalletUI (SolanaClusterId) and Gill types.
- *
- * Primary type: SolanaNetwork - normalized network names
- * External integration: Use WalletUI's SolanaClusterId for cluster operations
- */
-
-/**
- * Normalized Solana network names
- *
- * This is the canonical network type used throughout the connector.
- * Use `toClusterId()` to convert to WalletUI's SolanaClusterId format.
- * Aligned with Gill's SolanaClusterMoniker type.
- */
-type SolanaNetwork = 'mainnet' | 'devnet' | 'testnet' | 'localnet';
-/**
- * Public RPC endpoints for each Solana network
- *
- * ⚠️ WARNING: These are public, rate-limited endpoints provided by Solana Labs.
- * For production applications, use a dedicated RPC provider like:
- * - Triton (https://triton.one)
- * - Helius (https://helius.dev)
- * - QuickNode (https://quicknode.com)
- * - Alchemy (https://alchemy.com)
- *
- * Note: These values are now sourced from Gill's getPublicSolanaRpcUrl for consistency.
- * Kept here for reference and backward compatibility.
- */
-declare const PUBLIC_RPC_ENDPOINTS: Record<SolanaNetwork, string>;
-/**
- * Normalize network name to standard format
- * Accepts various naming conventions and returns the canonical SolanaNetwork format
- *
- * @example
- * normalizeNetwork('mainnet-beta') // Returns: 'mainnet'
- * normalizeNetwork('mainnet') // Returns: 'mainnet'
- * normalizeNetwork('MAINNET') // Returns: 'mainnet'
- */
-declare function normalizeNetwork(network: string): SolanaNetwork;
-/**
- * Convert network name to WalletUI cluster ID format
- *
- * WalletUI uses the 'solana:network' format for cluster identification.
- *
- * @example
- * toClusterId('mainnet') // Returns: 'solana:mainnet'
- * toClusterId('mainnet-beta') // Returns: 'solana:mainnet' (normalized)
- */
-declare function toClusterId(network: string): SolanaClusterId;
-/**
- * Get the public RPC URL for a network
- *
- * ⚠️ Returns public, rate-limited endpoints. For production, use a dedicated RPC provider.
- *
- * Now uses Gill's getPublicSolanaRpcUrl for consistency with the Gill ecosystem.
- * Falls back to localnet URL for unknown networks.
- *
- * @example
- * getDefaultRpcUrl('mainnet') // Returns: 'https://api.mainnet-beta.solana.com'
- * getDefaultRpcUrl('devnet') // Returns: 'https://api.devnet.solana.com'
- */
-declare function getDefaultRpcUrl(network: string): string;
-/**
- * Check if a network is mainnet
- *
- * @example
- * isMainnet('mainnet') // Returns: true
- * isMainnet('mainnet-beta') // Returns: true
- * isMainnet('devnet') // Returns: false
- */
-declare function isMainnet(network: string): boolean;
-/**
- * Check if a network is devnet
- *
- * @example
- * isDevnet('devnet') // Returns: true
- * isDevnet('mainnet') // Returns: false
- */
-declare function isDevnet(network: string): boolean;
-/**
- * Check if a network is testnet
- *
- * @example
- * isTestnet('testnet') // Returns: true
- * isTestnet('mainnet') // Returns: false
- */
-declare function isTestnet(network: string): boolean;
-/**
- * Check if a network is localnet
- *
- * @example
- * isLocalnet('localnet') // Returns: true
- * isLocalnet('mainnet') // Returns: false
- */
-declare function isLocalnet(network: string): boolean;
-/**
- * Get a user-friendly display name for a network
- *
- * @example
- * getNetworkDisplayName('mainnet-beta') // Returns: 'Mainnet'
- * getNetworkDisplayName('devnet') // Returns: 'Devnet'
- */
-declare function getNetworkDisplayName(network: string): string;
-
-/**
- * @solana/connector - Unified configuration
- *
- * Simplified configuration for apps using ConnectorKit
- * Eliminates config duplication and provides a single source of truth
- */
-
-/**
- * Options for creating a unified configuration
- * Maintains type safety while providing flexibility
- */
-interface UnifiedConfigOptions extends DefaultConfigOptions {
-    /**
-     * Custom RPC URL (optional - overrides default for network)
-     * Note: For production apps, use environment variables to avoid exposing API keys
-     * @see packages/connector/src/utils/cluster.ts for secure RPC URL patterns
-     */
-    rpcUrl?: string;
-}
-/**
- * Unified configuration output
- * Contains all configs needed for ConnectorKit and integrations
- *
- * Important: The `rpcUrl` property is intended for:
- * 1. Server-side rendering (SSR) setup
- * 2. Passing to external libraries that need RPC configuration
- * 3. Development/testing environments
- *
- * For production client-side code, use the connector client's `getRpcUrl()` method
- * which supports environment variable patterns and proxy configurations.
- */
-interface UnifiedConfig {
-    /** ConnectorKit configuration */
-    connectorConfig: ExtendedConnectorConfig;
-    /** Mobile Wallet Adapter configuration (optional) */
-    mobile?: MobileWalletAdapterConfig;
-    /** Normalized network name ('mainnet', 'devnet', 'testnet', 'localnet') */
-    network: SolanaNetwork;
-    /**
-     * RPC endpoint URL
-     * For external library integration only - client code should use connector client
-     * @deprecated in client components - use `useConnectorClient().getRpcUrl()` instead
-     */
-    rpcUrl: string;
-    /** Application metadata */
-    app: {
-        name: string;
-        url: string;
-    };
-}
-/**
- * Create a unified configuration for ConnectorKit
- *
- * This helper eliminates configuration duplication by creating all necessary
- * configs from a single source of truth. It automatically handles network
- * name translation between different conventions.
- *
- * @example Basic usage
- * ```tsx
- * import { createConfig, AppProvider } from '@solana/connector';
- *
- * const config = createConfig({
- *   appName: 'My App',
- *   network: 'mainnet', // Works with 'mainnet' or 'mainnet-beta'
- *   enableMobile: true
- * });
- *
- * <AppProvider config={config}>
- *   {children}
- * </AppProvider>
- * ```
- *
- * @example Integration with external libraries
- * ```tsx
- * import { createConfig, AppProvider } from '@solana/connector';
- * import { ArmaProvider } from '@armadura/sdk';
- *
- * const config = createConfig({
- *   appName: 'My App',
- *   network: 'mainnet',
- * });
- *
- * <AppProvider config={config}>
- *   <ArmaProvider
- *     config={{
- *       network: config.network,
- *       rpcUrl: config.rpcUrl, // Safe - for external library initialization
- *       providers: [...]
- *     }}
- *     useConnector="auto"
- *   >
- *     {children}
- *   </ArmaProvider>
- * </AppProvider>
- * ```
- *
- * @example Production with environment variables
- * ```tsx
- * // Use environment variables to avoid exposing API keys
- * const config = createConfig({
- *   appName: 'My App',
- *   network: 'mainnet',
- *   // RPC URL comes from process.env on server
- *   // Client-side code should use connector client's getRpcUrl()
- * });
- * ```
- *
- * @example Custom clusters
- * ```tsx
- * const config = createConfig({
- *   appName: 'My App',
- *   network: 'mainnet',
- *   customClusters: [
- *     {
- *       id: 'solana:custom',
- *       label: 'Custom RPC',
- *       url: process.env.CUSTOM_RPC_URL || 'https://...'
- *     }
- *   ]
- * });
- * ```
- */
-declare function createConfig(options: UnifiedConfigOptions): UnifiedConfig;
-/**
- * Type guard to check if a config is a unified config
- *
- * @example
- * ```ts
- * if (isUnifiedConfig(someConfig)) {
- *   // TypeScript knows this is UnifiedConfig
- *   console.log(someConfig.network, someConfig.rpcUrl);
- * }
- * ```
- */
-declare function isUnifiedConfig(config: unknown): config is UnifiedConfig;
-
 declare enum WalletErrorType {
     CONNECTION_FAILED = "CONNECTION_FAILED",
     TRANSACTION_FAILED = "TRANSACTION_FAILED",
@@ -1128,9 +914,43 @@ interface WalletsRegistry {
 }
 type WalletStandardWallet = Wallet;
 type WalletStandardAccount = WalletAccount;
+/**
+ * Promise that resolves when the wallet registry is initialized and ready.
+ *
+ * Use this when you need deterministic wallet detection (e.g., auto-reconnect,
+ * checking if a specific wallet is installed before showing UI).
+ *
+ * Resolves immediately if the registry is already available.
+ * Rejects only on fatal errors (e.g., module load failure in browser environment).
+ *
+ * @example
+ * ```ts
+ * import { ready, getWalletsRegistry } from '@solana/connector';
+ *
+ * // Wait for registry to be ready before detecting wallets
+ * await ready;
+ * const wallets = getWalletsRegistry().get();
+ * ```
+ */
+declare const ready: Promise<void>;
 /**
  * Get the wallets registry - simplified approach
+ *
+ * ⚠️ RACE CONDITION WARNING:
+ * The dynamic import of '@wallet-standard/app' is asynchronous. If `window.navigator.wallets`
+ * is not pre-populated by a wallet extension, the registry may be undefined briefly during
+ * initial page load. Calls to `getWalletsRegistry().get()` during this window will return
+ * an empty array as graceful degradation.
+ *
+ * For deterministic wallet detection (e.g., auto-reconnect, pre-checking wallet availability),
+ * await the exported `ready` Promise before calling `get()`:
+ *
+ * @example
+ * ```ts
+ * await ready;
+ * const wallets = getWalletsRegistry().get(); // Guaranteed to have registry loaded
+ * ```
  */
 declare function getWalletsRegistry(): WalletsRegistry;
 
-export { copySignatureToClipboard as $, type AccountInfo as A, type StorageOptions as B, ConnectorProvider as C, type DefaultConfigOptions as D, type ExtendedConnectorConfig as E, type EnhancedStorageAccountOptions as F, type EnhancedStorageClusterOptions as G, type EnhancedStorageWalletOptions as H, WalletErrorType as I, type WalletError as J, getPublicSolanaRpcUrl as K, type Listener as L, type MobileWalletAdapterConfig as M, createSolanaClient as N, type SolanaClusterMoniker as O, type ModifiedClusterUrl as P, type SolanaClient as Q, type CreateSolanaClientArgs as R, type StorageAdapter as S, ClipboardErrorType as T, type UnifiedConfigOptions as U, type ClipboardResult as V, type WalletInfo as W, type CopyOptions as X, isClipboardAvailable as Y, copyToClipboard as Z, copyAddressToClipboard as _, useConnectorClient as a, getClusterRpcUrl as a0, getClusterExplorerUrl as a1, getTransactionUrl as a2, getAddressUrl as a3, getTokenUrl as a4, getBlockUrl as a5, isMainnetCluster as a6, isDevnetCluster as a7, isTestnetCluster as a8, isLocalCluster as a9, getClusterName as aa, getClusterType as ab, getClusterChainId as ac, getChainIdForWalletStandard as ad, type SolanaNetwork as ae, PUBLIC_RPC_ENDPOINTS as af, normalizeNetwork as ag, toClusterId as ah, getDefaultRpcUrl as ai, isMainnet as aj, isDevnet as ak, isTestnet as al, isLocalnet as am, getNetworkDisplayName as an, ConnectorErrorBoundary as b, type ConnectorSnapshot as c, type ConnectorConfig as d, type ConnectorState as e, type WalletStandardWallet as f, type WalletStandardAccount as g, type UnifiedConfig as h, type ClusterType as i, ConnectorClient as j, getWalletsRegistry as k, getDefaultConfig as l, getDefaultMobileConfig as m, createConfig as n, isUnifiedConfig as o, type WalletName as p, type AccountAddress as q, isWalletName as r, isAccountAddress as s, type ConnectorHealth as t, useConnector as u, type ConnectorDebugMetrics as v, withErrorBoundary as w, type ConnectorDebugState as x, type ConnectorEvent as y, type ConnectorEventListener as z };
+export { getClusterExplorerUrl as $, type AccountInfo as A, type CoinGeckoConfig as B, ConnectorProvider as C, type DefaultConfigOptions as D, type ExtendedConnectorConfig as E, type ConnectorHealth as F, type ConnectorDebugMetrics as G, type ConnectorDebugState as H, type ConnectorEvent as I, type ConnectorEventListener as J, type StorageAdapter as K, type Listener as L, type MobileWalletAdapterConfig as M, type StorageOptions as N, type EnhancedStorageAccountOptions as O, type EnhancedStorageClusterOptions as P, type EnhancedStorageWalletOptions as Q, ClipboardErrorType as R, type SolanaClusterMoniker as S, type ClipboardResult as T, type CopyOptions as U, isClipboardAvailable as V, type WalletInfo as W, copyToClipboard as X, copyAddressToClipboard as Y, copySignatureToClipboard as Z, getClusterRpcUrl as _, useConnectorClient as a, getTransactionUrl as a0, getAddressUrl as a1, getTokenUrl as a2, getBlockUrl as a3, isMainnetCluster as a4, isDevnetCluster as a5, isTestnetCluster as a6, isLocalCluster as a7, getClusterName as a8, getClusterType as a9, getClusterChainId as aa, getChainIdForWalletStandard as ab, ConnectorErrorBoundary as b, type ConnectorSnapshot as c, type ConnectorConfig as d, type ConnectorState as e, type WalletStandardWallet as f, type WalletStandardAccount as g, type ClusterType as h, ConnectorClient as i, getDefaultConfig as j, getDefaultMobileConfig as k, getWalletsRegistry as l, WalletErrorType as m, type WalletError as n, getPublicSolanaRpcUrl as o, createSolanaClient as p, type ModifiedClusterUrl as q, ready as r, type SolanaClient as s, type CreateSolanaClientArgs as t, useConnector as u, type WalletName as v, withErrorBoundary as w, type AccountAddress as x, isWalletName as y, isAccountAddress as z };