@reown/appkit-controllers 1.8.14-bc4a961b448cedd0a8485a2188549b413b4e6512.0 → 1.8.14-e330f62532f95683ed69bdb0f4fef77f3039df30.0

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

@@ -19,7 +19,7 @@ export type { ConnectionControllerClient, ConnectionControllerState } from '../s
 export type { ConnectExternalOptions } from '../src/controllers/ConnectionController.js';
 export { ConnectorController } from '../src/controllers/ConnectorController.js';
 export { ConnectorControllerUtil } from '../src/utils/ConnectorControllerUtil.js';
-export type { ConnectorControllerState, ConnectorWithProviders } from '../src/controllers/ConnectorController.js';
+export type { ConnectorControllerState } from '../src/controllers/ConnectorController.js';
 export { SnackController } from '../src/controllers/SnackController.js';
 export type { SnackControllerState } from '../src/controllers/SnackController.js';
 export { ApiController } from '../src/controllers/ApiController.js';
@@ -69,5 +69,6 @@ export type { Exchange, GetExchangesParams, PayUrlParams, PaymentAsset, CurrentP
 export { FetchUtil } from '../src/utils/FetchUtil.js';
 export type * from '../src/utils/TypeUtil.js';
 export type * from '../src/utils/SIWXUtil.js';
+export type { WalletItem } from '../src/utils/ConnectUtil.js';
 export * from '../src/utils/ChainControllerUtil.js';
 export * from '../src/utils/WalletConnectUtil.js';

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

@@ -1,4 +1,5 @@
 import { type ChainNamespace, type Connection } from '@reown/appkit-common';
+import { type WalletItem } from '../src/utils/ConnectUtil.js';
 import type { UseAppKitAccountReturn, UseAppKitNetworkReturn } from '../src/utils/TypeUtil.js';
 export type { Connection } from '@reown/appkit-common';
 interface DisconnectParams {
@@ -75,3 +76,55 @@ export declare function useAppKitConnection({ namespace, onSuccess, onError }: U
     switchConnection: ({ connection: _connection, address }: SwitchConnectionParams) => Promise<void>;
     deleteConnection: ({ address, connectorId }: DeleteRecentConnectionProps) => void;
 };
+export interface UseAppKitWalletsReturn {
+    /**
+     * List of all wallets (injected wallets and WalletConnect wallets combined)
+     */
+    data: WalletItem[];
+    /**
+     * Boolean that indicates if WalletConnect wallets are being fetched.
+     */
+    isFetchingWallets: boolean;
+    /**
+     * Boolean that indicates if a WalletConnect URI is being fetched.
+     */
+    isFetchingWcUri: boolean;
+    /**
+     * The current WalletConnect URI for QR code display.
+     * This is set when connecting to a WalletConnect wallet.
+     */
+    wcUri?: string;
+    /**
+     * The current page number.
+     */
+    page: number;
+    /**
+     * The total number of available wallets.
+     */
+    count: number;
+    /**
+     * Function to fetch WalletConnect wallets from the explorer API.
+     * This is useful for pagination or initial load.
+     * @param options - Options for fetching wallets
+     * @param options.page - Page number to fetch (default: 1)
+     */
+    fetchWallets: (options?: {
+        page?: number;
+        query?: string;
+    }) => 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
+     *
+     * @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>;
+}
+/**
+ * Headless hook for wallet connection.
+ * Provides all the data and functions needed to build a custom connect UI.
+ */
+export declare function useAppKitWallets(): UseAppKitWalletsReturn;

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

@@ -99,6 +99,7 @@ export interface ConnectionControllerState {
     };
     wcBasic?: boolean;
     wcError?: boolean;
+    wcFetchingUri: boolean;
     recentWallet?: WcWallet;
     buffering: boolean;
     status?: 'connecting' | 'connected' | 'disconnected';

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

@@ -1,8 +1,5 @@
 import { type ChainNamespace } from '@reown/appkit-common';
-import type { AuthConnector, Connector, WcWallet } from '../utils/TypeUtil.js';
-export interface ConnectorWithProviders extends Connector {
-    connectors?: Connector[];
-}
+import type { AuthConnector, Connector, ConnectorWithProviders, WcWallet } from '../utils/TypeUtil.js';
 export interface ConnectorControllerState {
     allConnectors: Connector[];
     connectors: ConnectorWithProviders[];
@@ -33,10 +30,9 @@ export declare const ConnectorController: {
     getAuthConnector(chainNamespace?: ChainNamespace): AuthConnector | undefined;
     getAnnouncedConnectorRdns(): (string | undefined)[];
     getConnectorById(id: string): Connector | undefined;
-    getConnector({ id, rdns, namespace }: {
-        id?: string;
-        rdns?: string | null;
-        namespace?: ChainNamespace;
+    getConnector({ id, namespace }: {
+        id: string;
+        namespace: ChainNamespace;
     }): Connector | undefined;
     syncIfAuthConnector(connector: Connector | AuthConnector): void;
     /**

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

@@ -85,6 +85,11 @@ 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
@@ -226,6 +231,7 @@ 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;
@@ -1629,6 +1635,12 @@ 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
@@ -1784,6 +1796,7 @@ export declare const OptionsController: {
             readonly payWithExchange?: boolean | undefined;
             readonly payments?: boolean | undefined;
             readonly onramp?: false | readonly "meld"[] | undefined;
+            readonly headless?: boolean | undefined;
         } | undefined;
     };
 };

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

@@ -13,4 +13,22 @@ export declare const AssetUtil: {
     getConnectorImage(connector?: Connector): string | undefined;
     getChainImage(chain: ChainNamespace): string | undefined;
     getTokenImage(symbol?: string): string | undefined;
+    /**
+     * Get the explorer wallet's image URL for the given image ID.
+     * @param imageId - The image id of the wallet.
+     * @returns The image URL for the wallet.
+     */
+    getWalletImageUrl(imageId: string | undefined): string;
+    /**
+     * Get the public asset's image URL with the given image ID.
+     * @param imageId - The image id of the asset.
+     * @returns The image URL for the asset.
+     */
+    getAssetImageUrl(imageId: string | undefined): string;
+    /**
+     * Get the image URL for the given chain namespace.
+     * @param chainNamespace - The chain namespace to get the image URL for.
+     * @returns The image URL for the chain namespace.
+     */
+    getChainNamespaceImageUrl(chainNamespace: ChainNamespace): string;
 };

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

@@ -0,0 +1,38 @@
+import type { ChainNamespace } from '@reown/appkit-common';
+import type { WcWallet } from './TypeUtil.js';
+export type WalletItem = {
+    id: string;
+    name: string;
+    imageUrl: string;
+    connectors: {
+        id: string;
+        rdns?: string;
+        chain: ChainNamespace;
+        chainImageUrl?: string;
+    }[];
+    walletInfo: {
+        description?: WcWallet['description'];
+        supportedChains?: WcWallet['chains'];
+        supportedNamespaces?: ChainNamespace[];
+        website?: WcWallet['homepage'];
+        installationLinks?: {
+            appStore?: WcWallet['app_store'];
+            playStore?: WcWallet['play_store'];
+            chromeStore?: WcWallet['chrome_store'];
+            desktopLink?: WcWallet['desktop_link'];
+        };
+        deepLink?: WcWallet['mobile_link'];
+        isCertified?: boolean;
+    };
+    isInjected: boolean;
+    isRecent: boolean;
+};
+export declare const ConnectUtil: {
+    /**
+     * Transforms connectors and wallets into a unified list of wallet items
+     */
+    getUnifiedWalletList(params: {
+        wcWallets: WcWallet[];
+        search: WcWallet[];
+    }): WalletItem[];
+};

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

@@ -58,6 +58,7 @@ export declare const ConstantsUtil: {
         payWithExchange: boolean;
         payments: boolean;
         reownAuthentication: boolean;
+        headless: boolean;
     };
     DEFAULT_REMOTE_FEATURES_DISABLED: {
         readonly email: false;
@@ -68,6 +69,7 @@ export declare const ConstantsUtil: {
         readonly reownBranding: false;
         readonly emailCapture: false;
         readonly reownAuthentication: false;
+        readonly headless: false;
     };
     DEFAULT_FEATURES: {
         receive: true;

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

@@ -71,6 +71,9 @@ export type Connector = {
     connectors?: Connector[];
     explorerWallet?: WcWallet;
 };
+export interface ConnectorWithProviders extends Connector {
+    connectors?: Connector[];
+}
 export interface AuthConnector extends Connector {
     provider: W3mFrameProvider;
     socials?: SocialProvider[];
@@ -95,6 +98,7 @@ export interface WcWallet {
     id: string;
     name: string;
     badge_type?: BadgeType;
+    description?: string;
     chains?: CaipNetworkId[];
     homepage?: string;
     image_id?: string;
@@ -1067,6 +1071,7 @@ export type RemoteFeatures = {
     payWithExchange?: boolean;
     payments?: boolean;
     onramp?: OnRampProvider[] | false;
+    headless?: boolean;
 };
 export type Features = {
     /**
@@ -1196,13 +1201,13 @@ export type ConnectionStatus = 'connected' | 'disconnected' | 'connecting' | 're
 export type PreferredAccountTypes = {
     [Key in keyof NamespaceTypeMap]?: NamespaceTypeMap[Key];
 };
-export type FeatureID = 'multi_wallet' | 'activity' | 'onramp' | 'swap' | 'social_login' | 'reown_branding' | 'email_capture' | 'fund_from_exchange' | 'payments' | 'reown_authentication';
+export type FeatureID = 'multi_wallet' | 'activity' | 'onramp' | 'swap' | 'social_login' | 'reown_branding' | 'email_capture' | 'fund_from_exchange' | 'payments' | 'reown_authentication' | 'headless';
 export interface BaseFeature<T extends FeatureID, C extends string[] | null> {
     id: T;
     isEnabled: boolean;
     config: C;
 }
-export type TypedFeatureConfig = BaseFeature<'activity', null | []> | BaseFeature<'onramp', OnRampProvider[]> | BaseFeature<'swap', SwapProvider[]> | BaseFeature<'social_login', (SocialProvider | 'email')[]> | BaseFeature<'reown_branding', null | []> | BaseFeature<'multi_wallet', null | []> | BaseFeature<'email_capture', EmailCaptureOptions[]>;
+export type TypedFeatureConfig = BaseFeature<'activity', null | []> | BaseFeature<'onramp', OnRampProvider[]> | BaseFeature<'swap', SwapProvider[]> | BaseFeature<'social_login', (SocialProvider | 'email')[]> | BaseFeature<'reown_branding', null | []> | BaseFeature<'multi_wallet', null | []> | BaseFeature<'email_capture', EmailCaptureOptions[]> | BaseFeature<'headless', null | []>;
 export type ApiGetProjectConfigResponse = {
     features: TypedFeatureConfig[];
 };
@@ -1278,6 +1283,12 @@ export type FeatureConfigMap = {
         returnType: boolean;
         isLegacy: false;
     };
+    headless: {
+        apiFeatureName: 'headless';
+        localFeatureName: 'headless';
+        returnType: boolean;
+        isLegacy: false;
+    };
 };
 export type FeatureKey = keyof FeatureConfigMap;
 export type Tier = 'none' | 'starter' | 'pro' | 'enteprise';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reown/appkit-controllers",
-  "version": "1.8.14-bc4a961b448cedd0a8485a2188549b413b4e6512.0",
+  "version": "1.8.14-e330f62532f95683ed69bdb0f4fef77f3039df30.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-bc4a961b448cedd0a8485a2188549b413b4e6512.0",
-    "@reown/appkit-wallet": "1.8.14-bc4a961b448cedd0a8485a2188549b413b4e6512.0"
+    "@reown/appkit-common": "1.8.14-e330f62532f95683ed69bdb0f4fef77f3039df30.0",
+    "@reown/appkit-wallet": "1.8.14-e330f62532f95683ed69bdb0f4fef77f3039df30.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "2.1.9",