@solana/connector 0.1.0 → 0.1.2

package/dist/headless.d.ts

@@ -1,14 +1,22 @@
-import { B as StorageOptions, S as StorageAdapter, F as EnhancedStorageAccountOptions, G as EnhancedStorageClusterOptions, H as EnhancedStorageWalletOptions } from './wallet-standard-shim-BGlvGRbB.js';
-export { q as AccountAddress, A as AccountInfo, K as ClipboardErrorType, N as ClipboardResult, i as ClusterType, j as ConnectorClient, d as ConnectorConfig, v as ConnectorDebugMetrics, x as ConnectorDebugState, y as ConnectorEvent, z as ConnectorEventListener, t as ConnectorHealth, e as ConnectorState, O as CopyOptions, D as DefaultConfigOptions, E as ExtendedConnectorConfig, L as Listener, M as MobileWalletAdapterConfig, a7 as PUBLIC_RPC_ENDPOINTS, a6 as SolanaNetwork, h as UnifiedConfig, U as UnifiedConfigOptions, J as WalletError, I as WalletErrorType, W as WalletInfo, p as WalletName, g as WalletStandardAccount, f as WalletStandardWallet, R as copyAddressToClipboard, T as copySignatureToClipboard, Q as copyToClipboard, n as createConfig, Z as getAddressUrl, $ as getBlockUrl, X as getClusterExplorerUrl, a4 as getClusterName, V as getClusterRpcUrl, a5 as getClusterType, l as getDefaultConfig, m as getDefaultMobileConfig, aa as getDefaultRpcUrl, af as getNetworkDisplayName, _ as getTokenUrl, Y as getTransactionUrl, k as getWalletsRegistry, s as isAccountAddress, P as isClipboardAvailable, ac as isDevnet, a1 as isDevnetCluster, a3 as isLocalCluster, ae as isLocalnet, ab as isMainnet, a0 as isMainnetCluster, ad as isTestnet, a2 as isTestnetCluster, o as isUnifiedConfig, r as isWalletName, a8 as normalizeNetwork, a9 as toClusterId } from './wallet-standard-shim-BGlvGRbB.js';
-import { j as TransactionSigner } from './transaction-signer-BtJPGXIg.js';
-export { l as ConfigurationError, x as ConfigurationErrorCode, k as ConnectionError, v as ConnectionErrorCode, C as ConnectorError, E as Errors, N as NetworkError, y as NetworkErrorCode, a as SignedTransaction, S as SolanaTransaction, c as TransactionActivity, d as TransactionActivityStatus, m as TransactionError, z as TransactionErrorCode, f as TransactionMetadata, e as TransactionMethod, b as TransactionSignerCapabilities, T as TransactionSignerConfig, h as TransactionSignerError, V as ValidationError, w as ValidationErrorCode, g as createTransactionSigner, u as getUserFriendlyMessage, q as isConfigurationError, o as isConnectionError, n as isConnectorError, r as isNetworkError, s as isTransactionError, i as isTransactionSignerError, p as isValidationError, t as toConnectorError } from './transaction-signer-BtJPGXIg.js';
+import { i as ClusterType, B as StorageOptions, S as StorageAdapter, F as EnhancedStorageAccountOptions, G as EnhancedStorageClusterOptions, H as EnhancedStorageWalletOptions } from './wallet-standard-shim-C1tisl9S.js';
+export { q as AccountAddress, A as AccountInfo, K as ClipboardErrorType, N as ClipboardResult, j as ConnectorClient, d as ConnectorConfig, v as ConnectorDebugMetrics, x as ConnectorDebugState, y as ConnectorEvent, z as ConnectorEventListener, t as ConnectorHealth, e as ConnectorState, O as CopyOptions, D as DefaultConfigOptions, E as ExtendedConnectorConfig, L as Listener, M as MobileWalletAdapterConfig, a9 as PUBLIC_RPC_ENDPOINTS, a8 as SolanaNetwork, h as UnifiedConfig, U as UnifiedConfigOptions, J as WalletError, I as WalletErrorType, W as WalletInfo, p as WalletName, g as WalletStandardAccount, f as WalletStandardWallet, R as copyAddressToClipboard, T as copySignatureToClipboard, Q as copyToClipboard, n as createConfig, Z as getAddressUrl, $ as getBlockUrl, a7 as getChainIdForWalletStandard, a6 as getClusterChainId, X as getClusterExplorerUrl, a4 as getClusterName, V as getClusterRpcUrl, a5 as getClusterType, l as getDefaultConfig, m as getDefaultMobileConfig, ac as getDefaultRpcUrl, ah as getNetworkDisplayName, _ as getTokenUrl, Y as getTransactionUrl, k as getWalletsRegistry, s as isAccountAddress, P as isClipboardAvailable, ae as isDevnet, a1 as isDevnetCluster, a3 as isLocalCluster, ag as isLocalnet, ad as isMainnet, a0 as isMainnetCluster, af as isTestnet, a2 as isTestnetCluster, o as isUnifiedConfig, r as isWalletName, aa as normalizeNetwork, ab as toClusterId } from './wallet-standard-shim-C1tisl9S.js';
+import { j as TransactionSigner } from './transaction-signer-D3csM_Mf.js';
+export { l as ConfigurationError, x as ConfigurationErrorCode, k as ConnectionError, v as ConnectionErrorCode, C as ConnectorError, E as Errors, N as NetworkError, y as NetworkErrorCode, a as SignedTransaction, S as SolanaTransaction, c as TransactionActivity, d as TransactionActivityStatus, m as TransactionError, z as TransactionErrorCode, f as TransactionMetadata, e as TransactionMethod, b as TransactionSignerCapabilities, T as TransactionSignerConfig, h as TransactionSignerError, V as ValidationError, w as ValidationErrorCode, g as createTransactionSigner, u as getUserFriendlyMessage, q as isConfigurationError, o as isConnectionError, n as isConnectorError, r as isNetworkError, s as isTransactionError, i as isTransactionSignerError, p as isValidationError, t as toConnectorError } from './transaction-signer-D3csM_Mf.js';
 import { TransactionModifyingSigner } from 'gill';
