@solana/connector 0.1.3 → 0.1.5

package/dist/{wallet-standard-shim-C1tisl9S.d.ts → wallet-standard-shim-Dx7H8Ctf.d.mts}

@@ -1,9 +1,11 @@
-import { c as TransactionActivity, d as TransactionActivityStatus } from './transaction-signer-D3csM_Mf.js';
+import { c as TransactionActivity, d as TransactionActivityStatus } from './transaction-signer-D9d8nxwb.mjs';
 import { SolanaClusterId, SolanaCluster } from '@wallet-ui/core';
 import { Wallet, WalletAccount } from '@wallet-standard/base';
-import { Address, Signature } from 'gill';
+import { Address } from '@solana/addresses';
 import React, { ReactNode, Component, ErrorInfo } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Signature } from '@solana/keys';
+import { DevnetUrl, MainnetUrl, TestnetUrl, Rpc, SolanaRpcApi, RpcSubscriptions, SolanaRpcSubscriptionsApi } from '@solana/kit';
 
 /**
  * Wallet-related types
@@ -21,7 +23,7 @@ type WalletName = string & {
  * Account address as a branded string for type safety
  * Represents a Solana address (base58-encoded public key)
  *
- * @deprecated Use `Address` from 'gill' instead for consistent address typing
+ * @deprecated Use `Address` from '@solana/addresses' instead for consistent address typing
  */
 type AccountAddress = string & {
     readonly __brand: 'AccountAddress';
@@ -33,7 +35,7 @@ declare function isWalletName(value: string): value is WalletName;
 /**
  * Type guard to check if a string is a valid account address
  *
- * @deprecated Use `isAddress` from 'gill' instead for proper address validation
+ * @deprecated Use `isAddress` from '@solana/addresses' instead for proper address validation
  */
 declare function isAccountAddress(value: string): value is AccountAddress;
 /**
@@ -114,6 +116,48 @@ interface AccountInfo {
     raw: WalletAccount;
 }
 
+/**
+ * CoinGecko API configuration for price fetching.
+ *
+ * Rate Limits (as of 2024):
+ * - Free tier (no API key): 10-30 requests/minute (varies by endpoint)
+ * - Demo tier (free API key): 30 requests/minute
+ * - Paid tiers: Higher limits based on plan
+ *
+ * @see https://docs.coingecko.com/reference/introduction
+ */
+interface CoinGeckoConfig {
+    /**
+     * CoinGecko API key for higher rate limits.
+     * Get a free Demo API key at https://www.coingecko.com/en/api/pricing
+     * - Without key: ~10-30 requests/minute (public rate limit)
+     * - With Demo key: 30 requests/minute
+     */
+    apiKey?: string;
+    /**
+     * Whether the API key is for the Pro API (api.coingecko.com with x-cg-pro-api-key header)
+     * or the Demo API (api.coingecko.com with x-cg-demo-api-key header).
+     * @default false (uses Demo API header)
+     */
+    isPro?: boolean;
+    /**
+     * Maximum number of retry attempts when rate limited (429 response).
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Base delay in milliseconds for exponential backoff.
+     * Actual delay = baseDelay * 2^attempt + random jitter
+     * @default 1000 (1 second)
+     */
+    baseDelay?: number;
+    /**
+     * Maximum total timeout in milliseconds for all retry attempts combined.
+     * Prevents blocking the caller for too long.
+     * @default 30000 (30 seconds)
+     */
+    maxTimeout?: number;
+}
 /**
  * Core connector state
  */
@@ -149,6 +193,19 @@ interface ConnectorConfig {
         persistSelection?: boolean;
         initialCluster?: SolanaClusterId;
     };
+    /**
+     * Image proxy URL prefix for token images.
+     * When set, token image URLs will be transformed to: `${imageProxy}${encodeURIComponent(originalUrl)}`
+     * This prevents direct image fetching which can leak user IPs to untrusted hosts.
+     * @example '/_next/image?w=64&q=75&url=' // Next.js Image Optimization
+     * @example '/cdn-cgi/image/width=64,quality=75/' // Cloudflare Image Resizing
+     */
+    imageProxy?: string;
+    /**
+     * CoinGecko API configuration for token price fetching.
+     * Configure API key for higher rate limits and retry behavior for 429 responses.
+     */
+    coingecko?: CoinGeckoConfig;
 }
 /**
  * Health check information for connector diagnostics
@@ -322,6 +379,10 @@ declare class ConnectorClient {
     getHealth(): ConnectorHealth;
     getDebugMetrics(): ConnectorDebugMetrics;
     getDebugState(): ConnectorDebugState;
+    /**
+     * Get the current connector configuration
+     */
+    getConfig(): ConnectorConfig;
     resetDebugMetrics(): void;
     destroy(): void;
 }
