@solana/connector 0.1.4 → 0.1.5

package/dist/index.mjs

@@ -1,6 +1,6 @@
-export { EnhancedStorage, EnhancedStorageAdapter, SOLANA_CHAIN_IDS, address, base58ToSignatureBytes, chainIdToClusterId, chainIdToClusterType, clusterToChainId, copySignature, createConfig, createEnhancedStorageAccount, createEnhancedStorageCluster, createEnhancedStorageWallet, createKitSignersFromWallet, createMessageSignerFromWallet, createSignableMessage, createSolanaDevnet, createSolanaLocalnet, createSolanaMainnet, createSolanaTestnet, createTransactionSendingSignerFromWallet, detectMessageModification, formatSignature, freezeSigner, getAllExplorerUrls, getChainIdFromCluster, getChainIdFromClusterId, getChainIdFromClusterType, getChainIdFromConnection, getClusterIdFromChainId, getClusterTypeFromChainId, getClusterTypeFromConnection, getDefaultConfig, getDefaultMobileConfig, getLatestBlockhash, getSolanaExplorerUrl, getSolanaFmUrl, getSolscanUrl, getXrayUrl, isAccountAddress, isKitConnection, isKnownSolanaChain, isLegacyConnection, isSolanaChain, isUnifiedConfig, isWalletName, sendRawTransaction, signatureBytesToBase58, updateSignatureDictionary, validateKnownSolanaChain } from './chunk-N3Q2J2FG.mjs';
-export { AccountElement, UnifiedProvider as AppProvider, BalanceElement, ClusterElement, ConnectorProvider, DisconnectElement, TokenListElement, TransactionHistoryElement, UnifiedProvider, WalletListElement, useAccount, useBalance, useCluster, useConnector, useConnectorClient, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo } from './chunk-U64YZRJL.mjs';
-export { ClipboardErrorType, ConfigurationError, ConnectionError, ConnectorClient, ConnectorError, ConnectorErrorBoundary, Errors, NetworkError, PUBLIC_RPC_ENDPOINTS, TransactionError, TransactionSignerError, ValidationError, WalletErrorType, copyAddressToClipboard, copySignatureToClipboard, copyToClipboard, createGillTransactionSigner, createKitTransactionSigner, createTransactionSigner, formatAddress, formatNumber, formatSOL, formatTokenAmount, getAddressUrl, getBlockUrl, getChainIdForWalletStandard, getClusterChainId, getClusterExplorerUrl, getClusterName, getClusterRpcUrl, getClusterType, getDefaultRpcUrl, getNetworkDisplayName, getPolyfillStatus, getTokenUrl, getTransactionUrl, getUserFriendlyMessage, getWalletsRegistry, installPolyfills, isClipboardAvailable, isConfigurationError, isConnectionError, isConnectorError, isCryptoAvailable, isDevnet, isDevnetCluster, isLocalCluster, isLocalnet, isMainnet, isMainnetCluster, isNetworkError, isPolyfillInstalled, isTestnet, isTestnetCluster, isTransactionError, isTransactionSignerError, isValidationError, normalizeNetwork, toClusterId, toConnectorError, truncate, withErrorBoundary } from './chunk-YTCSTE3Q.mjs';
-export { LAMPORTS_PER_SOL, createSolanaClient, getExplorerLink, getPublicSolanaRpcUrl, lamportsToSol, prepareTransaction, solToLamports } from './chunk-P5MWBDFG.mjs';
+export { EnhancedStorage, EnhancedStorageAdapter, SOLANA_CHAIN_IDS, address, base58ToSignatureBytes, chainIdToClusterId, chainIdToClusterType, clusterToChainId, copySignature, createConfig, createEnhancedStorageAccount, createEnhancedStorageCluster, createEnhancedStorageWallet, createKitSignersFromWallet, createMessageSignerFromWallet, createSignableMessage, createSolanaDevnet, createSolanaLocalnet, createSolanaMainnet, createSolanaTestnet, createTransactionSendingSignerFromWallet, detectMessageModification, formatSignature, freezeSigner, getAllExplorerUrls, getChainIdFromCluster, getChainIdFromClusterId, getChainIdFromClusterType, getChainIdFromConnection, getClusterIdFromChainId, getClusterTypeFromChainId, getClusterTypeFromConnection, getDefaultConfig, getDefaultMobileConfig, getLatestBlockhash, getSolanaExplorerUrl, getSolanaFmUrl, getSolscanUrl, getXrayUrl, isAccountAddress, isKitConnection, isKnownSolanaChain, isLegacyConnection, isSolanaChain, isUnifiedConfig, isWalletName, sendRawTransaction, signatureBytesToBase58, updateSignatureDictionary, validateKnownSolanaChain } from './chunk-QKVL45F6.mjs';
+export { AccountElement, UnifiedProvider as AppProvider, BalanceElement, ClusterElement, ConnectorProvider, DisconnectElement, TokenListElement, TransactionHistoryElement, UnifiedProvider, WalletListElement, useAccount, useBalance, useCluster, useConnector, useConnectorClient, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo } from './chunk-3STZXVXD.mjs';
+export { ClipboardErrorType, ConfigurationError, ConnectionError, ConnectorClient, ConnectorError, ConnectorErrorBoundary, Errors, NetworkError, PUBLIC_RPC_ENDPOINTS, TransactionError, TransactionSignerError, ValidationError, WalletErrorType, copyAddressToClipboard, copySignatureToClipboard, copyToClipboard, createGillTransactionSigner, createKitTransactionSigner, createTransactionSigner, formatAddress, formatNumber, formatSOL, formatTokenAmount, getAddressUrl, getBlockUrl, getChainIdForWalletStandard, getClusterChainId, getClusterExplorerUrl, getClusterName, getClusterRpcUrl, getClusterType, getDefaultRpcUrl, getNetworkDisplayName, getPolyfillStatus, getTokenUrl, getTransactionUrl, getUserFriendlyMessage, getWalletsRegistry, installPolyfills, isClipboardAvailable, isConfigurationError, isConnectionError, isConnectorError, isCryptoAvailable, isDevnet, isDevnetCluster, isLocalCluster, isLocalnet, isMainnet, isMainnetCluster, isNetworkError, isPolyfillInstalled, isTestnet, isTestnetCluster, isTransactionError, isTransactionSignerError, isValidationError, normalizeNetwork, toClusterId, toConnectorError, truncate, withErrorBoundary } from './chunk-VMSZJPR5.mjs';
+export { LAMPORTS_PER_SOL, createSolanaClient, getExplorerLink, getPublicSolanaRpcUrl, lamportsToSol, prepareTransaction, solToLamports } from './chunk-QL3IT3TS.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/react.d.mts

