@reown/appkit-controllers 1.7.0-rc.0

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

@@ -0,0 +1,364 @@
+import type { SIWXConfig } from '../utils/SIWXUtil.js';
+import type { ConnectMethod, CustomWallet, DefaultAccountTypes, Features, Metadata, ProjectId, SdkVersion, SocialProvider, Tokens, WalletFeature } from '../utils/TypeUtil.js';
+export interface OptionsControllerStatePublic {
+    /**
+     * A boolean that allows you to add or remove the "All Wallets" button on the modal
+     * @default 'SHOW'
+     * @see https://docs.reown.com/appkit/react/core/options#allwallets
+     */
+    allWallets?: 'SHOW' | 'HIDE' | 'ONLY_MOBILE';
+    /**
+     * The project ID for the AppKit. You can find or create your project ID in the Cloud.
+     * @see https://cloud.walletconnect.com/
+     */
+    projectId: ProjectId;
+    /**
+     * Array of wallet ids to be shown in the modal's connection view with priority. These wallets will also show up first in `All Wallets` view
+     * @default []
+     * @see https://docs.reown.com/appkit/react/core/options#featuredwalletids
+     */
+    featuredWalletIds?: string[];
+    /**
+     * Array of wallet ids to be shown (order is respected). Unlike `featuredWalletIds`, these wallets will be the only ones shown in `All Wallets` view and as recommended wallets.
+     * @default []
+     * @see https://docs.reown.com/appkit/react/core/options#includewalletids
+     */
+    includeWalletIds?: string[];
+    /**
+     * Array of wallet ids to be excluded from the wallet list in the modal.
+     * @default []
+     * @see https://docs.reown.com/appkit/react/core/options#excludewalletids
+     */
+    excludeWalletIds?: string[];
+    /**
+     * Array of tokens to show the user's balance of. Each key represents the chain id of the token's blockchain
+     * @default {}
+     * @see https://docs.reown.com/appkit/react/core/options#tokens
+     */
+    tokens?: Tokens;
+    /**
+     * Add custom wallets to the modal. CustomWallets is an array of objects, where each object contains specific information of a custom wallet.
+     * @default []
+     * @see https://docs.reown.com/appkit/react/core/options#customwallets
+     *
+     */
+    customWallets?: CustomWallet[];
+    /**
+     * You can add an url for the terms and conditions link.
+     * @default undefined
+     */
+    termsConditionsUrl?: string;
+    /**
+     * You can add an url for the privacy policy link.
+     * @default undefined
+     */
+    privacyPolicyUrl?: string;
+    /**
+     * Set of fields that related to your project which will be used to populate the metadata of the modal.
+     * @default {}
+     */
+    metadata?: Metadata;
+    /**
+     * Enable or disable the appending the AppKit to the DOM. Created for specific use cases like WebGL.
+     * @default false
+     */
+    disableAppend?: boolean;
+    /**
+     * Enable or disable the all the wallet options (injected, Coinbase, QR, etc.). This is useful if you want to use only email and socials.
+     * @default true
+     */
+    enableWallets?: boolean;
+    /**
+     * Enable or disable the EIP6963 feature in your AppKit.
+     * @default false
+     */
+    enableEIP6963?: boolean;
+    /**
+     * Enable or disable the Coinbase wallet in your AppKit.
+     * @default true
+     */
+    enableCoinbase?: boolean;
+    /**
+     * Enable or disable the Injected wallet in your AppKit.
+     * @default true
+     */
+    enableInjected?: boolean;
+    /**
+     * Enable or disable the WalletConnect QR code in your AppKit.
+     * @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 logs from email/social login.
+     * @default true
+     */
+    enableAuthLogger?: boolean;
+    /**
+     * Enable or disable debug mode in your AppKit. This is useful if you want to see UI alerts when debugging.
+     * @default true
+     */
+    debug?: boolean;
+    /**
+     * Features configuration object.
+     * @default { swaps: true, onramp: true, email: true, socials: ['google', 'x', 'discord', 'farcaster', 'github', 'apple', 'facebook'], history: true, analytics: true, allWallets: true }
+     * @see https://docs.reown.com/appkit/react/core/options#features
+     */
+    features?: Features;
+    /**
+     * @experimental - This feature is not production ready.
+     * Enable Sign In With X (SIWX) feature in your AppKit.
+     * @default undefined
+     */
+    siwx?: SIWXConfig;
+    /**
+     * Renders the AppKit to DOM instead of the default modal.
+     * @default false
+     */
+    enableEmbedded?: boolean;
+    /**
+     * Allow users to switch to an unsupported chain.
+     * @default false
+     */
+    allowUnsupportedChain?: boolean;
+    /**
+     * Default account types for each namespace.
+     * @default "{ bip122: 'payment', eip155: 'smartAccount', polkadot: 'eoa', solana: 'eoa' }"
+     */
+    defaultAccountTypes: DefaultAccountTypes;
+    /**
+     * Allows users to indicate if they want to handle the WC connection themselves.
+     * @default false
+     * @see https://docs.reown.com/appkit/react/core/options#manualwccontrol
+     */
+    manualWCControl?: boolean;
+}
+export interface OptionsControllerStateInternal {
+    sdkType: 'appkit';
+    sdkVersion: SdkVersion;
+    isSiweEnabled?: boolean;
+    isUniversalProvider?: boolean;
+    hasMultipleAddresses?: boolean;
+}
+type StateKey = keyof OptionsControllerStatePublic | keyof OptionsControllerStateInternal;
+type OptionsControllerState = OptionsControllerStatePublic & OptionsControllerStateInternal;
+export declare const OptionsController: {
+    state: OptionsControllerStatePublic & OptionsControllerStateInternal;
+    subscribeKey<K extends StateKey>(key: K, callback: (value: OptionsControllerState[K]) => void): () => void;
+    setOptions(options: OptionsControllerState): void;
+    setFeatures(features: OptionsControllerState["features"] | undefined): void;
+    setProjectId(projectId: OptionsControllerState["projectId"]): void;
+    setAllWallets(allWallets: OptionsControllerState["allWallets"]): void;
+    setIncludeWalletIds(includeWalletIds: OptionsControllerState["includeWalletIds"]): void;
+    setExcludeWalletIds(excludeWalletIds: OptionsControllerState["excludeWalletIds"]): void;
+    setFeaturedWalletIds(featuredWalletIds: OptionsControllerState["featuredWalletIds"]): void;
+    setTokens(tokens: OptionsControllerState["tokens"]): void;
+    setTermsConditionsUrl(termsConditionsUrl: OptionsControllerState["termsConditionsUrl"]): void;
+    setPrivacyPolicyUrl(privacyPolicyUrl: OptionsControllerState["privacyPolicyUrl"]): void;
+    setCustomWallets(customWallets: OptionsControllerState["customWallets"]): void;
+    setIsSiweEnabled(isSiweEnabled: OptionsControllerState["isSiweEnabled"]): void;
+    setIsUniversalProvider(isUniversalProvider: OptionsControllerState["isUniversalProvider"]): void;
+    setSdkVersion(sdkVersion: OptionsControllerState["sdkVersion"]): void;
+    setMetadata(metadata: OptionsControllerState["metadata"]): void;
+    setDisableAppend(disableAppend: OptionsControllerState["disableAppend"]): void;
+    setEIP6963Enabled(enableEIP6963: OptionsControllerState["enableEIP6963"]): void;
+    setDebug(debug: OptionsControllerState["debug"]): void;
+    setEnableWalletConnect(enableWalletConnect: OptionsControllerState["enableWalletConnect"]): void;
+    setEnableWalletGuide(enableWalletGuide: OptionsControllerState["enableWalletGuide"]): void;
+    setEnableAuthLogger(enableAuthLogger: OptionsControllerState["enableAuthLogger"]): 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;
+    setAllowUnsupportedChain(allowUnsupportedChain: OptionsControllerState["allowUnsupportedChain"]): void;
+    setManualWCControl(manualWCControl: OptionsControllerState["manualWCControl"]): void;
+    setDefaultAccountTypes(defaultAccountType?: Partial<OptionsControllerState["defaultAccountTypes"]>): void;
+    getSnapshot(): {
+        readonly allWallets?: "SHOW" | "HIDE" | "ONLY_MOBILE"
+        /**
+         * The project ID for the AppKit. You can find or create your project ID in the Cloud.
+         * @see https://cloud.walletconnect.com/
+         */
+         | undefined;
+        readonly projectId: ProjectId;
+        readonly featuredWalletIds?: readonly string[] | undefined;
+        readonly includeWalletIds?: readonly string[] | undefined;
+        readonly excludeWalletIds?: readonly string[] | undefined;
+        readonly tokens?: {
+            readonly [x: `eip155:${string}`]: {
+                readonly address: string;
+                readonly image?: string | undefined;
+            };
+            readonly [x: `eip155:${number}`]: {
+                readonly address: string;
+                readonly image?: string | undefined;
+            };
+            readonly [x: `solana:${string}`]: {
+                readonly address: string;
+                readonly image?: string | undefined;
+            };
+            readonly [x: `solana:${number}`]: {
+                readonly address: string;
+                readonly image?: string | undefined;
+            };
+            readonly [x: `polkadot:${string}`]: {
+                readonly address: string;
+                readonly image?: string | undefined;
+            };
+            readonly [x: `polkadot:${number}`]: {
+                readonly address: string;
+                readonly image?: string | undefined;
+            };
+            readonly [x: `bip122:${string}`]: {
+                readonly address: string;
+                readonly image?: string | undefined;
+            };
+            readonly [x: `bip122:${number}`]: {
+                readonly address: string;
+                readonly image?: string | undefined;
+            };
+        } | undefined;
+        readonly customWallets?: readonly {
+            readonly name: string;
+            readonly id: string;
+            readonly homepage?: string | undefined;
+            readonly image_url?: string | undefined;
+            readonly mobile_link?: string | null | undefined;
+            readonly desktop_link?: string | null | undefined;
+            readonly webapp_link?: string | null | undefined;
+            readonly app_store?: string | null | undefined;
+            readonly play_store?: string | null | undefined;
+        }[] | undefined;
+        readonly termsConditionsUrl?: string
+        /**
+         * You can add an url for the privacy policy link.
+         * @default undefined
+         */
+         | undefined;
+        readonly privacyPolicyUrl?: string
+        /**
+         * Set of fields that related to your project which will be used to populate the metadata of the modal.
+         * @default {}
+         */
+         | undefined;
+        readonly metadata?: {
+            readonly name: string;
+            readonly description: string;
+            readonly url: string;
+            readonly icons: readonly string[];
+        } | undefined;
+        readonly disableAppend?: boolean
+        /**
+         * Enable or disable the all the wallet options (injected, Coinbase, QR, etc.). This is useful if you want to use only email and socials.
+         * @default true
+         */
+         | undefined;
+        readonly enableWallets?: boolean
+        /**
+         * Enable or disable the EIP6963 feature in your AppKit.
+         * @default false
+         */
+         | undefined;
+        readonly enableEIP6963?: boolean
+        /**
+         * Enable or disable the Coinbase wallet in your AppKit.
+         * @default true
+         */
+         | undefined;
+        readonly enableCoinbase?: boolean
+        /**
+         * Enable or disable the Injected wallet in your AppKit.
+         * @default true
+         */
+         | undefined;
+        readonly enableInjected?: boolean
+        /**
+         * Enable or disable the WalletConnect QR code in your AppKit.
+         * @default true
+         */
+         | undefined;
+        readonly enableWalletConnect?: boolean
+        /**
+         * Enable or disable the wallet guide footer in AppKit if you have email or social login configured.
+         * @default true
+         */
+         | undefined;
+        readonly enableWalletGuide?: boolean
+        /**
+         * Enable or disable logs from email/social login.
+         * @default true
+         */
+         | undefined;
+        readonly enableAuthLogger?: boolean
+        /**
+         * Enable or disable debug mode in your AppKit. This is useful if you want to see UI alerts when debugging.
+         * @default true
+         */
+         | undefined;
+        readonly debug?: boolean
+        /**
+         * Features configuration object.
+         * @default { swaps: true, onramp: true, email: true, socials: ['google', 'x', 'discord', 'farcaster', 'github', 'apple', 'facebook'], history: true, analytics: true, allWallets: true }
+         * @see https://docs.reown.com/appkit/react/core/options#features
+         */
+         | undefined;
+        readonly features?: {
+            readonly swaps?: boolean | undefined;
+            readonly onramp?: boolean | undefined;
+            readonly receive?: boolean | undefined;
+            readonly send?: boolean | undefined;
+            readonly email?: boolean | undefined;
+            readonly emailShowWallets?: boolean | undefined;
+            readonly socials?: false | readonly SocialProvider[] | undefined;
+            readonly history?: boolean | undefined;
+            readonly analytics?: boolean | undefined;
+            readonly allWallets?: boolean | undefined;
+            readonly smartSessions?: boolean | undefined;
+            readonly legalCheckbox?: boolean | undefined;
+            readonly connectMethodsOrder?: readonly ConnectMethod[] | undefined;
+            readonly walletFeaturesOrder?: readonly WalletFeature[] | undefined;
+            readonly collapseWallets?: boolean | undefined;
+        } | undefined;
+        readonly siwx?: {
+            readonly createMessage: (input: import("../utils/SIWXUtil.js").SIWXMessage.Input) => Promise<import("../utils/SIWXUtil.js").SIWXMessage>;
+            readonly addSession: (session: import("../utils/SIWXUtil.js").SIWXSession) => Promise<void>;
+            readonly revokeSession: (chainId: import("@reown/appkit-common").CaipNetworkId, address: string) => Promise<void>;
+            readonly setSessions: (sessions: import("../utils/SIWXUtil.js").SIWXSession[]) => Promise<void>;
+            readonly getSessions: (chainId: import("@reown/appkit-common").CaipNetworkId, address: string) => Promise<import("../utils/SIWXUtil.js").SIWXSession[]>;
+            readonly getRequired?: (() => boolean) | undefined;
+        } | undefined;
+        readonly enableEmbedded?: boolean
+        /**
+         * Allow users to switch to an unsupported chain.
+         * @default false
+         */
+         | undefined;
+        readonly allowUnsupportedChain?: boolean
+        /**
+         * Default account types for each namespace.
+         * @default "{ bip122: 'payment', eip155: 'smartAccount', polkadot: 'eoa', solana: 'eoa' }"
+         */
+         | undefined;
+        readonly defaultAccountTypes: {
+            readonly eip155: "eoa" | "smartAccount";
+            readonly solana: "eoa";
+            readonly bip122: "payment" | "ordinal" | "stx";
+            readonly polkadot: "eoa";
+        };
+        readonly manualWCControl?: boolean | undefined;
+        readonly sdkType: "appkit";
+        readonly sdkVersion: SdkVersion;
+        readonly isSiweEnabled?: boolean | undefined;
+        readonly isUniversalProvider?: boolean | undefined;
+        readonly hasMultipleAddresses?: boolean | undefined;
+    };
+};
+export {};

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

