@sodax/dapp-kit 1.3.1-beta-rc1 → 1.3.1-beta-rc3

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { Sodax, SpokeProvider, GetEstimateGasReturnType, TxReturnType, SpokeChainId, StellarSpokeProvider, EvmHubProvider, IWalletProvider, 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, OrderbookResponse, MoneyMarketPosition, MoneyMarketAsset, MoneyMarketAssetBorrowers, MoneyMarketAssetSuppliers, MoneyMarketBorrowers, CreateBridgeIntentParams, SpokeTxHash, HubTxHash, BridgeError, BridgeErrorCode, BridgeLimit, StakeParams, UnstakeParams, ClaimParams, CancelUnstakeParams, StakingInfo, UnstakingInfo, UnstakeRequestWithPenalty, StakingConfig, InstantUnstakeParams, SodaxConfig } from '@sodax/sdk';
-import { RpcConfig, SpokeChainId as SpokeChainId$1, XToken as XToken$1 } from '@sodax/types';
-import { UseMutationResult, UseQueryResult, UseQueryOptions } from '@tanstack/react-query';
+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, 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 } from '@tanstack/react-query';
 import { Address } from 'viem';
 import { ReactNode, ReactElement } from 'react';
 
@@ -179,6 +179,109 @@ declare function useHubProvider(): EvmHubProvider;
  */
 declare function useSpokeProvider(spokeChainId: SpokeChainId$1 | undefined, walletProvider?: IWalletProvider | undefined): SpokeProvider | undefined;
 
