@solana/connector 0.1.8 → 0.1.10

package/dist/headless.d.ts

@@ -1,5 +1,5 @@
-import { h as ClusterType, N as StorageOptions, K as StorageAdapter, O as EnhancedStorageAccountOptions, P as EnhancedStorageClusterOptions, Q as EnhancedStorageWalletOptions } from './standard-shim-D9guL5fz.js';
-export { x as AccountAddress, A as AccountInfo, R as ClipboardErrorType, T as ClipboardResult, B as CoinGeckoConfig, i as ConnectorClient, d as ConnectorConfig, G as ConnectorDebugMetrics, H as ConnectorDebugState, I as ConnectorEvent, J as ConnectorEventListener, F as ConnectorHealth, e as ConnectorState, U as CopyOptions, t as CreateSolanaClientArgs, D as DefaultConfigOptions, E as ExtendedConnectorConfig, L as Listener, M as MobileWalletAdapterConfig, q as ModifiedClusterUrl, s as SolanaClient, S as SolanaClusterMoniker, n as WalletError, m as WalletErrorType, W as WalletInfo, v as WalletName, g as WalletStandardAccount, f as WalletStandardWallet, Y as copyAddressToClipboard, Z as copySignatureToClipboard, X as copyToClipboard, p as createSolanaClient, a1 as getAddressUrl, a3 as getBlockUrl, ab as getChainIdForWalletStandard, aa as getClusterChainId, $ as getClusterExplorerUrl, a8 as getClusterName, _ as getClusterRpcUrl, a9 as getClusterType, j as getDefaultConfig, k as getDefaultMobileConfig, o as getPublicSolanaRpcUrl, a2 as getTokenUrl, a0 as getTransactionUrl, l as getWalletsRegistry, z as isAccountAddress, V as isClipboardAvailable, a5 as isDevnetCluster, a7 as isLocalCluster, a4 as isMainnetCluster, a6 as isTestnetCluster, y as isWalletName, r as ready } from './standard-shim-D9guL5fz.js';
+import { j as ClusterType, R as StorageOptions, Q as StorageAdapter, T as EnhancedStorageAccountOptions, U as EnhancedStorageClusterOptions, V as EnhancedStorageWalletOptions, x as WalletConnectConfig, z as WalletConnectTransport } from './standard-shim-LsQ97i9T.js';
+export { F as AccountAddress, A as AccountInfo, a4 as ClipboardErrorType, a5 as ClipboardResult, I as CoinGeckoConfig, k as ConnectorClient, e as ConnectorConfig, K as ConnectorDebugMetrics, L as ConnectorDebugState, O as ConnectorEvent, P as ConnectorEventListener, J as ConnectorHealth, f as ConnectorState, a6 as CopyOptions, v as CreateSolanaClientArgs, D as DefaultConfigOptions, E as ExtendedConnectorConfig, N as Listener, M as MobileWalletAdapterConfig, s as ModifiedClusterUrl, t as SolanaClient, q as SolanaClusterMoniker, y as WalletConnectMetadata, a0 as WalletConnectSignAllTransactionsParams, a1 as WalletConnectSignAllTransactionsResult, a2 as WalletConnectSignAndSendTransactionParams, a3 as WalletConnectSignAndSendTransactionResult, Y as WalletConnectSignMessageParams, Z as WalletConnectSignMessageResult, _ as WalletConnectSignTransactionParams, $ as WalletConnectSignTransactionResult, X as WalletConnectSolanaAccount, n as WalletError, m as WalletErrorType, W as WalletInfo, B as WalletName, i as WalletStandardAccount, h as WalletStandardWallet, a9 as copyAddressToClipboard, aa as copySignatureToClipboard, a8 as copyToClipboard, p as createSolanaClient, ae as getAddressUrl, ag as getBlockUrl, ao as getChainIdForWalletStandard, an as getClusterChainId, ac as getClusterExplorerUrl, al as getClusterName, ab as getClusterRpcUrl, am as getClusterType, g as getDefaultConfig, b as getDefaultMobileConfig, o as getPublicSolanaRpcUrl, af as getTokenUrl, ad as getTransactionUrl, l as getWalletsRegistry, H as isAccountAddress, a7 as isClipboardAvailable, ai as isDevnetCluster, ak as isLocalCluster, ah as isMainnetCluster, aj as isTestnetCluster, G as isWalletName, r as ready } from './standard-shim-LsQ97i9T.js';
 import { z } from 'zod/v4';
 import { a as TransactionSigner } from './transaction-signer-T-KVQFi8.js';
 export { d as ConfigurationError, p as ConfigurationErrorCode, b as ConnectionError, n as ConnectionErrorCode, C as ConnectorError, E as Errors, N as NetworkError, q as NetworkErrorCode, u as SignedTransaction, S as SolanaTransaction, w as TransactionActivity, x as TransactionActivityStatus, e as TransactionError, r as TransactionErrorCode, z as TransactionMetadata, y as TransactionMethod, v as TransactionSignerCapabilities, s as TransactionSignerConfig, T as TransactionSignerError, V as ValidationError, o as ValidationErrorCode, c as createTransactionSigner, m as getUserFriendlyMessage, j as isConfigurationError, g as isConnectionError, f as isConnectorError, k as isNetworkError, l as isTransactionError, i as isTransactionSignerError, h as isValidationError, t as toConnectorError } from './transaction-signer-T-KVQFi8.js';
