@reown/appkit-controllers 1.8.14-cc0928045461a473e8850f4bd5ee072c53e54502.0 → 1.8.14-d921da175a718bd981568cbf2b4236631c3f59c1.0

package/dist/types/exports/index.d.ts

@@ -55,7 +55,9 @@ export { ExchangeController } from '../src/controllers/ExchangeController.js';
 export type { ExchangeControllerState } from '../src/controllers/ExchangeController.js';
 export { AssetUtil } from '../src/utils/AssetUtil.js';
 export { ConstantsUtil } from '../src/utils/ConstantsUtil.js';
+export { WalletUtil } from '../src/utils/WalletUtil.js';
 export { CoreHelperUtil, type OpenTarget } from '../src/utils/CoreHelperUtil.js';
+export { ConnectorUtil } from '../src/utils/ConnectorUtil.js';
 export { StorageUtil } from '../src/utils/StorageUtil.js';
 export { RouterUtil } from '../src/utils/RouterUtil.js';
 export { OptionsUtil } from '../src/utils/OptionsUtil.js';

package/dist/types/src/utils/ConnectorUtil.d.ts

@@ -0,0 +1,57 @@
+import type { Connector, ConnectorOrWalletItem, ConnectorTypeOrder, ConnectorWithProviders, CustomWallet, SocialProvider, WcWallet } from './TypeUtil.js';
+interface GetConnectorTypeOrderParameters {
+    recommended: WcWallet[];
+    featured: WcWallet[];
+    custom: CustomWallet[] | undefined;
+    recent: WcWallet[];
+    announced: WcWallet[];
+    injected: WcWallet[];
+    multiChain: WcWallet[];
+    external: WcWallet[];
+    overriddenConnectors?: ConnectorTypeOrder[];
+}
+export declare const ConnectorUtil: {
+    getConnectorsByType(connectors: ConnectorWithProviders[], recommended: WcWallet[], featured: WcWallet[]): {
+        custom: CustomWallet[] | undefined;
+        recent: WcWallet[];
+        external: ConnectorWithProviders[];
+        multiChain: ConnectorWithProviders[];
+        announced: ConnectorWithProviders[];
+        injected: ConnectorWithProviders[];
+        recommended: WcWallet[];
+        featured: WcWallet[];
+    };
+    showConnector(connector: ConnectorWithProviders): boolean;
+    /**
+     * Returns true if the user is connected to a WalletConnect connector in the any of the available namespaces.
+     * @returns boolean
+     */
+    getIsConnectedWithWC(): boolean;
+    /**
+     * Returns the connector positions in the order of the user's preference.
+     * @returns ConnectorTypeOrder[]
+     */
+    getConnectorTypeOrder({ recommended, featured, custom, recent, announced, injected, multiChain, external, overriddenConnectors }: GetConnectorTypeOrderParameters): string[];
+    sortConnectorsByExplorerWallet(connectors: ConnectorWithProviders[]): ConnectorWithProviders[];
+    getAuthName({ email, socialUsername, socialProvider }: {
+        email: string;
+        socialUsername?: string | null;
+        socialProvider?: SocialProvider | null;
+    }): string;
+    fetchProviderData(connector: Connector): Promise<{
+        accounts: string[];
+        chainId: number | undefined;
+    }>;
+    /**
+     * Filter out duplicate custom wallets by RDNS
+     * @param wallets
+     */
+    getFilteredCustomWallets(wallets: WcWallet[]): WcWallet[];
+    hasWalletConnector(wallet: WcWallet): boolean;
+    isWalletCompatibleWithCurrentChain(wallet: WcWallet): boolean;
+    getFilteredRecentWallets(): WcWallet[];
+    getCappedRecommendedWallets(wallets: WcWallet[]): WcWallet[];
+    processConnectorsByType(connectors: ConnectorWithProviders[], shouldFilter?: boolean): ConnectorWithProviders[];
+    connectorList(): ConnectorOrWalletItem[];
+};
+export {};

package/dist/types/src/utils/ConstantsUtil.d.ts

@@ -1,4 +1,5 @@
 import { type ChainNamespace, type OnRampProvider, type SocialProvider, type SwapProvider } from '@reown/appkit-common';
