@wheelx-widget/widget 0.2.0 → 0.3.0

package/dist/index.d.mts

@@ -111,6 +111,8 @@ interface TxInfoProps {
     routes?: routesItem$1[] | undefined;
     onToggleAiRouter?: () => void;
     hasMultipleQuotes?: boolean;
+    /** Current quote request_id — TxInfo re-expands whenever it changes */
+    quoteRequestId?: string | null;
 }
 
 interface RefetchQuoteParams {
@@ -127,8 +129,12 @@ 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;
@@ -149,9 +155,27 @@ interface QuoteItem {
         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 {
@@ -180,6 +204,7 @@ interface TokenInfo {
     platform_type?: string[];
     isSolana?: boolean;
     isTron?: boolean;
+    isBitcoin?: boolean;
     fee_level?: FeeLevel;
 }
 interface TokenInfoWithBalance extends TokenInfo {
@@ -225,9 +250,35 @@ interface ChainsAndTokens {
     };
 }
 declare function getChainsAndTokens(): Promise<ChainsAndTokens>;
-declare const useChainsAndTokens: (enabled?: boolean) => _tanstack_react_query.UseQueryResult<NoInfer<ChainsAndTokens>, Error>;
+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;
 };
@@ -251,6 +302,16 @@ interface QuoteInfo {
     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;
@@ -284,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 {
@@ -302,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;
@@ -325,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>>;
 
@@ -349,7 +423,7 @@ interface BalanceResult {
     symbol: string;
     value: bigint;
 }
-declare const useTokenBalance: ({ chainId, tokenAddress, connectAddress }: Props) => NoInfer<BalanceResult> | undefined;
+declare const useTokenBalance: ({ chainId, tokenAddress, connectAddress }: Props) => BalanceResult | undefined;
 
 interface ChainsStore {
     chains: ChainInfo[] | null;
@@ -451,6 +525,8 @@ interface WalletStore {
     setIsSolanaWalletConnected: (isSolanaWalletConnected: boolean) => void;
     isTronWalletConnected: boolean;
     setIsTronWalletConnected: (isTronWalletConnected: boolean) => void;
+    isBitcoinWalletConnected: boolean;
+    setIsBitcoinWalletConnected: (isBitcoinWalletConnected: boolean) => void;
     totalConnectedWallets: number;
     setTotalConnectedWallets: () => void;
     totalWallets: number;
@@ -458,6 +534,8 @@ interface WalletStore {
     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

@@ -111,6 +111,8 @@ interface TxInfoProps {
     routes?: routesItem$1[] | undefined;
     onToggleAiRouter?: () => void;
     hasMultipleQuotes?: boolean;
+    /** Current quote request_id — TxInfo re-expands whenever it changes */
+    quoteRequestId?: string | null;
 }
 
 interface RefetchQuoteParams {
@@ -127,8 +129,12 @@ 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;
@@ -149,9 +155,27 @@ interface QuoteItem {
         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 {
@@ -180,6 +204,7 @@ interface TokenInfo {
     platform_type?: string[];
     isSolana?: boolean;
     isTron?: boolean;
+    isBitcoin?: boolean;
     fee_level?: FeeLevel;
 }
 interface TokenInfoWithBalance extends TokenInfo {
@@ -225,9 +250,35 @@ interface ChainsAndTokens {
     };
 }
 declare function getChainsAndTokens(): Promise<ChainsAndTokens>;
-declare const useChainsAndTokens: (enabled?: boolean) => _tanstack_react_query.UseQueryResult<NoInfer<ChainsAndTokens>, Error>;
+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;
 };
@@ -251,6 +302,16 @@ interface QuoteInfo {
     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;
@@ -284,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 {
@@ -302,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;
@@ -325,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>>;
 
@@ -349,7 +423,7 @@ interface BalanceResult {
     symbol: string;
     value: bigint;
 }
-declare const useTokenBalance: ({ chainId, tokenAddress, connectAddress }: Props) => NoInfer<BalanceResult> | undefined;
+declare const useTokenBalance: ({ chainId, tokenAddress, connectAddress }: Props) => BalanceResult | undefined;
 
 interface ChainsStore {
     chains: ChainInfo[] | null;
@@ -451,6 +525,8 @@ interface WalletStore {
     setIsSolanaWalletConnected: (isSolanaWalletConnected: boolean) => void;
     isTronWalletConnected: boolean;
     setIsTronWalletConnected: (isTronWalletConnected: boolean) => void;
+    isBitcoinWalletConnected: boolean;
+    setIsBitcoinWalletConnected: (isBitcoinWalletConnected: boolean) => void;
     totalConnectedWallets: number;
     setTotalConnectedWallets: () => void;
     totalWallets: number;
@@ -458,6 +534,8 @@ interface WalletStore {
     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;