@@ -0,0 +1,33 @@
+import type { CaipNetworkId, ChainNamespace } from '@reown/appkit-common';
+export interface PublicStateControllerState {
+    /**
+     * @description Indicates if the AppKit is loading.
+     * @type {boolean}
+     */
+    loading: boolean;
+    /**
+     * @description Indicates if the AppKit modal is open.
+     * @type {boolean}
+     */
+    open: boolean;
+    /**
+     * @description Indicates the selected network id in CAIP-2 format.
+     * @type {CaipNetworkId | undefined}
+     */
+    selectedNetworkId?: CaipNetworkId | undefined;
+    /**
+     * @description Indicates the active chain namespace.
+     * @type {ChainNamespace | undefined}
+     */
+    activeChain?: ChainNamespace | undefined;
+    /**
+     * @description Indicates if the AppKit has been initialized. This sets to true when all controllers, adapters and internal state is ready.
+     * @type {boolean}
+     */
+    initialized: boolean;
+}
+export declare const PublicStateController: {
+    state: PublicStateControllerState;
+    subscribe(callback: (newState: PublicStateControllerState) => void): () => void;
+    set(newState: Partial<PublicStateControllerState>): void;
+};

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

@@ -0,0 +1,56 @@
+import type { CaipNetwork, ChainNamespace } from '@reown/appkit-common';
+import type { Connector, WcWallet } from '../utils/TypeUtil.js';
+import type { SwapInputTarget } from './SwapController.js';
+type TransactionAction = {
+    /**
+     * If true, the router will go back to the previous view after the transaction is complete..
+     */
+    goBack: boolean;
+    /**
+     * If set, the router will navigate to the specified view after the transaction is complete.
+     */
+    view: RouterControllerState['view'] | null;
+    /**
+     * If true, the router will remove the previous view from the history and navigate to the current view.
+     */
+    replace?: boolean;
+    /**
+     * Function to be called when the transaction is complete.
+     */
+    onSuccess?: () => void;
+    /**
+     * Function to be called when the transaction is cancelled.
+     */
+    onCancel?: () => void;
+};
+export interface RouterControllerState {
+    view: 'Account' | 'AccountSettings' | 'AllWallets' | 'ApproveTransaction' | 'BuyInProgress' | 'WalletCompatibleNetworks' | 'ChooseAccountName' | 'Connect' | 'Create' | 'ConnectingExternal' | 'ConnectingFarcaster' | 'ConnectingWalletConnect' | 'ConnectingWalletConnectBasic' | '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;
+        wallet?: WcWallet;
+        network?: CaipNetwork;
+        email?: string;
+        newEmail?: string;
+        target?: SwapInputTarget;
+        swapUnsupportedChain?: boolean;
+        connectors?: Connector[];
+        switchToChain?: ChainNamespace;
+        navigateTo?: RouterControllerState['view'];
+        navigateWithReplace?: boolean;
+    };
+    transactionStack: TransactionAction[];
+}
+type StateKey = keyof RouterControllerState;
+export declare const RouterController: {
+    state: RouterControllerState;
+    subscribeKey<K extends StateKey>(key: K, callback: (value: RouterControllerState[K]) => void): () => void;
+    pushTransactionStack(action: TransactionAction): void;
+    popTransactionStack(cancel?: boolean): void;
+    push(view: RouterControllerState["view"], data?: RouterControllerState["data"]): void;
+    reset(view: RouterControllerState["view"], data?: RouterControllerState["data"]): void;
+    replace(view: RouterControllerState["view"], data?: RouterControllerState["data"]): void;
+    goBack(): void;
+    goBackToIndex(historyIndex: number): void;
+};
+export {};

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