-import { Storage, SolanaClusterId } from '@wallet-ui/core';
+import { SolanaCluster, SolanaClusterId, Storage } from '@wallet-ui/core';
 export { SolanaCluster, SolanaClusterId, createSolanaDevnet, createSolanaLocalnet, createSolanaMainnet, createSolanaTestnet } from '@wallet-ui/core';
+import { MessageModifyingSigner, TransactionSendingSigner, SignatureDictionary } from '@solana/signers';
+export { MessageModifyingSigner, MessageModifyingSignerConfig, SignableMessage, SignatureDictionary, TransactionSendingSigner, TransactionSendingSignerConfig, createSignableMessage } from '@solana/signers';
+import { Address } from '@solana/addresses';
+export { Address, address } from '@solana/addresses';
+import { SignatureBytes } from '@solana/keys';
+export { SignatureBytes } from '@solana/keys';
+export { Transaction } from '@solana/transactions';
+import { Wallet, WalletAccount } from '@wallet-standard/base';
 export { Wallet, WalletAccount } from '@wallet-standard/base';
+import { Connection, SendOptions } from '@solana/web3.js';
 import 'react';
 import 'react/jsx-runtime';
-import '@solana/web3.js';
 
 /**
  * @solana/connector - Formatting utilities
@@ -85,6 +93,25 @@ declare function formatTokenAmount(amount: number | bigint, decimals: number, op
     maximumDecimals?: number;
 }): string;
 
+declare const SOLANA_CHAIN_IDS: {
+    readonly mainnet: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+    readonly devnet: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
+    readonly testnet: "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z";
+};
+declare function getChainIdFromCluster(cluster: SolanaCluster): `solana:${string}` | null;
+declare function getChainIdFromClusterId(clusterId: SolanaClusterId): `solana:${string}` | null;
+declare function getChainIdFromClusterType(type: ClusterType): `solana:${string}` | null;
+declare function getClusterTypeFromChainId(chainId: string): ClusterType | null;
+declare function getClusterIdFromChainId(chainId: string): SolanaClusterId | null;
+declare function isSolanaChain(chain: string): chain is `solana:${string}`;
+declare function isKnownSolanaChain(chain: string): boolean;
+declare function validateKnownSolanaChain(chain: string): asserts chain is `solana:${string}`;
+declare function getClusterTypeFromConnection(connection: Connection | null): ClusterType | null;
+declare function getChainIdFromConnection(connection: Connection | null, network?: 'mainnet' | 'devnet' | 'testnet'): `solana:${string}` | null;
+declare function clusterToChainId(cluster: SolanaCluster): `solana:${string}` | null;
+declare function chainIdToClusterType(chainId: string): ClusterType | null;
+declare function chainIdToClusterId(chainId: string): SolanaClusterId | null;
+
 /**
  * @solana/connector - Gill/Kit Transaction Signer Adapter
  *
@@ -126,15 +153,7 @@ declare function formatTokenAmount(amount: number | bigint, decimals: number, op
 declare function createGillTransactionSigner<TAddress extends string = string>(connectorSigner: TransactionSigner): TransactionModifyingSigner<TAddress>;
 
 /**
- * @solana/connector - Enhanced Storage
- *
- * Extended version of @wallet-ui/core Storage with additional features:
- * - Validation hooks
- * - Error handling and recovery
- * - SSR/memory fallback
- * - Transform utilities
- * - Migration support
- * - Storage availability checks
+ * Enhanced Storage
  */
 
 /**
@@ -147,112 +166,21 @@ declare class EnhancedStorage<T> extends Storage<T> {
     private validators;
     private memoryFallback;
     constructor(key: string, initial: T, options?: StorageOptions<T> | undefined);
-    /**
-     * Enhanced set with validation and error handling
-     * @returns boolean indicating success
-     */
     set(value: T): boolean;
