@imtbl/checkout-widgets 2.0.0-alpha.0

package/dist/types/lib/squid/types.d.ts

@@ -0,0 +1,40 @@
+import { TokenBalance } from '@0xsquid/sdk/dist/types';
+import { RouteResponse } from '@0xsquid/squid-types';
+export type Token = {
+    chainId: string;
+    address: string;
+    decimals: number;
+    symbol?: string;
+    name?: string;
+    usdPrice: number;
+    iconUrl: string;
+};
+export type Chain = {
+    id: string;
+    type: string;
+    name: string;
+    iconUrl: string;
+    nativeCurrency: NativeCurrency;
+};
+export type NativeCurrency = {
+    name: string;
+    symbol: string;
+    decimals: number;
+    iconUrl: string;
+};
+export type AmountData = {
+    fromToken: Token;
+    fromAmount: string;
+    toToken: Token;
+    toAmount: string;
+    balance: TokenBalance;
+    additionalBuffer: number;
+};
+export type RouteData = {
+    amountData: AmountData;
+    route: RouteResponse;
+};
+export type RouteResponseData = {
+    route?: RouteResponse;
+    additionalBuffer?: number;
+};

package/dist/types/lib/storage.d.ts

@@ -0,0 +1,4 @@
+export declare const IMTBL_CHECKOUT_NAMESPACE = "imtbl-checkout";
+export declare function addToLocalStorage(key: string, value: any): void;
+export declare function removeFromLocalStorage(key: string): void;
+export declare function getFromLocalStorage(key: string): string | null;

package/dist/types/lib/theme.d.ts

@@ -0,0 +1,3 @@
+import { BaseTokens } from '@biom3/design-tokens';
+import { WidgetTheme } from '@imtbl/checkout-sdk';
+export declare const widgetTheme: (theme: WidgetTheme) => BaseTokens;

package/dist/types/lib/theme.test.d.ts

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

package/dist/types/lib/utils.d.ts

@@ -0,0 +1,28 @@
+import { ChainId, CheckoutConfiguration, GetBalanceResult, NetworkInfo, WidgetTheme, WrappedBrowserProvider } from '@imtbl/checkout-sdk';
+import { Environment } from '@imtbl/config';
+import { SignedTransaction } from './primary-sales';
+export declare const tokenSymbolNameOverrides: {
+    timx: string;
+};
+export declare const sortTokensByAmount: (config: CheckoutConfiguration, tokens: GetBalanceResult[], chainId: ChainId) => GetBalanceResult[];
+export declare const sortNetworksCompareFn: (a: NetworkInfo, b: NetworkInfo, config: CheckoutConfiguration) => 0 | 1 | -1;
+export declare const formatFiatString: (amount: number, decimals?: number) => string;
+export declare const calculateCryptoToFiat: (amount: string, symbol: string, conversions: Map<string, number>, zeroString?: string, maxDecimals?: number) => string;
+export declare const formatZeroAmount: (amount: string, allowZeros?: boolean) => string;
+export declare const tokenValueFormat: (s: Number | string, maxDecimals?: number) => string;
+export declare const isZkEvmChainId: (chainId: ChainId) => chainId is ChainId.IMTBL_ZKEVM_MAINNET | ChainId.IMTBL_ZKEVM_TESTNET | ChainId.IMTBL_ZKEVM_DEVNET;
+export declare const isL1EthChainId: (chainId: ChainId) => chainId is ChainId.ETHEREUM | ChainId.SEPOLIA;
+export declare const isNativeToken: (address: string | undefined) => boolean;
+export declare function getRemoteImage(environment: Environment | undefined, path: string): string;
+export declare function getRemoteVideo(environment: Environment | undefined, path: string): string;
+export declare function getRemoteRive(environment: Environment | undefined, path: string): string;
+export declare function getChainImage(environment: Environment | undefined, chainId: ChainId): string;
+export declare function getEthTokenImage(environment: Environment | undefined): string;
+export declare function getImxTokenImage(environment: Environment | undefined): string;
+export declare function getTokenImageByAddress(environment: Environment | undefined, address: string): string;
+export declare function getDefaultTokenImage(environment: Environment | undefined, theme: WidgetTheme): string;
+export declare function abbreviateWalletAddress(address: string, separator?: string, firstChars?: number, lastChars?: number): string;
+export declare function compareStr(a: string, b: string): boolean;
+export declare function removeSpace(str: string): string;
+export declare const filterAllowedTransactions: (transactions: SignedTransaction[], provider: WrappedBrowserProvider) => Promise<SignedTransaction[]>;
+export declare const hexToText: (value: string) => string;