+type RadfiSession = {
+    accessToken: string;
+    refreshToken: string;
+    tradingAddress: string;
+    publicKey: string;
+    accessTokenExpiry: number;
+    refreshTokenExpiry: number;
+};
+type RadfiAuthResult = {
+    accessToken: string;
+    refreshToken: string;
+    tradingAddress: string;
+};
+declare function saveRadfiSession(address: string, session: RadfiSession): void;
+declare function loadRadfiSession(address: string): RadfiSession | null;
+declare function clearRadfiSession(address: string): void;
+declare function isAccessTokenExpired(address: string): boolean;
+declare function isRefreshTokenExpired(address: string): boolean;
+/**
+ * Hook to authenticate with Radfi using BIP322 message signing.
+ * Saves full session (accessToken, refreshToken, tradingAddress, expiry) to localStorage.
+ */
+declare function useRadfiAuth(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<RadfiAuthResult, Error, void>;
+
+type UseRadfiSessionReturn = {
+    walletAddress: string | undefined;
+    isAuthed: boolean;
+    tradingAddress: string | undefined;
+    login: () => Promise<void>;
+    isLoginPending: boolean;
+};
+/**
+ * Manages the full Radfi session lifecycle:
+ * - Restores session from localStorage on mount
+ * - Polls every 2s: silently refreshes accessToken before expiry, resets auth when refreshToken expires
+ * - Exposes login() and isAuthed for UI
+ */
+declare function useRadfiSession(spokeProvider: BitcoinSpokeProvider | undefined): UseRadfiSessionReturn;
+
+/**
+ * Hook to fund the Radfi trading wallet by sending BTC from the user's personal wallet.
+ *
+ * @param {BitcoinSpokeProvider | undefined} spokeProvider - The Bitcoin spoke provider with signing capability
+ * @returns {UseMutationResult} Mutation result — input is amount in satoshis, output is transaction ID
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync: fundWallet, isPending } = useFundTradingWallet(spokeProvider);
+ *
+ * const handleFund = async () => {
+ *   const txId = await fundWallet(100_000n); // fund 100,000 satoshis
+ *   console.log('Funded:', txId);
+ * };
+ * ```
+ */
+declare function useFundTradingWallet(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<string, Error, bigint>;
+
+/**
+ * Hook to fetch BTC balance for any Bitcoin address.
+ * Sums all UTXOs (confirmed + unconfirmed) from mempool.space API.
+ *
+ * The UTXO set already excludes spent outputs (even from unconfirmed txs),
+ * so the total is always the correct spendable balance.
+ */
+declare function useBitcoinBalance(address: string | undefined, rpcUrl?: string): UseQueryResult<bigint, Error>;
+
+/**
+ * Hook to fetch trading wallet balance from Radfi API.
+ * Returns confirmed + pending satoshi balances.
+ */
+declare function useTradingWalletBalance(spokeProvider: BitcoinSpokeProvider | undefined, tradingAddress: string | undefined): UseQueryResult<RadfiWalletBalance, Error>;
+
+/**
+ * Hook to fetch expired UTXOs for a trading wallet address.
+ * UTXOs that are expired or within 2 weeks of expiry are considered invalid for trading
+ * and need to be renewed via the Radfi renew-utxo flow.
+ */
+declare function useExpiredUtxos(spokeProvider: BitcoinSpokeProvider | undefined, tradingAddress: string | undefined): UseQueryResult<RadfiUtxo[], Error>;
+
+type RenewUtxosParams = {
+    txIdVouts: string[];
+};
+/**
+ * Hook to renew expired UTXOs in the Radfi trading wallet.
+ *
+ * Flow:
+ * 1. Build renew-utxo transaction via Radfi API (returns unsigned PSBT)
+ * 2. User signs the PSBT with their wallet
+ * 3. Submit signed PSBT back to Radfi for co-signing and broadcasting
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync: renewUtxos, isPending } = useRenewUtxos(spokeProvider);
+ *
+ * const handleRenew = async (expiredUtxos: RadfiUtxo[]) => {
+ *   const txIdVouts = expiredUtxos.map(u => `${u.txId}:${u.vout}`);
+ *   const txId = await renewUtxos({ txIdVouts });
+ *   console.log('Renewed:', txId);
+ * };
+ * ```
+ */
+declare function useRenewUtxos(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<string, Error, RenewUtxosParams>;
+
 interface BorrowResponse {
     ok: true;
     value: [string, string];
@@ -932,6 +1035,74 @@ type UseBackendUserIntentsParams = {
  */
 declare const useBackendUserIntents: ({ params, queryOptions, }: UseBackendUserIntentsParams) => UseQueryResult<UserIntentsResponse | undefined, Error>;
 
+type UseBackendSubmitSwapTxParams = {
+    apiConfig?: RequestOverrideConfig;
+    mutationOptions?: UseMutationOptions<SubmitSwapTxResponse, Error, SubmitSwapTxRequest>;
+};
+/**
+ * React hook for submitting a swap transaction to be processed by the backend
+ * (relay, post execution to solver, etc.).
+ *
+ * @param {UseBackendSubmitSwapTxParams | undefined} params - Optional parameters:
+ *   - `mutationOptions`: React Query mutation options to customize behavior (e.g., onSuccess, onError, retry).
+ *
+ * @returns {UseMutationResult<SubmitSwapTxResponse, Error, SubmitSwapTxRequest>} React Query mutation result:
+ *   - `mutate` / `mutateAsync`: Functions to trigger the submission.
+ *   - `data`: The submit response on success.
+ *   - `isPending`: Loading state.
+ *   - `error`: Error instance if the mutation failed.
+ *
+ * @example
+ * const { mutateAsync: submitSwapTx, isPending, error } = useBackendSubmitSwapTx();
+ *
+ * const result = await submitSwapTx({
+ *   txHash: '0x123...',
+ *   srcChainId: '1',
+ *   walletAddress: '0xabc...',
+ *   intent: { ... },
+ *   relayData: '0x...',
+ * });
+ */
+declare const useBackendSubmitSwapTx: (params?: UseBackendSubmitSwapTxParams) => UseMutationResult<SubmitSwapTxResponse, Error, SubmitSwapTxRequest>;
+
+type UseBackendSubmitSwapTxStatusParams = {
+    params: {
+        txHash: string | undefined;
+        srcChainId?: string;
+    };
+    apiConfig?: RequestOverrideConfig;
+    queryOptions?: UseQueryOptions<SubmitSwapTxStatusResponse | undefined, Error>;
+};
+/**
+ * React hook for polling the processing status of a submitted swap transaction.
+ *
+ * @param {UseBackendSubmitSwapTxStatusParams | undefined} params - Parameters for the query:
+ *   - `params.txHash`: The transaction hash of the submitted swap; query is disabled if undefined or empty.
+ *   - `params.srcChainId`: Optional source chain ID to narrow the status lookup.
+ *   - `queryOptions`: Optional React Query options to override default behavior (e.g., refetchInterval, retry).
+ *
+ * @returns {UseQueryResult<SubmitSwapTxStatusResponse | undefined, Error>} React Query result object:
+ *   - `data`: The status response or undefined if unavailable.
+ *   - `isLoading`: Loading state.
+ *   - `error`: Error instance if the query failed.
+ *   - `refetch`: Function to re-trigger the query.
+ *
+ * @example
+ * const { data: status, isLoading, error } = useBackendSubmitSwapTxStatus({
+ *   params: { txHash: '0x123...', srcChainId: '1' },
+ * });
+ *
+ * if (status?.data.status === 'executed') {
+ *   console.log('Swap completed!', status.data.result);
+ * }
+ *
+ * @remarks
+ * - Query is disabled if `params` is undefined or `txHash` is undefined/empty.
+ * - Default refetch interval is 1 second for real-time status polling.
+ * - Uses React Query for state management, caching, and retries.
+ */
+declare const useBackendSubmitSwapTxStatus: (params: UseBackendSubmitSwapTxStatusParams | undefined) => UseQueryResult<SubmitSwapTxStatusResponse | undefined, Error>;
+
 type UseBackendOrderbookParams = {
     queryOptions?: UseQueryOptions<OrderbookResponse | undefined, Error>;
     pagination?: BackendPaginationParams;
@@ -1837,4 +2008,4 @@ interface SodaxProviderProps {
 }
 declare const SodaxProvider: ({ children, testnet, config, rpcConfig }: SodaxProviderProps) => ReactElement;
 
-export { type BackendPaginationParams, MIGRATION_MODE_BNUSD, MIGRATION_MODE_ICX_SODA, type MigrationIntentParams, type MigrationMode, SodaxProvider, type UseATokenParams, type UseATokensBalancesParams, type UseBorrowParams, type UseMMAllowanceParams, type UseMMApproveParams, type UseRepayParams, type UseReservesDataParams, type UseReservesUsdFormatParams, type UseSupplyParams, type UseUserFormattedSummaryParams, type UseUserReservesDataParams, type UseWithdrawParams, useAToken, useATokensBalances, useBackendAllMoneyMarketAssets, useBackendAllMoneyMarketBorrowers, useBackendIntentByHash, useBackendIntentByTxHash, useBackendMoneyMarketAsset, useBackendMoneyMarketAssetBorrowers, useBackendMoneyMarketAssetSuppliers, useBackendMoneyMarketPosition, useBackendOrderbook, useBackendUserIntents, useBorrow, useBridge, useBridgeAllowance, useBridgeApprove, useCancelLimitOrder, useCancelSwap, useCancelUnstake, useClaim, useConvertedAssets, useCreateLimitOrder, useDeriveUserWalletAddress, useEstimateGas, useGetBridgeableAmount, useGetBridgeableTokens, useGetUserHubWalletAddress, useHubProvider, useInstantUnstake, useInstantUnstakeAllowance, useInstantUnstakeApprove, useInstantUnstakeRatio, useMMAllowance, useMMApprove, useMigrate, useMigrationAllowance, useMigrationApprove, useQuote, useRepay, useRequestTrustline, useReservesData, useReservesUsdFormat, useSodaxContext, useSpokeProvider, useStake, useStakeAllowance, useStakeApprove, useStakeRatio, useStakingConfig, useStakingInfo, useStatus, useStellarTrustlineCheck, useSupply, useSwap, useSwapAllowance, useSwapApprove, useUnstake, useUnstakeAllowance, useUnstakeApprove, useUnstakingInfo, useUnstakingInfoWithPenalty, useUserFormattedSummary, useUserReservesData, useWithdraw };
+export { type BackendPaginationParams, MIGRATION_MODE_BNUSD, MIGRATION_MODE_ICX_SODA, type MigrationIntentParams, type MigrationMode, type RadfiSession, SodaxProvider, type UseATokenParams, type UseATokensBalancesParams, type UseBorrowParams, type UseMMAllowanceParams, type UseMMApproveParams, type UseRadfiSessionReturn, type UseRepayParams, type UseReservesDataParams, type UseReservesUsdFormatParams, type UseSupplyParams, type UseUserFormattedSummaryParams, type UseUserReservesDataParams, type UseWithdrawParams, clearRadfiSession, isAccessTokenExpired, isRefreshTokenExpired, 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, useConvertedAssets, useCreateLimitOrder, useDeriveUserWalletAddress, useEstimateGas, useExpiredUtxos, useFundTradingWallet, useGetBridgeableAmount, useGetBridgeableTokens, useGetUserHubWalletAddress, useHubProvider, useInstantUnstake, useInstantUnstakeAllowance, useInstantUnstakeApprove, useInstantUnstakeRatio, useMMAllowance, useMMApprove, useMigrate, useMigrationAllowance, useMigrationApprove, useQuote, useRadfiAuth, useRadfiSession, useRenewUtxos, useRepay, useRequestTrustline, useReservesData, useReservesUsdFormat, useSodaxContext, useSpokeProvider, useStake, useStakeAllowance, useStakeApprove, useStakeRatio, useStakingConfig, useStakingInfo, useStatus, useStellarTrustlineCheck, useSupply, useSwap, useSwapAllowance, useSwapApprove, useTradingWalletBalance, useUnstake, useUnstakeAllowance, useUnstakeApprove, useUnstakingInfo, useUnstakingInfoWithPenalty, useUserFormattedSummary, useUserReservesData, useWithdraw };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { Sodax, SpokeProvider, GetEstimateGasReturnType, TxReturnType, SpokeChainId, StellarSpokeProvider, EvmHubProvider, IWalletProvider, 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, OrderbookResponse, MoneyMarketPosition, MoneyMarketAsset, MoneyMarketAssetBorrowers, MoneyMarketAssetSuppliers, MoneyMarketBorrowers, CreateBridgeIntentParams, SpokeTxHash, HubTxHash, BridgeError, BridgeErrorCode, BridgeLimit, StakeParams, UnstakeParams, ClaimParams, CancelUnstakeParams, StakingInfo, UnstakingInfo, UnstakeRequestWithPenalty, StakingConfig, InstantUnstakeParams, SodaxConfig } from '@sodax/sdk';
-import { RpcConfig, SpokeChainId as SpokeChainId$1, XToken as XToken$1 } from '@sodax/types';
-import { UseMutationResult, UseQueryResult, UseQueryOptions } from '@tanstack/react-query';
+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, 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 } from '@tanstack/react-query';
 import { Address } from 'viem';
 import { ReactNode, ReactElement } from 'react';
 
@@ -179,6 +179,109 @@ declare function useHubProvider(): EvmHubProvider;
  */
 declare function useSpokeProvider(spokeChainId: SpokeChainId$1 | undefined, walletProvider?: IWalletProvider | undefined): SpokeProvider | undefined;
 
+type RadfiSession = {
+    accessToken: string;
+    refreshToken: string;
+    tradingAddress: string;
+    publicKey: string;
+    accessTokenExpiry: number;
+    refreshTokenExpiry: number;
+};
+type RadfiAuthResult = {
+    accessToken: string;
+    refreshToken: string;
+    tradingAddress: string;
+};
+declare function saveRadfiSession(address: string, session: RadfiSession): void;
+declare function loadRadfiSession(address: string): RadfiSession | null;
+declare function clearRadfiSession(address: string): void;
+declare function isAccessTokenExpired(address: string): boolean;
+declare function isRefreshTokenExpired(address: string): boolean;
+/**
+ * Hook to authenticate with Radfi using BIP322 message signing.
+ * Saves full session (accessToken, refreshToken, tradingAddress, expiry) to localStorage.
+ */
+declare function useRadfiAuth(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<RadfiAuthResult, Error, void>;
+
+type UseRadfiSessionReturn = {
+    walletAddress: string | undefined;
+    isAuthed: boolean;
+    tradingAddress: string | undefined;
+    login: () => Promise<void>;
+    isLoginPending: boolean;
+};
+/**
+ * Manages the full Radfi session lifecycle:
+ * - Restores session from localStorage on mount
+ * - Polls every 2s: silently refreshes accessToken before expiry, resets auth when refreshToken expires
+ * - Exposes login() and isAuthed for UI
+ */
+declare function useRadfiSession(spokeProvider: BitcoinSpokeProvider | undefined): UseRadfiSessionReturn;
+
+/**
+ * Hook to fund the Radfi trading wallet by sending BTC from the user's personal wallet.
+ *
+ * @param {BitcoinSpokeProvider | undefined} spokeProvider - The Bitcoin spoke provider with signing capability
+ * @returns {UseMutationResult} Mutation result — input is amount in satoshis, output is transaction ID
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync: fundWallet, isPending } = useFundTradingWallet(spokeProvider);
+ *
+ * const handleFund = async () => {
+ *   const txId = await fundWallet(100_000n); // fund 100,000 satoshis
+ *   console.log('Funded:', txId);
+ * };
+ * ```
+ */
+declare function useFundTradingWallet(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<string, Error, bigint>;
+
+/**
+ * Hook to fetch BTC balance for any Bitcoin address.
+ * Sums all UTXOs (confirmed + unconfirmed) from mempool.space API.
+ *
+ * The UTXO set already excludes spent outputs (even from unconfirmed txs),
+ * so the total is always the correct spendable balance.
+ */
+declare function useBitcoinBalance(address: string | undefined, rpcUrl?: string): UseQueryResult<bigint, Error>;
+
+/**
+ * Hook to fetch trading wallet balance from Radfi API.
+ * Returns confirmed + pending satoshi balances.
+ */
+declare function useTradingWalletBalance(spokeProvider: BitcoinSpokeProvider | undefined, tradingAddress: string | undefined): UseQueryResult<RadfiWalletBalance, Error>;
+
+/**
+ * Hook to fetch expired UTXOs for a trading wallet address.
+ * UTXOs that are expired or within 2 weeks of expiry are considered invalid for trading
+ * and need to be renewed via the Radfi renew-utxo flow.
+ */
+declare function useExpiredUtxos(spokeProvider: BitcoinSpokeProvider | undefined, tradingAddress: string | undefined): UseQueryResult<RadfiUtxo[], Error>;
+
+type RenewUtxosParams = {
+    txIdVouts: string[];
+};
+/**
+ * Hook to renew expired UTXOs in the Radfi trading wallet.
+ *
+ * Flow:
+ * 1. Build renew-utxo transaction via Radfi API (returns unsigned PSBT)
+ * 2. User signs the PSBT with their wallet
+ * 3. Submit signed PSBT back to Radfi for co-signing and broadcasting
+ *
+ * @example
+ * ```tsx
+ * const { mutateAsync: renewUtxos, isPending } = useRenewUtxos(spokeProvider);
+ *
+ * const handleRenew = async (expiredUtxos: RadfiUtxo[]) => {
+ *   const txIdVouts = expiredUtxos.map(u => `${u.txId}:${u.vout}`);
+ *   const txId = await renewUtxos({ txIdVouts });
+ *   console.log('Renewed:', txId);
+ * };
+ * ```
+ */
+declare function useRenewUtxos(spokeProvider: BitcoinSpokeProvider | undefined): UseMutationResult<string, Error, RenewUtxosParams>;
+
 interface BorrowResponse {
     ok: true;
     value: [string, string];
@@ -932,6 +1035,74 @@ type UseBackendUserIntentsParams = {
  */
 declare const useBackendUserIntents: ({ params, queryOptions, }: UseBackendUserIntentsParams) => UseQueryResult<UserIntentsResponse | undefined, Error>;
 
+type UseBackendSubmitSwapTxParams = {
+    apiConfig?: RequestOverrideConfig;
+    mutationOptions?: UseMutationOptions<SubmitSwapTxResponse, Error, SubmitSwapTxRequest>;
+};
+/**
+ * React hook for submitting a swap transaction to be processed by the backend
+ * (relay, post execution to solver, etc.).
+ *
+ * @param {UseBackendSubmitSwapTxParams | undefined} params - Optional parameters:
+ *   - `mutationOptions`: React Query mutation options to customize behavior (e.g., onSuccess, onError, retry).
+ *
+ * @returns {UseMutationResult<SubmitSwapTxResponse, Error, SubmitSwapTxRequest>} React Query mutation result:
+ *   - `mutate` / `mutateAsync`: Functions to trigger the submission.
+ *   - `data`: The submit response on success.
+ *   - `isPending`: Loading state.
+ *   - `error`: Error instance if the mutation failed.
+ *
+ * @example
+ * const { mutateAsync: submitSwapTx, isPending, error } = useBackendSubmitSwapTx();
+ *
+ * const result = await submitSwapTx({
+ *   txHash: '0x123...',
+ *   srcChainId: '1',
+ *   walletAddress: '0xabc...',
+ *   intent: { ... },
+ *   relayData: '0x...',
+ * });
+ */
+declare const useBackendSubmitSwapTx: (params?: UseBackendSubmitSwapTxParams) => UseMutationResult<SubmitSwapTxResponse, Error, SubmitSwapTxRequest>;
+
+type UseBackendSubmitSwapTxStatusParams = {
+    params: {
+        txHash: string | undefined;
+        srcChainId?: string;
+    };
+    apiConfig?: RequestOverrideConfig;
+    queryOptions?: UseQueryOptions<SubmitSwapTxStatusResponse | undefined, Error>;
+};
+/**
+ * React hook for polling the processing status of a submitted swap transaction.
+ *
+ * @param {UseBackendSubmitSwapTxStatusParams | undefined} params - Parameters for the query:
+ *   - `params.txHash`: The transaction hash of the submitted swap; query is disabled if undefined or empty.
+ *   - `params.srcChainId`: Optional source chain ID to narrow the status lookup.
+ *   - `queryOptions`: Optional React Query options to override default behavior (e.g., refetchInterval, retry).
+ *
+ * @returns {UseQueryResult<SubmitSwapTxStatusResponse | undefined, Error>} React Query result object:
+ *   - `data`: The status response or undefined if unavailable.
+ *   - `isLoading`: Loading state.
+ *   - `error`: Error instance if the query failed.
+ *   - `refetch`: Function to re-trigger the query.
+ *
+ * @example
+ * const { data: status, isLoading, error } = useBackendSubmitSwapTxStatus({
+ *   params: { txHash: '0x123...', srcChainId: '1' },
+ * });
+ *
+ * if (status?.data.status === 'executed') {
+ *   console.log('Swap completed!', status.data.result);
+ * }
+ *
+ * @remarks
+ * - Query is disabled if `params` is undefined or `txHash` is undefined/empty.
+ * - Default refetch interval is 1 second for real-time status polling.
+ * - Uses React Query for state management, caching, and retries.
+ */
+declare const useBackendSubmitSwapTxStatus: (params: UseBackendSubmitSwapTxStatusParams | undefined) => UseQueryResult<SubmitSwapTxStatusResponse | undefined, Error>;
+
 type UseBackendOrderbookParams = {
     queryOptions?: UseQueryOptions<OrderbookResponse | undefined, Error>;
     pagination?: BackendPaginationParams;
@@ -1837,4 +2008,4 @@ interface SodaxProviderProps {
 }
 declare const SodaxProvider: ({ children, testnet, config, rpcConfig }: SodaxProviderProps) => ReactElement;
 
-export { type BackendPaginationParams, MIGRATION_MODE_BNUSD, MIGRATION_MODE_ICX_SODA, type MigrationIntentParams, type MigrationMode, SodaxProvider, type UseATokenParams, type UseATokensBalancesParams, type UseBorrowParams, type UseMMAllowanceParams, type UseMMApproveParams, type UseRepayParams, type UseReservesDataParams, type UseReservesUsdFormatParams, type UseSupplyParams, type UseUserFormattedSummaryParams, type UseUserReservesDataParams, type UseWithdrawParams, useAToken, useATokensBalances, useBackendAllMoneyMarketAssets, useBackendAllMoneyMarketBorrowers, useBackendIntentByHash, useBackendIntentByTxHash, useBackendMoneyMarketAsset, useBackendMoneyMarketAssetBorrowers, useBackendMoneyMarketAssetSuppliers, useBackendMoneyMarketPosition, useBackendOrderbook, useBackendUserIntents, useBorrow, useBridge, useBridgeAllowance, useBridgeApprove, useCancelLimitOrder, useCancelSwap, useCancelUnstake, useClaim, useConvertedAssets, useCreateLimitOrder, useDeriveUserWalletAddress, useEstimateGas, useGetBridgeableAmount, useGetBridgeableTokens, useGetUserHubWalletAddress, useHubProvider, useInstantUnstake, useInstantUnstakeAllowance, useInstantUnstakeApprove, useInstantUnstakeRatio, useMMAllowance, useMMApprove, useMigrate, useMigrationAllowance, useMigrationApprove, useQuote, useRepay, useRequestTrustline, useReservesData, useReservesUsdFormat, useSodaxContext, useSpokeProvider, useStake, useStakeAllowance, useStakeApprove, useStakeRatio, useStakingConfig, useStakingInfo, useStatus, useStellarTrustlineCheck, useSupply, useSwap, useSwapAllowance, useSwapApprove, useUnstake, useUnstakeAllowance, useUnstakeApprove, useUnstakingInfo, useUnstakingInfoWithPenalty, useUserFormattedSummary, useUserReservesData, useWithdraw };
+export { type BackendPaginationParams, MIGRATION_MODE_BNUSD, MIGRATION_MODE_ICX_SODA, type MigrationIntentParams, type MigrationMode, type RadfiSession, SodaxProvider, type UseATokenParams, type UseATokensBalancesParams, type UseBorrowParams, type UseMMAllowanceParams, type UseMMApproveParams, type UseRadfiSessionReturn, type UseRepayParams, type UseReservesDataParams, type UseReservesUsdFormatParams, type UseSupplyParams, type UseUserFormattedSummaryParams, type UseUserReservesDataParams, type UseWithdrawParams, clearRadfiSession, isAccessTokenExpired, isRefreshTokenExpired, 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, useConvertedAssets, useCreateLimitOrder, useDeriveUserWalletAddress, useEstimateGas, useExpiredUtxos, useFundTradingWallet, useGetBridgeableAmount, useGetBridgeableTokens, useGetUserHubWalletAddress, useHubProvider, useInstantUnstake, useInstantUnstakeAllowance, useInstantUnstakeApprove, useInstantUnstakeRatio, useMMAllowance, useMMApprove, useMigrate, useMigrationAllowance, useMigrationApprove, useQuote, useRadfiAuth, useRadfiSession, useRenewUtxos, useRepay, useRequestTrustline, useReservesData, useReservesUsdFormat, useSodaxContext, useSpokeProvider, useStake, useStakeAllowance, useStakeApprove, useStakeRatio, useStakingConfig, useStakingInfo, useStatus, useStellarTrustlineCheck, useSupply, useSwap, useSwapAllowance, useSwapApprove, useTradingWalletBalance, useUnstake, useUnstakeAllowance, useUnstakeApprove, useUnstakingInfo, useUnstakingInfoWithPenalty, useUserFormattedSummary, useUserReservesData, useWithdraw };