@@ -0,0 +1,52 @@
+import { type Balance } from '@reown/appkit-common';
+export interface TxParams {
+    receiverAddress: string;
+    sendTokenAmount: number;
+    gasPrice: bigint;
+    decimals: string;
+}
+export interface ContractWriteParams {
+    receiverAddress: string;
+    tokenAddress: string;
+    sendTokenAmount: number;
+    decimals: string;
+}
+export interface SendControllerState {
+    tokenBalances: Balance[];
+    token?: Balance;
+    sendTokenAmount?: number;
+    receiverAddress?: string;
+    receiverProfileName?: string;
+    receiverProfileImageUrl?: string;
+    gasPrice?: bigint;
+    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 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;
+    fetchTokenBalance(onError?: (error: unknown) => void): Promise<Balance[]>;
+    fetchNetworkBalance(): void;
+    isInsufficientNetworkTokenForGas(networkBalanceInUSD: string, gasPriceInUSD: number | undefined): boolean;
+    hasInsufficientGasFunds(): boolean;
+    sendNativeToken(params: TxParams): Promise<void>;
+    sendERC20Token(params: ContractWriteParams): Promise<void>;
+    sendSolanaToken(): void;
+    resetSend(): void;
+};
+export {};

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

@@ -0,0 +1,29 @@
+export interface SnackControllerState {
+    message: string;
+    variant: 'error' | 'success' | 'loading';
+    svg?: {
+        iconColor: string;
+        icon: string;
+    };
+    open: boolean;
+    autoClose: boolean;
+}
+export type SnackControllerShowOptions = {
+    autoClose?: boolean;
+    svg?: SnackControllerState['svg'];
+    variant?: SnackControllerState['variant'];
+};
+type StateKey = keyof SnackControllerState;
+export declare const SnackController: {
+    state: SnackControllerState;
+    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

@@ -0,0 +1,127 @@
+import type { SwapTokenWithBalance } from '../utils/TypeUtil.js';
+export declare const INITIAL_GAS_LIMIT = 150000;
+export declare const TO_AMOUNT_DECIMALS = 6;
+export type SwapInputTarget = 'sourceToken' | 'toToken';
+type TransactionParams = {
+    data: string;
+    to: string;
+    gas: bigint;
+    gasPrice: bigint;
+    value: bigint;
+    toAmount: string;
+};
+export interface SwapControllerState {
+    initializing: boolean;
+    initialized: boolean;
+    loadingPrices: boolean;
+    loadingQuote?: boolean;
+    loadingApprovalTransaction?: boolean;
+    loadingBuildTransaction?: boolean;
+    loadingTransaction?: boolean;
+    fetchError: boolean;
+    approvalTransaction: TransactionParams | undefined;
+    swapTransaction: TransactionParams | undefined;
+    transactionError?: string;
+    sourceToken?: SwapTokenWithBalance;
+    sourceTokenAmount: string;
+    sourceTokenPriceInUSD: number;
+    toToken?: SwapTokenWithBalance;
+    toTokenAmount: string;
+    toTokenPriceInUSD: number;
+    networkPrice: string;
+    networkBalanceInUSD: string;
+    networkTokenSymbol: string;
+    inputError: string | undefined;
+    slippage: number;
+    tokens?: SwapTokenWithBalance[];
+    suggestedTokens?: SwapTokenWithBalance[];
+    popularTokens?: SwapTokenWithBalance[];
+    foundTokens?: SwapTokenWithBalance[];
+    myTokensWithBalance?: SwapTokenWithBalance[];
+    tokensPriceMap: Record<string, number>;
+    gasFee: string;
+    gasPriceInUSD?: number;
+    priceImpact: number | undefined;
+    maxSlippage: number | undefined;
+    providerFee: string | undefined;
+}
+export interface TokenInfo {
+    address: `0x${string}`;
+    symbol: string;
+    name: string;
+    decimals: number;
+    logoURI: string;
+    domainVersion?: string;
+    eip2612?: boolean;
+    isFoT?: boolean;
+    tags?: string[];
+}
+type StateKey = keyof SwapControllerState;
+export declare const SwapController: {
+    state: SwapControllerState;
+    subscribe(callback: (newState: SwapControllerState) => void): () => void;
+    subscribeKey<K extends StateKey>(key: K, callback: (value: SwapControllerState[K]) => void): () => void;
+    getParams(): {
+        networkAddress: string;
+        fromAddress: string;
+        fromCaipAddress: `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `bip122:${string}:${string}` | `bip122:${number}:${string}` | undefined;
+        sourceTokenAddress: `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `bip122:${string}:${string}` | `bip122:${number}:${string}` | undefined;
+        toTokenAddress: `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `bip122:${string}:${string}` | `bip122:${number}:${string}` | undefined;
+        toTokenAmount: string;
+        toTokenDecimals: number | undefined;
+        sourceTokenAmount: string;
+        sourceTokenDecimals: number | undefined;
+        invalidToToken: boolean;
+        invalidSourceToken: boolean;
+        invalidSourceTokenAmount: boolean;
+        availableToSwap: boolean | undefined;
+        isAuthConnector: boolean;
+    };
+    setSourceToken(sourceToken: SwapTokenWithBalance | undefined): void;
+    setSourceTokenAmount(amount: string): void;
+    setToToken(toToken: SwapTokenWithBalance | undefined): void;
+    setToTokenAmount(amount: string): void;
+    setTokenPrice(address: string, target: SwapInputTarget): Promise<void>;
+    switchTokens(): void;
+    resetState(): void;
+    resetValues(): void;
+    getApprovalLoadingState(): boolean | undefined;
+    clearError(): void;
+    initializeState(): Promise<void>;
+    fetchTokens(): Promise<void>;
+    getTokenList(): Promise<void>;
+    getAddressPrice(address: string): Promise<number>;
+    getNetworkTokenPrice(): Promise<void>;
+    getMyTokensWithBalance(forceUpdate?: string): Promise<void>;
+    setBalances(balances: SwapTokenWithBalance[]): void;
+    getInitialGasPrice(): Promise<{
+        gasPrice: null;
+        gasPriceInUSD: null;
+    } | {
+        gasPrice: bigint;
+        gasPriceInUSD: number;
+    }>;
+    swapTokens(): Promise<void>;
+    getTransaction(): Promise<TransactionParams | undefined>;
+    createAllowanceTransaction(): Promise<{
+        data: `0x${string}`;
+        to: `0x${string}`;
+        gas: bigint;
+        gasPrice: bigint;
+        value: bigint;
+        toAmount: string;
+    } | undefined>;
+    createSwapTransaction(): Promise<{
+        data: `0x${string}`;
+        to: `0x${string}`;
+        gas: bigint;
+        gasPrice: bigint;
+        value: bigint;
+        toAmount: string;
+    } | undefined>;
+    sendTransactionForApproval(data: TransactionParams): Promise<void>;
+    sendTransactionForSwap(data: TransactionParams | undefined): Promise<string | null | undefined>;
+    hasInsufficientToken(sourceTokenAmount: string, sourceTokenAddress: string): boolean;
+    setTransactionDetails(): void;
+};
+export {};