@reown/appkit-core 1.6.8 → 1.6.9-rc.1.0

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

@@ -12,6 +12,7 @@ export interface ContractWriteParams {
     decimals: string;
 }
 export interface SendControllerState {
+    tokenBalances: Balance[];
     token?: Balance;
     sendTokenAmount?: number;
     receiverAddress?: string;
@@ -21,23 +22,26 @@ export interface SendControllerState {
     gasPriceInUSD?: number;
     networkBalanceInUSD?: string;
     loading: boolean;
+    lastRetry?: number;
 }
+type StateKey = keyof SendControllerState;
 export declare const SendController: {
     state: SendControllerState;
     subscribe(callback: (newState: SendControllerState) => void): () => void;
-    subscribeKey<K extends keyof SendControllerState>(key: K, callback: (value: SendControllerState[K]) => void): () => void;
-    setToken(token: SendControllerState['token']): void;
-    setTokenAmount(sendTokenAmount: SendControllerState['sendTokenAmount']): void;
-    setReceiverAddress(receiverAddress: SendControllerState['receiverAddress']): void;
-    setReceiverProfileImageUrl(receiverProfileImageUrl: SendControllerState['receiverProfileImageUrl']): void;
-    setReceiverProfileName(receiverProfileName: SendControllerState['receiverProfileName']): void;
-    setGasPrice(gasPrice: SendControllerState['gasPrice']): void;
-    setGasPriceInUsd(gasPriceInUSD: SendControllerState['gasPriceInUSD']): void;
-    setNetworkBalanceInUsd(networkBalanceInUSD: SendControllerState['networkBalanceInUSD']): void;
-    setLoading(loading: SendControllerState['loading']): void;
+    subscribeKey<K extends StateKey>(key: K, callback: (value: SendControllerState[K]) => void): () => void;
+    setToken(token: SendControllerState["token"]): void;
+    setTokenAmount(sendTokenAmount: SendControllerState["sendTokenAmount"]): void;
+    setReceiverAddress(receiverAddress: SendControllerState["receiverAddress"]): void;
+    setReceiverProfileImageUrl(receiverProfileImageUrl: SendControllerState["receiverProfileImageUrl"]): void;
+    setReceiverProfileName(receiverProfileName: SendControllerState["receiverProfileName"]): void;
+    setGasPrice(gasPrice: SendControllerState["gasPrice"]): void;
+    setGasPriceInUsd(gasPriceInUSD: SendControllerState["gasPriceInUSD"]): void;
+    setNetworkBalanceInUsd(networkBalanceInUSD: SendControllerState["networkBalanceInUSD"]): void;
+    setLoading(loading: SendControllerState["loading"]): void;
     sendToken(): void;
     sendEvmToken(): void;
-    fetchNetworkBalance(): Promise<void>;
+    fetchTokenBalance(onError?: (error: unknown) => void): Promise<Balance[]>;
+    fetchNetworkBalance(): void;
     isInsufficientNetworkTokenForGas(networkBalanceInUSD: string, gasPriceInUSD: number | undefined): boolean;
     hasInsufficientGasFunds(): boolean;
     sendNativeToken(params: TxParams): Promise<void>;
@@ -45,3 +49,4 @@ export declare const SendController: {
     sendSolanaToken(): void;
     resetSend(): void;
 };
+export {};

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

@@ -13,15 +13,17 @@ export type SnackControllerShowOptions = {
     svg?: SnackControllerState['svg'];
     variant?: SnackControllerState['variant'];
 };
+type StateKey = keyof SnackControllerState;
 export declare const SnackController: {
     state: SnackControllerState;
-    subscribeKey<K extends keyof SnackControllerState>(key: K, callback: (value: SnackControllerState[K]) => void): () => void;
-    showLoading(message: SnackControllerState['message'], options?: SnackControllerShowOptions): void;
-    showSuccess(message: SnackControllerState['message']): void;
-    showSvg(message: SnackControllerState['message'], svg: NonNullable<SnackControllerState['svg']>): void;
+    subscribeKey<K extends StateKey>(key: K, callback: (value: SnackControllerState[K]) => void): () => 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, autoClose }: {
         message: string;
     } & SnackControllerShowOptions): void;
 };
+export {};

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

@@ -56,10 +56,11 @@ export interface TokenInfo {
     isFoT?: boolean;
     tags?: string[];
 }
