@wheelx-widget/widget 0.1.10 → 0.1.11

package/dist/index.d.mts

@@ -0,0 +1,363 @@
+import React from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Fraction } from 'bi-fraction';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import * as zustand from 'zustand';
+
+interface TokenConfig {
+    chainId: number;
+    address: string;
+    decimals?: number;
+    symbol?: string;
+    name?: string;
+    logo?: string;
+}
+interface WidgetTheme {
+    defaultTextColor: string;
+    highlightTextColor: string;
+    weakTextColor: string;
+    defaultBgColor: string;
+    highlightBgColor: string;
+    assistBgColor: string;
+    defaultBorderColor: string;
+    highlightBorderColor: string;
+    highlightButtonBg: string;
+    highlightButtonText: string;
+    normalButtonBg: string;
+    normalButtonText: string;
+    disabledButtonBg: string;
+    disabledButtonText: string;
+}
+interface WidgetConfig {
+    theme?: Partial<WidgetTheme>;
+    from?: {
+        chains?: number[];
+        defaultChainId?: number;
+        chainTokens?: Record<number, TokenConfig[]>;
+        defaultToken?: {
+            chainId: number;
+            address: string;
+        };
+    };
+    to?: {
+        chains?: number[];
+        defaultChainId?: number;
+        chainTokens?: Record<number, TokenConfig[]>;
+        defaultToken?: {
+            chainId: number;
+            address: string;
+        };
+    };
+    routerCallback?: {
+        onPathnameChange?: (pathname: string) => void;
+        onRouteLeave?: () => void;
+        getCurrentPathname?: () => string;
+    };
+    dynamicEnvironmentId?: string;
+}
+
+interface WheelXProviderProps {
+    config?: WidgetConfig;
+    children: React.ReactNode;
+}
+declare const WheelXProvider: React.FC<WheelXProviderProps>;
+
+interface routesItem {
+    name: string;
+    logo: string;
+}
+interface TxInfoProps {
+    priceImpact: {
+        bridgeFee: string;
+        dstGasFee: string;
+        swapFee: string;
+        before_discount_fee: string;
+        discount_percentage: string | undefined;
+    };
+    slippage: number;
+    minReceive: string;
+    estimatedTime: number;
+    recipient: string;
+    router: string;
+    points: number | string;
+    amountOut: string;
+    fromTokenInUsd?: Fraction;
+    router_type: string | null | undefined;
+    routes?: routesItem[] | undefined;
+}
+
+interface RefetchQuoteParams {
+    slippageValue?: string;
+    isAutoSlippage?: boolean;
+}
+
+interface QuoteRequest {
+    from_chain: number;
+    to_chain: number;
+    from_token: string;
+    to_token: string;
+    from_address: string;
+    to_address: string;
+    amount: string;
+    slippage?: number;
+    to_platform_id: number;
+}
+type QuoteErrorType = 'business_error' | 'http_error' | 'network_error' | 'timeout' | 'unknown_error';
+interface QuoteMutationError extends Error {
+    httpStatus?: number;
+    hasResponseBody?: boolean;
+    errorType?: QuoteErrorType;
+    detail?: string;
+    code?: string;
+}
+
+type Tag = 'pin' | 'top' | 'cert' | 'native';
+type FeeLevel = 'Group1' | 'Group2' | null;
+interface TokenInfo {
+    name: string;
+    address: `0x${string}`;
+    chain_id: number;
+    decimals: number;
+    symbol: string;
+    logo: string;
+    tags: Tag[];
+    support_kline?: boolean;
+    token_type?: string;
+    categories?: string[];
+    chain_icon?: string;
+    platform_id?: number;
+    platform_type?: string[];
+    isSolana?: boolean;
+    fee_level?: FeeLevel;
+}
+interface TokenInfoWithBalance extends TokenInfo {
+    balance?: string;
+    usdPrice?: string;
+}
+type ChainInfo = {
+    name: string;
+    rpc_url: string;
+    rpc_fallback: string[];
+    chain_icon: string;
+    chain_id: number;
+    eth_token: `0x${string}`;
+    support_kline: boolean;
+    is_popular: boolean;
+    outbound: boolean;
+    inbound: boolean;
+    is_testnet?: boolean;
+    platform_id?: number;
+};
+interface Prediction {
+    chains: ChainInfo[];
+    tokens: TokenInfo[];
+}
+interface SlippagePolicy {
+    bridge: boolean;
+    from_fee_level: FeeLevel;
+    to_fee_level: FeeLevel;
+    default_slippage: number;
+    min_slippage: number;
+    max_slippage: number;
+    refresh_interval: number;
+    notice_rounds?: number;
+}
+interface ChainsAndTokens {
+    chains: ChainInfo[];
+    tokens: TokenInfo[];
+    slippage_policies?: SlippagePolicy[];
+    deposit_platforms: {
+        prediction: Prediction;
+    };
+}
+declare function getChainsAndTokens(): Promise<ChainsAndTokens>;
+declare const useChainsAndTokens: (enabled?: boolean) => _tanstack_react_query.UseQueryResult<ChainsAndTokens, Error>;
+declare function mergeTokensWithCompositeKey(arr1: TokenInfoWithBalance[], arr2: TokenInfoWithBalance[]): TokenInfoWithBalance[];
+
+type WheelXWidgetProps = {
+    config?: WidgetConfig;
+};
+
+interface QuoteInfo {
+    isFetching: boolean;
+    error: string | null;
+    data: `0x${string}` | null;
+    contractAddress: `0x${string}` | null;
+    info: TxInfoProps | null;
+    request_id?: string | null;
+    gas?: bigint | null;
+    maxFeePerGas?: bigint | undefined;
+    maxPriorityFeePerGas?: bigint | undefined;
+    backApprove?: boolean;
+    router_type?: string | null;
+    tx_value?: string | null;
+    points?: number | 0 | string;
+    quote_message?: string | null;
+    routes?: routesItem[];
+    solanaTxMessage?: string;
+    solanaTxSender?: string;
+}
+interface QuoteRequestWithToTokenDecimals extends QuoteRequest {
+    toTokenDecimals: number;
+    isAutoRefetch?: boolean;
+    affiliation?: string | null;
+}
+declare const initialQuoteInfo: QuoteInfo;
+declare const WheelXWidget: ({ config }: WheelXWidgetProps) => react_jsx_runtime.JSX.Element;
+
+declare const defaultTheme: WidgetTheme;
+
+interface WidgetThemeContextValue {
+    theme: WidgetTheme;
+}
+declare const useWidgetTheme: () => WidgetThemeContextValue;
+interface WidgetThemeProviderProps {
+    theme?: Partial<WidgetTheme>;
+    children: React.ReactNode;
+}
+declare const WidgetThemeProvider: React.FC<WidgetThemeProviderProps>;
+
+interface SwapState {
+    fromTokenInfo: TokenInfo;
+    toTokenInfo: TokenInfo;
+    fromAmount: string;
+    toAmount: string;
+    slippage?: string;
+    fromAmountToUsd?: string | null;
+    toAmountToUsd?: string | null;
+    isShortLink?: boolean;
+    shortLink?: string;
+    transactionType?: string;
+    autoSlippage?: number | undefined;
+    tradeType?: string | null;
+}
+interface SwapAndBridgeContextStore extends SwapState {
+    setFromTokenInfo: (tokenInfo: TokenInfo) => void;
+    setToTokenInfo: (tokenInfo: TokenInfo) => void;
+    setFromAmount: (amount: string) => void;
+    setToAmount: (amount: string) => void;
+    switchTokens: () => void;
+    resetState: () => void;
+    setAmounts: (fromAmount: string, toAmount: string) => void;
+    resetAmounts: () => void;
+    setSlippage: (slippage?: string) => void;
+    setFromAmountToUsd: (value: string | null) => void;
+    setToAmountToUsd: (value: string | null) => void;
+    setIsShortLink: (value: boolean) => void;
+    setShortLink: (value: string) => void;
+    setTransactionType: (value: string) => void;
+    setAutoSlippage: (value: number | undefined) => void;
+}
+declare const useSwapAndBridgeContextStore: zustand.UseBoundStore<zustand.StoreApi<SwapAndBridgeContextStore>>;
+declare const useInitSwapAndBridgeState: (config?: WidgetConfig) => void;
+declare const useResetSwapAndBridgeState: () => void;
+
+interface TxStateContextStore {
+    fromTxHash: `0x${string}` | null;
+    toTxHash: `0x${string}` | null;
+    setFromTxHash: (fromTxHash: `0x${string}` | null) => void;
+    setToTxHash: (toTxHash: `0x${string}` | null) => void;
+    resetTxState: () => void;
+    startTrading: boolean;
+    setStartTrading: (startTrading: boolean) => void;
+    userCancelsTransaction: boolean;
+    setUserCancelsTransaction: (userCancelsTransaction: boolean) => void;
+    fromValue?: string | null;
+    setFromValue?: (fromValue: string | null) => void;
+    tryAgain?: boolean;
+    setTryAgain: (tryAgain: boolean) => void;
+    solanaFromTxHash: string | null;
+    setSolanaFromTxHash: (hash: string | null) => void;
+    isSolanaTransaction: boolean;
+    setIsSolanaTransaction: (isSolana: boolean) => void;
+}
+declare const useTxStateContextStore: zustand.UseBoundStore<zustand.StoreApi<TxStateContextStore>>;
+
+declare const useGuardChain: (callback: () => void, requiredChainId: number) => {
+    isSwitching: boolean;
+    sendTx: () => Promise<void>;
+};
+
+declare const useRefreshLoading: () => {
+    isLoading: boolean;
+    startLoading: () => void;
+};
+
+interface Props {
+    chainId: number;
+    tokenAddress?: `0x${string}`;
+    connectAddress?: `0x${string}`;
+}
+interface BalanceResult {
+    decimals: number;
+    formatted: string;
+    symbol: string;
+    value: bigint;
+}
+declare const useTokenBalance: ({ chainId, tokenAddress, connectAddress }: Props) => BalanceResult | undefined;
+
+interface ChainsStore {
+    chains: ChainInfo[] | null;
+    setChains: (chains: ChainInfo[]) => void;
+    isSelectPredictionChain: boolean;
+    setIsSelectPredictionChain: (isSelectPredictionChain: boolean) => void;
+    slippagePolicies: SlippagePolicy[] | null;
+    setSlippagePolicies: (policies: SlippagePolicy[]) => void;
+}
+interface TokenStore {
+    tokens: TokenInfo[] | null;
+    setTokens: (tokens: TokenInfo[]) => void;
+}
+declare const useChainsStore: zustand.UseBoundStore<zustand.StoreApi<ChainsStore>>;
+declare const useTokensStore: zustand.UseBoundStore<zustand.StoreApi<TokenStore>>;
+
+/**
+ * Hook to get EVM wallet address with fallback to saved address.
+ *
+ * Priority: saved evmWalletAddress > current wagmi address (only when store says connected).
+ *
+ * CRITICAL: The store is the single source of truth for connection state.
+ * After user disconnects, even if wagmi briefly shows connected (e.g. due to
+ * DynamicWagmiConnector reconnecting), we must NOT use wagmi's address as
+ * fallback — otherwise the UI will continue to show address/balance info
+ * after the user has explicitly disconnected.
+ *
+ * @returns The EVM wallet address, or undefined if not connected.
+ */
+declare const useEvmAddress: () => `0x${string}` | undefined;
+
+interface WalletStore {
+    isEthWalletConnected: boolean;
+    setIsEthWalletConnected: (isEthWalletConnected: boolean) => void;
+    isSolanaWalletConnected: boolean;
+    setIsSolanaWalletConnected: (isSolanaWalletConnected: boolean) => void;
+    totalConnectedWallets: number;
+    setTotalConnectedWallets: () => void;
+    totalWallets: number;
+    solanaWalletAddress: string | null;
+    setSolanaWalletAddress: (address: string | null) => void;
+    evmWalletAddress: string | null;
+    evmWalletConnectorId: string | null;
+    setEvmWalletInfo: (address: string | null, connectorId: string | null) => void;
+    isEvmWalletMetamask: boolean;
+    setIsEvmWalletMetamask: (isEvmWalletMetamask: boolean) => void;
+    isLoggingOut: boolean;
+    setIsLoggingOut: (isLoggingOut: boolean) => void;
+    /** Timestamp (ms) of the most recent manual disconnect. Used to guard
+     *  against DynamicWagmiConnector auto-reconnecting right after logout. */
+    lastDisconnectTimestamp: number;
+    setLastDisconnectTimestamp: (ts: number) => void;
+}
+declare const useWalletConnectedStore: zustand.UseBoundStore<zustand.StoreApi<WalletStore>>;
+
+interface DifferentAddressProp {
+    differentAddress: `0x${string}` | undefined | string;
+    setDifferentAddress: (address: `0x${string}` | undefined | string) => void;
+    isDepositPlatformToken: boolean;
+    setIsDepositPlatformToken: (isDepositPlatformToken: boolean) => void;
+}
+declare const useDifferentAddressStore: zustand.UseBoundStore<zustand.StoreApi<DifferentAddressProp>>;
+
+declare const useSyncWalletConnectedStore: () => void;
+
+export { type ChainInfo, type ChainsAndTokens, type FeeLevel, type QuoteErrorType, type QuoteInfo, type QuoteMutationError, type QuoteRequest, type QuoteRequestWithToTokenDecimals, type RefetchQuoteParams, type SlippagePolicy, type TokenConfig, type TokenInfo, type TxInfoProps, WheelXProvider, type WheelXProviderProps, WheelXWidget, type WheelXWidgetProps, type WidgetConfig, type WidgetTheme, WidgetThemeProvider, defaultTheme, getChainsAndTokens, initialQuoteInfo, mergeTokensWithCompositeKey, useChainsAndTokens, useChainsStore, useDifferentAddressStore, useEvmAddress, useGuardChain, useInitSwapAndBridgeState, useRefreshLoading, useResetSwapAndBridgeState, useSwapAndBridgeContextStore, useSyncWalletConnectedStore, useTokenBalance, useTokensStore, useTxStateContextStore, useWalletConnectedStore, useWidgetTheme };