@sodax/dapp-kit 2.0.0-rc.3 → 2.0.0-rc.4

package/dist/index.d.cts

@@ -1,1557 +0,0 @@
-import { UseQueryOptions, UseMutationOptions, UseMutationResult, MutateOptions, UseQueryResult, QueryClientConfig, QueryClient } from '@tanstack/react-query';
-import { Result, Sodax, SpokeChainKey, GetEstimateGasReturnType, EstimateGasParams, IStellarWalletProvider, StellarChainKey, IXServiceBase, XToken, EvmHubProvider, IBitcoinWalletProvider, RadfiWalletBalance, RadfiUtxo, MoneyMarketBorrowActionParams, TxHashPair, MoneyMarketRepayActionParams, MoneyMarketSupplyActionParams, MoneyMarketWithdrawActionParams, UserReserveData, AggregatedReserveData, BaseCurrencyInfo, ReservesDataHumanized, Address as Address$1, MoneyMarketParams, MoneyMarketApproveActionParams, TxReturnType, Erc20Token, ChainKey, ReserveDataHumanized, FormatReserveUSDResponse, FormatUserSummaryResponse, SolverIntentQuoteResponse, SolverErrorResponse, SolverIntentQuoteRequest, SwapActionParams, SwapResponse, SolverIntentStatusResponse, Hex, CreateIntentParams, CreateLimitOrderParams, GetWalletProviderType, Intent, LimitOrderActionParams, IntentResponse, UserIntentsResponse, SubmitSwapTxResponse, SubmitSwapTxRequest, RequestOverrideConfig, SubmitSwapTxStatusResponse, OrderbookResponse, MoneyMarketPosition, MoneyMarketAsset, MoneyMarketAssetBorrowers, MoneyMarketAssetSuppliers, MoneyMarketBorrowers, BridgeParams, CreateBridgeIntentParams, BridgeLimit, StakeAction, StakeParams, UnstakeAction, ClaimAction, CancelUnstakeAction, StakingInfo, UnstakingInfo, UnstakeRequestWithPenalty, StakingConfig, InstantUnstakeAction, UnstakeParams, InstantUnstakeParams, PartnerFeeClaimAssetBalance, AutoSwapPreferences, FeeTokenApproveParams, FeeTokenApproveAction, HubChainKey, SetSwapPreferenceAction, PartnerFeeClaimSwapAction, IntentAutoSwapResult, HubAssetBalance, WithdrawHubAssetAction, IcxMigrateAction, IcxRevertMigrationAction, UnifiedBnUSDMigrateAction, BalnMigrateAction, MigrationAction, IcxMigrateParams, IcxCreateRevertMigrationParams, UnifiedBnUSDMigrateParams, BalnMigrateParams, PoolKey, PoolData, ClPositionInfo, AssetDepositAction, AssetWithdrawAction, CreateAssetDepositParams, ClSupplyParams, ClIncreaseLiquidityParams, ClLiquidityDecreaseLiquidityAction, ClDecreaseLiquidityParams, CreateAssetWithdrawParams, PoolSpokeAssets, DestinationParamsType, ClLiquidityClaimRewardsAction, DeepPartial, SodaxConfig } from '@sodax/sdk';
-export * from '@sodax/sdk';
-import { Address } from 'viem';
-import { ReactNode, ReactElement } from 'react';
-
-/**
- * Subset of `UseQueryOptions` consumers may override on dapp-kit read hooks.
- *
- * `queryKey`, `queryFn`, and `enabled` are owned by the hook (the latter is derived
- * from required-input presence) and are intentionally stripped here.
- */
-type ReadQueryOptions<TData, TError = Error> = Omit<UseQueryOptions<TData, TError>, 'queryKey' | 'queryFn' | 'enabled'>;
-/**
- * Canonical params shape for read-only `useQuery`-backed hooks in dapp-kit.
- *
- * Two top-level keys, always:
- * - `params`: SDK-feature-domain inputs (the "what" being fetched)
- * - `queryOptions`: React Query behavior knobs (the "how" the query behaves)
- *
- * For hooks with no required inputs, leave `TParams` at its default and accept the
- * whole params object as optional at the call site.
- */
-type ReadHookParams<TData, TParams = Record<string, never>, TError = Error> = {
-    params?: TParams;
-    queryOptions?: ReadQueryOptions<TData, TError>;
-};
-/**
- * Subset of `UseMutationOptions` consumers may override on dapp-kit mutation hooks.
- *
- * `mutationFn` is owned by the hook (it's the SDK integration point) and is
- * intentionally stripped here. Everything else — `mutationKey`, `retry`, `gcTime`,
- * `networkMode`, `onMutate`, `onSuccess`, `onError`, `onSettled`, `meta`, etc. —
- * is consumer-overridable.
- *
- * Conventions enforced by every dapp-kit mutation hook:
- *
- * 1. **`mutationFn` throws on SDK failure.** The SDK returns `Result<T>`; the hook
- *    unwraps `result.value` on `ok` and throws `result.error` on `!ok`. So `TData`
- *    here is the unwrapped success type, not `Result<T>`. React Query's native
- *    error model — `isError`, `error`, `onError`, `retry`, `throwOnError`, devtools —
- *    works exactly as documented.
- *
- * 2. **`onSuccess` is composed.** Hook-owned invalidations always run first; then
- *    the hook awaits `mutationOptions?.onSuccess?.(data, vars, ctx)`. Per-call
- *    `mutate(vars, { onSuccess })` runs after both, per TanStack Query's native
- *    ordering. Because invalidations now live inside `onSuccess` (not `onSettled`),
- *    they only fire on confirmed success — failed mutations never trigger them.
- *
- * 3. **A default `mutationKey` is set per hook** (e.g. `['mm', 'supply']`,
- *    `['swap']`) so consumers can use `useIsMutating(['mm'])` and
- *    `useMutationState` without guessing the key shape. The default is set
- *    *before* `...mutationOptions` is spread, so consumers can override it.
- */
-type MutationHookOptions<TData, TVars, TError = Error, TContext = unknown> = Omit<UseMutationOptions<TData, TError, TVars, TContext>, 'mutationFn'>;
-/**
- * Canonical params shape for `useMutation`-backed hooks in dapp-kit.
- *
- * One top-level key:
- * - `mutationOptions`: React Query behavior knobs (the "how" the mutation behaves)
- *
- * Domain inputs (params, walletProvider, etc.) are NOT here — they belong in
- * `TVars` and flow through `mutate(vars)` so the call site can vary them per
- * invocation without re-rendering the hook.
- *
- * Always accept the whole params object as optional at the call site:
- * `useFoo({ mutationOptions } = {})`.
- */
-type MutationHookParams<TData, TVars, TError = Error, TContext = unknown> = {
-    mutationOptions?: MutationHookOptions<TData, TVars, TError, TContext>;
-};
-
-/**
- * Translates the SDK's `Result<T>` contract into the React Query contract: returns `value` on
- * success, throws `error` on failure. Non-`Error` throwables are wrapped so consumers always get
- * an `Error` in `mutation.error` / catch blocks.
- *
- * Used by every dapp-kit mutation hook so the React Query error model (`isError`, `error`,
- * `onError`, `retry`, `throwOnError`, devtools) engages uniformly.
- */
-declare function unwrapResult<T>(result: Result<T>): T;
-
-/**
- * Return shape of every dapp-kit mutation hook. Extends `UseMutationResult` with one extra
- * method, `mutateAsyncSafe`, that never rejects — it returns the SDK's `Result<T>` shape so
- * callers can branch on `.ok` without `try/catch`.
- *
- * The underlying `mutationFn` still throws on SDK failure, so React Query's native error model
- * (`isError`, `error`, `onError`, `retry`, `throwOnError`, devtools) keeps working as documented.
- */
-type SafeUseMutationResult<TData, TError, TVars, TContext = unknown> = UseMutationResult<TData, TError, TVars, TContext> & {
-    /**
-     * Like `mutateAsync` but never rejects. Returns `Result<TData>` so callers can branch
-     * on `.ok` without `try/catch`.
-     *
-     * Use this for imperative flows where rejection-style errors are awkward — e.g. sequential
-     * `if (!hasAllowance) await approve(...); await action(...)` chains where the user-reject
-     * case is the modal failure mode, not an exceptional one.
-     */
-    mutateAsyncSafe: (vars: TVars, options?: MutateOptions<TData, TError, TVars, TContext>) => Promise<Result<TData>>;
-};
-/**
- * Wraps a `Promise<T>` (typically `mutateAsync(vars)`) into a `Promise<Result<T>>` that never
- * rejects. Pure, side-effect-free — extracted for unit testing.
- */
-declare function toResult<T>(promise: Promise<T>): Promise<Result<T>>;
-/**
- * Drop-in replacement for `useMutation` that augments the result with `mutateAsyncSafe`. Used
- * by every dapp-kit mutation hook so consumers can pick rejection-style (`mutateAsync`) or
- * Result-style (`mutateAsyncSafe`) ergonomics without the hook author having to think about it.
- */
-declare function useSafeMutation<TData, TError, TVars, TContext = unknown>(options: UseMutationOptions<TData, TError, TVars, TContext>): SafeUseMutationResult<TData, TError, TVars, TContext>;
-
-interface SodaxContextType {
-    sodax: Sodax;
-}
-
-/**
- * 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<C extends SpokeChainKey>({ mutationOptions, }?: MutationHookParams<GetEstimateGasReturnType<C>, EstimateGasParams<C>>): SafeUseMutationResult<GetEstimateGasReturnType<C>, Error, EstimateGasParams<C>>;
-
-type UseDeriveUserWalletAddressParams = ReadHookParams<Address, {
-    spokeChainId?: SpokeChainKey;
-    spokeAddress?: string;
-}>;
-declare function useDeriveUserWalletAddress({ params, queryOptions, }?: UseDeriveUserWalletAddressParams): UseQueryResult<Address, Error>;
-
-type UseStellarTrustlineCheckParams = ReadHookParams<boolean, {
-    token: string | undefined;
-    amount: bigint | undefined;
-    chainId: SpokeChainKey | undefined;
-    walletProvider: IStellarWalletProvider | undefined;
-}>;
-declare function useStellarTrustlineCheck({ params, queryOptions, }?: UseStellarTrustlineCheckParams): UseQueryResult<boolean, Error>;
-
-declare function useRequestTrustline(token: string | undefined): {
-    requestTrustline: (params: {
-        token: string;
-        amount: bigint;
-        srcChainKey: StellarChainKey;
-        walletProvider: IStellarWalletProvider;
-    }) => Promise<string>;
-    isLoading: boolean;
-    isRequested: boolean;
-    error: Error | null;
-    data: string | null;
-};
-
-type UseGetUserHubWalletAddressParams = ReadHookParams<Address, {
-    spokeChainId?: SpokeChainKey;
-    spokeAddress?: string;
-}>;
-/**
- * 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.
- *
- * @example
- * ```typescript
- * const { data: derivedAddress, isLoading, error } = useGetUserHubWalletAddress({
- *   params: { spokeChainId, spokeAddress: userAddress },
- * });
- * ```
- */
-declare function useGetUserHubWalletAddress({ params, queryOptions, }?: UseGetUserHubWalletAddressParams): UseQueryResult<Address, Error>;
-
-/**
- * Domain inputs for {@link useXBalances}. `xChainId` is optional so the hook can be mounted
- * before a chain is selected; `enabled` gates execution on every required field being present.
- */
-interface XBalancesInputs {
-    xService: IXServiceBase | undefined;
-    xChainId: SpokeChainKey | undefined;
-    xTokens: readonly XToken[];
-    address: string | undefined;
-}
-type UseXBalancesParams = ReadHookParams<Record<string, bigint>, XBalancesInputs>;
-/**
- * Pure builder for {@link useXBalances} query options. Exported for unit
- * tests and for advanced callers that compose their own `useQuery` wrapper.
- */
-declare function getXBalancesQueryOptions({ xService, xChainId, xTokens, address }: XBalancesInputs): {
-    queryKey: readonly ["shared", "xBalances", "0xa86a.avax" | "0xa4b1.arbitrum" | "0x2105.base" | "0x38.bsc" | "injective-1" | "sonic" | "0x1.icon" | "sui" | "0xa.optimism" | "0x89.polygon" | "solana" | "stellar" | "hyper" | "lightlink" | "near" | "ethereum" | "bitcoin" | "redbelly" | "0x2019.kaia" | "stacks" | undefined, (readonly [string, string])[], string | undefined];
-    queryFn: () => Promise<Record<string, bigint>>;
-    enabled: boolean;
-    refetchInterval: number;
-};
-/**
- * Fetch token balances for multiple tokens on a specific chain. Returns an
- * object mapping each token's address to its balance in smallest unit.
- *
- * @example
- * ```tsx
- * const xService = useXService({ xChainType: getXChainType(xChainId) });
- * const { data: balances } = useXBalances({ params: { xService, xChainId, xTokens, address } });
- * ```
- */
-declare function useXBalances({ params, queryOptions, }?: UseXBalancesParams): UseQueryResult<Record<string, bigint>>;
-
-declare function useHubProvider(): EvmHubProvider;
-
-type RadfiSession = {
-    accessToken: string;
-    refreshToken: string;
-    tradingAddress: string;
-    publicKey: string;
-};
-type UseRadfiAuthVars = {
-    walletProvider: IBitcoinWalletProvider;
-};
-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;
-/**
- * React hook for authenticating with Radfi via BIP322-signed message. Pure mutation: pass
- * `{ walletProvider }` to `mutate({...})`. The hook itself takes no arguments other than the
- * structural `mutationOptions` slot.
- */
-declare function useRadfiAuth({ mutationOptions, }?: MutationHookParams<RadfiAuthResult, UseRadfiAuthVars>): SafeUseMutationResult<RadfiAuthResult, Error, UseRadfiAuthVars>;
-
-type UseRadfiSessionReturn = {
-    walletAddress: string | undefined;
-    isAuthed: boolean;
-    tradingAddress: string | undefined;
-    login: () => Promise<void>;
-    isLoginPending: boolean;
-};
-declare function useRadfiSession(walletProvider: IBitcoinWalletProvider | undefined): UseRadfiSessionReturn;
-
-type UseFundTradingWalletVars = {
-    amount: bigint;
-    walletProvider: IBitcoinWalletProvider;
-};
-/**
- * React hook for funding the user's Radfi trading wallet from their personal Bitcoin wallet.
- * Pure mutation: pass `{ amount, walletProvider }` to `mutate({...})`. Returns the broadcast tx
- * id on success.
- */
-declare function useFundTradingWallet({ mutationOptions, }?: MutationHookParams<string, UseFundTradingWalletVars>): SafeUseMutationResult<string, Error, UseFundTradingWalletVars>;
-
-type UseBitcoinBalanceParams = ReadHookParams<bigint, {
-    address: string | undefined;
-    rpcUrl?: string;
-}>;
-/**
- * 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({ params, queryOptions, }?: UseBitcoinBalanceParams): UseQueryResult<bigint, Error>;
-
-type UseTradingWalletReturn = {
-    tradingAddress: string | undefined;
-};
-/**
- * Returns the Radfi trading wallet address from the persisted session.
- * Trading wallet is created automatically during authentication — no API call needed.
- */
-declare function useTradingWallet(walletAddress: string | undefined): UseTradingWalletReturn;
-
-type UseTradingWalletBalanceParams = ReadHookParams<RadfiWalletBalance, {
-    walletProvider: IBitcoinWalletProvider | undefined;
-    tradingAddress: string | undefined;
-}>;
-declare function useTradingWalletBalance({ params, queryOptions, }?: UseTradingWalletBalanceParams): UseQueryResult<RadfiWalletBalance, Error>;
-
-type UseExpiredUtxosParams = ReadHookParams<RadfiUtxo[], {
-    walletProvider: IBitcoinWalletProvider | undefined;
-    tradingAddress: string | undefined;
-}>;
-declare function useExpiredUtxos({ params, queryOptions, }?: UseExpiredUtxosParams): UseQueryResult<RadfiUtxo[], Error>;
-
-type UseRenewUtxosVars = {
-    txIdVouts: string[];
-    walletProvider: IBitcoinWalletProvider;
-};
-/**
- * React hook for renewing expired UTXOs in the user's Radfi trading wallet. Pure mutation: pass
- * `{ txIdVouts, walletProvider }` to `mutate({...})`.
- */
-declare function useRenewUtxos({ mutationOptions, }?: MutationHookParams<string, UseRenewUtxosVars>): SafeUseMutationResult<string, Error, UseRenewUtxosVars>;
-
-type UseRadfiWithdrawVars = {
-    amount: string;
-    tokenId: string;
-    withdrawTo: string;
-    walletProvider: IBitcoinWalletProvider;
-};
-type WithdrawResult = {
-    txId: string;
-    fee: number;
-};
-/**
- * React hook for withdrawing BTC from the user's Radfi trading wallet back to their personal
- * Bitcoin wallet. Pure mutation: pass all inputs (including the wallet provider) to
- * `mutate({...})`.
- */
-declare function useRadfiWithdraw({ mutationOptions, }?: MutationHookParams<WithdrawResult, UseRadfiWithdrawVars>): SafeUseMutationResult<WithdrawResult, Error, UseRadfiWithdrawVars>;
-
-/**
- * Mutation variables for {@link useBorrow}. Generic over `K extends SpokeChainKey` (defaults to
- * the full union). Sophisticated callers can lock K at the hook call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseBorrowVars<K extends SpokeChainKey = SpokeChainKey> = Omit<MoneyMarketBorrowActionParams<K, false>, 'raw'>;
-/**
- * React hook for borrowing tokens from the Sodax money market protocol.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useBorrow<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseBorrowVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseBorrowVars<K>>;
-
-/**
- * Mutation variables for {@link useRepay}. Generic over `K extends SpokeChainKey` (defaults to
- * the full union). Sophisticated callers can lock K at the hook call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseRepayVars<K extends SpokeChainKey = SpokeChainKey> = Omit<MoneyMarketRepayActionParams<K, false>, 'raw'>;
-/**
- * React hook for repaying a borrow in the Sodax money market protocol.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useRepay<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseRepayVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseRepayVars<K>>;
-
-/**
- * Mutation variables for {@link useSupply}. Generic over `K extends SpokeChainKey` (defaults to
- * the full union). Sophisticated callers can lock K at the hook call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseSupplyVars<K extends SpokeChainKey = SpokeChainKey> = Omit<MoneyMarketSupplyActionParams<K, false>, 'raw'>;
-/**
- * React hook for supplying tokens to the Sodax money market protocol.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- *
- * @example
- * ```tsx
- * const walletProvider = useWalletProvider({ xChainId: chainKey });
- * const { mutateAsync: supply, isError, error } = useSupply();
- * if (!walletProvider) return;
- * try {
- *   const { spokeTxHash, hubTxHash } = await supply({ params: supplyParams, walletProvider });
- * } catch (e) {
- *   // surfaced via mutation.error / onError
- * }
- * ```
- */
-declare function useSupply<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseSupplyVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseSupplyVars<K>>;
-
-/**
- * Mutation variables for {@link useWithdraw}. Generic over `K extends SpokeChainKey` (defaults to
- * the full union). Sophisticated callers can lock K at the hook call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseWithdrawVars<K extends SpokeChainKey = SpokeChainKey> = Omit<MoneyMarketWithdrawActionParams<K, false>, 'raw'>;
-/**
- * React hook for withdrawing supplied tokens from the Sodax money market protocol.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useWithdraw<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseWithdrawVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseWithdrawVars<K>>;
-
-type UseUserReservesDataParams = ReadHookParams<readonly [readonly UserReserveData[], number], {
-    spokeChainKey: SpokeChainKey | undefined;
-    userAddress: string | undefined;
-}>;
-/**
- * React hook for fetching the raw user reserves data (positions on the hub) for a given spoke
- * chain and user address.
- */
-declare function useUserReservesData({ params, queryOptions, }?: UseUserReservesDataParams): UseQueryResult<readonly [readonly UserReserveData[], number], Error>;
-
-type UseReservesDataParams = ReadHookParams<readonly [readonly AggregatedReserveData[], BaseCurrencyInfo]>;
-/**
- * React hook for fetching the latest aggregated reserves data and base-currency info from the
- * Sodax money market.
- */
-declare function useReservesData({ queryOptions, }?: UseReservesDataParams): UseQueryResult<readonly [readonly AggregatedReserveData[], BaseCurrencyInfo], Error>;
-
-type UseReservesHumanizedParams = ReadHookParams<ReservesDataHumanized>;
-/**
- * React hook for fetching the human-readable (decimal-normalized, string-formatted) reserves
- * snapshot from the Sodax money market.
- */
-declare function useReservesHumanized({ queryOptions, }?: UseReservesHumanizedParams): UseQueryResult<ReservesDataHumanized, Error>;
-
-type UseReservesListParams = ReadHookParams<readonly Address$1[]>;
-/**
- * React hook for fetching the list of reserve asset addresses currently registered in the
- * Sodax money market.
- */
-declare function useReservesList({ queryOptions, }?: UseReservesListParams): UseQueryResult<readonly Address$1[], Error>;
-
-type UseMMAllowanceParams<K extends SpokeChainKey> = ReadHookParams<boolean, {
-    payload: MoneyMarketParams<K> | undefined;
-}>;
-/**
- * Hook for checking token allowance / trustline sufficiency for money market operations.
- *
- * Skips the on-chain check entirely for `borrow` and `withdraw` actions — those don't require
- * approval, and the SDK already short-circuits to `true` for them. The early `enabled: false`
- * here additionally avoids a render flash with `isLoading: true`.
- *
- * The query key matches the invalidation keys emitted by `useMMApprove` and the four mutation
- * hooks: `['mm', 'allowance', srcChainKey, token, action]`.
- *
- * @example
- * ```tsx
- * const { data: hasAllowance } = useMMAllowance({ params: { payload: supplyParams } });
- * ```
- */
-declare function useMMAllowance<K extends SpokeChainKey>({ params, queryOptions, }?: UseMMAllowanceParams<K>): UseQueryResult<boolean, Error>;
-
-/**
- * Mutation variables for {@link useMMApprove}. Generic over `K extends SpokeChainKey` (defaults
- * to the full union). Sophisticated callers can lock K at the hook call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseMMApproveVars<K extends SpokeChainKey = SpokeChainKey> = Omit<MoneyMarketApproveActionParams<K, false>, 'raw'>;
-/**
- * React hook for approving ERC-20 token spending (or trustline establishment) for a Sodax money
- * market action.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped tx return value on success. Invalidates the matching
- * `['mm', 'allowance', srcChainKey, token, action]` query on confirmed success.
- */
-declare function useMMApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseMMApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseMMApproveVars<K>>;
-
-type ATokenData = Erc20Token & {
-    chainKey: ChainKey;
-};
-type UseATokenParams = ReadHookParams<ATokenData, {
-    aToken: Address | string | undefined;
-}>;
-/**
- * React hook to fetch ERC-20 metadata for a given aToken address on the hub chain.
- * Returns `Erc20Token` (`name`, `symbol`, `decimals`, `address`) augmented with the hub
- * `chainKey`. Note: the returned shape is a subset of `XToken` — `hubAsset` and `vault` fields
- * must be resolved separately if needed.
- */
-declare function useAToken({ params, queryOptions }?: UseATokenParams): UseQueryResult<ATokenData, Error>;
-
-type UseATokensBalancesParams = ReadHookParams<Map<Address, bigint>, {
-    aTokens: readonly Address[];
-    spokeChainKey: SpokeChainKey | undefined;
-    userAddress: string | undefined;
-}>;
-/**
- * React hook to fetch aToken balances for a list of addresses in a single multicall.
- * Derives the user's hub wallet via `EvmHubProvider.getUserHubWalletAddress` from the
- * spoke `chainKey` + spoke wallet `userAddress`.
- */
-declare function useATokensBalances({ params, queryOptions, }?: UseATokensBalancesParams): UseQueryResult<Map<Address, bigint>, Error>;
-
-type ReserveUsdFormat = ReserveDataHumanized & FormatReserveUSDResponse;
-type UseReservesUsdFormatParams = ReadHookParams<ReserveUsdFormat[]>;
-/**
- * React hook returning reserves with USD-formatted values for the Sodax money market.
- * Chains `getReservesHumanized` → `buildReserveDataWithPrice` → `formatReservesUSD`.
- */
-declare function useReservesUsdFormat({ queryOptions, }?: UseReservesUsdFormatParams): UseQueryResult<ReserveUsdFormat[], Error>;
-
-type UseUserFormattedSummaryParams = ReadHookParams<FormatUserSummaryResponse<FormatReserveUSDResponse>, {
-    spokeChainKey: SpokeChainKey | undefined;
-    userAddress: string | undefined;
-}>;
-/**
- * React hook returning the user's formatted money market portfolio summary (collateral, borrows,
- * health factor, available borrow power, etc.) for the given spoke chain.
- *
- * Internally chains `getReservesHumanized` → `formatReservesUSD` → `getUserReservesHumanized`
- * → `formatUserSummary`.
- */
-declare function useUserFormattedSummary({ params, queryOptions, }?: UseUserFormattedSummaryParams): UseQueryResult<FormatUserSummaryResponse<FormatReserveUSDResponse>, Error>;
-
-type UseQuoteParams = ReadHookParams<Result<SolverIntentQuoteResponse, SolverErrorResponse> | undefined, {
-    payload: SolverIntentQuoteRequest | undefined;
-}>;
-/**
- * Hook for fetching a quote for an intent-based swap.
- *
- * @example
- * ```typescript
- * const { data: quote, isLoading } = useQuote({ params: { payload } });
- * ```
- *
- * @remarks
- * - The quote is automatically refreshed every 3 seconds
- * - The query is disabled when payload is undefined
- */
-declare const useQuote: ({ params, queryOptions, }?: UseQuoteParams) => UseQueryResult<Result<SolverIntentQuoteResponse, SolverErrorResponse> | undefined>;
-
-/**
- * Mutation variables for {@link useSwap}. Generic over `K extends SpokeChainKey` (defaults to the
- * full union). Sophisticated callers can lock K at the hook call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseSwapVars<K extends SpokeChainKey = SpokeChainKey> = Omit<SwapActionParams<K, false>, 'raw'>;
-/**
- * React hook for executing an intent-based cross-chain swap.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `SwapResponse` on success.
- */
-declare function useSwap<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<SwapResponse, UseSwapVars<K>>): SafeUseMutationResult<SwapResponse, Error, UseSwapVars<K>>;
-
-type UseStatusParams = ReadHookParams<Result<SolverIntentStatusResponse, SolverErrorResponse> | undefined, {
-    intentTxHash: Hex | undefined;
-}>;
-/**
- * Hook for monitoring the status of an intent-based swap.
- *
- * @example
- * ```typescript
- * const { data: status, isLoading } = useStatus({ params: { intentTxHash } });
- * ```
- */
-declare const useStatus: ({ params, queryOptions, }?: UseStatusParams) => UseQueryResult<Result<SolverIntentStatusResponse, SolverErrorResponse> | undefined>;
-
-type UseSwapAllowanceParams<K extends SpokeChainKey> = ReadHookParams<boolean, {
-    payload: CreateIntentParams | CreateLimitOrderParams | undefined;
-    srcChainKey: K | undefined;
-    walletProvider: GetWalletProviderType<K> | undefined;
-}>;
-declare function useSwapAllowance<K extends SpokeChainKey>({ params, queryOptions, }?: UseSwapAllowanceParams<K>): UseQueryResult<boolean, Error>;
-
-/**
- * Mutation variables for {@link useSwapApprove}. Generic over `K extends SpokeChainKey` (defaults
- * to the full union). Sophisticated callers can lock K at the call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseSwapApproveVars<K extends SpokeChainKey = SpokeChainKey> = {
-    params: CreateIntentParams<K> | CreateLimitOrderParams<K>;
-    walletProvider: GetWalletProviderType<K>;
-};
-/**
- * React hook for approving ERC-20 token spending (or trustline establishment) for a swap or
- * limit-order intent.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped tx return value on success. Invalidates all
- * `['swap', 'allowance', ...]` queries so any pending allowance check refreshes.
- */
-declare function useSwapApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseSwapApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseSwapApproveVars<K>>;
-
-type CancelIntentParams<K extends SpokeChainKey = SpokeChainKey> = {
-    srcChainKey: K;
-    walletProvider: GetWalletProviderType<K>;
-    intent: Intent;
-};
-/**
- * React hook for cancelling an in-flight swap intent.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useCancelSwap({ mutationOptions, }?: MutationHookParams<TxHashPair, CancelIntentParams>): SafeUseMutationResult<TxHashPair, Error, CancelIntentParams>;
-
-/**
- * Mutation variables for {@link useCreateLimitOrder}. Generic over `K extends SpokeChainKey`
- * (defaults to the full union). Sophisticated callers can lock K at the call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseCreateLimitOrderVars<K extends SpokeChainKey = SpokeChainKey> = Omit<LimitOrderActionParams<K, false>, 'raw'>;
-/**
- * React hook for creating a limit-order intent (no deadline).
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `SwapResponse` on success.
- */
-declare function useCreateLimitOrder<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<SwapResponse, UseCreateLimitOrderVars<K>>): SafeUseMutationResult<SwapResponse, Error, UseCreateLimitOrderVars<K>>;
-
-type CancelLimitOrderParams<K extends SpokeChainKey = SpokeChainKey> = {
-    srcChainKey: K;
-    walletProvider: GetWalletProviderType<K>;
-    intent: Intent;
-    timeout?: number;
-};
-/**
- * React hook for cancelling a limit-order intent.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useCancelLimitOrder({ mutationOptions, }?: MutationHookParams<TxHashPair, CancelLimitOrderParams>): SafeUseMutationResult<TxHashPair, Error, CancelLimitOrderParams>;
-
-type UseBackendIntentByTxHashParams = ReadHookParams<IntentResponse | undefined, {
-    txHash: string | undefined;
-}>;
-/**
- * React hook for fetching intent details from the backend API using a transaction hash.
- *
- * @example
- * const { data: intent } = useBackendIntentByTxHash({ params: { txHash: '0x123...' } });
- *
- * @remarks
- * - Intents are only created on the hub chain, so `txHash` must originate from there.
- * - Default refetch interval is 1 second.
- */
-declare const useBackendIntentByTxHash: ({ params, queryOptions, }?: UseBackendIntentByTxHashParams) => UseQueryResult<IntentResponse | undefined, Error>;
-
-type UseBackendIntentByHashParams = ReadHookParams<IntentResponse | undefined, {
-    intentHash: string | undefined;
-}>;
-/**
- * React hook to fetch intent details from the backend API using an intent hash.
- *
- * @example
- * const { data: intent } = useBackendIntentByHash({ params: { intentHash: '0xabc...' } });
- */
-declare const useBackendIntentByHash: ({ params, queryOptions, }?: UseBackendIntentByHashParams) => UseQueryResult<IntentResponse | undefined, Error>;
-
-type UseBackendUserIntentsParams = ReadHookParams<UserIntentsResponse | undefined, {
-    userAddress: Address$1 | undefined;
-    startDate?: number;
-    endDate?: number;
-}>;
-/**
- * React hook for fetching user-created intents from the backend API for a given user address.
- *
- * @example
- * const { data: userIntents } = useBackendUserIntents({
- *   params: { userAddress: '0x123...' },
- * });
- */
-declare const useBackendUserIntents: ({ params, queryOptions, }?: UseBackendUserIntentsParams) => UseQueryResult<UserIntentsResponse | undefined, Error>;
-
-/**
- * Mutation variables for {@link useBackendSubmitSwapTx}. The per-request `apiConfig` override
- * (e.g. base URL) belongs here rather than at the hook level — different submissions in the same
- * component can target different endpoints without re-rendering.
- */
-type UseBackendSubmitSwapTxVars = {
-    request: SubmitSwapTxRequest;
-    apiConfig?: RequestOverrideConfig;
-};
-/**
- * React hook for submitting a swap transaction to be processed by the backend (relay, post
- * execution to solver, etc.).
- *
- * Pure mutation: pass `{ request, apiConfig? }` to `mutate({...})`. Default `retry: 3` is applied
- * at the hook level — consumers can override via `mutationOptions.retry`.
- *
- * @example
- * const { mutateAsync: submitSwapTx, isPending, error } = useBackendSubmitSwapTx();
- *
- * const result = await submitSwapTx({
- *   request: { txHash: '0x123...', srcChainKey: 'sonic', walletAddress: '0xabc...', intent: { ... }, relayData: '0x...' },
- *   apiConfig: { baseURL: 'https://...' },
- * });
- */
-declare const useBackendSubmitSwapTx: ({ mutationOptions, }?: MutationHookParams<SubmitSwapTxResponse, UseBackendSubmitSwapTxVars>) => SafeUseMutationResult<SubmitSwapTxResponse, Error, UseBackendSubmitSwapTxVars>;
-
-type UseBackendSubmitSwapTxStatusParams = ReadHookParams<SubmitSwapTxStatusResponse | undefined, {
-    txHash: string | undefined;
-    srcChainKey?: string;
-    apiConfig?: RequestOverrideConfig;
-}>;
-/**
- * React hook for polling the processing status of a submitted swap transaction.
- *
- * @example
- * const { data: status } = useBackendSubmitSwapTxStatus({
- *   params: { txHash: '0x123...', srcChainKey: 'sonic' },
- * });
- *
- * @remarks
- * - Default refetch interval is 1 second; stops on 'executed' or 'failed' status.
- */
-declare const useBackendSubmitSwapTxStatus: ({ params, queryOptions, }?: UseBackendSubmitSwapTxStatusParams) => UseQueryResult<SubmitSwapTxStatusResponse | undefined, Error>;
-
-type BackendPaginationParams = {
-    offset: string;
-    limit: string;
-};
-
-type UseBackendOrderbookParams = ReadHookParams<OrderbookResponse, {
-    pagination: BackendPaginationParams;
-}>;
-/**
- * Hook for fetching the solver orderbook from the backend API.
- *
- * @example
- * const { data } = useBackendOrderbook({ params: { pagination: { offset: '0', limit: '10' } } });
- */
-declare const useBackendOrderbook: ({ params, queryOptions, }?: UseBackendOrderbookParams) => UseQueryResult<OrderbookResponse>;
-
-type UseBackendMoneyMarketPositionParams = ReadHookParams<MoneyMarketPosition | undefined, {
-    userAddress: string | undefined;
-}>;
-/**
- * React hook for fetching a user's money market position from the backend API.
- *
- * @example
- * const { data } = useBackendMoneyMarketPosition({ params: { userAddress: '0xabc...' } });
- */
-declare const useBackendMoneyMarketPosition: ({ params, queryOptions, }?: UseBackendMoneyMarketPositionParams) => UseQueryResult<MoneyMarketPosition | undefined, Error>;
-
-type UseBackendAllMoneyMarketAssetsParams = ReadHookParams<MoneyMarketAsset[]>;
-/**
- * React hook to fetch all money market assets from the backend API.
- *
- * @example
- * const { data: assets, isLoading, error } = useBackendAllMoneyMarketAssets();
- */
-declare const useBackendAllMoneyMarketAssets: ({ queryOptions, }?: UseBackendAllMoneyMarketAssetsParams) => UseQueryResult<MoneyMarketAsset[], Error>;
-
-type UseBackendMoneyMarketAssetParams = ReadHookParams<MoneyMarketAsset | undefined, {
-    reserveAddress: string | undefined;
-}>;
-/**
- * React hook to fetch a specific money market asset from the backend API.
- *
- * @example
- * const { data: asset } = useBackendMoneyMarketAsset({ params: { reserveAddress: '0xabc...' } });
- */
-declare const useBackendMoneyMarketAsset: ({ params, queryOptions, }?: UseBackendMoneyMarketAssetParams) => UseQueryResult<MoneyMarketAsset | undefined, Error>;
-
-type UseBackendMoneyMarketAssetBorrowersParams = ReadHookParams<MoneyMarketAssetBorrowers | undefined, {
-    reserveAddress: string | undefined;
-    pagination: BackendPaginationParams;
-}>;
-/**
- * React hook for fetching borrowers for a specific money market asset from the backend API with pagination.
- *
- * @example
- * const { data: borrowers } = useBackendMoneyMarketAssetBorrowers({
- *   params: { reserveAddress: '0xabc...', pagination: { offset: '0', limit: '20' } },
- * });
- */
-declare const useBackendMoneyMarketAssetBorrowers: ({ params, queryOptions, }?: UseBackendMoneyMarketAssetBorrowersParams) => UseQueryResult<MoneyMarketAssetBorrowers | undefined, Error>;
-
-type UseBackendMoneyMarketAssetSuppliersParams = ReadHookParams<MoneyMarketAssetSuppliers | undefined, {
-    reserveAddress: string | undefined;
-    pagination: BackendPaginationParams;
-}>;
-/**
- * React hook for fetching suppliers for a specific money market asset from the backend API.
- *
- * @example
- * const { data: suppliers } = useBackendMoneyMarketAssetSuppliers({
- *   params: { reserveAddress: '0xabc...', pagination: { offset: '0', limit: '20' } },
- * });
- */
-declare const useBackendMoneyMarketAssetSuppliers: ({ params, queryOptions, }?: UseBackendMoneyMarketAssetSuppliersParams) => UseQueryResult<MoneyMarketAssetSuppliers | undefined, Error>;
-
-type UseBackendAllMoneyMarketBorrowersParams = ReadHookParams<MoneyMarketBorrowers | undefined, {
-    pagination: BackendPaginationParams;
-}>;
-/**
- * Hook for fetching all money market borrowers from the backend API.
- *
- * @example
- * ```typescript
- * const { data, isLoading, error } = useBackendAllMoneyMarketBorrowers({
- *   params: { pagination: { offset: '0', limit: '50' } },
- * });
- * ```
- */
-declare const useBackendAllMoneyMarketBorrowers: ({ params, queryOptions, }?: UseBackendAllMoneyMarketBorrowersParams) => UseQueryResult<MoneyMarketBorrowers | undefined>;
-
-/**
- * Mutation variables for {@link useBridge}. Generic over `K extends SpokeChainKey` (defaults to
- * the full union). Sophisticated callers can lock K at the hook call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseBridgeVars<K extends SpokeChainKey = SpokeChainKey> = Omit<BridgeParams<K, false>, 'raw'>;
-/**
- * React hook for executing a cross-chain bridge transfer.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useBridge<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseBridgeVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseBridgeVars<K>>;
-
-type UseBridgeAllowanceParams<K extends SpokeChainKey> = ReadHookParams<boolean, {
-    payload: CreateBridgeIntentParams<K> | undefined;
-    walletProvider: GetWalletProviderType<K> | undefined;
-}>;
-declare function useBridgeAllowance<K extends SpokeChainKey>({ params, queryOptions, }?: UseBridgeAllowanceParams<K>): UseQueryResult<boolean, Error>;
-
-/**
- * Mutation variables for {@link useBridgeApprove}. Generic over `K extends SpokeChainKey`
- * (defaults to the full union). Sophisticated callers can lock K at the hook call site to narrow
- * the `walletProvider` and `params.srcChainKey` types.
- */
-type UseBridgeApproveVars<K extends SpokeChainKey = SpokeChainKey> = Omit<BridgeParams<K, false>, 'raw'>;
-/**
- * React hook for approving ERC-20 token spending (or trustline establishment) for a bridge
- * action.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped tx return value on success. Invalidates all
- * `['bridge', 'allowance', ...]` queries so any pending allowance check refreshes.
- */
-declare function useBridgeApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseBridgeApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseBridgeApproveVars<K>>;
-
-type UseGetBridgeableAmountParams = ReadHookParams<BridgeLimit, {
-    from: XToken | undefined;
-    to: XToken | undefined;
-}>;
-declare function useGetBridgeableAmount({ params, queryOptions, }?: UseGetBridgeableAmountParams): UseQueryResult<BridgeLimit, Error>;
-
-type UseGetBridgeableTokensParams = ReadHookParams<XToken[], {
-    from: SpokeChainKey | undefined;
-    to: SpokeChainKey | undefined;
-    token: string | undefined;
-}>;
-declare function useGetBridgeableTokens({ params, queryOptions, }?: UseGetBridgeableTokensParams): UseQueryResult<XToken[], Error>;
-
-/**
- * Mutation variables for {@link useStake}. Generic over `K extends SpokeChainKey` (defaults to
- * the full union). Sophisticated callers can lock K at the hook call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseStakeVars<K extends SpokeChainKey = SpokeChainKey> = Omit<StakeAction<K, false>, 'raw'>;
-/**
- * React hook for staking SODA tokens.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useStake<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseStakeVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseStakeVars<K>>;
-
-/**
- * Mutation variables for {@link useStakeApprove}. The `action` literal is injected by the hook —
- * callers pass the stake-specific fields only.
- */
-type UseStakeApproveVars<K extends SpokeChainKey = SpokeChainKey> = {
-    params: Omit<StakeParams<K>, 'action'>;
-    walletProvider: GetWalletProviderType<K>;
-};
-/**
- * React hook for approving SODA spending on the stake action.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped tx return value on success.
- */
-declare function useStakeApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseStakeApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseStakeApproveVars<K>>;
-
-type UseStakeAllowanceParams<K extends SpokeChainKey = SpokeChainKey> = ReadHookParams<boolean, {
-    payload: Omit<StakeParams<K>, 'action'> | undefined;
-}>;
-/**
- * React hook to check whether the user has approved sufficient SODA spending for the stake
- * action. Read-only — calls `staking.isAllowanceValid` with `raw: true` so no `walletProvider`
- * is required.
- */
-declare function useStakeAllowance<K extends SpokeChainKey = SpokeChainKey>({ params, queryOptions, }?: UseStakeAllowanceParams<K>): UseQueryResult<boolean, Error>;
-
-type UseUnstakeVars<K extends SpokeChainKey = SpokeChainKey> = Omit<UnstakeAction<K, false>, 'raw'>;
-/**
- * React hook for initiating an SODA unstake.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useUnstake<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseUnstakeVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseUnstakeVars<K>>;
-
-type UseClaimVars<K extends SpokeChainKey = SpokeChainKey> = Omit<ClaimAction<K, false>, 'raw'>;
-/**
- * React hook for claiming an unstaked SODA request that has reached the end of its waiting period.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useClaim<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseClaimVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseClaimVars<K>>;
-
-type UseCancelUnstakeVars<K extends SpokeChainKey = SpokeChainKey> = Omit<CancelUnstakeAction<K, false>, 'raw'>;
-/**
- * React hook for cancelling a pending unstake request.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useCancelUnstake<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseCancelUnstakeVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseCancelUnstakeVars<K>>;
-
-type UseStakingInfoParams = ReadHookParams<StakingInfo, {
-    srcAddress: `0x${string}` | undefined;
-    srcChainKey: SpokeChainKey | undefined;
-}>;
-/**
- * React hook to fetch the user's staking info (xSODA balance, share value, underlying SODA) by
- * deriving the hub wallet from the spoke `srcAddress` + `srcChainKey`. Throws on `!ok` so React
- * Query lands in `error` state.
- */
-declare function useStakingInfo({ params, queryOptions }?: UseStakingInfoParams): UseQueryResult<StakingInfo, Error>;
-
-type UnstakingInfoWithPenalty = UnstakingInfo & {
-    requestsWithPenalty: UnstakeRequestWithPenalty[];
-};
-type UseUnstakingInfoWithPenaltyParams = ReadHookParams<UnstakingInfoWithPenalty, {
-    srcAddress: `0x${string}` | undefined;
-    srcChainKey: SpokeChainKey | undefined;
-}>;
-/**
- * React hook to fetch the user's pending unstake requests **with computed early-exit penalties**
- * by deriving the hub wallet from the spoke `srcAddress` + `srcChainKey`. Throws on `!ok`.
- */
-declare function useUnstakingInfoWithPenalty({ params, queryOptions, }?: UseUnstakingInfoWithPenaltyParams): UseQueryResult<UnstakingInfoWithPenalty, Error>;
-
-type UseStakingConfigParams = ReadHookParams<StakingConfig>;
-/**
- * React hook to fetch the global staking config (unstaking period, min unstaking period, max
- * penalty). Hub-only read; no chain context required. Throws on `!ok`.
- */
-declare function useStakingConfig({ queryOptions, }?: UseStakingConfigParams): UseQueryResult<StakingConfig, Error>;
-
-type UseStakeRatioParams = ReadHookParams<[
-    bigint,
-    bigint
-], {
-    amount: bigint | undefined;
-}>;
-/**
- * React hook to estimate the SODA → xSODA stake ratio for a given amount. Hub-only read. Throws
- * on `!ok`.
- */
-declare function useStakeRatio({ params, queryOptions, }?: UseStakeRatioParams): UseQueryResult<[bigint, bigint], Error>;
-
-type UseInstantUnstakeRatioParams = ReadHookParams<bigint, {
-    amount: bigint | undefined;
-}>;
-/**
- * React hook to estimate the SODA amount received from instant-unstaking a given xSODA amount
- * (after slippage). Hub-only read. Throws on `!ok`.
- */
-declare function useInstantUnstakeRatio({ params, queryOptions, }?: UseInstantUnstakeRatioParams): UseQueryResult<bigint, Error>;
-
-type UseConvertedAssetsParams = ReadHookParams<bigint, {
-    amount: bigint | undefined;
-}>;
-/**
- * React hook to convert an xSODA share amount to its underlying SODA value via the vault's
- * exchange rate. Hub-only read. Throws on `!ok`.
- */
-declare function useConvertedAssets({ params, queryOptions, }?: UseConvertedAssetsParams): UseQueryResult<bigint, Error>;
-
-type UseInstantUnstakeVars<K extends SpokeChainKey = SpokeChainKey> = Omit<InstantUnstakeAction<K, false>, 'raw'>;
-/**
- * React hook for instant-unstaking SODA (bypassing the waiting period at a slippage cost).
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useInstantUnstake<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseInstantUnstakeVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseInstantUnstakeVars<K>>;
-
-type UseUnstakeAllowanceParams<K extends SpokeChainKey = SpokeChainKey> = ReadHookParams<boolean, {
-    payload: Omit<UnstakeParams<K>, 'action'> | undefined;
-}>;
-/**
- * React hook to check whether the user has approved sufficient xSODA spending for the unstake
- * action. Read-only — calls `staking.isAllowanceValid` with `raw: true` so no `walletProvider`
- * is required.
- */
-declare function useUnstakeAllowance<K extends SpokeChainKey = SpokeChainKey>({ params, queryOptions, }?: UseUnstakeAllowanceParams<K>): UseQueryResult<boolean, Error>;
-
-/**
- * Mutation variables for {@link useUnstakeApprove}. The `action` literal is injected by the hook.
- */
-type UseUnstakeApproveVars<K extends SpokeChainKey = SpokeChainKey> = {
-    params: Omit<UnstakeParams<K>, 'action'>;
-    walletProvider: GetWalletProviderType<K>;
-};
-/**
- * React hook for approving xSODA spending on the unstake action.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped tx return value on success.
- */
-declare function useUnstakeApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseUnstakeApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseUnstakeApproveVars<K>>;
-
-type UseUnstakingInfoParams = ReadHookParams<UnstakingInfo, {
-    srcAddress: `0x${string}` | undefined;
-    srcChainKey: SpokeChainKey | undefined;
-}>;
-/**
- * React hook to fetch the user's pending unstake requests by deriving the hub wallet from the
- * spoke `srcAddress` + `srcChainKey`. Throws on `!ok`.
- */
-declare function useUnstakingInfo({ params, queryOptions, }?: UseUnstakingInfoParams): UseQueryResult<UnstakingInfo, Error>;
-
-/**
- * Mutation variables for {@link useInstantUnstakeApprove}. The `action` literal is injected by
- * the hook.
- */
-type UseInstantUnstakeApproveVars<K extends SpokeChainKey = SpokeChainKey> = {
-    params: Omit<InstantUnstakeParams<K>, 'action'>;
-    walletProvider: GetWalletProviderType<K>;
-};
-/**
- * React hook for approving xSODA spending on the instant-unstake action.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped tx return value on success.
- */
-declare function useInstantUnstakeApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseInstantUnstakeApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseInstantUnstakeApproveVars<K>>;
-
-type UseInstantUnstakeAllowanceParams<K extends SpokeChainKey = SpokeChainKey> = ReadHookParams<boolean, {
-    payload: Omit<InstantUnstakeParams<K>, 'action'> | undefined;
-}>;
-/**
- * React hook to check whether the user has approved sufficient xSODA spending for the
- * instant-unstake action. Read-only — calls `staking.isAllowanceValid` with `raw: true` so no
- * `walletProvider` is required.
- */
-declare function useInstantUnstakeAllowance<K extends SpokeChainKey = SpokeChainKey>({ params, queryOptions, }?: UseInstantUnstakeAllowanceParams<K>): UseQueryResult<boolean, Error>;
-
-type UseFetchAssetsBalancesParams = ReadHookParams<Map<string, PartnerFeeClaimAssetBalance>, {
-    queryAddress: string | undefined;
-}>;
-/**
- * React hook to fetch hub-asset balances on Sonic for a given EVM address. Disabled when
- * `queryAddress` is missing. Throws on `!ok`.
- */
-declare function useFetchAssetsBalances({ params, queryOptions, }?: UseFetchAssetsBalancesParams): UseQueryResult<Map<string, PartnerFeeClaimAssetBalance>, Error>;
-
-type UseGetAutoSwapPreferencesParams = ReadHookParams<AutoSwapPreferences, {
-    queryAddress: string | undefined;
-}>;
-/**
- * React hook to fetch the auto-swap preferences (output token, destination chain, destination
- * address) for a given EVM address. Disabled when `queryAddress` is missing. Throws on `!ok`.
- */
-declare function useGetAutoSwapPreferences({ params, queryOptions, }?: UseGetAutoSwapPreferencesParams): UseQueryResult<AutoSwapPreferences, Error>;
-
-type UseIsTokenApprovedParams = ReadHookParams<boolean, {
-    payload: FeeTokenApproveParams | undefined;
-}>;
-/**
- * React hook to check whether a token is approved to the protocol-intents contract on Sonic for
- * a given owner. Read-only; throws on `!ok`.
- */
-declare function useIsTokenApproved({ params, queryOptions, }?: UseIsTokenApprovedParams): UseQueryResult<boolean, Error>;
-
-type UseApproveTokenVars = Omit<FeeTokenApproveAction<HubChainKey, false>, 'raw'>;
-type ApproveTokenData = TxReturnType<HubChainKey, false>;
-/**
- * React hook to approve a token to the protocol-intents contract on Sonic with max allowance.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped tx return value on success.
- */
-declare function useApproveToken({ mutationOptions, }?: MutationHookParams<ApproveTokenData, UseApproveTokenVars>): SafeUseMutationResult<ApproveTokenData, Error, UseApproveTokenVars>;
-
-/**
- * Mutation variables for {@link useSetSwapPreference}. Generic over `K extends SpokeChainKey`
- * for compatibility with the SDK signature; at runtime the SDK enforces hub-only
- * (`isHubChainKeyType(srcChainKey)`).
- */
-type UseSetSwapPreferenceVars<K extends SpokeChainKey = SpokeChainKey> = Omit<SetSwapPreferenceAction<K, false>, 'raw'>;
-/**
- * React hook to set the partner's auto-swap preferences (output token + destination chain +
- * destination address) on the protocol-intents contract.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped tx return value on success.
- */
-declare function useSetSwapPreference<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseSetSwapPreferenceVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseSetSwapPreferenceVars<K>>;
-type UseSetSwapPreferenceVarsHub = UseSetSwapPreferenceVars<HubChainKey>;
-
-type UseFeeClaimSwapVars = Omit<PartnerFeeClaimSwapAction<HubChainKey, false>, 'raw'>;
-/**
- * React hook to create a partner-fee auto-swap intent and wait for the solver execution.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `IntentAutoSwapResult` on success.
- */
-declare function useFeeClaimSwap({ mutationOptions, }?: MutationHookParams<IntentAutoSwapResult, UseFeeClaimSwapVars>): SafeUseMutationResult<IntentAutoSwapResult, Error, UseFeeClaimSwapVars>;
-
-type UseHubAssetBalancesParams = ReadHookParams<HubAssetBalance[], {
-    chainKey: SpokeChainKey | undefined;
-    /** The user's address on the spoke chain. The SDK derives the hub wallet abstraction internally. */
-    srcAddress: string | undefined;
-}>;
-/**
- * React hook to fetch the hub-side balances of every supported token on the given spoke chain
- * for the user's hub wallet (derived internally from `srcAddress` + `chainKey`). Disabled when
- * either input is missing. Throws on `!ok`.
- */
-declare function useHubAssetBalances({ params, queryOptions, }?: UseHubAssetBalancesParams): UseQueryResult<HubAssetBalance[], Error>;
-
-/**
- * Mutation variables for {@link useWithdrawHubAsset}. Generic over `K extends SpokeChainKey`
- * (defaults to the full union). Sophisticated callers can lock K at the hook call site to narrow
- * the `walletProvider` and `params.srcChainKey` types.
- */
-type UseWithdrawHubAssetVars<K extends SpokeChainKey = SpokeChainKey> = Omit<WithdrawHubAssetAction<K, false>, 'raw'>;
-/**
- * React hook for withdrawing a hub-side asset back to the user's spoke chain wallet.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped tx return value on success.
- */
-declare function useWithdrawHubAsset<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseWithdrawHubAssetVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseWithdrawHubAssetVars<K>>;
-
-/**
- * Mutation variables for {@link useMigrateIcxToSoda}. Wraps `IcxMigrateAction<false>` with `raw`
- * stripped — the hook always submits non-raw and unwraps the SDK Result.
- */
-type UseMigrateIcxToSodaVars = Omit<IcxMigrateAction<false>, 'raw'>;
-/**
- * React hook for migrating ICX/wICX → SODA on the Sonic hub. Forward-only direction; for the
- * reverse (SODA → ICX) use {@link useRevertMigrateSodaToIcx}.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useMigrateIcxToSoda({ mutationOptions, }?: MutationHookParams<TxHashPair, UseMigrateIcxToSodaVars>): SafeUseMutationResult<TxHashPair, Error, UseMigrateIcxToSodaVars>;
-
-type UseRevertMigrateSodaToIcxVars = Omit<IcxRevertMigrationAction<false>, 'raw'>;
-/**
- * React hook for reverting SODA → ICX (the inverse of {@link useMigrateIcxToSoda}).
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useRevertMigrateSodaToIcx({ mutationOptions, }?: MutationHookParams<TxHashPair, UseRevertMigrateSodaToIcxVars>): SafeUseMutationResult<TxHashPair, Error, UseRevertMigrateSodaToIcxVars>;
-
-/**
- * Mutation variables for {@link useMigratebnUSD}. Generic over `K extends SpokeChainKey` (defaults
- * to the full union). Bidirectional — handles both legacy → new and new → legacy bnUSD migration
- * via the same SDK call; the SDK detects direction from the token addresses.
- */
-type UseMigratebnUSDVars<K extends SpokeChainKey = SpokeChainKey> = Omit<UnifiedBnUSDMigrateAction<K, false>, 'raw'>;
-/**
- * React hook for migrating bnUSD between legacy and new formats across spoke chains via Sonic.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useMigratebnUSD<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseMigratebnUSDVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseMigratebnUSDVars<K>>;
-
-type UseMigrateBalnVars = Omit<BalnMigrateAction<false>, 'raw'>;
-/**
- * React hook for migrating BALN → SODA on the Sonic hub. Source chain is always Icon. Supports
- * lockup periods (0–24 months) which multiply the SODA reward (0.5x–1.5x).
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useMigrateBaln({ mutationOptions, }?: MutationHookParams<TxHashPair, UseMigrateBalnVars>): SafeUseMutationResult<TxHashPair, Error, UseMigrateBalnVars>;
-
-/**
- * Mutation variables for {@link useMigrationApprove}. The SDK's `approve` accepts a union of
- * action wrappers (Icx-revert OR bnUSD bidirectional) plus a separate `'migrate' | 'revert'`
- * discriminator. Both ride along in `TVars` here so the hook stays a pure pass-through.
- */
-type UseMigrationApproveVars<K extends SpokeChainKey = SpokeChainKey> = (Omit<IcxRevertMigrationAction<false>, 'raw'> | Omit<UnifiedBnUSDMigrateAction<K, false>, 'raw'>) & {
-    action: MigrationAction;
-};
-/**
- * React hook for approving token spending on a migration intent. Required before:
- * - SODA → ICX revert (consumes SODA on Sonic via the user's hub router)
- * - bnUSD migrations on EVM/Stellar source chains (consumes the source bnUSD via asset manager)
- *
- * NOT required for ICX → SODA forward migrations or BALN migrations (both originate on Icon
- * which doesn't use ERC-20 allowances).
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped tx return value on success.
- */
-declare function useMigrationApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseMigrationApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseMigrationApproveVars<K>>;
-
-/**
- * Domain inputs for {@link useMigrationAllowance}. `params` is the underlying migration params
- * (NOT the action wrapper — no `walletProvider`/`raw`); `action` is the `'migrate' | 'revert'`
- * discriminator the SDK uses to pick the right allowance check path.
- *
- * For ICX forward migration (`migrate`, params={IcxMigrateParams}) and BALN migration the SDK
- * always returns `true` (Icon has no ERC-20-style allowance) — but the hook still works there
- * for code-uniformity at the call site.
- */
-type UseMigrationAllowanceInputs<K extends SpokeChainKey = SpokeChainKey> = {
-    params: IcxMigrateParams | IcxCreateRevertMigrationParams | UnifiedBnUSDMigrateParams<K> | BalnMigrateParams | undefined;
-    action: MigrationAction | undefined;
-};
-type UseMigrationAllowanceParams<K extends SpokeChainKey = SpokeChainKey> = ReadHookParams<boolean, UseMigrationAllowanceInputs<K>>;
-/**
- * React hook to check if migration spending is approved.
- *
- * Returns `false` when params are missing (so the call site can disable the action button).
- * Hook lifecycle (`enabled`, `queryKey`, `queryFn`) is owned internally; consumers can override
- * other React Query knobs via `queryOptions`.
- */
-declare function useMigrationAllowance<K extends SpokeChainKey = SpokeChainKey>({ params, queryOptions, }?: UseMigrationAllowanceParams<K>): UseQueryResult<boolean, Error>;
-
-type UsePoolsParams = ReadHookParams<PoolKey[]>;
-/**
- * Loads the list of concentrated-liquidity pools known to the SDK config. The SDK's `getPools()`
- * is synchronous in v2 (no network), so this hook caches indefinitely by default.
- */
-declare function usePools({ queryOptions }?: UsePoolsParams): UseQueryResult<PoolKey[], Error>;
-
-type UsePoolDataParams = ReadHookParams<PoolData, {
-    poolKey: PoolKey | null;
-}>;
-/**
- * React hook to fetch on-chain pool data (sqrt price, tick, fees, token info, etc.) for a given
- * pool key. Reads via the hub `publicClient`. Disabled when `poolKey` is null.
- */
-declare function usePoolData({ params, queryOptions }?: UsePoolDataParams): UseQueryResult<PoolData, Error>;
-
-type UsePoolBalancesResponse = {
-    token0Balance: bigint;
-    token1Balance: bigint;
-};
-type UsePoolBalancesParams = ReadHookParams<UsePoolBalancesResponse, {
-    poolData: PoolData | null;
-    poolKey: PoolKey | null;
-    spokeChainKey: SpokeChainKey | undefined;
-    userAddress: string | undefined;
-}>;
-/**
- * React hook to query the user's hub-side deposit balances for both pool tokens. Derives the hub
- * wallet once and reads both pool-token balances in parallel via the hub `publicClient`.
- */
-declare function usePoolBalances({ params, queryOptions, }?: UsePoolBalancesParams): UseQueryResult<UsePoolBalancesResponse, Error>;
-
-type UsePositionInfoResponse = {
-    positionInfo: ClPositionInfo;
-    isValid: boolean;
-};
-type UsePositionInfoParams = ReadHookParams<UsePositionInfoResponse, {
-    tokenId: string | null;
-    poolKey: PoolKey | null;
-}>;
-/**
- * React hook to fetch a CL position by NFT token id and validate it against an expected pool key.
- * Reads via the hub `publicClient`. Disabled when `tokenId` or `poolKey` is missing.
- */
-declare function usePositionInfo({ params, queryOptions, }?: UsePositionInfoParams): UseQueryResult<UsePositionInfoResponse, Error>;
-
-/**
- * Mutation variables for {@link useDexDeposit}. Generic over `K extends SpokeChainKey` (defaults
- * to the full union). Sophisticated callers can lock K at the hook call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseDexDepositVars<K extends SpokeChainKey = SpokeChainKey> = Omit<AssetDepositAction<K, false>, 'raw'>;
-/**
- * React hook for depositing an asset into a DEX pool.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- *
- * @example
- * ```tsx
- * const walletProvider = useWalletProvider({ xChainId: chainKey });
- * const { mutateAsync: deposit } = useDexDeposit();
- * try {
- *   const { spokeTxHash, hubTxHash } = await deposit({ params, walletProvider });
- * } catch (e) {
- *   // surfaced via mutation.error / onError
- * }
- * ```
- */
-declare function useDexDeposit<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseDexDepositVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseDexDepositVars<K>>;
-
-/**
- * Mutation variables for {@link useDexWithdraw}. Generic over `K extends SpokeChainKey` (defaults
- * to the full union). Sophisticated callers can lock K at the hook call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseDexWithdrawVars<K extends SpokeChainKey = SpokeChainKey> = Omit<AssetWithdrawAction<K, false>, 'raw'>;
-/**
- * React hook for withdrawing an asset from a DEX pool.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useDexWithdraw<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseDexWithdrawVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseDexWithdrawVars<K>>;
-
-type UseDexAllowanceParams<K extends SpokeChainKey = SpokeChainKey> = ReadHookParams<boolean, {
-    payload: CreateAssetDepositParams<K> | undefined;
-}>;
-/**
- * React hook to check whether the user has approved sufficient token allowance (or established a
- * trustline, on Stellar) for a DEX deposit. Read-only — calls `assetService.isAllowanceValid`
- * with `raw: true` so no `walletProvider` is required.
- */
-declare function useDexAllowance<K extends SpokeChainKey = SpokeChainKey>({ params, queryOptions, }?: UseDexAllowanceParams<K>): UseQueryResult<boolean, Error>;
-
-/**
- * Mutation variables for {@link useDexApprove}. Generic over `K extends SpokeChainKey` (defaults
- * to the full union). Sophisticated callers can lock K at the hook call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseDexApproveVars<K extends SpokeChainKey = SpokeChainKey> = Omit<AssetDepositAction<K, false>, 'raw'>;
-/**
- * React hook for approving ERC-20 token spending (or trustline establishment) for a DEX deposit.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped tx return value on success.
- */
-declare function useDexApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseDexApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseDexApproveVars<K>>;
-
-type 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 concentrated-liquidity amounts based on the price range. Pure state +
- * math; no SDK calls beyond the static {@link ClService} helpers.
- */
-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;
-};
-/**
- * Subset of {@link ClSupplyParams} / {@link ClIncreaseLiquidityParams} produced by
- * {@link useCreateSupplyLiquidityParams}. Callers add `srcChainKey` + `srcAddress` at the mutation
- * call site. `tokenId` and `isValidPosition` distinguish the mint-new vs increase-existing path.
- */
-type UseCreateSupplyLiquidityParamsResult = Omit<ClSupplyParams<SpokeChainKey>, 'srcChainKey' | 'srcAddress'> & Omit<ClIncreaseLiquidityParams<SpokeChainKey>, 'srcChainKey' | 'srcAddress' | 'tokenId'> & {
-    tokenId?: string | bigint;
-    positionId?: string | null;
-    isValidPosition?: boolean;
-};
-/**
- * React hook to memoize concentrated-liquidity supply parameters for a given pool. Returns the
- * pool/tick/liquidity/amount fields without `srcChainKey`/`srcAddress` — callers add those at the
- * mutation call site.
- */
-declare function useCreateSupplyLiquidityParams({ poolData, poolKey, minPrice, maxPrice, liquidityToken0Amount, liquidityToken1Amount, slippageTolerance, positionId, isValidPosition, }: UseCreateSupplyLiquidityParamsProps): UseCreateSupplyLiquidityParamsResult;
-
-/**
- * Mutation variables for {@link useSupplyLiquidity}. Generic over `K extends SpokeChainKey`
- * (defaults to the full union). The hook fans out internally to either
- * `clService.increaseLiquidity` (when `params.tokenId` + `params.isValidPosition` are present) or
- * `clService.supplyLiquidity` (mint a new position).
- */
-type UseSupplyLiquidityVars<K extends SpokeChainKey = SpokeChainKey> = {
-    params: UseCreateSupplyLiquidityParamsResult & {
-        srcChainKey: K;
-        srcAddress: string;
-    };
-    walletProvider: GetWalletProviderType<K>;
-    /** Optional relay timeout in ms (default 60_000) */
-    timeout?: number;
-};
-/**
- * React hook for supplying liquidity to a concentrated-liquidity pool. If the input vars include a
- * valid `tokenId` for an existing position, the hook calls `increaseLiquidity`; otherwise it mints
- * a new position via `supplyLiquidity`.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useSupplyLiquidity<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseSupplyLiquidityVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseSupplyLiquidityVars<K>>;
-
-/**
- * Mutation variables for {@link useDecreaseLiquidity}. Generic over `K extends SpokeChainKey`
- * (defaults to the full union). Sophisticated callers can lock K at the hook call site to narrow
- * the `walletProvider` and `params.srcChainKey` types.
- */
-type UseDecreaseLiquidityVars<K extends SpokeChainKey = SpokeChainKey> = Omit<ClLiquidityDecreaseLiquidityAction<K, false>, 'raw'>;
-/**
- * React hook for decreasing liquidity in an existing concentrated-liquidity position.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useDecreaseLiquidity<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseDecreaseLiquidityVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseDecreaseLiquidityVars<K>>;
-
-/**
- * Subset of {@link CreateAssetDepositParams} produced by {@link createDepositParamsProps}.
- * Callers add `srcChainKey` + `srcAddress` at the mutation call site.
- */
-type DepositParamsCore = Omit<CreateAssetDepositParams<SpokeChainKey>, 'srcChainKey' | 'srcAddress'>;
-/**
- * Subset of {@link CreateAssetWithdrawParams} produced by {@link createWithdrawParamsProps}.
- * Callers add `srcChainKey` + `srcAddress` at the mutation call site.
- */
-type WithdrawParamsCore = Omit<CreateAssetWithdrawParams<SpokeChainKey>, 'srcChainKey' | 'srcAddress'>;
-/**
- * Subset of {@link ClDecreaseLiquidityParams} produced by {@link createDecreaseLiquidityParamsProps}.
- * Callers add `srcChainKey` + `srcAddress` at the mutation call site.
- */
-type DecreaseLiquidityParamsCore = Omit<ClDecreaseLiquidityParams<SpokeChainKey>, 'srcChainKey' | 'srcAddress'>;
-declare function createDecreaseLiquidityParamsProps({ poolKey, tokenId, percentage, positionInfo, slippageTolerance, }: UseCreateDecreaseLiquidityParamsProps): DecreaseLiquidityParamsCore;
-declare function createDepositParamsProps({ tokenIndex, amount, poolData, poolSpokeAssets, }: UseCreateDepositParamsProps): DepositParamsCore;
-declare function createSupplyLiquidityParamsProps({ poolData, poolKey, minPrice, maxPrice, liquidityToken0Amount, liquidityToken1Amount, slippageTolerance, positionId, isValidPosition, }: UseCreateSupplyLiquidityParamsProps): UseCreateSupplyLiquidityParamsResult;
-declare function createWithdrawParamsProps({ tokenIndex, amount, poolData, poolSpokeAssets, dst, }: UseCreateWithdrawParamsProps): WithdrawParamsCore;
-
-type UseCreateDepositParamsProps = {
-    tokenIndex: 0 | 1;
-    amount: string | number;
-    poolData: PoolData;
-    poolSpokeAssets: PoolSpokeAssets;
-};
-/**
- * React hook to memoize the deposit-specific subset of {@link CreateAssetDepositParams}
- * (`{ asset, amount, poolToken, dst? }`). Callers add `srcChainKey` + `srcAddress` at the mutation
- * call site.
- */
-declare function useCreateDepositParams({ tokenIndex, amount, poolData, poolSpokeAssets, }: UseCreateDepositParamsProps): DepositParamsCore | undefined;
-
-type UseCreateDecreaseLiquidityParamsProps = {
-    poolKey: PoolKey;
-    tokenId: string | bigint;
-    percentage: string | number;
-    positionInfo: ClPositionInfo;
-    slippageTolerance: string | number;
-};
-/**
- * React hook to memoize the decrease-liquidity-specific subset of {@link ClDecreaseLiquidityParams}
- * (`{ poolKey, tokenId, liquidity, amount0Min, amount1Min }`). Callers add `srcChainKey` +
- * `srcAddress` at the mutation call site.
- */
-declare function useCreateDecreaseLiquidityParams({ poolKey, tokenId, percentage, positionInfo, slippageTolerance, }: UseCreateDecreaseLiquidityParamsProps): DecreaseLiquidityParamsCore;
-
-type UseCreateWithdrawParamsProps = {
-    tokenIndex: 0 | 1;
-    amount: string | number;
-    poolData: PoolData;
-    poolSpokeAssets: PoolSpokeAssets;
-    dst?: DestinationParamsType;
-};
-/**
- * React hook to memoize the withdraw-specific subset of {@link CreateAssetWithdrawParams}
- * (`{ asset, amount, poolToken, dst? }`). Callers add `srcChainKey` + `srcAddress` at the mutation
- * call site.
- */
-declare function useCreateWithdrawParams({ tokenIndex, amount, poolData, poolSpokeAssets, dst, }: UseCreateWithdrawParamsProps): WithdrawParamsCore | undefined;
-
-/**
- * Mutation variables for {@link useClaimRewards}. Generic over `K extends SpokeChainKey` (defaults
- * to the full union). Sophisticated callers can lock K at the hook call site to narrow the
- * `walletProvider` and `params.srcChainKey` types.
- */
-type UseClaimRewardsVars<K extends SpokeChainKey = SpokeChainKey> = Omit<ClLiquidityClaimRewardsAction<K, false>, 'raw'>;
-/**
- * React hook for claiming accrued fees on a concentrated-liquidity position.
- *
- * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
- * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
- */
-declare function useClaimRewards<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseClaimRewardsVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseClaimRewardsVars<K>>;
-
-interface SodaxProviderProps {
-    children: ReactNode;
-    /**
-     * Sodax SDK config. Tracked by **reference** - a new identity re-instantiates the
-     * SDK. Hoist to a module constant or wrap in `useMemo`; include any value the SDK
-     * should react to (e.g. solver env) in the deps. Inline `{...}` re-creates the SDK
-     * every parent render and resets every `useSodaxContext` consumer.
-     *
-     * @example
-     * ```tsx
-     * const config = useMemo(() => ({ solver: solverMap[env] }), [env]);
-     * <SodaxProvider config={config}>...</SodaxProvider>
-     * ```
-     */
-    config?: DeepPartial<SodaxConfig>;
-}
-/** Root provider for `@sodax/dapp-kit`. Must be paired with `QueryClientProvider`. */
-declare const SodaxProvider: ({ children, config }: SodaxProviderProps) => ReactElement;
-
-type CreateSodaxQueryClientOptions = {
-    /**
-     * Called for every mutation failure (i.e. every time `mutationFn` throws) that does NOT opt out
-     * via `meta: { silent: true }` on the mutation. Defaults to `console.error`.
-     *
-     * This is **global observability** — it runs alongside any per-hook `onError` handler the
-     * consumer set, NOT instead of them. In particular, it fires:
-     * - whether or not `mutateAsync` was awaited inside `try/catch`
-     * - whether or not `mutateAsyncSafe` was used (the wrapper packs into `Result<T>` AFTER React
-     *   Query has already entered the error state and dispatched its callbacks)
-     * - whether or not the consumer's `mutationOptions.onError` already toasted/logged
-     *
-     * It is NOT a "did this rejection escape to the global handler?" detector — accurate
-     * unhandled-rejection detection lives at `window.onunhandledrejection`, not here.
-     *
-     * To silence the default for a specific mutation that the consumer is handling locally, set
-     * `meta: { silent: true }`:
-     *
-     * ```ts
-     * useSwap({ mutationOptions: { meta: { silent: true }, onError: (e) => toast(e.message) } });
-     * ```
-     *
-     * To disable the default globally (e.g. wire your own error boundary), pass a no-op:
-     *
-     * ```ts
-     * createSodaxQueryClient({ onMutationError: () => {} });
-     * ```
-     */
-    onMutationError?: (error: unknown) => void;
-    /** Pass-through for any other QueryClient config (default queries options, etc.) */
-    config?: QueryClientConfig;
-};
-/**
- * Creates a `QueryClient` pre-wired with a mutation-error observability hook that gives dapp-kit
- * consumers a single seam for every mutation failure across the app — wire to Sentry/Datadog/console
- * as you like. Optional opt-in: consumers who construct their own `QueryClient` are unaffected.
- *
- * **Composition with a custom `MutationCache`.** If you pass `config.mutationCache`, we keep your
- * cache instance (preserving its own `onError` / `onSuccess` / etc.) and *additionally* subscribe
- * to its event stream to dispatch `onMutationError`. Both your handler and the dapp-kit handler
- * fire — neither replaces the other. If you don't pass one, we install our own.
- *
- * @example default — logs to console
- * const queryClient = createSodaxQueryClient();
- *
- * @example custom — Sentry
- * const queryClient = createSodaxQueryClient({
- *   onMutationError: (e) => Sentry.captureException(e),
- * });
- *
- * @example silent — disable the default
- * const queryClient = createSodaxQueryClient({ onMutationError: () => {} });
- *
- * @example bring-your-own MutationCache
- * const myCache = new MutationCache({ onError: myOwnErrorHandler });
- * const queryClient = createSodaxQueryClient({ config: { mutationCache: myCache } });
- * // myOwnErrorHandler still runs; onMutationError ALSO runs (unless meta.silent).
- */
-declare function createSodaxQueryClient({ onMutationError, config, }?: CreateSodaxQueryClientOptions): QueryClient;
-
-export { type ATokenData, type BackendPaginationParams, type CreateSodaxQueryClientOptions, type DecreaseLiquidityParamsCore, type DepositParamsCore, type MutationHookOptions, type MutationHookParams, type RadfiSession, type ReadHookParams, type ReadQueryOptions, type ReserveUsdFormat, type SafeUseMutationResult, SodaxProvider, type UseATokenParams, type UseATokensBalancesParams, type UseApproveTokenVars, type UseBitcoinBalanceParams, type UseBorrowVars, type UseBridgeAllowanceParams, type UseBridgeApproveVars, type UseBridgeVars, type UseClaimRewardsVars, type UseCreateDecreaseLiquidityParamsProps, type UseCreateDepositParamsProps, type UseCreateLimitOrderVars, type UseCreateSupplyLiquidityParamsProps, type UseCreateSupplyLiquidityParamsResult, type UseCreateWithdrawParamsProps, type UseDecreaseLiquidityVars, type UseDeriveUserWalletAddressParams, type UseDexAllowanceParams, type UseDexApproveVars, type UseDexDepositVars, type UseDexWithdrawVars, type UseExpiredUtxosParams, type UseFeeClaimSwapVars, type UseFetchAssetsBalancesParams, type UseFundTradingWalletVars, type UseGetAutoSwapPreferencesParams, type UseGetBridgeableAmountParams, type UseGetBridgeableTokensParams, type UseGetUserHubWalletAddressParams, type UseHubAssetBalancesParams, type UseIsTokenApprovedParams, type UseLiquidityAmountsResult, type UseMMAllowanceParams, type UseMMApproveVars, type UseMigrateBalnVars, type UseMigrateIcxToSodaVars, type UseMigratebnUSDVars, type UseMigrationAllowanceInputs, type UseMigrationAllowanceParams, type UseMigrationApproveVars, type UsePoolBalancesParams, type UsePoolBalancesResponse, type UsePoolDataParams, type UsePoolsParams, type UsePositionInfoParams, type UsePositionInfoResponse, type UseQuoteParams, type UseRadfiAuthVars, type UseRadfiSessionReturn, type UseRadfiWithdrawVars, type UseRenewUtxosVars, type UseRepayVars, type UseReservesDataParams, type UseReservesHumanizedParams, type UseReservesListParams, type UseReservesUsdFormatParams, type UseRevertMigrateSodaToIcxVars, type UseSetSwapPreferenceVars, type UseSetSwapPreferenceVarsHub, type UseStatusParams, type UseStellarTrustlineCheckParams, type UseSupplyLiquidityVars, type UseSupplyVars, type UseSwapAllowanceParams, type UseSwapApproveVars, type UseSwapVars, type UseTradingWalletBalanceParams, type UseUserFormattedSummaryParams, type UseUserReservesDataParams, type UseWithdrawHubAssetVars, type UseWithdrawVars, type UseXBalancesParams, type WithdrawParamsCore, type XBalancesInputs, clearRadfiSession, createDecreaseLiquidityParamsProps, createDepositParamsProps, createSodaxQueryClient, createSupplyLiquidityParamsProps, createWithdrawParamsProps, getXBalancesQueryOptions, loadRadfiSession, saveRadfiSession, toResult, unwrapResult, useAToken, useATokensBalances, useApproveToken, 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, useFeeClaimSwap, useFetchAssetsBalances, useFundTradingWallet, useGetAutoSwapPreferences, useGetBridgeableAmount, useGetBridgeableTokens, useGetUserHubWalletAddress, useHubAssetBalances, useHubProvider, useInstantUnstake, useInstantUnstakeAllowance, useInstantUnstakeApprove, useInstantUnstakeRatio, useIsTokenApproved, useLiquidityAmounts, useMMAllowance, useMMApprove, useMigrateBaln, useMigrateIcxToSoda, useMigratebnUSD, useMigrationAllowance, useMigrationApprove, usePoolBalances, usePoolData, usePools, usePositionInfo, useQuote, useRadfiAuth, useRadfiSession, useRadfiWithdraw, useRenewUtxos, useRepay, useRequestTrustline, useReservesData, useReservesHumanized, useReservesList, useReservesUsdFormat, useRevertMigrateSodaToIcx, useSafeMutation, useSetSwapPreference, useSodaxContext, useStake, useStakeAllowance, useStakeApprove, useStakeRatio, useStakingConfig, useStakingInfo, useStatus, useStellarTrustlineCheck, useSupply, useSupplyLiquidity, useSwap, useSwapAllowance, useSwapApprove, useTradingWallet, useTradingWalletBalance, useUnstake, useUnstakeAllowance, useUnstakeApprove, useUnstakingInfo, useUnstakingInfoWithPenalty, useUserFormattedSummary, useUserReservesData, useWithdraw, useWithdrawHubAsset, useXBalances };