@solana/connector 0.1.8 → 0.1.10

package/dist/{standard-shim-CT49DM5l.d.mts → standard-shim-BTUm7cur.d.mts}

@@ -117,6 +117,213 @@ interface AccountInfo {
     raw: WalletAccount;
 }
 
+/**
+ * WalletConnect configuration types
+ *
+ * Types for configuring WalletConnect integration with the connector.
+ * WalletConnect uses Solana JSON-RPC methods as documented at:
+ * https://docs.walletconnect.network/wallet-sdk/chain-support/solana
+ */
+/**
+ * WalletConnect app metadata
+ * Required for session establishment with mobile/desktop wallets
+ */
+interface WalletConnectMetadata {
+    /** Application name displayed to the user in the wallet */
+    name: string;
+    /** Brief description of the application */
+    description: string;
+    /** Application URL (used for verification) */
+    url: string;
+    /** Array of icon URLs for the application */
+    icons: string[];
+}
+/**
+ * Configuration for WalletConnect integration
+ *
+ * When enabled, ConnectorKit registers a virtual "WalletConnect" wallet
+ * into the Wallet Standard registry. This wallet proxies all signing
+ * operations through WalletConnect's Solana JSON-RPC methods.
+ *
+ * @example
+ * ```typescript
+ * const config = getDefaultConfig({
+ *   appName: 'My App',
+ *   walletConnect: {
+ *     enabled: true,
+ *     projectId: process.env.NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID!,
+ *     metadata: {
+ *       name: 'My App',
+ *       description: 'My Solana Application',
+ *       url: 'https://myapp.com',
+ *       icons: ['https://myapp.com/icon.png'],
+ *     },
+ *     onDisplayUri: (uri) => {
+ *       // Show QR code or deep link with this URI
+ *       console.log('WalletConnect URI:', uri);
+ *     },
+ *   },
+ * });
+ * ```
+ */
+interface WalletConnectConfig {
+    /**
+     * Enable WalletConnect integration.
+     * When true, a "WalletConnect" wallet is registered in the Wallet Standard registry.
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * WalletConnect Cloud project ID.
+     * Get one at https://cloud.walletconnect.com/
+     */
+    projectId: string;
+    /**
+     * Application metadata shown to users during connection.
+     */
+    metadata: WalletConnectMetadata;
+    /**
+     * Default Solana chain/cluster for WalletConnect sessions.
+     * Used as fallback if getCurrentChain is not provided.
+     * Uses ConnectorKit's cluster ID format.
+     * @default 'solana:mainnet'
+     */
+    defaultChain?: 'solana:mainnet' | 'solana:devnet' | 'solana:testnet';
+    /**
+     * Callback to get the current chain/cluster dynamically.
+     * When provided, this is called before each request to determine the chain.
+     * This allows WalletConnect to follow the app's cluster selection.
+     *
+     * @returns The current chain ID (e.g., 'solana:mainnet', 'solana:devnet')
+     */
+    getCurrentChain?: () => 'solana:mainnet' | 'solana:devnet' | 'solana:testnet';
+    /**
+     * Callback invoked when WalletConnect needs to display a connection URI.
+     * The app should render this as a QR code or use it for deep linking.
+     *
+     * If not provided, the URI will be logged to console in development.
+     *
+     * @param uri - The WalletConnect pairing URI (starts with "wc:")
+     */
+    onDisplayUri?: (uri: string) => void;
+    /**
+     * Callback invoked when a WalletConnect session is established.
+     */
+    onSessionEstablished?: () => void;
+    /**
+     * Callback invoked when a WalletConnect session is disconnected.
+     */
+    onSessionDisconnected?: () => void;
+    /**
+     * Optional relay URL override.
+     * @default 'wss://relay.walletconnect.org'
+     */
+    relayUrl?: string;
+}
+/**
+ * Internal transport interface for WalletConnect provider
+ * Used by the shim wallet to communicate with WalletConnect
+ */
+interface WalletConnectTransport {
+    /** Establish connection and create/restore session */
+    connect(): Promise<void>;
+    /** Disconnect the current session */
+    disconnect(): Promise<void>;
+    /** Send a JSON-RPC request to the connected wallet */
+    request<T = unknown>(args: {
+        method: string;
+        params: unknown;
+        chainId?: string;
+    }): Promise<T>;
+    /** Check if there's an active session */
+    isConnected(): boolean;
+    /** Get accounts from the current session namespaces (if available) */
+    getSessionAccounts(): string[];
+}
+/**
+ * WalletConnect Solana account response
+ * Response format from solana_getAccounts and solana_requestAccounts
+ */
+interface WalletConnectSolanaAccount {
+    /** Base58-encoded public key */
+    pubkey: string;
+}
+/**
+ * WalletConnect sign message params
+ * Parameters for solana_signMessage
+ */
+interface WalletConnectSignMessageParams {
+    /** Base58-encoded message bytes */
+    message: string;
+    /** Base58-encoded public key of the signer */
+    pubkey: string;
+}
+/**
+ * WalletConnect sign message result
+ * Response from solana_signMessage
+ */
+interface WalletConnectSignMessageResult {
+    /** Base58-encoded signature */
+    signature: string;
+}
+/**
+ * WalletConnect sign transaction params
+ * Parameters for solana_signTransaction
+ */
+interface WalletConnectSignTransactionParams {
+    /** Base64-encoded serialized transaction */
+    transaction: string;
+}
+/**
+ * WalletConnect sign transaction result
+ * Response from solana_signTransaction
+ */
+interface WalletConnectSignTransactionResult {
+    /** Base58-encoded signature */
+    signature: string;
+    /** Optional: Base64-encoded signed transaction (if wallet returns full tx) */
+    transaction?: string;
+}
+/**
+ * WalletConnect sign all transactions params
+ * Parameters for solana_signAllTransactions
+ */
+interface WalletConnectSignAllTransactionsParams {
+    /** Array of Base64-encoded serialized transactions */
+    transactions: string[];
+}
+/**
+ * WalletConnect sign all transactions result
+ * Response from solana_signAllTransactions
+ */
+interface WalletConnectSignAllTransactionsResult {
+    /** Array of Base64-encoded signed transactions */
+    transactions: string[];
+}
+/**
+ * WalletConnect sign and send transaction params
+ * Parameters for solana_signAndSendTransaction
+ */
+interface WalletConnectSignAndSendTransactionParams {
+    /** Base64-encoded serialized transaction */
+    transaction: string;
+    /** Optional send options */
+    sendOptions?: {
+        skipPreflight?: boolean;
+        preflightCommitment?: 'processed' | 'confirmed' | 'finalized' | 'recent' | 'single' | 'singleGossip' | 'root' | 'max';
+        maxRetries?: number;
+        minContextSlot?: number;
+    };
+}
+/**
+ * WalletConnect sign and send transaction result
+ * Response from solana_signAndSendTransaction
+ */
+interface WalletConnectSignAndSendTransactionResult {
+    /** Base58-encoded transaction signature (transaction ID) */
+    signature: string;
+}
+
 /**
  * CoinGecko API configuration for price fetching.
  *
@@ -212,6 +419,12 @@ interface ConnectorConfig {
      * Configure API key for higher rate limits and retry behavior for 429 responses.
      */
     coingecko?: CoinGeckoConfig;