+import type { ConnectMethod } from './TypeUtil.js';
 export declare const ONRAMP_PROVIDERS: {
     label: string;
     name: string;
@@ -105,4 +106,6 @@ export declare const ConstantsUtil: {
     SIWX_DEFAULTS: {
         readonly signOutOnDisconnect: true;
     };
+    MANDATORY_WALLET_IDS_ON_MOBILE: (string | undefined)[];
+    DEFAULT_CONNECT_METHOD_ORDER: ConnectMethod[];
 };

package/dist/types/src/utils/TypeUtil.d.ts

@@ -1296,4 +1296,15 @@ export type ProjectLimits = {
     isAboveRpcLimit: boolean;
     isAboveMauLimit: boolean;
 };
+export type ConnectorItemWithKind = {
+    kind: 'connector';
+    subtype: 'injected' | 'announced' | 'multiChain' | 'external' | 'walletConnect';
+    connector: ConnectorWithProviders;
+};
+export type WalletItemWithKind = {
+    kind: 'wallet';
+    subtype: 'featured' | 'recommended' | 'custom' | 'recent';
+    wallet: WcWallet;
+};
+export type ConnectorOrWalletItem = ConnectorItemWithKind | WalletItemWithKind;
 export {};

package/dist/types/src/utils/WalletUtil.d.ts

@@ -0,0 +1,56 @@
+import type { ConnectMethod, Connector, Features, WcWallet } from './TypeUtil.js';
+interface AppKitWallet extends WcWallet {
+    installed: boolean;
+}
+export declare const WalletUtil: {
+    filterOutDuplicatesByRDNS(wallets: WcWallet[]): WcWallet[];
+    filterOutDuplicatesByIds(wallets: WcWallet[]): WcWallet[];
+    filterOutDuplicateWallets(wallets: WcWallet[]): WcWallet[];
+    /**
+     * Marks wallets as installed based on available connectors and sorts them
+     * according to both installation status and featuredWalletIds order.
+     *
+     * @param wallets - Array of wallets to process
+     * @returns Array of wallets marked as installed and sorted by priority
+     */
+    markWalletsAsInstalled(wallets: WcWallet[]): AppKitWallet[];
+    getConnectOrderMethod(_features: Features | undefined, _connectors: Connector[]): ConnectMethod[];
+    isExcluded(wallet: WcWallet): boolean;
+    markWalletsWithDisplayIndex(wallets: WcWallet[]): {
+        display_index: number;
+        id: string;
+        name: string;
+        badge_type?: import("./TypeUtil.js").BadgeType;
+        description?: string;
+        chains?: import("@reown/appkit-common").CaipNetworkId[];
+        homepage?: string;
+        image_id?: string;
+        image_url?: string;
+        order?: number;
+        link_mode?: string | null;
+        mobile_link?: string | null;
+        desktop_link?: string | null;
+        webapp_link?: string | null;
+        app_store?: string | null;
+        play_store?: string | null;
+        chrome_store?: string | null;
+        rdns?: string | null;
+        injected?: {
+            namespace?: string;
+            injected_id?: string;
+        }[] | null;
+        supports_wc?: boolean;
+    }[];
+    /**
+     * Filters wallets based on WalletConnect support and platform requirements.
+     *
+     * On mobile only wallets with WalletConnect support and some mandatory wallets are shown.
+     * On desktop with Appkit Core only wallets with WalletConnect support are shown.
+     * On desktop with Appkit all wallets are shown.
+     *
+     * @param wallets - Array of wallets to filter
+     * @returns Filtered array of wallets based on WalletConnect support and platform
+     */
+    filterWalletsByWcSupport(wallets: WcWallet[]): WcWallet[];
+};
+export {};

package/dist/types/tests/utils/ControllerUtil.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reown/appkit-controllers",
-  "version": "1.8.14-cc0928045461a473e8850f4bd5ee072c53e54502.0",
+  "version": "1.8.14-d921da175a718bd981568cbf2b4236631c3f59c1.0",
   "sideEffects": false,
   "type": "module",
   "main": "./dist/esm/exports/index.js",
@@ -56,8 +56,8 @@
     "@walletconnect/universal-provider": "2.23.0",
     "valtio": "2.1.7",
     "viem": ">=2.37.9",
-    "@reown/appkit-common": "1.8.14-cc0928045461a473e8850f4bd5ee072c53e54502.0",
-    "@reown/appkit-wallet": "1.8.14-cc0928045461a473e8850f4bd5ee072c53e54502.0"
+    "@reown/appkit-common": "1.8.14-d921da175a718bd981568cbf2b4236631c3f59c1.0",
+    "@reown/appkit-wallet": "1.8.14-d921da175a718bd981568cbf2b4236631c3f59c1.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "2.1.9",