@reown/appkit 1.8.21 → 1.8.22-headless-js.0

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

@@ -1 +1 @@
-export declare const PACKAGE_VERSION = "1.8.21";
+export declare const PACKAGE_VERSION = "1.8.22-headless-js.0";

package/dist/types/src/client/appkit-base-client.d.ts

@@ -1,7 +1,7 @@
 import type { SessionTypes } from '@walletconnect/types';
 import UniversalProvider from '@walletconnect/universal-provider';
 import type { AppKitNetwork, AppKitSdkVersion, CaipAddress, CaipNetwork, CaipNetworkId, ChainNamespace, SdkVersion } from '@reown/appkit-common';
-import type { AccountState, AdapterBlueprint, Adapters, ChainAdapterConnector, ConnectExternalOptions, ConnectMethod, ConnectedWalletInfo, ConnectionControllerClient, ConnectionControllerState, ConnectorType, EventsControllerState, Features, ModalControllerState, NamespaceTypeMap, OptionsControllerState, PublicStateControllerState, RemoteFeatures, RouterControllerState, SIWXConfig, SocialProvider, ThemeControllerState, UseAppKitAccountReturn, UseAppKitNetworkReturn, User, WalletFeature } from '@reown/appkit-controllers';
+import type { AccountState, AdapterBlueprint, Adapters, ChainAdapterConnector, ConnectExternalOptions, ConnectMethod, ConnectOptions, ConnectedWalletInfo, ConnectionControllerClient, ConnectionControllerState, ConnectorType, EventsControllerState, Features, FetchWalletsOptions, ModalControllerState, NamespaceTypeMap, OptionsControllerState, PublicStateControllerState, RemoteFeatures, RouterControllerState, SIWXConfig, SocialProvider, ThemeControllerState, UseAppKitAccountReturn, UseAppKitNetworkReturn, User, WalletFeature, WalletItem, WalletListSnapshot } from '@reown/appkit-controllers';
 import { AssetUtil, BlockchainApiController, ChainController, ConnectionController, ConnectorController, EnsController, OptionsController, type ProviderControllerState, StorageUtil } from '@reown/appkit-controllers';
 import type { AppKitOptions } from '../utils/index.js';
 export interface AppKitOptionsWithSdk extends AppKitOptions {
@@ -173,6 +173,25 @@ export declare abstract class AppKitBaseClient {
     close(): Promise<void>;
     setLoading(loading: ModalControllerState['loading'], namespace?: ChainNamespace): void;
     disconnect(chainNamespace?: ChainNamespace): Promise<void>;
+    /**
+     * Fetch / search / paginate the WalletConnect wallet list (WalletGuide explorer). Read
+     * the results with {@link getWalletList}; subscribe with {@link subscribeWalletList}.
+     */
+    fetchWallets(options?: FetchWalletsOptions): Promise<void>;
+    /** The current headless wallet list (initial view + WalletConnect list + pagination). */
+    getWalletList(): WalletListSnapshot;
+    /** Subscribe to wallet-list changes. Returns an unsubscribe. */
+    subscribeWalletList(callback: () => void): () => void;
+    /**
+     * Pre-fetch the WalletConnect URI (read from {@link getState} / `subscribeConnections`).
+     * Call when a wallet is selected so a later connect can deeplink synchronously (iOS).
+     */
+    getWalletConnectUri(options?: ConnectOptions): Promise<void>;
+    /**
+     * Connect a chosen wallet programmatically (headless — no modal). Handles injected,
+     * API ("all wallets"), and mobile-deeplink wallets.
+     */
+    connectWallet(wallet: WalletItem, namespace?: ChainNamespace, options?: ConnectOptions): Promise<void>;
     getSIWX<SIWXConfigInterface = SIWXConfig>(): SIWXConfigInterface | undefined;
     getError(): string;
     getChainId(): string | number | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reown/appkit",
-  "version": "1.8.21",
+  "version": "1.8.22-headless-js.0",
   "type": "module",
   "main": "./dist/esm/exports/index.js",
   "types": "./dist/types/exports/index.d.ts",
@@ -108,14 +108,14 @@
     "semver": "7.7.2",
     "valtio": "2.1.7",
     "viem": ">=2.45.0",
-    "@reown/appkit-common": "1.8.21",
-    "@reown/appkit-controllers": "1.8.21",
-    "@reown/appkit-pay": "1.8.21",
-    "@reown/appkit-polyfills": "1.8.21",
-    "@reown/appkit-scaffold-ui": "1.8.21",
-    "@reown/appkit-ui": "1.8.21",
-    "@reown/appkit-utils": "1.8.21",
-    "@reown/appkit-wallet": "1.8.21"
+    "@reown/appkit-common": "1.8.22-headless-js.0",
+    "@reown/appkit-controllers": "1.8.22-headless-js.0",
+    "@reown/appkit-pay": "1.8.22-headless-js.0",
+    "@reown/appkit-polyfills": "1.8.22-headless-js.0",
+    "@reown/appkit-scaffold-ui": "1.8.22-headless-js.0",
+    "@reown/appkit-ui": "1.8.22-headless-js.0",
+    "@reown/appkit-utils": "1.8.22-headless-js.0",
+    "@reown/appkit-wallet": "1.8.22-headless-js.0"
   },
   "devDependencies": {
     "@walletconnect/types": "2.23.7",
@@ -129,7 +129,7 @@
     "react-dom": "19.1.2",
     "vitest": "3.1.3",
     "vue": "3.x",
-    "@reown/appkit-siwe": "1.8.21"
+    "@reown/appkit-siwe": "1.8.22-headless-js.0"
   },
   "optionalDependencies": {
     "@lit/react": "1.0.8"