+type StateKey = keyof SwapControllerState;
 export declare const SwapController: {
     state: SwapControllerState;
     subscribe(callback: (newState: SwapControllerState) => void): () => void;
-    subscribeKey<K extends keyof SwapControllerState>(key: K, callback: (value: SwapControllerState[K]) => void): () => void;
+    subscribeKey<K extends StateKey>(key: K, callback: (value: SwapControllerState[K]) => void): () => void;
     getParams(): {
         networkAddress: string;
         fromAddress: string;

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

@@ -8,8 +8,8 @@ export interface ThemeControllerState {
 export declare const ThemeController: {
     state: ThemeControllerState;
     subscribe(callback: (newState: ThemeControllerState) => void): () => void;
-    setThemeMode(themeMode: ThemeControllerState['themeMode']): void;
-    setThemeVariables(themeVariables: ThemeControllerState['themeVariables']): void;
+    setThemeMode(themeMode: ThemeControllerState["themeMode"]): void;
+    setThemeVariables(themeVariables: ThemeControllerState["themeVariables"]): void;
     getSnapshot(): {
         readonly themeMode: ThemeMode;
         readonly themeVariables: {

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

@@ -10,14 +10,15 @@ export interface TooltipControllerState {
     open: boolean;
     variant: 'shade' | 'fill';
 }
+type StateKey = keyof TooltipControllerState;
 export declare const TooltipController: {
     state: TooltipControllerState;
     subscribe(callback: (newState: TooltipControllerState) => void): () => void;
-    subscribeKey<K extends keyof TooltipControllerState>(key: K, callback: (value: TooltipControllerState[K]) => void): () => void;
+    subscribeKey<K extends StateKey>(key: K, callback: (value: TooltipControllerState[K]) => void): () => void;
     showTooltip({ message, triggerRect, variant }: {
         message: string;
         triggerRect: TriggerRect;
-        variant: 'shade' | 'fill';
+        variant: "shade" | "fill";
     }): void;
     hide(): void;
 };

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

@@ -14,8 +14,8 @@ export interface TransactionsControllerState {
 export declare const TransactionsController: {
     state: TransactionsControllerState;
     subscribe(callback: (newState: TransactionsControllerState) => void): () => void;
-    setLastNetworkInView(lastNetworkInView: TransactionsControllerState['lastNetworkInView']): void;
-    fetchTransactions(accountAddress?: string, onramp?: 'coinbase'): Promise<void>;
+    setLastNetworkInView(lastNetworkInView: TransactionsControllerState["lastNetworkInView"]): void;
+    fetchTransactions(accountAddress?: string, onramp?: "coinbase"): Promise<void>;
     groupTransactionsByYearAndMonth(transactionsMap?: TransactionByYearMap, transactions?: Transaction[]): TransactionByYearMap;
     filterSpamTransactions(transactions: Transaction[]): Transaction[];
     filterByConnectedChain(transactions: Transaction[]): Transaction[];

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

@@ -22,7 +22,7 @@ export declare const CoreHelperUtil: {
     isHttpUrl(url: string): boolean;
     formatNativeUrl(appUrl: string, wcUri: string): LinkingRecord;
     formatUniversalUrl(appUrl: string, wcUri: string): LinkingRecord;
-    getOpenTargetForPlatform(target: string): string;
+    getOpenTargetForPlatform(target: OpenTarget): "_blank" | "_self" | "popupWindow" | "_top";
     openHref(href: string, target: OpenTarget, features?: string): void;
     returnOpenHref(href: string, target: OpenTarget, features?: string): Window | null;
     isTelegram(): boolean;
@@ -48,6 +48,9 @@ export declare const CoreHelperUtil: {
     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], publicKey?: string, path?: string): AccountTypeMap[N];
-    isCaipAddress(address?: unknown): address is `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `bip122:${string}:${string}` | `bip122:${number}:${string}`;
+    isCaipAddress(address?: unknown): address is CaipAddress;
+    isMac(): boolean;
+    formatTelegramSocialLoginUrl(url: string): string;
+    injectIntoUrl(url: string, key: string, appendString: string): string;
 };
 export {};

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

@@ -0,0 +1,67 @@
+import type { Balance, CaipNetworkId, ChainNamespace } from '@reown/appkit-common';
+type Hex = `0x${string}`;
+interface Asset {
+    address: `0x${string}` | 'native';
+    balance: `0x${string}`;
+    type: 'NATIVE' | 'ERC20';
+    metadata: Record<string, unknown>;
+}
+export interface WalletGetAssetsRequest {
+    account: Hex;
+    assetFilter?: Record<Hex, (Hex | 'native')[]>;
+    assetTypeFilter?: ('NATIVE' | 'ERC20')[];
+    chainFilter?: Hex[];
+}
+export type WalletGetAssetsResponse = Record<Hex, Asset[]>;
+export declare const ERC7811Utils: {
+    /**
+     * Creates a Balance object from an ERC7811 Asset object
+     * @param asset - Asset object to convert
+     * @param chainId - Chain ID in CAIP-2 format
+     * @returns Balance object
+     */
+    createBalance(asset: Asset, chainId: string): Balance;
+    /**
+     * Converts a hex string to a Balance object
+     * @param hex - Hex string to convert
+     * @param decimals - Number of decimals to use
+     * @returns Balance object
+     */
+    convertHexToBalance({ hex, decimals }: {
+        hex: `0x${string}`;
+        decimals: number;
+    }): string;
+    /**
+     * Converts an address to a CAIP-10 address
+     * @param address - Address to convert
+     * @param chainId - Chain ID in CAIP-2 format
+     * @returns CAIP-10 address
+     */
+    convertAddressToCAIP10Address(address: `0x${string}`, chainId: string): string;
+    /**
+     *  Creates a CAIP-2 Chain ID from a chain ID and namespace
+     * @param chainId  - Chain ID in hex format
+     * @param namespace  - Chain namespace
+     * @returns
+     */
+    createCAIP2ChainId(chainId: `0x${string}`, namespace: ChainNamespace): string;
+    /**
+     * Gets the chain ID in hex format from a CAIP-2 Chain ID
+     * @param caip2ChainId - CAIP-2 Chain ID
+     * @returns Chain ID in hex format
+     */
+    getChainIdHexFromCAIP2ChainId(caip2ChainId: CaipNetworkId): `0x${string}`;
+    /**
+     * Checks if a response is a valid WalletGetAssetsResponse
+     * @param response - The response to check
+     * @returns True if the response is a valid WalletGetAssetsResponse, false otherwise
+     */
+    isWalletGetAssetsResponse(response: WalletGetAssetsResponse): response is WalletGetAssetsResponse;
+    /**
+     * Checks if an asset object is valid.
+     * @param asset - The asset object to check.
+     * @returns True if the asset is valid, false otherwise.
+     */
+    isValidAsset(asset: Asset): asset is Asset;
+};
+export {};

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

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

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

@@ -0,0 +1,13 @@
+import type { CaipNetwork } from '@reown/appkit-common';
+import type { SwapTokenWithBalance } from './TypeUtil.js';
+import type { BlockchainApiBalanceResponse } from './TypeUtil.js';
+export declare const SendApiUtil: {
+    getMyTokensWithBalance(forceUpdate?: string): Promise<BlockchainApiBalanceResponse["balances"]>;
+    getEIP155Balances(address: string, caipNetwork: CaipNetwork): Promise<import("@reown/appkit-common").Balance[] | null>;
+    /**
+     * The 1Inch API includes many low-quality tokens in the balance response,
+     * which appear inconsistently. This filter prevents them from being displayed.
+     */
+    filterLowQualityTokens(balances: BlockchainApiBalanceResponse["balances"]): import("@reown/appkit-common").Balance[];
+    mapBalancesToSwapTokens(balances: BlockchainApiBalanceResponse["balances"]): SwapTokenWithBalance[];
+};

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

@@ -1,6 +1,13 @@
 import { type CaipNetworkId, type ChainNamespace } from '@reown/appkit-common';
-import type { ConnectionStatus, SocialProvider, WcWallet } from './TypeUtil.js';
+import type { BlockchainApiBalanceResponse, BlockchainApiIdentityResponse, BlockchainApiLookupEnsName, ConnectionStatus, SocialProvider, WcWallet } from './TypeUtil.js';
 export declare const StorageUtil: {
+    cacheExpiry: {
+        portfolio: number;
+        nativeBalance: number;
+        ens: number;
+        identity: number;
+    };
+    isCacheExpired(timestamp: number, cacheExpiry: number): boolean;
     getActiveNetworkProps(): {
         namespace: ChainNamespace | undefined;
         caipNetworkId: `eip155:${string}` | `eip155:${number}` | `solana:${string}` | `solana:${number}` | `polkadot:${string}` | `polkadot:${number}` | `bip122:${string}` | `bip122:${number}` | undefined;
@@ -33,4 +40,57 @@ export declare const StorageUtil: {
     setConnectedNamespaces(namespaces: ChainNamespace[]): void;
     addConnectedNamespace(namespace: ChainNamespace): void;
     removeConnectedNamespace(namespace: ChainNamespace): void;
+    getBalanceCache(): Record<string, {
+        timestamp: number;
+        balance: BlockchainApiBalanceResponse;
+    }>;
+    removeAddressFromBalanceCache(caipAddress: string): void;
+    getBalanceCacheForCaipAddress(caipAddress: string): BlockchainApiBalanceResponse | undefined;
+    updateBalanceCache(params: {
+        caipAddress: string;
+        balance: BlockchainApiBalanceResponse;
+        timestamp: number;
+    }): void;
+    getNativeBalanceCache(): Record<string, {
+        caipAddress: string;
+        balance: string;
+        symbol: string;
+        timestamp: number;
+    }>;
+    removeAddressFromNativeBalanceCache(caipAddress: string): void;
+    getNativeBalanceCacheForCaipAddress(caipAddress: string): {
+        caipAddress: string;
+        balance: string;
+        symbol: string;
+        timestamp: number;
+    } | undefined;
+    updateNativeBalanceCache(params: {
+        caipAddress: string;
+        balance: string;
+        symbol: string;
+        timestamp: number;
+    }): void;
+    getEnsCache(): Record<string, {
+        ens: BlockchainApiLookupEnsName[];
+        timestamp: number;
+    }>;
+    getEnsFromCacheForAddress(address: string): BlockchainApiLookupEnsName[] | undefined;
+    updateEnsCache(params: {
+        address: string;
+        timestamp: number;
+        ens: BlockchainApiLookupEnsName[];
+    }): void;
+    removeEnsFromCache(address: string): void;
+    getIdentityCache(): Record<string, {
+        identity: BlockchainApiIdentityResponse;
+        timestamp: number;
+    }>;
+    getIdentityFromCacheForAddress(address: string): BlockchainApiIdentityResponse | undefined;
+    updateIdentityCache(params: {
+        address: string;
+        timestamp: number;
+        identity: BlockchainApiIdentityResponse;
+    }): void;
+    removeIdentityFromCache(address: string): void;
+    clearAddressCache(): void;
 };

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

@@ -23,5 +23,5 @@ export declare const SwapApiUtil: {
         sourceTokenDecimals: number;
     }): Promise<boolean>;
     getMyTokensWithBalance(forceUpdate?: string): Promise<SwapTokenWithBalance[]>;
-    mapBalancesToSwapTokens(balances: BlockchainApiBalanceResponse['balances']): SwapTokenWithBalance[];
+    mapBalancesToSwapTokens(balances: BlockchainApiBalanceResponse["balances"]): SwapTokenWithBalance[];
 };

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

@@ -32,6 +32,7 @@ export type CaipNetworkCoinbaseNetwork = 'Ethereum' | 'Arbitrum One' | 'Polygon'
 export type ConnectedWalletInfo = {
     name: string;
     icon?: string;
+    type?: string;
     [key: string]: unknown;
 };
 export type User = {
@@ -676,6 +677,7 @@ export type Event = {
     address?: string;
     event: 'SEND_ERROR';
     properties: {
+        message: string;
         isSmartAccount: boolean;
         network: string;
         token: string;
@@ -771,6 +773,18 @@ export type AccountTypeMap = {
         path?: K extends 'bip122' ? string : never;
     };
 };
+export type WalletGetAssetsParams = {
+    account: `0x${string}`;
+    assetFilter?: Record<`0x${string}`, (`0x${string}` | 'native')[]>;
+    assetTypeFilter?: ('NATIVE' | 'ERC20')[];
+    chainFilter?: `0x${string}`[];
+};
+export type WalletGetAssetsResponse = Record<`0x${string}`, {
+    address: `0x${string}` | 'native';
+    balance: `0x${string}`;
+    type: 'NATIVE' | 'ERC20';
+    metadata: Record<string, unknown>;
+}[]>;
 export type AccountType = AccountTypeMap[ChainNamespace];
 export type SendTransactionArgs = {
     chainNamespace?: undefined | 'eip155';
@@ -818,31 +832,10 @@ export type AdapterNetworkState = {
     allowUnsupportedCaipNetwork?: boolean;
     smartAccountEnabledNetworks?: number[];
 };
-export type AdapterAccountState = {
-    currentTab: number;
-    caipAddress?: CaipAddress;
-    address?: string;
-    addressLabels: Map<string, string>;
-    allAccounts: AccountType[];
-    balance?: string;
-    balanceSymbol?: string;
-    profileName?: string | null;
-    profileImage?: string | null;
-    addressExplorerUrl?: string;
-    smartAccountDeployed?: boolean;
-    socialProvider?: SocialProvider;
-    tokenBalance?: Balance[];
-    shouldUpdateToAddress?: string;
-    connectedWalletInfo?: ConnectedWalletInfo;
-    preferredAccountType?: W3mFrameTypes.AccountType;
-    socialWindow?: Window;
-    farcasterUrl?: string;
-    status?: 'reconnecting' | 'connected' | 'disconnected' | 'connecting';
-};
 export type ChainAdapter = {
     connectionControllerClient?: ConnectionControllerClient;
     networkControllerClient?: NetworkControllerClient;
-    accountState?: AdapterAccountState;
+    accountState?: AccountControllerState;
     networkState?: AdapterNetworkState;
     namespace?: ChainNamespace;
     caipNetworks?: CaipNetwork[];

package/dist/types/tests/controllers/BlockchainApiController.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/hooks/vue.test.d.ts

@@ -0,0 +1,2 @@
+import type { App } from 'vue';
+export declare function withSetup<T>(composable: () => T): [T, App];

package/dist/types/tests/mocks/ChainController.d.ts

@@ -0,0 +1,2 @@
+export declare function mockChainControllerState(): void;
+export declare function mockResetChainControllerState(): void;

package/dist/types/tests/mocks/SwapController.d.ts

@@ -1,8 +1,9 @@
+import type { CaipAddress } from '@reown/appkit-common';
 export declare const tokensResponse: {
     tokens: {
         name: string;
         symbol: string;
-        address: `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `bip122:${string}:${string}` | `bip122:${number}:${string}`;
+        address: CaipAddress;
         decimals: number;
         logoUri: string;
         eip2612: boolean;
@@ -57,8 +58,8 @@ export declare const swapQuoteResponse: {
 };
 export declare const swapCalldataResponse: {
     tx: {
-        from: `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `bip122:${string}:${string}` | `bip122:${number}:${string}`;
-        to: `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `bip122:${string}:${string}` | `bip122:${number}:${string}`;
+        from: CaipAddress;
+        to: CaipAddress;
         data: `0x${string}`;
         amount: string;
         eip155: {

package/dist/types/tests/mocks/useAppKitAccount.d.ts

@@ -0,0 +1,40 @@
+export declare const defaultAccountState: {
+    allAccounts: never[];
+    address: undefined;
+    caipAddress: undefined;
+    isConnected: boolean;
+    status: undefined;
+    embeddedWalletInfo: undefined;
+};
+export declare const connectedAccountState: {
+    allAccounts: never[];
+    address: string;
+    caipAddress: string;
+    isConnected: boolean;
+    status: string;
+    embeddedWalletInfo: undefined;
+};
+export declare const disconnectedAccountState: {
+    allAccounts: never[];
+    address: undefined;
+    caipAddress: undefined;
+    isConnected: boolean;
+    status: string;
+    embeddedWalletInfo: undefined;
+};
+export declare const connectedWithEmbeddedWalletState: {
+    allAccounts: never[];
+    address: string;
+    caipAddress: string;
+    isConnected: boolean;
+    status: string;
+    embeddedWalletInfo: {
+        user: {
+            username: string;
+            email: string;
+        };
+        accountType: string;
+        authProvider: string;
+        isSmartAccountDeployed: boolean;
+    };
+};

package/dist/types/tests/utils/ERC7811.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/utils/SendApiUtil.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reown/appkit-core",
-  "version": "1.6.8",
+  "version": "1.6.9-rc.1.0",
   "type": "module",
   "main": "./dist/esm/exports/index.js",
   "types": "./dist/types/exports/index.d.ts",
@@ -39,12 +39,12 @@
     "@walletconnect/universal-provider": "2.18.0",
     "valtio": "1.13.2",
     "viem": ">=2.23",
-    "@reown/appkit-common": "1.6.8",
-    "@reown/appkit-wallet": "1.6.8"
+    "@reown/appkit-common": "1.6.9-rc.1.0",
+    "@reown/appkit-wallet": "1.6.9-rc.1.0"
   },
   "peerDependencies": {},
   "devDependencies": {
-    "vitest": "2.1.3",
+    "vitest": "2.1.9",
     "@vitest/coverage-v8": "2.1.3",
     "vue": "3.x"
   },