@@ -22,6 +22,122 @@ import 'react';
 import '@solana-mobile/wallet-standard-mobile';
 import '@solana/transaction-messages';
 
+/**
+ * @solana/connector - Configuration Schemas
+ *
+ * Zod schemas for runtime validation of configuration options.
+ * These schemas provide type-safe validation with helpful error messages.
+ */
+
+declare const defaultConfigOptionsSchema: z.ZodObject<{
+    appName: z.ZodString;
+    appUrl: z.ZodOptional<z.ZodString>;
+    imageProxy: z.ZodOptional<z.ZodString>;
+    clusterStorageKey: z.ZodOptional<z.ZodString>;
+    autoConnect: z.ZodOptional<z.ZodBoolean>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    enableMobile: z.ZodOptional<z.ZodBoolean>;
+    persistClusterSelection: z.ZodOptional<z.ZodBoolean>;
+    enableErrorBoundary: z.ZodOptional<z.ZodBoolean>;
+    network: z.ZodOptional<z.ZodEnum<{
+        devnet: "devnet";
+        localnet: "localnet";
+        mainnet: "mainnet";
+        testnet: "testnet";
+        "mainnet-beta": "mainnet-beta";
+    }>>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    storage: z.ZodOptional<z.ZodObject<{
+        account: z.ZodObject<{
+            get: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
+            set: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
+        }, z.core.$loose>;
+        cluster: z.ZodObject<{
+            get: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
+            set: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
+        }, z.core.$loose>;
+        wallet: z.ZodObject<{
+            get: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
+            set: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
+        }, z.core.$loose>;
+    }, z.core.$strip>>;
+    clusters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        url: z.ZodString;
+        urlWs: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    customClusters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        url: z.ZodString;
+        urlWs: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    programLabels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    coingecko: z.ZodOptional<z.ZodObject<{
+        apiKey: z.ZodOptional<z.ZodString>;
+        isPro: z.ZodOptional<z.ZodBoolean>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        baseDelay: z.ZodOptional<z.ZodNumber>;
+        maxTimeout: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    walletConnect: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        projectId: z.ZodString;
+        metadata: z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            url: z.ZodString;
+            icons: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        defaultChain: z.ZodOptional<z.ZodEnum<{
+            "solana:mainnet": "solana:mainnet";
+            "solana:devnet": "solana:devnet";
+            "solana:testnet": "solana:testnet";
+        }>>;
+        onDisplayUri: z.ZodOptional<z.ZodCustom<(uri: string) => void, (uri: string) => void>>;
+        onSessionEstablished: z.ZodOptional<z.ZodCustom<() => void, () => void>>;
+        onSessionDisconnected: z.ZodOptional<z.ZodCustom<() => void, () => void>>;
+        relayUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    onError: z.ZodOptional<z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
+}, z.core.$strip>;
+type DefaultConfigOptionsInput = z.input<typeof defaultConfigOptionsSchema>;
+/**
+ * Validate configuration options and return a result with helpful errors
+ *
+ * @example
+ * ```ts
+ * const result = validateConfigOptions({
+ *   appName: 'My App',
+ *   network: 'mainnet',
+ * });
+ *
+ * if (!result.success) {
+ *   console.error('Config validation failed:', result.error.format());
+ * }
+ * ```
+ */
+declare function validateConfigOptions(options: unknown): z.ZodSafeParseResult<DefaultConfigOptionsInput>;
+/**
+ * Parse and validate config options, throwing on error with formatted message
+ *
+ * @throws {z.ZodError} If validation fails
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const validOptions = parseConfigOptions(userInput);
+ *   // validOptions is typed and validated
+ * } catch (error) {
+ *   if (error instanceof z.ZodError) {
+ *     console.error(error.format());
+ *   }
+ * }
+ * ```
+ */
+declare function parseConfigOptions(options: unknown): DefaultConfigOptionsInput;
+
 /**
  * @solana/connector - Formatting utilities
  *
@@ -548,103 +664,6 @@ declare function freezeSigner<T extends object>(signer: T): Readonly<T>;
 declare function base58ToSignatureBytes(signature: string): SignatureBytes;
 declare function signatureBytesToBase58(bytes: SignatureBytes): string;
 
-/**
- * @solana/connector - Configuration Schemas
- *
- * Zod schemas for runtime validation of configuration options.
- * These schemas provide type-safe validation with helpful error messages.
- */
-
-declare const defaultConfigOptionsSchema: z.ZodObject<{
-    appName: z.ZodString;
-    appUrl: z.ZodOptional<z.ZodString>;
-    imageProxy: z.ZodOptional<z.ZodString>;
-    clusterStorageKey: z.ZodOptional<z.ZodString>;
-    autoConnect: z.ZodOptional<z.ZodBoolean>;
-    debug: z.ZodOptional<z.ZodBoolean>;
-    enableMobile: z.ZodOptional<z.ZodBoolean>;
-    persistClusterSelection: z.ZodOptional<z.ZodBoolean>;
-    enableErrorBoundary: z.ZodOptional<z.ZodBoolean>;
-    network: z.ZodOptional<z.ZodEnum<{
-        devnet: "devnet";
-        localnet: "localnet";
-        mainnet: "mainnet";
-        testnet: "testnet";
-        "mainnet-beta": "mainnet-beta";
-    }>>;
-    maxRetries: z.ZodOptional<z.ZodNumber>;
-    storage: z.ZodOptional<z.ZodObject<{
-        account: z.ZodObject<{
-            get: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-            set: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-        }, z.core.$loose>;
-        cluster: z.ZodObject<{
-            get: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-            set: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-        }, z.core.$loose>;
-        wallet: z.ZodObject<{
-            get: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-            set: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-        }, z.core.$loose>;
-    }, z.core.$strip>>;
-    clusters: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        label: z.ZodString;
-        url: z.ZodString;
-        urlWs: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    customClusters: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        label: z.ZodString;
-        url: z.ZodString;
-        urlWs: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    programLabels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    coingecko: z.ZodOptional<z.ZodObject<{
-        apiKey: z.ZodOptional<z.ZodString>;
-        isPro: z.ZodOptional<z.ZodBoolean>;
-        maxRetries: z.ZodOptional<z.ZodNumber>;
-        baseDelay: z.ZodOptional<z.ZodNumber>;
-        maxTimeout: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strict>>;
-    onError: z.ZodOptional<z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-}, z.core.$strip>;
-type DefaultConfigOptionsInput = z.input<typeof defaultConfigOptionsSchema>;
-/**
- * Validate configuration options and return a result with helpful errors
- *
- * @example
- * ```ts
- * const result = validateConfigOptions({
- *   appName: 'My App',
- *   network: 'mainnet',
- * });
- *
- * if (!result.success) {
- *   console.error('Config validation failed:', result.error.format());
- * }
- * ```
- */
-declare function validateConfigOptions(options: unknown): z.ZodSafeParseResult<DefaultConfigOptionsInput>;
-/**
- * Parse and validate config options, throwing on error with formatted message
- *
- * @throws {z.ZodError} If validation fails
- *
- * @example
- * ```ts
- * try {
- *   const validOptions = parseConfigOptions(userInput);
- *   // validOptions is typed and validated
- * } catch (error) {
- *   if (error instanceof z.ZodError) {
- *     console.error(error.format());
- *   }
- * }
- * ```
- */
-declare function parseConfigOptions(options: unknown): DefaultConfigOptionsInput;
-
 /**
  * Enhanced Storage
  */
@@ -689,6 +708,104 @@ declare class EnhancedStorageAdapter<T> implements StorageAdapter<T> {
     onError(handler: (error: Error) => void): this;
 }
 
+/**
+ * WalletConnect Wallet Standard Shim
+ *
+ * Creates a Wallet Standard-compatible wallet that proxies all operations
+ * to WalletConnect Solana JSON-RPC methods.
+ *
+ * @see https://docs.walletconnect.network/wallet-sdk/chain-support/solana
+ */
+
+/**
+ * Create a Wallet Standard-compatible wallet that uses WalletConnect
+ */
+declare function createWalletConnectWallet(config: WalletConnectConfig, transport: WalletConnectTransport): Wallet;
+
+/**
+ * WalletConnect Universal Provider Adapter
+ *
+ * Provides a thin adapter around @walletconnect/universal-provider that:
+ * - Lazily imports the provider (optional dependency)
+ * - Handles display_uri events and forwards to onDisplayUri callback
+ * - Implements the WalletConnectTransport interface
+ *
+ * @see https://docs.walletconnect.network/wallet-sdk/chain-support/solana
+ */
+
+/**
+ * Create a WalletConnect transport adapter
+ *
+ * This adapter lazily loads @walletconnect/universal-provider and implements
+ * the WalletConnectTransport interface for use with the WalletConnect wallet shim.
+ */
+declare function createWalletConnectTransport(config: WalletConnectConfig): Promise<WalletConnectTransport>;
+/**
+ * Create a mock transport for testing purposes
+ *
+ * This allows testing the WalletConnect wallet shim without actual WalletConnect
+ * network dependencies.
+ */
+declare function createMockWalletConnectTransport(mockImplementation?: Partial<WalletConnectTransport>): WalletConnectTransport;
+
+/**
+ * WalletConnect Registration Helper
+ *
+ * Registers the WalletConnect wallet shim into the Wallet Standard registry,
+ * making it available to ConnectorKit's wallet detection system.
+ */
+
+/**
+ * Result of registering the WalletConnect wallet
+ */
+interface WalletConnectRegistration {
+    /** The registered wallet instance */
+    wallet: Wallet;
+    /** Function to unregister the wallet from the registry */
+    unregister: () => void;
+}
+/**
+ * Register a WalletConnect wallet into the Wallet Standard registry
+ *
+ * This function:
+ * 1. Creates a WalletConnect transport adapter
+ * 2. Creates a Wallet Standard-compatible wallet shim
+ * 3. Registers the wallet with the Wallet Standard registry
+ *
+ * The wallet will appear in ConnectorKit's wallet list as "WalletConnect"
+ * and can be selected like any other wallet.
+ *
+ * @param config - WalletConnect configuration
+ * @returns Registration result with wallet and unregister function
+ *
+ * @example
+ * ```typescript
+ * const { wallet, unregister } = await registerWalletConnectWallet({
+ *   projectId: 'your-project-id',
+ *   metadata: {
+ *     name: 'My App',
+ *     description: 'My Solana App',
+ *     url: 'https://myapp.com',
+ *     icons: ['https://myapp.com/icon.png'],
+ *   },
+ *   onDisplayUri: (uri) => {
+ *     // Show QR code with this URI
+ *   },
+ * });
+ *
+ * // Later, to remove from registry:
+ * unregister();
+ * ```
+ */
+declare function registerWalletConnectWallet(config: WalletConnectConfig): Promise<WalletConnectRegistration>;
+/**
+ * Check if WalletConnect dependencies are available
+ *
+ * This function checks if @walletconnect/universal-provider can be imported.
+ * Useful for conditionally showing WalletConnect options in UI.
+ */
+declare function isWalletConnectAvailable(): Promise<boolean>;
+
 /**
  * @solana/connector - Kit Transaction Signer Adapter
  *
@@ -1028,4 +1145,4 @@ declare function formatSignature(signature: string, chars?: number): string;
  */
 declare function copySignature(signature: string): Promise<boolean>;
 
-export { ClusterType, type Commitment, type DualConnection, EnhancedStorage, EnhancedStorageAccountOptions, EnhancedStorageAdapter, EnhancedStorageClusterOptions, EnhancedStorageWalletOptions, type ExplorerOptions, type ExplorerType, type Failure, type GetExplorerLinkArgs, type KitSignersFromWallet, LAMPORTS_PER_SOL, PUBLIC_RPC_ENDPOINTS, type PrepareTransactionConfig, type Result, SOLANA_CHAIN_IDS, type SolanaNetwork, StorageAdapter, StorageOptions, type Success, TransactionSigner, base58ToSignatureBytes, chainIdToClusterId, chainIdToClusterType, clusterToChainId, copySignature, createEnhancedStorageAccount, createEnhancedStorageCluster, createEnhancedStorageWallet, createGillTransactionSigner, createKitSignersFromWallet, createKitTransactionSigner, createMessageSignerFromWallet, createTransactionSendingSignerFromWallet, detectMessageModification, formatAddress, formatBigIntBalance, formatBigIntUsd, formatLamportsToSolSafe, formatNumber, formatSOL, formatSignature, formatTokenAmount, formatTokenBalanceSafe, freezeSigner, getAllExplorerUrls, getChainIdFromCluster, getChainIdFromClusterId, getChainIdFromClusterType, getChainIdFromConnection, getClusterIdFromChainId, getClusterTypeFromChainId, getClusterTypeFromConnection, getDefaultRpcUrl, getExplorerLink, getLatestBlockhash, getNetworkDisplayName, getPolyfillStatus, getSolanaExplorerUrl, getSolanaFmUrl, getSolscanUrl, getXrayUrl, installPolyfills, isCryptoAvailable, isDevnet, isFailure, isKitConnection, isKnownSolanaChain, isLegacyConnection, isLocalnet, isMainnet, isPolyfillInstalled, isSolanaChain, isSuccess, isTestnet, lamportsToSol, normalizeNetwork, parseConfigOptions, prepareTransaction, sendRawTransaction, signatureBytesToBase58, solToLamports, toClusterId, truncate, tryCatch, tryCatchSync, updateSignatureDictionary, validateConfigOptions, validateKnownSolanaChain };
+export { ClusterType, type Commitment, type DualConnection, EnhancedStorage, EnhancedStorageAccountOptions, EnhancedStorageAdapter, EnhancedStorageClusterOptions, EnhancedStorageWalletOptions, type ExplorerOptions, type ExplorerType, type Failure, type GetExplorerLinkArgs, type KitSignersFromWallet, LAMPORTS_PER_SOL, PUBLIC_RPC_ENDPOINTS, type PrepareTransactionConfig, type Result, SOLANA_CHAIN_IDS, type SolanaNetwork, StorageAdapter, StorageOptions, type Success, TransactionSigner, WalletConnectConfig, type WalletConnectRegistration, WalletConnectTransport, base58ToSignatureBytes, chainIdToClusterId, chainIdToClusterType, clusterToChainId, copySignature, createEnhancedStorageAccount, createEnhancedStorageCluster, createEnhancedStorageWallet, createGillTransactionSigner, createKitSignersFromWallet, createKitTransactionSigner, createMessageSignerFromWallet, createMockWalletConnectTransport, createTransactionSendingSignerFromWallet, createWalletConnectTransport, createWalletConnectWallet, detectMessageModification, formatAddress, formatBigIntBalance, formatBigIntUsd, formatLamportsToSolSafe, formatNumber, formatSOL, formatSignature, formatTokenAmount, formatTokenBalanceSafe, freezeSigner, getAllExplorerUrls, getChainIdFromCluster, getChainIdFromClusterId, getChainIdFromClusterType, getChainIdFromConnection, getClusterIdFromChainId, getClusterTypeFromChainId, getClusterTypeFromConnection, getDefaultRpcUrl, getExplorerLink, getLatestBlockhash, getNetworkDisplayName, getPolyfillStatus, getSolanaExplorerUrl, getSolanaFmUrl, getSolscanUrl, getXrayUrl, installPolyfills, isCryptoAvailable, isDevnet, isFailure, isKitConnection, isKnownSolanaChain, isLegacyConnection, isLocalnet, isMainnet, isPolyfillInstalled, isSolanaChain, isSuccess, isTestnet, isWalletConnectAvailable, lamportsToSol, normalizeNetwork, parseConfigOptions, prepareTransaction, registerWalletConnectWallet, sendRawTransaction, signatureBytesToBase58, solToLamports, toClusterId, truncate, tryCatch, tryCatchSync, updateSignatureDictionary, validateConfigOptions, validateKnownSolanaChain };