@unifold/ui-react 0.1.81 → 0.1.83

package/dist/index.d.mts

@@ -66,6 +66,31 @@ interface UseDepositPollingOptions {
      */
     depositWalletIds?: string[];
     enabled?: boolean;
+    /**
+     * When the current deposit attempt began, as a timestamp. Only executions
+     * created after it are attributed to the attempt. Pass a new value to start a
+     * fresh attempt and `null` when there is none in progress.
+     *
+     * Callers fall into two groups, decided by how the deposit can arrive:
+     *
+     * - **Address-based rails** (crypto transfer, bank transfer) are passive: the
+     *   displayed address can be paid at any moment, from anywhere, so every
+     *   deposit seen while the screen is open belongs to the user. They enable
+     *   polling for the life of the screen and leave this unset, which baselines
+     *   detection at the moment the screen opened.
+     * - **Session-based rails** (card, exchange, Stripe, connected wallet,
+     *   Cash App, Apple/Google Pay, Binance Pay) can only produce a deposit once
+     *   the user has committed to one — Confirm on a review screen, or Continue on
+     *   an input screen — so detection has to start there, not when the screen
+     *   opened.
+     *
+     * Session rails pass this from Continue / Confirm and clear it when the user
+     * returns to the amount / input screen (or the main menu, which unmounts).
+     * Card is the exception that keeps the timestamp after leaving the review —
+     * its provider tab can still pay out. Leaving it unset also keeps the older
+     * implicit behaviour, where turning `enabled` on is itself the start.
+     */
+    sessionStartedAt?: number | null;
     onDepositSuccess?: (data: {
         message: string;
         transaction?: unknown;
@@ -84,6 +109,10 @@ interface UseDepositPollingOptions {
      * (e.g. browser wallet confirming step).
      */
     immediateDirectPolling?: boolean;
+    /** `/query` cadence. Default 2.5s. */
+    queryIntervalMs?: number;
+    /** `/poll` cadence. Default 5s. */
+    pollIntervalMs?: number;
 }
 interface UseDepositPollingResult {
     executions: DirectExecutionResponse[];
@@ -95,7 +124,7 @@ interface UseDepositPollingResult {
     /** Call this when user clicks "I've made the deposit" (manual mode) */
     handleIveDeposited: () => void;
 }
-declare function useDepositPolling({ userId, publishableKey, clientSecret, depositConfirmationMode, depositWalletId, depositWalletIds, enabled, immediateDirectPolling, onDepositSuccess, onDepositError, }: UseDepositPollingOptions): UseDepositPollingResult;
+declare function useDepositPolling({ userId, publishableKey, clientSecret, depositConfirmationMode, depositWalletId, depositWalletIds, enabled, sessionStartedAt, immediateDirectPolling, queryIntervalMs, pollIntervalMs, onDepositSuccess, onDepositError, }: UseDepositPollingOptions): UseDepositPollingResult;
 
 type WalletType = 'phantom-solana' | 'phantom-ethereum' | 'metamask' | 'coinbase' | 'solflare' | 'backpack' | 'glow' | 'trust' | 'trust-solana' | 'rainbow' | 'rabby' | 'okx' | 'robinhood';
 interface BrowserWalletInfo {
@@ -120,39 +149,8 @@ interface BrowserWalletInfo {
 
 /** Quick amount chips on the browser wallet "Enter amount" step */
 type BrowserWalletAmountQuickSelect = 'usd' | 'percentage';
-interface SolanaWalletProvider {
-    isPhantom?: boolean;
-    isConnected?: boolean;
-    publicKey?: {
-        toString(): string;
-    };
-    connect(opts?: {
-        onlyIfTrusted?: boolean;
-    }): Promise<{
-        publicKey: {
-            toString(): string;
-        };
-    }>;
-    disconnect(): Promise<void>;
-    signTransaction(transaction: any): Promise<any>;
-    on(event: string, callback: (...args: unknown[]) => void): void;
-    off(event: string, callback: (...args: unknown[]) => void): void;
-}
-interface EvmWalletProvider {
-    isMetaMask?: boolean;
-    isPhantom?: boolean;
-    isCoinbaseWallet?: 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;
-}
-
-type DepositModalInitialScreen = 'main' | 'transfer' | 'card' | 'cashapp' | 'apple_pay' | 'google_pay' | 'tracker' | 'pay_with_exchange' | 'exchange_connect' | 'wallet_connect' | 'bank_transfer' | 'stripe_link';
+
+type DepositModalInitialScreen = 'main' | 'transfer' | 'card' | 'cashapp' | 'interac' | 'apple_pay' | 'google_pay' | 'tracker' | 'pay_with_exchange' | 'exchange_connect' | 'wallet_connect' | 'bank_transfer' | 'stripe_link';
 interface DepositModalProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -228,6 +226,13 @@ interface DepositModalProps {
     enableConnectExchange?: boolean;
     /** Enable "Pay with Cash App" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
     enableCashApp?: boolean;
+    /**
+     * Enable the "Pay with Interac" option (CAD e-Transfer, Canada). Opt-in like
+     * Stripe Link: resolves as flag ?? dashboard `interac.enabled` ?? false. The
+     * platform `interac.is_hidden` hard hide (project whitelist + Canada-only)
+     * always wins regardless of this flag.
+     */
+    enableInterac?: boolean;
     /**
      * Enable the Stripe "Pay with Link" option. Overrides the dashboard default.
      * Resolves as flag ?? dashboard `stripe_link.enabled` ?? false (Link is
@@ -286,8 +291,9 @@ interface DepositModalProps {
      */
     googlePaySubTitle?: string;
     /**
-     * Enable the "Bank Transfer" section (SEPA, etc.). Overrides dashboard default.
-     * Resolves as flag ?? dashboard `bank_transfer.enabled` ?? true.
+     * Enable the "Bank Transfer" section (SEPA, ACH, etc.).
+     * Resolves as flag ?? dashboard `bank_transfer.enabled` ?? false.
+     * The platform `bank_transfer.is_hidden` hard hide always wins.
      *
      * Even when enabled, each rail inside is gated on the caller's country. Only
      * rails the caller can use are listed; when none are, the section explains that
@@ -344,7 +350,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, 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;
+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, enableInterac, 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;
@@ -473,7 +479,9 @@ interface TransferCryptoDoubleInputProps {
 }
 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';
+type CardOnrampView = 'amount' | 'quotes' | 'review' | 'processing';
+
+type CardView = CardOnrampView;
 interface BuyWithCardProps {
     userId: string;
     publishableKey: string;
@@ -520,7 +528,7 @@ interface BuyWithCardProps {
 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' | '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 WalletPayView = 'loading_config' | 'disabled' | 'contact_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 {
     /**
@@ -573,6 +581,7 @@ interface BuyWithWalletPayProps {
     /** Invoked when the user taps the exit button on a terminal screen. */
     onExit?: () => void;
     themeClass?: string;
+    assetCdnUrl?: string;
 }
 /** Imperative handle: `requestBack` returns true when the child handled the back. */
 interface BuyWithWalletPayHandle {
@@ -698,20 +707,39 @@ declare const BuyWithGooglePay: React$1.ForwardRefExoticComponent<BuyWithGoogleP
 
 interface StoredWalletPaySession {
     email: string;
-    /** US phone in E.164 (e.g. +12345678901). */
+    /** US phone in E.164 (e.g. +12345678901). Collected on every flow. */
     phone: string;
     termsAcceptedAt: string;
+    /**
+     * Per-channel proof clocks. Mirrors of the token's `pv` / `ev` claims:
+     * whenever `onrampToken` is written these are re-derived from it, so they
+     * cannot disagree with the credential they describe.
+     */
     phoneVerifiedAt?: string;
     emailVerifiedAt?: string;
-    /** Onramp verification JWT — skips OTP for as long as it is valid. */
+    /** The onramp JWT. One per device+user; carries every clock earned so far. */
     onrampToken?: string;
     /** Epoch ms; treated as expired 60s before this to avoid order-race. */
     onrampTokenExpiresAtMs?: number;
+    /**
+     * Merchant `external_user_id` stamped when we minted the JWT. Legacy
+     * Coinbase records omit this — skip helpers treat that as "re-OTP".
+     */
+    externalUserId?: string;
 }
 declare function getStoredWalletPaySession(userId: string): StoredWalletPaySession | null;
 declare function setStoredWalletPaySession(userId: string, contact: StoredWalletPaySession): void;
 declare function clearStoredWalletPaySession(userId: string): void;
+/** Wallet pay: the Coinbase routes are `@RequireVerifiedFactors('phone')`. */
 declare function isOnrampTokenFresh(contact: StoredWalletPaySession | null): boolean;
+/** Bank transfer / KYC: those routes are `@RequireVerifiedFactors('email')`. */
+declare function isEmailOnrampTokenFresh(contact: StoredWalletPaySession | null): boolean;
+/**
+ * The token to hand the bank-transfer and identity routes, or nothing. Gated
+ * on a fresh `ev` because those routes 401 anything else, and a 401 there
+ * used to cost the user their wallet-pay credential.
+ */
+declare function bankTransferOnrampToken(contact: StoredWalletPaySession | null): string | undefined;
 
 interface CurrencyModalProps {
     open: boolean;
@@ -846,7 +874,10 @@ interface StripeLinkButtonProps {
 }
 declare function StripeLinkButton({ onClick, title, subtitle, iconUrl }: StripeLinkButtonProps): react_jsx_runtime.JSX.Element;
 
-type BankTransferView = 'providers' | 'amount' | 'pending';
+/** Sheet surface: identity-verification screens plus instructions / preparing. */
+type BankTransferSheetView = 'kyc_info' | 'kyc_docs' | 'kyc_review' | 'kyc_questionnaire' | 'tos' | 'rejected' | 'instructions' | 'preparing';
+
+type BankTransferView = 'amount' | 'contact_input' | 'phone_input' | 'submitting_session' | 'email_otp' | 'session_failed' | 'pending' | BankTransferSheetView;
 interface BankTransferProps {
     userId: string;
     publishableKey: string;
@@ -874,17 +905,20 @@ interface BankTransferProps {
     }) => void;
     /** Optional USD prefilled for the amount input (treated like manual user input). */
     prefilledAmountUsd?: string;
+    /** Shown on the details credit line. */
+    projectName?: string;
+    /** Host-platform-trusted email. Locks the contact field when valid. */
+    userEmail?: string;
+    /** Header back: info screens consume this first, then the modal falls through to amount. */
+    backHandlerRef?: React$1.MutableRefObject<(() => boolean) | null>;
 }
 /**
- * Bank-transfer deposit flow. Three steps:
- *  1. Provider list (returned by `getBankTransferProviders`)
- *  2. Amount input (Swapped-only today; other providers may diverge later)
- *  3. Pending — Swapped widget opens in a new tab, we poll for the deposit
- *
- * The widget itself handles KYC + IBAN entry + payment; we just collect the
- * fiat amount up-front so users aren't surprised by the default in the widget.
+ * Bank-transfer deposit flow. Amount first — the rail is picked from IP
+ * (USD/ACH today) and the currency pill becomes a selector once more than one
+ * fiat is enabled. Unifold rails then go through contact → KYC → bank details;
+ * Swapped still opens its widget and we poll for the deposit.
  */
-declare function BankTransfer({ userId, publishableKey, view: externalView, onViewChange, destinationChainType, destinationChainId, destinationTokenAddress, destinationTokenSymbol, wallets, defaultToken: externalDefaultToken, assetCdnUrl, onDepositSuccess, onEvent, onDepositError, prefilledAmountUsd, }: BankTransferProps): react_jsx_runtime.JSX.Element;
+declare function BankTransfer({ userId, publishableKey, view: externalView, onViewChange, destinationChainType, destinationChainId, destinationTokenAddress, destinationTokenSymbol, wallets, defaultToken: externalDefaultToken, assetCdnUrl, onDepositSuccess, onEvent, onDepositError, prefilledAmountUsd, projectName, userEmail, backHandlerRef, }: BankTransferProps): react_jsx_runtime.JSX.Element;
 
 interface DepositWallet {
     id: string;
@@ -1033,6 +1067,7 @@ declare function CheckingForDepositIndicator({ showWaitingUi, hasExecution, }: {
 interface ConfirmingViewProps {
     isConfirming: boolean;
     onClose: () => void;
+    onBack?: () => void;
     executions?: DirectExecutionResponse[];
     isPolling?: boolean;
     onNewDeposit?: () => void;
@@ -1043,7 +1078,7 @@ interface ConfirmingViewProps {
     /** Snapshot of amount_received_usd taken when the transaction was submitted. */
     amountReceivedUsdAtSubmission?: string | null;
 }
-declare function ConfirmingView({ isConfirming, onClose, executions, isPolling, onNewDeposit, onDone, paymentIntentStatus, amountReceivedUsd, amountReceivedUsdAtSubmission, }: ConfirmingViewProps): react_jsx_runtime.JSX.Element;
+declare function ConfirmingView({ isConfirming, onClose, onBack, executions, isPolling, onNewDeposit, onDone, paymentIntentStatus, amountReceivedUsd, amountReceivedUsdAtSubmission, }: ConfirmingViewProps): react_jsx_runtime.JSX.Element;
 
 interface CheckoutModalProps {
     open: boolean;
@@ -1319,46 +1354,6 @@ declare function WithdrawConfirmingView({ txInfo, executions, onClose, onViewTra
 
 declare const HYPERCORE_CHAIN_ID = "1337";
 
-declare function isHypercoreChain(chainId: string): boolean;
-
-type DetectedWallet = {
-    name: string;
-    address: string;
-} & ({
-    chainFamily: 'evm';
-    provider: EvmWalletProvider;
-} | {
-    chainFamily: 'solana';
-    provider: SolanaWalletProvider;
-});
-declare function sendEvmWithdraw(params: {
-    provider: EvmWalletProvider;
-    fromAddress: string;
-    depositWalletAddress: string;
-    sourceTokenAddress: string;
-    sourceChainId: string;
-    amountBaseUnit: string;
-}): Promise<string>;
-declare function sendSolanaWithdraw(params: {
-    provider: SolanaWalletProvider;
-    fromAddress: string;
-    depositWalletAddress: string;
-    sourceTokenAddress: string;
-    amountBaseUnit: string;
-    publishableKey: string;
-}): Promise<string>;
-
-declare function sendHypercoreWithdraw(params: {
-    provider: EvmWalletProvider;
-    fromAddress: string;
-    depositWalletAddress: string;
-    sourceTokenAddress: string;
-    amount: string;
-    publishableKey: string;
-}): Promise<void>;
-
-declare function detectBrowserWallet(chainType: string, senderAddress?: string): Promise<DetectedWallet | null>;
-
 type BrowserWalletErrorReporter = (error: unknown, metadata: {
     stage: BrowserWalletProviderErrorStage;
     chainType?: 'ethereum' | 'solana';
@@ -1544,6 +1539,9 @@ var common = {
 	loading: "Loading...",
 	search: "Search",
 	close: "Close",
+	noResults: "No matches found",
+	selectCountry: "Select country",
+	selectState: "Select state",
 	review: "Review",
 	tryAgain: "Try Again",
 	somethingWentWrong: "Something went wrong",
@@ -1766,6 +1764,7 @@ var transferCrypto = {
 			not_opted_in: "Please make sure you opt-in {{token_symbol}}({{chain_name}}) before receiving funds",
 			insufficient_balance: "Recipient account does not meet the minimum balance requirement",
 			account_not_found: "Recipient account does not exist on {{chain_name}}",
+			destination_tag_required: "This {{chain_name}} address requires a memo tag. Please provide your memo tag as well, in the format address:memotag",
 			validation_error: "Unable to verify recipient address on {{chain_name}}"
 		},
 		defaultError: "The recipient address cannot receive funds for the selected token"
@@ -1833,12 +1832,201 @@ var depositModal = {
 	bankTransfer: {
 		title: "Bank Transfer",
 		subtitle: "SEPA, ACH and more",
-		unavailableInCountry: "Bank transfer isn't available for this deposit."
+		unavailableInCountry: "Bank transfer isn't available for this deposit.",
+		verificationIntroTitle: "Verification Required",
+		verificationIntroBody: "Verify your identity to get a bank account you can send and receive payments with.",
+		preparingTitle: "Setting up your account",
+		preparingBody: "This may take a moment",
+		sessionFailedTitle: "Failed to create your account",
+		sessionFailedBody: "Please try again, or ",
+		sessionFailedSupport: "contact support.",
+		detailsTitle: "Bank Transfer Details",
+		instructions: {
+			title: "Send {{amount}} {{currency}} to your bank transfer details",
+			subtitle: "Send the funds to the account details below. Bank transfers take time. Please check back later.",
+			accountNumber: "Account number",
+			routingNumber: "Routing number",
+			iban: "IBAN",
+			bic: "BIC",
+			accountHolder: "Account holder",
+			beneficiary: "Beneficiary",
+			bankName: "Bank",
+			bankAddress: "Bank address",
+			swift: "SWIFT",
+			reference: "Reference",
+			amount: "Amount",
+			currency: "Currency",
+			rails: "Rails",
+			copied: "Copied",
+			processingTime: "Processing time",
+			feeLabel: "Fee",
+			railsTitle: "Fees and delivery",
+			ach_push: "ACH",
+			rtp: "RTP",
+			wire: "Wire",
+			sepa: "SEPA",
+			instant: "Instant",
+			minutes: "{{count}} min",
+			days: "{{min}}–{{max}} days",
+			fee: "{{rate}}% + {{flat}}",
+			min: "Min {{amount}}",
+			canClose: "Bank transfers can take some time. Please come back later.",
+			showFees: "Show fees and processing time",
+			showMoreDetails: "Show more details"
+		}
 	},
 	cashAppMenu: {
 		title: "Pay with Cash App",
 		subtitle: "Deposit via Cash App"
 	},
+	interacMenu: {
+		title: "Pay with Interac",
+		subtitle: "e-Transfer from a Canadian bank"
+	},
+	interac: {
+		"continue": "Continue",
+		checking: "Checking...",
+		submitting: "Submitting...",
+		verifying: "Verifying...",
+		creatingSession: "Creating order...",
+		emailSubtitle: "Enter your email to get started with Interac e-Transfer.",
+		emailPlaceholder: "you@example.com",
+		onboardSubtitle: "A few details are required to set up your account. This information is sent to our Canadian payment partner and is not stored by us.",
+		onboardUpdateSubtitle: "Your account is missing a few details. Confirm the information below to continue.",
+		additionalInfoSubtitle: "Our payment partner needs a few more details before your first purchase.",
+		additionalInfoFields: {
+			source_of_funds: "Source of funds",
+			intended_use_of_usdc: "Intended use of USDC",
+			how_did_you_hear: "How did you hear about us?",
+			who_referred_you: "Who referred you?",
+			previous_crypto_experience: "Previous crypto experience"
+		},
+		additionalInfoSelect: "Select an option",
+		additionalInfoOptions: {
+			source_of_funds: {
+				salary: "Salary",
+				savings: "Savings",
+				businessIncome: "Business income",
+				investments: "Investments",
+				pension: "Pension or retirement",
+				inheritanceOrGift: "Inheritance or gift",
+				other: "Other"
+			},
+			intended_use_of_usdc: {
+				savings: "Savings",
+				investing: "Investing or trading",
+				payments: "Payments or purchases",
+				remittance: "Sending funds to family or friends",
+				defi: "DeFi",
+				other: "Other"
+			},
+			how_did_you_hear: {
+				search: "Search engine",
+				social: "Social media",
+				friendOrFamily: "Friend or family",
+				news: "News or blog",
+				ad: "Advertisement",
+				other: "Other"
+			},
+			who_referred_you: {
+				friendOrFamily: "Friend or family",
+				colleague: "Colleague",
+				advisor: "Financial advisor",
+				community: "Online community",
+				noOne: "No one — not referred"
+			},
+			previous_crypto_experience: {
+				none: "None",
+				beginner: "Beginner",
+				intermediate: "Intermediate",
+				advanced: "Advanced"
+			}
+		},
+		sections: {
+			personal: "Personal details",
+			address: "Home address"
+		},
+		fields: {
+			firstName: "First name",
+			lastName: "Last name",
+			dob: "Date of birth",
+			phone: "Canadian phone number",
+			addressLine1: "Street address",
+			addressLine2: "Apartment, suite, etc. (optional)",
+			city: "City",
+			province: "Province",
+			provincePlaceholder: "Select province",
+			postalCode: "Postal code",
+			occupation: "Occupation"
+		},
+		attestation: "I confirm that I am not a politically exposed person and that I am not acting on behalf of a third party.",
+		otpSubtitle: "We emailed a login code to {{email}}. Enter it below to continue.",
+		otpCodePlaceholder: "0000",
+		otpVerify: "Verify code",
+		otpResend: "Resend code",
+		otpResendIn: "Resend in {{seconds}}s",
+		phoneSendCode: "Send code",
+		phoneSending: "Sending...",
+		phoneOtpSubtitle: "We texted a code to {{phone}}. Enter it below to continue.",
+		kycTitle: "Verify your identity",
+		kycSubtitle: "A quick one-time identity verification is required before your first purchase.",
+		kycStart: "Start verification",
+		kycOpening: "Opening...",
+		kycOpenNewTab: "Having trouble? Open in a new tab",
+		kycInReviewTitle: "Verification in review",
+		kycInReviewSubtitle: "Your documents were submitted and are being reviewed. This usually takes a few minutes — this screen advances automatically.",
+		kycReopen: "Reopen verification",
+		quoteLoading: "Fetching quote...",
+		quoteReceive: "You'll receive approximately {{amount}} USDC",
+		instructions: "Your Interac payment request is being prepared…",
+		instructionsWithPayee: "Send an Interac e-Transfer to {{payee}} for the exact amount below.",
+		instructionsWithLink: "Pay the Interac request below from your bank — scan the QR or open the link.",
+		amountLabel: "Amount",
+		payeeLabel: "Send to",
+		referenceLabel: "Reference",
+		payNow: "Pay with your bank",
+		scanToPay: "Scan with your phone to pay",
+		expiresIn: "Expires in {{time}}",
+		expiresInOneHour: "This order expires one hour after creation",
+		waitingForTransfer: "Waiting for your e-Transfer...",
+		cancelOrder: "Cancel order",
+		cancelOrderWarning: "Only cancel if you haven't sent your payment — a cancelled order can't be completed.",
+		cancelOrderConfirm: "Yes, cancel order",
+		cancelOrderKeep: "Keep order",
+		cancelling: "Cancelling...",
+		sessionExpiredTitle: "This order has expired",
+		sessionExpiredSubtitle: "If you already sent the e-Transfer, your deposit will still be processed. Otherwise, start a new order.",
+		startOver: "New order",
+		paymentProcessing: "Payment processing",
+		paymentProcessingSubtitle: "Your Interac e-Transfer is being confirmed...",
+		paymentReceived: "Payment received",
+		paymentReceivedSubtitle: "Delivering to your destination token...",
+		blockedTitle: "Account unavailable",
+		blockedSubtitle: "This payment method isn't available for your account. Please choose a different deposit method.",
+		errors: {
+			statusFailed: "Unable to check your account status",
+			onboardFailed: "Failed to create your account",
+			otpFailed: "Failed to verify the code",
+			invalidOtp: "Invalid or expired code. Request a new one and try again.",
+			phoneSendFailed: "Failed to send the verification code",
+			phoneVerifyFailed: "Failed to verify your phone number",
+			cancelFailed: "Failed to cancel the order",
+			profileUpdateFailed: "Failed to update your profile",
+			kycUrlFailed: "Failed to start verification",
+			missingWallet: "No deposit wallet available",
+			createSessionFailed: "Failed to create order",
+			paymentFailed: "Payment failed",
+			quoteFailed: "Failed to fetch a quote"
+		},
+		review: {
+			estimatedTime: "< 30 min",
+			disclaimer: "Your quoted rate is locked in when you place the order. The order expires if your payment isn't received within one hour.",
+			confirm: "Confirm order"
+		}
+	},
+	interacHeader: {
+		payAmount: "Pay {{amount}} via Interac"
+	},
 	applePayMenu: {
 		title: "Pay with Apple Pay",
 		subtitle: "Instant • Debit card only"
@@ -2060,19 +2248,22 @@ var buyWithCard = {
 var buyWithApplePay = {
 	email: {
 		label: "Email",
-		placeholder: "you@example.com"
+		placeholder: "you@example.com",
+		"continue": "Continue"
 	},
 	phone: {
 		label: "US phone number",
 		placeholder: "555 123 4567",
 		invalid: "Enter a valid US mobile number (no VoIP).",
 		reverified: "Re-verified every 60 days.",
-		sendCode: "Send code"
+		sendCode: "Send code",
+		conflict: "This email is linked to another phone number.",
+		contactSupport: "Contact support"
 	},
 	otp: {
 		sentTo: "Sent to {{target}}",
 		placeholder: "000000",
-		incorrect: "Incorrect code. Please try again.",
+		incorrect: "Invalid OTP code. Please try again.",
 		resend: "Resend code",
 		resendIn: "Resend in {{seconds}}s",
 		verify: "Verify"
@@ -2344,12 +2535,18 @@ var withdrawModal = {
 	receiveChain: "Receive chain",
 	recipientAddress: "Recipient address",
 	recipientAddressPlaceholder: "Enter wallet address",
+	recipientAddressPlaceholderXrpl: "Enter wallet address, or address:memotag",
 	amount: "Amount",
 	amountPlaceholder: "0.00",
 	balance: "Balance",
 	minimum: "min",
 	withdraw: "Withdraw",
 	invalidAddress: "Please enter a valid address",
+	invalidXrplAddress: "Please enter a valid {{chain_name}} address. If your recipient requires a memo tag, please provide it as well, in the format address:memotag",
+	memoTag: "Memo tag",
+	memoTagPlaceholder: "e.g. 12345",
+	memoTagRequiredHint: "This {{chain_name}} address requires a memo tag before it can receive funds",
+	invalidMemoTag: "Memo tag must be a whole number between 0 and 4294967295",
 	invalidAmount: "Please enter a valid amount",
 	verifyingAddress: "Verifying address...",
 	loading: "Loading...",
@@ -2391,6 +2588,110 @@ var hypercore = {
 	withdrawFee: "~{{fee}} fee will be applied to this withdrawal.",
 	activationFee: "~{{fee}} fee is required to activate a new HyperCore account."
 };
+var identityVerification = {
+	introTitle: "Verification Required",
+	introBody: "Verify your identity to continue.",
+	stepOf: "Step {{current}} of {{total}}",
+	stepOfNamed: "Step {{current}} of {{total}} · {{label}}",
+	verifyTitle: "Verify your identity",
+	steps: {
+		name: "What's your name?",
+		address: "Where do you live?",
+		identity: "A few more details",
+		questionnaire: "Source of funds",
+		docs: "Verify your ID"
+	},
+	dobParts: {
+		day: "Day",
+		month: "Month",
+		year: "Year"
+	},
+	reviewTitle: "Reviewing your documents",
+	reviewBody: "This usually takes a minute. We'll continue automatically.",
+	rejectedTitle: "Verification unsuccessful",
+	rejectedBody: "We couldn't verify your identity. Contact support if you think this is a mistake.",
+	expiredDoc: "Your {{doc}} expired. Please upload it again.",
+	questionnaireTitle: "Source of funds",
+	tosDisclaimer: {
+		prefix: "By continuing, you agree to ",
+		separator: ", ",
+		lastSeparator: " and ",
+		suffix: ".",
+		agreements: {
+			terms_of_service: "Terms of Service"
+		}
+	},
+	tosLoadFailed: "Failed to load terms of service",
+	docsMintFailed: "Failed to start document verification",
+	docs: {
+		identity: "ID document",
+		poa: "proof of address",
+		selfie: "selfie"
+	},
+	fields: {
+		first_name: "First name",
+		last_name: "Last name",
+		dob: "Date of birth",
+		nationality: "Nationality",
+		tin: "Social Security number",
+		address_line_1: "Address line 1",
+		address_line_2: "Address line 2 (optional)",
+		city: "City",
+		subdivision: "State",
+		postal_code: "Postal code",
+		country: "Country"
+	},
+	questionnaire: {
+		actingAsIntermediary: "I am acting as an intermediary",
+		employmentStatus: "Employment status",
+		expectedMonthlyPaymentsUsd: "Expected monthly payments (USD)",
+		mostRecentOccupation: "Occupation",
+		accountPurpose: "Account purpose",
+		accountPurposeOther: "Please specify",
+		sourceOfFunds: "Source of funds",
+		employment: {
+			employed: "Employed",
+			homemaker: "Homemaker",
+			retired: "Retired",
+			self_employed: "Self-employed",
+			student: "Student",
+			unemployed: "Unemployed"
+		},
+		monthly: {
+			"0_4999": "$0 – $4,999",
+			"5000_9999": "$5,000 – $9,999",
+			"10000_49999": "$10,000 – $49,999",
+			"50000_plus": "$50,000+"
+		},
+		purpose: {
+			charitable_donations: "Charitable donations",
+			ecommerce_retail_payments: "Ecommerce / retail payments",
+			investment_purposes: "Investment",
+			operating_a_company: "Operating a company",
+			payments_to_friends_or_family_abroad: "Payments to friends or family abroad",
+			personal_or_living_expenses: "Personal or living expenses",
+			protect_wealth: "Protect wealth",
+			purchase_goods_and_services: "Purchase goods and services",
+			receive_payment_for_freelancing: "Receive payment for freelancing",
+			receive_salary: "Receive salary",
+			other: "Other"
+		},
+		source: {
+			company_funds: "Company funds",
+			ecommerce_reseller: "Ecommerce reseller",
+			gambling_proceeds: "Gambling proceeds",
+			gifts: "Gifts",
+			government_benefits: "Government benefits",
+			inheritance: "Inheritance",
+			investments_loans: "Investments / loans",
+			pension_retirement: "Pension / retirement",
+			salary: "Salary",
+			sale_of_assets_real_estate: "Sale of assets / real estate",
+			savings: "Savings",
+			someone_elses_funds: "Someone else's funds"
+		}
+	}
+};
 var en = {
 	common: common,
 	executionDetails: executionDetails,
@@ -2408,7 +2709,8 @@ var en = {
 	payWithStripeLink: payWithStripeLink,
 	withdrawModal: withdrawModal,
 	incident: incident,
-	hypercore: hypercore
+	hypercore: hypercore,
+	identityVerification: identityVerification
 };
 
 /**
@@ -2445,6 +2747,9 @@ declare const i18n: {
         loading: string;
         search: string;
         close: string;
+        noResults: string;
+        selectCountry: string;
+        selectState: string;
         review: string;
         tryAgain: string;
         somethingWentWrong: string;
@@ -2667,6 +2972,7 @@ declare const i18n: {
                 not_opted_in: string;
                 insufficient_balance: string;
                 account_not_found: string;
+                destination_tag_required: string;
                 validation_error: string;
             };
             defaultError: string;
@@ -2735,11 +3041,200 @@ declare const i18n: {
             title: string;
             subtitle: string;
             unavailableInCountry: string;
+            verificationIntroTitle: string;
+            verificationIntroBody: string;
+            preparingTitle: string;
+            preparingBody: string;
+            sessionFailedTitle: string;
+            sessionFailedBody: string;
+            sessionFailedSupport: string;
+            detailsTitle: string;
+            instructions: {
+                title: string;
+                subtitle: string;
+                accountNumber: string;
+                routingNumber: string;
+                iban: string;
+                bic: string;
+                accountHolder: string;
+                beneficiary: string;
+                bankName: string;
+                bankAddress: string;
+                swift: string;
+                reference: string;
+                amount: string;
+                currency: string;
+                rails: string;
+                copied: string;
+                processingTime: string;
+                feeLabel: string;
+                railsTitle: string;
+                ach_push: string;
+                rtp: string;
+                wire: string;
+                sepa: string;
+                instant: string;
+                minutes: string;
+                days: string;
+                fee: string;
+                min: string;
+                canClose: string;
+                showFees: string;
+                showMoreDetails: string;
+            };
         };
         cashAppMenu: {
             title: string;
             subtitle: string;
         };
+        interacMenu: {
+            title: string;
+            subtitle: string;
+        };
+        interac: {
+            continue: string;
+            checking: string;
+            submitting: string;
+            verifying: string;
+            creatingSession: string;
+            emailSubtitle: string;
+            emailPlaceholder: string;
+            onboardSubtitle: string;
+            onboardUpdateSubtitle: string;
+            additionalInfoSubtitle: string;
+            additionalInfoFields: {
+                source_of_funds: string;
+                intended_use_of_usdc: string;
+                how_did_you_hear: string;
+                who_referred_you: string;
+                previous_crypto_experience: string;
+            };
+            additionalInfoSelect: string;
+            additionalInfoOptions: {
+                source_of_funds: {
+                    salary: string;
+                    savings: string;
+                    businessIncome: string;
+                    investments: string;
+                    pension: string;
+                    inheritanceOrGift: string;
+                    other: string;
+                };
+                intended_use_of_usdc: {
+                    savings: string;
+                    investing: string;
+                    payments: string;
+                    remittance: string;
+                    defi: string;
+                    other: string;
+                };
+                how_did_you_hear: {
+                    search: string;
+                    social: string;
+                    friendOrFamily: string;
+                    news: string;
+                    ad: string;
+                    other: string;
+                };
+                who_referred_you: {
+                    friendOrFamily: string;
+                    colleague: string;
+                    advisor: string;
+                    community: string;
+                    noOne: string;
+                };
+                previous_crypto_experience: {
+                    none: string;
+                    beginner: string;
+                    intermediate: string;
+                    advanced: string;
+                };
+            };
+            sections: {
+                personal: string;
+                address: string;
+            };
+            fields: {
+                firstName: string;
+                lastName: string;
+                dob: string;
+                phone: string;
+                addressLine1: string;
+                addressLine2: string;
+                city: string;
+                province: string;
+                provincePlaceholder: string;
+                postalCode: string;
+                occupation: string;
+            };
+            attestation: string;
+            otpSubtitle: string;
+            otpCodePlaceholder: string;
+            otpVerify: string;
+            otpResend: string;
+            otpResendIn: string;
+            phoneSendCode: string;
+            phoneSending: string;
+            phoneOtpSubtitle: string;
+            kycTitle: string;
+            kycSubtitle: string;
+            kycStart: string;
+            kycOpening: string;
+            kycOpenNewTab: string;
+            kycInReviewTitle: string;
+            kycInReviewSubtitle: string;
+            kycReopen: string;
+            quoteLoading: string;
+            quoteReceive: string;
+            instructions: string;
+            instructionsWithPayee: string;
+            instructionsWithLink: string;
+            amountLabel: string;
+            payeeLabel: string;
+            referenceLabel: string;
+            payNow: string;
+            scanToPay: string;
+            expiresIn: string;
+            expiresInOneHour: string;
+            waitingForTransfer: string;
+            cancelOrder: string;
+            cancelOrderWarning: string;
+            cancelOrderConfirm: string;
+            cancelOrderKeep: string;
+            cancelling: string;
+            sessionExpiredTitle: string;
+            sessionExpiredSubtitle: string;
+            startOver: string;
+            paymentProcessing: string;
+            paymentProcessingSubtitle: string;
+            paymentReceived: string;
+            paymentReceivedSubtitle: string;
+            blockedTitle: string;
+            blockedSubtitle: string;
+            errors: {
+                statusFailed: string;
+                onboardFailed: string;
+                otpFailed: string;
+                invalidOtp: string;
+                phoneSendFailed: string;
+                phoneVerifyFailed: string;
+                cancelFailed: string;
+                profileUpdateFailed: string;
+                kycUrlFailed: string;
+                missingWallet: string;
+                createSessionFailed: string;
+                paymentFailed: string;
+                quoteFailed: string;
+            };
+            review: {
+                estimatedTime: string;
+                disclaimer: string;
+                confirm: string;
+            };
+        };
+        interacHeader: {
+            payAmount: string;
+        };
         applePayMenu: {
             title: string;
             subtitle: string;
@@ -2962,6 +3457,7 @@ declare const i18n: {
         email: {
             label: string;
             placeholder: string;
+            continue: string;
         };
         phone: {
             label: string;
@@ -2969,6 +3465,8 @@ declare const i18n: {
             invalid: string;
             reverified: string;
             sendCode: string;
+            conflict: string;
+            contactSupport: string;
         };
         otp: {
             sentTo: string;
@@ -3245,12 +3743,18 @@ declare const i18n: {
         receiveChain: string;
         recipientAddress: string;
         recipientAddressPlaceholder: string;
+        recipientAddressPlaceholderXrpl: string;
         amount: string;
         amountPlaceholder: string;
         balance: string;
         minimum: string;
         withdraw: string;
         invalidAddress: string;
+        invalidXrplAddress: string;
+        memoTag: string;
+        memoTagPlaceholder: string;
+        memoTagRequiredHint: string;
+        invalidMemoTag: string;
         invalidAmount: string;
         verifyingAddress: string;
         loading: string;
@@ -3292,6 +3796,110 @@ declare const i18n: {
         withdrawFee: string;
         activationFee: string;
     };
+    identityVerification: {
+        introTitle: string;
+        introBody: string;
+        stepOf: string;
+        stepOfNamed: string;
+        verifyTitle: string;
+        steps: {
+            name: string;
+            address: string;
+            identity: string;
+            questionnaire: string;
+            docs: string;
+        };
+        dobParts: {
+            day: string;
+            month: string;
+            year: string;
+        };
+        reviewTitle: string;
+        reviewBody: string;
+        rejectedTitle: string;
+        rejectedBody: string;
+        expiredDoc: string;
+        questionnaireTitle: string;
+        tosDisclaimer: {
+            prefix: string;
+            separator: string;
+            lastSeparator: string;
+            suffix: string;
+            agreements: {
+                terms_of_service: string;
+            };
+        };
+        tosLoadFailed: string;
+        docsMintFailed: string;
+        docs: {
+            identity: string;
+            poa: string;
+            selfie: string;
+        };
+        fields: {
+            first_name: string;
+            last_name: string;
+            dob: string;
+            nationality: string;
+            tin: string;
+            address_line_1: string;
+            address_line_2: string;
+            city: string;
+            subdivision: string;
+            postal_code: string;
+            country: string;
+        };
+        questionnaire: {
+            actingAsIntermediary: string;
+            employmentStatus: string;
+            expectedMonthlyPaymentsUsd: string;
+            mostRecentOccupation: string;
+            accountPurpose: string;
+            accountPurposeOther: string;
+            sourceOfFunds: string;
+            employment: {
+                employed: string;
+                homemaker: string;
+                retired: string;
+                self_employed: string;
+                student: string;
+                unemployed: string;
+            };
+            monthly: {
+                "0_4999": string;
+                "5000_9999": string;
+                "10000_49999": string;
+                "50000_plus": string;
+            };
+            purpose: {
+                charitable_donations: string;
+                ecommerce_retail_payments: string;
+                investment_purposes: string;
+                operating_a_company: string;
+                payments_to_friends_or_family_abroad: string;
+                personal_or_living_expenses: string;
+                protect_wealth: string;
+                purchase_goods_and_services: string;
+                receive_payment_for_freelancing: string;
+                receive_salary: string;
+                other: string;
+            };
+            source: {
+                company_funds: string;
+                ecommerce_reseller: string;
+                gambling_proceeds: string;
+                gifts: string;
+                government_benefits: string;
+                inheritance: string;
+                investments_loans: string;
+                pension_retirement: string;
+                salary: string;
+                sale_of_assets_real_estate: string;
+                savings: string;
+                someone_elses_funds: string;
+            };
+        };
+    };
 };
 /**
  * Interpolate parameters into a template string
@@ -3358,6 +3966,248 @@ declare function I18nProvider({ children, locale }: I18nProviderProps): react_js
  */
 declare function useI18n(): I18nContextValue;
 
+/**
+ * Canonical country table for the SDK.
+ *
+ * One row per ISO 3166-1 assigned country or territory (249). Every other
+ * country list in the SDK — region groups, residence pickers, nationality
+ * selectors, dial-code pickers — is derived from this one, so a country's name,
+ * code and calling code can't drift between flows.
+ *
+ * Codes are ISO 3166-1 alpha-2 only. Providers that store the three-letter
+ * form convert at the API, so the client never maps between the two.
+ *
+ * Display names follow Stripe's EU KYC reference tables. Calling codes are
+ * ITU E.164 country codes, without the leading `+`; the six uninhabited
+ * territories have none.
+ */
+interface Country {
+    /** ISO 3166-1 alpha-2, e.g. `US`. */
+    alpha2: string;
+    /** English display name. */
+    name: string;
+    /** E.164 calling code without `+`, e.g. `1`. Absent for uninhabited territories. */
+    dialCode?: string;
+}
+/** Every ISO 3166-1 country, in alpha-2 order. Use {@link ALL_COUNTRIES} for display. */
+declare const COUNTRIES: readonly Country[];
+/** Every country, sorted by display name for pickers. */
+declare const ALL_COUNTRIES: readonly Country[];
+/** Look a country up by ISO 3166-1 alpha-2, case-insensitively. */
+declare function findCountry(code: string | undefined | null): Country | undefined;
+/** Canonical alpha-2, or `undefined` when unknown. */
+declare function toAlpha2(code: string | undefined | null): string | undefined;
+/** Display name for a code, falling back to the code itself when unknown. */
+declare function countryName(code: string): string;
+/** Calling code for a country, without the leading `+`. */
+declare function dialCode(code: string): string | undefined;
+
+/**
+ * Region groups a KYC or payment flow can be scoped to.
+ *
+ * Groups nest where the everyday meaning nests: `ASIA` contains `SEA` and
+ * `INDIA`, `EEA` contains `EU`, `LATAM` contains `CARIBBEAN`. Asking for a
+ * parent returns its children too, so a flow that is "open across Asia" can say
+ * `['ASIA']` rather than enumerating the pieces, while one that is only open in
+ * South East Asia can say `['SEA']`.
+ *
+ * Membership is by ISO 3166-1 alpha-2. Dependent territories sit with the
+ * region they are geographically in, not with their sovereign — French Guiana is
+ * `LATAM`, not `EU`, because that is where its residents are.
+ */
+type CountryGroup = 'US' | 'CANADA' | 'UK' | 'EU' | 'EEA' | 'EUROPE' | 'INDIA' | 'SEA' | 'ASIA' | 'MENA' | 'AFRICA' | 'CARIBBEAN' | 'LATAM' | 'OCEANIA';
+/** Alpha-2 members of each group, children included. */
+declare const COUNTRY_GROUPS: Record<CountryGroup, readonly string[]>;
+/** True when the country is in the group. Alpha-2, case-insensitive. */
+declare function isInGroup(code: string | undefined | null, group: CountryGroup): boolean;
+interface GetKycCountryListOptions {
+    /** Regions to include. Omit for every supported country. */
+    group?: readonly CountryGroup[];
+    /** Individual countries to include on top of `group`, ISO 3166-1 alpha-2. */
+    whitelisted?: readonly string[];
+    /**
+     * Countries to leave out, ISO 3166-1 alpha-2. Applied last, so it removes a
+     * country that `group` or `whitelisted` would otherwise bring in — an explicit
+     * exclusion outranks an inclusion.
+     */
+    blacklisted?: readonly string[];
+}
+/**
+ * Build a flat, de-duplicated country list for a picker.
+ *
+ * `getKycCountryList()` is every supported country. `getKycCountryList({ group: ['EU'],
+ * whitelisted: ['US'] })` is the EU plus the United States. Unknown codes in
+ * `whitelisted` or `blacklisted` are ignored rather than thrown on, since the
+ * lists are usually configuration.
+ *
+ * Sorted by display name.
+ */
+declare function getKycCountryList(options?: GetKycCountryListOptions): Country[];
+
+/** A US state or territory: USPS / ISO 3166-2:US code and display name. */
+interface UsState {
+    code: string;
+    name: string;
+}
+/**
+ * USPS/ISO 3166-2:US codes for the `state` field of a US address.
+ *
+ * Both Stripe and our identity API want the two-letter code, not the name, and
+ * reject anything else — so this list is the only way a state reaches the API,
+ * replacing a free-text box that accepted any two characters.
+ *
+ * Includes DC and the five inhabited territories: their addresses are US
+ * addresses with US ZIP codes, so someone living there has no other code to
+ * give. Sorted by name, which is the order the picker shows them in.
+ */
+declare const US_STATES: readonly UsState[];
+/** Display name for a state code, or the code itself if it isn't one we list. */
+declare function usStateName(code: string): string;
+
+/** Same CDN convention as `/icons/currencies/svg/{code}.svg`. Native ratio, long side 28. */
+declare function countryFlagIconPath(alpha2: string): string;
+/** Raster of the same flag. Native ratio, long side 128. */
+declare function countryFlagPngPath(alpha2: string): string;
+/**
+ * Flag emoji for a country, built from the two regional indicator symbols the
+ * alpha-2 code maps to. Kept for callers that want a text-only flag; the picker
+ * itself uses {@link CountryFlag} because Windows ships no flag glyphs and
+ * renders these as a letter pair.
+ */
+declare function countryFlag(code: string): string;
+/**
+ * Flag image served from the asset CDN.
+ *
+ * An image rather than an emoji so the same artwork renders on every platform:
+ * emoji flags depend on the system font, which on Windows has none. Each flag is
+ * ~1.4 KB and `loading="lazy"`, so a long picker only fetches the rows on
+ * screen, and the browser cache makes later opens free.
+ *
+ * Unknown or non-alpha-2 codes render nothing.
+ */
+declare function CountryFlag({ code, assetCdnUrl, size, className, }: {
+    code: string;
+    assetCdnUrl?: string;
+    /** Width in px. Height follows the flag's native ratio. */
+    size?: number;
+    className?: string;
+}): react_jsx_runtime.JSX.Element | null;
+
+/** One row of the sheet: a country, or a subdivision such as a US state. */
+interface RegionOption {
+    /**
+     * Value handed back from `onSelect` — an ISO 3166-1 country code or an
+     * ISO 3166-2 subdivision code, in whatever form the surrounding API speaks.
+     */
+    code: string;
+    name: string;
+    /**
+     * Alpha-2 country code for the flag when `code` isn't one — a subdivision
+     * whose parent flag should show. Defaults to `code`.
+     */
+    flagCode?: string;
+}
+/**
+ * Marks the element a sheet should cover. The sheet portals into the nearest
+ * ancestor carrying this attribute, so a form several components deep can raise
+ * a picker over the whole modal body — footer included — without every layer in
+ * between having to know about it. With no anchor in the tree the sheet renders
+ * in place, against the nearest positioned ancestor.
+ */
+declare const REGION_SHEET_ANCHOR_ATTR = "data-uf-sheet-anchor";
+/**
+ * Match options against what someone typed.
+ *
+ * Deliberately literal rather than fuzzy: with a couple of hundred countries and
+ * two-letter codes, fuzzy matching surfaces confusing near-misses. People search
+ * a list like this by typing the start of a name, its ISO code, or — in the phone
+ * picker — the calling code, with or without the leading `+`.
+ *
+ * Calling codes are only matched when the sheet is actually showing them.
+ * Subdivision codes collide with country ones (`DE` is both Delaware and
+ * Germany), so an unconditional dial lookup would let "49" surface Delaware.
+ */
+declare function filterRegions(options: readonly RegionOption[], query: string, matchDialCode?: boolean): RegionOption[];
+interface RegionSelectorSheetProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    options: readonly RegionOption[];
+    /** Currently selected code, if any. */
+    selectedCode: string;
+    onSelect: (code: string) => void;
+    title: string;
+    /**
+     * Show each country's E.164 calling code instead of its ISO code, turning the
+     * same sheet into the phone country-code picker.
+     */
+    showDialCode?: boolean;
+    /**
+     * Off for lists whose codes aren't countries — a US state has no flag, and
+     * the CDN would be asked for Germany's for Delaware.
+     */
+    showFlags?: boolean;
+    /**
+     * Trailing ISO/dial-code badge. Off for lists whose `code` isn't a country
+     * or subdivision (e.g. questionnaire option ids).
+     */
+    showCode?: boolean;
+    /** Asset CDN override for the flag images, as passed to the modal. */
+    assetCdnUrl?: string;
+}
+/**
+ * Full-panel picker for a country or a subdivision, replacing a native
+ * `<select>`.
+ *
+ * A native dropdown renders with the browser's own chrome, which ignores the
+ * theme entirely — a light popup over a dark modal — and is painful with a list
+ * this long. This follows the same shape as `TokenSelectorSheet`: a title row, a
+ * search field, and a scrollable themed list.
+ *
+ * Positioned `absolute` against the nearest positioned ancestor, so the host
+ * flow needs a `relative` wrapper around the area the sheet should cover —
+ * `DepositModal` provides one around its body.
+ */
+declare function RegionSelectorSheet({ open, onOpenChange, options, selectedCode, onSelect, title, showDialCode, showFlags, showCode, assetCdnUrl, }: RegionSelectorSheetProps): react_jsx_runtime.JSX.Element | null;
+
+interface RegionPickerButtonProps {
+    /** Text to show — the selected region, or a placeholder when nothing is set. */
+    label: string;
+    /** Dim the label when it stands in for an empty selection. */
+    placeholder?: boolean;
+    /** Country code of the current selection, to show its flag alongside the label. */
+    flagCode?: string;
+    /** Asset CDN override for the flag image, as passed to the modal. */
+    assetCdnUrl?: string;
+    onClick: () => void;
+    /**
+     * Size to the label rather than filling the row, for the calling-code control
+     * that sits beside a phone input. Dial codes run from one to three digits, and
+     * the flag, gaps and chevron around them take up most of the control, so a
+     * width that suits `+1` ellipsises `+372`.
+     */
+    fitContent?: boolean;
+    /**
+     * Match the shorter inputs used by the KYC forms (`py-2.5`) rather than the
+     * taller registration ones (`py-3`), so the control lines up with whatever
+     * field sits beside it.
+     */
+    dense?: boolean;
+    /**
+     * There is only one possible value, so render the selection as a read-only
+     * field: no chevron, nothing to click. A disabled button would still invite
+     * the click and read as temporarily unavailable rather than absent.
+     */
+    locked?: boolean;
+    /**
+     * Overrides merged last, so a form whose text inputs are styled differently
+     * from the theme's default input (the KYC form uses the card surface) can make
+     * the trigger match the fields beside it.
+     */
+    style?: React$1.CSSProperties;
+}
+/** Trigger that opens a {@link RegionSelectorSheet}, styled as an input. */
+declare function RegionPickerButton({ label, placeholder, flagCode, assetCdnUrl, onClick, fitContent, dense, locked, style: styleOverride, }: RegionPickerButtonProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Result of the useAllowedCountry hook
  */
@@ -3468,6 +4318,16 @@ interface UseDepositQuoteParams {
     adjustForSlippage?: boolean;
     /** When true and both tokens are stablecoins, returns a 1:1 quote without swap provider. */
     stablecoinParity?: boolean;
+    /**
+     * Deposit wallet that will send the swap. Optional — when omitted the
+     * API prices the route with a placeholder address for the source chain.
+     */
+    senderAddress?: string;
+    /**
+     * Final destination that should receive the swap. Optional — when omitted
+     * the API prices the route with a placeholder address for the destination chain.
+     */
+    recipientAddress?: string;
     enabled?: boolean;
 }
 /**
@@ -3912,4 +4772,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, 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 };
+export { ALL_COUNTRIES, 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, COUNTRIES, COUNTRY_GROUPS, type CardTokens, CheckingForDepositIndicator, CheckoutModal, type CheckoutModalProps, CoinbaseConnect, type ComponentConfig, type ComponentOverrides, type ComponentTokens, ConfirmingView, ConnectExchangeButton, type ContainerTokens, type Country, CountryFlag, type CountryGroup, CurrencyListItem, CurrencyListSection, CurrencyModal, type CustomThemeColors, type DepositConfirmationMode, DepositDetailContent, DepositExecutionItem, DepositHeader, type DepositMenuLayout, type DepositMenuLayoutType, DepositModal, type DepositModalInitialScreen, DepositSuccessToast, type DepositTab, DepositTrackerButton, DepositWithCardButton, DepositsModal, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, EIP6963_BOOTSTRAP_SCRIPT, type FontConfig, type GetKycCountryListOptions, 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, REGION_SHEET_ANCHOR_ATTR, type RegionOption, RegionPickerButton, type RegionPickerButtonProps, RegionSelectorSheet, type RegionSelectorSheetProps, type ResolvedFonts, SUPPORTED_LOCALES, type SearchTokens, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, type SolanaStandardAccount, type SolanaStandardWallet, 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, US_STATES, type UsState, 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, bankTransferOnrampToken, buildWalletPayQuote, buttonVariants, clearStoredWalletPaySession as clearStoredApplePaySession, clearStoredWalletPaySession, cn, colors, connectSolanaStandardWallet, countryFlag, countryFlagIconPath, countryFlagPngPath, countryName, defaultColors, detectBrowserLocale, detectConnectedBrowserWallet, dialCode, filterRegions, findCountry, findSolanaStandardWallet, formatCryptoAmount, formatFiat, getActiveLocale, getActiveStrings, getAuthorizedSolanaStandardAccounts, getColors, getKycCountryList, getSolanaStandardWallets, getStoredWalletPaySession as getStoredApplePaySession, getStoredWalletPaySession, getStrings, i18n, interpolate, isEmailOnrampTokenFresh, isInGroup, isOnrampTokenFresh, isSolanaWalletDetectedViaWalletStandard, mergeColors, normalizeLocale, platformSupportsWalletPay, qrErrorCorrectionLevel, requestEip6963Providers, resolveComponentTokens, setActiveLocale, setStoredWalletPaySession as setStoredApplePaySession, setStoredWalletPaySession, signSolanaStandardTransaction, startBrowserWalletDiscovery, subscribeSolanaStandardAccountChanges, subscribeSolanaStandardWallets, toAlpha2, truncateAddress, usStateName, useAddressBalance, useAllowedCountry, useAnalytics, useDebounce, useDepositPolling, useDepositQuote, useI18n, useMobilePlatform, usePaymentIntent, usePublicIncident, useSourceTokenValidation, useSupportedDepositTokens, useSupportedDestinationTokens, useTheme, useTokenMetadata, useVerifyRecipientAddress, useWithdrawPolling };