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

package/dist/index.d.ts

@@ -1,137 +1,160 @@
-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 { 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';
 
-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
+ * 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.
  */
-declare const useSodaxContext: () => SodaxContextType;
-
-declare function useEstimateGas<T extends SpokeProvider = SpokeProvider>(spokeProvider: T | undefined): UseMutationResult<GetEstimateGasReturnType<T>, Error, TxReturnType<T, true>>;
-
+type ReadQueryOptions<TData, TError = Error> = Omit<UseQueryOptions<TData, TError>, 'queryKey' | 'queryFn' | 'enabled'>;
 /**
- * Hook for deriving user wallet address for hub abstraction.
+ * Canonical params shape for read-only `useQuery`-backed hooks in dapp-kit.
  *
- * 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.
+ * Two top-level keys, always:
+ * - `params`: SDK-feature-domain inputs (the "what" being fetched)
+ * - `queryOptions`: React Query behavior knobs (the "how" the query behaves)
  *
- * 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.
+ * 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.
  *
- * @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)
+ * `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.
  *
- * @example
- * ```typescript
- * const { data: derivedAddress, isLoading, error } = useDeriveUserWalletAddress(spokeChainId, userAddress);
+ * Conventions enforced by every dapp-kit mutation hook:
  *
- * if (isLoading) return <div>Deriving address...</div>;
- * if (error) return <div>Error: {error.message}</div>;
- * if (derivedAddress) return <div>Derived Address: {derivedAddress}</div>;
- * ```
+ * 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.
  */
-declare function useDeriveUserWalletAddress(spokeChainId?: SpokeChainId | SpokeProvider | undefined, spokeAddress?: string | undefined): UseQueryResult<Address, Error>;
-
+type MutationHookOptions<TData, TVars, TError = Error, TContext = unknown> = Omit<UseMutationOptions<TData, TError, TVars, TContext>, 'mutationFn'>;
 /**
- * React hook to check if a Stellar account has a sufficient trustline for a given token and amount.
+ * Canonical params shape for `useMutation`-backed hooks in dapp-kit.
  *
- * 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.
+ * One top-level key:
+ * - `mutationOptions`: React Query behavior knobs (the "how" the mutation behaves)
  *
- * @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.
+ * 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.
  *
- * @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>;
- * ```
+ * Always accept the whole params object as optional at the call site:
+ * `useFoo({ mutationOptions } = {})`.
  */
-declare function useStellarTrustlineCheck<T extends SpokeProvider = SpokeProvider>(token: string | undefined, amount: bigint | undefined, spokeProvider: T | undefined, chainId: SpokeChainId | undefined): UseQueryResult<boolean, Error>;
+type MutationHookParams<TData, TVars, TError = Error, TContext = unknown> = {
+    mutationOptions?: MutationHookOptions<TData, TVars, TError, TContext>;
+};
 
 /**
- * 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.
+ * 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.
  *
- * @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,
- * });
+ * 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`.
  *
- * 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>;
- * ```
+ * 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 useRequestTrustline<T extends SpokeProvider = SpokeProvider>(token: string | undefined): {
+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;
-        spokeProvider: T;
-    }) => Promise<TxReturnType<StellarSpokeProvider, false>>;
+        srcChainKey: StellarChainKey;
+        walletProvider: IStellarWalletProvider;
+    }) => Promise<string>;
     isLoading: boolean;
     isRequested: boolean;
     error: Error | null;
-    data: TxReturnType<StellarSpokeProvider, false> | null;
+    data: string | null;
 };
 
+type UseGetUserHubWalletAddressParams = ReadHookParams<Address, {
+    spokeChainId?: SpokeChainKey;
+    spokeAddress?: string;
+}>;
 /**
  * Hook for deriving user wallet address for hub abstraction.
  *
@@ -143,41 +166,49 @@ declare function useRequestTrustline<T extends SpokeProvider = SpokeProvider>(to
  * 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>;
+ * const { data: derivedAddress, isLoading, error } = useGetUserHubWalletAddress({
+ *   params: { spokeChainId, spokeAddress: userAddress },
+ * });
  * ```
  */
-declare function useGetUserHubWalletAddress(spokeChainId?: SpokeChainId | SpokeProvider | undefined, spokeAddress?: string | undefined): UseQueryResult<Address, Error>;
-
-declare function useHubProvider(): EvmHubProvider;
+declare function useGetUserHubWalletAddress({ params, queryOptions, }?: UseGetUserHubWalletAddressParams): UseQueryResult<Address, Error>;
 
 /**
- * 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
+ * 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
- * // Using a specific SpokeChainId and wallet provider
- * const spokeProvider = useSpokeProvider(spokeChainId, walletProvider);
+ * const xService = useXService({ xChainType: getXChainType(xChainId) });
+ * const { data: balances } = useXBalances({ params: { xService, xChainId, xTokens, address } });
  * ```
  */
-declare function useSpokeProvider(spokeChainId: SpokeChainId$1 | undefined, walletProvider?: IWalletProvider | undefined): SpokeProvider | undefined;
+declare function useXBalances({ params, queryOptions, }?: UseXBalancesParams): UseQueryResult<Record<string, bigint>>;
+
+declare function useHubProvider(): EvmHubProvider;
 
 type RadfiSession = {
     accessToken: string;
@@ -185,6 +216,9 @@ type RadfiSession = {
     tradingAddress: string;
     publicKey: string;
 };
+type UseRadfiAuthVars = {
+    walletProvider: IBitcoinWalletProvider;
+};
 type RadfiAuthResult = {
     accessToken: string;
     refreshToken: string;
@@ -194,10 +228,11 @@ 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.
+ * 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(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<RadfiAuthResult, Error, void>;
+declare function useRadfiAuth({ mutationOptions, }?: MutationHookParams<RadfiAuthResult, UseRadfiAuthVars>): SafeUseMutationResult<RadfiAuthResult, Error, UseRadfiAuthVars>;
 
 type UseRadfiSessionReturn = {
     walletAddress: string | undefined;
@@ -206,33 +241,23 @@ type UseRadfiSessionReturn = {
     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;
+declare function useRadfiSession(walletProvider: IBitcoinWalletProvider | undefined): UseRadfiSessionReturn;
 
+type UseFundTradingWalletVars = {
+    amount: bigint;
+    walletProvider: IBitcoinWalletProvider;
+};
 /**
- * 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);
- * };
- * ```
+ * 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(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<string, Error, bigint>;
+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.
@@ -240,2079 +265,1060 @@ declare function useFundTradingWallet(spokeProvider: BitcoinSpokeProvider | unde
  * 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>;
+declare function useBitcoinBalance({ params, queryOptions, }?: UseBitcoinBalanceParams): UseQueryResult<bigint, Error>;
 
+type UseTradingWalletReturn = {
+    tradingAddress: string | undefined;
+};
 /**
- * Hook to fetch trading wallet balance from Radfi API.
- * Returns confirmed + pending satoshi balances.
+ * Returns the Radfi trading wallet address from the persisted session.
+ * Trading wallet is created automatically during authentication — no API call needed.
  */
-declare function useTradingWalletBalance(spokeProvider: BitcoinSpokeProvider | undefined, tradingAddress: string | undefined): UseQueryResult<RadfiWalletBalance, Error>;
+declare function useTradingWallet(walletAddress: string | undefined): UseTradingWalletReturn;
 
-/**
- * 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 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 RenewUtxosParams = {
+type UseRenewUtxosVars = {
     txIdVouts: string[];
+    walletProvider: IBitcoinWalletProvider;
 };
 /**
- * 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);
- * };
- * ```
+ * React hook for renewing expired UTXOs in the user's Radfi trading wallet. Pure mutation: pass
+ * `{ txIdVouts, walletProvider }` to `mutate({...})`.
  */
-declare function useRenewUtxos(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<string, Error, RenewUtxosParams>;
+declare function useRenewUtxos({ mutationOptions, }?: MutationHookParams<string, UseRenewUtxosVars>): SafeUseMutationResult<string, Error, UseRenewUtxosVars>;
 
-type WithdrawToUserParams = {
+type UseRadfiWithdrawVars = {
     amount: string;
     tokenId: string;
     withdrawTo: string;
+    walletProvider: IBitcoinWalletProvider;
 };
 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);
- * };
- * ```
+ * 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(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<WithdrawResult, Error, WithdrawToUserParams>;
+declare function useRadfiWithdraw({ mutationOptions, }?: MutationHookParams<WithdrawResult, UseRadfiWithdrawVars>): SafeUseMutationResult<WithdrawResult, Error, UseRadfiWithdrawVars>;
 
-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 });
- * ```
+ * 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 {Error} When:
- *   - `spokeProvider` is missing or invalid.
- *   - The underlying borrow transaction fails.
+ * 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(): UseMutationResult<BorrowResponse, MoneyMarketError<'CREATE_BORROW_INTENT_FAILED' | 'BORROW_UNKNOWN_ERROR' | RelayErrorCode>, UseBorrowParams>;
+declare function useBorrow<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseBorrowVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseBorrowVars<K>>;
 
-interface RepayResponse {
-    ok: true;
-    value: [string, string];
-}
-type UseRepayParams = {
-    params: MoneyMarketRepayParams;
-    spokeProvider: SpokeProvider;
-};
+/**
+ * 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.
  *
- * 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.
+ * 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(): UseMutationResult<RepayResponse, MoneyMarketError<'CREATE_REPAY_INTENT_FAILED' | 'REPAY_UNKNOWN_ERROR' | RelayErrorCode>, UseRepayParams>;
+declare function useRepay<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseRepayVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseRepayVars<K>>;
 
-interface SupplyResponse {
-    ok: true;
-    value: [string, string];
-}
-type UseSupplyParams = {
-    params: MoneyMarketSupplyParams;
-    spokeProvider: SpokeProvider;
-};
+/**
+ * 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.
  *
- * 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.
+ * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
+ * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
  *
  * @example
- * ```typescript
- * const { mutateAsync: supply, isPending, error } = useSupply();
- * await supply({ params: supplyParams, spokeProvider });
+ * ```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
+ * }
  * ```
- *
- * @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>;
+declare function useSupply<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseSupplyVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseSupplyVars<K>>;
 
-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 });
- * ```
+ * 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 {Error} When:
- *   - spokeProvider is not provided or invalid.
- *   - Underlying withdrawal logic fails.
+ * 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(): UseMutationResult<WithdrawResponse, MoneyMarketError<'CREATE_WITHDRAW_INTENT_FAILED' | 'WITHDRAW_UNKNOWN_ERROR' | RelayErrorCode>, UseWithdrawParams>;
+declare function useWithdraw<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseWithdrawVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseWithdrawVars<K>>;
 
-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 */
+type UseUserReservesDataParams = ReadHookParams<readonly [readonly UserReserveData[], number], {
+    spokeChainKey: SpokeChainKey | undefined;
     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,
- * });
+ * 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?: UseUserReservesDataParams): UseQueryResult<readonly [readonly UserReserveData[], number], Error>;
+declare function useUserReservesData({ params, queryOptions, }?: UseUserReservesDataParams): UseQueryResult<readonly [readonly UserReserveData[], number], Error>;
 
-type UseReservesDataParams = {
-    queryOptions?: UseQueryOptions<readonly [readonly AggregatedReserveData[], BaseCurrencyInfo], Error>;
-};
+type UseReservesDataParams = ReadHookParams<readonly [readonly AggregatedReserveData[], BaseCurrencyInfo]>;
 /**
- * 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'] } });
+ * React hook for fetching the latest aggregated reserves data and base-currency info from the
+ * Sodax money market.
  */
-declare function useReservesData(params?: UseReservesDataParams): UseQueryResult<readonly [readonly AggregatedReserveData[], BaseCurrencyInfo], Error>;
+declare function useReservesData({ queryOptions, }?: UseReservesDataParams): UseQueryResult<readonly [readonly AggregatedReserveData[], BaseCurrencyInfo], Error>;
 
-type UseMMAllowanceParams = {
-    params: MoneyMarketParams | undefined;
-    spokeProvider: SpokeProvider | undefined;
-    queryOptions?: UseQueryOptions<boolean, Error>;
-};
+type UseReservesHumanizedParams = ReadHookParams<ReservesDataHumanized>;
 /**
- * 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);
- * ```
+ * React hook for fetching the human-readable (decimal-normalized, string-formatted) reserves
+ * snapshot from the Sodax money market.
  */
-declare function useMMAllowance({ params, spokeProvider, queryOptions, }: UseMMAllowanceParams): UseQueryResult<boolean, Error>;
+declare function useReservesHumanized({ queryOptions, }?: UseReservesHumanizedParams): UseQueryResult<ReservesDataHumanized, Error>;
 
-type UseMMApproveParams = {
-    params: MoneyMarketParams;
-    spokeProvider: SpokeProvider | undefined;
-};
+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 approving ERC20 token spending for Sodax money market actions.
+ * Hook for checking token allowance / trustline sufficiency for money market operations.
  *
- * 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.
+ * 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`.
  *
- * @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
+ * The query key matches the invalidation keys emitted by `useMMApprove` and the four mutation
+ * hooks: `['mm', 'allowance', srcChainKey, token, action]`.
  *
  * @example
  * ```tsx
- * const { mutateAsync: approve, isPending, error } = useMMApprove();
- * await approve({ params: { token, amount: "100", action: "supply", ... }, spokeProvider });
+ * 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 {Error} When:
- *   - spokeProvider is undefined or invalid
- *   - Approval transaction fails for any reason
+ * 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(): UseMutationResult<string, Error, UseMMApproveParams>;
+declare function useMMApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseMMApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseMMApproveVars<K>>;
 
-type UseATokenParams = {
-    aToken: string;
-    queryOptions?: UseQueryOptions<XToken, Error>;
+type ATokenData = Erc20Token & {
+    chainKey: ChainKey;
 };
+type UseATokenParams = ReadHookParams<ATokenData, {
+    aToken: Address | string | undefined;
+}>;
 /**
- * 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);
- * }
+ * 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({ aToken, queryOptions }: UseATokenParams): UseQueryResult<XToken, Error>;
+declare function useAToken({ params, queryOptions }?: UseATokenParams): UseQueryResult<ATokenData, Error>;
 
-type UseATokensBalancesParams = {
+type UseATokensBalancesParams = ReadHookParams<Map<Address, bigint>, {
     aTokens: readonly Address[];
-    spokeProvider?: SpokeProvider;
-    userAddress?: string;
-    queryOptions?: UseQueryOptions<Map<Address, bigint>, Error>;
-};
+    spokeChainKey: SpokeChainKey | undefined;
+    userAddress: string | undefined;
+}>;
 /**
- * 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);
+ * 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({ aTokens, spokeProvider, userAddress, queryOptions, }: UseATokensBalancesParams): UseQueryResult<Map<Address, bigint>, Error>;
+declare function useATokensBalances({ params, queryOptions, }?: UseATokensBalancesParams): UseQueryResult<Map<Address, bigint>, Error>;
 
-type UseReservesUsdFormatParams = {
-    queryOptions?: UseQueryOptions<(ReserveData & {
-        priceInMarketReferenceCurrency: string;
-    } & FormatReserveUSDResponse)[], Error>;
-};
+type ReserveUsdFormat = ReserveDataHumanized & FormatReserveUSDResponse;
+type UseReservesUsdFormatParams = ReadHookParams<ReserveUsdFormat[]>;
 /**
- * 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();
+ * React hook returning reserves with USD-formatted values for the Sodax money market.
+ * Chains `getReservesHumanized` → `buildReserveDataWithPrice` → `formatReservesUSD`.
  */
-declare function useReservesUsdFormat(params?: UseReservesUsdFormatParams): UseQueryResult<(ReserveData & {
-    priceInMarketReferenceCurrency: string;
-} & FormatReserveUSDResponse)[], Error>;
+declare function useReservesUsdFormat({ queryOptions, }?: UseReservesUsdFormatParams): UseQueryResult<ReserveUsdFormat[], 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 */
+type UseUserFormattedSummaryParams = ReadHookParams<FormatUserSummaryResponse<FormatReserveUSDResponse>, {
+    spokeChainKey: SpokeChainKey | undefined;
     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
+ * React hook returning the user's formatted money market portfolio summary (collateral, borrows,
+ * health factor, available borrow power, etc.) for the given spoke chain.
  *
- * @example
- * const { data, isLoading, error } = useUserFormattedSummary({ spokeChainId, userAddress });
+ * Internally chains `getReservesHumanized` → `formatReservesUSD` → `getUserReservesHumanized`
+ * → `formatUserSummary`.
  */
-declare function useUserFormattedSummary(params?: UseUserFormattedSummaryParams): UseQueryResult<FormatUserSummaryResponse<FormatReserveUSDResponse>, Error>;
+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.
  *
- * 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);
- * }
+ * const { data: quote, isLoading } = useQuote({ params: { payload } });
  * ```
  *
  * @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>;
+declare const useQuote: ({ params, queryOptions, }?: UseQuoteParams) => 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
+ * 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.
  *
- * @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'
- *   });
- * };
- * ```
+ * 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(spokeProvider: SpokeProvider | undefined): UseMutationResult<CreateIntentResult, Error, CreateIntentParams>;
+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.
  *
- * 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);
- * }
+ * const { data: status, isLoading } = useStatus({ params: { intentTxHash } });
  * ```
- *
- * @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>;
+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>;
 
 /**
- * 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);
- * ```
+ * 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.
  */
-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;
-}
+type UseSwapApproveVars<K extends SpokeChainKey = SpokeChainKey> = {
+    params: CreateIntentParams<K> | CreateLimitOrderParams<K>;
+    walletProvider: GetWalletProviderType<K>;
+};
 /**
- * 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);
+ * React hook for approving ERC-20 token spending (or trustline establishment) for a swap or
+ * limit-order intent.
  *
- * // Approve tokens for supply action
- * await approve({ amount: "100", action: "supply" });
- * ```
+ * 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(params: CreateIntentParams | CreateLimitOrderParams | undefined, spokeProvider: SpokeProvider | undefined): UseApproveReturn$1;
+declare function useSwapApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseSwapApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseSwapApproveVars<K>>;
 
-type CancelIntentParams = {
+type CancelIntentParams<K extends SpokeChainKey = SpokeChainKey> = {
+    srcChainKey: K;
+    walletProvider: GetWalletProviderType<K>;
     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.
+ * React hook for cancelling an in-flight swap intent.
  *
- * @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
- *   });
- * };
- * ```
+ * 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(spokeProvider: SpokeProvider | undefined): UseMutationResult<CancelIntentResult, Error, CancelIntentParams>;
+declare function useCancelSwap({ mutationOptions, }?: MutationHookParams<TxHashPair, CancelIntentParams>): SafeUseMutationResult<TxHashPair, 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
+ * 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).
  *
- * @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);
- *   }
- * };
- * ```
+ * 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(spokeProvider: SpokeProvider | undefined): UseMutationResult<CreateLimitOrderResult, Error, CreateLimitOrderParams>;
+declare function useCreateLimitOrder<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<SwapResponse, UseCreateLimitOrderVars<K>>): SafeUseMutationResult<SwapResponse, Error, UseCreateLimitOrderVars<K>>;
 
-type CancelLimitOrderParams = {
+type CancelLimitOrderParams<K extends SpokeChainKey = SpokeChainKey> = {
+    srcChainKey: K;
+    walletProvider: GetWalletProviderType<K>;
     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.
+ * React hook for cancelling a limit-order intent.
  *
- * @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);
- *   }
- * };
- * ```
+ * 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(): UseMutationResult<CancelLimitOrderResult, Error, CancelLimitOrderParams>;
+declare function useCancelLimitOrder({ mutationOptions, }?: MutationHookParams<TxHashPair, CancelLimitOrderParams>): SafeUseMutationResult<TxHashPair, Error, CancelLimitOrderParams>;
 
-type UseBackendIntentByTxHashParams = {
-    params: {
-        txHash: string | undefined;
-    };
-    queryOptions?: UseQueryOptions<IntentResponse | undefined, Error>;
-};
+type UseBackendIntentByTxHashParams = ReadHookParams<IntentResponse | undefined, {
+    txHash: string | undefined;
+}>;
 /**
  * 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);
- * }
+ * const { data: intent } = useBackendIntentByTxHash({ params: { txHash: '0x123...' } });
  *
  * @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.
+ * - Default refetch interval is 1 second.
  */