@@ -355,6 +416,20 @@ interface DefaultConfigOptions {
     maxRetries?: number;
     /** Custom error handler */
     onError?: (error: Error, errorInfo: React.ErrorInfo) => void;
+    /**
+     * Image proxy URL prefix for token images.
+     * When set, token image URLs will be transformed to: `${imageProxy}${encodeURIComponent(originalUrl)}`
+     * This prevents direct image fetching which can leak user IPs to untrusted hosts.
+     * @example '/_next/image?w=64&q=75&url=' // Next.js Image Optimization
+     * @example '/cdn-cgi/image/width=64,quality=75/' // Cloudflare Image Resizing
+     */
+    imageProxy?: string;
+    /**
+     * CoinGecko API configuration for token price fetching.
+     * Configure API key for higher rate limits and retry behavior for 429 responses.
+     * @see https://docs.coingecko.com/reference/introduction for rate limit details
+     */
+    coingecko?: CoinGeckoConfig;
 }
 /** Extended ConnectorConfig with app metadata */
 interface ExtendedConnectorConfig extends ConnectorConfig {
@@ -377,6 +452,16 @@ interface ExtendedConnectorConfig extends ConnectorConfig {
         /** Custom fallback component */
         fallback?: (error: Error, retry: () => void) => React.ReactNode;
     };
+    /**
+     * Image proxy URL prefix for token images.
+     * When set, token image URLs will be transformed to: `${imageProxy}${encodeURIComponent(originalUrl)}`
+     * This prevents direct image fetching which can leak user IPs to untrusted hosts.
+     */
+    imageProxy?: string;
+    /**
+     * CoinGecko API configuration for token price fetching.
+     */
+    coingecko?: CoinGeckoConfig;
 }
 /**
  * Creates a default connector configuration with sensible defaults for Solana applications
@@ -395,7 +480,7 @@ declare function getDefaultMobileConfig(options: {
         uri: string;
         icon: string;
     };
-    cluster: "mainnet" | "devnet" | "testnet" | "mainnet-beta";
+    cluster: "devnet" | "mainnet" | "testnet" | "mainnet-beta";
 };
 
 declare global {
@@ -912,6 +997,131 @@ declare function copyAddressToClipboard(address: string, options?: Omit<CopyOpti
  */
 declare function copySignatureToClipboard(signature: string, options?: Omit<CopyOptions, 'validateType'>): Promise<ClipboardResult>;
 
