@unifold/ui-react 0.1.79 → 0.1.80

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { DirectExecutionSucceededEvent, DirectExecutionFailedEvent, DirectExecutionResponse, ChainType, EvmContractCall, DepositMethod, DepositEvent, Wallet, ProductType, WalletPayMethod, CoinbaseWalletPaySessionResponse, FiatCurrency, ExecutionStatus, FeaturedToken, PaymentNetwork, DefaultTokenResponse, ConfirmIntegrationTransferResult, CheckoutMethod, CheckoutPaymentIntent, CheckoutEvent, WithdrawDirectExecutionSucceededEvent, WithdrawEvent, DestinationToken, DestinationTokenChain, PaymentIntent, DepositQuote, PublicIncidentResponse, WithdrawDirectExecutionFailedEvent, SupportedDestinationTokensResponse, SupportedDepositTokensResponse, VerifyAddressResponse } from '@unifold/core';
+import { DirectExecutionSucceededEvent, DirectExecutionFailedEvent, DirectExecutionResponse, ChainType, EvmContractCall, DepositMethod, DepositEvent, Wallet, ProductType, WalletPayMethod, CoinbaseWalletPaySessionResponse, FiatCurrency, ExecutionStatus, FeaturedToken, PaymentNetwork, DefaultTokenResponse, ConfirmIntegrationTransferResult, CheckoutMethod, CheckoutPaymentIntent, CheckoutEvent, WithdrawDirectExecutionSucceededEvent, WithdrawEvent, DestinationToken, DestinationTokenChain, PaymentIntent, DepositQuote, PublicIncidentResponse, WithdrawDirectExecutionFailedEvent, ActionType, SupportedDestinationTokensResponse, SupportedDepositTokensResponse, VerifyAddressResponse } from '@unifold/core';
 export { ChainType, DepositMethod } from '@unifold/core';
 import * as React$1 from 'react';
 import { MutableRefObject } from 'react';