-    /**
-     * Enhanced get with error handling and fallback
-     */
     get(): T;
-    /**
-     * Validate a value against all registered validators
-     */
     validate(value: T): boolean;
-    /**
-     * Add a validation rule (chainable)
-     *
-     * @example
-     * ```ts
-     * storage
-     *   .addValidator((addr) => addr?.length === 44)
-     *   .addValidator((addr) => addr?.startsWith('5'))
-     * ```
-     */
     addValidator(validator: (value: T) => boolean): this;
-    /**
-     * Add error handler (chainable)
-     */
     onError(handler: (error: Error) => void): this;
-    /**
-     * Transform the stored value
-     *
-     * @example
-     * ```ts
-     * const formatted = storage.transform(
-     *   (address) => address ? formatAddress(address) : ''
-     * )
-     * ```
-     */
     transform<U>(transformer: (value: T) => U): U;
-    /**
-     * Reset to initial value
-     */
     reset(): void;
-    /**
-     * Clear storage (remove from localStorage)
-     */
     clear(): void;
-    /**
-     * Check if storage is available (not in private mode, quota not exceeded)
-     */
     isAvailable(): boolean;
-    /**
-     * Migrate from old key to new key
-     *
-     * @example
-     * ```ts
-     * EnhancedStorage.migrate(
-     *   'old-connector:account',
-     *   createEnhancedStorageAccount()
-     * )
-     * ```
-     */
     static migrate<T>(oldKey: string, newStorage: EnhancedStorage<T>): boolean;
     private handleError;
 }