+/**
+ * @solana/connector - Kit RPC Utilities
+ *
+ * RPC URL helpers for Solana clusters.
+ */
+
+/** Solana cluster moniker */
+type SolanaClusterMoniker = 'devnet' | 'localnet' | 'mainnet' | 'testnet';
+/** Localnet URL type */
+type LocalnetUrl = string & {
+    '~cluster': 'localnet';
+};
+/** Generic URL type */
+type GenericUrl = string & {};
+/** Union of all cluster URL types */
+type ModifiedClusterUrl = DevnetUrl | GenericUrl | LocalnetUrl | MainnetUrl | TestnetUrl;
+/** URL or moniker that can be used to create a Solana client */
+type SolanaClientUrlOrMoniker = ModifiedClusterUrl | SolanaClusterMoniker | URL;
+/**
+ * Get a public Solana RPC endpoint for a cluster based on its moniker
+ *
+ * Note: These RPC URLs are rate limited and not suitable for production applications.
+ * For production, use a dedicated RPC provider like Triton, Helius, QuickNode, or Alchemy.
+ *
+ * @param cluster - Cluster moniker
+ * @returns Public RPC URL for the cluster
+ */
+declare function getPublicSolanaRpcUrl(cluster: SolanaClusterMoniker | 'mainnet-beta' | 'localhost'): ModifiedClusterUrl;
+
+/**
+ * @solana/connector - Kit Client Factory
+ *
+ * Creates a Solana RPC and WebSocket subscriptions client.
+ * Replaces gill's createSolanaClient with a kit-based implementation.
+ */
+
+/**
+ * Configuration for creating a Solana RPC client
+ */
+interface CreateSolanaClientRpcConfig {
+    /** Custom port for the RPC endpoint */
+    port?: number;
+}
+/**
+ * Configuration for creating a Solana RPC subscriptions client
+ */
+interface CreateSolanaClientRpcSubscriptionsConfig {
+    /** Custom port for the WebSocket endpoint */
+    port?: number;
+}
+/**
+ * Arguments for creating a Solana client
+ */
+interface CreateSolanaClientArgs<TClusterUrl extends SolanaClientUrlOrMoniker = string> {
+    /** Full RPC URL (for a private RPC endpoint) or the Solana moniker (for a public RPC endpoint) */
+    urlOrMoniker: SolanaClientUrlOrMoniker | TClusterUrl;
+    /** Configuration used to create the `rpc` client */
+    rpcConfig?: CreateSolanaClientRpcConfig;
+    /** Configuration used to create the `rpcSubscriptions` client */
+    rpcSubscriptionsConfig?: CreateSolanaClientRpcSubscriptionsConfig;
+}
+/**
+ * A Solana client with RPC and WebSocket subscription capabilities
+ */
+interface SolanaClient<TClusterUrl extends ModifiedClusterUrl | string = string> {
+    /** Used to make RPC calls to your RPC provider */
+    rpc: Rpc<SolanaRpcApi>;
+    /** Used to make RPC websocket calls to your RPC provider */
+    rpcSubscriptions: RpcSubscriptions<SolanaRpcSubscriptionsApi>;
+    /** Full RPC URL that was used to create this client */
+    urlOrMoniker: SolanaClientUrlOrMoniker | TClusterUrl;
+}
+/**
+ * Create a Solana `rpc` and `rpcSubscriptions` client
+ *
+ * @param props - Configuration for the client
+ * @returns Solana client with RPC and WebSocket subscription capabilities
+ *
+ * @example
+ * ```ts
+ * // Using a cluster moniker
+ * const client = createSolanaClient({ urlOrMoniker: 'devnet' });
+ *
+ * // Using a custom RPC URL
+ * const client = createSolanaClient({ urlOrMoniker: 'https://my-rpc.example.com' });
+ *
+ * // Making RPC calls
+ * const balance = await client.rpc.getBalance(address).send();
+ * ```
+ */
+declare function createSolanaClient(props: Omit<CreateSolanaClientArgs<MainnetUrl | 'mainnet'>, 'urlOrMoniker'> & {
+    urlOrMoniker: 'mainnet';
+}): SolanaClient<MainnetUrl>;
+declare function createSolanaClient(props: Omit<CreateSolanaClientArgs<DevnetUrl | 'devnet'>, 'urlOrMoniker'> & {
+    urlOrMoniker: 'devnet';
+}): SolanaClient<DevnetUrl>;
+declare function createSolanaClient(props: Omit<CreateSolanaClientArgs<TestnetUrl | 'testnet'>, 'urlOrMoniker'> & {
+    urlOrMoniker: 'testnet';
+}): SolanaClient<TestnetUrl>;
+declare function createSolanaClient(props: Omit<CreateSolanaClientArgs<LocalnetUrl | 'localnet'>, 'urlOrMoniker'> & {
+    urlOrMoniker: 'localnet';
+}): SolanaClient<LocalnetUrl>;
+declare function createSolanaClient<TClusterUrl extends ModifiedClusterUrl>(props: CreateSolanaClientArgs<TClusterUrl>): SolanaClient<TClusterUrl>;
+
+/**
+ * @solana/connector - Kit Debug Utilities
+ *
+ * Simplified debug logging utilities for the connector.
+ * Replaces gill's debug system with a connector-specific implementation.
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+declare global {
+    /**
+     * Whether or not to enable debug mode. When enabled, default log level of `info`
+     */
+    var __CONNECTOR_DEBUG__: boolean | undefined;
+    /**
+     * Set the a desired level of logs to be output in the application
+     *
+     * - Default: `info`
+     * - Options: `debug` | `info` | `warn` | `error`
+     */
+    var __CONNECTOR_DEBUG_LEVEL__: LogLevel | undefined;
+}
+
 interface WalletsRegistry {
     get(): readonly Wallet[];
     on(event: 'register' | 'unregister', callback: (wallet: Wallet) => void): () => void;
@@ -923,4 +1133,4 @@ type WalletStandardAccount = WalletAccount;
  */
 declare function getWalletsRegistry(): WalletsRegistry;
 
-export { getBlockUrl as $, type AccountInfo as A, type StorageOptions as B, ConnectorProvider as C, type DefaultConfigOptions as D, type ExtendedConnectorConfig as E, type EnhancedStorageAccountOptions as F, type EnhancedStorageClusterOptions as G, type EnhancedStorageWalletOptions as H, WalletErrorType as I, type WalletError as J, ClipboardErrorType as K, type Listener as L, type MobileWalletAdapterConfig as M, type ClipboardResult as N, type CopyOptions as O, isClipboardAvailable as P, copyToClipboard as Q, copyAddressToClipboard as R, type StorageAdapter as S, copySignatureToClipboard as T, type UnifiedConfigOptions as U, getClusterRpcUrl as V, type WalletInfo as W, getClusterExplorerUrl as X, getTransactionUrl as Y, getAddressUrl as Z, getTokenUrl as _, useConnectorClient as a, isMainnetCluster as a0, isDevnetCluster as a1, isTestnetCluster as a2, isLocalCluster as a3, getClusterName as a4, getClusterType as a5, getClusterChainId as a6, getChainIdForWalletStandard as a7, type SolanaNetwork as a8, PUBLIC_RPC_ENDPOINTS as a9, normalizeNetwork as aa, toClusterId as ab, getDefaultRpcUrl as ac, isMainnet as ad, isDevnet as ae, isTestnet as af, isLocalnet as ag, getNetworkDisplayName as ah, ConnectorErrorBoundary as b, type ConnectorSnapshot as c, type ConnectorConfig as d, type ConnectorState as e, type WalletStandardWallet as f, type WalletStandardAccount as g, type UnifiedConfig as h, type ClusterType as i, ConnectorClient as j, getWalletsRegistry as k, getDefaultConfig as l, getDefaultMobileConfig as m, createConfig as n, isUnifiedConfig as o, type WalletName as p, type AccountAddress as q, isWalletName as r, isAccountAddress as s, type ConnectorHealth as t, useConnector as u, type ConnectorDebugMetrics as v, withErrorBoundary as w, type ConnectorDebugState as x, type ConnectorEvent as y, type ConnectorEventListener as z };
+export { copySignatureToClipboard as $, type AccountInfo as A, type StorageOptions as B, ConnectorProvider as C, type DefaultConfigOptions as D, type ExtendedConnectorConfig as E, type EnhancedStorageAccountOptions as F, type EnhancedStorageClusterOptions as G, type EnhancedStorageWalletOptions as H, WalletErrorType as I, type WalletError as J, getPublicSolanaRpcUrl as K, type Listener as L, type MobileWalletAdapterConfig as M, createSolanaClient as N, type SolanaClusterMoniker as O, type ModifiedClusterUrl as P, type SolanaClient as Q, type CreateSolanaClientArgs as R, type StorageAdapter as S, ClipboardErrorType as T, type UnifiedConfigOptions as U, type ClipboardResult as V, type WalletInfo as W, type CopyOptions as X, isClipboardAvailable as Y, copyToClipboard as Z, copyAddressToClipboard as _, useConnectorClient as a, getClusterRpcUrl as a0, getClusterExplorerUrl as a1, getTransactionUrl as a2, getAddressUrl as a3, getTokenUrl as a4, getBlockUrl as a5, isMainnetCluster as a6, isDevnetCluster as a7, isTestnetCluster as a8, isLocalCluster as a9, getClusterName as aa, getClusterType as ab, getClusterChainId as ac, getChainIdForWalletStandard as ad, type SolanaNetwork as ae, PUBLIC_RPC_ENDPOINTS as af, normalizeNetwork as ag, toClusterId as ah, getDefaultRpcUrl as ai, isMainnet as aj, isDevnet as ak, isTestnet as al, isLocalnet as am, getNetworkDisplayName as an, ConnectorErrorBoundary as b, type ConnectorSnapshot as c, type ConnectorConfig as d, type ConnectorState as e, type WalletStandardWallet as f, type WalletStandardAccount as g, type UnifiedConfig as h, type ClusterType as i, ConnectorClient as j, getWalletsRegistry as k, getDefaultConfig as l, getDefaultMobileConfig as m, createConfig as n, isUnifiedConfig as o, type WalletName as p, type AccountAddress as q, isWalletName as r, isAccountAddress as s, type ConnectorHealth as t, useConnector as u, type ConnectorDebugMetrics as v, withErrorBoundary as w, type ConnectorDebugState as x, type ConnectorEvent as y, type ConnectorEventListener as z };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@solana/connector",
-    "version": "0.1.3",
+    "version": "0.1.5",
     "description": "Headless wallet connector client and React provider built on Wallet Standard",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",
@@ -65,17 +65,17 @@
         "@nanostores/persistent": "^1.1.0",
         "@solana-mobile/wallet-standard-mobile": "^0.4.3",
         "@solana/webcrypto-ed25519-polyfill": "^4.0.0",
-        "@solana/addresses": "^3.0.0",
-        "@solana/keys": "^3.0.0",
-        "@solana/kit": "^3.0.0",
-        "@solana/signers": "^3.0.0",
-        "@solana/transactions": "^3.0.0",
+        "@solana/addresses": "^5.0.0",
+        "@solana/codecs": "^5.0.0",
+        "@solana/keys": "^5.0.0",
+        "@solana/kit": "^5.0.0",
+        "@solana/signers": "^5.0.0",
+        "@solana/transaction-messages": "^5.0.0",
+        "@solana/transactions": "^5.0.0",
         "@wallet-standard/app": "^1.1.0",
         "@wallet-standard/base": "^1.1.0",
         "@wallet-standard/features": "^1.1.0",
-        "@wallet-ui/core": "^2.0.0",
-        "bs58": "^6.0.0",
-        "gill": "^0.12.0"
+        "@wallet-ui/core": "^2.1.0"
     },
     "devDependencies": {
         "@testing-library/jest-dom": "^6.9.1",
@@ -85,11 +85,15 @@
         "@vitest/coverage-v8": "^3.2.4",
         "@vitest/ui": "^3.2.4",
         "happy-dom": "^20.0.7",
-        "react": "19.2.0",
-        "react-dom": "19.2.0",
+        "react": "^19.2.1",
+        "react-dom": "^19.2.1",
         "tsup": "^8.5.0",
         "typescript": "^5.9.3",
         "vitest": "^3.2.4"
     },
