@wheelx-widget/widget 0.1.19 → 0.3.0

package/dist/index.d.mts

@@ -72,6 +72,8 @@ interface WidgetConfig {
     evmDifferentAddress?: string;
     /** Solana链固定收款异地址（base58格式）。配置后，to网络为Solana链时优先使用此地址 */
     solanaDifferentAddress?: string;
+    /** Tron链固定收款异地址（T地址格式，以T开头）。配置后，to网络为Tron链时优先使用此地址 */
+    tronDifferentAddress?: string;
     /**
      * 返佣ID（affiliation code）。
      * 配置后在 quote 请求中优先使用此值；为空时回退到从 URL path 中提取。
@@ -85,7 +87,7 @@ interface WheelXProviderProps {
 }
 declare const WheelXProvider: React.FC<WheelXProviderProps>;
 
-interface routesItem {
+interface routesItem$1 {
     name: string;
     logo: string;
 }
@@ -106,7 +108,11 @@ interface TxInfoProps {
     amountOut: string;
     fromTokenInUsd?: Fraction;
     router_type: string | null | undefined;
-    routes?: routesItem[] | undefined;
+    routes?: routesItem$1[] | undefined;
+    onToggleAiRouter?: () => void;
+    hasMultipleQuotes?: boolean;
+    /** Current quote request_id — TxInfo re-expands whenever it changes */
+    quoteRequestId?: string | null;
 }
 
 interface RefetchQuoteParams {
@@ -123,8 +129,53 @@ interface QuoteRequest {
     to_address: string;
     amount: string;
     slippage?: number;
+    /** Whether the user is in auto (recommended) slippage mode — recorded by
+     * the backend. false = manual preset/custom value. */
+    is_auto_slippage?: boolean;
     to_platform_id: number;
     sponsor_gas?: boolean;
+    btc_transfer_mode?: 'psbt' | 'deposit';
+}
+interface routesItem {
+    name: string;
+    logo: string;
+}
+interface QuoteItem {
+    request_id: string;
+    router: string;
+    amount_out: string;
+    tx: {
+        chainId: number;
+        data: `0x${string}`;
+        to: `0x${string}`;
+        value: string;
+        gas?: bigint | null;
+        maxFeePerGas?: bigint | undefined;
+        maxPriorityFeePerGas?: bigint | undefined;
+        message?: string;
+        sender?: string;
+        tx?: string;
+        psbt?: string;
+        encoding?: string;
+        /** JSON-serialized TronTxInfo for Tron approve transactions */
+        approveTx?: string;
+    };
+    routes: routesItem[];
+    gas_fee?: string | null;
+    /** Provider fee (USD) — legacy fallback: `fee_usd` */
+    fee_usd?: string | null;
+    /** Network cost (USD) */
+    native_fee_usd?: string | null;
+    /** Per-route approve payload (ERC-20 / TRC-20) */
+    approve?: {
+        token: string;
+        spender: string;
+        amount: bigint;
+    } | null;
+    /** Deposit address for deposit-address flows (Tron / Bitcoin) */
+    deposit_address?: string | null;
+    /** Per-route estimated completion time (seconds) */
+    estimated_time?: number;
 }
 type QuoteErrorType = 'business_error' | 'http_error' | 'network_error' | 'timeout' | 'unknown_error';
 interface QuoteMutationError extends Error {
@@ -152,6 +203,8 @@ interface TokenInfo {
     platform_id?: number;
     platform_type?: string[];
     isSolana?: boolean;
+    isTron?: boolean;
+    isBitcoin?: boolean;
     fee_level?: FeeLevel;
 }
 interface TokenInfoWithBalance extends TokenInfo {
@@ -200,6 +253,32 @@ declare function getChainsAndTokens(): Promise<ChainsAndTokens>;
 declare const useChainsAndTokens: (enabled?: boolean) => _tanstack_react_query.UseQueryResult<ChainsAndTokens, Error>;
 declare function mergeTokensWithCompositeKey(arr1: TokenInfoWithBalance[], arr2: TokenInfoWithBalance[]): TokenInfoWithBalance[];
 
+/**
+ * Parameter section of a Tron transaction from the backend.
+ *
+ * Two shapes come back from the quote API:
+ * - TriggerSmartContract (TRC-20 swap / approve): contract_address + data
+ * - TransferContract (native TRX, deposit-address bridges): to_address + amount
+ *   and NO calldata at all
+ */
+interface TronTxParameter {
+    owner_address: string;
+    contract_address?: string;
+    data?: string;
+    call_value?: number;
+    /** Native TransferContract only. */
+    to_address?: string;
+    /** Native TransferContract only. */
+    amount?: number;
+}
+/** Tron transaction data returned by the quote API (tron→X swaps) */
+interface TronTxInfo {
+    parameter: TronTxParameter;
+    type: string;
+    gas: null | number;
+    chainId: number;
+}
+
 type WheelXWidgetProps = {
     config?: WidgetConfig;
 };
@@ -219,9 +298,20 @@ interface QuoteInfo {
     tx_value?: string | null;
     points?: number | 0 | string;
     quote_message?: string | null;
-    routes?: routesItem[];
+    routes?: routesItem$1[];
+    quotes?: QuoteItem[];
     solanaTxMessage?: string;
     solanaTxSender?: string;
+    tronTx?: TronTxInfo | null;
+    tronApproveTx?: TronTxInfo | null;
+    tronDepositAddress?: string | null;
+    bitcoinPsbt?: string;
+    bitcoinDepositAddress?: string | null;
+    approve?: {
+        token: string;
+        spender: string;
+        amount: bigint;
+    } | null;
 }
 interface QuoteRequestWithToTokenDecimals extends QuoteRequest {
     toTokenDecimals: number;
@@ -255,6 +345,10 @@ interface SwapState {
     shortLink?: string;
     transactionType?: string;
     autoSlippage?: number | undefined;
+    /** Session-level slippage mode: true = auto (recommended), false = manual.
+     * Synced from the per-address localStorage preference by SlippageSettings
+     * and used by the quote request funnel (getState read, always fresh). */
+    isAutoSlippage: boolean;
     tradeType?: string | null;
 }
 interface SwapAndBridgeContextStore extends SwapState {
@@ -273,6 +367,7 @@ interface SwapAndBridgeContextStore extends SwapState {
     setShortLink: (value: string) => void;
     setTransactionType: (value: string) => void;
     setAutoSlippage: (value: number | undefined) => void;
+    setIsAutoSlippage: (value: boolean) => void;
 }
 declare const useSwapAndBridgeContextStore: zustand.UseBoundStore<zustand.StoreApi<SwapAndBridgeContextStore>>;
 declare const useInitSwapAndBridgeState: (config?: WidgetConfig) => void;
@@ -296,6 +391,14 @@ interface TxStateContextStore {
     setSolanaFromTxHash: (hash: string | null) => void;
     isSolanaTransaction: boolean;
     setIsSolanaTransaction: (isSolana: boolean) => void;
+    tronFromTxHash: string | null;
+    setTronFromTxHash: (hash: string | null) => void;
+    isTronTransaction: boolean;
+    setIsTronTransaction: (isTronTransaction: boolean) => void;
+    bitcoinFromTxHash: string | null;
+    setBitcoinFromTxHash: (hash: string | null) => void;
+    isBitcoinTransaction: boolean;
+    setIsBitcoinTransaction: (isBitcoinTransaction: boolean) => void;
 }
 declare const useTxStateContextStore: zustand.UseBoundStore<zustand.StoreApi<TxStateContextStore>>;
 
@@ -312,7 +415,7 @@ declare const useRefreshLoading: () => {
 interface Props {
     chainId: number;
     tokenAddress?: `0x${string}`;
-    connectAddress?: `0x${string}`;
+    connectAddress?: string;
 }
 interface BalanceResult {
     decimals: number;
@@ -352,6 +455,27 @@ declare const useEvmAddress: () => `0x${string}` | undefined;
  * Used to detect and intercept deep links when the widget runs inside
  * a WebView (e.g., React Native, Android WebView, WKWebView).
  */
+declare global {
+    interface Window {
+        ReactNativeWebView?: {
+            postMessage?: (msg: string) => void;
+        };
+        __wheelx_wallet_callback_url__?: string;
+        __walletx_callback_params__?: Record<string, string>;
+        __wheelx_trigger_url_update__?: () => void;
+        __wheelx_callback_listener_installed?: boolean;
+        __wheelx_pending_callback__?: string;
+        DynamicLabs?: {
+            utils?: {
+                PlatformService?: unknown;
+            };
+        };
+        __DYNAMIC_LABS__?: {
+            PlatformService?: unknown;
+        };
+        PlatformService?: unknown;
+    }
+}
 /** Check if running inside a React Native WebView */
 declare const isReactNativeWebView: () => boolean;
 /** Check if running in any WebView (Android/iOS) */
@@ -399,11 +523,19 @@ interface WalletStore {
     setIsEthWalletConnected: (isEthWalletConnected: boolean) => void;
     isSolanaWalletConnected: boolean;
     setIsSolanaWalletConnected: (isSolanaWalletConnected: boolean) => void;
+    isTronWalletConnected: boolean;
+    setIsTronWalletConnected: (isTronWalletConnected: boolean) => void;
+    isBitcoinWalletConnected: boolean;
+    setIsBitcoinWalletConnected: (isBitcoinWalletConnected: boolean) => void;
     totalConnectedWallets: number;
     setTotalConnectedWallets: () => void;
     totalWallets: number;
     solanaWalletAddress: string | null;
     setSolanaWalletAddress: (address: string | null) => void;
+    tronWalletAddress: string | null;
+    setTronWalletAddress: (address: string | null) => void;
+    bitcoinWalletAddress: string | null;
+    setBitcoinWalletAddress: (address: string | null) => void;
     evmWalletAddress: string | null;
     evmWalletConnectorId: string | null;
     setEvmWalletInfo: (address: string | null, connectorId: string | null) => void;

package/dist/index.d.ts

@@ -72,6 +72,8 @@ interface WidgetConfig {
     evmDifferentAddress?: string;
     /** Solana链固定收款异地址（base58格式）。配置后，to网络为Solana链时优先使用此地址 */
     solanaDifferentAddress?: string;
+    /** Tron链固定收款异地址（T地址格式，以T开头）。配置后，to网络为Tron链时优先使用此地址 */
+    tronDifferentAddress?: string;
     /**
      * 返佣ID（affiliation code）。
      * 配置后在 quote 请求中优先使用此值；为空时回退到从 URL path 中提取。
@@ -85,7 +87,7 @@ interface WheelXProviderProps {
 }
 declare const WheelXProvider: React.FC<WheelXProviderProps>;
 
-interface routesItem {
+interface routesItem$1 {
     name: string;
     logo: string;
 }
@@ -106,7 +108,11 @@ interface TxInfoProps {
     amountOut: string;
     fromTokenInUsd?: Fraction;
     router_type: string | null | undefined;
-    routes?: routesItem[] | undefined;
+    routes?: routesItem$1[] | undefined;
+    onToggleAiRouter?: () => void;
+    hasMultipleQuotes?: boolean;
+    /** Current quote request_id — TxInfo re-expands whenever it changes */
+    quoteRequestId?: string | null;
 }
 
 interface RefetchQuoteParams {
@@ -123,8 +129,53 @@ interface QuoteRequest {
     to_address: string;
     amount: string;
     slippage?: number;
+    /** Whether the user is in auto (recommended) slippage mode — recorded by
+     * the backend. false = manual preset/custom value. */
+    is_auto_slippage?: boolean;
     to_platform_id: number;
     sponsor_gas?: boolean;
+    btc_transfer_mode?: 'psbt' | 'deposit';
+}
+interface routesItem {
+    name: string;
+    logo: string;
+}
+interface QuoteItem {
+    request_id: string;
+    router: string;
+    amount_out: string;
+    tx: {
+        chainId: number;
+        data: `0x${string}`;
+        to: `0x${string}`;
+        value: string;
+        gas?: bigint | null;
+        maxFeePerGas?: bigint | undefined;
+        maxPriorityFeePerGas?: bigint | undefined;
+        message?: string;
+        sender?: string;
+        tx?: string;
+        psbt?: string;
+        encoding?: string;
+        /** JSON-serialized TronTxInfo for Tron approve transactions */
+        approveTx?: string;
+    };
+    routes: routesItem[];
+    gas_fee?: string | null;
+    /** Provider fee (USD) — legacy fallback: `fee_usd` */
+    fee_usd?: string | null;
+    /** Network cost (USD) */
+    native_fee_usd?: string | null;
+    /** Per-route approve payload (ERC-20 / TRC-20) */
+    approve?: {
+        token: string;
+        spender: string;
+        amount: bigint;
+    } | null;
+    /** Deposit address for deposit-address flows (Tron / Bitcoin) */
+    deposit_address?: string | null;
+    /** Per-route estimated completion time (seconds) */
+    estimated_time?: number;
 }
 type QuoteErrorType = 'business_error' | 'http_error' | 'network_error' | 'timeout' | 'unknown_error';
 interface QuoteMutationError extends Error {
@@ -152,6 +203,8 @@ interface TokenInfo {
     platform_id?: number;
     platform_type?: string[];
     isSolana?: boolean;
+    isTron?: boolean;
+    isBitcoin?: boolean;
     fee_level?: FeeLevel;
 }
 interface TokenInfoWithBalance extends TokenInfo {
@@ -200,6 +253,32 @@ declare function getChainsAndTokens(): Promise<ChainsAndTokens>;
 declare const useChainsAndTokens: (enabled?: boolean) => _tanstack_react_query.UseQueryResult<ChainsAndTokens, Error>;
 declare function mergeTokensWithCompositeKey(arr1: TokenInfoWithBalance[], arr2: TokenInfoWithBalance[]): TokenInfoWithBalance[];
 
+/**
+ * Parameter section of a Tron transaction from the backend.
+ *
+ * Two shapes come back from the quote API:
+ * - TriggerSmartContract (TRC-20 swap / approve): contract_address + data
+ * - TransferContract (native TRX, deposit-address bridges): to_address + amount
+ *   and NO calldata at all
+ */
+interface TronTxParameter {
+    owner_address: string;
+    contract_address?: string;
+    data?: string;
+    call_value?: number;
+    /** Native TransferContract only. */
+    to_address?: string;
+    /** Native TransferContract only. */
+    amount?: number;
+}
+/** Tron transaction data returned by the quote API (tron→X swaps) */
+interface TronTxInfo {
+    parameter: TronTxParameter;
+    type: string;
+    gas: null | number;
+    chainId: number;
+}
+
 type WheelXWidgetProps = {
     config?: WidgetConfig;
 };
@@ -219,9 +298,20 @@ interface QuoteInfo {
     tx_value?: string | null;
     points?: number | 0 | string;
     quote_message?: string | null;
-    routes?: routesItem[];
+    routes?: routesItem$1[];
+    quotes?: QuoteItem[];
     solanaTxMessage?: string;
     solanaTxSender?: string;
+    tronTx?: TronTxInfo | null;
+    tronApproveTx?: TronTxInfo | null;
+    tronDepositAddress?: string | null;
+    bitcoinPsbt?: string;
+    bitcoinDepositAddress?: string | null;
+    approve?: {
+        token: string;
+        spender: string;
+        amount: bigint;
+    } | null;
 }
 interface QuoteRequestWithToTokenDecimals extends QuoteRequest {
     toTokenDecimals: number;
@@ -255,6 +345,10 @@ interface SwapState {
     shortLink?: string;
     transactionType?: string;
     autoSlippage?: number | undefined;
+    /** Session-level slippage mode: true = auto (recommended), false = manual.
+     * Synced from the per-address localStorage preference by SlippageSettings
+     * and used by the quote request funnel (getState read, always fresh). */
+    isAutoSlippage: boolean;
     tradeType?: string | null;
 }
 interface SwapAndBridgeContextStore extends SwapState {
@@ -273,6 +367,7 @@ interface SwapAndBridgeContextStore extends SwapState {
     setShortLink: (value: string) => void;
     setTransactionType: (value: string) => void;
     setAutoSlippage: (value: number | undefined) => void;
+    setIsAutoSlippage: (value: boolean) => void;
 }
 declare const useSwapAndBridgeContextStore: zustand.UseBoundStore<zustand.StoreApi<SwapAndBridgeContextStore>>;
 declare const useInitSwapAndBridgeState: (config?: WidgetConfig) => void;
@@ -296,6 +391,14 @@ interface TxStateContextStore {
     setSolanaFromTxHash: (hash: string | null) => void;
     isSolanaTransaction: boolean;
     setIsSolanaTransaction: (isSolana: boolean) => void;
+    tronFromTxHash: string | null;
+    setTronFromTxHash: (hash: string | null) => void;
+    isTronTransaction: boolean;
+    setIsTronTransaction: (isTronTransaction: boolean) => void;
+    bitcoinFromTxHash: string | null;
+    setBitcoinFromTxHash: (hash: string | null) => void;
+    isBitcoinTransaction: boolean;
+    setIsBitcoinTransaction: (isBitcoinTransaction: boolean) => void;
 }
 declare const useTxStateContextStore: zustand.UseBoundStore<zustand.StoreApi<TxStateContextStore>>;
 
@@ -312,7 +415,7 @@ declare const useRefreshLoading: () => {
 interface Props {
     chainId: number;
     tokenAddress?: `0x${string}`;
-    connectAddress?: `0x${string}`;
+    connectAddress?: string;
 }
 interface BalanceResult {
     decimals: number;
@@ -352,6 +455,27 @@ declare const useEvmAddress: () => `0x${string}` | undefined;
  * Used to detect and intercept deep links when the widget runs inside
  * a WebView (e.g., React Native, Android WebView, WKWebView).
  */
+declare global {
+    interface Window {
+        ReactNativeWebView?: {
+            postMessage?: (msg: string) => void;
+        };
+        __wheelx_wallet_callback_url__?: string;
+        __walletx_callback_params__?: Record<string, string>;
+        __wheelx_trigger_url_update__?: () => void;
+        __wheelx_callback_listener_installed?: boolean;
+        __wheelx_pending_callback__?: string;
+        DynamicLabs?: {
+            utils?: {
+                PlatformService?: unknown;
+            };
+        };
+        __DYNAMIC_LABS__?: {
+            PlatformService?: unknown;
+        };
+        PlatformService?: unknown;
+    }
+}
 /** Check if running inside a React Native WebView */
 declare const isReactNativeWebView: () => boolean;
 /** Check if running in any WebView (Android/iOS) */
@@ -399,11 +523,19 @@ interface WalletStore {
     setIsEthWalletConnected: (isEthWalletConnected: boolean) => void;
     isSolanaWalletConnected: boolean;
     setIsSolanaWalletConnected: (isSolanaWalletConnected: boolean) => void;
+    isTronWalletConnected: boolean;
+    setIsTronWalletConnected: (isTronWalletConnected: boolean) => void;
+    isBitcoinWalletConnected: boolean;
+    setIsBitcoinWalletConnected: (isBitcoinWalletConnected: boolean) => void;
     totalConnectedWallets: number;
     setTotalConnectedWallets: () => void;
     totalWallets: number;
     solanaWalletAddress: string | null;
     setSolanaWalletAddress: (address: string | null) => void;
+    tronWalletAddress: string | null;
+    setTronWalletAddress: (address: string | null) => void;
+    bitcoinWalletAddress: string | null;
+    setBitcoinWalletAddress: (address: string | null) => void;
     evmWalletAddress: string | null;
     evmWalletConnectorId: string | null;
     setEvmWalletInfo: (address: string | null, connectorId: string | null) => void;