@reown/appkit-controllers 1.8.14-ecf1794d555806e376ab2253b48ab2b185e85a10.0 → 1.8.14-embedded-mode-fix.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/exports/react.d.ts

@@ -78,9 +78,14 @@ export declare function useAppKitConnection({ namespace, onSuccess, onError }: U
 };
 export interface UseAppKitWalletsReturn {
     /**
-     * List of all wallets (injected wallets and WalletConnect wallets combined)
+     * List of wallets for the initial connect view including WalletConnect wallet and injected wallets together. If user doesn't have any injected wallets, it'll fill the list with most ranked WalletConnect wallets.
      */
-    data: WalletItem[];
+    wallets: WalletItem[];
+    /**
+     * List of WalletConnect wallets from Wallet Guide API. Useful to display all available WalletConnect wallets in a separate Search Wallets view.
+     * @see https://walletguide.walletconnect.network/.
+     */
+    wcWallets: WalletItem[];
     /**
      * Boolean that indicates if WalletConnect wallets are being fetched.
      */
@@ -90,23 +95,30 @@ export interface UseAppKitWalletsReturn {
      */
     isFetchingWcUri: boolean;
     /**
-     * The current WalletConnect URI for QR code display.
-     * This is set when connecting to a WalletConnect wallet.
+     * Boolean that indicates if the AppKit is initialized. It's useful to render a fallback UI when the AppKit initializes and detects all injected wallets.
+     */
+    isInitialized: boolean;
+    /**
+     * The current WalletConnect URI for QR code display. This is set when connecting to a WalletConnect wallet. Reset with resetWcUri().
      */
     wcUri?: string;
     /**
-     * The current page number.
+     * The wallet currently being connected to. This is set when a connection is initiated and cleared when it completes or fails. For WalletConnect wallets, resetWcUri() should be called to clear the state.
+     */
+    connectingWallet?: WalletItem;
+    /**
+     * The current page number of WalletConnect wallets.
      */
     page: number;
     /**
-     * The total number of available wallets.
+     * The total number of available WalletConnect wallets based on the AppKit configurations and given parameters.
      */
     count: number;
     /**
-     * Function to fetch WalletConnect wallets from the explorer API.
-     * This is useful for pagination or initial load.
+     * Function to fetch WalletConnect wallets from the explorer API. Allows to list, search and paginate through the wallets.
      * @param options - Options for fetching wallets
      * @param options.page - Page number to fetch (default: 1)
+     * @param options.query - Search query to filter wallets (default: '')
      */
     fetchWallets: (options?: {
         page?: number;
@@ -114,14 +126,18 @@ export interface UseAppKitWalletsReturn {
     }) => Promise<void>;
     /**
      * Function to connect to a wallet.
-     * - For WalletConnect wallets: initiates WC connection and returns the URI in the onSuccess callback
-     * - For injected connectors: triggers the extension/wallet directly
+     * - For WalletConnect wallets: initiates WC connection and returns the URI with the `wcUri` state.
+     * - For injected connectors: triggers the extension/wallet directly.
      *
      * @param wallet - The wallet item to connect to
      * @param callbacks - Success and error callbacks
      * @returns Promise that resolves when connection completes or rejects on error
      */
     connect: (wallet: WalletItem, namespace?: ChainNamespace) => Promise<void>;
+    /**
+     * Function to reset the WC URI. Useful to keep `connectingWallet` state sync with the WC URI. Can be called when the QR code is closed.
+     */
+    resetWcUri: () => void;
 }
 /**
  * Headless hook for wallet connection.

package/dist/types/src/controllers/OptionsController.d.ts

@@ -85,11 +85,6 @@ export interface OptionsControllerStatePublic {
      * @default true
      */
     enableCoinbase?: boolean;
-    /**
-     * Enable or disable the AppKit Headless mode to build custom connect user interfaces.
-     * @default true
-     */
-    enableHeadless?: boolean;
     /**
      * Enable or disable the Injected wallet.
      * @default true
@@ -231,7 +226,6 @@ export declare const OptionsController: {
     setAllowUnsupportedChain(allowUnsupportedChain: OptionsControllerState["allowUnsupportedChain"]): void;
     setManualWCControl(manualWCControl: OptionsControllerState["manualWCControl"]): void;
     setEnableNetworkSwitch(enableNetworkSwitch: OptionsControllerState["enableNetworkSwitch"]): void;
-    setEnableHeadless(enableHeadless: OptionsControllerState["enableHeadless"]): void;
     setEnableMobileFullScreen(enableMobileFullScreen: OptionsControllerState["enableMobileFullScreen"]): void;
     setEnableReconnect(enableReconnect: OptionsControllerState["enableReconnect"]): void;
     setCoinbasePreference(coinbasePreference: OptionsControllerState["coinbasePreference"]): void;
@@ -1635,12 +1629,6 @@ export declare const OptionsController: {
          */
          | undefined;
         readonly enableCoinbase?: boolean
-        /**
-         * Enable or disable the AppKit Headless mode to build custom connect user interfaces.
-         * @default true
-         */
-         | undefined;
-        readonly enableHeadless?: boolean
         /**
          * Enable or disable the Injected wallet.
          * @default true
@@ -1709,6 +1697,7 @@ export declare const OptionsController: {
             readonly collapseWallets?: boolean | undefined;
             readonly pay?: boolean | undefined;
             readonly reownAuthentication?: boolean | undefined;
+            readonly headless?: boolean | undefined;
         } | undefined;
         readonly siwx?: {
             readonly createMessage: (input: import("../utils/SIWXUtil.js").SIWXMessage.Input) => Promise<import("../utils/SIWXUtil.js").SIWXMessage>;

package/dist/types/src/controllers/PublicStateController.d.ts

@@ -1,4 +1,5 @@
 import type { CaipNetworkId, ChainNamespace } from '@reown/appkit-common';
+import type { WalletItem } from '../utils/ConnectUtil.js';
 export interface PublicStateControllerState {
     /**
      * @description Indicates if the AppKit is loading.
@@ -25,6 +26,11 @@ export interface PublicStateControllerState {
      * @type {boolean}
      */
     initialized: boolean;
+    /**
+     * @description Indicates the wallet item that is currently being connecting.
+     * @type {WalletItem | undefined}
+     */
+    connectingWallet: WalletItem | undefined;
 }
 export declare const PublicStateController: {
     state: PublicStateControllerState;

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

@@ -0,0 +1,8 @@
+import type { WcWallet } from './TypeUtil.js';
+export declare const ApiControllerUtil: {
+    /**
+     * Finds a wallet by ID across all wallet arrays (wallets, recommended, featured, search, etc.)
+     * This is useful when a wallet might be in different arrays depending on the context
+     */
+    getWalletById(walletId: string | undefined): WcWallet | undefined;
+};

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

@@ -1,5 +1,5 @@
 import type { ChainNamespace } from '@reown/appkit-common';
-import type { WcWallet } from './TypeUtil.js';
+import type { ConnectorItemWithKind, ConnectorWithProviders, WcWallet } from './TypeUtil.js';
 export type WalletItem = {
     id: string;
     name: string;
@@ -29,10 +29,26 @@ export type WalletItem = {
 };
 export declare const ConnectUtil: {
     /**
-     * Transforms connectors and wallets into a unified list of wallet items
+     * Maps the initial connect view wallets into WalletItems. Includes WalletConnect wallet and injected wallets. If user doesn't have any injected wallets, it'll fill the list with most ranked WalletConnect wallets.
+     * @returns The WalletItems for the initial connect view.
      */
-    getUnifiedWalletList(params: {
-        wcWallets: WcWallet[];
-        search: WcWallet[];
-    }): WalletItem[];
+    getInitialWallets(): WalletItem[];
+    /**
+     * Maps the WalletGuide explorer wallets to WalletItems including search results.
+     * @returns The WalletItems for the WalletGuide explorer wallets.
+     */
+    getWalletConnectWallets(wcAllWallets: WcWallet[], wcSearchWallets: WcWallet[]): WalletItem[];
+    /**
+     * Maps the connector to a WalletItem.
+     * @param connector - The connector to map to a WalletItem.
+     * @param subType - The subtype of the connector.
+     * @returns The WalletItem for the connector.
+     */
+    mapConnectorToWalletItem(connector: ConnectorWithProviders, subType: ConnectorItemWithKind["subtype"]): WalletItem;
+    /**
+     * Maps the WalletGuide explorer wallet to a WalletItem.
+     * @param w - The WalletGuide explorer wallet.
+     * @returns The WalletItem for the WalletGuide explorer wallet.
+     */
+    mapWalletToWalletItem(w: WcWallet): WalletItem;
 };

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

@@ -1,5 +1,6 @@
 import { type ChainNamespace } from '@reown/appkit-common';
 import type { Connection } from '@reown/appkit-common';
+import type { WcWallet } from './TypeUtil.js';
 interface ExcludeConnectorAddressFromConnectionsParamters {
     connections: Connection[];
     connectorId?: string;
@@ -14,5 +15,6 @@ export declare const ConnectionControllerUtil: {
         connections: Connection[];
         recentConnections: Connection[];
     };
+    onConnectMobile(wallet: WcWallet | undefined): void;
 };
 export {};

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

@@ -0,0 +1,58 @@
+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[];
+    hasInjectedConnectors(): number;
+};
+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;
@@ -85,6 +86,7 @@ export declare const ConstantsUtil: {
         connectMethodsOrder: undefined;
         pay: false;
         reownAuthentication: false;
+        headless: false;
     };
     DEFAULT_SOCIALS: SocialProvider[];
     DEFAULT_ACCOUNT_TYPES: {
@@ -105,4 +107,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

@@ -1170,6 +1170,12 @@ export type Features = {
      * @type {boolean}
      */
     reownAuthentication?: boolean;
+    /**
+     * @description Enable or disable the AppKit Headless mode to build custom connect user interfaces.
+     * @default false
+     * @type {boolean}
+     */
+    headless?: boolean;
 };
 export type FeaturesKeys = Exclude<keyof Features, 'swaps' | 'onramp' | 'email' | 'socials' | 'history'>;
 export type WalletGuideType = 'get-started' | 'explore';
@@ -1296,4 +1302,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/ViemUtil.d.ts

@@ -338,6 +338,7 @@ export declare const ViemUtil: {
                 type: "legacy";
                 hash: import("viem").Hash;
                 input: import("viem").Hex;
+                chainId?: number | undefined;
                 yParity?: undefined | undefined;
                 from: import("viem").Address;
                 gas: bigint;
@@ -350,7 +351,6 @@ export declare const ViemUtil: {
                 accessList?: undefined | undefined;
                 authorizationList?: undefined | undefined;
                 blobVersionedHashes?: undefined | undefined;
-                chainId?: number | undefined;
                 gasPrice: bigint;
                 maxFeePerBlobGas?: undefined | undefined;
                 maxFeePerGas?: undefined | undefined;
@@ -363,6 +363,7 @@ export declare const ViemUtil: {
                 type: "eip2930";
                 hash: import("viem").Hash;
                 input: import("viem").Hex;
+                chainId: number;
                 yParity: number;
                 from: import("viem").Address;
                 gas: bigint;
@@ -375,7 +376,6 @@ export declare const ViemUtil: {
                 accessList: import("viem").AccessList;
                 authorizationList?: undefined | undefined;
                 blobVersionedHashes?: undefined | undefined;
-                chainId: number;
                 gasPrice: bigint;
                 maxFeePerBlobGas?: undefined | undefined;
                 maxFeePerGas?: undefined | undefined;
@@ -388,6 +388,7 @@ export declare const ViemUtil: {
                 type: "eip1559";
                 hash: import("viem").Hash;
                 input: import("viem").Hex;
+                chainId: number;
                 yParity: number;
                 from: import("viem").Address;
                 gas: bigint;
@@ -400,7 +401,6 @@ export declare const ViemUtil: {
                 accessList: import("viem").AccessList;
                 authorizationList?: undefined | undefined;
                 blobVersionedHashes?: undefined | undefined;
-                chainId: number;
                 gasPrice?: undefined | undefined;
                 maxFeePerBlobGas?: undefined | undefined;
                 maxFeePerGas: bigint;
@@ -413,6 +413,7 @@ export declare const ViemUtil: {
                 type: "eip4844";
                 hash: import("viem").Hash;
                 input: import("viem").Hex;
+                chainId: number;
                 yParity: number;
                 from: import("viem").Address;
                 gas: bigint;
@@ -425,7 +426,6 @@ export declare const ViemUtil: {
                 accessList: import("viem").AccessList;
                 authorizationList?: undefined | undefined;
                 blobVersionedHashes: readonly import("viem").Hex[];
-                chainId: number;
                 gasPrice?: undefined | undefined;
                 maxFeePerBlobGas: bigint;
                 maxFeePerGas: bigint;
@@ -438,6 +438,7 @@ export declare const ViemUtil: {
                 type: "eip7702";
                 hash: import("viem").Hash;
                 input: import("viem").Hex;
+                chainId: number;
                 yParity: number;
                 from: import("viem").Address;
                 gas: bigint;
@@ -450,7 +451,6 @@ export declare const ViemUtil: {
                 accessList: import("viem").AccessList;
                 authorizationList: import("viem").SignedAuthorizationList;
                 blobVersionedHashes?: undefined | undefined;
-                chainId: number;
                 gasPrice?: undefined | undefined;
                 maxFeePerBlobGas?: undefined | undefined;
                 maxFeePerGas: bigint;
@@ -542,6 +542,7 @@ export declare const ViemUtil: {
             type: "legacy";
             hash: import("viem").Hash;
             input: import("viem").Hex;
+            chainId?: number | undefined;
             yParity?: undefined | undefined;
             from: import("viem").Address;
             gas: bigint;
@@ -554,7 +555,6 @@ export declare const ViemUtil: {
             accessList?: undefined | undefined;
             authorizationList?: undefined | undefined;
             blobVersionedHashes?: undefined | undefined;
-            chainId?: number | undefined;
             gasPrice: bigint;
             maxFeePerBlobGas?: undefined | undefined;
             maxFeePerGas?: undefined | undefined;
@@ -567,6 +567,7 @@ export declare const ViemUtil: {
             type: "eip2930";
             hash: import("viem").Hash;
             input: import("viem").Hex;
+            chainId: number;
             yParity: number;
             from: import("viem").Address;
             gas: bigint;
@@ -579,7 +580,6 @@ export declare const ViemUtil: {
             accessList: import("viem").AccessList;
             authorizationList?: undefined | undefined;
             blobVersionedHashes?: undefined | undefined;
-            chainId: number;
             gasPrice: bigint;
             maxFeePerBlobGas?: undefined | undefined;
             maxFeePerGas?: undefined | undefined;
@@ -592,6 +592,7 @@ export declare const ViemUtil: {
             type: "eip1559";
             hash: import("viem").Hash;
             input: import("viem").Hex;
+            chainId: number;
             yParity: number;
             from: import("viem").Address;
             gas: bigint;
@@ -604,7 +605,6 @@ export declare const ViemUtil: {
             accessList: import("viem").AccessList;
             authorizationList?: undefined | undefined;
             blobVersionedHashes?: undefined | undefined;
-            chainId: number;
             gasPrice?: undefined | undefined;
             maxFeePerBlobGas?: undefined | undefined;
             maxFeePerGas: bigint;
@@ -617,6 +617,7 @@ export declare const ViemUtil: {
             type: "eip4844";
             hash: import("viem").Hash;
             input: import("viem").Hex;
+            chainId: number;
             yParity: number;
             from: import("viem").Address;
             gas: bigint;
@@ -629,7 +630,6 @@ export declare const ViemUtil: {
             accessList: import("viem").AccessList;
             authorizationList?: undefined | undefined;
             blobVersionedHashes: readonly import("viem").Hex[];
-            chainId: number;
             gasPrice?: undefined | undefined;
             maxFeePerBlobGas: bigint;
             maxFeePerGas: bigint;
@@ -642,6 +642,7 @@ export declare const ViemUtil: {
             type: "eip7702";
             hash: import("viem").Hash;
             input: import("viem").Hex;
+            chainId: number;
             yParity: number;
             from: import("viem").Address;
             gas: bigint;
@@ -654,7 +655,6 @@ export declare const ViemUtil: {
             accessList: import("viem").AccessList;
             authorizationList: import("viem").SignedAuthorizationList;
             blobVersionedHashes?: undefined | undefined;
-            chainId: number;
             gasPrice?: undefined | undefined;
             maxFeePerBlobGas?: undefined | undefined;
             maxFeePerGas: bigint;
@@ -4243,7 +4243,7 @@ export declare const ViemUtil: {
             authorizationList: import("viem").TransactionSerializableEIP7702["authorizationList"];
         } ? "eip7702" : never) | (request["type"] extends string | undefined ? Extract<request["type"], string> : never)>) ? T_25 extends "eip7702" ? import("viem").TransactionRequestEIP7702 : never : never : never)>> & {
             chainId?: number | undefined;
-        }, (request["parameters"] extends readonly import("viem").PrepareTransactionRequestParameterType[] ? request["parameters"][number] : "fees" | "type" | "gas" | "nonce" | "blobVersionedHashes" | "chainId") extends infer T_26 ? T_26 extends (request["parameters"] extends readonly import("viem").PrepareTransactionRequestParameterType[] ? request["parameters"][number] : "fees" | "type" | "gas" | "nonce" | "blobVersionedHashes" | "chainId") ? T_26 extends "fees" ? "gasPrice" | "maxFeePerGas" | "maxPriorityFeePerGas" : T_26 : never : never> & (unknown extends request["kzg"] ? {} : Pick<request, "kzg">) extends infer T ? { [K in keyof T]: (import("viem").UnionRequiredBy<Extract<import("viem").UnionOmit<import("viem").ExtractChainFormatterParameters<import("viem").DeriveChain<{
+        }, (request["parameters"] extends readonly import("viem").PrepareTransactionRequestParameterType[] ? request["parameters"][number] : "fees" | "type" | "chainId" | "gas" | "nonce" | "blobVersionedHashes") extends infer T_26 ? T_26 extends (request["parameters"] extends readonly import("viem").PrepareTransactionRequestParameterType[] ? request["parameters"][number] : "fees" | "type" | "chainId" | "gas" | "nonce" | "blobVersionedHashes") ? T_26 extends "fees" ? "gasPrice" | "maxFeePerGas" | "maxPriorityFeePerGas" : T_26 : never : never> & (unknown extends request["kzg"] ? {} : Pick<request, "kzg">) extends infer T ? { [K in keyof T]: (import("viem").UnionRequiredBy<Extract<import("viem").UnionOmit<import("viem").ExtractChainFormatterParameters<import("viem").DeriveChain<{
             blockExplorers?: {
                 [key: string]: {
                     name: string;
@@ -7657,7 +7657,7 @@ export declare const ViemUtil: {
             authorizationList: import("viem").TransactionSerializableEIP7702["authorizationList"];
         } ? "eip7702" : never) | (request["type"] extends string | undefined ? Extract<request["type"], string> : never)>) ? T_12 extends "eip7702" ? import("viem").TransactionRequestEIP7702 : never : never : never)>> & {
             chainId?: number | undefined;
-        }, (request["parameters"] extends readonly import("viem").PrepareTransactionRequestParameterType[] ? request["parameters"][number] : "fees" | "type" | "gas" | "nonce" | "blobVersionedHashes" | "chainId") extends infer T_13 ? T_13 extends (request["parameters"] extends readonly import("viem").PrepareTransactionRequestParameterType[] ? request["parameters"][number] : "fees" | "type" | "gas" | "nonce" | "blobVersionedHashes" | "chainId") ? T_13 extends "fees" ? "gasPrice" | "maxFeePerGas" | "maxPriorityFeePerGas" : T_13 : never : never> & (unknown extends request["kzg"] ? {} : Pick<request, "kzg">))[K]; } : never>;
+        }, (request["parameters"] extends readonly import("viem").PrepareTransactionRequestParameterType[] ? request["parameters"][number] : "fees" | "type" | "chainId" | "gas" | "nonce" | "blobVersionedHashes") extends infer T_13 ? T_13 extends (request["parameters"] extends readonly import("viem").PrepareTransactionRequestParameterType[] ? request["parameters"][number] : "fees" | "type" | "chainId" | "gas" | "nonce" | "blobVersionedHashes") ? T_13 extends "fees" ? "gasPrice" | "maxFeePerGas" | "maxPriorityFeePerGas" : T_13 : never : never> & (unknown extends request["kzg"] ? {} : Pick<request, "kzg">))[K]; } : never>;
         readContract: <const abi extends import("viem").Abi | readonly unknown[], functionName extends import("viem").ContractFunctionName<abi, "pure" | "view">, const args extends import("viem").ContractFunctionArgs<abi, "pure" | "view", functionName>>(args: import("viem").ReadContractParameters<abi, functionName, args>) => Promise<import("viem").ReadContractReturnType<abi, functionName, args>>;
         sendRawTransaction: (args: import("viem").SendRawTransactionParameters) => Promise<import("viem").SendRawTransactionReturnType>;
         simulate: <const calls extends readonly unknown[]>(args: import("viem").SimulateBlocksParameters<calls>) => Promise<import("viem").SimulateBlocksReturnType<calls>>;

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

@@ -0,0 +1,81 @@
+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[];
+    getWalletConnectWallets(allWallets: 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;
+    }[];
+};
+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-ecf1794d555806e376ab2253b48ab2b185e85a10.0",
+  "version": "1.8.14-embedded-mode-fix.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-ecf1794d555806e376ab2253b48ab2b185e85a10.0",
-    "@reown/appkit-wallet": "1.8.14-ecf1794d555806e376ab2253b48ab2b185e85a10.0"
+    "@reown/appkit-common": "1.8.14-embedded-mode-fix.0",
+    "@reown/appkit-wallet": "1.8.14-embedded-mode-fix.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "2.1.9",