-    "license": "MIT"
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/solana-foundation/connectorkit"
+    }
 }

package/dist/chunk-5ZUVZZWU.mjs

@@ -1,180 +0,0 @@
-import { isDebugEnabled, debug } from 'gill';
-
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key != "symbol" ? key + "" : key, value);
-var SENSITIVE_KEYS = [
-  "address",
-  "publickey",
-  "signature",
-  "account",
-  "rpcurl",
-  "url",
-  "apikey",
-  "api_key",
-  "token",
-  "secret",
-  "password",
-  "private",
-  "seed",
-  "mnemonic"
-], LOG_LEVELS = {
-  debug: 0,
-  info: 1,
-  warn: 2,
-  error: 3
-}, SecureLogger = class {
-  constructor(config = {}) {
-    __publicField(this, "config");
-    let isDevelopment = typeof process < "u" && process.env?.NODE_ENV === "development";
-    this.config = {
-      enabled: config.enabled ?? isDevelopment,
-      level: config.level ?? "debug",
-      redactSensitive: config.redactSensitive ?? !isDevelopment,
-      prefix: config.prefix ?? "Connector",
-      useGillDebug: config.useGillDebug ?? true
-      // Default to using gill's debug system
-    };
-  }
-  /**
-   * Log debug information (lowest priority)
-   */
-  debug(message, data) {
-    this.log("debug", message, data);
-  }
-  /**
-   * Log general information
-   */
-  info(message, data) {
-    this.log("info", message, data);
-  }
-  /**
-   * Log warnings
-   */
-  warn(message, data) {
-    this.log("warn", message, data);
-  }
-  /**
-   * Log errors (highest priority)
-   */
-  error(message, data) {
-    this.log("error", message, data);
-  }
-  /**
-   * Internal log method that handles level filtering and redaction
-   * Integrates with gill's debug system when enabled
-   */
-  log(level, message, data) {
-    let gillDebugEnabled = this.config.useGillDebug ? isDebugEnabled() : false;
-    if (!this.config.enabled && !gillDebugEnabled) return;
-    let effectiveLevel = this.config.level;
-    if (this.config.useGillDebug && typeof globalThis < "u") {
-      let gillLevel = globalThis.__GILL_DEBUG_LEVEL__;
-      gillLevel && ["debug", "info", "warn", "error"].includes(gillLevel) && (effectiveLevel = gillLevel);
-    }
-    if (LOG_LEVELS[level] < LOG_LEVELS[effectiveLevel])
-      return;
-    let processedData = this.config.redactSensitive ? this.redact(data) : data, fullMessage = processedData !== void 0 ? `${message} ${typeof processedData == "object" ? JSON.stringify(processedData, null, 2) : processedData}` : message;
-    if (this.config.useGillDebug && gillDebugEnabled)
-      debug(fullMessage, level, this.config.prefix);
-    else {
-      let prefix = `[${this.config.prefix}]`;
-      switch (level) {
-        case "debug":
-          console.debug(prefix, message, processedData !== void 0 ? processedData : "");
-          break;
-        case "info":
-          console.info(prefix, message, processedData !== void 0 ? processedData : "");
-          break;
-        case "warn":
-          console.warn(prefix, message, processedData !== void 0 ? processedData : "");
-          break;
-        case "error":
-          console.error(prefix, message, processedData !== void 0 ? processedData : "");
-          break;
-      }
-    }
-  }
-  /**
-   * Recursively redact sensitive information from data
-   */
-  redact(data) {
-    if (data == null || typeof data != "object")
-      return data;
-    if (Array.isArray(data))
-      return data.map((item) => this.redact(item));
-    let redacted = {};
-    for (let [key, value] of Object.entries(data)) {
-      let keyLower = key.toLowerCase();
-      SENSITIVE_KEYS.some((sensitiveKey) => keyLower.includes(sensitiveKey)) ? redacted[key] = this.maskValue(value) : typeof value == "object" && value !== null ? redacted[key] = this.redact(value) : redacted[key] = value;
-    }
-    return redacted;
-  }
-  /**
-   * Mask a sensitive value for logging
-   * Shows first 4 and last 4 characters for strings longer than 8 chars
-   */
-  maskValue(value) {
-    if (value == null)
-      return "***";
-    let str = String(value);
-    return str.length <= 8 ? "***" : `${str.slice(0, 4)}...${str.slice(-4)}`;
-  }
-  /**
-   * Update logger configuration at runtime
-   */
-  updateConfig(config) {
-    this.config = { ...this.config, ...config };
-  }
-  /**
-   * Get current configuration
-   */
-  getConfig() {
-    return { ...this.config };
-  }
-}; new SecureLogger({
-  prefix: "Connector"
-});
-function createLogger(prefix, config) {
-  return new SecureLogger({ ...config, prefix });
-}
-
-// src/utils/transaction-format.ts
-function isWeb3jsTransaction(tx) {
-  return tx !== null && typeof tx == "object" && "serialize" in tx && typeof tx.serialize == "function";
-}
-function serializeTransaction(tx) {
-  if (isWeb3jsTransaction(tx))
-    return tx.serialize({
-      requireAllSignatures: false,
-      verifySignatures: false
-    });
-  if (tx instanceof Uint8Array)
-    return tx;
-  if (ArrayBuffer.isView(tx))
-    return new Uint8Array(tx.buffer, tx.byteOffset, tx.byteLength);
-  throw new Error("Unsupported transaction format - must be Transaction, VersionedTransaction, or Uint8Array");
-}
-function isLegacyTransaction(bytes) {
-  return bytes.length === 0 ? false : (bytes[0] & 128) === 0;
-}
-async function deserializeToWeb3jsTransaction(bytes) {
-  if (isLegacyTransaction(bytes)) {
-    let { Transaction } = await import('@solana/web3.js');
-    return Transaction.from(bytes);
-  } else {
-    let { VersionedTransaction } = await import('@solana/web3.js');
-    return VersionedTransaction.deserialize(bytes);
-  }
-}
-function prepareTransactionForWallet(tx) {
-  let wasWeb3js = isWeb3jsTransaction(tx);
-  return { serialized: serializeTransaction(tx), wasWeb3js };
-}
-async function convertSignedTransaction(signedBytes, wasWeb3js) {
-  return wasWeb3js ? await deserializeToWeb3jsTransaction(signedBytes) : signedBytes;
-}
-
-export { __publicField, convertSignedTransaction, createLogger, isWeb3jsTransaction, prepareTransactionForWallet };
-//# sourceMappingURL=chunk-5ZUVZZWU.mjs.map
-//# sourceMappingURL=chunk-5ZUVZZWU.mjs.map

