@solana/connector 0.2.2 → 0.2.3

package/README.md

@@ -70,6 +70,12 @@ export function Providers({ children }: { children: React.ReactNode }) {
             autoConnect: true,
             enableMobile: true,
             clusters,
+            // Optional: Control which detected wallets are shown/available (Wallet Standard auto-discovery)
+            wallets: {
+                allowList: ['Phantom', 'Solflare', 'Backpack'],
+                denyList: ['Keplr', 'MetaMask'],
+                featured: ['Phantom', 'Solflare'],
+            },
         });
     }, []);
 
@@ -90,6 +96,16 @@ export function Providers({ children }: { children: React.ReactNode }) {
 }
 ```
 
+**Optional: Wallet filtering & ordering**
+
+ConnectorKit auto-detects wallets via Wallet Standard. To improve UX for users with many installed wallets, you can filter/prioritize the detected list using `wallets`.
+
+- `allowList`: only expose these wallet names
+- `denyList`: hide these wallet names (deny wins)
+- `featured`: show these wallets first
+
+This is **full-scope** filtering: hidden wallets are removed from `connectors` and cannot be selected or auto-connected.
+
 ### 3. Use Hooks (in any component)
 
 ```typescript
@@ -1467,6 +1483,7 @@ import { AppProvider, useConnector, useWallet, useConnectWallet } from '@solana/
 import type {
     // Configuration
     ConnectorConfig,
+    WalletDisplayConfig,
     DefaultConfigOptions,
     ExtendedConnectorConfig,
 

package/dist/{chunk-VVLY6QPI.js → chunk-B6YBZB6H.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkTRSJSU33_js = require('./chunk-TRSJSU33.js');
+var chunkULEPN4NL_js = require('./chunk-ULEPN4NL.js');
 var chunkBF67LVVM_js = require('./chunk-BF67LVVM.js');
 var chunkL5FWMNWO_js = require('./chunk-L5FWMNWO.js');
 var React4 = require('react');
@@ -314,7 +314,7 @@ function useWalletConnectUri() {
   };
 }
 var logger2 = chunkBF67LVVM_js.createLogger("ConnectorProvider");
-chunkTRSJSU33_js.installPolyfills();
+chunkULEPN4NL_js.installPolyfills();
 var ConnectorContext = React4.createContext(null);
 ConnectorContext.displayName = "ConnectorContext";
 function ConnectorProviderInternal({
@@ -325,7 +325,7 @@ function ConnectorProviderInternal({
   let clientRef = React4.useRef(null), client = React4__default.default.useCallback(() => {
     if (!clientRef.current)
       try {
-        clientRef.current = new chunkTRSJSU33_js.ConnectorClient(config), typeof window < "u" && (window.__connectorClient = clientRef.current), config?.debug && logger2.info("Client initialized successfully");
+        clientRef.current = new chunkULEPN4NL_js.ConnectorClient(config), typeof window < "u" && (window.__connectorClient = clientRef.current), config?.debug && logger2.info("Client initialized successfully");
       } catch (error) {
         let err = error;
         logger2.error("Failed to initialize client", { error: err });
@@ -568,7 +568,7 @@ function useCluster() {
     [client]
   );
   return React4.useMemo(() => {
-    let isMainnet = cluster ? chunkTRSJSU33_js.isMainnetCluster(cluster) : false, isDevnet = cluster ? chunkTRSJSU33_js.isDevnetCluster(cluster) : false, isTestnet = cluster ? chunkTRSJSU33_js.isTestnetCluster(cluster) : false, isLocal = cluster ? chunkTRSJSU33_js.isLocalCluster(cluster) : false, explorerUrl = cluster ? chunkTRSJSU33_js.getClusterExplorerUrl(cluster) : "", type = cluster ? chunkTRSJSU33_js.getClusterType(cluster) : null;
+    let isMainnet = cluster ? chunkULEPN4NL_js.isMainnetCluster(cluster) : false, isDevnet = cluster ? chunkULEPN4NL_js.isDevnetCluster(cluster) : false, isTestnet = cluster ? chunkULEPN4NL_js.isTestnetCluster(cluster) : false, isLocal = cluster ? chunkULEPN4NL_js.isLocalCluster(cluster) : false, explorerUrl = cluster ? chunkULEPN4NL_js.getClusterExplorerUrl(cluster) : "", type = cluster ? chunkULEPN4NL_js.getClusterType(cluster) : null;
     return {
       cluster,
       clusters,
@@ -586,7 +586,7 @@ function useAccount() {
   let { selectedAccount, accounts, connected, selectAccount } = useConnector(), [copied, setCopied] = React4.useState(false), copyTimeoutRef = React4__default.default.useRef(void 0), account = React4.useMemo(
     () => accounts.find((a) => a.address === selectedAccount) ?? null,
     [accounts, selectedAccount]
-  ), formatted = React4.useMemo(() => selectedAccount ? chunkTRSJSU33_js.formatAddress(selectedAccount) : "", [selectedAccount]), copy = React4.useCallback(async () => selectedAccount ? (copyTimeoutRef.current && clearTimeout(copyTimeoutRef.current), await chunkTRSJSU33_js.copyAddressToClipboard(selectedAccount, {
+  ), formatted = React4.useMemo(() => selectedAccount ? chunkULEPN4NL_js.formatAddress(selectedAccount) : "", [selectedAccount]), copy = React4.useCallback(async () => selectedAccount ? (copyTimeoutRef.current && clearTimeout(copyTimeoutRef.current), await chunkULEPN4NL_js.copyAddressToClipboard(selectedAccount, {
     onSuccess: () => {
       setCopied(true), copyTimeoutRef.current = setTimeout(() => setCopied(false), 2e3);
     }
@@ -616,7 +616,7 @@ function useWalletInfo() {
     () => wallets.map(
       (walletInfo) => ({
         name: walletInfo.wallet.name,
-        connectorId: chunkTRSJSU33_js.createConnectorId(walletInfo.wallet.name),
+        connectorId: chunkULEPN4NL_js.createConnectorId(walletInfo.wallet.name),
         icon: walletInfo.wallet.icon,
         installed: walletInfo.installed,
         connectable: walletInfo.connectable
@@ -653,7 +653,7 @@ function useTransactionSigner() {
   let { selectedWallet, selectedAccount, accounts, cluster, connected } = useConnector(), client = useConnectorClient(), account = React4.useMemo(
     () => accounts.find((a) => a.address === selectedAccount)?.raw ?? null,
     [accounts, selectedAccount]
-  ), signer = React4.useMemo(() => !connected || !selectedWallet || !account ? null : chunkTRSJSU33_js.createTransactionSigner({
+  ), signer = React4.useMemo(() => !connected || !selectedWallet || !account ? null : chunkULEPN4NL_js.createTransactionSigner({
     wallet: selectedWallet,
     account,
     cluster: cluster ?? void 0,
@@ -681,7 +681,7 @@ function useTransactionSigner() {
 function useKitTransactionSigner() {
   let { signer: connectorSigner, ready } = useTransactionSigner();
   return {
-    signer: React4.useMemo(() => connectorSigner ? chunkTRSJSU33_js.createKitTransactionSigner(connectorSigner) : null, [connectorSigner]),
+    signer: React4.useMemo(() => connectorSigner ? chunkULEPN4NL_js.createKitTransactionSigner(connectorSigner) : null, [connectorSigner]),
     ready
   };
 }
@@ -1066,7 +1066,7 @@ function getBalanceQueryKey(rpcUrl, address) {
 }
 var LAMPORTS_PER_SOL2 = 1000000000n;
 function formatTokenAccount(account) {
-  let formatted = chunkTRSJSU33_js.formatBigIntBalance(account.amount, account.decimals, {
+  let formatted = chunkULEPN4NL_js.formatBigIntBalance(account.amount, account.decimals, {
     maxDecimals: Math.min(account.decimals, 6)
   });
   return {
@@ -1110,7 +1110,7 @@ function useBalance(options = {}) {
     refetchIntervalMs: autoRefresh ? refreshInterval : false,
     client: clientOverride,
     select: selectBalance
-  }), lamports = data?.lamports ?? 0n, tokens = data?.tokens ?? [], solBalance = React4.useMemo(() => Number(lamports) / Number(LAMPORTS_PER_SOL2), [lamports]), formattedSol = React4.useMemo(() => chunkTRSJSU33_js.formatLamportsToSolSafe(lamports, { maxDecimals: 4, suffix: true }), [lamports]), visibleError = updatedAt ? null : error, refetch = React4.useCallback(
+  }), lamports = data?.lamports ?? 0n, tokens = data?.tokens ?? [], solBalance = React4.useMemo(() => Number(lamports) / Number(LAMPORTS_PER_SOL2), [lamports]), formattedSol = React4.useMemo(() => chunkULEPN4NL_js.formatLamportsToSolSafe(lamports, { maxDecimals: 4, suffix: true }), [lamports]), visibleError = updatedAt ? null : error, refetch = React4.useCallback(
     async (opts) => {
       await sharedRefetch(opts);
     },
@@ -1579,7 +1579,7 @@ function useTransactions(options = {}) {
             blockTimeNum,
             Number(sig.slot),
             sig.err,
-            chunkTRSJSU33_js.getTransactionUrl(String(sig.signature), currentCluster)
+            chunkULEPN4NL_js.getTransactionUrl(String(sig.signature), currentCluster)
           );
         });
       } else
@@ -1594,7 +1594,7 @@ function useTransactions(options = {}) {
             type: "unknown",
             formattedDate: date,
             formattedTime: time,
-            explorerUrl: chunkTRSJSU33_js.getTransactionUrl(String(sig.signature), currentCluster)
+            explorerUrl: chunkULEPN4NL_js.getTransactionUrl(String(sig.signature), currentCluster)
           };
         });
       let mintsToFetch = [
@@ -1608,7 +1608,7 @@ function useTransactions(options = {}) {
         throwIfAborted(signal);
         let tokenMetadata = await fetchTransactionTokenMetadata(mintsToFetch, {
           signal,
-          cluster: chunkTRSJSU33_js.getClusterType(currentCluster)
+          cluster: chunkULEPN4NL_js.getClusterType(currentCluster)
         });
         tokenMetadata.size > 0 && (newTransactions = newTransactions.map((tx) => {
           let enrichedTx = { ...tx };
@@ -1888,12 +1888,12 @@ async function fetchTokenMetadataHybrid(mints, coingeckoConfig, options) {
   return didUpdatePrices && options?.onUpdate?.(), didUpdate;
 }
 function formatBalance(amount, decimals) {
-  return chunkTRSJSU33_js.formatBigIntBalance(amount, decimals, {
+  return chunkULEPN4NL_js.formatBigIntBalance(amount, decimals, {
     maxDecimals: Math.min(decimals, 6)
   });
 }
 function formatUsd(amount, decimals, usdPrice) {
-  return chunkTRSJSU33_js.formatBigIntUsd(amount, decimals, usdPrice);
+  return chunkULEPN4NL_js.formatBigIntUsd(amount, decimals, usdPrice);
 }
 function selectTokens(assets, address) {
   return {
@@ -2110,7 +2110,7 @@ function AccountElement({
   variant = "compact",
   render
 }) {
-  let { account, connectorId } = useWallet(), connectors = useWalletConnectors(), address = React4__default.default.useMemo(() => account ? String(account) : null, [account]), formatted = React4__default.default.useMemo(() => address ? chunkTRSJSU33_js.formatAddress(address) : "", [address]), connector = React4__default.default.useMemo(() => connectorId ? connectors.find((c) => c.id === connectorId) ?? null : null, [connectors, connectorId]), walletName = connector?.name ?? null, walletIcon = connector?.icon ? connector.icon : null, [copied, setCopied] = React4__default.default.useState(false), copyTimeoutRef = React4__default.default.useRef(void 0), copy = React4__default.default.useCallback(async () => address ? (copyTimeoutRef.current && clearTimeout(copyTimeoutRef.current), await chunkTRSJSU33_js.copyAddressToClipboard(address, {
+  let { account, connectorId } = useWallet(), connectors = useWalletConnectors(), address = React4__default.default.useMemo(() => account ? String(account) : null, [account]), formatted = React4__default.default.useMemo(() => address ? chunkULEPN4NL_js.formatAddress(address) : "", [address]), connector = React4__default.default.useMemo(() => connectorId ? connectors.find((c) => c.id === connectorId) ?? null : null, [connectors, connectorId]), walletName = connector?.name ?? null, walletIcon = connector?.icon ? connector.icon : null, [copied, setCopied] = React4__default.default.useState(false), copyTimeoutRef = React4__default.default.useRef(void 0), copy = React4__default.default.useCallback(async () => address ? (copyTimeoutRef.current && clearTimeout(copyTimeoutRef.current), await chunkULEPN4NL_js.copyAddressToClipboard(address, {
     onSuccess: () => {
       setCopied(true), copyTimeoutRef.current = setTimeout(() => setCopied(false), 2e3);
     }
@@ -3309,5 +3309,5 @@ exports.useWalletConnectUri = useWalletConnectUri;
 exports.useWalletConnectors = useWalletConnectors;
 exports.useWalletInfo = useWalletInfo;
 exports.withErrorBoundary = withErrorBoundary;
-//# sourceMappingURL=chunk-VVLY6QPI.js.map
-//# sourceMappingURL=chunk-VVLY6QPI.js.map
+//# sourceMappingURL=chunk-B6YBZB6H.js.map
+//# sourceMappingURL=chunk-B6YBZB6H.js.map