@unifold/ui-react 0.1.74 → 0.1.75

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, 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, SupportedDestinationTokensResponse, SupportedDepositTokensResponse, VerifyAddressResponse } from '@unifold/core';
 export { ChainType, DepositMethod } from '@unifold/core';
 import * as React$1 from 'react';
 import { MutableRefObject } from 'react';
@@ -535,7 +535,8 @@ interface BuyWithCardProps {
 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;
 
-type View = 'loading_config' | 'disabled' | 'email_input' | 'phone_input' | 'submitting_session' | 'email_otp' | 'phone_otp' | 'amount' | 'checking_deposit' | 'success' | 'guest_limit_reached' | 'limit_upgrade_intro' | 'limit_upgrade_form' | 'limit_upgrade_submitting' | 'limit_upgrade_failed';
+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 View = WalletPayView;
 interface BuyWithWalletPayProps {
     /**
      * Device wallet the user pays with. Coinbase runs both wallets through the
@@ -594,6 +595,99 @@ interface BuyWithWalletPayHandle {
 }
 declare const BuyWithWalletPay: React$1.ForwardRefExoticComponent<BuyWithWalletPayProps & React$1.RefAttributes<BuyWithWalletPayHandle>>;
 
+/**
+ * The figures shown on the device-wallet confirm screen.
+ *
+ * The Coinbase order *is* the quote: it is priced at creation time, and
+ * `source_amount` comes back as `paymentTotal` — what the wallet is charged,
+ * fees included. Everything here is derived from that one response so the
+ * screen can never show a total the user won't actually be billed.
+ */
+interface WalletPayQuote {
+    /** Fiat charged, inclusive of fees. */
+    totalFiat: number;
+    /** Fiat before fees. */
+    subtotalFiat: number;
+    /** Sum of the provider's fees, in `fiatCurrency`. */
+    feeFiat: number;
+    /** Uppercase ISO 4217 code for every fiat figure above. */
+    fiatCurrency: string;
+    /** Crypto delivered, when the provider priced it. */
+    receiveAmount: string | null;
+    receiveCurrency: string;
+    receiveNetwork: string;
+}
+declare function buildWalletPayQuote(session: CoinbaseWalletPaySessionResponse): WalletPayQuote;
+/** `1234.5, "USD"` → `"$1,234.50"`, falling back to `"USD 1234.50"`. */
+declare function formatFiat(amount: number, currency: string): string;
+/**
+ * Render a crypto amount without the long tail of zeros Coinbase pads its
+ * quotes with (`"97.560000"` → `"97.56"`), keeping at most 6 decimals so a
+ * sub-cent asset still shows something.
+ */
+declare function formatCryptoAmount(value: string): string;
+/**
+ * Error-correction level for a QR the user scans off a screen with a phone.
+ *
+ * `H` (30% recovery) is the nicest choice for short payloads, but it also
+ * inflates the module count, and a Coinbase payment link carries a session
+ * token. Past a few hundred characters the modules get too small to scan
+ * reliably at modal size, so trade recovery for density as the payload grows —
+ * a screen-displayed code has no print smudges or creases to recover from.
+ */
+declare function qrErrorCorrectionLevel(value: string): 'L' | 'M' | 'Q' | 'H';
+
+interface WalletPayQrCheckoutProps {
+    method: WalletPayMethod;
+    /** Coinbase-hosted checkout page for this order. */
+    paymentUrl: string;
+    quote: WalletPayQuote;
+}
+/**
+ * Desktop hand-off for the headless Coinbase device wallets: the code to scan,
+ * what it will cost, and the fact that we're watching for the payment.
+ *
+ * Apple Pay on the web only renders on a device that has the wallet, on a
+ * domain Apple has verified — which is Coinbase's own checkout page, loaded
+ * top-level. A desktop browser can't satisfy that, so rather than trying to host
+ * the sheet here we hand the priced order to the user's phone. A phone never
+ * sees this screen; it pays from the amount screen in one tap.
+ *
+ * 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;
+
+type MobilePlatform = 'ios' | 'android';
+
+/**
+ * The mobile OS, or `null` for desktop and for any phone we can't identify.
+ *
+ * `null` covers desktop, an unfamiliar user agent and the server, because all
+ * three mean the same thing to callers: nothing here justifies taking an option
+ * away. Anything that hides a payment method on this should treat `null` as
+ * "allow", so an unrecognised device never loses something that might have
+ * worked.
+ */
+declare function useMobilePlatform(): MobilePlatform | null;
+
+/**
+ * Whether this device can pay with a given wallet itself.
+ *
+ * A phone only carries the wallet its own OS ships: Apple Pay does not exist on
+ * Android, and Coinbase's guest checkout treats Google Pay as the Android rail.
+ * Offering the other one is a dead end — the user reaches Coinbase's page and no
+ * payment sheet appears.
+ *
+ * `null` — desktop, an unfamiliar user agent, or a server render — allows both,
+ * and that is the important half of the rule. On desktop the QR hands the
+ * payment to a phone we know nothing about, so neither wallet can be ruled out;
+ * the user picks whichever their own phone has. Guessing here would remove a
+ * working option, where guessing on a known platform only ever removes one that
+ * would have failed.
+ */
+declare function platformSupportsWalletPay(method: WalletPayMethod, platform: MobilePlatform | null): boolean;
+
 type BuyWithApplePayProps = Omit<BuyWithWalletPayProps, 'method'>;
 /**
  * Apple Pay entry point into the headless Coinbase guest-checkout flow.
@@ -664,19 +758,25 @@ interface DepositsModalProps {
 }
 declare function DepositsModal({ open, onOpenChange, onCloseAll, executions: sessionExecutions, userId, publishableKey, themeClass, }: DepositsModalProps): react_jsx_runtime.JSX.Element;
 
+type ErrorCorrectionLevel = 'L' | 'M' | 'Q' | 'H';
 interface StyledQRCodeProps {
     value: string;
     size?: number;
     imageUrl?: string;
     imageSize?: number;
     darkMode?: boolean;
+    /**
+     * Lower levels pack a long payload into fewer, larger modules, which scans
+     * better off a screen than a dense high-recovery code.
+     */
+    errorCorrectionLevel?: ErrorCorrectionLevel;
 }
 interface QRCodeSkeletonProps {
     size?: number;
     darkMode?: boolean;
 }
 declare function QRCodeSkeleton({ size, darkMode }: QRCodeSkeletonProps): react_jsx_runtime.JSX.Element;
-declare function StyledQRCode({ value, size, imageUrl, imageSize, darkMode, }: StyledQRCodeProps): react_jsx_runtime.JSX.Element;
+declare function StyledQRCode({ value, size, imageUrl, imageSize, darkMode, errorCorrectionLevel, }: StyledQRCodeProps): react_jsx_runtime.JSX.Element;
 
 interface TransferCryptoButtonProps {
     onClick: () => void;
@@ -919,9 +1019,6 @@ interface ManualDepositButtonProps {
  * Returns null for auto modes or after the user has clicked.
  */
 declare function ManualDepositButton({ depositConfirmationMode, showWaitingUi, onIveDeposited, }: ManualDepositButtonProps): react_jsx_runtime.JSX.Element | null;
-/**
- * Inline "Checking for deposit" spinner for the footer row.
- */
 declare function CheckingForDepositIndicator({ showWaitingUi, hasExecution, }: {
     showWaitingUi: boolean;
     hasExecution: boolean;
@@ -1309,6 +1406,10 @@ var common = {
 	dateTime: "{{date}} at {{time}}",
 	"continue": "Continue",
 	processing: "Processing",
+	checkingFor: "Checking for {{target}}",
+	depositTarget: "deposit",
+	paymentTarget: "payment",
+	paymentFailed: "Payment failed",
 	terms: "Terms",
 	help: "Help",
 	done: "Done",
@@ -1593,6 +1694,8 @@ var depositModal = {
 		verifyEmail: "Verify your email",
 		verifyPhone: "Verify your phone",
 		amount: "Amount",
+		gettingQuote: "Getting quote",
+		delivering: "Payment received",
 		checkingDeposit: "Checking deposit",
 		success: "Success",
 		limitReached: "Limit reached",
@@ -1603,7 +1706,6 @@ var depositModal = {
 		payAmount: "Pay ${{amount}} via Cash App"
 	},
 	cashAppScan: {
-		mobile: "Complete payment in Cash App",
 		desktop: "Scan to pay"
 	},
 	cashAppErrors: {
@@ -1611,6 +1713,9 @@ var depositModal = {
 		createSessionFailed: "Failed to create session",
 		paymentFailed: "Payment failed",
 		cashAppPaymentFailed: "Cash App payment failed"
+	},
+	exchangeScan: {
+		desktop: "Scan to transfer"
 	}
 };
 var checkoutModal = {
@@ -1775,11 +1880,26 @@ var buyWithApplePay = {
 		tokenRoutingUnavailable: "Token routing unavailable",
 		preparing: "Preparing {{wallet}}",
 		payWith: "Pay with",
-		pay: "Pay"
+		pay: "Pay",
+		confirm: "Confirm",
+		gettingQuote: "Getting your quote…"
+	},
+	payment: {
+		scanToPay: "Scan to pay",
+		total: "Total",
+		viewBreakdown: "View breakdown",
+		hideBreakdown: "Hide breakdown",
+		subtotal: "Amount",
+		fees: "Fees",
+		youReceive: "You receive",
+		copyLink: "Copy payment link",
+		copied: "Copied"
 	},
 	checking: {
 		title: "Checking for your deposit…",
-		description: "Return if the payment is not made."
+		description: "Return if the payment is not made.",
+		paidTitle: "Payment received",
+		paidDescription: "Your funds are on the way. This usually takes less than a minute."
 	},
 	upgrade: {
 		limitReached: "{{wallet}} limit reached",
@@ -1810,7 +1930,8 @@ var buyWithApplePay = {
 		destinationNotConfigured: "Deposit destination not configured. Please contact support.",
 		tokenInfoUnavailable: "Unable to load token information. Please try again.",
 		depositWalletUnavailable: "Deposit wallet unavailable. Please try again.",
-		requestFailed: "Unable to process your request. Please try again later."
+		requestFailed: "Unable to process your request. Please try again later.",
+		tabBlocked: "Couldn't open the {{wallet}} page. Allow pop-ups for this site and try again."
 	},
 	"continue": "Continue",
 	cancel: "Cancel",
@@ -1822,7 +1943,9 @@ var buyWithApplePay = {
 		verifyInfoFailed: "We couldn't verify your information. Please check your SSN and date of birth and try again.",
 		limitUpgradeFailed: "Failed to request limit upgrade",
 		verificationFailed: "Verification failed",
-		createPaymentFailed: "Failed to create payment"
+		createPaymentFailed: "Failed to create payment",
+		paymentFailed: "That payment didn't go through. Check the amount and try again.",
+		paymentExpired: "This payment expired before it was completed. Try again."
 	}
 };
 var payWithStripeLink = {
@@ -2113,6 +2236,10 @@ declare const i18n: {
         dateTime: string;
         continue: string;
         processing: string;
+        checkingFor: string;
+        depositTarget: string;
+        paymentTarget: string;
+        paymentFailed: string;
         terms: string;
         help: string;
         done: string;
@@ -2397,6 +2524,8 @@ declare const i18n: {
             verifyEmail: string;
             verifyPhone: string;
             amount: string;
+            gettingQuote: string;
+            delivering: string;
             checkingDeposit: string;
             success: string;
             limitReached: string;
@@ -2407,7 +2536,6 @@ declare const i18n: {
             payAmount: string;
         };
         cashAppScan: {
-            mobile: string;
             desktop: string;
         };
         cashAppErrors: {
@@ -2416,6 +2544,9 @@ declare const i18n: {
             paymentFailed: string;
             cashAppPaymentFailed: string;
         };
+        exchangeScan: {
+            desktop: string;
+        };
     };
     checkoutModal: {
         title: string;
@@ -2580,10 +2711,25 @@ declare const i18n: {
             preparing: string;
             payWith: string;
             pay: string;
+            confirm: string;
+            gettingQuote: string;
+        };
+        payment: {
+            scanToPay: string;
+            total: string;
+            viewBreakdown: string;
+            hideBreakdown: string;
+            subtotal: string;
+            fees: string;
+            youReceive: string;
+            copyLink: string;
+            copied: string;
         };
         checking: {
             title: string;
             description: string;
+            paidTitle: string;
+            paidDescription: string;
         };
         upgrade: {
             limitReached: string;
@@ -2615,6 +2761,7 @@ declare const i18n: {
             tokenInfoUnavailable: string;
             depositWalletUnavailable: string;
             requestFailed: string;
+            tabBlocked: string;
         };
         continue: string;
         cancel: string;
@@ -2627,6 +2774,8 @@ declare const i18n: {
             limitUpgradeFailed: string;
             verificationFailed: string;
             createPaymentFailed: string;
+            paymentFailed: string;
+            paymentExpired: string;
         };
     };
     payWithStripeLink: {
@@ -3431,4 +3580,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, 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, WithdrawConfirmingView, WithdrawDoubleInput, WithdrawExecutionItem, WithdrawForm, WithdrawModal, type WithdrawModalProps, WithdrawTokenSelector, type WithdrawTransactionInfo, buttonVariants, clearStoredWalletPaySession as clearStoredApplePaySession, clearStoredWalletPaySession, cn, colors, defaultColors, detectBrowserLocale, detectBrowserWallet, getActiveLocale, getActiveStrings, getColors, getStoredWalletPaySession as getStoredApplePaySession, getStoredWalletPaySession, getStrings, i18n, interpolate, isHypercoreChain, isOnrampTokenFresh, mergeColors, normalizeLocale, resolveComponentTokens, sendEvmWithdraw, sendHypercoreWithdraw, sendSolanaWithdraw, setActiveLocale, setStoredWalletPaySession as setStoredApplePaySession, setStoredWalletPaySession, truncateAddress, useAddressBalance, useAllowedCountry, useAnalytics, useDebounce, useDepositPolling, useDepositQuote, useI18n, 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, 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 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { DirectExecutionSucceededEvent, DirectExecutionFailedEvent, DirectExecutionResponse, ChainType, EvmContractCall, DepositMethod, DepositEvent, Wallet, ProductType, WalletPayMethod, 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, SupportedDestinationTokensResponse, SupportedDepositTokensResponse, VerifyAddressResponse } from '@unifold/core';
 export { ChainType, DepositMethod } from '@unifold/core';
 import * as React$1 from 'react';
 import { MutableRefObject } from 'react';
@@ -535,7 +535,8 @@ interface BuyWithCardProps {
 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;
 
-type View = 'loading_config' | 'disabled' | 'email_input' | 'phone_input' | 'submitting_session' | 'email_otp' | 'phone_otp' | 'amount' | 'checking_deposit' | 'success' | 'guest_limit_reached' | 'limit_upgrade_intro' | 'limit_upgrade_form' | 'limit_upgrade_submitting' | 'limit_upgrade_failed';
+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 View = WalletPayView;
 interface BuyWithWalletPayProps {
     /**
      * Device wallet the user pays with. Coinbase runs both wallets through the
@@ -594,6 +595,99 @@ interface BuyWithWalletPayHandle {
 }
 declare const BuyWithWalletPay: React$1.ForwardRefExoticComponent<BuyWithWalletPayProps & React$1.RefAttributes<BuyWithWalletPayHandle>>;
 
+/**
+ * The figures shown on the device-wallet confirm screen.
+ *
+ * The Coinbase order *is* the quote: it is priced at creation time, and
+ * `source_amount` comes back as `paymentTotal` — what the wallet is charged,
+ * fees included. Everything here is derived from that one response so the
+ * screen can never show a total the user won't actually be billed.
+ */
+interface WalletPayQuote {
+    /** Fiat charged, inclusive of fees. */
+    totalFiat: number;
+    /** Fiat before fees. */
+    subtotalFiat: number;
+    /** Sum of the provider's fees, in `fiatCurrency`. */
+    feeFiat: number;
+    /** Uppercase ISO 4217 code for every fiat figure above. */
+    fiatCurrency: string;
+    /** Crypto delivered, when the provider priced it. */
+    receiveAmount: string | null;
+    receiveCurrency: string;
+    receiveNetwork: string;
+}
+declare function buildWalletPayQuote(session: CoinbaseWalletPaySessionResponse): WalletPayQuote;
+/** `1234.5, "USD"` → `"$1,234.50"`, falling back to `"USD 1234.50"`. */
+declare function formatFiat(amount: number, currency: string): string;
+/**
+ * Render a crypto amount without the long tail of zeros Coinbase pads its
+ * quotes with (`"97.560000"` → `"97.56"`), keeping at most 6 decimals so a
+ * sub-cent asset still shows something.
+ */
+declare function formatCryptoAmount(value: string): string;
+/**
+ * Error-correction level for a QR the user scans off a screen with a phone.
+ *
+ * `H` (30% recovery) is the nicest choice for short payloads, but it also
+ * inflates the module count, and a Coinbase payment link carries a session
+ * token. Past a few hundred characters the modules get too small to scan
+ * reliably at modal size, so trade recovery for density as the payload grows —
+ * a screen-displayed code has no print smudges or creases to recover from.
+ */
+declare function qrErrorCorrectionLevel(value: string): 'L' | 'M' | 'Q' | 'H';
+
+interface WalletPayQrCheckoutProps {
+    method: WalletPayMethod;
+    /** Coinbase-hosted checkout page for this order. */
+    paymentUrl: string;
+    quote: WalletPayQuote;
+}
+/**
+ * Desktop hand-off for the headless Coinbase device wallets: the code to scan,
+ * what it will cost, and the fact that we're watching for the payment.
+ *
+ * Apple Pay on the web only renders on a device that has the wallet, on a
+ * domain Apple has verified — which is Coinbase's own checkout page, loaded
+ * top-level. A desktop browser can't satisfy that, so rather than trying to host
+ * the sheet here we hand the priced order to the user's phone. A phone never
+ * sees this screen; it pays from the amount screen in one tap.
+ *
+ * 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;
+
+type MobilePlatform = 'ios' | 'android';
+
+/**
+ * The mobile OS, or `null` for desktop and for any phone we can't identify.
+ *
+ * `null` covers desktop, an unfamiliar user agent and the server, because all
+ * three mean the same thing to callers: nothing here justifies taking an option
+ * away. Anything that hides a payment method on this should treat `null` as
+ * "allow", so an unrecognised device never loses something that might have
+ * worked.
+ */
+declare function useMobilePlatform(): MobilePlatform | null;
+
+/**
+ * Whether this device can pay with a given wallet itself.
+ *
+ * A phone only carries the wallet its own OS ships: Apple Pay does not exist on
+ * Android, and Coinbase's guest checkout treats Google Pay as the Android rail.
+ * Offering the other one is a dead end — the user reaches Coinbase's page and no
+ * payment sheet appears.
+ *
+ * `null` — desktop, an unfamiliar user agent, or a server render — allows both,
+ * and that is the important half of the rule. On desktop the QR hands the
+ * payment to a phone we know nothing about, so neither wallet can be ruled out;
+ * the user picks whichever their own phone has. Guessing here would remove a
+ * working option, where guessing on a known platform only ever removes one that
+ * would have failed.
+ */
+declare function platformSupportsWalletPay(method: WalletPayMethod, platform: MobilePlatform | null): boolean;
+
 type BuyWithApplePayProps = Omit<BuyWithWalletPayProps, 'method'>;
 /**
  * Apple Pay entry point into the headless Coinbase guest-checkout flow.
@@ -664,19 +758,25 @@ interface DepositsModalProps {
 }
 declare function DepositsModal({ open, onOpenChange, onCloseAll, executions: sessionExecutions, userId, publishableKey, themeClass, }: DepositsModalProps): react_jsx_runtime.JSX.Element;
 
+type ErrorCorrectionLevel = 'L' | 'M' | 'Q' | 'H';
 interface StyledQRCodeProps {
     value: string;
     size?: number;
     imageUrl?: string;
     imageSize?: number;
     darkMode?: boolean;
+    /**
+     * Lower levels pack a long payload into fewer, larger modules, which scans
+     * better off a screen than a dense high-recovery code.
+     */
+    errorCorrectionLevel?: ErrorCorrectionLevel;
 }
 interface QRCodeSkeletonProps {
     size?: number;
     darkMode?: boolean;
 }
 declare function QRCodeSkeleton({ size, darkMode }: QRCodeSkeletonProps): react_jsx_runtime.JSX.Element;
-declare function StyledQRCode({ value, size, imageUrl, imageSize, darkMode, }: StyledQRCodeProps): react_jsx_runtime.JSX.Element;
+declare function StyledQRCode({ value, size, imageUrl, imageSize, darkMode, errorCorrectionLevel, }: StyledQRCodeProps): react_jsx_runtime.JSX.Element;
 
 interface TransferCryptoButtonProps {
     onClick: () => void;
@@ -919,9 +1019,6 @@ interface ManualDepositButtonProps {
  * Returns null for auto modes or after the user has clicked.
  */
 declare function ManualDepositButton({ depositConfirmationMode, showWaitingUi, onIveDeposited, }: ManualDepositButtonProps): react_jsx_runtime.JSX.Element | null;
-/**
- * Inline "Checking for deposit" spinner for the footer row.
- */
 declare function CheckingForDepositIndicator({ showWaitingUi, hasExecution, }: {
     showWaitingUi: boolean;
     hasExecution: boolean;
@@ -1309,6 +1406,10 @@ var common = {
 	dateTime: "{{date}} at {{time}}",
 	"continue": "Continue",
 	processing: "Processing",
+	checkingFor: "Checking for {{target}}",
+	depositTarget: "deposit",
+	paymentTarget: "payment",
+	paymentFailed: "Payment failed",
 	terms: "Terms",
 	help: "Help",
 	done: "Done",
@@ -1593,6 +1694,8 @@ var depositModal = {
 		verifyEmail: "Verify your email",
 		verifyPhone: "Verify your phone",
 		amount: "Amount",
+		gettingQuote: "Getting quote",
+		delivering: "Payment received",
 		checkingDeposit: "Checking deposit",
 		success: "Success",
 		limitReached: "Limit reached",
@@ -1603,7 +1706,6 @@ var depositModal = {
 		payAmount: "Pay ${{amount}} via Cash App"
 	},
 	cashAppScan: {
-		mobile: "Complete payment in Cash App",
 		desktop: "Scan to pay"
 	},
 	cashAppErrors: {
@@ -1611,6 +1713,9 @@ var depositModal = {
 		createSessionFailed: "Failed to create session",
 		paymentFailed: "Payment failed",
 		cashAppPaymentFailed: "Cash App payment failed"
+	},
+	exchangeScan: {
+		desktop: "Scan to transfer"
 	}
 };
 var checkoutModal = {
@@ -1775,11 +1880,26 @@ var buyWithApplePay = {
 		tokenRoutingUnavailable: "Token routing unavailable",
 		preparing: "Preparing {{wallet}}",
 		payWith: "Pay with",
-		pay: "Pay"
+		pay: "Pay",
+		confirm: "Confirm",
+		gettingQuote: "Getting your quote…"
+	},
+	payment: {
+		scanToPay: "Scan to pay",
+		total: "Total",
+		viewBreakdown: "View breakdown",
+		hideBreakdown: "Hide breakdown",
+		subtotal: "Amount",
+		fees: "Fees",
+		youReceive: "You receive",
+		copyLink: "Copy payment link",
+		copied: "Copied"
 	},
 	checking: {
 		title: "Checking for your deposit…",
-		description: "Return if the payment is not made."
+		description: "Return if the payment is not made.",
+		paidTitle: "Payment received",
+		paidDescription: "Your funds are on the way. This usually takes less than a minute."
 	},
 	upgrade: {
 		limitReached: "{{wallet}} limit reached",
@@ -1810,7 +1930,8 @@ var buyWithApplePay = {
 		destinationNotConfigured: "Deposit destination not configured. Please contact support.",
 		tokenInfoUnavailable: "Unable to load token information. Please try again.",
 		depositWalletUnavailable: "Deposit wallet unavailable. Please try again.",
-		requestFailed: "Unable to process your request. Please try again later."
+		requestFailed: "Unable to process your request. Please try again later.",
+		tabBlocked: "Couldn't open the {{wallet}} page. Allow pop-ups for this site and try again."
 	},
 	"continue": "Continue",
 	cancel: "Cancel",
@@ -1822,7 +1943,9 @@ var buyWithApplePay = {
 		verifyInfoFailed: "We couldn't verify your information. Please check your SSN and date of birth and try again.",
 		limitUpgradeFailed: "Failed to request limit upgrade",
 		verificationFailed: "Verification failed",
-		createPaymentFailed: "Failed to create payment"
+		createPaymentFailed: "Failed to create payment",
+		paymentFailed: "That payment didn't go through. Check the amount and try again.",
+		paymentExpired: "This payment expired before it was completed. Try again."
 	}
 };
 var payWithStripeLink = {
@@ -2113,6 +2236,10 @@ declare const i18n: {
         dateTime: string;
         continue: string;
         processing: string;
+        checkingFor: string;
+        depositTarget: string;
+        paymentTarget: string;
+        paymentFailed: string;
         terms: string;
         help: string;
         done: string;
@@ -2397,6 +2524,8 @@ declare const i18n: {
             verifyEmail: string;
             verifyPhone: string;
             amount: string;
+            gettingQuote: string;
+            delivering: string;
             checkingDeposit: string;
             success: string;
             limitReached: string;
@@ -2407,7 +2536,6 @@ declare const i18n: {
             payAmount: string;
         };
         cashAppScan: {
-            mobile: string;
             desktop: string;
         };
         cashAppErrors: {
@@ -2416,6 +2544,9 @@ declare const i18n: {
             paymentFailed: string;
             cashAppPaymentFailed: string;
         };
+        exchangeScan: {
+            desktop: string;
+        };
     };
     checkoutModal: {
         title: string;
@@ -2580,10 +2711,25 @@ declare const i18n: {
             preparing: string;
             payWith: string;
             pay: string;
+            confirm: string;
+            gettingQuote: string;
+        };
+        payment: {
+            scanToPay: string;
+            total: string;
+            viewBreakdown: string;
+            hideBreakdown: string;
+            subtotal: string;
+            fees: string;
+            youReceive: string;
+            copyLink: string;
+            copied: string;
         };
         checking: {
             title: string;
             description: string;
+            paidTitle: string;
+            paidDescription: string;
         };
         upgrade: {
             limitReached: string;
@@ -2615,6 +2761,7 @@ declare const i18n: {
             tokenInfoUnavailable: string;
             depositWalletUnavailable: string;
             requestFailed: string;
+            tabBlocked: string;
         };
         continue: string;
         cancel: string;
@@ -2627,6 +2774,8 @@ declare const i18n: {
             limitUpgradeFailed: string;
             verificationFailed: string;
             createPaymentFailed: string;
+            paymentFailed: string;
+            paymentExpired: string;
         };
     };
     payWithStripeLink: {
@@ -3431,4 +3580,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, 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, WithdrawConfirmingView, WithdrawDoubleInput, WithdrawExecutionItem, WithdrawForm, WithdrawModal, type WithdrawModalProps, WithdrawTokenSelector, type WithdrawTransactionInfo, buttonVariants, clearStoredWalletPaySession as clearStoredApplePaySession, clearStoredWalletPaySession, cn, colors, defaultColors, detectBrowserLocale, detectBrowserWallet, getActiveLocale, getActiveStrings, getColors, getStoredWalletPaySession as getStoredApplePaySession, getStoredWalletPaySession, getStrings, i18n, interpolate, isHypercoreChain, isOnrampTokenFresh, mergeColors, normalizeLocale, resolveComponentTokens, sendEvmWithdraw, sendHypercoreWithdraw, sendSolanaWithdraw, setActiveLocale, setStoredWalletPaySession as setStoredApplePaySession, setStoredWalletPaySession, truncateAddress, useAddressBalance, useAllowedCountry, useAnalytics, useDebounce, useDepositPolling, useDepositQuote, useI18n, 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, 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 };