package/dist/chunk-5ZUVZZWU.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/lib/utils/secure-logger.ts","../src/utils/transaction-format.ts"],"names":["gillDebug"],"mappings":"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","file":"chunk-5ZUVZZWU.mjs","sourcesContent":["/**\n * @solana/connector - Secure Logger\n *\n * Production-safe logger that redacts sensitive information\n * Prevents accidental exposure of addresses, keys, and other PII in logs\n *\n * Integrates with gill's debug system:\n * - Respects `__GILL_DEBUG__` flag (enable/disable logging globally)\n * - Respects `__GILL_DEBUG_LEVEL__` (set minimum log level)\n * - Extends gill's debug with sensitive data redaction\n * - Provides unified logging API across connector and gill\n *\n * Enable gill debug:\n * ```ts\n * window.__GILL_DEBUG__ = true\n * window.__GILL_DEBUG_LEVEL__ = 'debug' // or 'info', 'warn', 'error'\n * ```\n */\n\nimport { isDebugEnabled, debug as gillDebug } from 'gill';\n\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nexport interface SecureLoggerConfig {\n    /** Enable logging (defaults to true in development, false in production) */\n    enabled?: boolean;\n    /** Minimum log level to output */\n    level?: LogLevel;\n    /** Redact sensitive information in logs (defaults to true in production) */\n    redactSensitive?: boolean;\n    /** Custom prefix for all log messages */\n    prefix?: string;\n    /** Use gill's debug system for logging (respects __GILL_DEBUG__ flags) */\n    useGillDebug?: boolean;\n}\n\n/**\n * Keys that contain sensitive information that should be redacted\n */\nconst SENSITIVE_KEYS = [\n    'address',\n    'publickey',\n    'signature',\n    'account',\n    'rpcurl',\n    'url',\n    'apikey',\n    'api_key',\n    'token',\n    'secret',\n    'password',\n    'private',\n    'seed',\n    'mnemonic',\n];\n\n/**\n * Log levels in order of severity\n */\nconst LOG_LEVELS: Record<LogLevel, number> = {\n    debug: 0,\n    info: 1,\n    warn: 2,\n    error: 3,\n};\n\n/**\n * SecureLogger - Production-safe logging with automatic redaction\n *\n * Features:\n * - Integrates with gill's debug system (respects __GILL_DEBUG__ flags)\n * - Automatic redaction of sensitive data (addresses, keys, URLs)\n * - Configurable log levels (respects __GILL_DEBUG_LEVEL__)\n * - Environment-aware defaults\n * - Deep object traversal for nested sensitive data\n *\n * @example\n * ```ts\n * // Enable gill debug (affects all logging across connector + gill)\n * window.__GILL_DEBUG__ = true\n * window.__GILL_DEBUG_LEVEL__ = 'info' // Optional: filter by level\n *\n * const logger = new SecureLogger({ prefix: 'Connector' });\n *\n * logger.debug('User connected', {\n *   address: '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU', // Auto-redacted in prod\n *   wallet: 'Phantom'\n * });\n * // Development: \"User connected { address: '7xKX...gAsU', wallet: 'Phantom' }\"\n * // Production:   \"User connected { address: '***', wallet: 'Phantom' }\"\n * ```\n */\nexport class SecureLogger {\n    private config: Required<SecureLoggerConfig>;\n\n    constructor(config: SecureLoggerConfig = {}) {\n        const isDevelopment = typeof process !== 'undefined' && process.env?.NODE_ENV === 'development';\n\n        this.config = {\n            enabled: config.enabled ?? isDevelopment,\n            level: config.level ?? 'debug',\n            redactSensitive: config.redactSensitive ?? !isDevelopment,\n            prefix: config.prefix ?? 'Connector',\n            useGillDebug: config.useGillDebug ?? true, // Default to using gill's debug system\n        };\n    }\n\n    /**\n     * Log debug information (lowest priority)\n     */\n    debug(message: string, data?: unknown): void {\n        this.log('debug', message, data);\n    }\n\n    /**\n     * Log general information\n     */\n    info(message: string, data?: unknown): void {\n        this.log('info', message, data);\n    }\n\n    /**\n     * Log warnings\n     */\n    warn(message: string, data?: unknown): void {\n        this.log('warn', message, data);\n    }\n\n    /**\n     * Log errors (highest priority)\n     */\n    error(message: string, data?: unknown): void {\n        this.log('error', message, data);\n    }\n\n    /**\n     * Internal log method that handles level filtering and redaction\n     * Integrates with gill's debug system when enabled\n     */\n    private log(level: LogLevel, message: string, data?: unknown): void {\n        // Check if logging is enabled (either via config or gill's debug system)\n        const gillDebugEnabled = this.config.useGillDebug ? isDebugEnabled() : false;\n        if (!this.config.enabled && !gillDebugEnabled) return;\n\n        // Get effective log level (prefer gill's debug level if set)\n        let effectiveLevel = this.config.level;\n        if (this.config.useGillDebug && typeof globalThis !== 'undefined') {\n            const gillLevel = (globalThis as { __GILL_DEBUG_LEVEL__?: string }).__GILL_DEBUG_LEVEL__;\n            if (gillLevel && ['debug', 'info', 'warn', 'error'].includes(gillLevel)) {\n                effectiveLevel = gillLevel as LogLevel;\n            }\n        }\n\n        // Check if this log level should be output\n        if (LOG_LEVELS[level] < LOG_LEVELS[effectiveLevel]) {\n            return;\n        }\n\n        // Process data (redact if enabled)\n        const processedData = this.config.redactSensitive ? this.redact(data) : data;\n\n        // Format message with data\n        const fullMessage =\n            processedData !== undefined\n                ? `${message} ${typeof processedData === 'object' ? JSON.stringify(processedData, null, 2) : processedData}`\n                : message;\n\n        // Use gill's debug system if enabled, otherwise fall back to console.*\n        if (this.config.useGillDebug && gillDebugEnabled) {\n            gillDebug(fullMessage, level as any, this.config.prefix);\n        } else {\n            const prefix = `[${this.config.prefix}]`;\n            switch (level) {\n                case 'debug':\n                    console.debug(prefix, message, processedData !== undefined ? processedData : '');\n                    break;\n                case 'info':\n                    console.info(prefix, message, processedData !== undefined ? processedData : '');\n                    break;\n                case 'warn':\n                    console.warn(prefix, message, processedData !== undefined ? processedData : '');\n                    break;\n                case 'error':\n                    console.error(prefix, message, processedData !== undefined ? processedData : '');\n                    break;\n            }\n        }\n    }\n\n    /**\n     * Recursively redact sensitive information from data\n     */\n    private redact(data: unknown): unknown {\n        if (data === null || data === undefined) {\n            return data;\n        }\n\n        // Handle primitives\n        if (typeof data !== 'object') {\n            return data;\n        }\n\n        // Handle arrays\n        if (Array.isArray(data)) {\n            return data.map(item => this.redact(item));\n        }\n\n        // Handle objects\n        const redacted: Record<string, unknown> = {};\n        for (const [key, value] of Object.entries(data)) {\n            const keyLower = key.toLowerCase();\n\n            // Check if this key contains sensitive information\n            const isSensitive = SENSITIVE_KEYS.some(sensitiveKey => keyLower.includes(sensitiveKey));\n\n            if (isSensitive) {\n                redacted[key] = this.maskValue(value);\n            } else if (typeof value === 'object' && value !== null) {\n                redacted[key] = this.redact(value);\n            } else {\n                redacted[key] = value;\n            }\n        }\n\n        return redacted;\n    }\n\n    /**\n     * Mask a sensitive value for logging\n     * Shows first 4 and last 4 characters for strings longer than 8 chars\n     */\n    private maskValue(value: unknown): string {\n        if (value === null || value === undefined) {\n            return '***';\n        }\n\n        const str = String(value);\n\n        // For very short strings, just mask completely\n        if (str.length <= 8) {\n            return '***';\n        }\n\n        // For longer strings, show first and last 4 characters\n        return `${str.slice(0, 4)}...${str.slice(-4)}`;\n    }\n\n    /**\n     * Update logger configuration at runtime\n     */\n    updateConfig(config: Partial<SecureLoggerConfig>): void {\n        this.config = { ...this.config, ...config };\n    }\n\n    /**\n     * Get current configuration\n     */\n    getConfig(): Required<SecureLoggerConfig> {\n        return { ...this.config };\n    }\n}\n\n/**\n * Default logger instance for the connector\n * Automatically configured based on NODE_ENV\n */\nexport const logger = new SecureLogger({\n    prefix: 'Connector',\n});\n\n/**\n * Create a logger with a custom prefix\n *\n * @example\n * ```ts\n * const walletLogger = createLogger('WalletDetector');\n * walletLogger.debug('Scanning for wallets...');\n * // Output: [WalletDetector] Scanning for wallets...\n * ```\n */\nexport function createLogger(prefix: string, config?: Omit<SecureLoggerConfig, 'prefix'>): SecureLogger {\n    return new SecureLogger({ ...config, prefix });\n}\n","/**\n * Transaction Format Utilities\n *\n * Utilities for detecting and converting between different transaction formats:\n * - web3.js Transaction/VersionedTransaction objects\n * - Serialized Uint8Array (Wallet Standard format)\n * - Other TypedArray formats\n *\n * Note: Uses dynamic imports for @solana/web3.js to avoid bundling it\n * since it's only needed for the compat layer.\n */\n\nimport type { Transaction, VersionedTransaction } from '@solana/web3.js';\nimport type { SolanaTransaction } from '../types/transactions';\n\n/**\n * Check if a value is a web3.js Transaction or VersionedTransaction object\n *\n * @param tx - Value to check\n * @returns True if it's a web3.js transaction object\n */\nexport function isWeb3jsTransaction(tx: unknown): tx is Transaction | VersionedTransaction {\n    // Duck-typing: if it has a serialize method, it's likely a web3.js transaction\n    return tx !== null && typeof tx === 'object' && 'serialize' in tx && typeof tx.serialize === 'function';\n}\n\n/**\n * Serialize a transaction to Uint8Array format (required for Wallet Standard)\n *\n * @param tx - Transaction to serialize (web3.js object, Uint8Array, or TypedArray)\n * @returns Serialized transaction bytes\n * @throws Error if transaction format is unsupported\n */\nexport function serializeTransaction(tx: SolanaTransaction): Uint8Array {\n    // web3.js Transaction/VersionedTransaction object\n    if (isWeb3jsTransaction(tx)) {\n        return tx.serialize({\n            requireAllSignatures: false,\n            verifySignatures: false,\n        });\n    }\n\n    // Already serialized as Uint8Array\n    if (tx instanceof Uint8Array) {\n        return tx;\n    }\n\n    // Other TypedArray format\n    if (ArrayBuffer.isView(tx)) {\n        return new Uint8Array(tx.buffer, tx.byteOffset, tx.byteLength);\n    }\n\n    throw new Error('Unsupported transaction format - must be Transaction, VersionedTransaction, or Uint8Array');\n}\n\n/**\n * Check if transaction bytes represent a legacy transaction\n * Legacy transactions have high bit = 0, versioned have high bit = 1\n *\n * @param bytes - Serialized transaction bytes\n * @returns True if legacy transaction\n */\nfunction isLegacyTransaction(bytes: Uint8Array): boolean {\n    if (bytes.length === 0) return false;\n    // High bit of first byte: 0 = legacy, 1 = versioned\n    return (bytes[0] & 0x80) === 0;\n}\n\n/**\n * Deserialize bytes to a web3.js Transaction or VersionedTransaction object\n * Uses dynamic import to avoid bundling @solana/web3.js\n * Automatically detects legacy vs versioned format\n *\n * @param bytes - Serialized transaction bytes\n * @returns Transaction or VersionedTransaction object\n */\nexport async function deserializeToWeb3jsTransaction(bytes: Uint8Array): Promise<Transaction | VersionedTransaction> {\n    if (isLegacyTransaction(bytes)) {\n        // Legacy transaction - use Transaction.deserialize to preserve legacy-only fields\n        const { Transaction } = await import('@solana/web3.js');\n        return Transaction.from(bytes);\n    } else {\n        // Versioned transaction\n        const { VersionedTransaction } = await import('@solana/web3.js');\n        return VersionedTransaction.deserialize(bytes);\n    }\n}\n\n/**\n * Smart converter that preserves the original format\n * Converts to Wallet Standard format (Uint8Array) and tracks original type\n *\n * @param tx - Transaction in any supported format\n * @returns Object with serialized bytes and format flag\n */\nexport function prepareTransactionForWallet(tx: SolanaTransaction): { serialized: Uint8Array; wasWeb3js: boolean } {\n    const wasWeb3js = isWeb3jsTransaction(tx);\n    const serialized = serializeTransaction(tx);\n    return { serialized, wasWeb3js };\n}\n\n/**\n * Convert signed transaction bytes back to original format if needed\n *\n * @param signedBytes - Signed transaction as Uint8Array\n * @param wasWeb3js - Whether the original was a web3.js object\n * @returns Transaction in appropriate format (async if conversion needed)\n *          Returns Transaction for legacy, VersionedTransaction for versioned, or Uint8Array if not web3js\n */\nexport async function convertSignedTransaction(\n    signedBytes: Uint8Array,\n    wasWeb3js: boolean,\n): Promise<Transaction | VersionedTransaction | Uint8Array> {\n    if (wasWeb3js) {\n        return await deserializeToWeb3jsTransaction(signedBytes);\n    }\n    return signedBytes;\n}\n"]}