@unifold/ui-react 0.1.80 → 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, ActionType, 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)
@@ -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 */
@@ -1354,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;
@@ -1442,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",
@@ -1455,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}}",
@@ -1528,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...",
@@ -1759,6 +1868,7 @@ var depositModal = {
 		cash: "Use Cash"
 	},
 	applePayHeader: {
+		enterContact: "Verification",
 		enterEmail: "Enter your email",
 		enterPhone: "Enter your phone",
 		verifyEmail: "Verify your email",
@@ -1841,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",
@@ -1850,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"
@@ -1870,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: "."
 	},
@@ -2339,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;
@@ -2352,6 +2463,9 @@ declare const i18n: {
         help: string;
         done: string;
         from: string;
+        to: string;
+        youPay: string;
+        intentAddressDisclaimer: string;
         max: string;
         or: string;
         minimumAmount: string;
@@ -2426,7 +2540,6 @@ declare const i18n: {
             minimumForTokenOnChain: string;
             amountAdjusted: string;
             minimumDeposit: string;
-            walletWillPrompt: string;
         };
         confirming: {
             waitingTitle: string;
@@ -2656,6 +2769,7 @@ declare const i18n: {
             cash: string;
         };
         applePayHeader: {
+            enterContact: string;
             enterEmail: string;
             enterPhone: string;
             verifyEmail: string;
@@ -2748,7 +2862,6 @@ declare const i18n: {
             flowTransfer: string;
             flowDirect: string;
             flowDestination: string;
-            secureNote: string;
         };
         holdings: {
             title: string;
@@ -3364,10 +3477,23 @@ interface UseDepositQuoteParams {
  * that destination amount. Exact-in (`sourceAmount`): estimated destination
  * amount received for that source amount. The response includes the project's
  * platform fee from billing (`platform_fee_percent`).
- * Server-side cached for 1 minute; client re-fetches on param change.
+ * 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;
@@ -3786,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 };