-declare const useBackendIntentByTxHash: (params: UseBackendIntentByTxHashParams | undefined) => UseQueryResult<IntentResponse | undefined, Error>;
+declare const useBackendIntentByTxHash: ({ params, queryOptions, }?: UseBackendIntentByTxHashParams) => UseQueryResult<IntentResponse | undefined, Error>;
 
-type UseBackendIntentByHashParams = {
-    params: {
-        intentHash: string | undefined;
-    };
-    queryOptions?: UseQueryOptions<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.
  *
- * @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.
+ * const { data: intent } = useBackendIntentByHash({ params: { intentHash: '0xabc...' } });
  */
-declare const useBackendIntentByHash: (params: UseBackendIntentByHashParams | undefined) => UseQueryResult<IntentResponse | undefined, Error>;
+declare const useBackendIntentByHash: ({ params, queryOptions, }?: UseBackendIntentByHashParams) => UseQueryResult<IntentResponse | undefined, Error>;
 
-type BackendPaginationParams = {
-    offset: string;
-    limit: string;
-};
-
-type GetUserIntentsParams = {
-    userAddress: Address$1;
+type UseBackendUserIntentsParams = ReadHookParams<UserIntentsResponse | undefined, {
+    userAddress: Address$1 | undefined;
     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.
+ * React hook for fetching user-created intents from the backend API for a given user address.
  *
  * @example
- * const { data: userIntents, isLoading, error } = useBackendUserIntents({
- *   params: { userAddress: "0x123..." }
+ * const { data: userIntents } = 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>;
+declare const useBackendUserIntents: ({ params, queryOptions, }?: UseBackendUserIntentsParams) => UseQueryResult<UserIntentsResponse | undefined, Error>;
 
-type UseBackendSubmitSwapTxParams = {
+/**
+ * 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;
-    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).
+ * React hook for submitting a swap transaction to be processed by the backend (relay, post
+ * execution to solver, etc.).
  *
- * @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.
+ * 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({
- *   txHash: '0x123...',
- *   srcChainId: '1',
- *   walletAddress: '0xabc...',
- *   intent: { ... },
- *   relayData: '0x...',
+ *   request: { txHash: '0x123...', srcChainKey: 'sonic', walletAddress: '0xabc...', intent: { ... }, relayData: '0x...' },
+ *   apiConfig: { baseURL: 'https://...' },
  * });
  */
-declare const useBackendSubmitSwapTx: (params?: UseBackendSubmitSwapTxParams) => UseMutationResult<SubmitSwapTxResponse, Error, SubmitSwapTxRequest>;
+declare const useBackendSubmitSwapTx: ({ mutationOptions, }?: MutationHookParams<SubmitSwapTxResponse, UseBackendSubmitSwapTxVars>) => SafeUseMutationResult<SubmitSwapTxResponse, Error, UseBackendSubmitSwapTxVars>;
 
-type UseBackendSubmitSwapTxStatusParams = {
-    params: {
-        txHash: string | undefined;
-        srcChainId?: string;
-    };
+type UseBackendSubmitSwapTxStatusParams = ReadHookParams<SubmitSwapTxStatusResponse | undefined, {
+    txHash: string | undefined;
+    srcChainKey?: 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' },
+ * const { data: status } = useBackendSubmitSwapTxStatus({
+ *   params: { txHash: '0x123...', srcChainKey: 'sonic' },
  * });
  *
- * 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.
+ * - Default refetch interval is 1 second; stops on 'executed' or 'failed' status.
  */
-declare const useBackendSubmitSwapTxStatus: (params: UseBackendSubmitSwapTxStatusParams | undefined) => UseQueryResult<SubmitSwapTxStatusResponse | undefined, Error>;
+declare const useBackendSubmitSwapTxStatus: ({ params, queryOptions, }?: UseBackendSubmitSwapTxStatusParams) => UseQueryResult<SubmitSwapTxStatusResponse | undefined, Error>;
 
-type UseBackendOrderbookParams = {
-    queryOptions?: UseQueryOptions<OrderbookResponse | undefined, Error>;
-    pagination?: BackendPaginationParams;
+type BackendPaginationParams = {
+    offset: string;
+    limit: string;
 };
+
+type UseBackendOrderbookParams = ReadHookParams<OrderbookResponse, {
+    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.
+ * const { data } = useBackendOrderbook({ params: { pagination: { offset: '0', limit: '10' } } });
  */
-declare const useBackendOrderbook: (params: UseBackendOrderbookParams | undefined) => UseQueryResult<OrderbookResponse | undefined>;
+declare const useBackendOrderbook: ({ params, queryOptions, }?: UseBackendOrderbookParams) => UseQueryResult<OrderbookResponse>;
 
-type UseBackendMoneyMarketPositionParams = {
+type UseBackendMoneyMarketPositionParams = ReadHookParams<MoneyMarketPosition | undefined, {
     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 },
- * });
+ * const { data } = useBackendMoneyMarketPosition({ params: { userAddress: '0xabc...' } });
  */
-declare const useBackendMoneyMarketPosition: (params: UseBackendMoneyMarketPositionParams | undefined) => UseQueryResult<MoneyMarketPosition | undefined, Error>;
+declare const useBackendMoneyMarketPosition: ({ params, queryOptions, }?: UseBackendMoneyMarketPositionParams) => UseQueryResult<MoneyMarketPosition | undefined, Error>;
 
-type UseBackendAllMoneyMarketAssetsParams = {
-    queryOptions?: UseQueryOptions<MoneyMarketAsset[], Error>;
-};
+type UseBackendAllMoneyMarketAssetsParams = ReadHookParams<MoneyMarketAsset[]>;
 /**
  * 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>;
+declare const useBackendAllMoneyMarketAssets: ({ queryOptions, }?: UseBackendAllMoneyMarketAssetsParams) => UseQueryResult<MoneyMarketAsset[], Error>;
 
-type UseBackendMoneyMarketAssetParams = {
-    params: {
-        reserveAddress: string | undefined;
-    };
-    queryOptions?: UseQueryOptions<MoneyMarketAsset | undefined, Error>;
-};
+type UseBackendMoneyMarketAssetParams = ReadHookParams<MoneyMarketAsset | undefined, {
+    reserveAddress: string | undefined;
+}>;
 /**
  * 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.
+ * const { data: asset } = useBackendMoneyMarketAsset({ params: { reserveAddress: '0xabc...' } });
  */
-declare const useBackendMoneyMarketAsset: (params: UseBackendMoneyMarketAssetParams | undefined) => UseQueryResult<MoneyMarketAsset | undefined, Error>;
+declare const useBackendMoneyMarketAsset: ({ params, queryOptions, }?: UseBackendMoneyMarketAssetParams) => UseQueryResult<MoneyMarketAsset | undefined, Error>;
 
-type UseBackendMoneyMarketAssetBorrowersParams = {
-    params: {
-        reserveAddress: string | undefined;
-    };
+type UseBackendMoneyMarketAssetBorrowersParams = ReadHookParams<MoneyMarketAssetBorrowers | undefined, {
+    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' }
+ * const { data: borrowers } = 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>;
+declare const useBackendMoneyMarketAssetBorrowers: ({ params, queryOptions, }?: UseBackendMoneyMarketAssetBorrowersParams) => UseQueryResult<MoneyMarketAssetBorrowers | undefined, Error>;
 
-type UseBackendMoneyMarketAssetSuppliersParams = {
-    params: {
-        reserveAddress: string | undefined;
-    };
+type UseBackendMoneyMarketAssetSuppliersParams = ReadHookParams<MoneyMarketAssetSuppliers | undefined, {
+    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.
+ * React hook for fetching suppliers for a specific money market asset from the backend API.
  *
  * @example
- * const { data: suppliers, isLoading, error } = useBackendMoneyMarketAssetSuppliers({
- *   params: { reserveAddress: '0xabc...' },
- *   pagination: { offset: '0', limit: '20' }
+ * const { data: suppliers } = 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>;
+declare const useBackendMoneyMarketAssetSuppliers: ({ params, queryOptions, }?: UseBackendMoneyMarketAssetSuppliersParams) => UseQueryResult<MoneyMarketAssetSuppliers | undefined, Error>;
 
-type UseBackendAllMoneyMarketBorrowersParams = {
+type UseBackendAllMoneyMarketBorrowersParams = ReadHookParams<MoneyMarketBorrowers | undefined, {
     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'
+ * const { data, isLoading, error } = useBackendAllMoneyMarketBorrowers({
+ *   params: { pagination: { 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>;
+declare const useBackendAllMoneyMarketBorrowers: ({ params, queryOptions, }?: UseBackendAllMoneyMarketBorrowersParams) => UseQueryResult<MoneyMarketBorrowers | undefined>;
 
 /**
- * Hook for checking token allowance for bridge operations.
+ * 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.
  *
- * This hook verifies if the user has approved enough tokens for a specific bridge action.
- * It automatically queries and tracks the allowance status.
+ * 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.
  *
- * @param {BridgeParams} params - The parameters for the bridge to check allowance for.
- * @param {SpokeProvider} spokeProvider - The spoke provider to use for allowance checks
+ * 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.
  *
- * @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
+ * 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.
  *
- * @example
- * ```typescript
- * const { data: hasAllowed, isLoading } = useBridgeAllowance(params, spokeProvider);
- * ```
+ * 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 useBridgeAllowance(params: CreateBridgeIntentParams | undefined, spokeProvider: SpokeProvider | undefined): UseQueryResult<boolean, Error>;
+declare function useStakeApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseStakeApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseStakeApproveVars<K>>;
 
-interface UseBridgeApproveReturn {
-    approve: (params: CreateBridgeIntentParams) => Promise<boolean>;
-    isLoading: boolean;
-    error: Error | null;
-    resetError: () => void;
-}
+type UseStakeAllowanceParams<K extends SpokeChainKey = SpokeChainKey> = ReadHookParams<boolean, {
+    payload: Omit<StakeParams<K>, 'action'> | undefined;
+}>;
 /**
- * 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...'
- * });
- * ```
+ * 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 useBridgeApprove(spokeProvider: SpokeProvider | undefined): UseBridgeApproveReturn;
+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'>;
 /**
- * Hook for executing bridge transactions to transfer tokens between chains.
- * Uses React Query's useMutation for better state management and caching.
+ * React hook for initiating an SODA unstake.
  *
- * @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
- *   });
- * };
- * ```
+ * 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(spokeProvider: SpokeProvider | undefined): UseMutationResult<Result<[SpokeTxHash, HubTxHash], BridgeError<BridgeErrorCode>>, Error, CreateBridgeIntentParams>;
+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'>;
 /**
- * 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
+ * React hook for claiming an unstaked SODA request that has reached the end of its waiting period.
  *
- * @example
- * ```typescript
- * const { data: balance, isLoading } = useSpokeAssetManagerTokenBalance(chainId, tokenAddress);
+ * 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.
  *
- * if (balance) {
- *   console.log('Asset manager token balance:', balance.toString());
- * }
- * ```
+ * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
+ * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
  */
-declare function useGetBridgeableAmount(from: XToken | undefined, to: XToken | undefined): UseQueryResult<BridgeLimit, Error>;
+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;
+}>;
 /**
- * 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.');
- * }
- * ```
+ * 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 useGetBridgeableTokens(from: SpokeChainId | undefined, to: SpokeChainId | undefined, token: string | undefined): UseQueryResult<XToken[], Error>;
+declare function useUnstakingInfoWithPenalty({ params, queryOptions, }?: UseUnstakingInfoWithPenaltyParams): UseQueryResult<UnstakingInfoWithPenalty, Error>;
 
+type UseStakingConfigParams = ReadHookParams<StakingConfig>;
 /**
- * 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);
- * };
- * ```
+ * 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 useStake(spokeProvider: SpokeProvider | undefined): UseMutationResult<[SpokeTxHash, HubTxHash], Error, StakeParams>;
+declare function useStakingConfig({ queryOptions, }?: UseStakingConfigParams): UseQueryResult<StakingConfig, Error>;
 
+type UseStakeRatioParams = ReadHookParams<[
+    bigint,
+    bigint
+], {
+    amount: bigint | undefined;
+}>;
 /**
- * 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);
- * };
- * ```
+ * React hook to estimate the SODA → xSODA stake ratio for a given amount. Hub-only read. Throws
+ * on `!ok`.
  */
-declare function useStakeApprove(spokeProvider: SpokeProvider | undefined): UseMutationResult<TxReturnType<SpokeProvider, false>, Error, Omit<StakeParams, 'action'>>;
+declare function useStakeRatio({ params, queryOptions, }?: UseStakeRatioParams): UseQueryResult<[bigint, bigint], Error>;
 
+type UseInstantUnstakeRatioParams = ReadHookParams<bigint, {
+    amount: bigint | undefined;
+}>;
 /**
- * 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');
- * }
- * ```
+ * 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 useStakeAllowance(params: Omit<StakeParams, 'action'> | undefined, spokeProvider: SpokeProvider | undefined): UseQueryResult<boolean, Error>;
+declare function useInstantUnstakeRatio({ params, queryOptions, }?: UseInstantUnstakeRatioParams): UseQueryResult<bigint, Error>;
 
+type UseConvertedAssetsParams = ReadHookParams<bigint, {
+    amount: bigint | undefined;
+}>;
 /**
- * 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);
- * };
- * ```
+ * 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 useUnstake(spokeProvider: SpokeProvider | undefined): UseMutationResult<[SpokeTxHash, HubTxHash], Error, Omit<UnstakeParams, 'action'>>;
+declare function useConvertedAssets({ params, queryOptions, }?: UseConvertedAssetsParams): UseQueryResult<bigint, Error>;
 
+type UseInstantUnstakeVars<K extends SpokeChainKey = SpokeChainKey> = Omit<InstantUnstakeAction<K, false>, 'raw'>;
 /**
- * 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.
+ * React hook for instant-unstaking SODA (bypassing the waiting period at a slippage cost).
  *
- * @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);
- * };
- * ```
+ * 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(spokeProvider: SpokeProvider | undefined): UseMutationResult<[SpokeTxHash, HubTxHash], Error, Omit<ClaimParams, 'action'>>;
+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;
+}>;
 /**
- * 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);
- * };
- * ```
+ * 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 useCancelUnstake(spokeProvider: SpokeProvider | undefined): UseMutationResult<[SpokeTxHash, HubTxHash], Error, Omit<CancelUnstakeParams, 'action'>>;
+declare function useUnstakeAllowance<K extends SpokeChainKey = SpokeChainKey>({ params, queryOptions, }?: UseUnstakeAllowanceParams<K>): UseQueryResult<boolean, Error>;
 
 /**
- * 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);
+ * 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.
  *
- * 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);
- * }
- * ```
+ * 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 useStakingInfo(spokeProvider: SpokeProvider | undefined, refetchInterval?: number): UseQueryResult<StakingInfo, Error>;
+declare function useUnstakeApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseUnstakeApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseUnstakeApproveVars<K>>;
 
-type UnstakingInfoWithPenalty = UnstakingInfo & {
-    requestsWithPenalty: UnstakeRequestWithPenalty[];
+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>;
 };
 /**
- * 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
+ * React hook for approving xSODA spending on the instant-unstake action.
  *
- * @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);
- *   });
- * }
- * ```
+ * 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 useUnstakingInfoWithPenalty(userAddress: string | undefined, spokeProvider: SpokeProvider | undefined, refetchInterval?: number): UseQueryResult<UnstakingInfoWithPenalty, Error>;
+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;
+}>;
 /**
- * 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);
- * }
- * ```
+ * 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 useStakingConfig(refetchInterval?: number): UseQueryResult<StakingConfig, Error>;
+declare function useInstantUnstakeAllowance<K extends SpokeChainKey = SpokeChainKey>({ params, queryOptions, }?: UseInstantUnstakeAllowanceParams<K>): UseQueryResult<boolean, Error>;
 
+type UseFetchAssetsBalancesParams = ReadHookParams<Map<string, PartnerFeeClaimAssetBalance>, {
+    queryAddress: string | undefined;
+}>;
 /**
- * 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);
- * }
- * ```
+ * React hook to fetch hub-asset balances on Sonic for a given EVM address. Disabled when
+ * `queryAddress` is missing. Throws on `!ok`.
  */
-declare function useStakeRatio(amount: bigint | undefined, refetchInterval?: number): UseQueryResult<[bigint, bigint], Error>;
+declare function useFetchAssetsBalances({ params, queryOptions, }?: UseFetchAssetsBalancesParams): UseQueryResult<Map<string, PartnerFeeClaimAssetBalance>, Error>;
 
+type UseGetAutoSwapPreferencesParams = ReadHookParams<AutoSwapPreferences, {
+    queryAddress: string | undefined;
+}>;
 /**
- * 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);
- * }
- * ```
+ * 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 useInstantUnstakeRatio(amount: bigint | undefined, refetchInterval?: number): UseQueryResult<bigint, Error>;
+declare function useGetAutoSwapPreferences({ params, queryOptions, }?: UseGetAutoSwapPreferencesParams): UseQueryResult<AutoSwapPreferences, Error>;
 
+type UseIsTokenApprovedParams = ReadHookParams<boolean, {
+    payload: FeeTokenApproveParams | undefined;
+}>;
 /**
- * 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);
- * }
- * ```
+ * 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 useConvertedAssets(amount: bigint | undefined, refetchInterval?: number): UseQueryResult<bigint, Error>;
+declare function useIsTokenApproved({ params, queryOptions, }?: UseIsTokenApprovedParams): UseQueryResult<boolean, Error>;
 
+type UseApproveTokenVars = Omit<FeeTokenApproveAction<HubChainKey, false>, 'raw'>;
+type ApproveTokenData = TxReturnType<HubChainKey, false>;
 /**
- * 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
+ * React hook to approve a token to the protocol-intents contract on Sonic with max allowance.
  *
- * @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);
- * };
- * ```
+ * 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 useInstantUnstake(spokeProvider: SpokeProvider | undefined): UseMutationResult<[string, string], Error, Omit<InstantUnstakeParams, 'action'>>;
+declare function useApproveToken({ mutationOptions, }?: MutationHookParams<ApproveTokenData, UseApproveTokenVars>): SafeUseMutationResult<ApproveTokenData, Error, UseApproveTokenVars>;
 
 /**
- * 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
+ * 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.
  *
- * @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');
- * }
- * ```
+ * 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 useUnstakeAllowance(params: Omit<UnstakeParams, 'action'> | undefined, spokeProvider: SpokeProvider | undefined): UseQueryResult<boolean, Error>;
+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'>;
 /**
- * Hook for approving xSODA token spending for unstaking operations.
- * Uses React Query's useMutation for better state management and caching.
+ * React hook to create a partner-fee auto-swap intent and wait for the solver execution.
  *
- * @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);
- * };
- * ```
+ * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
+ * `onError`, `retry`). Returns the unwrapped `IntentAutoSwapResult` on success.
  */
-declare function useUnstakeApprove(spokeProvider: SpokeProvider | undefined): UseMutationResult<TxReturnType<SpokeProvider, false>, Error, Omit<UnstakeParams, 'action'>>;
+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;
+}>;
 /**
- * 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);
- *   });
- * }
- * ```
+ * 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 useUnstakingInfo(userAddress: string | undefined, spokeProvider: SpokeProvider | undefined, refetchInterval?: number): UseQueryResult<UnstakingInfo, Error>;
+declare function useHubAssetBalances({ params, queryOptions, }?: UseHubAssetBalancesParams): UseQueryResult<HubAssetBalance[], 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...'
- *   });
+ * 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.
  *
- *   console.log('Approval successful:', result);
- * };
- * ```
+ * 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(spokeProvider: SpokeProvider | undefined): UseMutationResult<TxReturnType<SpokeProvider, false>, Error, Omit<InstantUnstakeParams, 'action'>>;
+declare function useWithdrawHubAsset<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseWithdrawHubAssetVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseWithdrawHubAssetVars<K>>;
 
 /**
- * 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
+ * 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}.
  *
- * @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');
- * }
- * ```
+ * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
+ * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
  */
-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;
-}
+declare function useMigrateIcxToSoda({ mutationOptions, }?: MutationHookParams<TxHashPair, UseMigrateIcxToSodaVars>): SafeUseMutationResult<TxHashPair, Error, UseMigrateIcxToSodaVars>;
 
+type UseRevertMigrateSodaToIcxVars = Omit<IcxRevertMigrationAction<false>, 'raw'>;
 /**
- * Hook for executing migration operations between chains.
+ * React hook for reverting SODA → ICX (the inverse of {@link useMigrateIcxToSoda}).
  *
- * 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..."
- * });
- * ```
+ * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
+ * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
  */
-declare function useMigrate(spokeProvider: SpokeProvider | undefined): UseMutationResult<{
-    spokeTxHash: string;
-    hubTxHash: `0x${string}`;
-}, Error, MigrationIntentParams>;
+declare function useRevertMigrateSodaToIcx({ mutationOptions, }?: MutationHookParams<TxHashPair, UseRevertMigrateSodaToIcxVars>): SafeUseMutationResult<TxHashPair, Error, UseRevertMigrateSodaToIcxVars>;
 
 /**
- * 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
+ * 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.
  *
- * @example
- * ```typescript
- * const { data: hasAllowed, isLoading } = useMigrationAllowance(params, spokeProvider);
- * ```
+ * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
+ * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
  */
-declare function useMigrationAllowance(params: MigrationIntentParams | undefined, spokeProvider: SpokeProvider | undefined): UseQueryResult<boolean, Error>;
+declare function useMigratebnUSD<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseMigratebnUSDVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseMigratebnUSDVars<K>>;
 
-interface UseApproveReturn {
-    approve: ({ params }: {
-        params: MigrationIntentParams;
-    }) => Promise<boolean>;
-    isLoading: boolean;
-    error: Error | null;
-    resetError: () => void;
-    isApproved: boolean;
-}
+type UseMigrateBalnVars = Omit<BalnMigrateAction<false>, 'raw'>;
 /**
- * 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);
+ * 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).
  *
- * // Approve tokens for migration
- * await approve({ params });
- * ```
+ * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
+ * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
  */
-declare function useMigrationApprove(params: MigrationIntentParams | undefined, spokeProvider: SpokeProvider | undefined): UseApproveReturn;
+declare function useMigrateBaln({ mutationOptions, }?: MutationHookParams<TxHashPair, UseMigrateBalnVars>): SafeUseMutationResult<TxHashPair, Error, UseMigrateBalnVars>;
 
-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>;
+/**
+ * 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;
 };
 /**
- * Loads and caches the available list of pools from the DEX service's ConcentratedLiquidityService.
+ * 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)
  *
- * By default, the query result is cached indefinitely (with `staleTime` set to Infinity), reflecting the
- * assumption that the pools list is mostly static.
+ * NOT required for ICX → SODA forward migrations or BALN migrations (both originate on Icon
+ * which doesn't use ERC-20 allowances).
  *
- * @param params
- *   Optional configuration object:
- *   - queryOptions: Partial QueryObserverOptions for react-query (merged with built-in defaults).
+ * 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.
  *
- * @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.
+ * 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.
  *
- * @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));
+ * 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 usePools(params?: UsePoolsProps): UseQueryResult<PoolKey[], Error>;
+declare function useMigrationAllowance<K extends SpokeChainKey = SpokeChainKey>({ params, queryOptions, }?: UseMigrationAllowanceParams<K>): UseQueryResult<boolean, Error>;
 
-type UsePoolDataProps = {
+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;
-    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.
+ * 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({ poolKey, queryOptions, }: UsePoolDataProps): UseQueryResult<PoolData, Error>;
+declare function usePoolData({ params, queryOptions }?: UsePoolDataParams): UseQueryResult<PoolData, Error>;
 
-interface UsePoolBalancesResponse {
+type UsePoolBalancesResponse = {
     token0Balance: bigint;
     token1Balance: bigint;
-}
-interface UsePoolBalancesProps {
+};
+type UsePoolBalancesParams = ReadHookParams<UsePoolBalancesResponse, {
     poolData: PoolData | null;
     poolKey: PoolKey | null;
-    spokeProvider: SpokeProvider | null;
-    enabled?: boolean;
-    queryOptions?: QueryObserverOptions<UsePoolBalancesResponse, Error>;
-}
+    spokeChainKey: SpokeChainKey | undefined;
+    userAddress: string | undefined;
+}>;
 /**
- * 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);
- * }
- * ```
+ * 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({ poolData, poolKey, spokeProvider, enabled, queryOptions, }: UsePoolBalancesProps): UseQueryResult<UsePoolBalancesResponse, Error>;
+declare function usePoolBalances({ params, queryOptions, }?: UsePoolBalancesParams): UseQueryResult<UsePoolBalancesResponse, Error>;
 
-interface UsePositionInfoResponse {
+type UsePositionInfoResponse = {
     positionInfo: ClPositionInfo;
     isValid: boolean;
-}
-interface UsePositionInfoProps {
+};
+type UsePositionInfoParams = ReadHookParams<UsePositionInfoResponse, {
     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.
+ * 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({ tokenId, poolKey, queryOptions, }: UsePositionInfoProps): UseQueryResult<UsePositionInfoResponse, Error>;
+declare function usePositionInfo({ params, queryOptions, }?: UsePositionInfoParams): UseQueryResult<UsePositionInfoResponse, Error>;
 
-type UseDexDepositParams = {
-    params: CreateAssetDepositParams;
-    spokeProvider: SpokeProvider;
-};
 /**
+ * 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 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.
+ * React hook for depositing an asset into a DEX pool.
  *
- * @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.
+ * Throws on SDK failure so React Query's native error model engages (`isError`, `error`,
+ * `onError`, `retry`). Returns the unwrapped `TxHashPair` on success.
  *
  * @example
- * ```typescript
- * const { mutateAsync: deposit, isPending, error } = useDexDeposit();
- * await deposit({ params: { asset, amount, poolToken }, spokeProvider });
+ * ```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
+ * }
  * ```
- *
- * @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>;
+declare function useDexDeposit<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseDexDepositVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseDexDepositVars<K>>;
 
-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.
+ * 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.
  *
- * @example
- * const { mutateAsync: withdraw, isPending, error } = useDexWithdraw();
- * await withdraw({ params, spokeProvider });
+ * 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(): UseMutationResult<[SpokeTxHash, HubTxHash], Error, UseDexWithdrawParams>;
+declare function useDexWithdraw<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseDexWithdrawVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseDexWithdrawVars<K>>;
 
-type UseDexAllowanceProps = {
-    params: CreateAssetDepositParams | undefined;
-    spokeProvider: SpokeProvider | null;
-    enabled?: boolean;
-    queryOptions?: QueryObserverOptions<boolean, Error>;
-};
+type UseDexAllowanceParams<K extends SpokeChainKey = SpokeChainKey> = ReadHookParams<boolean, {
+    payload: CreateAssetDepositParams<K> | undefined;
+}>;
 /**
- * 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.
+ * 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({ params, spokeProvider, queryOptions, }: UseDexAllowanceProps): UseQueryResult<boolean, Error>;
+declare function useDexAllowance<K extends SpokeChainKey = SpokeChainKey>({ params, queryOptions, }?: UseDexAllowanceParams<K>): 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 });
- * ```
+ * 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.
  *
- * @remarks
- * - Throws if called without both a valid `params` and `spokeProvider`.
- * - On approval success, the query for ['dex', 'allowance'] is invalidated/refetched.
+ * 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(): UseMutationResult<SpokeTxHash, Error, UseDexApproveParams>;
+declare function useDexApprove<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxReturnType<K, false>, UseDexApproveVars<K>>): SafeUseMutationResult<TxReturnType<K, false>, Error, UseDexApproveVars<K>>;
 
-interface UseLiquidityAmountsResult {
+type UseLiquidityAmountsResult = {
     liquidityToken0Amount: string;
     liquidityToken1Amount: string;
     lastEditedToken: 'token0' | 'token1' | null;
@@ -2320,33 +1326,10 @@ interface UseLiquidityAmountsResult {
     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)}
- * />
- * ```
+ * 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;
 
@@ -2361,105 +1344,81 @@ type UseCreateSupplyLiquidityParamsProps = {
     positionId?: string | null;
     isValidPosition?: boolean;
 };
-type UseCreateSupplyLiquidityParamsResult = ConcentratedLiquiditySupplyParams & Omit<ConcentratedLiquidityIncreaseLiquidityParams, 'tokenId'> & {
+/**
+ * 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 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.
+ * 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;
 
-type UseSupplyLiquidityProps = {
-    params: UseCreateSupplyLiquidityParamsResult;
-    spokeProvider: SpokeProvider;
+/**
+ * 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;
 };
 /**
- * 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
+ * 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`.
  *
- * @example
- * ```typescript
- * const { mutateAsync: supplyLiquidity, isPending, error } = useSupplyLiquidity(spokeProvider);
- *
- * await supplyLiquidity({
- *   poolData,
- *   poolKey,
- *   minPrice: '100',
- *   maxPrice: '200',
- *   liquidityToken0Amount: '10',
- *   liquidityToken1Amount: '20',
- *   slippageTolerance: '0.5',
- * });
- * ```
+ * 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(): UseMutationResult<[SpokeTxHash, HubTxHash], Error, UseSupplyLiquidityProps>;
+declare function useSupplyLiquidity<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseSupplyLiquidityVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseSupplyLiquidityVars<K>>;
 
-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.
+ * 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.
  *
- * @remarks
- * - After a successful liquidity decrease, the hook will invalidate DEX pool balances and position info queries.
+ * 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.
  */
-declare function useDecreaseLiquidity(): UseMutationResult<[SpokeTxHash, HubTxHash], Error, UseDecreaseLiquidityParams>;
+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;
@@ -2468,23 +1427,11 @@ type UseCreateDepositParamsProps = {
     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.
+ * 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): CreateAssetDepositParams | undefined;
+declare function useCreateDepositParams({ tokenIndex, amount, poolData, poolSpokeAssets, }: UseCreateDepositParamsProps): DepositParamsCore | undefined;
 
 type UseCreateDecreaseLiquidityParamsProps = {
     poolKey: PoolKey;
@@ -2494,23 +1441,11 @@ type UseCreateDecreaseLiquidityParamsProps = {
     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.
+ * 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): ConcentratedLiquidityDecreaseLiquidityParams;
+declare function useCreateDecreaseLiquidityParams({ poolKey, tokenId, percentage, positionInfo, slippageTolerance, }: UseCreateDecreaseLiquidityParamsProps): DecreaseLiquidityParamsCore;
 
 type UseCreateWithdrawParamsProps = {
     tokenIndex: 0 | 1;
@@ -2520,62 +1455,96 @@ type UseCreateWithdrawParamsProps = {
     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.
+ * 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): CreateAssetWithdrawParams | undefined;
+declare function useCreateWithdrawParams({ tokenIndex, amount, poolData, poolSpokeAssets, dst, }: UseCreateWithdrawParamsProps): WithdrawParamsCore | 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'`.
+ * 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.
  *
- * @example
- * const claimRewardsMutation = useClaimRewards();
- * claimRewardsMutation.mutateAsync({
- *   params: { poolKey, tokenId, tickLower, tickUpper },
- *   spokeProvider,
- * });
+ * 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(): UseMutationResult<[
-    SpokeTxHash,
-    HubTxHash
-], ConcentratedLiquidityError<ConcentratedLiquidityErrorCode>, UseClaimRewardsParams>;
+declare function useClaimRewards<K extends SpokeChainKey = SpokeChainKey>({ mutationOptions, }?: MutationHookParams<TxHashPair, UseClaimRewardsVars<K>>): SafeUseMutationResult<TxHashPair, Error, UseClaimRewardsVars<K>>;
 
 interface SodaxProviderProps {
     children: ReactNode;
-    testnet?: boolean;
-    config?: SodaxConfig;
-    rpcConfig: RpcConfig;
+    /**
+     * Sodax config (overrides defaults including rpcUrls). **Read-once at mount** —
+     * changes after first render are ignored to prevent re-instantiating the SDK
+     * from unstable parent references. To switch config (e.g. testnet ↔ mainnet),
+     * unmount/remount the provider.
+     */
+    config?: DeepPartial<SodaxConfig>;
 }
-declare const SodaxProvider: ({ children, testnet, config, rpcConfig }: SodaxProviderProps) => ReactElement;
+declare const SodaxProvider: ({ children, config }: 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;
+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 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 };
+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 };