@@ -1,5 +1,5 @@
-import { h as UnifiedConfig, d as ConnectorConfig, M as MobileWalletAdapterConfig, i as ClusterType, A as AccountInfo, V as ClipboardResult, Q as SolanaClient } from './wallet-standard-shim-Cp4vF4oo.mjs';
-export { b as ConnectorErrorBoundary, C as ConnectorProvider, c as ConnectorSnapshot, e as ConnectorState, D as DefaultConfigOptions, E as ExtendedConnectorConfig, U as UnifiedConfigOptions, W as WalletInfo, g as WalletStandardAccount, f as WalletStandardWallet, u as useConnector, a as useConnectorClient, w as withErrorBoundary } from './wallet-standard-shim-Cp4vF4oo.mjs';
+import { h as UnifiedConfig, d as ConnectorConfig, M as MobileWalletAdapterConfig, i as ClusterType, A as AccountInfo, V as ClipboardResult, Q as SolanaClient } from './wallet-standard-shim-Dx7H8Ctf.mjs';
+export { b as ConnectorErrorBoundary, C as ConnectorProvider, c as ConnectorSnapshot, e as ConnectorState, D as DefaultConfigOptions, E as ExtendedConnectorConfig, U as UnifiedConfigOptions, W as WalletInfo, g as WalletStandardAccount, f as WalletStandardWallet, u as useConnector, a as useConnectorClient, w as withErrorBoundary } from './wallet-standard-shim-Dx7H8Ctf.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, PropsWithChildren } from 'react';
 import { SolanaCluster, SolanaClusterId } from '@wallet-ui/core';
