@sodax/dapp-kit 1.5.7-beta → 2.0.0-rc.1

package/dist/index.d.mts

@@ -1,2581 +0,0 @@
-import { Sodax, SpokeProvider, GetEstimateGasReturnType, TxReturnType, SpokeChainId, StellarSpokeProvider, EvmHubProvider, IWalletProvider, BitcoinSpokeProvider, RadfiWalletBalance, RadfiUtxo, MoneyMarketBorrowParams, MoneyMarketError, RelayErrorCode, MoneyMarketRepayParams, MoneyMarketSupplyParams, MoneyMarketWithdrawParams, UserReserveData, AggregatedReserveData, BaseCurrencyInfo, MoneyMarketParams, XToken, ReserveData, FormatReserveUSDResponse, FormatUserSummaryResponse, SolverIntentQuoteRequest, Result, SolverIntentQuoteResponse, SolverErrorResponse, SolverExecutionResponse, Intent, IntentDeliveryInfo, IntentError, IntentErrorCode, CreateIntentParams, Hex, SolverIntentStatusResponse, CreateLimitOrderParams, IntentResponse, Address as Address$1, UserIntentsResponse, RequestOverrideConfig, OrderbookResponse, MoneyMarketPosition, MoneyMarketAsset, MoneyMarketAssetBorrowers, MoneyMarketAssetSuppliers, MoneyMarketBorrowers, CreateBridgeIntentParams, SpokeTxHash, HubTxHash, BridgeError, BridgeErrorCode, BridgeLimit, StakeParams, UnstakeParams, ClaimParams, CancelUnstakeParams, StakingInfo, UnstakingInfo, UnstakeRequestWithPenalty, StakingConfig, InstantUnstakeParams, PoolKey, PoolData, ClPositionInfo, CreateAssetDepositParams, CreateAssetWithdrawParams, ConcentratedLiquiditySupplyParams, ConcentratedLiquidityIncreaseLiquidityParams, ConcentratedLiquidityDecreaseLiquidityParams, PoolSpokeAssets, DestinationParamsType, ConcentratedLiquidityClaimRewardsParams, ConcentratedLiquidityError, ConcentratedLiquidityErrorCode, SodaxConfig } from '@sodax/sdk';
-import { RpcConfig, SpokeChainId as SpokeChainId$1, SubmitSwapTxResponse, SubmitSwapTxRequest, SubmitSwapTxStatusResponse, XToken as XToken$1 } from '@sodax/types';
-import { UseMutationResult, UseQueryResult, UseQueryOptions, UseMutationOptions, QueryObserverOptions } from '@tanstack/react-query';
-import { Address } from 'viem';
-import { ReactNode, ReactElement } from 'react';
-
-interface SodaxContextType {
-    sodax: Sodax;
-    testnet: boolean;
-    rpcConfig: RpcConfig;
-}
-
-/**
- * Hook to access the Sodax context which provides access to the Sodax SDK instance and chain configuration
- * @throws {Error} If used outside of a SodaxProvider
- * @returns {SodaxContextType} The Sodax context containing SDK instance and configuration
- */
-declare const useSodaxContext: () => SodaxContextType;
-
-declare function useEstimateGas<T extends SpokeProvider = SpokeProvider>(spokeProvider: T | undefined): UseMutationResult<GetEstimateGasReturnType<T>, Error, TxReturnType<T, true>>;
-
-/**
- * Hook for deriving user wallet address for hub abstraction.
- *
- * This hook derives the user's abstracted wallet address for the hub chain based on the spoke chain ID and address.
- * If the spoke chain is the same as the hub chain, it returns the encoded spoke address.
- * Otherwise, it derives and returns the abstracted wallet address for cross-chain operations.
- *
- * The query is automatically enabled when both `spokeChainId` and `spokeAddress` are provided.
- * This is a deterministic operation, so the result is cached and not refetched automatically.
- *
- * @param spokeChainId - Optional spoke chain ID. If not provided, the query will be disabled.
- * @param spokeAddress - Optional user wallet address on the spoke chain. If not provided, the query will be disabled.
- * @returns A React Query result object containing:
- *   - data: The derived user wallet address (Address) when available
- *   - isLoading: Loading state indicator
- *   - error: Any error that occurred during derivation (Error)
- *
- * @example
- * ```typescript
- * const { data: derivedAddress, isLoading, error } = useDeriveUserWalletAddress(spokeChainId, userAddress);
- *
- * if (isLoading) return <div>Deriving address...</div>;
- * if (error) return <div>Error: {error.message}</div>;
- * if (derivedAddress) return <div>Derived Address: {derivedAddress}</div>;
- * ```
- */
-declare function useDeriveUserWalletAddress(spokeChainId?: SpokeChainId | SpokeProvider | undefined, spokeAddress?: string | undefined): UseQueryResult<Address, Error>;
-
-/**
- * React hook to check if a Stellar account has a sufficient trustline for a given token and amount.
- *
- * This hook queries the Stellar network (via the provided SpokeProvider) to determine
- * whether the account has established a trustline for the specified token and if the trustline
- * is sufficient for the intended amount. It is useful for gating UI actions that require
- * a trustline to be present and funded.
- *
- * @template T - The type of SpokeProvider, defaults to SpokeProvider.
- * @param {string | undefined} token - The Stellar asset code or token address to check the trustline for.
- * @param {bigint | undefined} amount - The minimum amount required for the trustline.
- * @param {T | undefined} spokeProvider - The provider instance for interacting with the Stellar network.
- * @param {SpokeChainId | undefined} chainId - The chain ID to determine if the check should be performed (only on Stellar mainnet).
- * @returns {UseQueryResult<boolean, Error>} A React Query result object containing:
- *   - `data`: `true` if the trustline exists and is sufficient, `false` otherwise.
- *   - `error`: Any error encountered during the check.
- *   - `isLoading`: Whether the query is in progress.
- *   - Other React Query state.
- *
- * @example
- * ```tsx
- * import { useStellarTrustlineCheck } from '@sodax/dapp-kit';
- *
- * const { data: hasTrustline, isLoading, error } = useStellarTrustlineCheck(
- *   'USDC-G...TOKEN',
- *   10000000n,
- *   stellarProvider,
- *   'stellar'
- * );
- *
- * if (isLoading) return <span>Checking trustline...</span>;
- * if (error) return <span>Error: {error.message}</span>;
- * if (!hasTrustline) return <span>Trustline not established or insufficient.</span>;
- * return <span>Trustline is sufficient!</span>;
- * ```
- */
-declare function useStellarTrustlineCheck<T extends SpokeProvider = SpokeProvider>(token: string | undefined, amount: bigint | undefined, spokeProvider: T | undefined, chainId: SpokeChainId | undefined): UseQueryResult<boolean, Error>;
-
-/**
- * React hook to request a Stellar trustline for a given token and amount.
- *
- * This hook provides a callback function for requesting a trustline on the Stellar network
- * using the provided SpokeProvider. It is intended for use with StellarSpokeProvider
- * and will throw if used with a non-Stellar provider. Upon success, it invalidates
- * the trustline check query to ensure UI reflects the updated trustline state.
- *
- * @template T - The type of SpokeProvider, defaults to SpokeProvider.
- * @param {string | undefined} token - The Stellar asset code or token address for which to request a trustline.
- * @returns {Object} An object containing:
- *   - `requestTrustline`: Function to trigger the trustline request.
- *   - `isLoading`: Whether the request is in progress.
- *   - `isRequested`: Whether a trustline has been successfully requested.
- *   - `error`: Any error encountered during the request.
- *   - `data`: The transaction result if successful.
- *
- * @example
- * ```tsx
- * import { useRequestTrustline } from '@sodax/dapp-kit';
- *
- * const { requestTrustline, isLoading, isRequested, error, data } = useRequestTrustline('USDC-G...TOKEN');
- *
- * // To request a trustline:
- * await requestTrustline({
- *   token: 'USDC-G...TOKEN',
- *   amount: 10000000n,
- *   spokeProvider: stellarProvider,
- * });
- *
- * if (isLoading) return <span>Requesting trustline...</span>;
- * if (error) return <span>Error: {error.message}</span>;
- * if (isRequested) return <span>Trustline requested! Tx: {data?.txHash}</span>;
- * ```
- */
-declare function useRequestTrustline<T extends SpokeProvider = SpokeProvider>(token: string | undefined): {
-    requestTrustline: (params: {
-        token: string;
-        amount: bigint;
-        spokeProvider: T;
-    }) => Promise<TxReturnType<StellarSpokeProvider, false>>;
-    isLoading: boolean;
-    isRequested: boolean;
-    error: Error | null;
-    data: TxReturnType<StellarSpokeProvider, false> | null;
-};
-
-/**
- * Hook for deriving user wallet address for hub abstraction.
- *
- * This hook derives the user's abstracted wallet address for the hub chain based on the spoke chain ID and address.
- * If the spoke chain is the same as the hub chain, it returns the encoded spoke address.
- * Otherwise, it derives and returns the abstracted wallet address for cross-chain operations.
- * NOTE: This hook is different from useDeriveUserWalletAddress because it uses wallet router address instead of CREATE3 address for Sonic (hub).
- *
- * The query is automatically enabled when both `spokeChainId` and `spokeAddress` are provided.
- * This is a deterministic operation, so the result is cached and not refetched automatically.
- *
- * @param spokeChainId - Optional spoke chain ID. If not provided, the query will be disabled.
- * @param spokeAddress - Optional user wallet address on the spoke chain. If not provided, the query will be disabled.
- * @returns A React Query result object containing:
- *   - data: The derived user wallet address (Address) when available
- *   - isLoading: Loading state indicator
- *   - error: Any error that occurred during derivation (Error)
- *
- * @example
- * ```typescript
- * const { data: derivedAddress, isLoading, error } = useDeriveUserWalletAddress(spokeChainId, userAddress);
- *
- * if (isLoading) return <div>Deriving address...</div>;
- * if (error) return <div>Error: {error.message}</div>;
- * if (derivedAddress) return <div>Derived Address: {derivedAddress}</div>;
- * ```
- */
-declare function useGetUserHubWalletAddress(spokeChainId?: SpokeChainId | SpokeProvider | undefined, spokeAddress?: string | undefined): UseQueryResult<Address, Error>;
-
-declare function useHubProvider(): EvmHubProvider;
-
-/**
- * Hook to get the appropriate spoke provider based on the chain type.
- * Supports EVM, SUI, ICON and INJECTIVE chains.
- *
- * @param {SpokeChainId | undefined} spokeChainId - The spoke chain ID to get the provider for
- * @param {IWalletProvider | undefined} walletProvider - The wallet provider to use
- * @returns {SpokeProvider | undefined} The appropriate spoke provider instance for the given chain ID, or undefined if invalid/unsupported
- *
- * @example
- * ```tsx
- * // Using a specific SpokeChainId and wallet provider
- * const spokeProvider = useSpokeProvider(spokeChainId, walletProvider);
- * ```
- */
-declare function useSpokeProvider(spokeChainId: SpokeChainId$1 | undefined, walletProvider?: IWalletProvider | undefined): SpokeProvider | undefined;
-
-type RadfiSession = {
-    accessToken: string;
-    refreshToken: string;
-    tradingAddress: string;
-    publicKey: string;
-};
-type RadfiAuthResult = {
-    accessToken: string;
-    refreshToken: string;
-    tradingAddress: string;
-};
-declare function saveRadfiSession(address: string, session: RadfiSession): void;
-declare function loadRadfiSession(address: string): RadfiSession | null;
-declare function clearRadfiSession(address: string): void;
-/**
- * Hook to authenticate with Radfi using BIP322 message signing.
- * Saves session (accessToken, refreshToken, tradingAddress, publicKey) to localStorage.
- */
-declare function useRadfiAuth(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<RadfiAuthResult, Error, void>;
-
-type UseRadfiSessionReturn = {
-    walletAddress: string | undefined;
-    isAuthed: boolean;
-    tradingAddress: string | undefined;
-    login: () => Promise<void>;
-    isLoginPending: boolean;
-};
-/**
- * Manages the full Radfi session lifecycle:
- * - On mount / wallet switch: refreshes token to validate session
- * - Single interval (~5 min): refreshes access token. If refresh fails → clears session, isAuthed=false
- * - ensureRadfiAccessToken (SDK layer) acts as safety net before swap/bridge
- * - Exposes login() and isAuthed for UI
- */
-declare function useRadfiSession(spokeProvider: BitcoinSpokeProvider | undefined): UseRadfiSessionReturn;
-
-/**
- * Hook to fund the Radfi trading wallet by sending BTC from the user's personal wallet.
- *
- * @param {BitcoinSpokeProvider | undefined} spokeProvider - The Bitcoin spoke provider with signing capability
- * @returns {UseMutationResult} Mutation result — input is amount in satoshis, output is transaction ID
- *
- * @example
- * ```tsx
- * const { mutateAsync: fundWallet, isPending } = useFundTradingWallet(spokeProvider);
- *
- * const handleFund = async () => {
- *   const txId = await fundWallet(100_000n); // fund 100,000 satoshis
- *   console.log('Funded:', txId);
- * };
- * ```
- */
-declare function useFundTradingWallet(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<string, Error, bigint>;
-
-/**
- * Hook to fetch BTC balance for any Bitcoin address.
- * Sums all UTXOs (confirmed + unconfirmed) from mempool.space API.
- *
- * The UTXO set already excludes spent outputs (even from unconfirmed txs),
- * so the total is always the correct spendable balance.
- */
-declare function useBitcoinBalance(address: string | undefined, rpcUrl?: string): UseQueryResult<bigint, Error>;
-
-/**
- * Hook to fetch trading wallet balance from Radfi API.
- * Returns confirmed + pending satoshi balances.
- */
-declare function useTradingWalletBalance(spokeProvider: BitcoinSpokeProvider | undefined, tradingAddress: string | undefined): UseQueryResult<RadfiWalletBalance, Error>;
-
-/**
- * Hook to fetch expired UTXOs for a trading wallet address.
- * UTXOs that are expired or within 2 weeks of expiry are considered invalid for trading
- * and need to be renewed via the Radfi renew-utxo flow.
- */
-declare function useExpiredUtxos(spokeProvider: BitcoinSpokeProvider | undefined, tradingAddress: string | undefined): UseQueryResult<RadfiUtxo[], Error>;
-
-type RenewUtxosParams = {
-    txIdVouts: string[];
-};
-/**
- * Hook to renew expired UTXOs in the Radfi trading wallet.
- *
- * Flow:
- * 1. Build renew-utxo transaction via Radfi API (returns unsigned PSBT)
- * 2. User signs the PSBT with their wallet
- * 3. Submit signed PSBT back to Radfi for co-signing and broadcasting
- *
- * @example
- * ```tsx
- * const { mutateAsync: renewUtxos, isPending } = useRenewUtxos(spokeProvider);
- *
- * const handleRenew = async (expiredUtxos: RadfiUtxo[]) => {
- *   const txIdVouts = expiredUtxos.map(u => u.txidVout);
- *   const txId = await renewUtxos({ txIdVouts });
- *   console.log('Renewed:', txId);
- * };
- * ```
- */
-declare function useRenewUtxos(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<string, Error, RenewUtxosParams>;
-
-type WithdrawToUserParams = {
-    amount: string;
-    tokenId: string;
-    withdrawTo: string;
-};
-type WithdrawResult = {
-    txId: string;
-    fee: number;
-};
-/**
- * Hook to withdraw BTC from Radfi trading wallet to user's personal wallet.
- *
- * Flow:
- * 1. Build withdraw transaction via Radfi API (returns unsigned PSBT)
- * 2. User signs the PSBT with their wallet
- * 3. Submit signed PSBT back to Radfi for co-signing and broadcasting
- *
- * @example
- * ```tsx
- * const { mutateAsync: withdraw, isPending } = useRadfiWithdraw(spokeProvider);
- *
- * const handleWithdraw = async () => {
- *   const result = await withdraw({
- *     amount: '10000',
- *     tokenId: '0:0',
- *     withdrawTo: 'bc1q...', // user's segwit address
- *   });
- *   console.log('Withdrawn:', result.txId);
- * };
- * ```
- */
-declare function useRadfiWithdraw(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<WithdrawResult, Error, WithdrawToUserParams>;
-
-interface BorrowResponse {
-    ok: true;
-    value: [string, string];
-}
-type UseBorrowParams = {
-    params: MoneyMarketBorrowParams;
-    spokeProvider: SpokeProvider;
-};
-/**
- * React hook for borrowing tokens in the Sodax money market protocol.
- *
- * Encapsulates the async process to initiate a borrow transaction via the money market,
- * handling transaction creation, submission, and cross-chain logic.
- *
- * @returns {UseMutationResult<
- *   BorrowResponse,
- *   MoneyMarketError<'CREATE_BORROW_INTENT_FAILED' | 'BORROW_UNKNOWN_ERROR' | RelayErrorCode>,
- *   UseBorrowParams
- * >} A React Query mutation result object containing:
- *   - mutateAsync: (params: UseBorrowParams) => Promise<BorrowResponse>
- *     Triggers the borrow action. Expects an object with valid borrow params and a `SpokeProvider`.
- *   - isPending: `boolean` if a borrow transaction is in progress.
- *   - error: `MoneyMarketError` if the transaction fails, or `null`.
- *
- * @example
- * ```typescript
- * const { mutateAsync: borrow, isPending, error } = useBorrow();
- * await borrow({ params: borrowParams, spokeProvider });
- * ```
- *
- * @throws {Error} When:
- *   - `spokeProvider` is missing or invalid.
- *   - The underlying borrow transaction fails.
- */
-declare function useBorrow(): UseMutationResult<BorrowResponse, MoneyMarketError<'CREATE_BORROW_INTENT_FAILED' | 'BORROW_UNKNOWN_ERROR' | RelayErrorCode>, UseBorrowParams>;
-
-interface RepayResponse {
-    ok: true;
-    value: [string, string];
-}
-type UseRepayParams = {
-    params: MoneyMarketRepayParams;
-    spokeProvider: SpokeProvider;
-};
-/**
- * React hook for repaying a borrow in the Sodax money market protocol.
- *
- * This hook encapsulates the process of sending a repay transaction to the money market.
- * It manages the asynchronous operation for repayment, including sending the transaction
- * and error handling.
- *
- * @returns {UseMutationResult<RepayResponse, MoneyMarketError<'CREATE_REPAY_INTENT_FAILED' | 'REPAY_UNKNOWN_ERROR' | RelayErrorCode>, UseRepayParams>} React Query mutation result object containing:
- *   - mutateAsync: (params: UseRepayParams) => Promise<RepayResponse>
- *     Initiates a repay transaction using the given MoneyMarketRepayParams and SpokeProvider.
- *   - isPending: boolean indicating if a transaction is in progress.
- *   - error: MoneyMarketError if an error occurred while repaying, otherwise undefined.
- *
- * @example
- * ```typescript
- * const { mutateAsync: repay, isPending, error } = useRepay();
- * await repay({ params: repayParams, spokeProvider });
- * ```
- *
- * @throws {Error} When:
- *   - `spokeProvider` is missing or invalid.
- *   - The underlying repay transaction fails.
- */
-declare function useRepay(): UseMutationResult<RepayResponse, MoneyMarketError<'CREATE_REPAY_INTENT_FAILED' | 'REPAY_UNKNOWN_ERROR' | RelayErrorCode>, UseRepayParams>;
-
-interface SupplyResponse {
-    ok: true;
-    value: [string, string];
-}
-type UseSupplyParams = {
-    params: MoneyMarketSupplyParams;
-    spokeProvider: SpokeProvider;
-};
-/**
- * React hook for supplying tokens to the Sodax money market protocol.
- *
- * Provides a mutation for performing the supply operation using React Query. Useful
- * for UI components needing to manage the full state (pending, error, etc.) of a supply
- * transaction. It handles transaction creation, cross-chain logic, and errors.
- *
- * @returns {UseMutationResult<SupplyResponse, MoneyMarketError<'CREATE_SUPPLY_INTENT_FAILED' | 'SUPPLY_UNKNOWN_ERROR' | RelayErrorCode>, UseSupplyParams>}
- *   Mutation result object from React Query, where:
- *   - mutateAsync(params: UseSupplyParams): Promise<SupplyResponse>
- *     Initiates a supply transaction using the given MoneyMarketSupplyParams and SpokeProvider.
- *   - isPending: boolean indicating if a transaction is in progress.
- *   - error: MoneyMarketError if an error occurred while supplying, otherwise undefined.
- *
- * @example
- * ```typescript
- * const { mutateAsync: supply, isPending, error } = useSupply();
- * await supply({ params: supplyParams, spokeProvider });
- * ```
- *
- * @throws {Error|MoneyMarketError<...>} When:
- *   - `spokeProvider` is not provided or invalid.
- *   - The underlying supply transaction fails.
- */
-declare function useSupply(): UseMutationResult<SupplyResponse, MoneyMarketError<'CREATE_SUPPLY_INTENT_FAILED' | 'SUPPLY_UNKNOWN_ERROR' | RelayErrorCode>, UseSupplyParams>;
-
-type UseWithdrawParams = {
-    params: MoneyMarketWithdrawParams;
-    spokeProvider: SpokeProvider;
-};
-interface WithdrawResponse {
-    ok: true;
-    value: [string, string];
-}
-/**
- * Hook for performing withdrawals from the Sodax money market.
- *
- * This hook exposes a mutation that executes the complete withdrawal logic, including transaction
- * creation and handling cross-chain communication. It leverages React Query's mutation API for
- * easy asynchronous handling and status tracking within UI components.
- *
- * @returns {UseMutationResult<WithdrawResponse, MoneyMarketError<'CREATE_WITHDRAW_INTENT_FAILED' | 'WITHDRAW_UNKNOWN_ERROR' | RelayErrorCode>, UseWithdrawParams>}
- *   Mutation result object, with:
- *   - mutateAsync: (params: UseWithdrawParams) => Promise<WithdrawResponse>
- *       Initiates the withdrawal using the provided params.
- *   - isPending: boolean indicating if a transaction is in progress.
- *   - error: MoneyMarketError if an error occurred while withdrawing, otherwise undefined.
- *
- * @example
- * ```typescript
- * const { mutateAsync: withdraw, isPending, error } = useWithdraw();
- * await withdraw({ params: withdrawParams, spokeProvider });
- * ```
- *
- * @throws {Error} When:
- *   - spokeProvider is not provided or invalid.
- *   - Underlying withdrawal logic fails.
- */
-declare function useWithdraw(): UseMutationResult<WithdrawResponse, MoneyMarketError<'CREATE_WITHDRAW_INTENT_FAILED' | 'WITHDRAW_UNKNOWN_ERROR' | RelayErrorCode>, UseWithdrawParams>;
-
-type BaseQueryOptions$1 = {
-    queryOptions?: UseQueryOptions<readonly [readonly UserReserveData[], number], Error>;
-};
-type NewParams$1 = BaseQueryOptions$1 & {
-    /** Spoke chain id (e.g. '0xa86a.avax') */
-    spokeChainId: SpokeChainId$1 | undefined;
-    /** User wallet address on the spoke chain */
-    userAddress: string | undefined;
-};
-/** @deprecated Use `{ spokeChainId, userAddress }` instead */
-type LegacyParams$1 = BaseQueryOptions$1 & {
-    /** @deprecated Use `spokeChainId` instead */
-    spokeProvider: SpokeProvider | undefined;
-    /** @deprecated Use `userAddress` instead */
-    address: string | undefined;
-};
-type UseUserReservesDataParams = NewParams$1 | LegacyParams$1;
-/**
- * Hook for fetching user reserves data from the Sodax money market.
- *
- * @param params (optional) - Object including:
- *   - spokeChainId: The spoke chain id whose reserves data will be fetched. If not provided, data fetching is disabled.
- *   - userAddress: The user's address (string) whose reserves data will be fetched. If not provided, data fetching is disabled.
- *   - queryOptions: (optional) Custom React Query options such as `queryKey`, `enabled`, or cache policy.
- *
- * @returns {UseQueryResult<readonly [readonly UserReserveData[], number], Error>} React Query result object containing:
- *   - data: A tuple with array of UserReserveData and associated number, or undefined if loading
- *   - isLoading: Boolean loading state
- *   - isError: Boolean error state
- *   - error: Error object, if present
- *
- * @example
- * const { data: userReservesData, isLoading, error } = useUserReservesData({
- *   spokeChainId,
- *   userAddress,
- * });
- */
-declare function useUserReservesData(params?: UseUserReservesDataParams): UseQueryResult<readonly [readonly UserReserveData[], number], Error>;
-
-type UseReservesDataParams = {
-    queryOptions?: UseQueryOptions<readonly [readonly AggregatedReserveData[], BaseCurrencyInfo], Error>;
-};
-/**
- * React hook for fetching the latest reserves data from the Sodax money market.
- *
- * Provides the full set of aggregated reserves and base currency information.
- * Optionally accepts React Query options for customizing the query key, cache time, and related behaviors.
- *
- * @param params (optional) - Object including:
- *   - queryOptions: Custom React Query options
- *
- * @returns {UseQueryResult<readonly [readonly AggregatedReserveData[], BaseCurrencyInfo], Error>}
- *   React Query result object containing:
- *     - data: [aggregated reserves[], base currency info], or undefined if not loaded
- *     - isLoading: True if the request is loading
- *     - isError: True if the request failed
- *     - error: Error object, if present
- *
- * @example
- * const { data, isLoading, error } = useReservesData();
- * const { data } = useReservesData({ queryOptions: { queryKey: ['custom', 'reservesData'] } });
- */
-declare function useReservesData(params?: UseReservesDataParams): UseQueryResult<readonly [readonly AggregatedReserveData[], BaseCurrencyInfo], Error>;
-
-type UseMMAllowanceParams = {
-    params: MoneyMarketParams | undefined;
-    spokeProvider: SpokeProvider | undefined;
-    queryOptions?: UseQueryOptions<boolean, Error>;
-};
-/**
- * Hook for checking token allowance for money market operations.
- *
- * This hook verifies if the user has approved enough tokens for a specific money market action
- * (borrow/repay). It automatically queries and tracks the allowance status.
- *
- * @param {XToken} token - The token to check allowance for. Must be an XToken with valid address and chain information.
- * @param {string} amount - The amount to check allowance for, as a decimal string
- * @param {MoneyMarketAction} action - The money market action to check allowance for ('borrow' or 'repay')
- * @param {SpokeProvider} spokeProvider - The spoke provider to use for allowance checks
- *
- * @returns {UseQueryResult<boolean, Error>} A React Query result containing:
- *   - data: Boolean indicating if allowance is sufficient
- *   - isLoading: Loading state indicator
- *   - error: Any error that occurred during the check
- *
- * @example
- * ```typescript
- * const { data: hasAllowed, isLoading } = useMMAllowance(token, "100", "repay", provider);
- * ```
- */
-declare function useMMAllowance({ params, spokeProvider, queryOptions, }: UseMMAllowanceParams): UseQueryResult<boolean, Error>;
-
-type UseMMApproveParams = {
-    params: MoneyMarketParams;
-    spokeProvider: SpokeProvider | undefined;
-};
-/**
- * Hook for approving ERC20 token spending for Sodax money market actions.
- *
- * This hook manages the approval transaction, allowing the user
- * to grant the protocol permission to spend their tokens for specific money market actions
- * (such as supply, borrow, or repay). Upon successful approval, it also invalidates and
- * refetches the associated allowance status so the UI remains up-to-date.
- *
- * @returns {UseMutationResult<string, Error, UseMMApproveParams>} A React Query mutation result containing:
- *   - mutateAsync: Function to trigger the approval (see below)
- *   - isPending: Boolean indicating if approval transaction is in progress
- *   - error: Error object if the last approval failed, null otherwise
- *
- * @example
- * ```tsx
- * const { mutateAsync: approve, isPending, error } = useMMApprove();
- * await approve({ params: { token, amount: "100", action: "supply", ... }, spokeProvider });
- * ```
- *
- * @throws {Error} When:
- *   - spokeProvider is undefined or invalid
- *   - Approval transaction fails for any reason
- */
-declare function useMMApprove(): UseMutationResult<string, Error, UseMMApproveParams>;
-
-type UseATokenParams = {
-    aToken: string;
-    queryOptions?: UseQueryOptions<XToken, Error>;
-};
-/**
- * React hook to fetch and cache metadata for a given aToken address.
- *
- * Accepts an aToken address and React Query options to control query behavior.
- * Returns the aToken's ERC20-style metadata from the Sodax money market, with querying/caching
- * powered by React Query.
- *
- * @param {UseATokenParams} params - Required params object:
- *   @property {Address} aToken - The aToken contract address to query.
- *   @property {UseQueryOptions<XToken, Error>} queryOptions - React Query options to control query (e.g., staleTime, refetch, etc.).
- *
- * @returns {UseQueryResult<XToken, Error>} React Query result object:
- *   - data: XToken metadata, if available
- *   - isLoading: Boolean loading state
- *   - error: Error, if API call fails
- *
- * @example
- * const { data: xToken, isLoading, error } = useAToken({ aToken: aTokenAddress, queryOptions: {} });
- * if (xToken) {
- *   console.log(xToken.symbol);
- * }
- */
-declare function useAToken({ aToken, queryOptions }: UseATokenParams): UseQueryResult<XToken, Error>;
-
-type UseATokensBalancesParams = {
-    aTokens: readonly Address[];
-    spokeProvider?: SpokeProvider;
-    userAddress?: string;
-    queryOptions?: UseQueryOptions<Map<Address, bigint>, Error>;
-};
-/**
- * React hook to fetch and cache aToken balances for multiple aToken addresses in a single multicall.
- *
- * Accepts an array of aToken addresses, a spoke provider, and user address. The hook derives the user's
- * hub wallet address and then fetches balanceOf for each aToken in a single multicall. Returns a Map
- * of aToken address to balance, with querying/caching powered by React Query. This hook uses viem's
- * multicall to batch all requests into a single RPC call for better performance.
- *
- * @param {UseATokensBalancesParams} params - Required params object:
- *   @property {readonly Address[]} aTokens - Array of aToken contract addresses to query balances for.
- *   @property {SpokeProvider} spokeProvider - The spoke provider to derive hub wallet address from.
- *   @property {string} userAddress - User's wallet address on the spoke chain.
- *   @property {UseQueryOptions<Map<Address, bigint>, Error>} queryOptions - React Query options to control query (e.g., staleTime, refetch, etc.).
- *
- * @returns {UseQueryResult<Map<Address, bigint>, Error>} React Query result object:
- *   - data: Map of aToken address to balance, if available
- *   - isLoading: Boolean loading state
- *   - error: Error, if API call fails
- *
- * @example
- * const { data: aTokenBalances, isLoading, error } = useATokensBalances({
- *   aTokens: [aToken1, aToken2, aToken3],
- *   spokeProvider,
- *   userAddress: '0x...',
- *   queryOptions: {}
- * });
- * const aToken1Balance = aTokenBalances?.get(aToken1);
- */
-declare function useATokensBalances({ aTokens, spokeProvider, userAddress, queryOptions, }: UseATokensBalancesParams): UseQueryResult<Map<Address, bigint>, Error>;
-
-type UseReservesUsdFormatParams = {
-    queryOptions?: UseQueryOptions<(ReserveData & {
-        priceInMarketReferenceCurrency: string;
-    } & FormatReserveUSDResponse)[], Error>;
-};
-/**
- * Hook for fetching reserves data formatted with USD values in the Sodax money market.
- *
- * This hook returns an array of reserve objects, each extended with its price in the market reference
- * currency and formatted USD values. Data is automatically fetched and cached using React Query.
- *
- * @param params (optional) - Object including:
- *   - queryOptions: Custom React Query options such as `queryKey`, cache behavior, or refetching policy.
- *
- * @returns {UseQueryResult<(ReserveData & { priceInMarketReferenceCurrency: string } & FormatReserveUSDResponse)[], Error>} React Query result object containing:
- *   - data: Array of reserves with USD-formatted values, or undefined if loading
- *   - isLoading: Boolean loading state
- *   - isError: Boolean error state
- *   - error: Error object, if present
- *
- * @example
- * const { data: reservesUSD, isLoading, error } = useReservesUsdFormat();
- */
-declare function useReservesUsdFormat(params?: UseReservesUsdFormatParams): UseQueryResult<(ReserveData & {
-    priceInMarketReferenceCurrency: string;
-} & FormatReserveUSDResponse)[], Error>;
-
-type BaseQueryOptions = {
-    queryOptions?: UseQueryOptions<FormatUserSummaryResponse<FormatReserveUSDResponse>, Error>;
-};
-type NewParams = BaseQueryOptions & {
-    /** Spoke chain id (e.g. '0xa86a.avax') */
-    spokeChainId: SpokeChainId$1 | undefined;
-    /** User wallet address on the spoke chain */
-    userAddress: string | undefined;
-};
-/** @deprecated Use `{ spokeChainId, userAddress }` instead */
-type LegacyParams = BaseQueryOptions & {
-    /** @deprecated Use `spokeChainId` instead */
-    spokeProvider: SpokeProvider | undefined;
-    /** @deprecated Use `userAddress` instead */
-    address: string | undefined;
-};
-type UseUserFormattedSummaryParams = NewParams | LegacyParams;
-/**
- * React hook to fetch a formatted summary of a user's Sodax money market portfolio.
- *
- * @param params (optional) - Object including:
- *   - spokeChainId: The spoke chain id whose data will be fetched. If not provided, data fetching is disabled.
- *   - userAddress: The user's address (string) whose summary will be fetched. If not provided, data fetching is disabled.
- *   - queryOptions: (optional) Custom React Query options such as `queryKey`, `enabled`, or cache policy.
- *
- * @returns {UseQueryResult<FormatUserSummaryResponse<FormatReserveUSDResponse>, Error>}
- *   A result object from React Query including:
- *     - data: The user's formatted portfolio summary (or undefined if not loaded)
- *     - isLoading: Boolean loading state
- *     - isError: Boolean error state
- *     - error: Error if thrown in fetching
- *
- * @example
- * const { data, isLoading, error } = useUserFormattedSummary({ spokeChainId, userAddress });
- */
-declare function useUserFormattedSummary(params?: UseUserFormattedSummaryParams): UseQueryResult<FormatUserSummaryResponse<FormatReserveUSDResponse>, Error>;
-
-/**
- * Hook for fetching a quote for an intent-based swap.
- *
- * This hook provides real-time quote data for an intent-based swap.
- *
- * @param {SolverIntentQuoteRequest | undefined} payload - The intent quote request parameters. If undefined, the query will be disabled.
- *
- * @returns {UseQueryResult<Result<SolverIntentQuoteResponse, SolverErrorResponse> | undefined>} A query result object containing:
- *   - data: The quote result from the solver
- *   - isLoading: Boolean indicating if the quote is being fetched
- *   - error: Error object if the quote request failed
- *   - refetch: Function to manually trigger a quote refresh
- *
- * @example
- * ```typescript
- * const { data: quote, isLoading } = useQuote({
- *   token_src: '0x...',
- *   token_src_blockchain_id: '1',
- *   token_dst: '0x...',
- *   token_dst_blockchain_id: '2',
- *   amount: '1000000000000000000',
- *   quote_type: 'exact_input',
- * });
- *
- * if (isLoading) return <div>Loading quote...</div>;
- * if (quote) {
- *   console.log('Quote received:', quote);
- * }
- * ```
- *
- * @remarks
- * - The quote is automatically refreshed every 3 seconds
- * - The query is disabled when payload is undefined
- * - Uses React Query for efficient caching and state management
- */
-declare const useQuote: (payload: SolverIntentQuoteRequest | undefined) => UseQueryResult<Result<SolverIntentQuoteResponse, SolverErrorResponse> | undefined>;
-
-type CreateIntentResult = Result<[SolverExecutionResponse, Intent, IntentDeliveryInfo], IntentError<IntentErrorCode>>;
-/**
- * Hook for creating and submitting an swap intent order for cross-chain swaps.
- * Uses React Query's useMutation for better state management and caching.
- *
- * @param {SpokeProvider} spokeProvider - The spoke provider to use for the swap
- * @returns {UseMutationResult} Mutation result object containing mutation function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: swap, isPending } = useSwap(spokeProvider);
- *
- * const handleSwap = async () => {
- *   const result = await swap({
- *     token_src: '0x...',
- *     token_src_blockchain_id: 'arbitrum',
- *     token_dst: '0x...',
- *     token_dst_blockchain_id: 'polygon',
- *     amount: '1000000000000000000',
- *     min_output_amount: '900000000000000000'
- *   });
- * };
- * ```
- */
-declare function useSwap(spokeProvider: SpokeProvider | undefined): UseMutationResult<CreateIntentResult, Error, CreateIntentParams>;
-
-/**
- * Hook for monitoring the status of an intent-based swap.
- *
- * This hook provides real-time status updates for an intent-based swap transaction.
- *
- * @param {Hex} intent_tx_hash - The transaction hash of the intent order on the hub chain
- *
- * @returns {UseQueryResult<Result<SolverIntentStatusResponse, SolverErrorResponse> | undefined>} A query result object containing:
- *   - data: The status result from the solver
- *   - isLoading: Boolean indicating if the status is being fetched
- *   - error: Error object if the status request failed
- *   - refetch: Function to manually trigger a status refresh
- *
- * @example
- * ```typescript
- * const { data: status, isLoading } = useStatus('0x...');
- *
- * if (isLoading) return <div>Loading status...</div>;
- * if (status?.ok) {
- *   console.log('Status:', status.value);
- * }
- * ```
- *
- * @remarks
- * - The status is automatically refreshed every 3 seconds
- * - Uses React Query for efficient caching and state management
- */
-declare const useStatus: (intent_tx_hash: Hex) => UseQueryResult<Result<SolverIntentStatusResponse, SolverErrorResponse> | undefined>;
-
-/**
- * Hook for checking token allowance for swap operations.
- *
- * This hook verifies if the user has approved enough tokens for a specific swap action.
- * It automatically queries and tracks the allowance status.
- *
- * @param {CreateIntentParams | CreateLimitOrderParams} params - The parameters for the intent to check allowance for.
- * @param {SpokeProvider} spokeProvider - The spoke provider to use for allowance checks
- *
- * @returns {UseQueryResult<boolean, Error>} A React Query result containing:
- *   - data: Boolean indicating if allowance is sufficient
- *   - isLoading: Loading state indicator
- *   - error: Any error that occurred during the check
- *
- * @example
- * ```typescript
- * const { data: hasAllowed, isLoading } = useSwapAllowance(params, spokeProvider);
- * ```
- */
-declare function useSwapAllowance(params: CreateIntentParams | CreateLimitOrderParams | undefined, spokeProvider: SpokeProvider | undefined): UseQueryResult<boolean, Error>;
-
-interface UseApproveReturn$1 {
-    approve: ({ params }: {
-        params: CreateIntentParams | CreateLimitOrderParams;
-    }) => Promise<boolean>;
-    isLoading: boolean;
-    error: Error | null;
-    resetError: () => void;
-}
-/**
- * Hook for approving token spending for swap actions
- * @param params The parameters for the intent to approve spending for
- * @param spokeProvider The spoke provider instance for the chain
- * @returns Object containing approve function, loading state, error state and reset function
- * @example
- * ```tsx
- * const { approve, isLoading, error } = useApprove(token, spokeProvider);
- *
- * // Approve tokens for supply action
- * await approve({ amount: "100", action: "supply" });
- * ```
- */
-declare function useSwapApprove(params: CreateIntentParams | CreateLimitOrderParams | undefined, spokeProvider: SpokeProvider | undefined): UseApproveReturn$1;
-
-type CancelIntentParams = {
-    intent: Intent;
-    raw?: boolean;
-};
-type CancelIntentResult = Result<TxReturnType<SpokeProvider, boolean>>;
-/**
- * Hook for canceling a swap intent order.
- * Uses React Query's useMutation for better state management and caching.
- *
- * @param {SpokeProvider} spokeProvider - The spoke provider to use for canceling the intent
- * @returns {UseMutationResult} Mutation result object containing mutation function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: cancelSwap, isPending } = useCancelSwap(spokeProvider);
- *
- * const handleCancelSwap = async () => {
- *   const result = await cancelSwap({
- *     intent: intentObject,
- *     raw: false // optional, defaults to false
- *   });
- * };
- * ```
- */
-declare function useCancelSwap(spokeProvider: SpokeProvider | undefined): UseMutationResult<CancelIntentResult, Error, CancelIntentParams>;
-
-type CreateLimitOrderResult = Result<[
-    SolverExecutionResponse,
-    Intent,
-    IntentDeliveryInfo
-], IntentError<IntentErrorCode>>;
-/**
- * Hook for creating a limit order intent (no deadline, must be cancelled manually by user).
- * Uses React Query's useMutation for better state management and caching.
- *
- * Limit orders remain active until manually cancelled by the user. Unlike swaps, limit orders
- * do not have a deadline (deadline is automatically set to 0n).
- *
- * @param {SpokeProvider} spokeProvider - The spoke provider to use for creating the limit order
- * @returns {UseMutationResult} Mutation result object containing mutation function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: createLimitOrder, isPending } = useCreateLimitOrder(spokeProvider);
- *
- * const handleCreateLimitOrder = async () => {
- *   const result = await createLimitOrder({
- *     inputToken: '0x...',
- *     outputToken: '0x...',
- *     inputAmount: 1000000000000000000n,
- *     minOutputAmount: 900000000000000000n,
- *     allowPartialFill: false,
- *     srcChain: '0xa4b1.arbitrum',
- *     dstChain: '0x89.polygon',
- *     srcAddress: '0x...',
- *     dstAddress: '0x...',
- *     solver: '0x0000000000000000000000000000000000000000',
- *     data: '0x'
- *   });
- *
- *   if (result.ok) {
- *     const [solverExecutionResponse, intent, intentDeliveryInfo] = result.value;
- *     console.log('Limit order created:', intent);
- *     console.log('Intent hash:', solverExecutionResponse.intent_hash);
- *   }
- * };
- * ```
- */
-declare function useCreateLimitOrder(spokeProvider: SpokeProvider | undefined): UseMutationResult<CreateLimitOrderResult, Error, CreateLimitOrderParams>;
-
-type CancelLimitOrderParams = {
-    intent: Intent;
-    spokeProvider: SpokeProvider;
-    timeout?: number;
-};
-type CancelLimitOrderResult = Result<[string, string], IntentError<IntentErrorCode>>;
-/**
- * Hook for canceling a limit order intent and submitting it to the Relayer API.
- * Uses React Query's useMutation for better state management and caching.
- *
- * This hook wraps cancelLimitOrder which cancels the intent on the spoke chain,
- * submits it to the relayer API, and waits for execution on the destination/hub chain.
- *
- * @returns {UseMutationResult} Mutation result object containing mutation function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: cancelLimitOrder, isPending } = useCancelLimitOrder();
- *
- * const handleCancelLimitOrder = async () => {
- *   const result = await cancelLimitOrder({
- *     intent: intentObject,
- *     spokeProvider,
- *     timeout: 60000 // optional, defaults to 60 seconds
- *   });
- *
- *   if (result.ok) {
- *     const [cancelTxHash, dstTxHash] = result.value;
- *     console.log('Cancel transaction hash:', cancelTxHash);
- *     console.log('Destination transaction hash:', dstTxHash);
- *   }
- * };
- * ```
- */
-declare function useCancelLimitOrder(): UseMutationResult<CancelLimitOrderResult, Error, CancelLimitOrderParams>;
-
-type UseBackendIntentByTxHashParams = {
-    params: {
-        txHash: string | undefined;
-    };
-    queryOptions?: UseQueryOptions<IntentResponse | undefined, Error>;
-};
-/**
- * React hook for fetching intent details from the backend API using a transaction hash.
- *
- * @param {UseBackendIntentByTxHashParams | undefined} params - Parameters for the query:
- *   - params: { txHash: string | undefined }
- *       - `txHash`: Transaction hash used to retrieve the associated intent; query is disabled if undefined or empty.
- *   - queryOptions (optional): React Query options to customize request behavior (e.g., caching, retry, refetchInterval, etc.).
- *
- * @returns {UseQueryResult<IntentResponse | undefined, Error>} React Query result object, including:
- *   - `data`: The intent response or undefined if unavailable,
- *   - `isLoading`: Loading state,
- *   - `error`: Error (if request failed),
- *   - `refetch`: Function to refetch the data.
- *
- * @example
- * const { data: intent, isLoading, error } = useBackendIntentByTxHash({
- *   params: { txHash: '0x123...' },
- * });
- *
- * if (isLoading) return <div>Loading intent...</div>;
- * if (error) return <div>Error: {error.message}</div>;
- * if (intent) {
- *   console.log('Intent found:', intent.intentHash);
- * }
- *
- * @remarks
- * - Intents are only created on the hub chain, so `txHash` must originate from there.
- * - Query is disabled if `params` is undefined, or if `params.params.txHash` is undefined or an empty string.
- * - Default refetch interval is 1 second. Uses React Query for state management, caching, and retries.
- */
-declare const useBackendIntentByTxHash: (params: UseBackendIntentByTxHashParams | undefined) => UseQueryResult<IntentResponse | undefined, Error>;
-
-type UseBackendIntentByHashParams = {
-    params: {
-        intentHash: string | undefined;
-    };
-    queryOptions?: UseQueryOptions<IntentResponse | undefined, Error>;
-};
-/**
- * React hook to fetch intent details from the backend API using an intent hash.
- *
- * @param {UseBackendIntentByHashParams | undefined} params - Parameters for the query:
- *   - params: { intentHash: string | undefined }
- *     - `intentHash`: The hash identifying the intent to fetch (disables query if undefined or empty).
- *   - queryOptions (optional): Options to customize React Query (e.g., staleTime, enabled).
- *
- * @returns {UseQueryResult<IntentResponse | undefined, Error>} React Query result containing intent response data, loading, error, and refetch states.
- *
- * @example
- * const { data: intent, isLoading, error } = useBackendIntentByHash({
- *   params: { intentHash: '0xabc...' },
- * });
- *
- * if (isLoading) return <div>Loading intent...</div>;
- * if (error) return <div>Error: {error.message}</div>;
- * if (intent) {
- *   console.log('Intent found:', intent.intentHash);
- * }
- *
- * @remarks
- * - Returns `undefined` data if no intentHash is provided or query is disabled.
- * - Query is cached and managed using React Query.
- * - Use `queryOptions` to customize caching, retry and fetch behavior.
- */
-declare const useBackendIntentByHash: (params: UseBackendIntentByHashParams | undefined) => UseQueryResult<IntentResponse | undefined, Error>;
-
-type BackendPaginationParams = {
-    offset: string;
-    limit: string;
-};
-
-type GetUserIntentsParams = {
-    userAddress: Address$1;
-    startDate?: number;
-    endDate?: number;
-};
-type UseBackendUserIntentsParams = {
-    params?: GetUserIntentsParams;
-    queryOptions?: UseQueryOptions<UserIntentsResponse | undefined, Error>;
-    pagination?: BackendPaginationParams;
-};
-/**
- * React hook for fetching user-created intents from the backend API for a given user address,
- * with optional support for a date filtering range.
- *
- * @param {UseBackendUserIntentsParams} args - Query configuration.
- *   @param {GetUserIntentsParams | undefined} args.params - User intent filter parameters.
- *     @param {Address} args.params.userAddress - The wallet address of the user (required).
- *     @param {number} [args.params.startDate] - Include intents created after this timestamp (ms).
- *     @param {number} [args.params.endDate] - Include intents created before this timestamp (ms).
- *   @param {UseQueryOptions<UserIntentsResponse | undefined, Error>} [args.queryOptions] - Optional React Query options.
- *   @param {BackendPaginationParams} [args.pagination] - (currently ignored) Pagination options.
- *
- * @returns {UseQueryResult<UserIntentsResponse | undefined, Error>} React Query result:
- *   - `data`: The user intent response, or undefined if unavailable.
- *   - `isLoading`: `true` if loading.
- *   - `error`: An Error instance if any occurred.
- *   - `refetch`: Function to refetch data.
- *
- * @example
- * const { data: userIntents, isLoading, error } = useBackendUserIntents({
- *   params: { userAddress: "0x123..." }
- * });
- *
- * @example
- * const { data } = useBackendUserIntents({
- *   params: {
- *     userAddress: "0xabc...",
- *     startDate: Date.now() - 1_000_000,
- *     endDate: Date.now(),
- *   },
- * });
- *
- * @remarks
- * The query is disabled if `params` or `params.userAddress` is missing or empty. Uses React Query for
- * cache/state management and auto-retries failed requests three times by default.
- */
-declare const useBackendUserIntents: ({ params, queryOptions, }: UseBackendUserIntentsParams) => UseQueryResult<UserIntentsResponse | undefined, Error>;
-
-type UseBackendSubmitSwapTxParams = {
-    apiConfig?: RequestOverrideConfig;
-    mutationOptions?: UseMutationOptions<SubmitSwapTxResponse, Error, SubmitSwapTxRequest>;
-};
-/**
- * React hook for submitting a swap transaction to be processed by the backend
- * (relay, post execution to solver, etc.).
- *
- * @param {UseBackendSubmitSwapTxParams | undefined} params - Optional parameters:
- *   - `mutationOptions`: React Query mutation options to customize behavior (e.g., onSuccess, onError, retry).
- *
- * @returns {UseMutationResult<SubmitSwapTxResponse, Error, SubmitSwapTxRequest>} React Query mutation result:
- *   - `mutate` / `mutateAsync`: Functions to trigger the submission.
- *   - `data`: The submit response on success.
- *   - `isPending`: Loading state.
- *   - `error`: Error instance if the mutation failed.
- *
- * @example
- * const { mutateAsync: submitSwapTx, isPending, error } = useBackendSubmitSwapTx();
- *
- * const result = await submitSwapTx({
- *   txHash: '0x123...',
- *   srcChainId: '1',
- *   walletAddress: '0xabc...',
- *   intent: { ... },
- *   relayData: '0x...',
- * });
- */
-declare const useBackendSubmitSwapTx: (params?: UseBackendSubmitSwapTxParams) => UseMutationResult<SubmitSwapTxResponse, Error, SubmitSwapTxRequest>;
-
-type UseBackendSubmitSwapTxStatusParams = {
-    params: {
-        txHash: string | undefined;
-        srcChainId?: string;
-    };
-    apiConfig?: RequestOverrideConfig;
-    queryOptions?: UseQueryOptions<SubmitSwapTxStatusResponse | undefined, Error>;
-};
-/**
- * React hook for polling the processing status of a submitted swap transaction.
- *
- * @param {UseBackendSubmitSwapTxStatusParams | undefined} params - Parameters for the query:
- *   - `params.txHash`: The transaction hash of the submitted swap; query is disabled if undefined or empty.
- *   - `params.srcChainId`: Optional source chain ID to narrow the status lookup.
- *   - `queryOptions`: Optional React Query options to override default behavior (e.g., refetchInterval, retry).
- *
- * @returns {UseQueryResult<SubmitSwapTxStatusResponse | undefined, Error>} React Query result object:
- *   - `data`: The status response or undefined if unavailable.
- *   - `isLoading`: Loading state.
- *   - `error`: Error instance if the query failed.
- *   - `refetch`: Function to re-trigger the query.
- *
- * @example
- * const { data: status, isLoading, error } = useBackendSubmitSwapTxStatus({
- *   params: { txHash: '0x123...', srcChainId: '1' },
- * });
- *
- * if (status?.data.status === 'executed') {
- *   console.log('Swap completed!', status.data.result);
- * }
- *
- * @remarks
- * - Query is disabled if `params` is undefined or `txHash` is undefined/empty.
- * - Default refetch interval is 1 second for real-time status polling.
- * - Uses React Query for state management, caching, and retries.
- */
-declare const useBackendSubmitSwapTxStatus: (params: UseBackendSubmitSwapTxStatusParams | undefined) => UseQueryResult<SubmitSwapTxStatusResponse | undefined, Error>;
-
-type UseBackendOrderbookParams = {
-    queryOptions?: UseQueryOptions<OrderbookResponse | undefined, Error>;
-    pagination?: BackendPaginationParams;
-};
-/**
- * Hook for fetching the solver orderbook from the backend API.
- *
- * @param {UseBackendOrderbookParams | undefined} params - Optional parameters:
- *   - `pagination`: Pagination configuration (see `BackendPaginationParams`), including
- *      `offset` and `limit` (both required for fetch to be enabled).
- *   - `queryOptions`: Optional React Query options to override default behavior.
- *
- * @returns {UseQueryResult<OrderbookResponse | undefined, Error>} React Query result object:
- *   - `data`: The orderbook response, or undefined if unavailable.
- *   - `isLoading`: Loading state.
- *   - `error`: Error instance if the query failed.
- *   - `refetch`: Function to re-trigger the query.
- *
- * @example
- * const { data, isLoading, error } = useBackendOrderbook({
- *   pagination: { offset: '0', limit: '10' },
- *   queryOptions: { staleTime: 60000 },
- * });
- *
- * @remarks
- * - Query is disabled if `params?.pagination`, `offset`, or `limit` are missing/empty.
- * - Caches and manages server state using React Query.
- * - Default `staleTime` is 30 seconds to support near-real-time updates.
- */
-declare const useBackendOrderbook: (params: UseBackendOrderbookParams | undefined) => UseQueryResult<OrderbookResponse | undefined>;
-
-type UseBackendMoneyMarketPositionParams = {
-    userAddress: string | undefined;
-    queryOptions?: UseQueryOptions<MoneyMarketPosition | undefined, Error>;
-};
-/**
- * React hook for fetching a user's money market position from the backend API.
- *
- * @param {UseBackendMoneyMarketPositionParams | undefined} params - Parameters object:
- *   - userAddress: The user's wallet address to fetch positions for. If undefined or empty, the query is disabled.
- *   - queryOptions: (Optional) React Query options to customize behavior (e.g., staleTime, enabled).
- *
- * @returns {UseQueryResult<MoneyMarketPosition | undefined, Error>} - React Query result object with:
- *   - data: The user's money market position data, or undefined if not available.
- *   - isLoading: Loading state.
- *   - error: An Error instance if fetching failed.
- *   - refetch: Function to manually trigger a refetch.
- *
- * @example
- * const { data, isLoading, error } = useBackendMoneyMarketPosition({
- *   userAddress: '0xabc...',
- *   queryOptions: { staleTime: 60000 },
- * });
- */
-declare const useBackendMoneyMarketPosition: (params: UseBackendMoneyMarketPositionParams | undefined) => UseQueryResult<MoneyMarketPosition | undefined, Error>;
-
-type UseBackendAllMoneyMarketAssetsParams = {
-    queryOptions?: UseQueryOptions<MoneyMarketAsset[], Error>;
-};
-/**
- * React hook to fetch all money market assets from the backend API.
- *
- * @param {UseBackendAllMoneyMarketAssetsParams | undefined} params - Optional parameters:
- *   - `queryOptions` (optional): React Query options to override default behavior (e.g., caching, retry, etc).
- *
- * @returns {UseQueryResult<MoneyMarketAsset[], Error>} React Query result object:
- *   - `data`: Array of all money market asset data when available.
- *   - `isLoading`: Boolean indicating if the request is in progress.
- *   - `error`: Error object if the request failed.
- *   - `refetch`: Function to manually trigger a data refresh.
- *
- * @example
- * const { data: assets, isLoading, error } = useBackendAllMoneyMarketAssets();
- *
- * if (isLoading) return <div>Loading assets...</div>;
- * if (error) return <div>Error: {error.message}</div>;
- * if (assets) {
- *   console.log('Total assets:', assets.length);
- *   assets.forEach(asset => {
- *     console.log(`${asset.symbol}: ${asset.liquidityRate} liquidity rate`);
- *   });
- * }
- *
- * @remarks
- * - No required parameters — fetches all available money market assets from backend.
- * - Uses React Query for caching, retries, and loading/error state management.
- * - Supports overriding React Query config via `queryOptions`.
- */
-declare const useBackendAllMoneyMarketAssets: (params: UseBackendAllMoneyMarketAssetsParams | undefined) => UseQueryResult<MoneyMarketAsset[], Error>;
-
-type UseBackendMoneyMarketAssetParams = {
-    params: {
-        reserveAddress: string | undefined;
-    };
-    queryOptions?: UseQueryOptions<MoneyMarketAsset | undefined, Error>;
-};
-/**
- * React hook to fetch a specific money market asset from the backend API.
- *
- * @param params - The hook input parameter object (may be undefined):
- *   - `params`: An object containing:
- *       - `reserveAddress` (string | undefined): Reserve contract address to fetch asset details. Disables query if undefined or empty.
- *   - `queryOptions` (optional): React Query options for advanced configuration (e.g. caching, staleTime, retry, etc.).
- *
- * @returns A React Query result object: {@link UseQueryResult} for {@link MoneyMarketAsset} or `undefined` on error or if disabled,
- *   including:
- *   - `data`: The money market asset (when available) or `undefined`.
- *   - `isLoading`: Whether the query is running.
- *   - `error`: An error encountered by the query (if any).
- *   - `refetch`: Function to manually refetch the asset.
- *
- * @example
- * const { data: asset, isLoading, error } = useBackendMoneyMarketAsset({
- *   params: { reserveAddress: '0xabc...' },
- * });
- * if (isLoading) return <div>Loading asset...</div>;
- * if (error) return <div>Error: {error.message}</div>;
- * if (asset) {
- *   console.log('Asset symbol:', asset.symbol);
- *   console.log('Liquidity rate:', asset.liquidityRate);
- *   console.log('Variable borrow rate:', asset.variableBorrowRate);
- * }
- *
- * @remarks
- * - Query is disabled if `params`, `params.params`, or `params.params.reserveAddress` is missing or empty.
- * - Uses React Query for caching and background-state management.
- * - Loading and error handling are managed automatically.
- */
-declare const useBackendMoneyMarketAsset: (params: UseBackendMoneyMarketAssetParams | undefined) => UseQueryResult<MoneyMarketAsset | undefined, Error>;
-
-type UseBackendMoneyMarketAssetBorrowersParams = {
-    params: {
-        reserveAddress: string | undefined;
-    };
-    pagination: BackendPaginationParams;
-    queryOptions?: UseQueryOptions<MoneyMarketAssetBorrowers | undefined, Error>;
-};
-/**
- * React hook for fetching borrowers for a specific money market asset from the backend API with pagination.
- *
- * @param {UseBackendMoneyMarketAssetBorrowersParams | undefined} params - Query parameters:
- *   - `params`: Object containing:
- *       - `reserveAddress`: Reserve contract address for which to fetch borrowers, or `undefined` to disable query.
- *   - `pagination`: Pagination controls with `offset` and `limit` (both required as strings).
- *   - `queryOptions` (optional): React Query options to override defaults (e.g. `staleTime`, `enabled`, etc.).
- *
- * @returns {UseQueryResult<MoneyMarketAssetBorrowers | undefined, Error>} React Query result object including:
- *   - `data`: The money market asset borrowers data, or `undefined` if not available.
- *   - `isLoading`: Boolean indicating whether the query is loading.
- *   - `error`: An Error instance if the request failed.
- *   - `refetch`: Function to manually trigger a data refresh.
- *
- * @example
- * const { data: borrowers, isLoading, error } = useBackendMoneyMarketAssetBorrowers({
- *   params: { reserveAddress: '0xabc...' },
- *   pagination: { offset: '0', limit: '20' }
- * });
- *
- * if (isLoading) return <div>Loading borrowers...</div>;
- * if (error) return <div>Error: {error.message}</div>;
- * if (borrowers) {
- *   console.log('Total borrowers:', borrowers.total);
- *   console.log('Borrowers:', borrowers.borrowers);
- * }
- *
- * @remarks
- * - The query is disabled if `reserveAddress`, `offset`, or `limit` are not provided.
- * - Uses React Query for caching, retries, and auto error/loading management.
- * - Pagination is handled via `pagination.offset` and `pagination.limit`.
- */
-declare const useBackendMoneyMarketAssetBorrowers: (params: UseBackendMoneyMarketAssetBorrowersParams | undefined) => UseQueryResult<MoneyMarketAssetBorrowers | undefined, Error>;
-
-type UseBackendMoneyMarketAssetSuppliersParams = {
-    params: {
-        reserveAddress: string | undefined;
-    };
-    pagination: BackendPaginationParams;
-    queryOptions?: UseQueryOptions<MoneyMarketAssetSuppliers | undefined, Error>;
-};
-/**
- * React hook for fetching suppliers for a specific money market asset from the backend API, with pagination support.
- *
- * @param {UseBackendMoneyMarketAssetSuppliersParams | undefined} params - Hook parameters:
- *   - `params`: Object containing:
- *       - `reserveAddress`: The reserve contract address to query, or undefined to disable the query.
- *   - `pagination`: Backend pagination controls (`offset` and `limit` as strings).
- *   - `queryOptions` (optional): React Query options to override defaults.
- *
- * @returns {UseQueryResult<MoneyMarketAssetSuppliers | undefined, Error>} - Query result object with:
- *   - `data`: The asset suppliers data when available.
- *   - `isLoading`: Indicates if the request is in progress.
- *   - `error`: Error object if the request failed.
- *   - `refetch`: Function to trigger a manual data refresh.
- *
- * @example
- * const { data: suppliers, isLoading, error } = useBackendMoneyMarketAssetSuppliers({
- *   params: { reserveAddress: '0xabc...' },
- *   pagination: { offset: '0', limit: '20' }
- * });
- *
- * if (isLoading) return <div>Loading suppliers...</div>;
- * if (error) return <div>Error: {error.message}</div>;
- * if (suppliers) {
- *   console.log('Total suppliers:', suppliers.total);
- *   console.log('Suppliers:', suppliers.suppliers);
- * }
- *
- * @remarks
- * - The query is disabled if `reserveAddress`, `offset`, or `limit` are not provided.
- * - Uses React Query for efficient caching, automatic retries, and error/loading handling.
- * - Pagination is handled via `pagination.offset` and `pagination.limit`.
- */
-declare const useBackendMoneyMarketAssetSuppliers: (params: UseBackendMoneyMarketAssetSuppliersParams | undefined) => UseQueryResult<MoneyMarketAssetSuppliers | undefined, Error>;
-
-type UseBackendAllMoneyMarketBorrowersParams = {
-    pagination: BackendPaginationParams;
-    queryOptions?: UseQueryOptions<MoneyMarketBorrowers | undefined, Error>;
-};
-/**
- * Hook for fetching all money market borrowers from the backend API.
- *
- * This hook provides access to the list of all borrowers across all money market assets,
- * with pagination support. The data is automatically fetched and cached using React Query.
- *
- * @param {Object} params - Pagination parameters for fetching all borrowers
- * @param {string} params.offset - The offset for pagination (number as string)
- * @param {string} params.limit - The limit for pagination (number as string)
- *
- * @returns {UseQueryResult<MoneyMarketBorrowers | undefined>} A query result object containing:
- *   - data: The all borrowers data when available
- *   - isLoading: Boolean indicating if the request is in progress
- *   - error: Error object if the request failed
- *   - refetch: Function to manually trigger a data refresh
- *
- * @example
- * ```typescript
- * const { data: borrowers, isLoading, error } = useAllMoneyMarketBorrowers({
- *   offset: '0',
- *   limit: '50'
- * });
- *
- * if (isLoading) return <div>Loading borrowers...</div>;
- * if (error) return <div>Error: {error.message}</div>;
- * if (borrowers) {
- *   console.log('Total borrowers:', borrowers.total);
- *   console.log('Borrowers:', borrowers.borrowers);
- * }
- * ```
- *
- * @remarks
- * - The query is disabled when params are undefined or invalid
- * - Uses React Query for efficient caching and state management
- * - Automatically handles error states and loading indicators
- * - Supports pagination through offset and limit parameters
- * - Returns borrowers across all money market assets
- */
-declare const useBackendAllMoneyMarketBorrowers: (params: UseBackendAllMoneyMarketBorrowersParams | undefined) => UseQueryResult<MoneyMarketBorrowers | undefined>;
-
-/**
- * Hook for checking token allowance for bridge operations.
- *
- * This hook verifies if the user has approved enough tokens for a specific bridge action.
- * It automatically queries and tracks the allowance status.
- *
- * @param {BridgeParams} params - The parameters for the bridge to check allowance for.
- * @param {SpokeProvider} spokeProvider - The spoke provider to use for allowance checks
- *
- * @returns {UseQueryResult<boolean, Error>} A React Query result containing:
- *   - data: Boolean indicating if allowance is sufficient
- *   - isLoading: Loading state indicator
- *   - error: Any error that occurred during the check
- *
- * @example
- * ```typescript
- * const { data: hasAllowed, isLoading } = useBridgeAllowance(params, spokeProvider);
- * ```
- */
-declare function useBridgeAllowance(params: CreateBridgeIntentParams | undefined, spokeProvider: SpokeProvider | undefined): UseQueryResult<boolean, Error>;
-
-interface UseBridgeApproveReturn {
-    approve: (params: CreateBridgeIntentParams) => Promise<boolean>;
-    isLoading: boolean;
-    error: Error | null;
-    resetError: () => void;
-}
-/**
- * Hook for approving token spending for bridge actions
- * @param spokeProvider The spoke provider instance for the chain
- * @returns Object containing approve function, loading state, error state and reset function
- * @example
- * ```tsx
- * const { approve, isLoading, error } = useBridgeApprove(spokeProvider);
- *
- * // Approve tokens for bridge action
- * await approve({
- *   srcChainId: '0x2105.base',
- *   srcAsset: '0x...',
- *   amount: 1000n,
- *   dstChainId: '0x89.polygon',
- *   dstAsset: '0x...',
- *   recipient: '0x...'
- * });
- * ```
- */
-declare function useBridgeApprove(spokeProvider: SpokeProvider | undefined): UseBridgeApproveReturn;
-
-/**
- * Hook for executing bridge transactions to transfer tokens between chains.
- * Uses React Query's useMutation for better state management and caching.
- *
- * @param {SpokeProvider} spokeProvider - The spoke provider to use for the bridge
- * @returns {UseMutationResult} Mutation result object containing mutation function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: bridge, isPending } = useBridge(spokeProvider);
- *
- * const handleBridge = async () => {
- *   const result = await bridge({
- *     srcChainId: '0x2105.base',
- *     srcAsset: '0x...',
- *     amount: 1000n,
- *     dstChainId: '0x89.polygon',
- *     dstAsset: '0x...',
- *     recipient: '0x...'
- *   });
- *
- *   console.log('Bridge transaction hashes:', {
- *     spokeTxHash: result.spokeTxHash,
- *     hubTxHash: result.hubTxHash
- *   });
- * };
- * ```
- */
-declare function useBridge(spokeProvider: SpokeProvider | undefined): UseMutationResult<Result<[SpokeTxHash, HubTxHash], BridgeError<BridgeErrorCode>>, Error, CreateBridgeIntentParams>;
-
-/**
- * Hook for getting the amount available to be bridged.
- *
- * This hook is used to check if a target chain has enough balance to bridge when bridging.
- * It automatically queries and tracks the available amount to be bridged.
- *
- * @param {SpokeChainId | undefined} chainId - The chain ID to get the balance for
- * @param {string | undefined} token - The token address to get the balance for
- *
- * @returns {UseQueryResult<BridgeLimit, Error>} A React Query result containing:
- *   - data: Data about available amount to be bridged
- *   - error: Any error that occurred during the check
- *
- * @example
- * ```typescript
- * const { data: balance, isLoading } = useSpokeAssetManagerTokenBalance(chainId, tokenAddress);
- *
- * if (balance) {
- *   console.log('Asset manager token balance:', balance.toString());
- * }
- * ```
- */
-declare function useGetBridgeableAmount(from: XToken | undefined, to: XToken | undefined): UseQueryResult<BridgeLimit, Error>;
-
-/**
-/**
- * Hook for retrieving all bridgeable tokens from a source token on one chain to a destination chain.
- *
- * This hook queries and tracks the set of tokens on the destination chain that can be bridged to,
- * given a source chain, destination chain, and source token address.
- *
- * @param {SpokeChainId | undefined} from - The source chain ID
- * @param {SpokeChainId | undefined} to - The destination chain ID
- * @param {string | undefined} token - The source token address
- *
- * @returns {UseQueryResult<XToken[], Error>} A React Query result containing:
- *   - data: Array of bridgeable tokens (XToken[]) on the destination chain
- *   - error: Any error that occurred during the query
- *
- *
- * @example
- * ```typescript
- * const { data: bridgeableTokens, isLoading } = useGetBridgeableTokens(
- *   fromChainId,
- *   toChainId,
- *   fromTokenAddress
- * );
- *
- * if (bridgeableTokens && bridgeableTokens.length > 0) {
- *   bridgeableTokens.forEach(token => {
- *     console.log(`Bridgeable token: ${token.symbol} (${token.address}) on chain ${token.xChainId}`);
- *   });
- * } else {
- *   console.log('No bridgeable tokens found for the selected route.');
- * }
- * ```
- */
-declare function useGetBridgeableTokens(from: SpokeChainId | undefined, to: SpokeChainId | undefined, token: string | undefined): UseQueryResult<XToken[], Error>;
-
-/**
- * Hook for executing stake transactions to stake SODA tokens and receive xSODA shares.
- * Uses React Query's useMutation for better state management and caching.
- *
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider to use for the stake
- * @returns {UseMutationResult<[SpokeTxHash, HubTxHash], Error, StakeParams>} Mutation result object containing mutation function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: stake, isPending } = useStake(spokeProvider);
- *
- * const handleStake = async () => {
- *   const result = await stake({
- *     amount: 1000000000000000000n, // 1 SODA
- *     account: '0x...'
- *   });
- *
- *   console.log('Stake successful:', result);
- * };
- * ```
- */
-declare function useStake(spokeProvider: SpokeProvider | undefined): UseMutationResult<[SpokeTxHash, HubTxHash], Error, StakeParams>;
-
-/**
- * Hook for approving SODA token spending for staking operations.
- * Uses React Query's useMutation for better state management and caching.
- *
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider to use for the approval
- * @returns {UseMutationResult<TxReturnType<SpokeProvider, false>, Error, Omit<StakeParams, 'action'>>} Mutation result object containing mutation function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: approve, isPending } = useStakeApprove(spokeProvider);
- *
- * const handleApprove = async () => {
- *   const result = await approve({
- *     amount: 1000000000000000000n, // 1 SODA
- *     account: '0x...'
- *   });
- *
- *   console.log('Approval successful:', result);
- * };
- * ```
- */
-declare function useStakeApprove(spokeProvider: SpokeProvider | undefined): UseMutationResult<TxReturnType<SpokeProvider, false>, Error, Omit<StakeParams, 'action'>>;
-
-/**
- * Hook for checking SODA token allowance for staking operations.
- * Uses React Query for efficient caching and state management.
- *
- * @param {Omit<StakeParams, 'action'> | undefined} params - The staking parameters. If undefined, the query will be disabled.
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider to use for the allowance check
- * @returns {UseQueryResult<boolean, Error>} Query result object containing allowance data and state
- *
- * @example
- * ```typescript
- * const { data: hasAllowed, isLoading } = useStakeAllowance(
- *   {
- *     amount: 1000000000000000000n, // 1 SODA
- *     account: '0x...'
- *   },
- *   spokeProvider
- * );
- *
- * if (isLoading) return <div>Checking allowance...</div>;
- * if (hasAllowed) {
- *   console.log('Sufficient allowance for staking');
- * }
- * ```
- */
-declare function useStakeAllowance(params: Omit<StakeParams, 'action'> | undefined, spokeProvider: SpokeProvider | undefined): UseQueryResult<boolean, Error>;
-
-/**
- * Hook for executing unstake transactions to unstake xSODA shares.
- * Uses React Query's useMutation for better state management and caching.
- *
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider to use for the unstake
- * @returns {UseMutationResult<[SpokeTxHash, HubTxHash], Error, Omit<UnstakeParams, 'action'>>} Mutation result object containing mutation function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: unstake, isPending } = useUnstake(spokeProvider);
- *
- * const handleUnstake = async () => {
- *   const result = await unstake({
- *     amount: 1000000000000000000n, // 1 xSODA
- *     account: '0x...'
- *   });
- *
- *   console.log('Unstake successful:', result);
- * };
- * ```
- */
-declare function useUnstake(spokeProvider: SpokeProvider | undefined): UseMutationResult<[SpokeTxHash, HubTxHash], Error, Omit<UnstakeParams, 'action'>>;
-
-/**
- * Hook for executing claim transactions to claim unstaked SODA tokens after the unstaking period.
- * Uses React Query's useMutation for better state management and caching.
- *
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider to use for the claim
- * @returns {UseMutationResult<[SpokeTxHash, HubTxHash], Error, Omit<ClaimParams, 'action'>>} Mutation result object containing mutation function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: claim, isPending } = useClaim(spokeProvider);
- *
- * const handleClaim = async () => {
- *   const result = await claim({
- *     requestId: 1n
- *   });
- *
- *   console.log('Claim successful:', result);
- * };
- * ```
- */
-declare function useClaim(spokeProvider: SpokeProvider | undefined): UseMutationResult<[SpokeTxHash, HubTxHash], Error, Omit<ClaimParams, 'action'>>;
-
-/**
- * Hook for executing cancel unstake transactions to cancel pending unstake requests.
- * Uses React Query's useMutation for better state management and caching.
- *
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider to use for the cancel unstake
- * @returns {UseMutationResult<[SpokeTxHash, HubTxHash], Error, Omit<CancelUnstakeParams, 'action'>>} Mutation result object containing mutation function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: cancelUnstake, isPending } = useCancelUnstake(spokeProvider);
- *
- * const handleCancelUnstake = async () => {
- *   const result = await cancelUnstake({
- *     requestId: 1n
- *   });
- *
- *   console.log('Cancel unstake successful:', result);
- * };
- * ```
- */
-declare function useCancelUnstake(spokeProvider: SpokeProvider | undefined): UseMutationResult<[SpokeTxHash, HubTxHash], Error, Omit<CancelUnstakeParams, 'action'>>;
-
-/**
- * Hook for fetching comprehensive staking information for a user.
- * Uses React Query for efficient caching and state management.
- *
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider to use for the query
- * @param {number} refetchInterval - The interval in milliseconds to refetch data (default: 5000)
- * @returns {UseQueryResult<StakingInfo, Error>} Query result object containing staking info and state
- *
- * @example
- * ```typescript
- * const { data: stakingInfo, isLoading, error } = useStakingInfo(spokeProvider);
- *
- * if (isLoading) return <div>Loading staking info...</div>;
- * if (stakingInfo) {
- *   console.log('Total staked:', stakingInfo.totalStaked);
- *   console.log('User staked:', stakingInfo.userStaked);
- *   console.log('xSODA balance:', stakingInfo.userXSodaBalance);
- * }
- * ```
- */
-declare function useStakingInfo(spokeProvider: SpokeProvider | undefined, refetchInterval?: number): UseQueryResult<StakingInfo, Error>;
-
-type UnstakingInfoWithPenalty = UnstakingInfo & {
-    requestsWithPenalty: UnstakeRequestWithPenalty[];
-};
-/**
- * Hook for fetching unstaking information with penalty calculations from the stakedSoda contract.
- * Uses React Query for efficient caching and state management.
- *
- * @param {string | undefined} userAddress - The user address to fetch unstaking info for
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider instance
- * @param {number} refetchInterval - The interval in milliseconds to refetch data (default: 5000)
- * @returns {UseQueryResult<UnstakingInfoWithPenalty, Error>} Query result object containing unstaking info with penalties and state
- *
- * @example
- * ```typescript
- * const { data: unstakingInfo, isLoading, error } = useUnstakingInfoWithPenalty(userAddress, spokeProvider);
- *
- * if (isLoading) return <div>Loading unstaking info...</div>;
- * if (unstakingInfo) {
- *   console.log('Total unstaking:', unstakingInfo.totalUnstaking);
- *   unstakingInfo.requestsWithPenalty.forEach(request => {
- *     console.log('Penalty:', request.penaltyPercentage + '%');
- *     console.log('Claimable amount:', request.claimableAmount);
- *   });
- * }
- * ```
- */
-declare function useUnstakingInfoWithPenalty(userAddress: string | undefined, spokeProvider: SpokeProvider | undefined, refetchInterval?: number): UseQueryResult<UnstakingInfoWithPenalty, Error>;
-
-/**
- * Hook for fetching staking configuration from the stakedSoda contract.
- * Uses React Query for efficient caching and state management.
- *
- * @param {number} refetchInterval - The interval in milliseconds to refetch data (default: 30000)
- * @returns {UseQueryResult<StakingConfig, Error>} Query result object containing staking config and state
- *
- * @example
- * ```typescript
- * const { data: stakingConfig, isLoading, error } = useStakingConfig();
- *
- * if (isLoading) return <div>Loading staking config...</div>;
- * if (stakingConfig) {
- *   console.log('Unstaking period (days):', stakingConfig.unstakingPeriod / 86400n);
- *   console.log('Max penalty (%):', stakingConfig.maxPenalty);
- * }
- * ```
- */
-declare function useStakingConfig(refetchInterval?: number): UseQueryResult<StakingConfig, Error>;
-
-/**
- * Hook for fetching stake ratio estimates (xSoda amount and preview deposit).
- * Uses React Query for efficient caching and state management.
- *
- * @param {bigint | undefined} amount - The amount of SODA to estimate stake for
- * @param {number} refetchInterval - The interval in milliseconds to refetch data (default: 10000)
- * @returns {UseQueryResult<[bigint, bigint], Error>} Query result object containing stake ratio estimates and state
- *
- * @example
- * ```typescript
- * const { data: stakeRatio, isLoading, error } = useStakeRatio(1000000000000000000n); // 1 SODA
- *
- * if (isLoading) return <div>Loading stake ratio...</div>;
- * if (stakeRatio) {
- *   const [xSodaAmount, previewDepositAmount] = stakeRatio;
- *   console.log('xSoda amount:', xSodaAmount);
- *   console.log('Preview deposit:', previewDepositAmount);
- * }
- * ```
- */
-declare function useStakeRatio(amount: bigint | undefined, refetchInterval?: number): UseQueryResult<[bigint, bigint], Error>;
-
-/**
- * Hook for fetching instant unstake ratio estimates.
- * Uses React Query for efficient caching and state management.
- *
- * @param {bigint | undefined} amount - The amount of xSoda to estimate instant unstake for
- * @param {number} refetchInterval - The interval in milliseconds to refetch data (default: 10000)
- * @returns {UseQueryResult<bigint, Error>} Query result object containing instant unstake ratio and state
- *
- * @example
- * ```typescript
- * const { data: instantUnstakeRatio, isLoading, error } = useInstantUnstakeRatio(1000000000000000000n); // 1 xSoda
- *
- * if (isLoading) return <div>Loading instant unstake ratio...</div>;
- * if (instantUnstakeRatio) {
- *   console.log('Instant unstake ratio:', instantUnstakeRatio);
- * }
- * ```
- */
-declare function useInstantUnstakeRatio(amount: bigint | undefined, refetchInterval?: number): UseQueryResult<bigint, Error>;
-
-/**
- * Hook for fetching converted assets amount for xSODA shares.
- * Uses React Query for efficient caching and state management.
- *
- * @param {bigint | undefined} amount - The amount of xSODA shares to convert
- * @param {number} refetchInterval - The interval in milliseconds to refetch data (default: 10000)
- * @returns {UseQueryResult<bigint, Error>} Query result object containing converted assets amount and state
- *
- * @example
- * ```typescript
- * const { data: convertedAssets, isLoading, error } = useConvertedAssets(1000000000000000000n); // 1 xSODA
- *
- * if (isLoading) return <div>Loading converted assets...</div>;
- * if (convertedAssets) {
- *   console.log('Converted assets:', convertedAssets);
- * }
- * ```
- */
-declare function useConvertedAssets(amount: bigint | undefined, refetchInterval?: number): UseQueryResult<bigint, Error>;
-
-/**
- * Hook for executing instant unstake operations.
- * Uses React Query for efficient state management and error handling.
- *
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider for the transaction
- * @returns {UseMutationResult<[string, string], Error, Omit<InstantUnstakeParams, 'action'>>} Mutation result object containing instant unstake state and methods
- *
- * @example
- * ```typescript
- * const { mutateAsync: instantUnstake, isPending } = useInstantUnstake(spokeProvider);
- *
- * const handleInstantUnstake = async () => {
- *   const result = await instantUnstake({
- *     amount: 1000000000000000000n,
- *     minAmount: 950000000000000000n,
- *     account: '0x...'
- *   });
- *   console.log('Instant unstake successful:', result);
- * };
- * ```
- */
-declare function useInstantUnstake(spokeProvider: SpokeProvider | undefined): UseMutationResult<[string, string], Error, Omit<InstantUnstakeParams, 'action'>>;
-
-/**
- * Hook for checking xSODA token allowance for unstaking operations.
- * Uses React Query for efficient caching and state management.
- *
- * @param {Omit<UnstakeParams, 'action'> | undefined} params - The unstaking parameters. If undefined, the query will be disabled.
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider to use for the allowance check
- * @returns {UseQueryResult<boolean, Error>} Query result object containing allowance data and state
- *
- * @example
- * ```typescript
- * const { data: hasAllowed, isLoading } = useUnstakeAllowance(
- *   {
- *     amount: 1000000000000000000n, // 1 xSODA
- *     account: '0x...'
- *   },
- *   spokeProvider
- * );
- *
- * if (isLoading) return <div>Checking allowance...</div>;
- * if (hasAllowed) {
- *   console.log('Sufficient allowance for unstaking');
- * }
- * ```
- */
-declare function useUnstakeAllowance(params: Omit<UnstakeParams, 'action'> | undefined, spokeProvider: SpokeProvider | undefined): UseQueryResult<boolean, Error>;
-
-/**
- * Hook for approving xSODA token spending for unstaking operations.
- * Uses React Query's useMutation for better state management and caching.
- *
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider to use for the approval
- * @returns {UseMutationResult<TxReturnType<SpokeProvider, false>, Error, Omit<UnstakeParams, 'action'>>} Mutation result object containing mutation function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: approve, isPending } = useUnstakeApprove(spokeProvider);
- *
- * const handleApprove = async () => {
- *   const result = await approve({
- *     amount: 1000000000000000000n, // 1 xSODA
- *     account: '0x...'
- *   });
- *
- *   console.log('Approval successful:', result);
- * };
- * ```
- */
-declare function useUnstakeApprove(spokeProvider: SpokeProvider | undefined): UseMutationResult<TxReturnType<SpokeProvider, false>, Error, Omit<UnstakeParams, 'action'>>;
-
-/**
- * Hook for fetching unstaking information from the stakedSoda contract.
- * Uses React Query for efficient caching and state management.
- *
- * @param {string | undefined} userAddress - The user address to fetch unstaking info for
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider instance
- * @param {number} refetchInterval - The interval in milliseconds to refetch data (default: 5000)
- * @returns {UseQueryResult<UnstakingInfo, Error>} Query result object containing unstaking info and state
- *
- * @example
- * ```typescript
- * const { data: unstakingInfo, isLoading, error } = useUnstakingInfo(userAddress, spokeProvider);
- *
- * if (isLoading) return <div>Loading unstaking info...</div>;
- * if (unstakingInfo) {
- *   console.log('Total unstaking:', unstakingInfo.totalUnstaking);
- *   unstakingInfo.userUnstakeSodaRequests.forEach(request => {
- *     console.log('Request amount:', request.request.amount);
- *   });
- * }
- * ```
- */
-declare function useUnstakingInfo(userAddress: string | undefined, spokeProvider: SpokeProvider | undefined, refetchInterval?: number): UseQueryResult<UnstakingInfo, Error>;
-
-/**
- * Hook for approving xSODA token spending for instant unstaking operations.
- * Uses React Query's useMutation for better state management and caching.
- *
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider to use for the approval
- * @returns {UseMutationResult<TxReturnType<SpokeProvider, false>, Error, Omit<InstantUnstakeParams, 'action'>>} Mutation result object containing mutation function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: approve, isPending } = useInstantUnstakeApprove(spokeProvider);
- *
- * const handleApprove = async () => {
- *   const result = await approve({
- *     amount: 1000000000000000000n, // 1 xSODA
- *     minAmount: 950000000000000000n, // 0.95 SODA
- *     account: '0x...'
- *   });
- *
- *   console.log('Approval successful:', result);
- * };
- * ```
- */
-declare function useInstantUnstakeApprove(spokeProvider: SpokeProvider | undefined): UseMutationResult<TxReturnType<SpokeProvider, false>, Error, Omit<InstantUnstakeParams, 'action'>>;
-
-/**
- * Hook for checking xSODA token allowance for instant unstaking operations.
- * Uses React Query for efficient caching and state management.
- *
- * @param {Omit<InstantUnstakeParams, 'action'> | undefined} params - The instant unstaking parameters. If undefined, the query will be disabled.
- * @param {SpokeProvider | undefined} spokeProvider - The spoke provider to use for the allowance check
- * @returns {UseQueryResult<boolean, Error>} Query result object containing allowance data and state
- *
- * @example
- * ```typescript
- * const { data: hasAllowed, isLoading } = useInstantUnstakeAllowance(
- *   {
- *     amount: 1000000000000000000n, // 1 xSODA
- *     minAmount: 950000000000000000n, // 0.95 SODA
- *     account: '0x...'
- *   },
- *   spokeProvider
- * );
- *
- * if (isLoading) return <div>Checking allowance...</div>;
- * if (hasAllowed) {
- *   console.log('Sufficient allowance for instant unstaking');
- * }
- * ```
- */
-declare function useInstantUnstakeAllowance(params: Omit<InstantUnstakeParams, 'action'> | undefined, spokeProvider: SpokeProvider | undefined): UseQueryResult<boolean, Error>;
-
-declare const MIGRATION_MODE_ICX_SODA = "icxsoda";
-declare const MIGRATION_MODE_BNUSD = "bnusd";
-type MigrationMode = typeof MIGRATION_MODE_ICX_SODA | typeof MIGRATION_MODE_BNUSD;
-interface MigrationIntentParams {
-    token: XToken$1 | undefined;
-    amount: string | undefined;
-    sourceAddress: string | undefined;
-    migrationMode?: MigrationMode;
-    toToken?: XToken$1;
-    destinationAddress?: string;
-}
-
-/**
- * Hook for executing migration operations between chains.
- *
- * This hook handles ICX/SODA and bnUSD migrations by accepting a spoke provider
- * and returning a mutation function that accepts migration parameters.
- *
- * @param {SpokeProvider} spokeProvider - The spoke provider to use for the migration
- * @returns {UseMutationResult} Mutation result object containing migration function and state
- *
- * @example
- * ```typescript
- * const { mutateAsync: migrate, isPending } = useMigrate(spokeProvider);
- *
- * const result = await migrate({
- *   token: { address: "0x...", decimals: 18 },
- *   amount: "100",
- *   migrationMode: MIGRATION_MODE_ICX_SODA,
- *   toToken: { address: "0x...", decimals: 18 },
- *   destinationAddress: "0x..."
- * });
- * ```
- */
-declare function useMigrate(spokeProvider: SpokeProvider | undefined): UseMutationResult<{
-    spokeTxHash: string;
-    hubTxHash: `0x${string}`;
-}, Error, MigrationIntentParams>;
-
-/**
- * Hook for checking token allowance for migration operations.
- *
- * This hook verifies if the user has approved enough tokens for migration operations.
- * It handles both ICX/SODA and bnUSD migration allowance checks.
- *
- * @param {MigrationIntentParams} params - The parameters for the migration allowance check
- * @param {SpokeProvider} spokeProvider - The spoke provider to use for allowance checks
- *
- * @returns {UseQueryResult<boolean, Error>} A React Query result containing:
- *   - data: Boolean indicating if allowance is sufficient
- *   - isLoading: Loading state indicator
- *   - error: Any error that occurred during the check
- *
- * @example
- * ```typescript
- * const { data: hasAllowed, isLoading } = useMigrationAllowance(params, spokeProvider);
- * ```
- */
-declare function useMigrationAllowance(params: MigrationIntentParams | undefined, spokeProvider: SpokeProvider | undefined): UseQueryResult<boolean, Error>;
-
-interface UseApproveReturn {
-    approve: ({ params }: {
-        params: MigrationIntentParams;
-    }) => Promise<boolean>;
-    isLoading: boolean;
-    error: Error | null;
-    resetError: () => void;
-    isApproved: boolean;
-}
-/**
- * Hook for approving token spending for migration actions
- * @param params The parameters for the migration approval
- * @param spokeProvider The spoke provider instance for the chain
- * @returns Object containing approve function, loading state, error state and reset function
- * @example
- * ```tsx
- * const { approve, isLoading, error } = useMigrationApprove(params, spokeProvider);
- *
- * // Approve tokens for migration
- * await approve({ params });
- * ```
- */
-declare function useMigrationApprove(params: MigrationIntentParams | undefined, spokeProvider: SpokeProvider | undefined): UseApproveReturn;
-
-type UsePoolsProps = {
-    /**
-     * Optional react-query QueryObserverOptions for customizing query behavior such as
-     * staleTime, refetchInterval, cacheTime, etc. These are merged with sensible defaults.
-     */
-    queryOptions?: QueryObserverOptions<PoolKey[], Error>;
-};
-/**
- * Loads and caches the available list of pools from the DEX service's ConcentratedLiquidityService.
- *
- * By default, the query result is cached indefinitely (with `staleTime` set to Infinity), reflecting the
- * assumption that the pools list is mostly static.
- *
- * @param params
- *   Optional configuration object:
- *   - queryOptions: Partial QueryObserverOptions for react-query (merged with built-in defaults).
- *
- * @returns
- *   A UseQueryResult object from @tanstack/react-query containing:
- *   - `data`: Array of PoolKey objects or undefined if not loaded or errored.
- *   - Status fields: `isLoading`, `isError`, `error`, etc.
- *
- * @example
- *   const { data: pools, isLoading, error } = usePools();
- *   if (isLoading) return <div>Loading pools...</div>;
- *   if (error) return <div>Error: {error.message}</div>;
- *   if (pools) pools.forEach((pool, idx) => console.log(pool.id, pool.fee));
- */
-declare function usePools(params?: UsePoolsProps): UseQueryResult<PoolKey[], Error>;
-
-type UsePoolDataProps = {
-    poolKey: PoolKey | null;
-    enabled?: boolean;
-    queryOptions?: QueryObserverOptions<PoolData, Error>;
-};
-/**
- * React hook to fetch on-chain data for a given DEX pool.
- *
- * @param {UsePoolDataProps} props - The props object:
- *   - `poolKey`: PoolKey | null — The unique identifier for the pool to fetch data for. If null, disables the query.
- *   - `enabled`: boolean (optional) — Whether the query is enabled. Defaults to enabled if a poolKey is provided, otherwise false.
- *   - `queryOptions`: QueryObserverOptions<PoolData, Error> (optional) — Additional React Query options (e.g., staleTime, refetchInterval).
- *
- * @returns {UseQueryResult<PoolData, Error>} React Query result containing pool data (`data`), loading state (`isLoading`), error (`error`), and status fields.
- *
- * @example
- * ```typescript
- * const { data: poolData, isLoading, error } = usePoolData({ poolKey });
- * if (isLoading) return <div>Loading…</div>;
- * if (error) return <div>Error!</div>;
- * if (poolData) {
- *   // poolData is available
- * }
- * ```
- *
- * @remarks
- * - Refetches pool data every 30 seconds by default, and may be configured via `queryOptions`.
- * - If `poolKey` is `null`, the query is disabled and no network request is performed.
- * - Throws an error if `poolKey` is missing when the query is enabled.
- */
-declare function usePoolData({ poolKey, queryOptions, }: UsePoolDataProps): UseQueryResult<PoolData, Error>;
-
-interface UsePoolBalancesResponse {
-    token0Balance: bigint;
-    token1Balance: bigint;
-}
-interface UsePoolBalancesProps {
-    poolData: PoolData | null;
-    poolKey: PoolKey | null;
-    spokeProvider: SpokeProvider | null;
-    enabled?: boolean;
-    queryOptions?: QueryObserverOptions<UsePoolBalancesResponse, Error>;
-}
-/**
- * React hook to query a user's token balances for a DEX pool.
- *
- * Given the pool data (with token addresses), the pool's key, and a SpokeProvider,
- * fetches the user's protocol balances for both token0 and token1 for the specified pool.
- * Queries are auto-refreshed; advanced options can be customized via `queryOptions`.
- *
- * @param {UsePoolBalancesProps} props
- *   Object containing:
- *   - `poolData`: {PoolData | null} - Pool info (must include token0 and token1 addresses). Required unless disabling.
- *   - `poolKey`: {PoolKey | null} - Unique key for the DEX pool. Required unless disabling.
- *   - `spokeProvider`: {SpokeProvider | null} - Provider instance for the chain. Required unless disabling.
- *   - `enabled`: {boolean} (optional) - Whether to enable the query. Defaults to `true` if all other arguments are provided.
- *   - `queryOptions`: {QueryObserverOptions<UsePoolBalancesResponse, Error>} (optional) - Advanced react-query options.
- *
- * @returns {UseQueryResult<UsePoolBalancesResponse, Error>}
- *   React Query result object:
- *   - `data`: `{ token0Balance: bigint, token1Balance: bigint }` if loaded, undefined otherwise.
- *   - `isLoading`, `isError`, etc. for status handling.
- *
- * @remarks
- * - Throws an error if any of `poolData`, `poolKey`, or `spokeProvider` is missing when enabled.
- * - Suitable for tracking current protocol/wallet balances for both pool tokens.
- * - The hook is designed for use within a React component tree that provides the Sodax context.
- * - Data are automatically refreshed at the provided or default polling interval (default: refetch every 10s).
- *
- * @example
- * ```typescript
- * const { data, isLoading } = usePoolBalances({ poolData, poolKey, spokeProvider });
- * if (data) {
- *   console.log('Balances:', data.token0Balance, data.token1Balance);
- * }
- * ```
- */
-declare function usePoolBalances({ poolData, poolKey, spokeProvider, enabled, queryOptions, }: UsePoolBalancesProps): UseQueryResult<UsePoolBalancesResponse, Error>;
-
-interface UsePositionInfoResponse {
-    positionInfo: ClPositionInfo;
-    isValid: boolean;
-}
-interface UsePositionInfoProps {
-    tokenId: string | null;
-    poolKey: PoolKey | null;
-    queryOptions?: QueryObserverOptions<UsePositionInfoResponse, Error>;
-}
-/**
- * React hook to fetch and validate CL position details by position NFT token ID.
- *
- * Fetches position data on-chain for a given tokenId, and checks if it matches the expected PoolKey.
- * This is commonly used in DEX dashboards to show or pre-validate user positions by ID.
- *
- * @param {string | null} tokenId
- *   Position NFT token ID to query, as a string. Pass `null` or empty string to disable.
- * @param {PoolKey | null} poolKey
- *   PoolKey to match against the position's underlying pool. Pass `null` to disable.
- * @param {QueryObserverOptions<UsePositionInfoResponse, Error>} [queryOptions]
- *   Optional react-query options for polling/refresh and config. Merged with sensible defaults.
- *
- * @returns {UseQueryResult<UsePositionInfoResponse, Error>}
- *   Standard React Query result object:
- *   - `data`: { positionInfo, isValid } if loaded, or undefined if not loaded/error
- *   - `isLoading`: boolean (query active)
- *   - `isError`: boolean (query failed)
- *   - ...other react-query helpers (refetch, status, etc)
- *
- * @example
- * ```typescript
- * const { data, isLoading, error } = usePositionInfo({ tokenId, poolKey });
- * if (isLoading) return <div>Loading position...</div>;
- * if (error) return <div>Error: {error.message}</div>;
- * if (data) {
- *   console.log('Valid for pool:', data.isValid);
- *   console.log('Liquidity:', data.positionInfo.liquidity);
- * }
- * ```
- *
- * @remarks
- * - Validates the underlying position's pool definition (currency0, currency1, fee) with the supplied PoolKey.
- * - Returns `isValid: false` if any field mismatches.
- * - Pass `null` as tokenId or poolKey to disable the query.
- * - Defaults: 10s stale, not enabled if missing arguments. Customizable via `queryOptions`.
- * - Throws error if called with invalid/null tokenId or poolKey when enabled.
- */
-declare function usePositionInfo({ tokenId, poolKey, queryOptions, }: UsePositionInfoProps): UseQueryResult<UsePositionInfoResponse, Error>;
-
-type UseDexDepositParams = {
-    params: CreateAssetDepositParams;
-    spokeProvider: SpokeProvider;
-};
-/**
-/**
- * React hook that provides a mutation to perform a deposit into a DEX pool using the provided parameters and SpokeProvider.
- *
- * The hook returns a mutation object for executing the deposit (`mutateAsync`), tracking its state (`isPending`), and any resulting error (`error`).
- * On successful deposit, all queries matching ['dex', 'poolBalances'] are invalidated and refetched.
- *
- * @returns {UseMutationResult<[SpokeTxHash, HubTxHash], Error, UseDexDepositParams>}
- *   React Query mutation result:
- *   - `mutateAsync({ params, spokeProvider })`: Triggers the deposit with {@link CreateDepositParams} and the target SpokeProvider.
- *   - `isPending`: True while the deposit transaction is pending.
- *   - `error`: Error if the mutation fails.
- *
- * @example
- * ```typescript
- * const { mutateAsync: deposit, isPending, error } = useDexDeposit();
- * await deposit({ params: { asset, amount, poolToken }, spokeProvider });
- * ```
- *
- * @remarks
- * - Throws if called with missing `spokeProvider` or `params`.
- * - Upon success, automatically refetches up-to-date pool balances.
- */
-declare function useDexDeposit(): UseMutationResult<[SpokeTxHash, HubTxHash], Error, UseDexDepositParams>;
-
-type UseDexWithdrawParams = {
-    params: CreateAssetWithdrawParams;
-    spokeProvider: SpokeProvider;
-};
-/**
- * React hook to provide a mutation for withdrawing assets from a DEX pool.
- *
- * This hook returns a mutation result object valid for use with React Query.
- * The mutation function expects an object with the withdrawal parameters and a SpokeProvider,
- * and triggers the withdrawal operation on the DEX. On success, it invalidates the relevant
- * ['dex', 'poolBalances'] query to fetch the updated balances.
- *
- * @returns {UseMutationResult<[SpokeTxHash, HubTxHash], Error, UseDexWithdrawParams>}
- *   Mutation result object. Use its properties to:
- *   - Call `mutateAsync({ params, spokeProvider })` to perform the withdrawal.
- *   - Track progress with `isPending`.
- *   - Access any `error` encountered during the mutation.
- *
- * @example
- * const { mutateAsync: withdraw, isPending, error } = useDexWithdraw();
- * await withdraw({ params, spokeProvider });
- */
-declare function useDexWithdraw(): UseMutationResult<[SpokeTxHash, HubTxHash], Error, UseDexWithdrawParams>;
-
-type UseDexAllowanceProps = {
-    params: CreateAssetDepositParams | undefined;
-    spokeProvider: SpokeProvider | null;
-    enabled?: boolean;
-    queryOptions?: QueryObserverOptions<boolean, Error>;
-};
-/**
- * Hook to check if the user has approved sufficient token allowance for DEX deposits.
- *
- * This hook automatically queries and tracks the allowance status, indicating whether
- * the user has granted enough allowance to allow a specific deposit to the DEX. It leverages
- * React Query for status, caching, and background refetching.
- *
- * @param {CreateAssetDepositParams | undefined} params
- *   The deposit parameters: asset address, poolToken, and raw amount (BigInt), or undefined to disable.
- * @param {SpokeProvider | undefined} spokeProvider
- *   The provider interface for the selected chain. When undefined, the query is disabled.
- * @param {boolean} [enabled]
- *   Whether the allowance status check is enabled. Defaults to true if both params and spokeProvider are truthy.
- * @param {QueryObserverOptions<boolean, Error>} [queryOptions]
- *   Optional react-query options. Any override here (e.g. staleTime, refetchInterval) will merge with defaults.
- *
- * @returns {UseQueryResult<boolean, Error>}
- *   React Query result object: `data` is boolean (true if allowance is sufficient), plus `isLoading`, `error`, etc.
- *
- * @example
- * ```typescript
- * const { data: isAllowed, isLoading, error } = useDexAllowance({
- *   params: { asset, amount: parseUnits('100', 18), poolToken },
- *   spokeProvider,
- * });
- * if (isLoading) return <Spinner />;
- * if (error) return <div>Error: {error.message}</div>;
- * if (isAllowed) { ... }
- * ```
- *
- * @remarks
- * - The allowance is checked every 5 seconds as long as enabled, params, and spokeProvider are all defined.
- * - Returns `false` if allowance cannot be determined or any error occurs in isAllowanceValid.
- * - Suitable for gating UI actions that require token approval before depositing in the DEX.
- */
-declare function useDexAllowance({ params, spokeProvider, queryOptions, }: UseDexAllowanceProps): UseQueryResult<boolean, Error>;
-
-type UseDexApproveParams = {
-    params: CreateAssetDepositParams;
-    spokeProvider: SpokeProvider;
-};
-/**
- * React hook for performing a DEX token allowance approval transaction.
- *
- * Returns a mutation object that allows explicitly triggering a token approval
- * for a DEX deposit, using the specified approval parameters and spoke provider.
- * On successful approval, the related allowance query is invalidated and refetched
- * for consistent UI state.
- *
- * @returns {UseMutationResult<SpokeTxHash, Error, UseDexApproveParams>}
- *   React Query mutation result for the approval operation. Use `mutateAsync` with
- *   an object of shape `{ params, spokeProvider }` to initiate approval.
- *
- * @example
- * ```typescript
- * const { mutateAsync: approve, isPending, error } = useDexApprove();
- * await approve({ params: { asset, amount, poolToken }, spokeProvider });
- * ```
- *
- * @remarks
- * - Throws if called without both a valid `params` and `spokeProvider`.
- * - On approval success, the query for ['dex', 'allowance'] is invalidated/refetched.
- */
-declare function useDexApprove(): UseMutationResult<SpokeTxHash, Error, UseDexApproveParams>;
-
-interface UseLiquidityAmountsResult {
-    liquidityToken0Amount: string;
-    liquidityToken1Amount: string;
-    lastEditedToken: 'token0' | 'token1' | null;
-    setLiquidityToken0Amount: (value: string) => void;
-    setLiquidityToken1Amount: (value: string) => void;
-    handleToken0AmountChange: (value: string) => void;
-    handleToken1AmountChange: (value: string) => void;
-}
-/**
- * Hook for calculating liquidity amounts based on price range.
- *
- * This hook manages the state and calculations for liquidity token amounts.
- * It automatically calculates the corresponding token amount when one is changed,
- * based on the current price range and pool data.
- *
- * @param {string} minPrice - Minimum price for the liquidity range
- * @param {string} maxPrice - Maximum price for the liquidity range
- * @param {PoolData | null} poolData - The pool data containing token information
- * @returns {UseLiquidityAmountsResult} Object containing amounts, state, and handlers
- *
- * @example
- * ```typescript
- * const {
- *   liquidityToken0Amount,
- *   liquidityToken1Amount,
- *   handleToken0AmountChange,
- *   handleToken1AmountChange,
- * } = useLiquidityAmounts(minPrice, maxPrice, poolData);
- *
- * <Input
- *   value={liquidityToken0Amount}
- *   onChange={(e) => handleToken0AmountChange(e.target.value)}
- * />
- * ```
- */
-declare function useLiquidityAmounts(minPrice: string, maxPrice: string, poolData: PoolData | null): UseLiquidityAmountsResult;
-
-type UseCreateSupplyLiquidityParamsProps = {
-    poolData: PoolData;
-    poolKey: PoolKey;
-    minPrice: string;
-    maxPrice: string;
-    liquidityToken0Amount: string;
-    liquidityToken1Amount: string;
-    slippageTolerance: string | number;
-    positionId?: string | null;
-    isValidPosition?: boolean;
-};
-type UseCreateSupplyLiquidityParamsResult = ConcentratedLiquiditySupplyParams & Omit<ConcentratedLiquidityIncreaseLiquidityParams, 'tokenId'> & {
-    tokenId?: string | bigint;
-    positionId?: string | null;
-    isValidPosition?: boolean;
-};
-/**
- * React hook to create the supply liquidity parameters for a given pool.
- *
- * Purpose:
- *   - Provides a hook which memoizes the supply liquidity parameters for a given pool.
- *
- * Usage:
- *   - Call the function with the pool data, pool key, minimum price, maximum price, liquidity token0 amount, liquidity token1 amount, slippage tolerance, position id, and validity of the position to create the supply liquidity parameters.
- *
- * Params:
- * @param poolData - The pool data of the pool to supply liquidity to.
- * @param poolKey - The pool key of the pool to supply liquidity to.
- * @param minPrice - The minimum price of the liquidity to supply.
- * @param maxPrice - The maximum price of the liquidity to supply.
- * @param liquidityToken0Amount - The amount of the token0 to supply.
- * @param liquidityToken1Amount - The amount of the token1 to supply.
- * @param slippageTolerance - The slippage tolerance to use for the supply.
- * @param positionId - The position id of the position to supply liquidity to.
- * @param isValidPosition - Whether the position is valid.
- * @returns The supply liquidity parameters.
- */
-declare function useCreateSupplyLiquidityParams({ poolData, poolKey, minPrice, maxPrice, liquidityToken0Amount, liquidityToken1Amount, slippageTolerance, positionId, isValidPosition, }: UseCreateSupplyLiquidityParamsProps): UseCreateSupplyLiquidityParamsResult;
-
-type UseSupplyLiquidityProps = {
-    params: UseCreateSupplyLiquidityParamsResult;
-    spokeProvider: SpokeProvider;
-};
-/**
- * Hook for supplying liquidity to a pool.
- *
- * This hook handles both minting new positions and increasing liquidity in existing positions.
- * It applies slippage tolerance before calculating liquidity and handles the complete transaction flow.
- *
- * @param {SpokeProvider} spokeProvider - The spoke provider for the chain
- * @returns {UseMutationResult<void, Error, SupplyLiquidityParams>} Mutation result with supply function
- *
- * @example
- * ```typescript
- * const { mutateAsync: supplyLiquidity, isPending, error } = useSupplyLiquidity(spokeProvider);
- *
- * await supplyLiquidity({
- *   poolData,
- *   poolKey,
- *   minPrice: '100',
- *   maxPrice: '200',
- *   liquidityToken0Amount: '10',
- *   liquidityToken1Amount: '20',
- *   slippageTolerance: '0.5',
- * });
- * ```
- */
-declare function useSupplyLiquidity(): UseMutationResult<[SpokeTxHash, HubTxHash], Error, UseSupplyLiquidityProps>;
-
-type UseDecreaseLiquidityParams = {
-    params: ConcentratedLiquidityDecreaseLiquidityParams;
-    spokeProvider: SpokeProvider;
-};
-/**
- * React hook that provides a mutation for decreasing liquidity in a concentrated liquidity position.
- *
- * This hook returns a mutation for removing liquidity from a position using the provided
- * `ConcentratedLiquidityDecreaseLiquidityParams` and `SpokeProvider`. The mutation returns a tuple of
- * the spoke transaction hash and the hub transaction hash upon success.
- *
- * @returns {UseMutationResult<[SpokeTxHash, HubTxHash], Error, UseDecreaseLiquidityParams>}
- *   React Query mutation result:
- *   - `mutateAsync({ params, spokeProvider })`: Triggers the decrease liquidity mutation.
- *   - On success, returns `[spokeTxHash, hubTxHash]`.
- *   - On failure, throws an error.
- *
- * @example
- * ```typescript
- * const { mutateAsync: decreaseLiquidity, isPending, error } = useDecreaseLiquidity();
- *
- * await decreaseLiquidity({
- *   params: {
- *     poolKey,
- *     tokenId: 123n,
- *     liquidity: 100000n,
- *     amount0Min: 0n,
- *     amount1Min: 0n,
- *   },
- *   spokeProvider,
- * });
- * ```
- *
- * @param {UseDecreaseLiquidityParams} variables
- *   - `params`: Parameters for the decrease liquidity operation, matching `ConcentratedLiquidityDecreaseLiquidityParams`.
- *   - `spokeProvider`: The provider instance for the target spoke chain.
- *
- * @remarks
- * - After a successful liquidity decrease, the hook will invalidate DEX pool balances and position info queries.
- */
-declare function useDecreaseLiquidity(): UseMutationResult<[SpokeTxHash, HubTxHash], Error, UseDecreaseLiquidityParams>;
-
-type UseCreateDepositParamsProps = {
-    tokenIndex: 0 | 1;
-    amount: string | number;
-    poolData: PoolData;
-    poolSpokeAssets: PoolSpokeAssets;
-};
-/**
- * React hook to create the deposit parameters for a given pool and token.
- *
- * Purpose:
- *   - Provides a hook which memoizes the deposit parameters for a given pool and token.
- *
- * Usage:
- *   - Call the function with the token index, amount, pool data, pool key, and spoke provider to create the deposit parameters.
- *
- * Params:
- * @param tokenIndex - The index of the token to deposit.
- * @param amount - The amount of the token to deposit.
- * @param poolData - The pool data of the pool to deposit to.
- * @param poolKey - The pool key of the pool to deposit to.
- * @param spokeProvider - The spoke provider to use for the deposit.
- * @returns The deposit parameters or undefined if the pool key, spoke provider, or amount is not set.
- */
-declare function useCreateDepositParams({ tokenIndex, amount, poolData, poolSpokeAssets, }: UseCreateDepositParamsProps): CreateAssetDepositParams | undefined;
-
-type UseCreateDecreaseLiquidityParamsProps = {
-    poolKey: PoolKey;
-    tokenId: string | bigint;
-    percentage: string | number;
-    positionInfo: ClPositionInfo;
-    slippageTolerance: string | number;
-};
-/**
- * React hook to create the decrease liquidity parameters for a given pool and position.
- *
- * Purpose:
- *   - Provides a hook which memoizes the decrease liquidity parameters for a given pool and position.
- *
- * Usage:
- *   - Call the function with the pool key, token ID, percentage, position info, and slippage tolerance to create the decrease liquidity parameters.
- *
- * Params:
- * @param poolKey - The pool key of the pool to decrease the liquidity from.
- * @param tokenId - The token ID of the position to decrease the liquidity from.
- * @param percentage - The percentage of liquidity to decrease.
- * @param positionInfo - The position info of the position to decrease the liquidity from.
- * @param slippageTolerance - The slippage tolerance to use for the decrease.
- * @returns The decrease liquidity parameters.
- */
-declare function useCreateDecreaseLiquidityParams({ poolKey, tokenId, percentage, positionInfo, slippageTolerance, }: UseCreateDecreaseLiquidityParamsProps): ConcentratedLiquidityDecreaseLiquidityParams;
-
-type UseCreateWithdrawParamsProps = {
-    tokenIndex: 0 | 1;
-    amount: string | number;
-    poolData: PoolData;
-    poolSpokeAssets: PoolSpokeAssets;
-    dst?: DestinationParamsType;
-};
-/**
- * React hook to create the withdrawal parameters for a given pool and token.
- *
- * Purpose:
- *   - Provides a hook which memoizes the withdrawal parameters for a given pool and token.
- *
- * Usage:
- *   - Call the function with the token index, amount, pool data, pool spoke assets, and destination parameters to create the withdrawal parameters.
- *
- * Params:
- * @param tokenIndex - The index of the token to withdraw.
- * @param amount - The amount of the token to withdraw.
- * @param poolData - The pool data of the pool to withdraw from.
- * @param poolSpokeAssets - The pool spoke assets of the pool to withdraw from.
- * @param dst - The destination parameters for the withdrawal.
- * @returns The withdrawal parameters or undefined if the amount is not set.
- */
-declare function useCreateWithdrawParams({ tokenIndex, amount, poolData, poolSpokeAssets, dst, }: UseCreateWithdrawParamsProps): CreateAssetWithdrawParams | undefined;
-
-type UseClaimRewardsParams = {
-    params: ConcentratedLiquidityClaimRewardsParams;
-    spokeProvider: SpokeProvider;
-};
-/**
- * React hook for creating a mutation to claim DEX rewards for a concentrated liquidity position.
- *
- * @returns {UseMutationResult<[SpokeTxHash, HubTxHash], ConcentratedLiquidityError<ConcentratedLiquidityErrorCode>, UseClaimRewardsParams>}
- *   Returns a react-query mutation result object:
- *   - On success: resolves to a tuple `[SpokeTxHash, HubTxHash]`.
- *   - On error: the error is of type `ConcentratedLiquidityError<ConcentratedLiquidityErrorCode>`.
- *   - The mutation function expects an argument of type {@link UseClaimRewardsParams}
- *     containing `params` (the claim parameters) and `spokeProvider` (the target provider).
- *   - On mutation success, invalidates the queries `'dex/poolBalances'` and `'dex/positionInfo'`.
- *
- * @example
- * const claimRewardsMutation = useClaimRewards();
- * claimRewardsMutation.mutateAsync({
- *   params: { poolKey, tokenId, tickLower, tickUpper },
- *   spokeProvider,
- * });
- */
-declare function useClaimRewards(): UseMutationResult<[
-    SpokeTxHash,
-    HubTxHash
-], ConcentratedLiquidityError<ConcentratedLiquidityErrorCode>, UseClaimRewardsParams>;
-
-interface SodaxProviderProps {
-    children: ReactNode;
-    testnet?: boolean;
-    config?: SodaxConfig;
-    rpcConfig: RpcConfig;
-}
-declare const SodaxProvider: ({ children, testnet, config, rpcConfig }: SodaxProviderProps) => ReactElement;
-
-declare function createDecreaseLiquidityParamsProps({ poolKey, tokenId, percentage, positionInfo, slippageTolerance, }: UseCreateDecreaseLiquidityParamsProps): ConcentratedLiquidityDecreaseLiquidityParams;
-declare function createDepositParamsProps({ tokenIndex, amount, poolData, poolSpokeAssets, }: UseCreateDepositParamsProps): CreateAssetDepositParams;
-declare function createSupplyLiquidityParamsProps({ poolData, poolKey, minPrice, maxPrice, liquidityToken0Amount, liquidityToken1Amount, slippageTolerance, positionId, isValidPosition, }: UseCreateSupplyLiquidityParamsProps): UseCreateSupplyLiquidityParamsResult;
-declare function createWithdrawParamsProps({ tokenIndex, amount, poolData, poolSpokeAssets, dst, }: UseCreateWithdrawParamsProps): CreateAssetWithdrawParams;
-
-export { type BackendPaginationParams, MIGRATION_MODE_BNUSD, MIGRATION_MODE_ICX_SODA, type MigrationIntentParams, type MigrationMode, type RadfiSession, SodaxProvider, type UseATokenParams, type UseATokensBalancesParams, type UseBorrowParams, type UseClaimRewardsParams, type UseCreateDecreaseLiquidityParamsProps, type UseCreateDepositParamsProps, type UseCreateSupplyLiquidityParamsProps, type UseCreateSupplyLiquidityParamsResult, type UseCreateWithdrawParamsProps, type UseDecreaseLiquidityParams, type UseDexAllowanceProps, type UseDexApproveParams, type UseDexDepositParams, type UseDexWithdrawParams, type UseMMAllowanceParams, type UseMMApproveParams, type UsePoolBalancesProps, type UsePoolBalancesResponse, type UsePoolDataProps, type UsePoolsProps, type UsePositionInfoProps, type UsePositionInfoResponse, type UseRadfiSessionReturn, type UseRepayParams, type UseReservesDataParams, type UseReservesUsdFormatParams, type UseSupplyLiquidityProps, type UseSupplyParams, type UseUserFormattedSummaryParams, type UseUserReservesDataParams, type UseWithdrawParams, clearRadfiSession, createDecreaseLiquidityParamsProps, createDepositParamsProps, createSupplyLiquidityParamsProps, createWithdrawParamsProps, loadRadfiSession, saveRadfiSession, useAToken, useATokensBalances, useBackendAllMoneyMarketAssets, useBackendAllMoneyMarketBorrowers, useBackendIntentByHash, useBackendIntentByTxHash, useBackendMoneyMarketAsset, useBackendMoneyMarketAssetBorrowers, useBackendMoneyMarketAssetSuppliers, useBackendMoneyMarketPosition, useBackendOrderbook, useBackendSubmitSwapTx, useBackendSubmitSwapTxStatus, useBackendUserIntents, useBitcoinBalance, useBorrow, useBridge, useBridgeAllowance, useBridgeApprove, useCancelLimitOrder, useCancelSwap, useCancelUnstake, useClaim, useClaimRewards, useConvertedAssets, useCreateDecreaseLiquidityParams, useCreateDepositParams, useCreateLimitOrder, useCreateSupplyLiquidityParams, useCreateWithdrawParams, useDecreaseLiquidity, useDeriveUserWalletAddress, useDexAllowance, useDexApprove, useDexDeposit, useDexWithdraw, useEstimateGas, useExpiredUtxos, useFundTradingWallet, useGetBridgeableAmount, useGetBridgeableTokens, useGetUserHubWalletAddress, useHubProvider, useInstantUnstake, useInstantUnstakeAllowance, useInstantUnstakeApprove, useInstantUnstakeRatio, useLiquidityAmounts, useMMAllowance, useMMApprove, useMigrate, useMigrationAllowance, useMigrationApprove, usePoolBalances, usePoolData, usePools, usePositionInfo, useQuote, useRadfiAuth, useRadfiSession, useRadfiWithdraw, useRenewUtxos, useRepay, useRequestTrustline, useReservesData, useReservesUsdFormat, useSodaxContext, useSpokeProvider, useStake, useStakeAllowance, useStakeApprove, useStakeRatio, useStakingConfig, useStakingInfo, useStatus, useStellarTrustlineCheck, useSupply, useSupplyLiquidity, useSwap, useSwapAllowance, useSwapApprove, useTradingWalletBalance, useUnstake, useUnstakeAllowance, useUnstakeApprove, useUnstakingInfo, useUnstakingInfoWithPenalty, useUserFormattedSummary, useUserReservesData, useWithdraw };