@sodax/dapp-kit 1.3.0-beta → 1.3.1-beta-rc2

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-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 { 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, 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 { Address } from 'viem';
@@ -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];
@@ -1837,4 +1940,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, 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,4 +1,4 @@
-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 { 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, 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 { Address } from 'viem';
@@ -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];
@@ -1837,4 +1940,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, 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.js

@@ -143,6 +143,21 @@ function useSpokeProvider(spokeChainId, walletProvider) {
     if (!spokeChainId) return void 0;
     if (!xChainType) return void 0;
     if (!rpcConfig) return void 0;
+    if (xChainType === "BITCOIN") {
+      const bitcoinConfig = sdk.spokeChainConfig[spokeChainId];
+      const btcRpcOverride = rpcConfig[spokeChainId];
+      return new sdk.BitcoinSpokeProvider(
+        walletProvider,
+        bitcoinConfig,
+        {
+          url: btcRpcOverride?.radfiApiUrl || bitcoinConfig.radfiApiUrl,
+          apiKey: bitcoinConfig.radfiApiKey,
+          umsUrl: btcRpcOverride?.radfiUmsUrl || bitcoinConfig.radfiUmsUrl
+        },
+        "TRADING",
+        btcRpcOverride?.rpcUrl || bitcoinConfig.rpcUrl
+      );
+    }
     if (xChainType === "EVM") {
       if (spokeChainId === sdk.SONIC_MAINNET_CHAIN_ID) {
         return new sdk.SonicSpokeProvider(
@@ -150,9 +165,11 @@ function useSpokeProvider(spokeChainId, walletProvider) {
           sdk.spokeChainConfig[spokeChainId]
         );
       }
+      const evmRpcUrl = rpcConfig[spokeChainId];
       return new sdk.EvmSpokeProvider(
         walletProvider,
-        sdk.spokeChainConfig[spokeChainId]
+        sdk.spokeChainConfig[spokeChainId],
+        typeof evmRpcUrl === "string" ? evmRpcUrl : void 0
       );
     }
     if (xChainType === "SUI") {
@@ -203,6 +220,258 @@ function useSpokeProvider(spokeChainId, walletProvider) {
   }, [spokeChainId, xChainType, walletProvider, rpcConfig]);
   return spokeProvider;
 }
+
+// src/hooks/bitcoin/radfiConstants.ts
+var ACCESS_TOKEN_TTL = 10 * 60 * 1e3;
+var REFRESH_TOKEN_TTL = 7 * 24 * 60 * 60 * 1e3;
+
+// src/hooks/bitcoin/useRadfiAuth.ts
+var SESSION_KEY = (address) => `radfi_session_${address}`;
+function saveRadfiSession(address, session) {
+  try {
+    localStorage.setItem(SESSION_KEY(address), JSON.stringify(session));
+  } catch {
+  }
+}
+function loadRadfiSession(address) {
+  try {
+    const raw = localStorage.getItem(SESSION_KEY(address));
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    return null;
+  }
+}
+function clearRadfiSession(address) {
+  try {
+    localStorage.removeItem(SESSION_KEY(address));
+  } catch {
+  }
+}
+function isAccessTokenExpired(address) {
+  const session = loadRadfiSession(address);
+  if (!session) return true;
+  return Date.now() >= session.accessTokenExpiry;
+}
+function isRefreshTokenExpired(address) {
+  const session = loadRadfiSession(address);
+  if (!session) return true;
+  return Date.now() >= session.refreshTokenExpiry;
+}
+function useRadfiAuth(spokeProvider) {
+  return reactQuery.useMutation({
+    mutationFn: async () => {
+      if (!spokeProvider) {
+        throw new Error("Bitcoin spoke provider not found");
+      }
+      const walletAddress = await spokeProvider.walletProvider.getWalletAddress();
+      const existingSession = loadRadfiSession(walletAddress);
+      const cachedPublicKey = existingSession?.publicKey;
+      try {
+        const { accessToken, refreshToken, tradingAddress, publicKey } = await spokeProvider.authenticateWithWallet(cachedPublicKey);
+        const session = {
+          accessToken,
+          refreshToken,
+          tradingAddress,
+          publicKey,
+          accessTokenExpiry: Date.now() + ACCESS_TOKEN_TTL,
+          refreshTokenExpiry: Date.now() + REFRESH_TOKEN_TTL
+        };
+        saveRadfiSession(walletAddress, session);
+        return { accessToken, refreshToken, tradingAddress };
+      } catch (err) {
+        const isAlreadyRegistered = err instanceof Error && (err.message.includes("duplicatedPubKey") || err.message.includes("4008"));
+        if (isAlreadyRegistered) {
+          if (existingSession && !isRefreshTokenExpired(walletAddress)) {
+            const refreshed = await spokeProvider.radfi.refreshAccessToken(existingSession.refreshToken);
+            const session = {
+              ...existingSession,
+              accessToken: refreshed.accessToken,
+              refreshToken: refreshed.refreshToken,
+              accessTokenExpiry: Date.now() + ACCESS_TOKEN_TTL,
+              refreshTokenExpiry: Date.now() + REFRESH_TOKEN_TTL
+            };
+            spokeProvider.setRadfiAccessToken(refreshed.accessToken);
+            saveRadfiSession(walletAddress, session);
+            return { accessToken: refreshed.accessToken, refreshToken: refreshed.refreshToken, tradingAddress: existingSession.tradingAddress };
+          }
+          throw new Error(
+            "This wallet is already registered with Radfi from another session. Please clear your browser storage for this site and try again, or wait for the previous session to expire."
+          );
+        }
+        throw err;
+      }
+    }
+  });
+}
+var POLL_INTERVAL = 3e4;
+function useRadfiSession(spokeProvider) {
+  const [walletAddress, setWalletAddress] = React.useState();
+  const [isAuthed, setIsAuthed] = React.useState(false);
+  const [tradingAddress, setTradingAddress] = React.useState();
+  const isRefreshingRef = React.useRef(false);
+  const silentRefresh = React.useCallback(async (address) => {
+    if (!spokeProvider || isRefreshingRef.current) return;
+    isRefreshingRef.current = true;
+    try {
+      const session = loadRadfiSession(address);
+      if (!session?.refreshToken) {
+        setIsAuthed(false);
+        return;
+      }
+      const { accessToken, refreshToken } = await spokeProvider.radfi.refreshAccessToken(session.refreshToken);
+      const updated = {
+        ...session,
+        accessToken,
+        refreshToken,
+        accessTokenExpiry: Date.now() + ACCESS_TOKEN_TTL
+        // Keep the original refreshTokenExpiry — don't roll it forward on every silent refresh
+      };
+      saveRadfiSession(address, updated);
+      spokeProvider.setRadfiAccessToken(accessToken);
+      setIsAuthed(true);
+      setTradingAddress(updated.tradingAddress || void 0);
+    } catch {
+      clearRadfiSession(address);
+      spokeProvider.setRadfiAccessToken("");
+      setIsAuthed(false);
+      setTradingAddress(void 0);
+    } finally {
+      isRefreshingRef.current = false;
+    }
+  }, [spokeProvider]);
+  React.useEffect(() => {
+    if (!spokeProvider) return;
+    const fetchAndRestore = () => {
+      spokeProvider.walletProvider.getWalletAddress().then((addr) => {
+        setWalletAddress(addr);
+        const session = loadRadfiSession(addr);
+        if (!session || isRefreshTokenExpired(addr)) return;
+        if (!isAccessTokenExpired(addr)) {
+          spokeProvider.setRadfiAccessToken(session.accessToken);
+          setIsAuthed(true);
+          setTradingAddress(session.tradingAddress || void 0);
+        } else {
+          silentRefresh(addr);
+        }
+      }).catch(() => {
+      });
+    };
+    fetchAndRestore();
+    const id = setInterval(fetchAndRestore, 3e3);
+    return () => clearInterval(id);
+  }, [spokeProvider, silentRefresh]);
+  React.useEffect(() => {
+    if (!walletAddress || !spokeProvider) return;
+    const id = setInterval(() => {
+      if (isRefreshTokenExpired(walletAddress)) {
+        clearRadfiSession(walletAddress);
+        spokeProvider.setRadfiAccessToken("");
+        setIsAuthed(false);
+        setTradingAddress(void 0);
+        return;
+      }
+      if (isAccessTokenExpired(walletAddress)) {
+        silentRefresh(walletAddress);
+      }
+    }, POLL_INTERVAL);
+    return () => clearInterval(id);
+  }, [walletAddress, spokeProvider, silentRefresh]);
+  const { mutateAsync: loginMutate, isPending: isLoginPending } = useRadfiAuth(spokeProvider);
+  const login = React.useCallback(async () => {
+    const result = await loginMutate();
+    setIsAuthed(true);
+    setTradingAddress(result.tradingAddress || void 0);
+  }, [loginMutate]);
+  return { walletAddress, isAuthed, tradingAddress, login, isLoginPending };
+}
+function useFundTradingWallet(spokeProvider) {
+  const queryClient = reactQuery.useQueryClient();
+  return reactQuery.useMutation({
+    mutationFn: async (amount) => {
+      if (!spokeProvider) {
+        throw new Error("Bitcoin spoke provider not found");
+      }
+      return sdk.BitcoinSpokeService.fundTradingWallet(amount, spokeProvider);
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["btc-balance"] });
+      queryClient.invalidateQueries({ queryKey: ["xBalances"] });
+    }
+  });
+}
+function useBitcoinBalance(address, rpcUrl = "https://mempool.space/api") {
+  return reactQuery.useQuery({
+    queryKey: ["btc-balance", address],
+    queryFn: async () => {
+      if (!address) return 0n;
+      const response = await fetch(`${rpcUrl}/address/${address}/utxo`);
+      if (!response.ok) return 0n;
+      const utxos = await response.json();
+      return BigInt(utxos.reduce((sum, utxo) => sum + utxo.value, 0));
+    },
+    enabled: !!address
+  });
+}
+function useTradingWalletBalance(spokeProvider, tradingAddress) {
+  return reactQuery.useQuery({
+    queryKey: ["trading-wallet-balance", tradingAddress],
+    queryFn: () => {
+      if (!spokeProvider || !tradingAddress) {
+        throw new Error("spokeProvider and tradingAddress are required");
+      }
+      return spokeProvider.radfi.getBalance(tradingAddress);
+    },
+    enabled: !!spokeProvider && !!tradingAddress
+  });
+}
+function useExpiredUtxos(spokeProvider, tradingAddress) {
+  return reactQuery.useQuery({
+    queryKey: ["expired-utxos", tradingAddress],
+    queryFn: async () => {
+      if (!spokeProvider || !tradingAddress) {
+        throw new Error("spokeProvider and tradingAddress are required");
+      }
+      const result = await spokeProvider.radfi.getExpiredUtxos(tradingAddress);
+      return result.data;
+    },
+    enabled: !!spokeProvider && !!tradingAddress,
+    refetchInterval: 6e4
+    // refetch every minute
+  });
+}
+function useRenewUtxos(spokeProvider) {
+  const queryClient = reactQuery.useQueryClient();
+  return reactQuery.useMutation({
+    mutationFn: async ({ txIdVouts }) => {
+      if (!spokeProvider) {
+        throw new Error("Bitcoin spoke provider not found");
+      }
+      const userAddress = await spokeProvider.walletProvider.getWalletAddress();
+      const session = loadRadfiSession(userAddress);
+      const accessToken = session?.accessToken || spokeProvider.radfiAccessToken;
+      if (!accessToken) {
+        throw new Error("Radfi authentication required. Please login first.");
+      }
+      const buildResult = await spokeProvider.radfi.buildRenewUtxoTransaction(
+        { userAddress, txIdVouts },
+        accessToken
+      );
+      const signedTx = await spokeProvider.walletProvider.signTransaction(
+        buildResult.base64Psbt,
+        false
+      );
+      const signedBase64Tx = sdk.normalizePsbtToBase64(signedTx);
+      return spokeProvider.radfi.signAndBroadcastRenewUtxo(
+        { userAddress, signedBase64Tx },
+        accessToken
+      );
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["expired-utxos"] });
+      queryClient.invalidateQueries({ queryKey: ["trading-wallet-balance"] });
+    }
+  });
+}
 function useBorrow() {
   const { sodax } = useSodaxContext();
   return reactQuery.useMutation({
@@ -324,8 +593,22 @@ function useMMAllowance({
   const { sodax } = useSodaxContext();
   const defaultQueryOptions = {
     queryKey: ["mm", "allowance", params?.token, params?.action],
-    enabled: !!spokeProvider,
-    refetchInterval: 5e3
+    /**
+     * IMPORTANT: Skip allowance checks for 'borrow' and 'withdraw' actions.
+     *
+     * Reason: According to the SDK's MoneyMarketService.isAllowanceValid() implementation,
+     * borrow and withdraw actions do NOT require ERC-20 token approval. The SDK's
+     * isAllowanceValid() method always returns `true` for these actions without making
+     * any on-chain allowance checks.
+     *
+     * This optimization prevents unnecessary RPC calls and avoids showing confusing states for actions that don't actually need approval.
+     *
+     * Only 'supply' and 'repay' actions require token approval and should trigger allowance checks.
+     */
+    enabled: !!spokeProvider && !!params && params.action !== "borrow" && params.action !== "withdraw",
+    refetchInterval: 5e3,
+    gcTime: 0
+    // Don't cache failed queries
   };
   queryOptions = {
     ...defaultQueryOptions,
@@ -337,6 +620,9 @@ function useMMAllowance({
     queryFn: async () => {
       if (!spokeProvider) throw new Error("Spoke provider is required");
       if (!params) throw new Error("Params are required");
+      if (params.action === "borrow" || params.action === "withdraw") {
+        return true;
+      }
       const allowance = await sodax.moneyMarket.isAllowanceValid(params, spokeProvider);
       if (!allowance.ok) {
         throw allowance.error;
@@ -1176,11 +1462,9 @@ function useInstantUnstakeRatio(amount, refetchInterval = 1e4) {
 }
 function useConvertedAssets(amount, refetchInterval = 1e4) {
   const { sodax } = useSodaxContext();
-  console.log("useConvertedAssets hook called with:", { amount: amount?.toString(), sodax: !!sodax });
   return reactQuery.useQuery({
     queryKey: ["soda", "convertedAssets", amount?.toString()],
     queryFn: async () => {
-      console.log("useConvertedAssets queryFn called with amount:", amount?.toString());
       if (!amount || amount <= 0n) {
         throw new Error("Amount must be greater than 0");
       }
@@ -1504,6 +1788,11 @@ var SodaxProvider = ({ children, testnet = false, config, rpcConfig }) => {
 exports.MIGRATION_MODE_BNUSD = MIGRATION_MODE_BNUSD;
 exports.MIGRATION_MODE_ICX_SODA = MIGRATION_MODE_ICX_SODA;
 exports.SodaxProvider = SodaxProvider;
+exports.clearRadfiSession = clearRadfiSession;
+exports.isAccessTokenExpired = isAccessTokenExpired;
+exports.isRefreshTokenExpired = isRefreshTokenExpired;
+exports.loadRadfiSession = loadRadfiSession;
+exports.saveRadfiSession = saveRadfiSession;
 exports.useAToken = useAToken;
 exports.useATokensBalances = useATokensBalances;
 exports.useBackendAllMoneyMarketAssets = useBackendAllMoneyMarketAssets;
@@ -1516,6 +1805,7 @@ exports.useBackendMoneyMarketAssetSuppliers = useBackendMoneyMarketAssetSupplier
 exports.useBackendMoneyMarketPosition = useBackendMoneyMarketPosition;
 exports.useBackendOrderbook = useBackendOrderbook;
 exports.useBackendUserIntents = useBackendUserIntents;
+exports.useBitcoinBalance = useBitcoinBalance;
 exports.useBorrow = useBorrow;
 exports.useBridge = useBridge;
 exports.useBridgeAllowance = useBridgeAllowance;
@@ -1528,6 +1818,8 @@ exports.useConvertedAssets = useConvertedAssets;
 exports.useCreateLimitOrder = useCreateLimitOrder;
 exports.useDeriveUserWalletAddress = useDeriveUserWalletAddress;
 exports.useEstimateGas = useEstimateGas;
+exports.useExpiredUtxos = useExpiredUtxos;
+exports.useFundTradingWallet = useFundTradingWallet;
 exports.useGetBridgeableAmount = useGetBridgeableAmount;
 exports.useGetBridgeableTokens = useGetBridgeableTokens;
 exports.useGetUserHubWalletAddress = useGetUserHubWalletAddress;
@@ -1542,6 +1834,9 @@ exports.useMigrate = useMigrate;
 exports.useMigrationAllowance = useMigrationAllowance;
 exports.useMigrationApprove = useMigrationApprove;
 exports.useQuote = useQuote;
+exports.useRadfiAuth = useRadfiAuth;
+exports.useRadfiSession = useRadfiSession;
+exports.useRenewUtxos = useRenewUtxos;
 exports.useRepay = useRepay;
 exports.useRequestTrustline = useRequestTrustline;
 exports.useReservesData = useReservesData;
@@ -1560,6 +1855,7 @@ exports.useSupply = useSupply;
 exports.useSwap = useSwap;
 exports.useSwapAllowance = useSwapAllowance;
 exports.useSwapApprove = useSwapApprove;
+exports.useTradingWalletBalance = useTradingWalletBalance;
 exports.useUnstake = useUnstake;
 exports.useUnstakeAllowance = useUnstakeAllowance;
 exports.useUnstakeApprove = useUnstakeApprove;