@@ -679,7 +679,7 @@ interface UseTokensOptions {
     autoRefresh?: boolean;
     /** Refresh interval in milliseconds */
     refreshInterval?: number;
-    /** Fetch metadata (name, symbol, logo) from Jupiter */
+    /** Fetch metadata (name, symbol, logo) and USD prices */
     fetchMetadata?: boolean;
     /** Include native SOL balance */
     includeNativeSol?: boolean;
@@ -700,7 +700,7 @@ interface UseTokensReturn {
 }
 /**
  * Hook for fetching wallet token holdings.
- * Fetches metadata (name, symbol, icon, USD price) from Jupiter's API.
+ * Fetches metadata (name, symbol, icon) from Solana Token List API and USD prices from CoinGecko.
  *
  * @example Basic usage
  * ```tsx

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { h as UnifiedConfig, d as ConnectorConfig, M as MobileWalletAdapterConfig, i as ClusterType, A as AccountInfo, V as ClipboardResult, Q as SolanaClient } from './wallet-standard-shim-DC_Z7DS-.js';
-export { b as ConnectorErrorBoundary, C as ConnectorProvider, c as ConnectorSnapshot, e as ConnectorState, D as DefaultConfigOptions, E as ExtendedConnectorConfig, U as UnifiedConfigOptions, W as WalletInfo, g as WalletStandardAccount, f as WalletStandardWallet, u as useConnector, a as useConnectorClient, w as withErrorBoundary } from './wallet-standard-shim-DC_Z7DS-.js';
+import { h as UnifiedConfig, d as ConnectorConfig, M as MobileWalletAdapterConfig, i as ClusterType, A as AccountInfo, V as ClipboardResult, Q as SolanaClient } from './wallet-standard-shim--YcrQNRt.js';
+export { b as ConnectorErrorBoundary, C as ConnectorProvider, c as ConnectorSnapshot, e as ConnectorState, D as DefaultConfigOptions, E as ExtendedConnectorConfig, U as UnifiedConfigOptions, W as WalletInfo, g as WalletStandardAccount, f as WalletStandardWallet, u as useConnector, a as useConnectorClient, w as withErrorBoundary } from './wallet-standard-shim--YcrQNRt.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, PropsWithChildren } from 'react';
 import { SolanaCluster, SolanaClusterId } from '@wallet-ui/core';
@@ -679,7 +679,7 @@ interface UseTokensOptions {
     autoRefresh?: boolean;
     /** Refresh interval in milliseconds */
     refreshInterval?: number;
-    /** Fetch metadata (name, symbol, logo) from Jupiter */
+    /** Fetch metadata (name, symbol, logo) and USD prices */
     fetchMetadata?: boolean;
     /** Include native SOL balance */
     includeNativeSol?: boolean;
@@ -700,7 +700,7 @@ interface UseTokensReturn {
 }
 /**
  * Hook for fetching wallet token holdings.
- * Fetches metadata (name, symbol, icon, USD price) from Jupiter's API.
+ * Fetches metadata (name, symbol, icon) from Solana Token List API and USD prices from CoinGecko.
  *
  * @example Basic usage
  * ```tsx

package/dist/react.js

@@ -1,113 +1,113 @@
 'use strict';
 
-var chunkLUZWUZ5N_js = require('./chunk-LUZWUZ5N.js');
-var chunkCLXM6UEE_js = require('./chunk-CLXM6UEE.js');
+var chunkULUYX23Q_js = require('./chunk-ULUYX23Q.js');
+var chunkJUZVCBAI_js = require('./chunk-JUZVCBAI.js');
 
 
 
 Object.defineProperty(exports, "AccountElement", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.AccountElement; }
+  get: function () { return chunkULUYX23Q_js.AccountElement; }
 });
 Object.defineProperty(exports, "AppProvider", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.UnifiedProvider; }
+  get: function () { return chunkULUYX23Q_js.UnifiedProvider; }
 });
 Object.defineProperty(exports, "BalanceElement", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.BalanceElement; }
+  get: function () { return chunkULUYX23Q_js.BalanceElement; }
 });
 Object.defineProperty(exports, "ClusterElement", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.ClusterElement; }
+  get: function () { return chunkULUYX23Q_js.ClusterElement; }
 });
 Object.defineProperty(exports, "ConnectorProvider", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.ConnectorProvider; }
+  get: function () { return chunkULUYX23Q_js.ConnectorProvider; }
 });
 Object.defineProperty(exports, "DisconnectElement", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.DisconnectElement; }
+  get: function () { return chunkULUYX23Q_js.DisconnectElement; }
 });
 Object.defineProperty(exports, "TokenListElement", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.TokenListElement; }
+  get: function () { return chunkULUYX23Q_js.TokenListElement; }
 });
 Object.defineProperty(exports, "TransactionHistoryElement", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.TransactionHistoryElement; }
+  get: function () { return chunkULUYX23Q_js.TransactionHistoryElement; }
 });
 Object.defineProperty(exports, "UnifiedProvider", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.UnifiedProvider; }
+  get: function () { return chunkULUYX23Q_js.UnifiedProvider; }
 });
 Object.defineProperty(exports, "WalletListElement", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.WalletListElement; }
+  get: function () { return chunkULUYX23Q_js.WalletListElement; }
 });
 Object.defineProperty(exports, "useAccount", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useAccount; }
+  get: function () { return chunkULUYX23Q_js.useAccount; }
 });
 Object.defineProperty(exports, "useBalance", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useBalance; }
+  get: function () { return chunkULUYX23Q_js.useBalance; }
 });
 Object.defineProperty(exports, "useCluster", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useCluster; }
+  get: function () { return chunkULUYX23Q_js.useCluster; }
 });
 Object.defineProperty(exports, "useConnector", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useConnector; }
+  get: function () { return chunkULUYX23Q_js.useConnector; }
 });
 Object.defineProperty(exports, "useConnectorClient", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useConnectorClient; }
+  get: function () { return chunkULUYX23Q_js.useConnectorClient; }
 });
 Object.defineProperty(exports, "useGillSolanaClient", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useGillSolanaClient; }
+  get: function () { return chunkULUYX23Q_js.useGillSolanaClient; }
 });
 Object.defineProperty(exports, "useGillTransactionSigner", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useGillTransactionSigner; }
+  get: function () { return chunkULUYX23Q_js.useGillTransactionSigner; }
 });
 Object.defineProperty(exports, "useKitTransactionSigner", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useKitTransactionSigner; }
+  get: function () { return chunkULUYX23Q_js.useKitTransactionSigner; }
 });
 Object.defineProperty(exports, "useSolanaClient", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useSolanaClient; }
+  get: function () { return chunkULUYX23Q_js.useSolanaClient; }
 });
 Object.defineProperty(exports, "useTokens", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useTokens; }
+  get: function () { return chunkULUYX23Q_js.useTokens; }
 });
 Object.defineProperty(exports, "useTransactionPreparer", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useTransactionPreparer; }
+  get: function () { return chunkULUYX23Q_js.useTransactionPreparer; }
 });
 Object.defineProperty(exports, "useTransactionSigner", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useTransactionSigner; }
+  get: function () { return chunkULUYX23Q_js.useTransactionSigner; }
 });
 Object.defineProperty(exports, "useTransactions", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useTransactions; }
+  get: function () { return chunkULUYX23Q_js.useTransactions; }
 });
 Object.defineProperty(exports, "useWalletInfo", {
   enumerable: true,
-  get: function () { return chunkLUZWUZ5N_js.useWalletInfo; }
+  get: function () { return chunkULUYX23Q_js.useWalletInfo; }
 });
 Object.defineProperty(exports, "ConnectorErrorBoundary", {
   enumerable: true,
-  get: function () { return chunkCLXM6UEE_js.ConnectorErrorBoundary; }
+  get: function () { return chunkJUZVCBAI_js.ConnectorErrorBoundary; }
 });
 Object.defineProperty(exports, "withErrorBoundary", {
   enumerable: true,
-  get: function () { return chunkCLXM6UEE_js.withErrorBoundary; }
+  get: function () { return chunkJUZVCBAI_js.withErrorBoundary; }
 });
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map

package/dist/react.mjs

@@ -1,4 +1,4 @@
-export { AccountElement, UnifiedProvider as AppProvider, BalanceElement, ClusterElement, ConnectorProvider, DisconnectElement, TokenListElement, TransactionHistoryElement, UnifiedProvider, WalletListElement, useAccount, useBalance, useCluster, useConnector, useConnectorClient, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo } from './chunk-U64YZRJL.mjs';
-export { ConnectorErrorBoundary, withErrorBoundary } from './chunk-YTCSTE3Q.mjs';
+export { AccountElement, UnifiedProvider as AppProvider, BalanceElement, ClusterElement, ConnectorProvider, DisconnectElement, TokenListElement, TransactionHistoryElement, UnifiedProvider, WalletListElement, useAccount, useBalance, useCluster, useConnector, useConnectorClient, useGillSolanaClient, useGillTransactionSigner, useKitTransactionSigner, useSolanaClient, useTokens, useTransactionPreparer, useTransactionSigner, useTransactions, useWalletInfo } from './chunk-3STZXVXD.mjs';
+export { ConnectorErrorBoundary, withErrorBoundary } from './chunk-VMSZJPR5.mjs';
 //# sourceMappingURL=react.mjs.map
 //# sourceMappingURL=react.mjs.map

package/dist/{wallet-standard-shim-DC_Z7DS-.d.ts → wallet-standard-shim--YcrQNRt.d.ts}

@@ -116,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
  */
@@ -151,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
@@ -324,6 +379,10 @@ declare class ConnectorClient {
     getHealth(): ConnectorHealth;
     getDebugMetrics(): ConnectorDebugMetrics;
     getDebugState(): ConnectorDebugState;
+    /**
+     * Get the current connector configuration
+     */
+    getConfig(): ConnectorConfig;
     resetDebugMetrics(): void;
     destroy(): void;
 }
@@ -357,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 {
@@ -379,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

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

@@ -116,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
  */
@@ -151,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
@@ -324,6 +379,10 @@ declare class ConnectorClient {
     getHealth(): ConnectorHealth;
     getDebugMetrics(): ConnectorDebugMetrics;
     getDebugState(): ConnectorDebugState;
+    /**
+     * Get the current connector configuration
+     */
+    getConfig(): ConnectorConfig;
     resetDebugMetrics(): void;
     destroy(): void;
 }
@@ -357,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 {
@@ -379,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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@solana/connector",
-    "version": "0.1.4",
+    "version": "0.1.5",
     "description": "Headless wallet connector client and React provider built on Wallet Standard",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",