@reown/appkit-core 1.5.3 → 1.5.4-rc.2.0

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

@@ -46,5 +46,6 @@ export { StorageUtil } from '../src/utils/StorageUtil.js';
 export { RouterUtil } from '../src/utils/RouterUtil.js';
 export { OptionsUtil } from '../src/utils/OptionsUtil.js';
 export { SIWXUtil } from '../src/utils/SIWXUtil.js';
+export { FetchUtil } from '../src/utils/FetchUtil.js';
 export type * from '../src/utils/TypeUtil.js';
 export type * from '../src/utils/SIWXUtil.js';

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

@@ -1,7 +1,7 @@
 export declare function useAppKitAccount(): import("vue").Ref<{
     address: string | null;
     caipAddress: `eip155:${string}:${string}` | `solana:${string}:${string}` | `polkadot:${string}:${string}` | `bip122:${string}:${string}` | null;
-    status: "reconnecting" | "connected" | "disconnected" | "connecting" | null;
+    status: "connected" | "disconnected" | "connecting" | "reconnecting" | null;
     isConnected: boolean;
 }>;
 export declare function useDisconnect(): {

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

@@ -1,4 +1,4 @@
-import type { AccountType, CombinedProvider, ConnectedWalletInfo, Provider, SocialProvider } from '../utils/TypeUtil.js';
+import type { AccountType, AccountTypeMap, CombinedProvider, ConnectedWalletInfo, Provider, SocialProvider } from '../utils/TypeUtil.js';
 import type { CaipAddress, ChainNamespace } from '@reown/appkit-common';
 import type { Balance } from '@reown/appkit-common';
 import type { W3mFrameTypes } from '@reown/appkit-wallet';
@@ -43,7 +43,7 @@ export declare const AccountController: {
     setCurrentTab(currentTab: AccountControllerState['currentTab']): void;
     setTokenBalance(tokenBalance: AccountControllerState['tokenBalance'], chain: ChainNamespace | undefined): void;
     setShouldUpdateToAddress(address: string, chain: ChainNamespace | undefined): void;
-    setAllAccounts(accounts: AccountType[], chain: ChainNamespace | undefined): void;
+    setAllAccounts<N extends ChainNamespace>(accounts: AccountTypeMap[N][], namespace: N): void;
     addAddressLabel(address: string, label: string, chain: ChainNamespace | undefined): void;
     removeAddressLabel(address: string, chain: ChainNamespace | undefined): void;
     setConnectedWalletInfo(connectedWalletInfo: AccountControllerState['connectedWalletInfo'], chain: ChainNamespace): void;

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

@@ -15,7 +15,7 @@ export declare const ChainController: {
     subscribe(callback: (value: ChainControllerState) => void): () => void;
     subscribeKey<K extends keyof ChainControllerState>(key: K, callback: (value: ChainControllerState[K]) => void): () => void;
     subscribeChainProp<K_1 extends keyof ChainAdapter>(property: K_1, callback: (value: ChainAdapter[K_1] | undefined) => void, chain?: ChainNamespace): () => void;
-    initialize(adapters: ChainAdapter[]): void;
+    initialize(adapters: ChainAdapter[], caipNetworks: CaipNetwork[] | undefined): void;
     setAdapterNetworkState(chain: ChainNamespace, props: Partial<AdapterNetworkState>): void;
     setChainAccountData(chain: ChainNamespace | undefined, accountProps: Partial<AccountControllerState>, _unknown?: boolean): void;
     setAccountProp(prop: keyof AccountControllerState, value: AccountControllerState[keyof AccountControllerState], chain: ChainNamespace | undefined, replaceState?: boolean): void;

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

@@ -1,4 +1,4 @@
-import type { CustomWallet, Features, Metadata, ProjectId, SdkVersion, Tokens } from '../utils/TypeUtil.js';
+import type { ConnectMethod, CustomWallet, Features, Metadata, ProjectId, SdkVersion, SocialProvider, Tokens, WalletFeature } from '../utils/TypeUtil.js';
 import type { SIWXConfig } from '../utils/SIWXUtil.js';
 export interface OptionsControllerStatePublic {
     /**
@@ -88,6 +88,11 @@ export interface OptionsControllerStatePublic {
      * @default true
      */
     enableWalletConnect?: boolean;
+    /**
+     * Enable or disable the wallet guide footer in AppKit if you have email or social login configured.
+     * @default true
+     */
+    enableWalletGuide?: boolean;
     /**
      * Enable or disable debug mode in your AppKit. This is useful if you want to see UI alerts when debugging.
      * @default false
@@ -105,6 +110,11 @@ export interface OptionsControllerStatePublic {
      * @default undefined
      */
     siwx?: SIWXConfig;
+    /**
+     * Renders the AppKit to DOM instead of the default modal.
+     * @default false
+     */
+    enableEmbedded?: boolean;
 }
 export interface OptionsControllerStateInternal {
     sdkType: 'appkit';
@@ -137,8 +147,14 @@ export declare const OptionsController: {
     setEIP6963Enabled(enableEIP6963: OptionsControllerState['enableEIP6963']): void;
     setDebug(debug: OptionsControllerState['debug']): void;
     setEnableWalletConnect(enableWalletConnect: OptionsControllerState['enableWalletConnect']): void;
+    setEnableWalletGuide(enableWalletGuide: OptionsControllerState['enableWalletGuide']): void;
     setEnableWallets(enableWallets: OptionsControllerState['enableWallets']): void;
     setHasMultipleAddresses(hasMultipleAddresses: OptionsControllerState['hasMultipleAddresses']): void;
     setSIWX(siwx: OptionsControllerState['siwx']): void;
+    setConnectMethodsOrder(connectMethodsOrder: ConnectMethod[]): void;
+    setWalletFeaturesOrder(walletFeaturesOrder: WalletFeature[]): void;
+    setSocialsOrder(socialsOrder: SocialProvider[]): void;
+    setCollapseWallets(collapseWallets: boolean): void;
+    setEnableEmbedded(enableEmbedded: OptionsControllerState['enableEmbedded']): void;
 };
 export {};

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

@@ -24,7 +24,7 @@ type TransactionAction = {
     onCancel?: () => void;
 };
 export interface RouterControllerState {
-    view: 'Account' | 'AccountSettings' | 'AllWallets' | 'ApproveTransaction' | 'BuyInProgress' | 'WalletCompatibleNetworks' | 'ChooseAccountName' | 'Connect' | 'Create' | 'ConnectingExternal' | 'ConnectingFarcaster' | 'ConnectingWalletConnect' | 'ConnectingSiwe' | 'ConnectingSocial' | 'ConnectSocials' | 'ConnectWallets' | 'Downloads' | 'EmailVerifyOtp' | 'EmailVerifyDevice' | 'GetWallet' | 'Networks' | 'OnRampActivity' | 'OnRampFiatSelect' | 'OnRampProviders' | 'OnRampTokenSelect' | 'Profile' | 'RegisterAccountName' | 'RegisterAccountNameSuccess' | 'SwitchNetwork' | 'SwitchAddress' | 'Transactions' | 'UnsupportedChain' | 'UpdateEmailWallet' | 'UpdateEmailPrimaryOtp' | 'UpdateEmailSecondaryOtp' | 'UpgradeEmailWallet' | 'UpgradeToSmartAccount' | 'WalletReceive' | 'WalletSend' | 'WalletSendPreview' | 'WalletSendSelectToken' | 'WhatIsANetwork' | 'WhatIsAWallet' | 'WhatIsABuy' | 'Swap' | 'SwapSelectToken' | 'SwapPreview' | 'ConnectingMultiChain' | 'SwitchActiveChain' | 'SmartSessionCreated' | 'SmartSessionList' | 'SIWXSignMessage';
+    view: 'Account' | 'AccountSettings' | 'AllWallets' | 'ApproveTransaction' | 'BuyInProgress' | 'WalletCompatibleNetworks' | 'ChooseAccountName' | 'Connect' | 'Create' | 'ConnectingExternal' | 'ConnectingFarcaster' | 'ConnectingWalletConnect' | 'ConnectingSiwe' | 'ConnectingSocial' | 'ConnectSocials' | 'ConnectWallets' | 'Downloads' | 'EmailVerifyOtp' | 'EmailVerifyDevice' | 'GetWallet' | 'Networks' | 'OnRampActivity' | 'OnRampFiatSelect' | 'OnRampProviders' | 'OnRampTokenSelect' | 'Profile' | 'RegisterAccountName' | 'RegisterAccountNameSuccess' | 'SwitchNetwork' | 'SwitchAddress' | 'Transactions' | 'UnsupportedChain' | 'UpdateEmailWallet' | 'UpdateEmailPrimaryOtp' | 'UpdateEmailSecondaryOtp' | 'UpgradeEmailWallet' | 'WalletReceive' | 'WalletSend' | 'WalletSendPreview' | 'WalletSendSelectToken' | 'WhatIsANetwork' | 'WhatIsAWallet' | 'WhatIsABuy' | 'Swap' | 'SwapSelectToken' | 'SwapPreview' | 'ConnectingMultiChain' | 'SwitchActiveChain' | 'SmartSessionCreated' | 'SmartSessionList' | 'SIWXSignMessage';
     history: RouterControllerState['view'][];
     data?: {
         connector?: Connector;

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

@@ -6,18 +6,22 @@ export interface SnackControllerState {
         icon: string;
     };
     open: boolean;
+    autoClose: boolean;
 }
+export type SnackControllerShowOptions = {
+    autoClose?: boolean;
+    svg?: SnackControllerState['svg'];
+    variant?: SnackControllerState['variant'];
+};
 export declare const SnackController: {
     state: SnackControllerState;
     subscribeKey<K extends keyof SnackControllerState>(key: K, callback: (value: SnackControllerState[K]) => void): () => void;
-    showLoading(message: SnackControllerState['message']): void;
+    showLoading(message: SnackControllerState['message'], options?: SnackControllerShowOptions): void;
     showSuccess(message: SnackControllerState['message']): void;
     showSvg(message: SnackControllerState['message'], svg: NonNullable<SnackControllerState['svg']>): void;
     showError(message: unknown): void;
     hide(): void;
-    _showMessage({ message, svg, variant }: {
-        message: SnackControllerState['message'];
-        svg?: SnackControllerState['svg'];
-        variant?: "error" | "success" | "loading" | undefined;
-    }): void;
+    _showMessage({ message, svg, variant, autoClose }: {
+        message: string;
+    } & SnackControllerShowOptions): void;
 };

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

@@ -20,6 +20,7 @@ export declare const ThemeController: {
             readonly '--w3m-font-size-master'?: string | undefined;
             readonly '--w3m-border-radius-master'?: string | undefined;
             readonly '--w3m-z-index'?: number | undefined;
+            readonly '--w3m-qr-color'?: string | undefined;
         };
         readonly w3mThemeVariables: {
             readonly '--w3m-accent': string;

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

@@ -1,4 +1,4 @@
-import type { Features } from './TypeUtil.js';
+import type { SocialProvider } from './TypeUtil.js';
 import type { ChainNamespace } from '@reown/appkit-common';
 export declare const ONRAMP_PROVIDERS: {
     label: string;
@@ -49,5 +49,21 @@ export declare const ConstantsUtil: {
     CONNECT_LABELS: {
         MOBILE: string;
     };
-    DEFAULT_FEATURES: Features;
+    DEFAULT_FEATURES: {
+        swaps: true;
+        onramp: true;
+        receive: true;
+        send: true;
+        email: true;
+        emailShowWallets: true;
+        socials: SocialProvider[];
+        history: true;
+        analytics: true;
+        allWallets: true;
+        legalCheckbox: false;
+        smartSessions: false;
+        collapseWallets: false;
+        connectMethodsOrder: ("email" | "social" | "wallet")[];
+        walletFeaturesOrder: ("swaps" | "send" | "receive" | "onramp")[];
+    };
 };

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

@@ -1,7 +1,8 @@
 import type { AppKitSdkVersion, Balance, ChainNamespace } from '@reown/appkit-common';
 import type { CaipAddress, CaipNetwork } from '@reown/appkit-common';
-import type { ChainAdapter, LinkingRecord } from './TypeUtil.js';
+import type { AccountTypeMap, ChainAdapter, LinkingRecord, NamespaceTypeMap } from './TypeUtil.js';
 type SDKFramework = 'html' | 'react' | 'vue';
+type OpenTarget = '_blank' | '_self' | 'popupWindow' | '_top';
 export declare const CoreHelperUtil: {
     isMobile(): boolean;
     checkCaipNetwork(network: CaipNetwork | undefined, networkName?: string): boolean | undefined;
@@ -11,6 +12,7 @@ export declare const CoreHelperUtil: {
     isPairingExpired(expiry?: number): boolean;
     isAllowedRetry(lastRetry: number, differenceMs?: number): boolean;
     copyToClopboard(text: string): void;
+    isIframe(): boolean;
     getPairingExpiry(): number;
     getNetworkId(caipAddress: CaipAddress | undefined): string | undefined;
     getPlainAddress(caipAddress: CaipAddress | undefined): string | undefined;
@@ -20,8 +22,8 @@ export declare const CoreHelperUtil: {
     formatNativeUrl(appUrl: string, wcUri: string): LinkingRecord;
     formatUniversalUrl(appUrl: string, wcUri: string): LinkingRecord;
     getOpenTargetForPlatform(target: string): string;
-    openHref(href: string, target: '_blank' | '_self' | 'popupWindow', features?: string): void;
-    returnOpenHref(href: string, target: '_blank' | '_self' | 'popupWindow', features?: string): Window | null;
+    openHref(href: string, target: OpenTarget, features?: string): void;
+    returnOpenHref(href: string, target: OpenTarget, features?: string): Window | null;
     isTelegram(): boolean;
     preloadImage(src: string): Promise<unknown>;
     formatBalance(balance: string | undefined, symbol: string | undefined): string;
@@ -44,5 +46,6 @@ export declare const CoreHelperUtil: {
     isAddress(address: string, chain?: ChainNamespace): boolean;
     uniqueBy<T>(arr: T[], key: keyof T): T[];
     generateSdkVersion(adapters: ChainAdapter[], platform: SDKFramework, version: string): AppKitSdkVersion;
+    createAccount<N extends ChainNamespace>(namespace: N, address: string, type: NamespaceTypeMap[N]): AccountTypeMap[N];
 };
 export {};

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

@@ -1,4 +1,4 @@
 import type { Features, FeaturesKeys } from './TypeUtil.js';
 export declare const OptionsUtil: {
-    getFeatureValue(key: FeaturesKeys, features?: Features): boolean | import("./TypeUtil.js").FeaturesSocials[] | undefined;
+    getFeatureValue(key: FeaturesKeys, features?: Features): boolean | import("./TypeUtil.js").SocialProvider[] | import("./TypeUtil.js").ConnectMethod[] | import("./TypeUtil.js").WalletFeature[] | undefined;
 };

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

@@ -1,21 +1,31 @@
-import { type ChainNamespace } from '@reown/appkit-common';
+import { type CaipNetworkId, type ChainNamespace } from '@reown/appkit-common';
 import type { WcWallet, ConnectorType, SocialProvider, ConnectionStatus } from './TypeUtil.js';
 export declare const StorageUtil: {
+    getActiveNetworkProps(): {
+        namespace: ChainNamespace | undefined;
+        caipNetworkId: string | undefined;
+        chainId: string | undefined;
+    };
     setWalletConnectDeepLink({ name, href }: {
         href: string;
         name: string;
     }): void;
     getWalletConnectDeepLink(): any;
     deleteWalletConnectDeepLink(): void;
+    setActiveNamespace(namespace: ChainNamespace): void;
+    setActiveCaipNetworkId(caipNetworkId: CaipNetworkId): void;
+    getActiveCaipNetworkId(): string | undefined;
+    deleteActiveCaipNetworkId(): void;
+    deleteConnectedConnector(): void;
     setAppKitRecent(wallet: WcWallet): void;
     getRecentWallets(): WcWallet[];
     setConnectedConnector(connectorType: ConnectorType): void;
-    setConnectedNamespace(namespace: ChainNamespace): void;
+    getActiveNamespace(): ChainNamespace | undefined;
     getConnectedConnector(): ConnectorType | undefined;
     setConnectedSocialProvider(socialProvider: SocialProvider): void;
     getConnectedSocialProvider(): string | undefined;
     getConnectedSocialUsername(): string | undefined;
-    getStoredActiveCaipNetwork(): import("@reown/appkit-common").CaipNetwork | undefined;
+    getStoredActiveCaipNetworkId(): string | undefined;
     setConnectionStatus(status: ConnectionStatus): void;
     getConnectionStatus(): ConnectionStatus | undefined;
 };

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

@@ -6,6 +6,28 @@ import type { OnRampProviderOption } from '../controllers/OnRampController.js';
 import type { ConstantsUtil } from './ConstantsUtil.js';
 import type { ReownName } from '../controllers/EnsController.js';
 import type UniversalProvider from '@walletconnect/universal-provider';
+type InitializeAppKitConfigs = {
+    showWallets?: boolean;
+    siweConfig?: {
+        options: {
+            enabled?: boolean;
+            nonceRefetchIntervalMs?: number;
+            sessionRefetchIntervalMs?: number;
+            signOutOnDisconnect?: boolean;
+            signOutOnAccountChange?: boolean;
+            signOutOnNetworkChange?: boolean;
+        };
+    };
+    themeMode?: 'dark' | 'light';
+    themeVariables?: ThemeVariables;
+    allowUnsupportedChain?: boolean;
+    networks: (string | number)[];
+    defaultNetwork?: AppKitNetwork;
+    chainImages?: Record<number | string, string>;
+    connectorImages?: Record<string, string>;
+    coinbasePreference?: 'all' | 'smartWalletOnly' | 'eoaOnly';
+    metadata?: Metadata;
+};
 export type CaipNetworkCoinbaseNetwork = 'Ethereum' | 'Arbitrum One' | 'Polygon' | 'Avalanche' | 'OP Mainnet' | 'Celo';
 export type ConnectedWalletInfo = {
     name?: string;
@@ -102,6 +124,7 @@ export interface ThemeVariables {
     '--w3m-font-size-master'?: string;
     '--w3m-border-radius-master'?: string;
     '--w3m-z-index'?: number;
+    '--w3m-qr-color'?: string;
 }
 export interface BlockchainApiIdentityRequest {
     address: string;
@@ -406,6 +429,9 @@ export type Event = {
 } | {
     type: 'track';
     event: 'EMAIL_VERIFICATION_CODE_FAIL';
+    properties: {
+        message: string;
+    };
 } | {
     type: 'track';
     event: 'EMAIL_EDIT';
@@ -494,6 +520,18 @@ export type Event = {
         swapToAmount: string;
         message: string;
     };
+} | {
+    type: 'track';
+    event: 'SWAP_APPROVAL_ERROR';
+    properties: {
+        isSmartAccount: boolean;
+        network: string;
+        swapFromToken: string;
+        swapToToken: string;
+        swapFromAmount: string;
+        swapToAmount: string;
+        message: string;
+    };
 } | {
     type: 'track';
     event: 'SOCIAL_LOGIN_STARTED';
@@ -602,6 +640,10 @@ export type Event = {
         badge: string;
         search: string;
     };
+} | {
+    type: 'track';
+    event: 'INITIALIZE';
+    properties: InitializeAppKitConfigs;
 };
 export type DestinationWallet = {
     address: string;
@@ -654,10 +696,20 @@ export type GetQuoteArgs = {
     amount: string;
     network: string;
 };
-export type AccountType = {
-    address: string;
-    type: 'eoa' | 'smartAccount';
+export type NamespaceTypeMap = {
+    eip155: 'eoa' | 'smartAccount';
+    solana: 'eoa';
+    bip122: 'payment' | 'ordinal' | 'stx';
+    polkadot: 'eoa';
+};
+export type AccountTypeMap = {
+    [K in ChainNamespace]: {
+        namespace: K;
+        address: string;
+        type: NamespaceTypeMap[K];
+    };
 };
+export type AccountType = AccountTypeMap[ChainNamespace];
 export type SendTransactionArgs = {
     chainNamespace?: undefined | 'eip155';
     to: `0x${string}`;
@@ -764,7 +816,8 @@ export interface Provider {
 }
 export type CombinedProvider = W3mFrameProvider & Provider;
 export type CoinbasePaySDKChainNameValues = keyof typeof ConstantsUtil.WC_COINBASE_PAY_SDK_CHAIN_NAME_MAP;
-export type FeaturesSocials = 'google' | 'x' | 'discord' | 'farcaster' | 'github' | 'apple' | 'facebook';
+export type WalletFeature = 'swaps' | 'send' | 'receive' | 'onramp';
+export type ConnectMethod = 'email' | 'social' | 'wallet';
 export type Features = {
     /**
      * @description Enable or disable the swaps feature. Enabled by default.
@@ -776,6 +829,17 @@ export type Features = {
      * @type {boolean}
      */
     onramp?: boolean;
+    /**
+     * @description Enable or disable the receive feature. Enabled by default.
+     * This feature is only visible when connected with email/social. It's not possible to configure when connected with wallet, which is enabled by default.
+     * @type {boolean}
+     */
+    receive?: boolean;
+    /**
+     * @description Enable or disable the send feature. Enabled by default.
+     * @type {boolean}
+     */
+    send?: boolean;
     /**
      * @description Enable or disable the email feature. Enabled by default.
      * @type {boolean}
@@ -783,14 +847,15 @@ export type Features = {
     email?: boolean;
     /**
      * @description Show or hide the regular wallet options when email is enabled. Enabled by default.
+     * @deprecated - This property will be removed in the next major release. Please use `features.collapseWallets` instead.
      * @type {boolean}
      */
     emailShowWallets?: boolean;
     /**
      * @description Enable or disable the socials feature. Enabled by default.
-     * @type {FeaturesSocials[]}
+     * @type {SocialProvider[]}
      */
-    socials?: FeaturesSocials[] | false;
+    socials?: SocialProvider[] | false;
     /**
      * @description Enable or disable the history feature. Enabled by default.
      * @type {boolean}
@@ -816,6 +881,25 @@ export type Features = {
      * @default false
      */
     legalCheckbox?: boolean;
+    /**
+     * @description The order of the connect methods. This is experimental and subject to change.
+     * @default ['email', 'social', 'wallet']
+     * @type {('email' | 'social' | 'wallet')[]}
+     */
+    connectMethodsOrder?: ConnectMethod[];
+    /**
+     * @
+     * @description The order of the wallet features. This is experimental and subject to change.
+     * @default ['receive' | 'onramp' | 'swaps' | 'send']
+     * @type {('receive' | 'onramp' | 'swaps' | 'send')[]}
+     */
+    walletFeaturesOrder?: WalletFeature[];
+    /**
+     * @description Enable or disable the collapse wallets as a single "Continue with wallet" button for simple UI in connect page.
+     * This can be activated when only have another connect method like email or social activated along with wallets.
+     * @default false
+     */
+    collapseWallets?: boolean;
 };
 export type FeaturesKeys = keyof Features;
 export type WalletGuideType = 'get-started' | 'explore';
@@ -833,3 +917,4 @@ export type UseAppKitNetworkReturn = {
 };
 export type BadgeType = 'none' | 'certified';
 export type ConnectionStatus = 'connected' | 'disconnected' | 'connecting' | 'reconnecting';
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reown/appkit-core",
-  "version": "1.5.3",
+  "version": "1.5.4-rc.2.0",
   "type": "module",
   "main": "./dist/esm/exports/index.js",
   "types": "./dist/types/exports/index.d.ts",
@@ -39,8 +39,8 @@
     "@walletconnect/universal-provider": "2.17.0",
     "valtio": "1.11.2",
     "viem": "2.x",
-    "@reown/appkit-common": "1.5.3",
-    "@reown/appkit-wallet": "1.5.3"
+    "@reown/appkit-common": "1.5.4-rc.2.0",
+    "@reown/appkit-wallet": "1.5.4-rc.2.0"
   },
   "peerDependencies": {},
   "devDependencies": {