@reown/appkit 1.8.20-perf-imp-3.0 → 1.8.20-prerelease-v2.0

package/dist/esm/exports/constants.js

@@ -1,2 +1,2 @@
-export const PACKAGE_VERSION = '1.8.20-perf-imp-3.0';
+export const PACKAGE_VERSION = '1.8.20-prerelease-v2.0';
 //# sourceMappingURL=constants.js.map

package/dist/esm/exports/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../exports/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,qBAAqB,CAAA"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../exports/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAA"}

package/dist/esm/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@reown/appkit",
-    "version": "1.8.20-perf-imp-3.0",
+    "version": "1.8.20-prerelease-v2.0",
     "type": "module",
     "main": "./dist/esm/exports/index.js",
     "types": "./dist/types/exports/index.d.ts",

package/dist/esm/src/auth-provider/W3MFrameProviderSingleton.js

@@ -1,29 +1,26 @@
 import { OptionsController } from '@reown/appkit-controllers';
+import { W3mFrameProvider } from '@reown/appkit-wallet';
 export class W3mFrameProviderSingleton {
     // eslint-disable-next-line @typescript-eslint/no-empty-function -- This is a singleton
     constructor() { }
-    static getInstance(config) {
-        if (!W3mFrameProviderSingleton.instancePromise) {
-            W3mFrameProviderSingleton.instancePromise = W3mFrameProviderSingleton.createInstance(config);
-        }
-        return W3mFrameProviderSingleton.instancePromise;
-    }
-    static async createInstance({ projectId, chainId, enableLogger, onTimeout, abortController, getActiveCaipNetwork, getCaipNetworks }) {
+    static getInstance({ projectId, chainId, enableLogger, onTimeout, abortController, getActiveCaipNetwork, getCaipNetworks }) {
         const { metadata, sdkVersion, sdkType } = OptionsController.getSnapshot();
-        const { W3mFrameProvider: Provider } = await import('@reown/appkit-wallet');
-        return new Provider({
-            projectId,
-            chainId,
-            enableLogger,
-            onTimeout,
-            abortController,
-            getActiveCaipNetwork,
-            getCaipNetworks,
-            enableCloudAuthAccount: Boolean(OptionsController.state.remoteFeatures?.emailCapture),
-            metadata: metadata,
-            sdkVersion: sdkVersion,
-            sdkType
-        });
+        if (!W3mFrameProviderSingleton.instance) {
+            W3mFrameProviderSingleton.instance = new W3mFrameProvider({
+                projectId,
+                chainId,
+                enableLogger,
+                onTimeout,
+                abortController,
+                getActiveCaipNetwork,
+                getCaipNetworks,
+                enableCloudAuthAccount: Boolean(OptionsController.state.remoteFeatures?.emailCapture),
+                metadata: metadata,
+                sdkVersion: sdkVersion,
+                sdkType
+            });
+        }
+        return W3mFrameProviderSingleton.instance;
     }
 }
 //# sourceMappingURL=W3MFrameProviderSingleton.js.map

package/dist/esm/src/auth-provider/W3MFrameProviderSingleton.js.map

@@ -1 +1 @@
-{"version":3,"file":"W3MFrameProviderSingleton.js","sourceRoot":"","sources":["../../../../src/auth-provider/W3MFrameProviderSingleton.ts"],"names":[],"mappings":"AAOA,OAAO,EAAiB,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAa5E,MAAM,OAAO,yBAAyB;IAGpC,uFAAuF;IACvF,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW,CAAC,MAA8B;QACtD,IAAI,CAAC,yBAAyB,CAAC,eAAe,EAAE,CAAC;YAC/C,yBAAyB,CAAC,eAAe,GAAG,yBAAyB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;QAC9F,CAAC;QAED,OAAO,yBAAyB,CAAC,eAAe,CAAA;IAClD,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,EAClC,SAAS,EACT,OAAO,EACP,YAAY,EACZ,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,eAAe,EACQ;QACvB,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAA;QACzE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAA;QAE3E,OAAO,IAAI,QAAQ,CAAC;YAClB,SAAS;YACT,OAAO;YACP,YAAY;YACZ,SAAS;YACT,eAAe;YACf,oBAAoB;YACpB,eAAe;YACf,sBAAsB,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,cAAc,EAAE,YAAY,CAAC;YACrF,QAAQ,EAAE,QAAoB;YAC9B,UAAU,EAAE,UAAwB;YACpC,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;CACF"}
+{"version":3,"file":"W3MFrameProviderSingleton.js","sourceRoot":"","sources":["../../../../src/auth-provider/W3MFrameProviderSingleton.ts"],"names":[],"mappings":"AAOA,OAAO,EAAiB,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAYvD,MAAM,OAAO,yBAAyB;IAGpC,uFAAuF;IACvF,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW,CAAC,EACxB,SAAS,EACT,OAAO,EACP,YAAY,EACZ,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,eAAe,EACQ;QACvB,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAA;QACzE,IAAI,CAAC,yBAAyB,CAAC,QAAQ,EAAE,CAAC;YACxC,yBAAyB,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC;gBACxD,SAAS;gBACT,OAAO;gBACP,YAAY;gBACZ,SAAS;gBACT,eAAe;gBACf,oBAAoB;gBACpB,eAAe;gBACf,sBAAsB,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,cAAc,EAAE,YAAY,CAAC;gBACrF,QAAQ,EAAE,QAAoB;gBAC9B,UAAU,EAAE,UAAwB;gBACpC,OAAO;aACR,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,yBAAyB,CAAC,QAAQ,CAAA;IAC3C,CAAC;CACF"}

package/dist/esm/src/client/appkit-base-client.js

@@ -1,19 +1,10 @@
 import UniversalProvider from '@walletconnect/universal-provider';
 import { ConstantsUtil, NetworkUtil, ParseUtil } from '@reown/appkit-common';
-import { AdapterController, AlertController, ApiController, AssetUtil, BlockchainApiController, ChainController, ConnectionController, ConnectionControllerUtil, ConnectorController, ConnectorUtil, ConstantsUtil as CoreConstantsUtil, CoreHelperUtil, EnsController, EventsController, ModalController, OnRampController, OptionsController, PerfLogger, ProviderController, PublicStateController, RouterController, SIWXUtil, SendController, SnackController, StorageUtil, ThemeController, WalletUtil, WcHelpersUtil, getPreferredAccountType } from '@reown/appkit-controllers';
-// SetColorTheme and setThemeVariables are lazily imported to avoid bundling UI utils in headless mode
+import { AdapterController, AlertController, ApiController, AssetUtil, BlockchainApiController, ChainController, ConnectionController, ConnectionControllerUtil, ConnectorController, ConnectorUtil, ConstantsUtil as CoreConstantsUtil, CoreHelperUtil, EnsController, EventsController, ModalController, OnRampController, OptionsController, ProviderController, PublicStateController, RouterController, SIWXUtil, SendController, SnackController, StorageUtil, ThemeController, WalletUtil, WcHelpersUtil, getPreferredAccountType } from '@reown/appkit-controllers';
+import { setColorTheme, setThemeVariables } from '@reown/appkit-ui';
 import { CaipNetworksUtil, ErrorUtil, HelpersUtil, LoggerUtil, TokenUtil, ConstantsUtil as UtilConstantsUtil } from '@reown/appkit-utils';
 import { UniversalAdapter } from '../universal-adapter/client.js';
 import { ConfigUtil } from '../utils/ConfigUtil.js';
-/**
- * Yields control to the main thread to prevent long tasks from blocking the UI.
- * Used during initialization to break up heavy synchronous work.
- */
-function yieldToMainThread() {
-    return new Promise(resolve => {
-        setTimeout(resolve, 0);
-    });
-}
 export class AppKitBaseClient {
     constructor(options) {
         this.chainNamespaces = [];
@@ -62,6 +53,13 @@ export class AppKitBaseClient {
         this.getProviderType = (namespace) => ProviderController.getProviderId(namespace);
         this.getPreferredAccountType = (namespace) => getPreferredAccountType(namespace);
         this.setCaipAddress = (caipAddress, chain, shouldRefresh = false) => {
+            if (caipAddress !== null) {
+                const parts = caipAddress.split(':');
+                if (parts.length !== 3 || parts.some(p => !p)) {
+                    console.warn(`[AppKit] setCaipAddress: invalid CAIP-10 address rejected: "${caipAddress}"`);
+                    return;
+                }
+            }
             ChainController.setAccountProp('caipAddress', caipAddress, chain, shouldRefresh);
             ChainController.setAccountProp('address', CoreHelperUtil.getPlainAddress(caipAddress), chain, shouldRefresh);
         };
@@ -211,19 +209,11 @@ export class AppKitBaseClient {
         return [...new Set(networkNamespaces)];
     }
     async initialize(options) {
-        PerfLogger.reset();
-        PerfLogger.mark('init:start');
         this.initializeProjectSettings(options);
-        PerfLogger.mark('init:projectSettings:done');
         this.initControllers(options);
-        PerfLogger.mark('init:controllers:done');
-        /*
-         * In headless mode, start wallet prefetch and config fetch early — they only need
-         * projectId + chains which are set by initControllers. Running them in parallel
-         * with adapter init saves ~200-500ms vs the previous sequential approach.
-         */
-        const isHeadless = options.features?.headless;
-        if (isHeadless && !ConnectorUtil.hasInjectedConnectors()) {
+        await this.initChainAdapters();
+        this.sendInitializeEvent(options);
+        if (options.features?.headless && !ConnectorUtil.hasInjectedConnectors()) {
             ApiController.prefetch({
                 fetchNetworkImages: false,
                 fetchConnectorImages: false,
@@ -231,42 +221,17 @@ export class AppKitBaseClient {
                 fetchRecommendedWallets: true
             });
         }
-        const remoteConfigPromise = isHeadless && !options.basic && !options.manualWCControl
-            ? ConfigUtil.fetchRemoteFeatures(options)
-            : null;
-        // Yield to main thread to avoid long tasks during initialization
-        await yieldToMainThread();
-        await PerfLogger.wrapAsync('init:chainAdapters', () => this.initChainAdapters());
-        await yieldToMainThread();
-        this.sendInitializeEvent(options);
         if (OptionsController.state.enableReconnect) {
-            await PerfLogger.wrapAsync('init:syncExistingConnection', () => this.syncExistingConnection());
-            await PerfLogger.wrapAsync('init:syncAdapterConnections', () => this.syncAdapterConnections());
+            await this.syncExistingConnection();
+            await this.syncAdapterConnections();
         }
         else {
-            await PerfLogger.wrapAsync('init:unSyncExistingConnection', () => this.unSyncExistingConnection());
+            await this.unSyncExistingConnection();
         }
         if (!options.basic && !options.manualWCControl) {
-            if (remoteConfigPromise) {
-                // In headless mode, config fetch started early (parallel with adapters) — just await it
-                ApiController.fetchUsage();
-                this.remoteFeatures = await remoteConfigPromise;
-            }
-            else if (isHeadless) {
-                ApiController.fetchUsage();
-                this.remoteFeatures = await PerfLogger.wrapAsync('init:fetchRemoteFeatures', () => ConfigUtil.fetchRemoteFeatures(options));
-            }
-            else {
-                const [remoteFeatures] = await Promise.all([
-                    PerfLogger.wrapAsync('init:fetchRemoteFeatures', () => ConfigUtil.fetchRemoteFeatures(options)),
-                    PerfLogger.wrapAsync('init:fetchUsage', () => ApiController.fetchUsage())
-                ]);
-                this.remoteFeatures = remoteFeatures;
-            }
-        }
-        else {
-            await PerfLogger.wrapAsync('init:fetchUsage', () => ApiController.fetchUsage());
+            this.remoteFeatures = await ConfigUtil.fetchRemoteFeatures(options);
         }
+        await ApiController.fetchUsage();
         OptionsController.setRemoteFeatures(this.remoteFeatures);
         if (this.remoteFeatures.onramp) {
             OnRampController.setOnrampProviders(this.remoteFeatures.onramp);
@@ -275,7 +240,7 @@ export class AppKitBaseClient {
         if (OptionsController.state.remoteFeatures?.email ||
             (Array.isArray(OptionsController.state.remoteFeatures?.socials) &&
                 OptionsController.state.remoteFeatures?.socials.length > 0)) {
-            await PerfLogger.wrapAsync('init:checkAllowedOrigins', () => this.checkAllowedOrigins());
+            await this.checkAllowedOrigins();
         }
         if (OptionsController.state.features?.reownAuthentication ||
             OptionsController.state.remoteFeatures?.reownAuthentication) {
@@ -289,8 +254,6 @@ export class AppKitBaseClient {
             }
             // If siwx is already configured for ReownAuthentication we keep the current instance
         }
-        PerfLogger.measure('init:total', 'init:start');
-        PerfLogger.summary('AppKit Base Init');
     }
     async openSend(args) {
         const namespaceToUse = args.namespace || ChainController.state.activeChain;
@@ -412,9 +375,7 @@ export class AppKitBaseClient {
     initControllers(options) {
         this.initializeOptionsController(options);
         this.initializeChainController(options);
-        if (!options.features?.headless) {
-            this.initializeThemeController(options);
-        }
+        this.initializeThemeController(options);
         this.initializeConnectionController(options);
         this.initializeConnectorController();
     }
@@ -458,6 +419,7 @@ export class AppKitBaseClient {
         OptionsController.setEnableWalletGuide(options.enableWalletGuide !== false);
         OptionsController.setEnableWallets(options.enableWallets !== false);
         OptionsController.setEIP6963Enabled(options.enableEIP6963 !== false);
+        OptionsController.setEnableInjected(options.enableInjected !== false);
         OptionsController.setEnableCoinbase(options.enableCoinbase !== false);
         OptionsController.setEnableNetworkSwitch(options.enableNetworkSwitch !== false);
         OptionsController.setEnableReconnect(options.enableReconnect !== false);
@@ -585,8 +547,6 @@ export class AppKitBaseClient {
     createClients() {
         this.connectionControllerClient = {
             connectWalletConnect: async () => {
-                // Ensure UniversalProvider is initialized (may have been deferred in headless mode)
-                await this.ensureUniversalProvider();
                 const activeChain = ChainController.state.activeChain;
                 const adapter = this.getAdapter(activeChain);
                 const chainId = this.getCaipNetwork(activeChain)?.id;
@@ -1035,29 +995,8 @@ export class AppKitBaseClient {
         if (!adapter) {
             throw new Error('adapter not found');
         }
-        await PerfLogger.wrapAsync(`init:adapter:${namespace}:syncConnectors`, async () => {
-            await adapter.syncConnectors();
-        });
-        /*
-         * In headless mode with no existing WC session, defer UniversalProvider init
-         * to avoid the expensive relay WebSocket connection during startup
-         */
-        const shouldDeferUp = this.options.features?.headless && !this.hasExistingWcConnection();
-        if (!shouldDeferUp) {
-            await PerfLogger.wrapAsync(`init:adapter:${namespace}:setUniversalProvider`, () => this.createUniversalProviderForAdapter(namespace));
-        }
-    }
-    hasExistingWcConnection() {
-        return this.chainNamespaces.some(ns => StorageUtil.getConnectedConnectorId(ns) === ConstantsUtil.CONNECTOR_ID.WALLET_CONNECT);
-    }
-    /**
-     * Ensures UniversalProvider is initialized for all adapters.
-     * Used when UP init was deferred in headless mode.
-     */
-    async ensureUniversalProvider() {
-        if (!this.universalProvider) {
-            await Promise.all(this.chainNamespaces.map(ns => this.createUniversalProviderForAdapter(ns)));
-        }
+        await adapter.syncConnectors();
+        await this.createUniversalProviderForAdapter(namespace);
     }
     async initChainAdapters() {
         await Promise.all(this.chainNamespaces.map(async (namespace) => {
@@ -1145,11 +1084,11 @@ export class AppKitBaseClient {
                     address,
                     chainId: syncAccountChainId,
                     chainNamespace
-                });
+                }).catch(() => null);
             }
             else if (!isActiveChain && syncAccountChainId) {
                 this.syncAccountInfo(address, syncAccountChainId, chainNamespace);
-                this.syncBalance({ address, chainId: syncAccountChainId, chainNamespace });
+                this.syncBalance({ address, chainId: syncAccountChainId, chainNamespace }).catch(() => null);
             }
             else {
                 this.syncAccountInfo(address, chainId, chainNamespace);
@@ -1189,7 +1128,7 @@ export class AppKitBaseClient {
     }
     // -- Connection Sync ---------------------------------------------------
     async syncExistingConnection() {
-        await Promise.allSettled(this.chainNamespaces.map(namespace => PerfLogger.wrapAsync(`init:syncNamespace:${namespace}`, () => this.syncNamespaceConnection(namespace))));
+        await Promise.allSettled(this.chainNamespaces.map(namespace => this.syncNamespaceConnection(namespace)));
     }
     async unSyncExistingConnection() {
         try {
@@ -1201,7 +1140,7 @@ export class AppKitBaseClient {
         }
     }
     async reconnectWalletConnect() {
-        await PerfLogger.wrapAsync('wc:syncWalletConnectAccount', () => this.syncWalletConnectAccount());
+        await this.syncWalletConnectAccount();
         const address = this.getAddress();
         if (!this.getCaipAddress()) {
             StorageUtil.deleteRecentWallet();
@@ -1265,11 +1204,9 @@ export class AppKitBaseClient {
             const adapter = this.getAdapter(namespace);
             const caipAddress = this.getCaipAddress(namespace);
             const caipNetwork = this.getCaipNetwork(namespace);
-            return PerfLogger.wrapAsync(`init:syncAdapterConn:${namespace}`, async () => {
-                await adapter?.syncConnections({
-                    connectToFirstConnector: !caipAddress,
-                    caipNetwork
-                });
+            return adapter?.syncConnections({
+                connectToFirstConnector: !caipAddress,
+                caipNetwork
             });
         }));
     }
@@ -1431,7 +1368,7 @@ export class AppKitBaseClient {
                 address,
                 chainId,
                 chainNamespace
-            });
+            }).catch(() => null);
         }
     }
     async syncAccountInfo(address, chainId, chainNamespace) {
@@ -1557,12 +1494,8 @@ export class AppKitBaseClient {
             logger
         };
         OptionsController.setManualWCControl(Boolean(this.options?.manualWCControl));
-        // Yield to main thread before heavy UniversalProvider initialization
-        await yieldToMainThread();
         this.universalProvider =
-            this.options.universalProvider ??
-                (await PerfLogger.wrapAsync('wc:UniversalProvider.init', () => UniversalProvider.init(universalProviderOptions)));
-        await yieldToMainThread();
+            this.options.universalProvider ?? (await UniversalProvider.init(universalProviderOptions));
         const originalDisconnect = this.universalProvider.disconnect.bind(this.universalProvider);
         this.universalProvider.disconnect = async () => {
             try {
@@ -1788,9 +1721,8 @@ export class AppKitBaseClient {
     getThemeVariables() {
         return ThemeController.state.themeVariables;
     }
-    async setThemeMode(themeMode) {
+    setThemeMode(themeMode) {
         ThemeController.setThemeMode(themeMode);
-        const { setColorTheme } = await import('@reown/appkit-ui');
         setColorTheme(ThemeController.state.themeMode);
     }
     setTermsConditionsUrl(termsConditionsUrl) {
@@ -1799,9 +1731,8 @@ export class AppKitBaseClient {
     setPrivacyPolicyUrl(privacyPolicyUrl) {
         OptionsController.setPrivacyPolicyUrl(privacyPolicyUrl);
     }
-    async setThemeVariables(themeVariables) {
+    setThemeVariables(themeVariables) {
         ThemeController.setThemeVariables(themeVariables);
-        const { setThemeVariables } = await import('@reown/appkit-ui');
         setThemeVariables(ThemeController.state.themeVariables);
     }
     subscribeTheme(callback) {
@@ -1830,15 +1761,17 @@ export class AppKitBaseClient {
         if (!namespace) {
             throw new Error('AppKit:getAccount - namespace is required');
         }
+        const fallbackCaipNetwork = ChainController.getActiveCaipNetwork(namespace);
         const allAccounts = connections.flatMap(connection => {
-            const { caipNetwork } = connection;
-            return caipNetwork
-                ? connection.accounts.map(({ address, type, publicKey }) => CoreHelperUtil.createAccount({
-                    caipAddress: `${caipNetwork.caipNetworkId}:${address}`,
-                    type: type || 'eoa',
-                    publicKey
-                }))
-                : [];
+            const caipNetwork = connection.caipNetwork ?? fallbackCaipNetwork;
+            if (!caipNetwork) {
+                return [];
+            }
+            return connection.accounts.map(({ address, type, publicKey }) => CoreHelperUtil.createAccount({
+                caipAddress: `${caipNetwork.caipNetworkId}:${address}`,
+                type: type || 'eoa',
+                publicKey
+            }));
         });
         if (!accountState) {
             return undefined;