@@ -289,7 +289,7 @@ interface DepositModalProps {
     applePayTitle?: string;
     /**
      * Subtitle shown for the Apple Pay row in the main menu.
-     * @default `"Instant"` (localized from `depositModal.applePayMenu.subtitle`)
+     * @default `"Instant • Debit card only"` (localized from `depositModal.applePayMenu.subtitle`)
      */
     applePaySubTitle?: string;
     /**
@@ -306,7 +306,7 @@ interface DepositModalProps {
     googlePayTitle?: string;
     /**
      * Subtitle shown for the Google Pay row in the main menu.
-     * @default `"Instant"` (localized from `depositModal.googlePayMenu.subtitle`)
+     * @default `"Instant • Debit card only"` (localized from `depositModal.googlePayMenu.subtitle`)
      */
     googlePaySubTitle?: string;
     /**
@@ -1119,7 +1119,15 @@ interface WithdrawTransactionInfo {
     amount: string;
     /** Token amount in base units (smallest denomination). */
     amountBaseUnit: string;
-    /** The Unifold deposit wallet address to send funds to */
+    /**
+     * The Unifold deposit wallet address to send funds to.
+     *
+     * Normally on `sourceChainType`. Withdrawing off a chain Unifold can't monitor
+     * (N1) instead gives an address on the chain the funds have to be bridged to
+     * first — for N1 that's Solana, which shares N1's address format, so the two
+     * are indistinguishable by inspection. Send there and Unifold routes the funds
+     * on to `recipientAddress`.
+     */
     withdrawIntentAddress: string;
     /** The user-provided final destination address */
     recipientAddress: string;
@@ -1145,6 +1153,24 @@ interface WithdrawModalProps {
     sourceTokenSymbol?: string;
     recipientAddress?: string;
     senderAddress: string;
+    /**
+     * Sender token balance in smallest units (e.g. `"1500000"` for 1.5 USDC).
+     * When provided, skips `/addresses/balance` and is the source of truth for
+     * max withdraw, over-balance checks, and amount conversion.
+     */
+    balanceInBaseUnit?: string;
+    /**
+     * USD value of {@link WithdrawModalProps.balanceInBaseUnit}. When provided,
+     * used for fiat display, max, and crypto↔USD conversion. When omitted, the
+     * modal prices the token (stablecoins assume $1) to compute USD.
+     */
+    balanceUsd?: string | number;
+    /**
+     * Source token decimals (e.g. `6` for USDC). Used with `balanceInBaseUnit`
+     * to format the human amount without waiting on the token catalog. Falls
+     * back to catalog decimals when omitted.
+     */
+    sourceTokenDecimals?: number;
     /**
      * Pre-select the destination (receive) token/chain in the withdraw view.
      * All four props are optional. To match a specific token, provide `chainType` + `chainId` + (`symbol` OR `tokenAddress`).
@@ -1173,7 +1199,7 @@ interface WithdrawModalProps {
     theme?: 'light' | 'dark' | 'auto';
     hideOverlay?: boolean;
 }
-declare function WithdrawModal({ open, onOpenChange, publishableKey, modalTitle, externalUserId, sourceChainType, sourceChainId, sourceTokenAddress, sourceTokenSymbol, recipientAddress: recipientAddressProp, senderAddress, defaultDestinationChainType, defaultDestinationChainId, defaultDestinationTokenAddress, defaultDestinationSymbol, onWithdraw, onWithdrawSuccess, onWithdrawError, onEvent, theme, hideOverlay, }: WithdrawModalProps): react_jsx_runtime.JSX.Element;
+declare function WithdrawModal({ open, onOpenChange, publishableKey, modalTitle, externalUserId, sourceChainType, sourceChainId, sourceTokenAddress, sourceTokenSymbol, recipientAddress: recipientAddressProp, senderAddress, balanceInBaseUnit, balanceUsd, sourceTokenDecimals, defaultDestinationChainType, defaultDestinationChainId, defaultDestinationTokenAddress, defaultDestinationSymbol, onWithdraw, onWithdrawSuccess, onWithdrawError, onEvent, theme, hideOverlay, }: WithdrawModalProps): react_jsx_runtime.JSX.Element;
 
 interface WithdrawTokenSelectorProps {
     tokens: DestinationToken[];
@@ -1192,7 +1218,11 @@ interface WithdrawDoubleInputProps {
 }
 declare function WithdrawDoubleInput({ tokens, selectedTokenSymbol, selectedChainKey, onTokenChange, onChainChange, isLoading, }: WithdrawDoubleInputProps): react_jsx_runtime.JSX.Element;
 
-interface AddressBalanceResult {
+/**
+ * Token amount helpers: base-unit ↔ human formatting, host-supplied
+ * balance/decimals parsing, and proportional base-unit scaling.
+ */
+interface TokenBalance {
     balanceBaseUnit: string;
     balanceHuman: string;
     balanceUsd: string | null;
@@ -1200,6 +1230,8 @@ interface AddressBalanceResult {
     decimals: number;
     symbol: string;
 }
+
+type AddressBalanceResult = TokenBalance;
 /**
  * Hook to fetch a token balance for a given address.
  * Uses React Query for caching and deduplication.
@@ -1211,7 +1243,7 @@ declare function useAddressBalance(params: {
     tokenAddress?: string;
     publishableKey: string;
     enabled?: boolean;
-}): _tanstack_react_query.UseQueryResult<AddressBalanceResult | null, Error>;
+}): _tanstack_react_query.UseQueryResult<TokenBalance | null, Error>;
 
 interface WithdrawFormProps {
     publishableKey: string;
@@ -1271,8 +1303,14 @@ interface WithdrawConfirmingViewProps {
     executions: DirectExecutionResponse[];
     onClose: () => void;
     onViewTracker: () => void;
+    /**
+     * Seconds until the funds are expected to land. Worth surfacing while the
+     * spinner is up because a bridged withdrawal (N1) takes about an hour, and
+     * without a number the user has no way to tell that from a stuck transfer.
+     */
+    estimatedProcessingTime?: number | null;
 }
-declare function WithdrawConfirmingView({ txInfo, executions, onClose, onViewTracker, }: WithdrawConfirmingViewProps): react_jsx_runtime.JSX.Element;
+declare function WithdrawConfirmingView({ txInfo, executions, onClose, onViewTracker, estimatedProcessingTime, }: WithdrawConfirmingViewProps): react_jsx_runtime.JSX.Element;
 
 declare const HYPERCORE_CHAIN_ID = "1337";
 
@@ -1434,7 +1472,8 @@ var common = {
 	balance: "Balance: {{amount}}",
 	balanceWithProject: "{{projectName}} Balance: {{amount}}",
 	balanceWithToken: "Balance: {{amount}} ({{tokenAmount}})",
-	amountDue: "Amount due: {{amount}}"
+	amountDue: "Amount due: {{amount}}",
+	back: "Back"
 };
 var executionDetails = {
 	processing: "Processing",
@@ -1522,6 +1561,32 @@ var connectWallet = {
 	connectFailed: "Failed to connect wallet",
 	transactionFailed: "Transaction failed"
 };
+var walletErrors = {
+	insufficientGas: "You don't have enough to cover the network fee.",
+	insufficientBalance: "Not enough balance for this transaction.",
+	activationFeeRequired: "This transfer is too small to cover the one-time activation fee.",
+	nonceConflict: "A previous transaction is still pending. Wait for it to finish, then try again.",
+	gasTooLow: "The network fee was set too low. Raise it in your wallet and try again.",
+	reverted: "The network rejected the transaction.",
+	networkNotAdded: "That network isn't set up in your wallet. Add it, then try again.",
+	networkSwitchDeclined: "Switch to the right network in your wallet to continue.",
+	wrongNetwork: "Your wallet is on the wrong network. Switch it, then try again.",
+	requestPending: "Your wallet already has a request open. Finish it there, then try again.",
+	walletNotFound: "We couldn't reach your wallet. Make sure it's installed and unlocked.",
+	noAccounts: "No account was shared. Unlock your wallet and try again.",
+	invalidRecipient: "That deposit address looks wrong. Contact support before retrying.",
+	noDepositAddress: "No deposit address is available for that network. Try a different wallet.",
+	rpcUnavailable: "The network is unreachable right now. Try again in a moment.",
+	walletLocked: "Unlock your wallet and try again.",
+	unsupportedMethod: "Your wallet doesn't support this action. Try a different wallet.",
+	chainDisconnected: "Your wallet is disconnected. Reconnect it and try again.",
+	chainDisconnectedNetwork: "Your wallet is disconnected from this network. Reconnect and try again.",
+	walletRejectedTransaction: "Your wallet rejected the transaction.",
+	connectDeclined: "Connection declined.",
+	signatureDeclined: "Signature declined.",
+	connectFailed: "Connection failed.",
+	transactionFailed: "Transaction failed."
+};
 var transferCrypto = {
 	priceImpact: {
 		label: "Price impact",
@@ -1596,7 +1661,8 @@ var transferCrypto = {
 		},
 		defaultError: "The recipient address cannot receive funds for the selected token"
 	},
-	selectNetworkPlaceholder: "Select network"
+	selectNetworkPlaceholder: "Select network",
+	recipientAddress: "Recipient address"
 };
 var glossary = {
 	title: "Glossary",
@@ -1633,13 +1699,14 @@ var depositModal = {
 	},
 	stripeLink: {
 		title: "Pay with Link",
-		subtitle: "Buy with card or bank",
+		subtitle: "Buy with debit or credit card",
 		unavailableInRegionMessage: "Pay with Link is currently unavailable in your region."
 	},
 	browserWallet: {
 		title: "Connect Wallet",
 		subtitle: "Deposit from your wallet",
-		disconnect: "Disconnect"
+		disconnect: "Disconnect",
+		balanceWithInstant: "${{balance}} • Instant"
 	},
 	cashApp: {
 		creatingOrder: "Creating order...",
@@ -1665,11 +1732,11 @@ var depositModal = {
 	},
 	applePayMenu: {
 		title: "Pay with Apple Pay",
-		subtitle: "Instant"
+		subtitle: "Instant • Debit card only"
 	},
 	googlePayMenu: {
 		title: "Pay with Google Pay",
-		subtitle: "Instant"
+		subtitle: "Instant • Debit card only"
 	},
 	cardMethodName: "Card",
 	applePayMethodName: "Apple Pay",
@@ -1750,7 +1817,13 @@ var payWithExchange = {
 	completeTransaction: "Complete transfer with {{provider}}",
 	canCloseModal: "You can close this modal.",
 	reopenExchange: "Reopen exchange window",
-	walletOrTokenUnavailable: "Wallet address or token information not available"
+	walletOrTokenUnavailable: "Wallet address or token information not available",
+	creatingOrder: "Creating order...",
+	tokenUnavailable: "Token information not available",
+	walletUnavailable: "Wallet address not available",
+	enterAmountToTransfer: "Enter an amount to transfer",
+	createSessionFailed: "Failed to create transfer session",
+	transferFailed: "Transfer failed"
 };
 var connectExchange = {
 	title: "Connect Exchange",
@@ -1833,7 +1906,20 @@ var connectExchange = {
 	errors: {
 		oauthStartFailed: "Failed to start OAuth",
 		createTransferFailed: "Failed to create transfer",
-		transferFailed: "Transfer failed"
+		transferFailed: "Transfer failed",
+		noDepositWallet: "No deposit wallet available",
+		noDepositWalletForNetwork: "No deposit wallet available for the {{network}} network",
+		paymentFailed: "Payment failed",
+		createSessionFailed: "Failed to create exchange transfer session",
+		transferDetailsNotReady: "Transfer details not ready. Please try again.",
+		sessionExpired: "Session expired. Please reconnect your exchange."
+	},
+	transferFrom: "Transfer from {{exchange}}",
+	redirect: {
+		paymentReceived: "Payment received",
+		paymentProcessing: "Payment processing",
+		converting: "Converting to your destination token...",
+		confirmingPayment: "Your {{exchange}} payment is being confirmed..."
 	}
 };
 var buyWithCard = {
@@ -1858,7 +1944,9 @@ var buyWithCard = {
 		bankTransferWalletUnavailable: "Wallet address not available for bank transfer"
 	},
 	refreshingIn: "Refreshing in {{seconds}}s",
-	estimatedDeliveryTime: "Estimated delivery time: {{time}}"
+	estimatedDeliveryTime: "Estimated delivery time: {{time}}",
+	thisToken: "this token",
+	destinationNotStablecoin: "Buying a fixed amount with card is only available for stablecoins (e.g. USDC, USDT). {{token}} isn't supported for this option."
 };
 var buyWithApplePay = {
 	email: {
@@ -1877,7 +1965,8 @@ var buyWithApplePay = {
 		placeholder: "000000",
 		incorrect: "Incorrect code. Please try again.",
 		resend: "Resend code",
-		resendIn: "Resend in {{seconds}}s"
+		resendIn: "Resend in {{seconds}}s",
+		verify: "Verify"
 	},
 	amount: {
 		enterAmount: "Enter amount",
@@ -2173,7 +2262,8 @@ var withdrawModal = {
 		history: "Withdrawal History",
 		status: "Withdrawal Status",
 		checking: "Checking Withdrawal",
-		empty: "No withdrawals to track yet"
+		empty: "No withdrawals to track yet",
+		estimatedTime: "Estimated delivery time: {{time}}. You can close this and check back later."
 	},
 	executionItem: {
 		processing: "Withdrawal processing",
@@ -2197,6 +2287,7 @@ var en = {
 	executionDetails: executionDetails,
 	depositTracker: depositTracker,
 	connectWallet: connectWallet,
+	walletErrors: walletErrors,
 	transferCrypto: transferCrypto,
 	glossary: glossary,
 	depositModal: depositModal,
@@ -2217,14 +2308,20 @@ var en = {
  */
 type I18nStrings = typeof en;
 /**
- * Canonical locale codes we ship a translation table for.
+ * Canonical locale codes we ship a translation table for. Codes follow Stripe's
+ * style: language-only unless a region split is required (`zh` vs `zh-TW`).
+ * - `en`    → English
  * - `zh`    → Simplified Chinese (Mainland China, Singapore)
  * - `zh-TW` → Traditional Chinese (Taiwan, Hong Kong, Macau)
+ * - `fr`    → French (France)
+ * - `th`    → Thai (Thailand)
+ * - `ja`    → Japanese (Japan)
+ * - `ko`    → Korean (South Korea)
  *
- * Callers may pass any BCP-47 tag (e.g. `zh-CN`, `zh-HK`, `zh-Hant-TW`); it is
+ * Callers may pass any BCP-47 tag (e.g. `zh-CN`, `fr-FR`, `ja-JP`); it is
  * mapped onto one of these via `normalizeLocale`.
  */
-type LocaleCode = 'en' | 'zh' | 'zh-TW';
+type LocaleCode = 'en' | 'zh' | 'zh-TW' | 'fr' | 'th' | 'ja' | 'ko';
 /** Locales with a bundled translation table. */
 declare const SUPPORTED_LOCALES: LocaleCode[];
 /**
@@ -2273,6 +2370,7 @@ declare const i18n: {
         balanceWithProject: string;
         balanceWithToken: string;
         amountDue: string;
+        back: string;
     };
     executionDetails: {
         processing: string;
@@ -2360,6 +2458,32 @@ declare const i18n: {
         connectFailed: string;
         transactionFailed: string;
     };
+    walletErrors: {
+        insufficientGas: string;
+        insufficientBalance: string;
+        activationFeeRequired: string;
+        nonceConflict: string;
+        gasTooLow: string;
+        reverted: string;
+        networkNotAdded: string;
+        networkSwitchDeclined: string;
+        wrongNetwork: string;
+        requestPending: string;
+        walletNotFound: string;
+        noAccounts: string;
+        invalidRecipient: string;
+        noDepositAddress: string;
+        rpcUnavailable: string;
+        walletLocked: string;
+        unsupportedMethod: string;
+        chainDisconnected: string;
+        chainDisconnectedNetwork: string;
+        walletRejectedTransaction: string;
+        connectDeclined: string;
+        signatureDeclined: string;
+        connectFailed: string;
+        transactionFailed: string;
+    };
     transferCrypto: {
         priceImpact: {
             label: string;
@@ -2435,6 +2559,7 @@ declare const i18n: {
             defaultError: string;
         };
         selectNetworkPlaceholder: string;
+        recipientAddress: string;
     };
     glossary: {
         title: string;
@@ -2478,6 +2603,7 @@ declare const i18n: {
             title: string;
             subtitle: string;
             disconnect: string;
+            balanceWithInstant: string;
         };
         cashApp: {
             creatingOrder: string;
@@ -2589,6 +2715,12 @@ declare const i18n: {
         canCloseModal: string;
         reopenExchange: string;
         walletOrTokenUnavailable: string;
+        creatingOrder: string;
+        tokenUnavailable: string;
+        walletUnavailable: string;
+        enterAmountToTransfer: string;
+        createSessionFailed: string;
+        transferFailed: string;
     };
     connectExchange: {
         title: string;
@@ -2672,6 +2804,19 @@ declare const i18n: {
             oauthStartFailed: string;
             createTransferFailed: string;
             transferFailed: string;
+            noDepositWallet: string;
+            noDepositWalletForNetwork: string;
+            paymentFailed: string;
+            createSessionFailed: string;
+            transferDetailsNotReady: string;
+            sessionExpired: string;
+        };
+        transferFrom: string;
+        redirect: {
+            paymentReceived: string;
+            paymentProcessing: string;
+            converting: string;
+            confirmingPayment: string;
         };
     };
     buyWithCard: {
@@ -2697,6 +2842,8 @@ declare const i18n: {
         };
         refreshingIn: string;
         estimatedDeliveryTime: string;
+        thisToken: string;
+        destinationNotStablecoin: string;
     };
     buyWithApplePay: {
         email: {
@@ -2716,6 +2863,7 @@ declare const i18n: {
             incorrect: string;
             resend: string;
             resendIn: string;
+            verify: string;
         };
         amount: {
             enterAmount: string;
@@ -3012,6 +3160,7 @@ declare const i18n: {
             status: string;
             checking: string;
             empty: string;
+            estimatedTime: string;
         };
         executionItem: {
             processing: string;
@@ -3045,18 +3194,21 @@ declare function interpolate(template: string, params?: Record<string, string |
  *
  * Chinese is resolved by script rather than a single region: any Traditional
  * signal (script `Hant`, or region TW/HK/MO) maps to `zh-TW` (Traditional);
- * every other `zh` tag maps to `zh` (Simplified).
+ * every other `zh` tag maps to `zh` (Simplified). Other languages collapse to
+ * their language-only Stripe-style code (`fr-FR` → `fr`, `ja-JP` → `ja`).
  *
  * @example normalizeLocale("zh-CN")      // "zh"    (Simplified)
  * @example normalizeLocale("zh-TW")      // "zh-TW" (Traditional)
  * @example normalizeLocale("zh-HK")      // "zh-TW" (Traditional)
  * @example normalizeLocale("zh-Hant-TW") // "zh-TW" (Traditional)
+ * @example normalizeLocale("fr-FR")      // "fr"
+ * @example normalizeLocale("ja-JP")      // "ja"
  * @example normalizeLocale("en_US")      // "en"
  */
 declare function normalizeLocale(tag?: string | null): LocaleCode;
 /**
  * Best-effort browser locale detection. Walks `navigator.languages` in the
- * user's own order and takes the first language we ship, so `["fr", "zh-TW"]`
+ * user's own order and takes the first language we ship, so `["de", "zh-TW"]`
  * resolves to `zh-TW` while `["en-US", "zh-CN"]` stays English. Returns "en"
  * during SSR or when nothing matches.
  */
@@ -3080,8 +3232,8 @@ interface I18nContextValue {
 interface I18nProviderProps {
     children: React$1.ReactNode;
     /**
-     * Locale tag (e.g. "zh", "zh-CN", "en-US"). When omitted, the browser locale
-     * is auto-detected. Unsupported locales fall back to English.
+     * Locale tag (e.g. "zh", "zh-CN", "fr", "ja-JP", "en-US"). When omitted, the
+     * browser locale is auto-detected. Unsupported locales fall back to English.
      */
     locale?: string;
 }
@@ -3183,7 +3335,19 @@ interface UseDepositQuoteParams {
     sourceChainType: string;
     sourceChainId: string;
     sourceTokenAddress: string;
-    destinationAmount: string;
+    /**
+     * Exact-in: how much the user will send. Mutually exclusive with
+     * `destinationAmount` — provide exactly one.
+     */
+    sourceAmount?: string;
+    /**
+     * Exact-out: how much the recipient should receive. Mutually exclusive with
+     * `sourceAmount` — provide exactly one.
+     *
+     * Checkout (CheckoutModal / WalletConnect / BrowserWalletModal) only sends
+     * this field. Omitting `sourceAmount` keeps that historic path.
+     */
+    destinationAmount?: string;
     destinationChainType: string;
     destinationChainId: string;
     destinationTokenAddress: string;
@@ -3196,8 +3360,10 @@ interface UseDepositQuoteParams {
 /**
  * Hook to fetch a deposit quote via react-query.
  *
- * Returns the estimated source token amount needed to receive a specific
- * destination amount, accounting for bridge fees and slippage.
+ * Exact-out (`destinationAmount`): estimated source token needed to receive
+ * that destination amount. Exact-in (`sourceAmount`): estimated destination
+ * amount received for that source amount. The response includes the project's
+ * platform fee from billing (`platform_fee_percent`).
  * Server-side cached for 1 minute; client re-fetches on param change.
  */
 declare function useDepositQuote(params: UseDepositQuoteParams): _tanstack_react_query.UseQueryResult<DepositQuote, Error>;
@@ -3237,14 +3403,24 @@ interface UseWithdrawPollingResult {
 }
 declare function useWithdrawPolling({ userId, publishableKey, depositWalletId, enabled, onWithdrawSuccess, onWithdrawError, }: UseWithdrawPollingOptions): UseWithdrawPollingResult;
 
+interface UseSupportedDestinationTokensOptions {
+    /** Which surface the list is for; only read by the API alongside `sourceChainType`. */
+    actionType?: ActionType;
+    /**
+     * Chain the funds are being sent from, so the API can drop destinations it
+     * can't reach (a withdrawal bridged off N1 can't land back on N1).
+     */
+    sourceChainType?: ChainType;
+}
 /**
  * Hook to fetch supported destination tokens with caching and deduplication via react-query.
  * Used in the withdraw flow to show available tokens the user can withdraw to.
  *
  * @param publishableKey - Publishable key for API calls
  * @param enabled - Whether to fetch (defaults to true)
+ * @param options - Optional surface + source filters
  */
-declare function useSupportedDestinationTokens(publishableKey: string, enabled?: boolean): _tanstack_react_query.UseQueryResult<SupportedDestinationTokensResponse, Error>;
+declare function useSupportedDestinationTokens(publishableKey: string, enabled?: boolean, options?: UseSupportedDestinationTokensOptions): _tanstack_react_query.UseQueryResult<SupportedDestinationTokensResponse, Error>;
 
 interface UseSupportedDepositTokensOptions {
     destination_token_address?: string;
@@ -3281,6 +3457,10 @@ declare function useVerifyRecipientAddress(params: UseVerifyRecipientAddressPara
 interface SourceTokenValidationResult {
     isSupported: boolean;
     isStablecoin: boolean;
+    /** Decimals of the matched source token, when found in the catalog. */
+    decimals: number | null;
+    /** Catalog symbol of the matched source token, when found. */
+    symbol: string | null;
     minimumAmountUsd: number | null;
     estimatedProcessingTime: number | null;
     maxSlippagePercent: number | null;
@@ -3296,6 +3476,13 @@ declare function useSourceTokenValidation(params: {
     sourceChainId?: string;
     sourceTokenAddress?: string;
     sourceTokenSymbol?: string;
+    /**
+     * Which catalog to validate against. `withdraw` also matches chains that can
+     * only ever be a withdrawal source, because their funds are bridged onto a
+     * settlement chain (N1) — the deposit catalog deliberately hides those, since
+     * nothing can be routed off them directly. Omitted defers to the API default.
+     */
+    actionType?: ActionType;
     publishableKey: string;
     enabled?: boolean;
 }): _tanstack_react_query.UseQueryResult<SourceTokenValidationResult, Error>;