+    /**
+     * WalletConnect configuration for connecting via QR code / deep link.
+     * When enabled, a "WalletConnect" wallet is registered in the Wallet Standard registry.
+     * @see https://docs.walletconnect.network/wallet-sdk/chain-support/solana
+     */
+    walletConnect?: WalletConnectConfig;
 }
 /**
  * Health check information for connector diagnostics
@@ -363,8 +576,14 @@ declare class ConnectorClient {
     private healthMonitor;
     private initialized;
     private config;
+    private walletConnectRegistration;
     constructor(config?: ConnectorConfig);
     private initialize;
+    /**
+     * Initialize WalletConnect integration
+     * Dynamically imports and registers the WalletConnect wallet
+     */
+    private initializeWalletConnect;
     select(walletName: string): Promise<void>;
     disconnect(): Promise<void>;
     selectAccount(address: string): Promise<void>;
@@ -441,6 +660,62 @@ interface DefaultConfigOptions {
      * @see https://docs.coingecko.com/reference/introduction for rate limit details
      */
     coingecko?: CoinGeckoConfig;
+    /**
+     * WalletConnect configuration for connecting via QR code / deep link.
+     * When enabled, a "WalletConnect" wallet appears in the wallet list.
+     *
+     * Can be:
+     * - `true` to enable with auto-detected project ID from NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID env var
+     * - An object with optional overrides (projectId, metadata, etc.)
+     * - `undefined` or `false` to disable
+     *
+     * When using `true` or minimal config, the following are auto-configured:
+     * - `projectId`: Read from NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID
+     * - `metadata.name`: Uses appName
+     * - `metadata.url`: Uses appUrl or window.location.origin
+     * - `metadata.description`: Auto-generated from appName
+     * - `metadata.icons`: Uses appUrl/icon.svg
+     * - `getCurrentChain`: Auto-reads from cluster storage
+     * - `onDisplayUri/onSessionEstablished/onSessionDisconnected`: Auto-wired by AppProvider
+     *
+     * @example
+     * ```ts
+     * // Simplest - just enable it (reads project ID from env)
+     * getDefaultConfig({ appName: 'My App', walletConnect: true })
+     *
+     * // With explicit project ID
+     * getDefaultConfig({
+     *   appName: 'My App',
+     *   walletConnect: { projectId: 'my-project-id' }
+     * })
+     * ```
+     *
+     * @see https://docs.walletconnect.network/wallet-sdk/chain-support/solana
+     */
+    walletConnect?: boolean | SimplifiedWalletConnectConfig;
+}
+/**
+ * Simplified WalletConnect configuration
+ * Most fields are auto-generated from appName/appUrl if not provided
+ */
+interface SimplifiedWalletConnectConfig {
+    /**
+     * WalletConnect Cloud project ID.
+     * If not provided, reads from NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID env var.
+     */
+    projectId?: string;
+    /**
+     * Optional metadata overrides. Merged with auto-generated metadata.
+     */
+    metadata?: Partial<WalletConnectConfig['metadata']>;
+    /**
+     * Default chain. Defaults to 'solana:mainnet'.
+     */
+    defaultChain?: WalletConnectConfig['defaultChain'];
+    /**
+     * Optional relay URL override.
+     */
+    relayUrl?: string;
 }
 /** Extended ConnectorConfig with app metadata */
 interface ExtendedConnectorConfig extends ConnectorConfig {
@@ -521,6 +796,10 @@ type ConnectorSnapshot = ReturnType<ConnectorClient['getSnapshot']> & {
     select: (walletName: string) => Promise<void>;
     disconnect: () => Promise<void>;
     selectAccount: (address: string) => Promise<void>;
+    /** WalletConnect URI for QR code display (null when not connecting via WalletConnect) */
+    walletConnectUri: string | null;
+    /** Clear the WalletConnect URI (call when modal closes or connection completes) */
+    clearWalletConnectUri: () => void;
 };
 interface MobileWalletAdapterConfig {
     appIdentity: {
@@ -953,4 +1232,4 @@ declare const ready: Promise<void>;
  */
 declare function getWalletsRegistry(): WalletsRegistry;
 
-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 };
+export { type WalletConnectSignTransactionResult as $, type AccountInfo as A, type WalletName as B, ConnectorProvider as C, type DefaultConfigOptions as D, type ExtendedConnectorConfig as E, type AccountAddress as F, isWalletName as G, isAccountAddress as H, type CoinGeckoConfig as I, type ConnectorHealth as J, type ConnectorDebugMetrics as K, type ConnectorDebugState as L, type MobileWalletAdapterConfig as M, type Listener as N, type ConnectorEvent as O, type ConnectorEventListener as P, type StorageAdapter as Q, type StorageOptions as R, type SimplifiedWalletConnectConfig as S, type EnhancedStorageAccountOptions as T, type EnhancedStorageClusterOptions as U, type EnhancedStorageWalletOptions as V, type WalletInfo as W, type WalletConnectSolanaAccount as X, type WalletConnectSignMessageParams as Y, type WalletConnectSignMessageResult as Z, type WalletConnectSignTransactionParams as _, useConnectorClient as a, type WalletConnectSignAllTransactionsParams as a0, type WalletConnectSignAllTransactionsResult as a1, type WalletConnectSignAndSendTransactionParams as a2, type WalletConnectSignAndSendTransactionResult as a3, ClipboardErrorType as a4, type ClipboardResult as a5, type CopyOptions as a6, isClipboardAvailable as a7, copyToClipboard as a8, copyAddressToClipboard as a9, copySignatureToClipboard as aa, getClusterRpcUrl as ab, getClusterExplorerUrl as ac, getTransactionUrl as ad, getAddressUrl as ae, getTokenUrl as af, getBlockUrl as ag, isMainnetCluster as ah, isDevnetCluster as ai, isTestnetCluster as aj, isLocalCluster as ak, getClusterName as al, getClusterType as am, getClusterChainId as an, getChainIdForWalletStandard as ao, getDefaultMobileConfig as b, ConnectorErrorBoundary as c, type ConnectorSnapshot as d, type ConnectorConfig as e, type ConnectorState as f, getDefaultConfig as g, type WalletStandardWallet as h, type WalletStandardAccount as i, type ClusterType as j, ConnectorClient as k, getWalletsRegistry as l, WalletErrorType as m, type WalletError as n, getPublicSolanaRpcUrl as o, createSolanaClient as p, type SolanaClusterMoniker as q, ready as r, type ModifiedClusterUrl as s, type SolanaClient as t, useConnector as u, type CreateSolanaClientArgs as v, withErrorBoundary as w, type WalletConnectConfig as x, type WalletConnectMetadata as y, type WalletConnectTransport as z };

package/dist/{standard-shim-D9guL5fz.d.ts → standard-shim-LsQ97i9T.d.ts}

@@ -117,6 +117,213 @@ interface AccountInfo {
     raw: WalletAccount;
 }
 
+/**
+ * WalletConnect configuration types
+ *
+ * Types for configuring WalletConnect integration with the connector.
+ * WalletConnect uses Solana JSON-RPC methods as documented at:
+ * https://docs.walletconnect.network/wallet-sdk/chain-support/solana
+ */
+/**
+ * WalletConnect app metadata
+ * Required for session establishment with mobile/desktop wallets
+ */
+interface WalletConnectMetadata {
+    /** Application name displayed to the user in the wallet */
+    name: string;
+    /** Brief description of the application */
+    description: string;
+    /** Application URL (used for verification) */
+    url: string;
+    /** Array of icon URLs for the application */
+    icons: string[];
+}
+/**
+ * Configuration for WalletConnect integration
+ *
+ * When enabled, ConnectorKit registers a virtual "WalletConnect" wallet
+ * into the Wallet Standard registry. This wallet proxies all signing
+ * operations through WalletConnect's Solana JSON-RPC methods.
+ *
+ * @example
+ * ```typescript
+ * const config = getDefaultConfig({
+ *   appName: 'My App',
+ *   walletConnect: {
+ *     enabled: true,
+ *     projectId: process.env.NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID!,
+ *     metadata: {
+ *       name: 'My App',
+ *       description: 'My Solana Application',
+ *       url: 'https://myapp.com',
+ *       icons: ['https://myapp.com/icon.png'],
+ *     },
+ *     onDisplayUri: (uri) => {
+ *       // Show QR code or deep link with this URI
+ *       console.log('WalletConnect URI:', uri);
+ *     },
+ *   },
+ * });
+ * ```
+ */
+interface WalletConnectConfig {
+    /**
+     * Enable WalletConnect integration.
+     * When true, a "WalletConnect" wallet is registered in the Wallet Standard registry.
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * WalletConnect Cloud project ID.
+     * Get one at https://cloud.walletconnect.com/
+     */
+    projectId: string;
+    /**
+     * Application metadata shown to users during connection.
+     */
+    metadata: WalletConnectMetadata;
+    /**
+     * Default Solana chain/cluster for WalletConnect sessions.
+     * Used as fallback if getCurrentChain is not provided.
+     * Uses ConnectorKit's cluster ID format.
+     * @default 'solana:mainnet'
+     */
+    defaultChain?: 'solana:mainnet' | 'solana:devnet' | 'solana:testnet';
+    /**
+     * Callback to get the current chain/cluster dynamically.
+     * When provided, this is called before each request to determine the chain.
+     * This allows WalletConnect to follow the app's cluster selection.
+     *
+     * @returns The current chain ID (e.g., 'solana:mainnet', 'solana:devnet')
+     */
+    getCurrentChain?: () => 'solana:mainnet' | 'solana:devnet' | 'solana:testnet';
+    /**
+     * Callback invoked when WalletConnect needs to display a connection URI.
+     * The app should render this as a QR code or use it for deep linking.
+     *
+     * If not provided, the URI will be logged to console in development.
+     *
+     * @param uri - The WalletConnect pairing URI (starts with "wc:")
+     */
+    onDisplayUri?: (uri: string) => void;
+    /**
+     * Callback invoked when a WalletConnect session is established.
+     */
+    onSessionEstablished?: () => void;
+    /**
+     * Callback invoked when a WalletConnect session is disconnected.
+     */
+    onSessionDisconnected?: () => void;
+    /**
+     * Optional relay URL override.
+     * @default 'wss://relay.walletconnect.org'
+     */
+    relayUrl?: string;
+}
+/**
+ * Internal transport interface for WalletConnect provider
+ * Used by the shim wallet to communicate with WalletConnect
+ */
+interface WalletConnectTransport {
+    /** Establish connection and create/restore session */
+    connect(): Promise<void>;
+    /** Disconnect the current session */
+    disconnect(): Promise<void>;
+    /** Send a JSON-RPC request to the connected wallet */
+    request<T = unknown>(args: {
+        method: string;
+        params: unknown;
+        chainId?: string;
+    }): Promise<T>;
+    /** Check if there's an active session */
+    isConnected(): boolean;
+    /** Get accounts from the current session namespaces (if available) */
+    getSessionAccounts(): string[];
+}
+/**
+ * WalletConnect Solana account response
+ * Response format from solana_getAccounts and solana_requestAccounts
+ */
+interface WalletConnectSolanaAccount {
+    /** Base58-encoded public key */
+    pubkey: string;
+}
+/**
+ * WalletConnect sign message params
+ * Parameters for solana_signMessage
+ */
+interface WalletConnectSignMessageParams {
+    /** Base58-encoded message bytes */
+    message: string;
+    /** Base58-encoded public key of the signer */
+    pubkey: string;
+}
+/**
+ * WalletConnect sign message result
+ * Response from solana_signMessage
+ */
+interface WalletConnectSignMessageResult {
+    /** Base58-encoded signature */
+    signature: string;
+}
+/**
+ * WalletConnect sign transaction params
+ * Parameters for solana_signTransaction
+ */
+interface WalletConnectSignTransactionParams {
+    /** Base64-encoded serialized transaction */
+    transaction: string;
+}
+/**
+ * WalletConnect sign transaction result
+ * Response from solana_signTransaction
+ */
+interface WalletConnectSignTransactionResult {
+    /** Base58-encoded signature */
+    signature: string;
+    /** Optional: Base64-encoded signed transaction (if wallet returns full tx) */
+    transaction?: string;
+}
+/**
+ * WalletConnect sign all transactions params
+ * Parameters for solana_signAllTransactions
+ */
+interface WalletConnectSignAllTransactionsParams {
+    /** Array of Base64-encoded serialized transactions */
+    transactions: string[];
+}
+/**
+ * WalletConnect sign all transactions result
+ * Response from solana_signAllTransactions
+ */
+interface WalletConnectSignAllTransactionsResult {
+    /** Array of Base64-encoded signed transactions */
+    transactions: string[];
+}
+/**
+ * WalletConnect sign and send transaction params
+ * Parameters for solana_signAndSendTransaction
+ */
+interface WalletConnectSignAndSendTransactionParams {
+    /** Base64-encoded serialized transaction */
+    transaction: string;
+    /** Optional send options */
+    sendOptions?: {
+        skipPreflight?: boolean;
+        preflightCommitment?: 'processed' | 'confirmed' | 'finalized' | 'recent' | 'single' | 'singleGossip' | 'root' | 'max';
+        maxRetries?: number;
+        minContextSlot?: number;
+    };
+}
+/**
+ * WalletConnect sign and send transaction result
+ * Response from solana_signAndSendTransaction
+ */
+interface WalletConnectSignAndSendTransactionResult {
+    /** Base58-encoded transaction signature (transaction ID) */
+    signature: string;
+}
+
 /**
  * CoinGecko API configuration for price fetching.
  *
@@ -212,6 +419,12 @@ interface ConnectorConfig {
      * Configure API key for higher rate limits and retry behavior for 429 responses.
      */
     coingecko?: CoinGeckoConfig;
+    /**
+     * WalletConnect configuration for connecting via QR code / deep link.
+     * When enabled, a "WalletConnect" wallet is registered in the Wallet Standard registry.
+     * @see https://docs.walletconnect.network/wallet-sdk/chain-support/solana
+     */
+    walletConnect?: WalletConnectConfig;
 }
 /**
  * Health check information for connector diagnostics
@@ -363,8 +576,14 @@ declare class ConnectorClient {
     private healthMonitor;
     private initialized;
     private config;
+    private walletConnectRegistration;
     constructor(config?: ConnectorConfig);
     private initialize;
+    /**
+     * Initialize WalletConnect integration
+     * Dynamically imports and registers the WalletConnect wallet
+     */
+    private initializeWalletConnect;
     select(walletName: string): Promise<void>;
     disconnect(): Promise<void>;
     selectAccount(address: string): Promise<void>;
@@ -441,6 +660,62 @@ interface DefaultConfigOptions {
      * @see https://docs.coingecko.com/reference/introduction for rate limit details
      */
     coingecko?: CoinGeckoConfig;
+    /**
+     * WalletConnect configuration for connecting via QR code / deep link.
+     * When enabled, a "WalletConnect" wallet appears in the wallet list.
+     *
+     * Can be:
+     * - `true` to enable with auto-detected project ID from NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID env var
+     * - An object with optional overrides (projectId, metadata, etc.)
+     * - `undefined` or `false` to disable
+     *
+     * When using `true` or minimal config, the following are auto-configured:
+     * - `projectId`: Read from NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID
+     * - `metadata.name`: Uses appName
+     * - `metadata.url`: Uses appUrl or window.location.origin
+     * - `metadata.description`: Auto-generated from appName
+     * - `metadata.icons`: Uses appUrl/icon.svg
+     * - `getCurrentChain`: Auto-reads from cluster storage
+     * - `onDisplayUri/onSessionEstablished/onSessionDisconnected`: Auto-wired by AppProvider
+     *
+     * @example
+     * ```ts
+     * // Simplest - just enable it (reads project ID from env)
+     * getDefaultConfig({ appName: 'My App', walletConnect: true })
+     *
+     * // With explicit project ID
+     * getDefaultConfig({
+     *   appName: 'My App',
+     *   walletConnect: { projectId: 'my-project-id' }
+     * })
+     * ```
+     *
+     * @see https://docs.walletconnect.network/wallet-sdk/chain-support/solana
+     */
+    walletConnect?: boolean | SimplifiedWalletConnectConfig;
+}
+/**
+ * Simplified WalletConnect configuration
+ * Most fields are auto-generated from appName/appUrl if not provided
+ */
+interface SimplifiedWalletConnectConfig {
+    /**
+     * WalletConnect Cloud project ID.
+     * If not provided, reads from NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID env var.
+     */
+    projectId?: string;
+    /**
+     * Optional metadata overrides. Merged with auto-generated metadata.
+     */
+    metadata?: Partial<WalletConnectConfig['metadata']>;
+    /**
+     * Default chain. Defaults to 'solana:mainnet'.
+     */
+    defaultChain?: WalletConnectConfig['defaultChain'];
+    /**
+     * Optional relay URL override.
+     */
+    relayUrl?: string;
 }
 /** Extended ConnectorConfig with app metadata */
 interface ExtendedConnectorConfig extends ConnectorConfig {
@@ -521,6 +796,10 @@ type ConnectorSnapshot = ReturnType<ConnectorClient['getSnapshot']> & {
     select: (walletName: string) => Promise<void>;
     disconnect: () => Promise<void>;
     selectAccount: (address: string) => Promise<void>;
+    /** WalletConnect URI for QR code display (null when not connecting via WalletConnect) */
+    walletConnectUri: string | null;
+    /** Clear the WalletConnect URI (call when modal closes or connection completes) */
+    clearWalletConnectUri: () => void;
 };
 interface MobileWalletAdapterConfig {
     appIdentity: {
@@ -953,4 +1232,4 @@ declare const ready: Promise<void>;
  */
 declare function getWalletsRegistry(): WalletsRegistry;
 
-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 };
+export { type WalletConnectSignTransactionResult as $, type AccountInfo as A, type WalletName as B, ConnectorProvider as C, type DefaultConfigOptions as D, type ExtendedConnectorConfig as E, type AccountAddress as F, isWalletName as G, isAccountAddress as H, type CoinGeckoConfig as I, type ConnectorHealth as J, type ConnectorDebugMetrics as K, type ConnectorDebugState as L, type MobileWalletAdapterConfig as M, type Listener as N, type ConnectorEvent as O, type ConnectorEventListener as P, type StorageAdapter as Q, type StorageOptions as R, type SimplifiedWalletConnectConfig as S, type EnhancedStorageAccountOptions as T, type EnhancedStorageClusterOptions as U, type EnhancedStorageWalletOptions as V, type WalletInfo as W, type WalletConnectSolanaAccount as X, type WalletConnectSignMessageParams as Y, type WalletConnectSignMessageResult as Z, type WalletConnectSignTransactionParams as _, useConnectorClient as a, type WalletConnectSignAllTransactionsParams as a0, type WalletConnectSignAllTransactionsResult as a1, type WalletConnectSignAndSendTransactionParams as a2, type WalletConnectSignAndSendTransactionResult as a3, ClipboardErrorType as a4, type ClipboardResult as a5, type CopyOptions as a6, isClipboardAvailable as a7, copyToClipboard as a8, copyAddressToClipboard as a9, copySignatureToClipboard as aa, getClusterRpcUrl as ab, getClusterExplorerUrl as ac, getTransactionUrl as ad, getAddressUrl as ae, getTokenUrl as af, getBlockUrl as ag, isMainnetCluster as ah, isDevnetCluster as ai, isTestnetCluster as aj, isLocalCluster as ak, getClusterName as al, getClusterType as am, getClusterChainId as an, getChainIdForWalletStandard as ao, getDefaultMobileConfig as b, ConnectorErrorBoundary as c, type ConnectorSnapshot as d, type ConnectorConfig as e, type ConnectorState as f, getDefaultConfig as g, type WalletStandardWallet as h, type WalletStandardAccount as i, type ClusterType as j, ConnectorClient as k, getWalletsRegistry as l, WalletErrorType as m, type WalletError as n, getPublicSolanaRpcUrl as o, createSolanaClient as p, type SolanaClusterMoniker as q, ready as r, type ModifiedClusterUrl as s, type SolanaClient as t, useConnector as u, type CreateSolanaClientArgs as v, withErrorBoundary as w, type WalletConnectConfig as x, type WalletConnectMetadata as y, type WalletConnectTransport as z };

package/dist/walletconnect-D4JN6H2O.js

@@ -0,0 +1,28 @@
+'use strict';
+
+var chunk4JT24DIX_js = require('./chunk-4JT24DIX.js');
+
+
+
+Object.defineProperty(exports, "createMockWalletConnectTransport", {
+  enumerable: true,
+  get: function () { return chunk4JT24DIX_js.createMockWalletConnectTransport; }
+});
+Object.defineProperty(exports, "createWalletConnectTransport", {
+  enumerable: true,
+  get: function () { return chunk4JT24DIX_js.createWalletConnectTransport; }
+});
+Object.defineProperty(exports, "createWalletConnectWallet", {
+  enumerable: true,
+  get: function () { return chunk4JT24DIX_js.createWalletConnectWallet; }
+});
+Object.defineProperty(exports, "isWalletConnectAvailable", {
+  enumerable: true,
+  get: function () { return chunk4JT24DIX_js.isWalletConnectAvailable; }
+});
+Object.defineProperty(exports, "registerWalletConnectWallet", {
+  enumerable: true,
+  get: function () { return chunk4JT24DIX_js.registerWalletConnectWallet; }
+});
+//# sourceMappingURL=walletconnect-D4JN6H2O.js.map
+//# sourceMappingURL=walletconnect-D4JN6H2O.js.map

package/dist/walletconnect-D4JN6H2O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"walletconnect-D4JN6H2O.js"}

package/dist/walletconnect-I3PZUBTA.mjs

@@ -0,0 +1,3 @@
+export { createMockWalletConnectTransport, createWalletConnectTransport, createWalletConnectWallet, isWalletConnectAvailable, registerWalletConnectWallet } from './chunk-7XHVZW2L.mjs';
+//# sourceMappingURL=walletconnect-I3PZUBTA.mjs.map
+//# sourceMappingURL=walletconnect-I3PZUBTA.mjs.map