-/**
- * Create a storage instance for wallet account persistence
- *
- * @example
- * ```ts
- * const storage = createEnhancedStorageAccount({
- *   validator: (address) => {
- *     if (!address) return true
- *     return isAddress(address)
- *   }
- * })
- * ```
- */
 declare function createEnhancedStorageAccount(options?: EnhancedStorageAccountOptions): EnhancedStorage<string | undefined>;
-/**
- * Create a storage instance for cluster selection persistence
- *
- * @example
- * ```ts
- * const storage = createEnhancedStorageCluster({
- *   initial: 'solana:mainnet',
- *   validClusters: ['solana:mainnet', 'solana:devnet']
- * })
- * ```
- */
 declare function createEnhancedStorageCluster(options?: EnhancedStorageClusterOptions): EnhancedStorage<SolanaClusterId>;
-/**
- * Create a storage instance for wallet name persistence
- *
- * @example
- * ```ts
- * const storage = createEnhancedStorageWallet({
- *   onError: (error) => console.error('Wallet storage error:', error)
- * })
- * ```
- */
 declare function createEnhancedStorageWallet(options?: EnhancedStorageWalletOptions): EnhancedStorage<string | undefined>;
-/**
- * Adapter to make EnhancedStorage compatible with StorageAdapter interface
- * Exposes both the basic interface and enhanced methods for advanced usage
- */
 declare class EnhancedStorageAdapter<T> implements StorageAdapter<T> {
     private storage;
     constructor(storage: EnhancedStorage<T>);
@@ -351,6 +279,193 @@ declare function getPolyfillStatus(): {
     environment: 'browser' | 'server';
 };
 
+/**
+ * @solana/connector - Kit Signer Factories
+ *
+ * Framework-agnostic factory functions to create Kit-compatible signers from wallet functions.
+ * These factories enable pure Kit integration without React or framework dependencies.
+ */
+
+/**
+ * Create a MessageModifyingSigner from a wallet's sign message function
+ *
+ * This is a pure, framework-agnostic factory function that can be used anywhere.
+ * Enables message signing (SIWS, auth) without React.
+ *
+ * @param walletAddress - The address of the wallet
+ * @param signMessageFn - Function to sign a message (from wallet adapter)
+ * @returns A frozen MessageModifyingSigner object
+ *
+ * @example
+ * ```typescript
+ * import { address } from '@solana/addresses';
+ * import { createMessageSignerFromWallet } from '@solana/connector/headless';
+ *
+ * const signer = createMessageSignerFromWallet(
+ *   address('...'),
+ *   async (msg) => await wallet.signMessage(msg)
+ * );
+ *
+ * // Use with Kit message signing
+ * import { createSignableMessage } from '@solana/signers';
+ * const signed = await signer.modifyAndSignMessages([createSignableMessage(messageBytes)]);
+ * ```
+ */
+declare function createMessageSignerFromWallet(walletAddress: Address<string>, signMessageFn: (message: Uint8Array) => Promise<Uint8Array>): MessageModifyingSigner<string>;
+/**
+ * Create a TransactionSendingSigner from a wallet's send transaction function
+ *
+ * This is a pure, framework-agnostic factory function that can be used anywhere.
+ * Enables sign + send in one operation (wallets like Phantom support this).
+ *
+ * @param walletAddress - The address of the wallet
+ * @param chain - The Solana chain identifier (e.g., 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1')
+ * @param sendTransactionFn - Function to send a transaction (from wallet adapter)
+ * @returns A frozen TransactionSendingSigner object
+ *
+ * @example
+ * ```typescript
+ * import { address } from '@solana/addresses';
+ * import { createTransactionSendingSignerFromWallet } from '@solana/connector/headless';
+ *
+ * const signer = createTransactionSendingSignerFromWallet(
+ *   address('...'),
+ *   'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
+ *   async (tx) => await wallet.sendTransaction(tx, connection)
+ * );
+ *
+ * // Use with Kit transaction sending
+ * const signatures = await signer.signAndSendTransactions([transaction]);
+ * ```
+ */
+declare function createTransactionSendingSignerFromWallet(walletAddress: Address<string>, chain: `solana:${string}`, sendTransactionFn: (transaction: any) => Promise<string>): TransactionSendingSigner<string>;
+
+/**
+ * @solana/connector - Kit Integration Helper
+ *
+ * High-level helper to create Kit signers from Wallet Standard wallets.
+ * Framework-agnostic and works in any JavaScript environment.
+ */
+
+/**
+ * Result of creating Kit signers from a Wallet Standard wallet
+ */
+interface KitSignersFromWallet {
+    /** Kit Address type (null if wallet not connected) */
+    address: Address<string> | null;
+    /** Plain address string (null if wallet not connected) */
+    addressString: string | null;
+    /** Message signer (null if wallet doesn't support signing or not connected) */
+    messageSigner: MessageModifyingSigner<string> | null;
+    /** Transaction sending signer (null if wallet doesn't support or not connected) */
+    transactionSigner: TransactionSendingSigner<string> | null;
+}
+/**
+ * Create Kit-compatible signers from a Wallet Standard wallet
+ *
+ * This function bridges Wallet Standard wallets with modern Kit architecture.
+ * It's framework-agnostic and can be used in any JavaScript environment.
+ *
+ * The network is automatically detected from the connection's RPC endpoint.
+ * For custom RPC URLs, you can override detection with the optional `network` parameter.
+ *
+ * @param wallet - The Wallet Standard wallet instance
+ * @param account - The wallet account to use (first account if not provided)
+ * @param connection - Optional connection for network detection and transaction sending
+ * @param network - Optional network override ('mainnet' | 'devnet' | 'testnet')
+ * @returns Kit signers object with address and signer instances
+ *
+ * @example
+ * ```typescript
+ * import { Connection } from '@solana/web3.js';
+ * import { createKitSignersFromWallet } from '@solana/connector/headless';
+ *
+ * const connection = new Connection('https://api.devnet.solana.com');
+ * const { address, messageSigner, transactionSigner } = createKitSignersFromWallet(
+ *   wallet,
+ *   account,
+ *   connection
+ * );
+ * ```
+ */
+declare function createKitSignersFromWallet(wallet: Wallet | null, account?: WalletAccount | null, connection?: Connection | null, network?: 'mainnet' | 'devnet' | 'testnet'): KitSignersFromWallet;
+
+declare function detectMessageModification(original: Uint8Array, modified: Uint8Array): boolean;
+declare function updateSignatureDictionary(original: Uint8Array, signed: Uint8Array, originalSignatures: SignatureDictionary, address: Address<string>, signature: Uint8Array): SignatureDictionary;
+declare function freezeSigner<T extends object>(signer: T): Readonly<T>;
+declare function base58ToSignatureBytes(signature: string): SignatureBytes;
+declare function signatureBytesToBase58(bytes: SignatureBytes): string;
+
+type Commitment = 'processed' | 'confirmed' | 'finalized';
+type KitRpc = {
+    getLatestBlockhash(options?: {
+        commitment?: Commitment;
+    }): {
+        send(): Promise<{
+            value: {
+                blockhash: string;
+                lastValidBlockHeight: number;
+            };
+        }>;
+    };
+    sendTransaction(bytes: Uint8Array | string, options?: any): {
+        send(): Promise<string>;
+    };
+    send?: () => unknown;
+};
+type DualConnection = Connection | KitRpc;
+declare function isLegacyConnection(conn: DualConnection): conn is Connection;
+declare function isKitConnection(conn: DualConnection): conn is KitRpc;
+
+/**
+ * @solana/connector - Connection Helpers
+ *
+ * Abstraction layer for working with both legacy @solana/web3.js Connection
+ * and modern Kit/gill Rpc objects.
+ */
+
+/**
+ * Get latest blockhash from either legacy Connection or Kit Rpc
+ *
+ * Abstracts the differences between web3.js 1.x and Kit/gill APIs.
+ *
+ * @param connection - Legacy Connection or Kit Rpc
+ * @param commitment - Optional commitment level (default: 'confirmed')
+ * @returns Latest blockhash and last valid block height
+ *
+ * @example
+ * ```typescript
+ * // Works with both Connection and Rpc
+ * const { blockhash, lastValidBlockHeight } = await getLatestBlockhash(connection);
+ * ```
+ */
+declare function getLatestBlockhash(connection: DualConnection, commitment?: Commitment): Promise<{
+    blockhash: string;
+    lastValidBlockHeight: number;
+}>;
+/**
+ * Send raw transaction bytes to either legacy Connection or Kit Rpc
+ *
+ * Abstracts the differences between web3.js 1.x and Kit/gill APIs.
+ *
+ * @param connection - Legacy Connection or Kit Rpc
+ * @param bytes - Raw transaction bytes
+ * @param options - Optional send options (skipPreflight, maxRetries, etc.)
+ * @returns Transaction signature string
+ *
+ * @example
+ * ```typescript
+ * // Works with both Connection and Rpc
+ * const signature = await sendRawTransaction(connection, transactionBytes, {
+ *   skipPreflight: false,
+ *   maxRetries: 3
+ * });
+ * ```
+ */
+declare function sendRawTransaction(connection: DualConnection, bytes: Uint8Array, options?: SendOptions & {
+    commitment?: Commitment;
+}): Promise<string>;
+
 /**
  * @solana/connector - Explorer URL Utilities
  *
@@ -397,4 +512,4 @@ declare function formatSignature(signature: string, chars?: number): string;
  */
 declare function copySignature(signature: string): Promise<boolean>;
 
-export { EnhancedStorage, EnhancedStorageAccountOptions, EnhancedStorageAdapter, EnhancedStorageClusterOptions, EnhancedStorageWalletOptions, type ExplorerOptions, type ExplorerType, StorageAdapter, StorageOptions, TransactionSigner, copySignature, createEnhancedStorageAccount, createEnhancedStorageCluster, createEnhancedStorageWallet, createGillTransactionSigner, formatAddress, formatNumber, formatSOL, formatSignature, formatTokenAmount, getAllExplorerUrls, getPolyfillStatus, getSolanaExplorerUrl, getSolanaFmUrl, getSolscanUrl, getXrayUrl, installPolyfills, isCryptoAvailable, isPolyfillInstalled, truncate };
+export { ClusterType, type Commitment, type DualConnection, EnhancedStorage, EnhancedStorageAccountOptions, EnhancedStorageAdapter, EnhancedStorageClusterOptions, EnhancedStorageWalletOptions, type ExplorerOptions, type ExplorerType, type KitSignersFromWallet, SOLANA_CHAIN_IDS, StorageAdapter, StorageOptions, TransactionSigner, base58ToSignatureBytes, chainIdToClusterId, chainIdToClusterType, clusterToChainId, copySignature, createEnhancedStorageAccount, createEnhancedStorageCluster, createEnhancedStorageWallet, createGillTransactionSigner, createKitSignersFromWallet, createMessageSignerFromWallet, createTransactionSendingSignerFromWallet, detectMessageModification, formatAddress, formatNumber, formatSOL, formatSignature, formatTokenAmount, freezeSigner, getAllExplorerUrls, getChainIdFromCluster, getChainIdFromClusterId, getChainIdFromClusterType, getChainIdFromConnection, getClusterIdFromChainId, getClusterTypeFromChainId, getClusterTypeFromConnection, getLatestBlockhash, getPolyfillStatus, getSolanaExplorerUrl, getSolanaFmUrl, getSolscanUrl, getXrayUrl, installPolyfills, isCryptoAvailable, isKitConnection, isKnownSolanaChain, isLegacyConnection, isPolyfillInstalled, isSolanaChain, sendRawTransaction, signatureBytesToBase58, truncate, updateSignatureDictionary, validateKnownSolanaChain };