package/dist/types/lib/utils.test.d.ts

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

package/dist/types/lib/validations/amountInputValidations.d.ts

@@ -0,0 +1 @@
+export declare function amountInputValidation(value: string): boolean;

package/dist/types/lib/validations/amountInputValidations.test.d.ts

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

package/dist/types/lib/validations/widgetValidators.d.ts

@@ -0,0 +1,3 @@
+export declare function isValidWalletProvider(walletProviderName: string | undefined): boolean;
+export declare function isValidAmount(amount: string | undefined): boolean;
+export declare function isValidAddress(address: string | undefined): boolean;

package/dist/types/lib/validations/widgetValidators.test.d.ts

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

package/dist/types/lib/walletConnect.d.ts

@@ -0,0 +1,40 @@
+import { WalletConnectModal } from '@walletconnect/modal';
+import EthereumProvider from '@walletconnect/ethereum-provider';
+import { EIP6963ProviderInfo, WidgetTheme } from '@imtbl/checkout-sdk';
+import { Environment } from '@imtbl/config';
+export declare const walletConnectProviderInfo: EIP6963ProviderInfo;
+export type WalletConnectConfiguration = {
+    projectId: string;
+    metadata: {
+        name: string;
+        description: string;
+        url: string;
+        icons: string[];
+    };
+};
+type ConnectConfig = {
+    walletConnect: boolean;
+};
+export declare class WalletConnectManager {
+    private static instance;
+    private isInitialising;
+    private initialised;
+    private enabled;
+    private environment;
+    private theme;
+    private walletConnectConfig;
+    private walletConnectModal;
+    private ethereumProvider;
+    private walletListings;
+    private providerQueue;
+    private validateConfig;
+    static getInstance(): WalletConnectManager;
+    initialise(environment: Environment, config: WalletConnectConfiguration, theme: WidgetTheme, remoteConfig: Promise<ConnectConfig>): void;
+    get isInitialised(): boolean;
+    get isEnabled(): boolean;
+    getModal(): WalletConnectModal;
+    getProvider(): Promise<EthereumProvider>;
+    private loadWalletListings;
+    getWalletLogoUrl(walletSlug?: string): Promise<string | undefined>;
+}
+export {};

package/dist/types/lib/withDefaultWidgetConfig.d.ts

@@ -0,0 +1,11 @@
+import { Environment } from '@imtbl/config';
+import { WidgetTheme } from '@imtbl/checkout-sdk';
+export type StrongCheckoutWidgetsConfig = {
+    theme: WidgetTheme;
+    environment: Environment;
+    isOnRampEnabled: boolean;
+    isSwapEnabled: boolean;
+    isBridgeEnabled: boolean;
+    isAddTokensEnabled: boolean;
+};
+export declare const withDefaultWidgetConfigs: (configs?: any) => StrongCheckoutWidgetsConfig;

package/dist/types/lib/withDefaultWidgetConfig.test.d.ts

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

package/dist/types/setupTests.d.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom';

package/dist/types/views/error/ErrorView.d.ts

