@unifold/ui-react 0.1.79 → 0.1.81

package/dist/index.d.mts

@@ -1,15 +1,16 @@
 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, TokenMetadata, 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';
 import * as _tanstack_react_query from '@tanstack/react-query';
+import { BrowserWalletProviderErrorStage, EventTracker, AnalyticsProperties, AnalyticsEvent } from '@unifold/analytics';
+import { Wallet as Wallet$1, WalletAccount } from '@wallet-standard/base';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as SelectPrimitive from '@radix-ui/react-select';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
-import { EventTracker, AnalyticsProperties, AnalyticsEvent } from '@unifold/analytics';
 import { ClassValue } from 'clsx';
 
 /** The two tabs the deposit menu splits funding methods across. */
@@ -96,52 +97,25 @@ interface UseDepositPollingResult {
 }
 declare function useDepositPolling({ userId, publishableKey, clientSecret, depositConfirmationMode, depositWalletId, depositWalletIds, enabled, immediateDirectPolling, onDepositSuccess, onDepositError, }: UseDepositPollingOptions): UseDepositPollingResult;
 
-interface EthereumProvider {
-    isMetaMask?: boolean;
-    isPhantom?: boolean;
-    isCoinbaseWallet?: boolean;
-    isTrust?: boolean;
-    isRainbow?: boolean;
-    isRabby?: boolean;
-    isOkxWallet?: boolean;
-    /** Set by the provider Robinhood Wallet injects into its web3 browser. */
-    isRobinhoodMobileWallet?: boolean;
-    selectedAddress?: string;
-    request(args: {
-        method: string;
-        params?: unknown[];
-    }): Promise<unknown>;
-    on?(event: string, callback: (...args: unknown[]) => void): void;
-    off?(event: string, callback: (...args: unknown[]) => void): void;
-    removeListener?(event: string, callback: (...args: unknown[]) => void): void;
-}
-
-declare global {
-    interface Window {
-        phantom?: {
-            solana?: PhantomSolanaProvider;
-            ethereum?: EthereumProvider;
-        };
-        solana?: PhantomSolanaProvider;
-        ethereum?: EthereumProvider;
-    }
-}
-interface PhantomSolanaProvider {
-    isPhantom?: boolean;
-    isConnected?: boolean;
-    publicKey?: {
-        toString(): string;
+type WalletType = 'phantom-solana' | 'phantom-ethereum' | 'metamask' | 'coinbase' | 'solflare' | 'backpack' | 'glow' | 'trust' | 'trust-solana' | 'rainbow' | 'rabby' | 'okx' | 'robinhood';
+interface BrowserWalletInfo {
+    type: WalletType;
+    name: string;
+    address: string;
+    balance?: string;
+    balanceUsd?: string;
+    icon: string;
+    depositWallet?: {
+        id: string;
+        chain_type: ChainType;
+        address_type: string | null;
+        address: string;
+        destination_chain_type: ChainType;
+        destination_chain_id: string;
+        destination_token_address: string;
+        recipient_address: string;
+        is_primary: boolean;
     };
-    connect(opts?: {
-        onlyIfTrusted?: boolean;
-    }): Promise<{
-        publicKey: {
-            toString(): string;
-        };
-    }>;
-    disconnect(): Promise<void>;
-    on(event: string, callback: (...args: unknown[]) => void): void;
-    off(event: string, callback: (...args: unknown[]) => void): void;
 }
 
 /** Quick amount chips on the browser wallet "Enter amount" step */
@@ -229,6 +203,8 @@ interface DepositModalProps {
     showBalanceHeader?: boolean;
     /** Input variant for Transfer Crypto view: "single_input" or "double_input" (default) */
     transferInputVariant?: 'single_input' | 'double_input';
+    /** Transfer Crypto: show the reference exchange-rate row. @default false */
+    showTransferCryptoExchangeRate?: boolean;
     /** Controls when deposit polling starts and what UI is shown.
      *  - "auto_ui": After 10s, starts polling and shows "Processing..." card (default)
      *  - "auto_silent": After 10s, starts polling silently (no waiting UI)
@@ -289,7 +265,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 +282,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;
     /**
@@ -368,7 +344,7 @@ interface DepositModalProps {
      */
     displayMode?: DepositMenuLayoutType;
 }
-declare function DepositModal({ open, onOpenChange, userId, publishableKey, modalTitle, destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, contractCalls, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, prefilledAmountUsd, hideDepositTracker, showBalanceHeader, transferInputVariant, depositConfirmationMode, enableTransferCrypto, enableConnectWallet, browserWalletAmountQuickSelect, enablePayWithExchange, enableFiatOnramp, enableConnectExchange, enableCashApp, enableApplePay, applePayTitle: applePayTitleProp, applePaySubTitle: applePaySubTitleProp, enableGooglePay, googlePayTitle: googlePayTitleProp, googlePaySubTitle: googlePaySubTitleProp, enableBankTransfer, enableIncidentBanner, enableStripeLink, onrampDestinationAmount, userEmail, hideDepositFlowInfo, hideDisplayDescription, onDepositSuccess, onDepositError, onEvent, theme, hideOverlay, initialScreen, layout, displayMode, transferCryptoTitle: transferCryptoTitleProp, depositWithCardTitle: depositWithCardTitleProp, payWithExchangeTitle: payWithExchangeTitleProp, depositTrackerTitle: depositTrackerTitleProp, depositTrackerSubTitle: depositTrackerSubTitleProp, }: DepositModalProps): react_jsx_runtime.JSX.Element;
+declare function DepositModal({ open, onOpenChange, userId, publishableKey, modalTitle, destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, contractCalls, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, prefilledAmountUsd, hideDepositTracker, showBalanceHeader, transferInputVariant, showTransferCryptoExchangeRate, depositConfirmationMode, enableTransferCrypto, enableConnectWallet, browserWalletAmountQuickSelect, enablePayWithExchange, enableFiatOnramp, enableConnectExchange, enableCashApp, enableApplePay, applePayTitle: applePayTitleProp, applePaySubTitle: applePaySubTitleProp, enableGooglePay, googlePayTitle: googlePayTitleProp, googlePaySubTitle: googlePaySubTitleProp, enableBankTransfer, enableIncidentBanner, enableStripeLink, onrampDestinationAmount, userEmail, hideDepositFlowInfo, hideDisplayDescription, onDepositSuccess, onDepositError, onEvent, theme, hideOverlay, initialScreen, layout, displayMode, transferCryptoTitle: transferCryptoTitleProp, depositWithCardTitle: depositWithCardTitleProp, payWithExchangeTitle: payWithExchangeTitleProp, depositTrackerTitle: depositTrackerTitleProp, depositTrackerSubTitle: depositTrackerSubTitleProp, }: DepositModalProps): react_jsx_runtime.JSX.Element;
 
 interface DepositHeaderProps {
     title: string;
@@ -439,7 +415,7 @@ interface TransferCryptoSingleInputProps {
         minimumDepositAmountUsd: number;
         isStablecoin: boolean;
     }) => void;
-    /** Optional USD prefilled used to render an estimated "You send" target. */
+    /** Optional USD prefill. You send is omitted when this is set. */
     prefilledAmountUsd?: string;
     /** Checkout mode: estimated source amount to send (from /public/quotes). Shown above the QR code. */
     checkoutQuote?: {
@@ -455,8 +431,10 @@ interface TransferCryptoSingleInputProps {
     persistCheckingIndicator?: boolean;
     /** Product context sent to the API — "deposit" (default) or "payment". */
     productType?: ProductType;
+    /** Show the reference exchange-rate row between selected and destination token. */
+    showExchangeRate?: boolean;
 }
-declare function TransferCryptoSingleInput({ userId, publishableKey, clientSecret, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, depositConfirmationMode, onExecutionsChange, onDepositSuccess, onDepositError, wallets: externalWallets, onSourceTokenChange, prefilledAmountUsd, checkoutQuote, isCheckoutQuoteLoading, persistCheckingIndicator, productType, }: TransferCryptoSingleInputProps): react_jsx_runtime.JSX.Element;
+declare function TransferCryptoSingleInput({ userId, publishableKey, clientSecret, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, depositConfirmationMode, onExecutionsChange, onDepositSuccess, onDepositError, wallets: externalWallets, onSourceTokenChange, prefilledAmountUsd, checkoutQuote, isCheckoutQuoteLoading, persistCheckingIndicator, productType, showExchangeRate, }: TransferCryptoSingleInputProps): react_jsx_runtime.JSX.Element;
 
 interface TransferCryptoDoubleInputProps {
     userId: string;
@@ -469,7 +447,7 @@ interface TransferCryptoDoubleInputProps {
     defaultSourceChainId?: string;
     defaultSourceTokenAddress?: string;
     defaultSourceSymbol?: string;
-    /** Optional USD prefilled used to render an estimated "You send" target. */
+    /** Optional USD prefill. You send is omitted when this is set. */
     prefilledAmountUsd?: string;
     /** Controls when polling starts and whether a waiting UI is shown.
      *  - "auto_ui": After 10s, starts polling and shows "Processing..." card (default)
@@ -490,14 +468,18 @@ interface TransferCryptoDoubleInputProps {
         code?: string;
     }) => void;
     wallets?: Wallet[];
+    /** Show the reference exchange-rate row between selected and destination token. */
+    showExchangeRate?: boolean;
 }
-declare function TransferCryptoDoubleInput({ userId, publishableKey, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, prefilledAmountUsd, depositConfirmationMode, onExecutionsChange, onDepositSuccess, onDepositError, wallets: externalWallets, }: TransferCryptoDoubleInputProps): react_jsx_runtime.JSX.Element;
+declare function TransferCryptoDoubleInput({ userId, publishableKey, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, depositConfirmationMode, onExecutionsChange, onDepositSuccess, onDepositError, wallets: externalWallets, showExchangeRate, }: TransferCryptoDoubleInputProps): react_jsx_runtime.JSX.Element;
 
+type CardView = 'amount' | 'quotes' | 'review';
 interface BuyWithCardProps {
     userId: string;
     publishableKey: string;
-    view?: 'amount' | 'quotes' | 'onramp';
-    onViewChange?: (view: 'amount' | 'quotes' | 'onramp', quotesCount?: number) => void;
+    view?: CardView;
+    onViewChange?: (view: CardView, quotesCount?: number) => void;
+    projectName?: string;
     maxAmountUsd?: number;
     accentColor?: string;
     destinationTokenSymbol?: string;
@@ -535,10 +517,10 @@ interface BuyWithCardProps {
      */
     destinationAmount?: string;
 }
-declare function BuyWithCard({ userId, publishableKey, view: externalView, onViewChange, maxAmountUsd, accentColor, // Keep prop for backward compatibility but don't use default
-destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, onDepositSuccess, onDepositError, onEvent, themeClass, wallets: externalWallets, assetCdnUrl, hideDepositFlowInfo, hideDisplayDescription, prefilledAmountUsd, destinationAmount, }: BuyWithCardProps): react_jsx_runtime.JSX.Element;
+declare function BuyWithCard({ userId, publishableKey, view: externalView, onViewChange, projectName, maxAmountUsd, accentColor, // Keep prop for backward compatibility but don't use default
+destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, onDepositSuccess, onDepositError, onEvent, themeClass, wallets: externalWallets, assetCdnUrl, hideDepositFlowInfo: _hideDepositFlowInfo, hideDisplayDescription: _hideDisplayDescription, prefilledAmountUsd, destinationAmount, }: BuyWithCardProps): react_jsx_runtime.JSX.Element;
 
-type WalletPayView = 'loading_config' | 'disabled' | 'email_input' | 'phone_input' | 'submitting_session' | 'email_otp' | 'phone_otp' | 'amount' | 'creating_order' | 'payment' | 'checking_deposit' | 'delivering' | 'success' | 'guest_limit_reached' | 'limit_upgrade_intro' | 'limit_upgrade_form' | 'limit_upgrade_submitting' | 'limit_upgrade_failed';
+type WalletPayView = 'loading_config' | 'disabled' | 'contact_input' | 'submitting_session' | 'email_otp' | 'phone_otp' | 'amount' | 'creating_order' | 'payment' | 'checking_deposit' | 'delivering' | 'success' | 'guest_limit_reached' | 'limit_upgrade_intro' | 'limit_upgrade_form' | 'limit_upgrade_submitting' | 'limit_upgrade_failed';
 type View = WalletPayView;
 interface BuyWithWalletPayProps {
     /**
@@ -645,6 +627,13 @@ interface WalletPayQrCheckoutProps {
     /** Coinbase-hosted checkout page for this order. */
     paymentUrl: string;
     quote: WalletPayQuote;
+    /**
+     * Final-dest Amount Received. When passed (including `null`), replaces the
+     * Coinbase session routing currency so we don't label USDC as the project dest.
+     */
+    amountReceived?: string | null;
+    /** Final-dest chain name. When passed, replaces the Coinbase routing network. */
+    destinationNetwork?: string | null;
 }
 /**
  * Desktop hand-off for the headless Coinbase device wallets: the code to scan,
@@ -659,7 +648,7 @@ interface WalletPayQrCheckoutProps {
  * Payment happens entirely on Coinbase's side, on another device, so nothing
  * here reports back — the parent polls the provider and the chain.
  */
-declare function WalletPayQrCheckout({ method, paymentUrl, quote }: WalletPayQrCheckoutProps): react_jsx_runtime.JSX.Element;
+declare function WalletPayQrCheckout({ method, paymentUrl, quote, amountReceived: amountReceivedOverride, destinationNetwork: destinationNetworkOverride, }: WalletPayQrCheckoutProps): react_jsx_runtime.JSX.Element;
 
 type MobilePlatform = 'ios' | 'android';
 
@@ -779,6 +768,17 @@ interface QRCodeSkeletonProps {
     darkMode?: boolean;
 }
 declare function QRCodeSkeleton({ size, darkMode }: QRCodeSkeletonProps): react_jsx_runtime.JSX.Element;
+/**
+ * Themed QR used on Transfer Crypto: card border + shadow, 180px code,
+ * theme-aware modules. Wallet Pay and Binance Pay use this instead of the
+ * larger Cash App white tile.
+ */
+declare function TransferQrCode({ value, imageUrl, errorCorrectionLevel, loading, }: {
+    value: string;
+    imageUrl?: string;
+    errorCorrectionLevel?: ErrorCorrectionLevel;
+    loading?: boolean;
+}): react_jsx_runtime.JSX.Element;
 declare function StyledQRCode({ value, size, imageUrl, imageSize, darkMode, errorCorrectionLevel, }: StyledQRCodeProps): react_jsx_runtime.JSX.Element;
 
 interface TransferCryptoButtonProps {
@@ -956,6 +956,9 @@ interface PayWithStripeLinkProps {
     email?: string;
     /** URL for the Link logo icon (from CDN) */
     iconUrl?: string;
+    projectName?: string;
+    assetCdnUrl?: string;
+    destinationTokenSymbol?: string;
     /** Controlled step state (optional — for header back button coordination) */
     step?: StripeLinkStep;
     onStepChange?: (step: StripeLinkStep) => void;
@@ -995,7 +998,7 @@ interface PayWithStripeLinkProps {
  * The Stripe publishable key is auto-fetched from the backend via GET /config,
  * so consumers only need their Unifold publishable key.
  */
-declare function PayWithStripeLink({ userId, publishableKey, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, countryCode, subdivisionCode, wallets: externalWallets, email: emailProp, iconUrl, step: controlledStep, onStepChange, backHandlerRef, onDepositSuccess, onDepositError, onEvent, }: PayWithStripeLinkProps): react_jsx_runtime.JSX.Element | null;
+declare function PayWithStripeLink({ userId, publishableKey, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, countryCode, subdivisionCode, wallets: externalWallets, email: emailProp, iconUrl, projectName, assetCdnUrl, destinationTokenSymbol, step: controlledStep, onStepChange, backHandlerRef, onDepositSuccess, onDepositError, onEvent, }: PayWithStripeLinkProps): react_jsx_runtime.JSX.Element | null;
 
 interface DepositExecutionItemProps {
     execution: DirectExecutionResponse;
@@ -1075,6 +1078,8 @@ interface CheckoutModalProps {
     defaultSourceTokenAddress?: string;
     /** Source token symbol (e.g. `"USDC"`). Must be paired with `defaultSourceChainType` + `defaultSourceChainId`. */
     defaultSourceSymbol?: string;
+    /** Transfer Crypto: show the reference exchange-rate row. @default false */
+    showTransferCryptoExchangeRate?: boolean;
     theme?: 'light' | 'dark' | 'auto';
     onCheckoutSuccess?: (data: {
         paymentIntentId: string;
@@ -1096,7 +1101,7 @@ interface CheckoutModalProps {
     }) => void;
     onEvent?: (event: CheckoutEvent) => void;
 }
-declare function CheckoutModal({ open, onOpenChange, clientSecret, publishableKey, modalTitle, enableTransferCrypto, enableConnectWallet, enableIncidentBanner, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, theme, onCheckoutSuccess, onCheckoutError, onEvent, externalUserId, }: CheckoutModalProps): react_jsx_runtime.JSX.Element;
+declare function CheckoutModal({ open, onOpenChange, clientSecret, publishableKey, modalTitle, enableTransferCrypto, enableConnectWallet, enableIncidentBanner, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, showTransferCryptoExchangeRate, theme, onCheckoutSuccess, onCheckoutError, onEvent, externalUserId, }: CheckoutModalProps): react_jsx_runtime.JSX.Element;
 
 interface WithdrawTransactionInfo {
     /** Source (sending) chain type */
@@ -1119,7 +1124,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 +1158,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 +1204,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 +1223,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 +1235,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 +1248,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 +1308,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";
 
@@ -1316,6 +1359,106 @@ declare function sendHypercoreWithdraw(params: {
 
 declare function detectBrowserWallet(chainType: string, senderAddress?: string): Promise<DetectedWallet | null>;
 
+type BrowserWalletErrorReporter = (error: unknown, metadata: {
+    stage: BrowserWalletProviderErrorStage;
+    chainType?: 'ethereum' | 'solana';
+    providerSource?: string;
+    componentStack?: string;
+    /**
+     * The provider threw but we still obtained a usable value, so the wallet
+     * stays available and only telemetry records the incompatibility.
+     */
+    recovered?: boolean;
+}) => void;
+
+/**
+ * Silently detects an already-connected injected browser wallet without triggering
+ * any wallet popups. Solana reads authorized Wallet Standard accounts; Ethereum
+ * uses the read-only `eth_accounts`.
+ * Returns the connected wallet, or `null` when none is connected (or the user
+ * previously disconnected explicitly).
+ *
+ * When the user has previously connected a wallet, its `WalletType` is persisted
+ * in localStorage; on subsequent refreshes we move that candidate to the front of
+ * the scan so multi-wallet setups (e.g. MetaMask + Phantom installed, Phantom
+ * Solana also connected) don't always resolve to whichever provider happens to be
+ * iterated first.
+ */
+declare function detectConnectedBrowserWallet(chainType?: 'ethereum' | 'solana', reportError?: BrowserWalletErrorReporter): Promise<BrowserWalletInfo | null>;
+
+/**
+ * Inline this in `<head>` so announce events that fire before React boots
+ * (MetaMask/Rainbow at document_start) are not lost. Splits Connect often
+ * `stopImmediatePropagation`s `eip6963:requestProvider`, so a late
+ * `requestProvider` will not get those wallets to re-announce.
+ */
+declare const EIP6963_BOOTSTRAP_SCRIPT: string;
+/** Start discovery as soon as the SDK mounts — do not wait for the modal. */
+declare function startBrowserWalletDiscovery(): void;
+/** Ask installed wallets to announce again. Safe to call more than once. */
+declare function requestEip6963Providers(): void;
+
+/**
+ * Shared Solana Wallet Standard discovery — the Solana counterpart to our
+ * guarded EIP-6963 registry.
+ *
+ * Wallets announce themselves to the page through the Wallet Standard registry,
+ * so every installed Solana wallet is enumerated without reading `window.solana`
+ * (one global that only ever holds a single wallet, so multi-extension setups
+ * race to own it) and without ever calling `connect()`.
+ *
+ * Everything here is read-only: `wallet.accounts` is populated by the wallet only
+ * for origins the user has already authorized, which makes it a silent
+ * already-connected check with no approval prompt.
+ */
+
+interface SolanaStandardWallet {
+    walletId: string;
+    name: string;
+    /** Data-URI icon supplied by the wallet itself. */
+    icon: string;
+    wallet: Wallet$1;
+}
+interface SolanaStandardAccount extends SolanaStandardWallet {
+    /** Base58 address of the wallet's first authorized account for this origin. */
+    address: string;
+    account: WalletAccount;
+}
+/**
+ * All registered Solana wallets. Purely a registry read — safe to call on mount
+ * and on every render.
+ */
+declare function getSolanaStandardWallets(): SolanaStandardWallet[];
+/** Find a registered Solana wallet by our internal wallet ID. */
+declare function findSolanaStandardWallet(walletId: string): SolanaStandardWallet | undefined;
+/** Whether a Solana wallet is installed, by our internal wallet ID. */
+declare function isSolanaWalletDetectedViaWalletStandard(walletId: string): boolean;
+/**
+ * Solana wallets that already have an authorized account for this origin.
+ *
+ * The Wallet Standard equivalent of EVM's `eth_accounts`: wallets only publish
+ * `accounts` once the user has approved the origin, so this reports existing
+ * connections without prompting. Wallets the user has never approved simply
+ * expose an empty array.
+ */
+declare function getAuthorizedSolanaStandardAccounts(): SolanaStandardAccount[];
+/** Connect a selected Wallet Standard wallet. Call only from a user gesture. */
+declare function connectSolanaStandardWallet(walletId: string): Promise<SolanaStandardAccount | null>;
+/** Sign a serialized Solana transaction through Wallet Standard when supported. */
+declare function signSolanaStandardTransaction(walletId: string, address: string, transaction: Uint8Array): Promise<Uint8Array | null>;
+/**
+ * Fires whenever a wallet registers or unregisters. Wallets register
+ * asynchronously after page load, so callers that enumerate wallets on mount need
+ * this to pick up late arrivals.
+ */
+declare function subscribeSolanaStandardWallets(listener: () => void): () => void;
+/**
+ * Fires when any registered Solana wallet changes its accounts — connect,
+ * disconnect, or account switch. Replaces per-wallet `provider.on('connect')`
+ * listeners for wallets that implement `standard:events`.
+ */
+declare function subscribeSolanaStandardAccountChanges(listener: () => void): () => void;
+
 interface CurrencyListItemProps {
     currency: FiatCurrency;
     isSelected: boolean;
@@ -1404,10 +1547,12 @@ var common = {
 	review: "Review",
 	tryAgain: "Try Again",
 	somethingWentWrong: "Something went wrong",
+	quoteFailed: "Failed to fetch quote, please try again later",
 	seeMoreDetails: "See more details",
 	seeLess: "See less",
 	dateTime: "{{date}} at {{time}}",
 	"continue": "Continue",
+	confirm: "Confirm",
 	processing: "Processing",
 	checkingFor: "Checking for {{target}}",
 	depositTarget: "deposit",
@@ -1417,6 +1562,9 @@ var common = {
 	help: "Help",
 	done: "Done",
 	from: "From",
+	to: "To",
+	youPay: "You pay",
+	intentAddressDisclaimer: "The address shown in the provider is an intent address. Funds will be automatically deposited into your account.",
 	max: "Max",
 	or: "or",
 	minimumAmount: "Minimum amount is {{amount}}",
@@ -1434,7 +1582,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",
@@ -1489,8 +1638,7 @@ var connectWallet = {
 		confirming: "Confirming...",
 		minimumForTokenOnChain: "Minimum for {{token}} on {{chain}} is ${{amount}}",
 		amountAdjusted: "Amount adjusted from remaining ${{amount}}",
-		minimumDeposit: "Minimum deposit: ${{amount}}",
-		walletWillPrompt: "{{wallet}} wallet will ask you to approve this transaction."
+		minimumDeposit: "Minimum deposit: ${{amount}}"
 	},
 	confirming: {
 		waitingTitle: "Waiting for confirmation...",
@@ -1522,6 +1670,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 +1770,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 +1808,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 +1841,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",
@@ -1692,6 +1868,7 @@ var depositModal = {
 		cash: "Use Cash"
 	},
 	applePayHeader: {
+		enterContact: "Verification",
 		enterEmail: "Enter your email",
 		enterPhone: "Enter your phone",
 		verifyEmail: "Verify your email",
@@ -1750,7 +1927,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",
@@ -1768,7 +1951,7 @@ var connectExchange = {
 	connectingDesc: "Complete authorization in the popup window",
 	connected: {
 		title: "Connected to {{exchange}}",
-		subtitle: "Your {{exchange}} account is linked and ready to use.",
+		subtitle: "Your account is linked and ready to use.",
 		exchange: "Exchange",
 		status: "Status",
 		statusConnected: "Connected",
@@ -1777,8 +1960,7 @@ var connectExchange = {
 		flowSource: "Source",
 		flowTransfer: "Transfer",
 		flowDirect: "Direct",
-		flowDestination: "Destination",
-		secureNote: "All transfers are secured with two-factor authentication and encrypted end-to-end."
+		flowDestination: "Destination"
 	},
 	holdings: {
 		title: "Select asset"
@@ -1797,7 +1979,7 @@ var connectExchange = {
 		mfaEnrollmentTitle: "Enable SMS or Authy 2FA",
 		mfaEnrollmentMessage: "Please make sure you enable SMS or Authy 2FA in your Coinbase account. Press Continue after you enable it.",
 		mfaEnrollmentSettingsLink: "Open Coinbase security settings",
-		termsNoticePrefix: "By clicking on Confirm Order, you agree to our ",
+		termsNoticePrefix: "By clicking on Confirm, you agree to our ",
 		termsNoticeLink: "terms",
 		termsNoticeSuffix: "."
 	},
@@ -1833,7 +2015,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 +2053,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 +2074,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 +2371,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 +2396,7 @@ var en = {
 	executionDetails: executionDetails,
 	depositTracker: depositTracker,
 	connectWallet: connectWallet,
+	walletErrors: walletErrors,
 	transferCrypto: transferCrypto,
 	glossary: glossary,
 	depositModal: depositModal,
@@ -2217,14 +2417,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[];
 /**
@@ -2242,10 +2448,12 @@ declare const i18n: {
         review: string;
         tryAgain: string;
         somethingWentWrong: string;
+        quoteFailed: string;
         seeMoreDetails: string;
         seeLess: string;
         dateTime: string;
         continue: string;
+        confirm: string;
         processing: string;
         checkingFor: string;
         depositTarget: string;
@@ -2255,6 +2463,9 @@ declare const i18n: {
         help: string;
         done: string;
         from: string;
+        to: string;
+        youPay: string;
+        intentAddressDisclaimer: string;
         max: string;
         or: string;
         minimumAmount: string;
@@ -2273,6 +2484,7 @@ declare const i18n: {
         balanceWithProject: string;
         balanceWithToken: string;
         amountDue: string;
+        back: string;
     };
     executionDetails: {
         processing: string;
@@ -2328,7 +2540,6 @@ declare const i18n: {
             minimumForTokenOnChain: string;
             amountAdjusted: string;
             minimumDeposit: string;
-            walletWillPrompt: string;
         };
         confirming: {
             waitingTitle: string;
@@ -2360,6 +2571,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 +2672,7 @@ declare const i18n: {
             defaultError: string;
         };
         selectNetworkPlaceholder: string;
+        recipientAddress: string;
     };
     glossary: {
         title: string;
@@ -2478,6 +2716,7 @@ declare const i18n: {
             title: string;
             subtitle: string;
             disconnect: string;
+            balanceWithInstant: string;
         };
         cashApp: {
             creatingOrder: string;
@@ -2530,6 +2769,7 @@ declare const i18n: {
             cash: string;
         };
         applePayHeader: {
+            enterContact: string;
             enterEmail: string;
             enterPhone: string;
             verifyEmail: string;
@@ -2589,6 +2829,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;
@@ -2616,7 +2862,6 @@ declare const i18n: {
             flowTransfer: string;
             flowDirect: string;
             flowDestination: string;
-            secureNote: string;
         };
         holdings: {
             title: string;
@@ -2672,6 +2917,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 +2955,8 @@ declare const i18n: {
         };
         refreshingIn: string;
         estimatedDeliveryTime: string;
+        thisToken: string;
+        destinationNotStablecoin: string;
     };
     buyWithApplePay: {
         email: {
@@ -2716,6 +2976,7 @@ declare const i18n: {
             incorrect: string;
             resend: string;
             resendIn: string;
+            verify: string;
         };
         amount: {
             enterAmount: string;
@@ -3012,6 +3273,7 @@ declare const i18n: {
             status: string;
             checking: string;
             empty: string;
+            estimatedTime: string;
         };
         executionItem: {
             processing: string;
@@ -3045,18 +3307,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 +3345,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 +3448,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,12 +3473,27 @@ 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.
- * Server-side cached for 1 minute; client re-fetches on param change.
+ * 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 treats a quote as fresh for 5 minutes.
  */
 declare function useDepositQuote(params: UseDepositQuoteParams): _tanstack_react_query.UseQueryResult<DepositQuote, Error>;
 
+interface UseTokenMetadataParams {
+    chainType?: string;
+    chainId?: string;
+    tokenAddress?: string;
+    publishableKey: string;
+    enabled?: boolean;
+}
+/**
+ * Token metadata (symbol, icons, decimals, chain) for a chain/token address.
+ * Shared query key so transfer, card, and other surfaces reuse the same cache.
+ */
+declare function useTokenMetadata(params: UseTokenMetadataParams): _tanstack_react_query.UseQueryResult<TokenMetadata | null, Error>;
+
 interface UsePublicIncidentOptions {
     publishableKey: string;
     enabled?: boolean;
@@ -3237,14 +3529,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 +3583,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 +3602,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>;
@@ -3599,4 +3912,4 @@ declare function cn(...inputs: ClassValue[]): string;
  */
 declare function truncateAddress(address: string, startChars?: number, endChars?: number): string;
 
-export { type AllowedCountryResult, AnalyticsProvider, type AnalyticsProviderProps, BankTransfer, BankTransferButton, type BankTransferProps, type BankTransferView, type BrowserWalletAmountQuickSelect, Button, type ButtonProps, type ButtonTokens, BuyWithApplePay, type BuyWithApplePayProps, BuyWithCard, type BuyWithCardProps, BuyWithGooglePay, type BuyWithGooglePayProps, BuyWithWalletPay, type BuyWithWalletPayHandle, type BuyWithWalletPayProps, type CardTokens, CheckingForDepositIndicator, CheckoutModal, type CheckoutModalProps, CoinbaseConnect, type ComponentConfig, type ComponentOverrides, type ComponentTokens, ConfirmingView, ConnectExchangeButton, type ContainerTokens, CurrencyListItem, CurrencyListSection, CurrencyModal, type CustomThemeColors, type DepositConfirmationMode, DepositDetailContent, DepositExecutionItem, DepositHeader, type DepositMenuLayout, type DepositMenuLayoutType, DepositModal, type DepositModalInitialScreen, DepositSuccessToast, type DepositTab, DepositTrackerButton, DepositWithCardButton, DepositsModal, type DetectedWallet, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type EvmWalletProvider, type FontConfig, HYPERCORE_CHAIN_ID, type HeaderTokens, type I18nContextValue, I18nProvider, type I18nProviderProps, type I18nStrings, type InputTokens, type ListTokens, type LocaleCode, ManualDepositButton, type MobilePlatform, PayWithStripeLink, type PayWithStripeLinkProps, QRCodeSkeleton, type ResolvedFonts, SUPPORTED_LOCALES, type SearchTokens, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, type SolanaWalletProvider, type StoredWalletPaySession as StoredApplePaySession, type StoredWalletPaySession, StripeLinkButton, type StripeLinkStep, StyledQRCode, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, type ThemeProviderProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TransferCryptoButton, TransferCryptoDoubleInput, TransferCryptoSingleInput, type UseDepositQuoteParams, type UsePaymentIntentParams, type UseSupportedDepositTokensOptions, WalletPayQrCheckout, type WalletPayQrCheckoutProps, type WalletPayQuote, type WalletPayView, WithdrawConfirmingView, WithdrawDoubleInput, WithdrawExecutionItem, WithdrawForm, WithdrawModal, type WithdrawModalProps, WithdrawTokenSelector, type WithdrawTransactionInfo, buildWalletPayQuote, buttonVariants, clearStoredWalletPaySession as clearStoredApplePaySession, clearStoredWalletPaySession, cn, colors, defaultColors, detectBrowserLocale, detectBrowserWallet, formatCryptoAmount, formatFiat, getActiveLocale, getActiveStrings, getColors, getStoredWalletPaySession as getStoredApplePaySession, getStoredWalletPaySession, getStrings, i18n, interpolate, isHypercoreChain, isOnrampTokenFresh, mergeColors, normalizeLocale, platformSupportsWalletPay, qrErrorCorrectionLevel, resolveComponentTokens, sendEvmWithdraw, sendHypercoreWithdraw, sendSolanaWithdraw, setActiveLocale, setStoredWalletPaySession as setStoredApplePaySession, setStoredWalletPaySession, truncateAddress, useAddressBalance, useAllowedCountry, useAnalytics, useDebounce, useDepositPolling, useDepositQuote, useI18n, useMobilePlatform, usePaymentIntent, usePublicIncident, useSourceTokenValidation, useSupportedDepositTokens, useSupportedDestinationTokens, useTheme, useVerifyRecipientAddress, useWithdrawPolling };
+export { type AllowedCountryResult, AnalyticsProvider, type AnalyticsProviderProps, BankTransfer, BankTransferButton, type BankTransferProps, type BankTransferView, type BrowserWalletAmountQuickSelect, Button, type ButtonProps, type ButtonTokens, BuyWithApplePay, type BuyWithApplePayProps, BuyWithCard, type BuyWithCardProps, BuyWithGooglePay, type BuyWithGooglePayProps, BuyWithWalletPay, type BuyWithWalletPayHandle, type BuyWithWalletPayProps, type CardTokens, CheckingForDepositIndicator, CheckoutModal, type CheckoutModalProps, CoinbaseConnect, type ComponentConfig, type ComponentOverrides, type ComponentTokens, ConfirmingView, ConnectExchangeButton, type ContainerTokens, CurrencyListItem, CurrencyListSection, CurrencyModal, type CustomThemeColors, type DepositConfirmationMode, DepositDetailContent, DepositExecutionItem, DepositHeader, type DepositMenuLayout, type DepositMenuLayoutType, DepositModal, type DepositModalInitialScreen, DepositSuccessToast, type DepositTab, DepositTrackerButton, DepositWithCardButton, DepositsModal, type DetectedWallet, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, EIP6963_BOOTSTRAP_SCRIPT, type EvmWalletProvider, type FontConfig, HYPERCORE_CHAIN_ID, type HeaderTokens, type I18nContextValue, I18nProvider, type I18nProviderProps, type I18nStrings, type InputTokens, type ListTokens, type LocaleCode, ManualDepositButton, type MobilePlatform, PayWithStripeLink, type PayWithStripeLinkProps, QRCodeSkeleton, type ResolvedFonts, SUPPORTED_LOCALES, type SearchTokens, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, type SolanaStandardAccount, type SolanaStandardWallet, type SolanaWalletProvider, type StoredWalletPaySession as StoredApplePaySession, type StoredWalletPaySession, StripeLinkButton, type StripeLinkStep, StyledQRCode, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, type ThemeProviderProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TransferCryptoButton, TransferCryptoDoubleInput, TransferCryptoSingleInput, TransferQrCode, type UseDepositQuoteParams, type UsePaymentIntentParams, type UseSupportedDepositTokensOptions, type UseTokenMetadataParams, WalletPayQrCheckout, type WalletPayQrCheckoutProps, type WalletPayQuote, type WalletPayView, WithdrawConfirmingView, WithdrawDoubleInput, WithdrawExecutionItem, WithdrawForm, WithdrawModal, type WithdrawModalProps, WithdrawTokenSelector, type WithdrawTransactionInfo, buildWalletPayQuote, buttonVariants, clearStoredWalletPaySession as clearStoredApplePaySession, clearStoredWalletPaySession, cn, colors, connectSolanaStandardWallet, defaultColors, detectBrowserLocale, detectBrowserWallet, detectConnectedBrowserWallet, findSolanaStandardWallet, formatCryptoAmount, formatFiat, getActiveLocale, getActiveStrings, getAuthorizedSolanaStandardAccounts, getColors, getSolanaStandardWallets, getStoredWalletPaySession as getStoredApplePaySession, getStoredWalletPaySession, getStrings, i18n, interpolate, isHypercoreChain, isOnrampTokenFresh, isSolanaWalletDetectedViaWalletStandard, mergeColors, normalizeLocale, platformSupportsWalletPay, qrErrorCorrectionLevel, requestEip6963Providers, resolveComponentTokens, sendEvmWithdraw, sendHypercoreWithdraw, sendSolanaWithdraw, setActiveLocale, setStoredWalletPaySession as setStoredApplePaySession, setStoredWalletPaySession, signSolanaStandardTransaction, startBrowserWalletDiscovery, subscribeSolanaStandardAccountChanges, subscribeSolanaStandardWallets, truncateAddress, useAddressBalance, useAllowedCountry, useAnalytics, useDebounce, useDepositPolling, useDepositQuote, useI18n, useMobilePlatform, usePaymentIntent, usePublicIncident, useSourceTokenValidation, useSupportedDepositTokens, useSupportedDestinationTokens, useTheme, useTokenMetadata, useVerifyRecipientAddress, useWithdrawPolling };