@solana/connector 0.1.0 → 0.1.1

package/dist/{transaction-signer-BtJPGXIg.d.ts → transaction-signer-D3csM_Mf.d.mts}

@@ -99,85 +99,40 @@ interface TransactionActivity {
 
 /**
  * @solana/connector - Unified Error System
- *
- * Provides consistent, structured error handling across the entire library.
- * All errors extend ConnectorError and include:
- * - Error codes for programmatic handling
- * - Optional context data
- * - Original error preservation
- * - Stack trace capture
- */
-/**
- * Base error class for all Connector errors
- * Provides common structure and metadata
  */
 declare abstract class ConnectorError extends Error {
-    /**
-     * Error code for programmatic handling
-     */
     abstract readonly code: string;
-    /**
-     * Whether this error is recoverable (user can retry)
-     */
     abstract readonly recoverable: boolean;
-    /**
-     * Additional context about the error
-     */
     readonly context?: Record<string, unknown>;
-    /**
-     * The underlying error that caused this error
-     */
     readonly originalError?: Error;
-    /**
-     * Timestamp when error occurred
-     */
     readonly timestamp: string;
     constructor(message: string, context?: Record<string, unknown>, originalError?: Error);
-    /**
-     * Get a JSON representation of the error
-     */
     toJSON(): Record<string, unknown>;
 }
-/**
- * Connection-related errors (wallet connection, disconnection)
- */
 declare class ConnectionError extends ConnectorError {
     readonly code: ConnectionErrorCode;
     readonly recoverable = true;
     constructor(code: ConnectionErrorCode, message: string, context?: Record<string, unknown>, originalError?: Error);
 }
 type ConnectionErrorCode = 'WALLET_NOT_CONNECTED' | 'WALLET_NOT_FOUND' | 'CONNECTION_FAILED' | 'CONNECTION_REJECTED' | 'DISCONNECTION_FAILED' | 'ACCOUNT_NOT_AVAILABLE' | 'RECONNECTION_FAILED';
-/**
- * Validation errors (invalid data, unsupported formats)
- */
 declare class ValidationError extends ConnectorError {
     readonly code: ValidationErrorCode;
     readonly recoverable = false;
     constructor(code: ValidationErrorCode, message: string, context?: Record<string, unknown>, originalError?: Error);
 }
 type ValidationErrorCode = 'INVALID_TRANSACTION' | 'INVALID_MESSAGE' | 'INVALID_ADDRESS' | 'INVALID_SIGNATURE' | 'INVALID_FORMAT' | 'UNSUPPORTED_FORMAT' | 'VALIDATION_FAILED';
-/**
- * Configuration errors (setup issues, missing required options)
- */
 declare class ConfigurationError extends ConnectorError {
     readonly code: ConfigurationErrorCode;
     readonly recoverable = false;
     constructor(code: ConfigurationErrorCode, message: string, context?: Record<string, unknown>, originalError?: Error);
 }
 type ConfigurationErrorCode = 'MISSING_PROVIDER' | 'INVALID_CLUSTER' | 'CLUSTER_NOT_FOUND' | 'INVALID_CONFIG' | 'INITIALIZATION_FAILED';
-/**
- * Network errors (RPC failures, timeout)
- */
 declare class NetworkError extends ConnectorError {
     readonly code: NetworkErrorCode;
     readonly recoverable = true;
     constructor(code: NetworkErrorCode, message: string, context?: Record<string, unknown>, originalError?: Error);
 }
 type NetworkErrorCode = 'RPC_ERROR' | 'NETWORK_TIMEOUT' | 'NETWORK_UNAVAILABLE' | 'TRANSACTION_SIMULATION_FAILED';
-/**
- * Transaction errors (signing, sending transactions)
- * Extends the existing TransactionSignerError pattern
- */
 declare class TransactionError extends ConnectorError {
     readonly code: TransactionErrorCode;
     readonly recoverable: boolean;
@@ -206,167 +161,38 @@ declare const Errors: {
     readonly featureNotSupported: (feature: string) => TransactionError;
     readonly userRejected: (operation: string) => TransactionError;
 };
-/**
- * Convert any error to a ConnectorError
- * Useful for wrapping unknown errors in a structured format
- */
 declare function toConnectorError(error: unknown, defaultMessage?: string): ConnectorError;
-/**
- * Get user-friendly error message
- * Converts technical errors into messages suitable for display
- */
 declare function getUserFriendlyMessage(error: unknown): string;
 
 /**
- * @solana/connector - Transaction Signing Abstraction Layer
- *
- * Provides a clean, unified interface for transaction operations that works
- * across both Wallet Standard and legacy wallet implementations.
- *
- * Inspired by wallet-adapter-compat's transaction signer pattern, this
- * abstraction layer makes it easy to integrate with transaction libraries
- * and provides consistent error handling and capability detection.
+ * Transaction signing abstraction layer
  */
 
-/**
- * Unified transaction signer interface
- *
- * This interface abstracts wallet-specific transaction signing methods
- * into a consistent API that works across all Wallet Standard wallets.
- *
- * @example
- * ```ts
- * const signer = createTransactionSigner({
- *   wallet: connectedWallet,
- *   account: selectedAccount,
- *   cluster: currentCluster
- * })
- *
- * // Check capabilities before using
- * const caps = signer.getCapabilities()
- * if (!caps.canSend) {
- *   console.warn('Wallet cannot send transactions directly')
- * }
- *
- * // Sign and send a transaction
- * const signature = await signer.signAndSendTransaction(transaction)
- * console.log('Transaction sent:', signature)
- * ```
- */
 interface TransactionSigner {
     /** The wallet address that will sign transactions */
     readonly address: string;
-    /**
-     * Sign a single transaction without sending it
-     * The wallet prompts the user to approve the transaction
-     *
-     * @param transaction - The transaction to sign
-     * @returns The signed transaction
-     * @throws {TransactionSignerError} If wallet doesn't support signing or user rejects
-     */
     signTransaction(transaction: SolanaTransaction): Promise<SolanaTransaction>;
-    /**
-     * Sign multiple transactions at once
-     * More efficient than signing one-by-one for batch operations
-     * Falls back to sequential signing if batch not supported
-     *
-     * @param transactions - Array of transactions to sign
-     * @returns Array of signed transactions in the same order
-     * @throws {TransactionSignerError} If signing fails for any transaction
-     */
     signAllTransactions(transactions: SolanaTransaction[]): Promise<SolanaTransaction[]>;
-    /**
-     * Sign and send a transaction in one operation
-     * The wallet handles both signing and broadcasting to the network
-     *
-     * @param transaction - The transaction to sign and send
-     * @param options - Optional send options (e.g., skipPreflight)
-     * @returns The transaction signature/hash
-     * @throws {TransactionSignerError} If sending fails or user rejects
-     */
     signAndSendTransaction(transaction: SolanaTransaction, options?: {
         skipPreflight?: boolean;
         maxRetries?: number;
     }): Promise<string>;
-    /**
-     * Sign and send multiple transactions sequentially
-     * Waits for each transaction to be sent before sending the next
-     *
-     * @param transactions - Array of transactions to sign and send
-     * @param options - Optional send options
-     * @returns Array of transaction signatures in the same order
-     * @throws {TransactionSignerError} If any transaction fails
-     */
     signAndSendTransactions(transactions: SolanaTransaction[], options?: {
         skipPreflight?: boolean;
         maxRetries?: number;
     }): Promise<string[]>;
-    /**
-     * Sign an arbitrary message (for authentication, verification, etc.)
-     * Optional: not all wallets support message signing
-     *
-     * @param message - The message to sign (as Uint8Array)
-     * @returns The signature bytes
-     * @throws {TransactionSignerError} If wallet doesn't support message signing
-     */
     signMessage?(message: Uint8Array): Promise<Uint8Array>;
-    /**
-     * Get the signer's capabilities
-     * Use this to conditionally enable/disable features in your UI
-     *
-     * @returns Object describing what this signer can do
-     */
     getCapabilities(): TransactionSignerCapabilities;
 }
-/**
- * Create a transaction signer from a Wallet Standard wallet
- *
- * This factory function creates a TransactionSigner instance that bridges
- * Wallet Standard features to a clean, consistent API.
- *
- * @param config - Configuration including wallet, account, and optional cluster
- * @returns TransactionSigner instance, or null if wallet/account invalid
- *
- * @example
- * ```ts
- * // Basic usage
- * const signer = createTransactionSigner({
- *   wallet: connectedWallet,
- *   account: selectedAccount
- * })
- *
- * if (!signer) {
- *   console.error('Failed to create signer - wallet or account missing')
- *   return
- * }
- *
- * // Use the signer
- * try {
- *   const sig = await signer.signAndSendTransaction(tx)
- *   console.log('Success:', sig)
- * } catch (error) {
- *   if (error instanceof TransactionSignerError) {
- *     console.error('Signing error:', error.code, error.message)
- *   }
- * }
- * ```
- */
 declare function createTransactionSigner(config: TransactionSignerConfig): TransactionSigner | null;
 /**
  * @deprecated Use TransactionError from '../errors' instead
- * Kept for backward compatibility
- *
- * Custom error class for transaction signer operations
- * Provides structured error information for better error handling
  */
 declare class TransactionSignerError extends TransactionError {
     constructor(message: string, code: 'WALLET_NOT_CONNECTED' | 'FEATURE_NOT_SUPPORTED' | 'SIGNING_FAILED' | 'SEND_FAILED', originalError?: Error);
 }
 /**
  * @deprecated Use isTransactionError from '../errors' instead
- * Kept for backward compatibility
- *
- * Type guard to check if an error is a TransactionSignerError
  */
 declare function isTransactionSignerError(error: unknown): error is TransactionSignerError;
 

package/dist/{transaction-signer-BtJPGXIg.d.mts → transaction-signer-D3csM_Mf.d.ts}

@@ -99,85 +99,40 @@ interface TransactionActivity {
 
 /**
  * @solana/connector - Unified Error System
- *
- * Provides consistent, structured error handling across the entire library.
- * All errors extend ConnectorError and include:
- * - Error codes for programmatic handling
- * - Optional context data
- * - Original error preservation
- * - Stack trace capture
- */
-/**
- * Base error class for all Connector errors
- * Provides common structure and metadata
  */
 declare abstract class ConnectorError extends Error {
-    /**
-     * Error code for programmatic handling
-     */
     abstract readonly code: string;
-    /**
-     * Whether this error is recoverable (user can retry)
-     */
     abstract readonly recoverable: boolean;
-    /**
-     * Additional context about the error
-     */
     readonly context?: Record<string, unknown>;
-    /**
-     * The underlying error that caused this error
-     */
     readonly originalError?: Error;
-    /**
-     * Timestamp when error occurred
-     */
     readonly timestamp: string;
     constructor(message: string, context?: Record<string, unknown>, originalError?: Error);
-    /**
-     * Get a JSON representation of the error
-     */
     toJSON(): Record<string, unknown>;
 }
-/**
- * Connection-related errors (wallet connection, disconnection)
- */
 declare class ConnectionError extends ConnectorError {
     readonly code: ConnectionErrorCode;
     readonly recoverable = true;
     constructor(code: ConnectionErrorCode, message: string, context?: Record<string, unknown>, originalError?: Error);
 }
 type ConnectionErrorCode = 'WALLET_NOT_CONNECTED' | 'WALLET_NOT_FOUND' | 'CONNECTION_FAILED' | 'CONNECTION_REJECTED' | 'DISCONNECTION_FAILED' | 'ACCOUNT_NOT_AVAILABLE' | 'RECONNECTION_FAILED';
-/**
- * Validation errors (invalid data, unsupported formats)
- */
 declare class ValidationError extends ConnectorError {
     readonly code: ValidationErrorCode;
     readonly recoverable = false;
     constructor(code: ValidationErrorCode, message: string, context?: Record<string, unknown>, originalError?: Error);
 }
 type ValidationErrorCode = 'INVALID_TRANSACTION' | 'INVALID_MESSAGE' | 'INVALID_ADDRESS' | 'INVALID_SIGNATURE' | 'INVALID_FORMAT' | 'UNSUPPORTED_FORMAT' | 'VALIDATION_FAILED';
-/**
- * Configuration errors (setup issues, missing required options)
- */
 declare class ConfigurationError extends ConnectorError {
     readonly code: ConfigurationErrorCode;
     readonly recoverable = false;
     constructor(code: ConfigurationErrorCode, message: string, context?: Record<string, unknown>, originalError?: Error);
 }
 type ConfigurationErrorCode = 'MISSING_PROVIDER' | 'INVALID_CLUSTER' | 'CLUSTER_NOT_FOUND' | 'INVALID_CONFIG' | 'INITIALIZATION_FAILED';
-/**
- * Network errors (RPC failures, timeout)
- */
 declare class NetworkError extends ConnectorError {
     readonly code: NetworkErrorCode;
     readonly recoverable = true;
     constructor(code: NetworkErrorCode, message: string, context?: Record<string, unknown>, originalError?: Error);
 }
 type NetworkErrorCode = 'RPC_ERROR' | 'NETWORK_TIMEOUT' | 'NETWORK_UNAVAILABLE' | 'TRANSACTION_SIMULATION_FAILED';
-/**
- * Transaction errors (signing, sending transactions)
- * Extends the existing TransactionSignerError pattern
- */
 declare class TransactionError extends ConnectorError {
     readonly code: TransactionErrorCode;
     readonly recoverable: boolean;
@@ -206,167 +161,38 @@ declare const Errors: {
     readonly featureNotSupported: (feature: string) => TransactionError;
     readonly userRejected: (operation: string) => TransactionError;
 };
-/**
- * Convert any error to a ConnectorError
- * Useful for wrapping unknown errors in a structured format
- */
 declare function toConnectorError(error: unknown, defaultMessage?: string): ConnectorError;
-/**
- * Get user-friendly error message
- * Converts technical errors into messages suitable for display
- */
 declare function getUserFriendlyMessage(error: unknown): string;
 
 /**
- * @solana/connector - Transaction Signing Abstraction Layer
- *
- * Provides a clean, unified interface for transaction operations that works
- * across both Wallet Standard and legacy wallet implementations.
- *
- * Inspired by wallet-adapter-compat's transaction signer pattern, this
- * abstraction layer makes it easy to integrate with transaction libraries
- * and provides consistent error handling and capability detection.
+ * Transaction signing abstraction layer
  */
 
-/**
- * Unified transaction signer interface
- *
- * This interface abstracts wallet-specific transaction signing methods
- * into a consistent API that works across all Wallet Standard wallets.
- *
- * @example
- * ```ts
- * const signer = createTransactionSigner({
- *   wallet: connectedWallet,
- *   account: selectedAccount,
- *   cluster: currentCluster
- * })
- *
- * // Check capabilities before using
- * const caps = signer.getCapabilities()
- * if (!caps.canSend) {
- *   console.warn('Wallet cannot send transactions directly')
- * }
- *
- * // Sign and send a transaction
- * const signature = await signer.signAndSendTransaction(transaction)
- * console.log('Transaction sent:', signature)
- * ```
- */
 interface TransactionSigner {
     /** The wallet address that will sign transactions */
     readonly address: string;
-    /**
-     * Sign a single transaction without sending it
-     * The wallet prompts the user to approve the transaction
-     *
-     * @param transaction - The transaction to sign
-     * @returns The signed transaction
-     * @throws {TransactionSignerError} If wallet doesn't support signing or user rejects
-     */
     signTransaction(transaction: SolanaTransaction): Promise<SolanaTransaction>;
-    /**
-     * Sign multiple transactions at once
-     * More efficient than signing one-by-one for batch operations
-     * Falls back to sequential signing if batch not supported
-     *
-     * @param transactions - Array of transactions to sign
-     * @returns Array of signed transactions in the same order
-     * @throws {TransactionSignerError} If signing fails for any transaction
-     */
     signAllTransactions(transactions: SolanaTransaction[]): Promise<SolanaTransaction[]>;
-    /**
-     * Sign and send a transaction in one operation
-     * The wallet handles both signing and broadcasting to the network
-     *
-     * @param transaction - The transaction to sign and send
-     * @param options - Optional send options (e.g., skipPreflight)
-     * @returns The transaction signature/hash
-     * @throws {TransactionSignerError} If sending fails or user rejects
-     */
     signAndSendTransaction(transaction: SolanaTransaction, options?: {
         skipPreflight?: boolean;
         maxRetries?: number;
     }): Promise<string>;
-    /**
-     * Sign and send multiple transactions sequentially
-     * Waits for each transaction to be sent before sending the next
-     *
-     * @param transactions - Array of transactions to sign and send
-     * @param options - Optional send options
-     * @returns Array of transaction signatures in the same order
-     * @throws {TransactionSignerError} If any transaction fails
-     */
     signAndSendTransactions(transactions: SolanaTransaction[], options?: {
         skipPreflight?: boolean;
         maxRetries?: number;
     }): Promise<string[]>;
-    /**
-     * Sign an arbitrary message (for authentication, verification, etc.)
-     * Optional: not all wallets support message signing
-     *
-     * @param message - The message to sign (as Uint8Array)
-     * @returns The signature bytes
-     * @throws {TransactionSignerError} If wallet doesn't support message signing
-     */
     signMessage?(message: Uint8Array): Promise<Uint8Array>;
-    /**
-     * Get the signer's capabilities
-     * Use this to conditionally enable/disable features in your UI
-     *
-     * @returns Object describing what this signer can do
-     */
     getCapabilities(): TransactionSignerCapabilities;
 }
-/**
- * Create a transaction signer from a Wallet Standard wallet
- *
- * This factory function creates a TransactionSigner instance that bridges
- * Wallet Standard features to a clean, consistent API.
- *
- * @param config - Configuration including wallet, account, and optional cluster
- * @returns TransactionSigner instance, or null if wallet/account invalid
- *
- * @example
- * ```ts
- * // Basic usage
- * const signer = createTransactionSigner({
- *   wallet: connectedWallet,
- *   account: selectedAccount
- * })
- *
- * if (!signer) {
- *   console.error('Failed to create signer - wallet or account missing')
- *   return
- * }
- *
- * // Use the signer
- * try {
- *   const sig = await signer.signAndSendTransaction(tx)
- *   console.log('Success:', sig)
- * } catch (error) {
- *   if (error instanceof TransactionSignerError) {
- *     console.error('Signing error:', error.code, error.message)
- *   }
- * }
- * ```
- */
 declare function createTransactionSigner(config: TransactionSignerConfig): TransactionSigner | null;
 /**
  * @deprecated Use TransactionError from '../errors' instead
- * Kept for backward compatibility
- *
- * Custom error class for transaction signer operations
- * Provides structured error information for better error handling
  */
 declare class TransactionSignerError extends TransactionError {
     constructor(message: string, code: 'WALLET_NOT_CONNECTED' | 'FEATURE_NOT_SUPPORTED' | 'SIGNING_FAILED' | 'SEND_FAILED', originalError?: Error);
 }
 /**
  * @deprecated Use isTransactionError from '../errors' instead
- * Kept for backward compatibility
- *
- * Type guard to check if an error is a TransactionSignerError
  */
 declare function isTransactionSignerError(error: unknown): error is TransactionSignerError;