@@ -0,0 +1,8 @@
+export interface ErrorViewProps {
+    actionText: string;
+    onActionClick: () => void;
+    errorEventAction?: () => void;
+    errorEventActionLoading?: boolean;
+    onCloseClick: () => void;
+}
+export declare function ErrorView({ actionText, onActionClick, errorEventAction, errorEventActionLoading, onCloseClick, }: ErrorViewProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/views/error/ServiceUnavailableErrorView.d.ts

@@ -0,0 +1,5 @@
+export interface ServiceUnavailableErrorViewProps {
+    onCloseClick: () => void;
+    onBackButtonClick?: () => void;
+}
+export declare function ServiceUnavailableErrorView({ onCloseClick, onBackButtonClick, }: ServiceUnavailableErrorViewProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/views/error/ServiceUnavailableToRegionErrorView.d.ts

@@ -0,0 +1,10 @@
+import { ServiceType } from './serviceTypes';
+export interface ServiceUnavailableToRegionErrorViewProps {
+    service: ServiceType;
+    onCloseClick: () => void;
+    primaryActionText?: string;
+    onPrimaryButtonClick?: () => void;
+    secondaryActionText?: string;
+    onSecondaryButtonClick?: () => void;
+}
+export declare function ServiceUnavailableToRegionErrorView({ service, onCloseClick, primaryActionText, onPrimaryButtonClick, secondaryActionText, onSecondaryButtonClick, }: ServiceUnavailableToRegionErrorViewProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/views/error/serviceTypes.d.ts

@@ -0,0 +1,5 @@
+export declare enum ServiceType {
+    SWAP = "swap",
+    GENERIC = "generic",
+    ADD_TOKENS = "addTokens"
+}

package/dist/types/views/loading/LoadingView.d.ts

@@ -0,0 +1,7 @@
+import { BoxProps } from '@biom3/react';
+export interface LoadingViewProps {
+    loadingText: string | string[];
+    textDuration?: number;
+    containerSx?: BoxProps['sx'];
+}
+export declare function LoadingView({ loadingText, textDuration, containerSx }: LoadingViewProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/views/top-up/TopUpMenuItem.d.ts

@@ -0,0 +1,14 @@
+import { type IconProps } from '@biom3/react';
+import type { ReactNode } from 'react';
+export interface TopUpMenuItemProps {
+    testId: string;
+    icon: IconProps['icon'];
+    iconVariant?: IconProps['variant'];
+    intentIcon?: IconProps['icon'];
+    heading: string;
+    caption: string;
+    onClick: () => void;
+    renderFeeFunction: (fees: string, feesLoading: boolean) => ReactNode;
+    isDisabled: boolean;
+}
+export declare function TopUpMenuItem({ testId, icon, iconVariant, intentIcon, heading, caption, onClick, renderFeeFunction, isDisabled, }: TopUpMenuItemProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/views/top-up/TopUpView.d.ts

@@ -0,0 +1,29 @@
+import { Checkout, IMTBLWidgetEvents, WrappedBrowserProvider } from '@imtbl/checkout-sdk';
+import { UserJourney } from '../../context/analytics-provider/SegmentAnalyticsProvider';
+type $Dictionary<T = unknown> = {
+    [key: string]: T;
+};
+interface TopUpViewProps {
+    widgetEvent: IMTBLWidgetEvents;
+    checkout?: Checkout;
+    provider?: WrappedBrowserProvider;
+    showOnrampOption: boolean;
+    showSwapOption: boolean;
+    showBridgeOption: boolean;
+    tokenAddress?: string;
+    amount?: string;
+    analytics: {
+        userJourney: UserJourney;
+    };
+    onCloseButtonClick: () => void;
+    onBackButtonClick?: () => void;
+    heading?: [key: string, options?: $Dictionary];
+    subheading?: [key: string, options?: $Dictionary];
+}
+export declare const TOOLKIT_BASE_URL: {
+    sandbox: string;
+    production: string;
+};
+export declare function TopUpView({ widgetEvent, checkout, provider, // Keep this for future use
+showOnrampOption, showSwapOption, showBridgeOption, tokenAddress, amount, analytics, onCloseButtonClick, onBackButtonClick, heading, subheading, }: TopUpViewProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/widgets/BaseWidgetRoot.d.ts

@@ -0,0 +1,39 @@
+import { Root } from 'react-dom/client';
+import { Widget, Checkout, WidgetProperties, WidgetType, WidgetEventData, WidgetParameters, WrappedBrowserProvider } from '@imtbl/checkout-sdk';
+import { StrongCheckoutWidgetsConfig } from '../lib/withDefaultWidgetConfig';
+export declare abstract class Base<T extends WidgetType> implements Widget<T> {
+    protected checkout: Checkout;
+    protected targetId?: string;
+    protected reactRoot?: Root;
+    protected widgetElement?: HTMLElement;
+    protected properties: WidgetProperties<T>;
+    protected parameters: WidgetParameters[T];
+    protected browserProvider: WrappedBrowserProvider | undefined;
+    protected eventHandlers: Map<keyof WidgetEventData[T], Function>;
+    protected eventHandlersFunction?: (event: any) => void;
+    protected eventTopic: string;
+    constructor(sdk: Checkout, props: WidgetProperties<T>);
+    private setLanguage;
+    unmount(): void;
+    mount(id: string, params?: WidgetParameters[T]): void;
+    update(props: WidgetProperties<T>): void;
+    addListener<KEventName extends keyof WidgetEventData[T]>(type: KEventName, callback: (data: WidgetEventData[T][KEventName]) => void): void;
+    removeListener<KEventName extends keyof WidgetEventData[T]>(type: KEventName): void;
+    protected strongConfig(): StrongCheckoutWidgetsConfig;
+    protected abstract render(): void;
+    protected abstract getValidatedProperties(props: WidgetProperties<T>): WidgetProperties<T>;
+    protected abstract getValidatedParameters(params: WidgetParameters[T]): WidgetParameters[T];
+    private setupProviderUpdatedListener;
+    private setupDisconnectProviderListener;
+    private handleEIP1193ProviderEvents;
+    /**
+     * Handles the PROVIDER_UPDATED event by and sets browserProvider on widgetRoot
+     * This must unsubscribe and re-subscribe to EIP-1193 events on the underlying provider
+     * After setting the new browserProvider, render the widget again.
+     */
+    private handleProviderUpdatedEvent;
+    /**
+     * Handles disconnect event from the wallet widget
+     */
+    private handleDisconnectEvent;
+}

package/dist/types/widgets/add-tokens/AddTokensRoot.d.ts

@@ -0,0 +1,8 @@
+import { IMTBLWidgetEvents, WidgetProperties, WidgetType, AddTokensWidgetParams } from '@imtbl/checkout-sdk';
+import { Base } from '../BaseWidgetRoot';
+export declare class AddTokens extends Base<WidgetType.ADD_TOKENS> {
+    protected eventTopic: IMTBLWidgetEvents;
+    protected getValidatedProperties({ config, }: WidgetProperties<WidgetType.ADD_TOKENS>): WidgetProperties<WidgetType.ADD_TOKENS>;
+    protected getValidatedParameters(params: AddTokensWidgetParams): AddTokensWidgetParams;
+    protected render(): void;
+}

package/dist/types/widgets/add-tokens/AddTokensWidget.d.ts

@@ -0,0 +1,6 @@
+import { AddTokensWidgetParams } from '@imtbl/checkout-sdk';
+import { StrongCheckoutWidgetsConfig } from '../../lib/withDefaultWidgetConfig';
+export type AddTokensWidgetInputs = Omit<AddTokensWidgetParams, 'toProvider'> & {
+    config: StrongCheckoutWidgetsConfig;
+};
+export default function AddTokensWidget({ showOnrampOption, showSwapOption, showBridgeOption, toTokenAddress, toAmount, showBackButton, config, }: AddTokensWidgetInputs): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/widgets/add-tokens/AddTokensWidgetEvents.d.ts

@@ -0,0 +1,5 @@
+import { EIP6963ProviderInfo, WrappedBrowserProvider } from '@imtbl/checkout-sdk';
+export declare function sendAddTokensCloseEvent(eventTarget: Window | EventTarget): void;
+export declare function sendConnectProviderSuccessEvent(eventTarget: Window | EventTarget, providerType: 'from' | 'to', provider: WrappedBrowserProvider, providerInfo: EIP6963ProviderInfo): void;
+export declare const sendAddTokensSuccessEvent: (eventTarget: Window | EventTarget, transactionHash: string) => void;
+export declare const sendAddTokensFailedEvent: (eventTarget: Window | EventTarget, reason: string) => void;

package/dist/types/widgets/add-tokens/components/AddressMissmatchDrawer.d.ts

@@ -0,0 +1,5 @@
+export interface AddressMissmatchDrawerProps {
+    visible: boolean;
+    onClick: () => void;
+}
+export declare function AddressMissmatchDrawer({ visible, onClick, }: AddressMissmatchDrawerProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/widgets/add-tokens/components/FiatOption.d.ts

@@ -0,0 +1,11 @@
+import { MenuItemSize } from '@biom3/react';
+import { ReactElement } from 'react';
+import { FiatOptionType } from '../types';
+export interface FiatOptionProps<RC extends ReactElement | undefined = undefined> {
+    rc?: RC;
+    type: FiatOptionType;
+    onClick?: (type: FiatOptionType) => void;
+    disabled?: boolean;
+    size?: MenuItemSize;
+}
+export declare function FiatOption<RC extends ReactElement | undefined = undefined>({ type, onClick, disabled, size, rc, }: FiatOptionProps<RC>): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/widgets/add-tokens/components/OnboardingDrawer.d.ts

@@ -0,0 +1,5 @@
+import { Environment } from '@imtbl/config';
+export type OnboardingDrawerProps = {
+    environment: Environment;
+};
+export declare function OnboardingDrawer({ environment }: OnboardingDrawerProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/widgets/add-tokens/components/Options.d.ts

@@ -0,0 +1,16 @@
+import { MenuItemSize } from '@biom3/react';
+import { Checkout } from '@imtbl/checkout-sdk';
+import { FiatOptionType } from '../types';
+import { Chain, RouteData } from '../../../lib/squid/types';
+export interface OptionsProps {
+    checkout: Checkout;
+    chains: Chain[] | null;
+    onCardClick: (type: FiatOptionType) => void;
+    onRouteClick: (route: RouteData, index: number) => void;
+    routes?: RouteData[];
+    size?: MenuItemSize;
+    showOnrampOption?: boolean;
+    insufficientBalance?: boolean;
+    selectedIndex: number;
+}
+export declare function Options({ checkout, routes, chains, onCardClick, onRouteClick, size, showOnrampOption, insufficientBalance, selectedIndex, }: OptionsProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/widgets/add-tokens/components/OptionsDrawer.d.ts

@@ -0,0 +1,17 @@
+import { Checkout } from '@imtbl/checkout-sdk';
+import { FiatOptionType } from '../types';
+import { RouteData } from '../../../lib/squid/types';
+type OptionsDrawerProps = {
+    checkout: Checkout;
+    routes: RouteData[] | undefined;
+    visible: boolean;
+    onClose: () => void;
+    onRouteClick: (route: RouteData) => void;
+    onCardClick: (type: FiatOptionType) => void;
+    showOnrampOption?: boolean;
+    showSwapOption?: boolean;
+    showBridgeOption?: boolean;
+    insufficientBalance?: boolean;
+};
+export declare function OptionsDrawer({ checkout, routes, visible, onClose, onRouteClick, onCardClick, showOnrampOption, showSwapOption, showBridgeOption, insufficientBalance, }: OptionsDrawerProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/widgets/add-tokens/components/RouteFees.d.ts

@@ -0,0 +1,9 @@
+import { RouteResponse } from '@0xsquid/squid-types';
+export type RouteFeesProps = {
+    visible: boolean;
+    onClose: () => void;
+    routeData: RouteResponse | undefined;
+    totalAmount: number;
+    totalFiatAmount: number;
+};
+export declare function RouteFees({ visible, onClose, routeData, totalAmount, totalFiatAmount, }: RouteFeesProps): import("@emotion/react/jsx-runtime").JSX.Element | null;

package/dist/types/widgets/add-tokens/components/RouteOption.d.ts

@@ -0,0 +1,14 @@
+import { MenuItemSize } from '@biom3/react';
+import { ReactElement } from 'react';
+import { Chain, RouteData } from '../../../lib/squid/types';
+export interface RouteOptionProps<RC extends ReactElement | undefined = undefined> {
+    routeData: RouteData;
+    chains: Chain[] | null;
+    onClick: (route: RouteData) => void;
+    disabled?: boolean;
+    isFastest?: boolean;
+    size?: MenuItemSize;
+    rc?: RC;
+    selected?: boolean;
+}
+export declare function RouteOption<RC extends ReactElement | undefined = undefined>({ routeData, onClick, chains, disabled, isFastest, size, rc, selected, }: RouteOptionProps<RC>): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/widgets/add-tokens/components/SelectedRouteOption.d.ts

@@ -0,0 +1,14 @@
+import { MouseEventHandler } from 'react';
+import { Checkout } from '@imtbl/checkout-sdk';
+import { Chain, RouteData } from '../../../lib/squid/types';
+export interface SelectedRouteOptionProps {
+    checkout: Checkout;
+    routeData?: RouteData;
+    chains: Chain[] | null;
+    onClick: MouseEventHandler<HTMLSpanElement>;
+    loading?: boolean;
+    withSelectedWallet?: boolean;
+    insufficientBalance?: boolean;
+    showOnrampOption?: boolean;
+}
+export declare function SelectedRouteOption({ checkout, routeData, chains, loading, withSelectedWallet, insufficientBalance, showOnrampOption, onClick, }: SelectedRouteOptionProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/widgets/add-tokens/components/SelectedWallet.d.ts

@@ -0,0 +1,20 @@
+import { MouseEventHandler, ReactNode } from 'react';
+import { SxProps } from '@biom3/react';
+import { EIP6963ProviderInfo } from '@imtbl/checkout-sdk';
+export type ChainInfo = {
+    name: string;
+    iconUrl: string;
+};
+export interface SelectedWalletProps {
+    children?: ReactNode;
+    label: string;
+    caption?: string;
+    providerInfo?: Partial<EIP6963ProviderInfo & {
+        address?: string;
+    }>;
+    chainInfo?: ChainInfo;
+    onClick: MouseEventHandler<HTMLSpanElement>;
+    disabled?: boolean;
+    sx?: SxProps;
+}
+export declare function SelectedWallet({ label, caption, children, onClick, providerInfo, chainInfo, disabled, sx, }: SelectedWalletProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/widgets/add-tokens/components/TokenDrawerMenu.d.ts

@@ -0,0 +1,12 @@
+import { Checkout } from '@imtbl/checkout-sdk';
+import { Dispatch } from 'react';
+import type { StrongCheckoutWidgetsConfig } from '../../../lib/withDefaultWidgetConfig';
+import { AddTokensAction, AddTokensState } from '../context/AddTokensContext';
+export interface TokenDrawerMenuProps {
+    checkout: Checkout;
+    config: StrongCheckoutWidgetsConfig;
+    toTokenAddress?: string;
+    addTokensState: AddTokensState;
+    addTokensDispatch: Dispatch<AddTokensAction>;
+}
+export declare function TokenDrawerMenu({ checkout, config, toTokenAddress, addTokensState, addTokensDispatch, }: TokenDrawerMenuProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/widgets/add-tokens/context/AddTokensContext.d.ts

@@ -0,0 +1,87 @@
+import { TokenInfo } from '@imtbl/checkout-sdk';
+import { Squid } from '@0xsquid/sdk';
+import { TokenBalance } from '@0xsquid/sdk/dist/types';
+import { Chain, RouteData, Token } from '../../../lib/squid/types';
+export interface AddTokensState {
+    id: string;
+    allowedTokens: TokenInfo[] | null;
+    squid: Squid | null;
+    chains: Chain[] | null;
+    balances: TokenBalance[] | null;
+    tokens: Token[] | null;
+    routes: RouteData[];
+    selectedRouteData: RouteData | undefined;
+    selectedToken: TokenInfo | undefined;
+    selectedAmount: string;
+    isSwapAvailable: boolean | undefined;
+}
+export declare const initialAddTokensState: AddTokensState;
+export interface AddTokensContextState {
+    addTokensState: AddTokensState;
+    addTokensDispatch: React.Dispatch<AddTokensAction>;
+}
+export interface AddTokensAction {
+    payload: ActionPayload;
+}
+type ActionPayload = SetId | SetAllowedTokensPayload | SetSquid | SetChains | SetBalances | SetTokens | SetRoutes | SetSelectedRouteData | SetSelectedToken | SetSelectedAmount | SetIsSwapAvailable;
+export declare enum AddTokensActions {
+    SET_ID = "SET_ID",
+    SET_ALLOWED_TOKENS = "SET_ALLOWED_TOKENS",
+    SET_SQUID = "SET_SQUID",
+    SET_CHAINS = "SET_CHAINS",
+    SET_BALANCES = "SET_BALANCES",
+    SET_TOKENS = "SET_TOKENS",
+    SET_ROUTES = "SET_ROUTES",
+    SET_SELECTED_ROUTE_DATA = "SET_SELECTED_ROUTE_DATA",
+    SET_SELECTED_TOKEN = "SET_SELECTED_TOKEN",
+    SET_SELECTED_AMOUNT = "SET_SELECTED_AMOUNT",
+    SET_IS_SWAP_AVAILABLE = "SET_IS_SWAP_AVAILABLE"
+}
+export interface SetId {
+    type: AddTokensActions.SET_ID;
+    id: string;
+}
+export interface SetAllowedTokensPayload {
+    type: AddTokensActions.SET_ALLOWED_TOKENS;
+    allowedTokens: TokenInfo[];
+}
+export interface SetSquid {
+    type: AddTokensActions.SET_SQUID;
+    squid: Squid;
+}
+export interface SetChains {
+    type: AddTokensActions.SET_CHAINS;
+    chains: Chain[];
+}
+export interface SetBalances {
+    type: AddTokensActions.SET_BALANCES;
+    balances: TokenBalance[];
+}
+export interface SetTokens {
+    type: AddTokensActions.SET_TOKENS;
+    tokens: Token[];
+}
+export interface SetRoutes {
+    type: AddTokensActions.SET_ROUTES;
+    routes: RouteData[];
+}
+export interface SetSelectedRouteData {
+    type: AddTokensActions.SET_SELECTED_ROUTE_DATA;
+    selectedRouteData: RouteData | undefined;
+}
+export interface SetSelectedToken {
+    type: AddTokensActions.SET_SELECTED_TOKEN;
+    selectedToken: TokenInfo | undefined;
+}
+export interface SetSelectedAmount {
+    type: AddTokensActions.SET_SELECTED_AMOUNT;
+    selectedAmount: string;
+}
+export interface SetIsSwapAvailable {
+    type: AddTokensActions.SET_IS_SWAP_AVAILABLE;
+    isSwapAvailable: boolean;
+}
+export declare const AddTokensContext: import("react").Context<AddTokensContextState>;
+export type Reducer<S, A> = (prevState: S, action: A) => S;
+export declare const addTokensReducer: Reducer<AddTokensState, AddTokensAction>;
+export {};

package/dist/types/widgets/add-tokens/functions/amountValidation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Validate the amount input
+ * @param amount - The amount to validate
+ * @returns An object containing the sanitized value, the float amount, and a boolean indicating if the amount is valid
+ */
+export declare const validateToAmount: (amount: string) => {
+    value: string;
+    amount: number;
+    isValid: boolean;
+};

package/dist/types/widgets/add-tokens/functions/checkSanctionedAddresses.d.ts

@@ -0,0 +1,2 @@
+import { CheckoutConfiguration } from '@imtbl/checkout-sdk';
+export declare const checkSanctionedAddresses: (addresses: string[], config: CheckoutConfiguration) => Promise<boolean>;

package/dist/types/widgets/add-tokens/functions/convertToNetworkChangeableProvider.d.ts

@@ -0,0 +1,2 @@
+import { WrappedBrowserProvider } from '@imtbl/checkout-sdk';
+export declare const convertToNetworkChangeableProvider: (provider: WrappedBrowserProvider) => WrappedBrowserProvider;

package/dist/types/widgets/add-tokens/functions/delay.d.ts

@@ -0,0 +1 @@
+export declare const delay: (ms: number) => Promise<unknown>;

package/dist/types/widgets/add-tokens/functions/errorType.d.ts

@@ -0,0 +1 @@
+export declare function isRejectedError(err: unknown): boolean;

package/dist/types/widgets/add-tokens/functions/getDurationFormatted.d.ts

@@ -0,0 +1 @@
+export declare function getDurationFormatted(estimatedRouteDuration: number, minutesText: string, minuteText: string, secondText: string): string;

package/dist/types/widgets/add-tokens/functions/getFormattedNumber.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Formats a number to a string with a maximum number of decimals
+ * removing trailing zeros
+ */
+export declare const getFormattedAmounts: (value: string | number, maxDecimals?: number) => string;
+/**
+ * Converts a crypto amount to a formatted string
+ */
+export declare function getFormattedNumber(value?: string | number, decimals?: number, maxDecimals?: number): string;

package/dist/types/widgets/add-tokens/functions/onboardingState.d.ts

@@ -0,0 +1,7 @@
+export declare const addTokensOnboardingCache: LocalForage;
+export declare const SEEN_ONBOARDING_KEY = "seen-onboarding";
+export declare function getCacheItem(key: string): Promise<boolean | null>;
+export declare function setCacheItem(key: string, value: boolean): Promise<{
+    value: boolean;
+}>;
+export declare function clearCacheItems(): Promise<void>;

package/dist/types/widgets/add-tokens/hooks/useError.d.ts

@@ -0,0 +1,5 @@
+import { Environment } from '@imtbl/config';
+import { AddTokensErrorTypes } from '../types';
+export declare const useError: (environment: Environment) => {
+    showErrorHandover: (errorType: AddTokensErrorTypes, data?: Record<string, unknown>) => void;
+};

package/dist/types/widgets/add-tokens/types.d.ts

@@ -0,0 +1,28 @@
+export declare enum FiatOptionType {
+    CREDIT = "credit",
+    DEBIT = "debit"
+}
+export declare enum RiveStateMachineInput {
+    START = 0,
+    WAITING = 1,
+    PROCESSING = 2,
+    COMPLETED = 3,
+    ERROR = 4
+}
+export type AddTokensError = {
+    type: AddTokensErrorTypes;
+    data?: Record<string, unknown>;
+};
+export declare enum AddTokensErrorTypes {
+    DEFAULT = "DEFAULT_ERROR",
+    INVALID_PARAMETERS = "INVALID_PARAMETERS",
+    SERVICE_BREAKDOWN = "SERVICE_BREAKDOWN",
+    TRANSACTION_FAILED = "TRANSACTION_FAILED",
+    UNRECOGNISED_CHAIN = "UNRECOGNISED_CHAIN",
+    PROVIDER_ERROR = "PROVIDER_ERROR",
+    WALLET_FAILED = "WALLET_FAILED",
+    WALLET_REJECTED = "WALLET_REJECTED",
+    WALLET_REJECTED_NO_FUNDS = "WALLET_REJECTED_NO_FUNDS",
+    WALLET_POPUP_BLOCKED = "WALLET_POPUP_BLOCKED",
+    ENVIRONMENT_ERROR = "ENVIRONMENT_ERROR"
+}

package/dist/types/widgets/add-tokens/utils/animation.d.ts

@@ -0,0 +1 @@
+export declare const PULSE_SHADOW: import("@emotion/react").Keyframes;