@unifold/connect-react 0.1.67 → 0.1.68-beta.1

package/dist/index.d.mts

@@ -3,8 +3,8 @@ import React from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { ChainType, DepositConfirmationMode, DepositMethod, DepositModalInitialScreen, ThemeMode, ThemeConfig, FontConfig, ComponentConfig, WithdrawTransactionInfo, AllowedCountryResult } from '@unifold/ui-react';
 export { AllowedCountryResult, BrowserWalletAmountQuickSelect, Button, ButtonProps, ButtonTokens, CardTokens, ComponentConfig, ComponentTokens, ConfirmingView, ContainerTokens, CustomThemeColors, DepositConfirmationMode, DepositModalInitialScreen as DepositInitialScreen, DepositMethod, FontConfig, HeaderTokens, InputTokens, ListTokens, SearchTokens, ThemeColors, ThemeConfig, ThemeMode, UseSupportedDepositTokensOptions, WithdrawTransactionInfo, useSupportedDepositTokens } from '@unifold/ui-react';
-import { EvmContractCall, DirectExecutionSucceededEvent, DepositEvent, WithdrawDirectExecutionSucceededEvent, WithdrawEvent } from '@unifold/core';
-export { ActionType, AutoSwapRequest, AutoSwapResponse, ChainType, CreateDepositAddressRequest, DefaultTokenChain, DefaultTokenMetadata, DefaultTokenResponse, DepositAddressResponse, DepositEvent, DepositEventType, DepositQuote, DepositQuoteRequest, DestinationToken, DestinationTokenChain, DirectExecution, DirectExecutionResponse, ExecutionStatus, FeaturedToken, FiatCurrenciesResponse, FiatCurrency, I18nStrings, IconUrl, IpAddressResponse, LockedQuoteLimits, LockedQuotePreview, LockedQuotePreviewRequest, OnrampQuote, OnrampQuotesRequest, OnrampQuotesResponse, OnrampSessionCreatedData, OnrampSessionCreatedEvent, OnrampSessionRequest, OnrampSessionResponse, PaymentIntent, PaymentIntentDepositAddress, PaymentIntentStatus, PaymentIntentType, PaymentNetwork, ProjectConfigResponse, QueryExecutionsRequest, QueryExecutionsResponse, SOLANA_USDC_ADDRESS, SendSolanaTransactionRequest, SendSolanaTransactionResponse, SourceToken, SourceTokenNetwork, SupportedChain, SupportedDepositTokensResponse, SupportedDestinationTokensResponse, SupportedSourceTokensQuery, SupportedSourceTokensResponse, SupportedToken, TokenChain, TokenChainIconUrl, TokenChainsResponse, UserIpInfo, Wallet, WithdrawDirectExecutionSucceededEvent, WithdrawEvent, WithdrawEventType, createDepositAddress, createOnrampSession, generatePrefixedKSUID, getApiBaseUrl, getChainName, getDefaultOnrampToken, getDepositQuote, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getWalletByChainType, i18n, queryExecutions, retrievePaymentIntent, sendSolanaTransaction, setApiConfig, useUserIp } from '@unifold/core';
+import { CheckoutMethod, CheckoutPaymentIntent, CheckoutEvent, EvmContractCall, DirectExecutionSucceededEvent, DepositEvent, WithdrawDirectExecutionSucceededEvent, WithdrawEvent } from '@unifold/core';
+export { ActionType, AutoSwapRequest, AutoSwapResponse, ChainType, CheckoutEvent, CheckoutEventType, CheckoutMethod, CheckoutPaymentIntent, CheckoutPaymentIntentData, CheckoutPaymentIntentSucceededEvent, CreateDepositAddressRequest, DefaultTokenChain, DefaultTokenMetadata, DefaultTokenResponse, DepositAddressResponse, DepositEvent, DepositEventType, DepositQuote, DepositQuoteRequest, DestinationToken, DestinationTokenChain, DirectExecution, DirectExecutionResponse, ExecutionStatus, FeaturedToken, FiatCurrenciesResponse, FiatCurrency, I18nStrings, IconUrl, IpAddressResponse, LockedQuoteLimits, LockedQuotePreview, LockedQuotePreviewRequest, OnrampQuote, OnrampQuotesRequest, OnrampQuotesResponse, OnrampSessionCreatedData, OnrampSessionCreatedEvent, OnrampSessionRequest, OnrampSessionResponse, PaymentIntent, PaymentIntentDepositAddress, PaymentIntentStatus, PaymentIntentType, PaymentNetwork, ProjectConfigResponse, QueryExecutionsRequest, QueryExecutionsResponse, SOLANA_USDC_ADDRESS, SendSolanaTransactionRequest, SendSolanaTransactionResponse, SourceToken, SourceTokenNetwork, StripeAccessTokenResponse, StripeAuthIntentResponse, StripeConfigResponse, StripeConfirmRequest, StripeConsumerWallet, StripeCreateSessionRequest, StripeCryptoCustomer, StripeCustomerVerification, StripeDefaultTokenResponse, StripeListResponse, StripeOnrampSession, StripeOnrampTransactionDetails, StripePaymentToken, StripeQuoteRequest, StripeQuotesResponse, SupportedChain, SupportedDepositTokensResponse, SupportedDestinationTokensResponse, SupportedSourceTokensQuery, SupportedSourceTokensResponse, SupportedToken, TokenChain, TokenChainIconUrl, TokenChainsResponse, UserIpInfo, Wallet, WithdrawDirectExecutionSucceededEvent, WithdrawEvent, WithdrawEventType, createDepositAddress, createOnrampSession, generatePrefixedKSUID, getApiBaseUrl, getChainName, getDefaultOnrampToken, getDepositQuote, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getWalletByChainType, i18n, queryExecutions, retrievePaymentIntent, sendSolanaTransaction, setApiConfig, stripeConfirmSession, stripeCreateAuthIntent, stripeCreateSession, stripeExchangeTokens, stripeGetConfig, stripeGetCustomer, stripeGetDefaultToken, stripeGetQuotes, stripeGetSession, stripeListPaymentTokens, stripeListWallets, stripeRefreshQuote, stripeRefreshToken, useUserIp } from '@unifold/core';
 
 interface UnifoldConnectProviderConfig {
     publishableKey: string;
@@ -45,6 +45,19 @@ interface UnifoldConnectProviderConfig {
         enableConnectExchange?: boolean;
         /** Enable "Pay with Cash App" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableCashApp?: boolean;
+        /** Enable "Pay with Link" headless onramp option. Defaults to false. */
+        enableStripeLink?: boolean;
+        /**
+         * Enable "Pay with Apple Pay" (headless Coinbase) option. Overrides
+         * dashboard default. Resolves as flag ?? dashboard `apple_pay.enabled` ??
+         * true. The server still gates per-region (US-only, NY excluded at
+         * launch) at order-creation time.
+         */
+        enableApplePay?: boolean;
+        /** Main menu — Apple Pay row title. @default `"Pay with Apple Pay"` */
+        applePayTitle?: string;
+        /** Main menu — Apple Pay row subtitle. @default `"Instant"` */
+        applePaySubTitle?: string;
         /** Simple accent/primary color override (applies to both light and dark modes) */
         accentColor?: string;
         /** Full theme color customization per mode */
@@ -72,7 +85,7 @@ interface UnifoldConnectProviderConfig {
         /** Deposit with Card onramp: hide wallet address disclaimer. @default false */
         hideDisplayDescription?: boolean;
         /** Connect Wallet → Enter amount: `percentage` (10%, 25%, 50%, 75%, MAX) or `usd` ($25…). @default `percentage` */
-        browserWalletAmountQuickSelect?: "usd" | "percentage";
+        browserWalletAmountQuickSelect?: 'usd' | 'percentage';
     };
 }
 interface DepositResult {
@@ -96,6 +109,15 @@ interface DepositConfig {
     destinationTokenSymbol: string;
     /** Address that receives the deposited funds. */
     recipientAddress: string;
+    /**
+     * Pre-trusted email for the host platform's signed-in user. When provided,
+     * Apple Pay (headless Coinbase) skips both the localStorage email check and
+     * the email-OTP screen — it passes `email_already_verified: true` and uses
+     * this address directly. Phone OTP is still required (Coinbase mandates
+     * phone re-verification every 60 days). Has no effect on the other deposit
+     * flows.
+     */
+    externalUserEmail?: string;
     /**
      * Array of contract calls to execute on the destination chain when delivering funds.
      * Each entry specifies a target contract address, hex-encoded data, and optional value in wei (defaults to "0").
@@ -117,6 +139,8 @@ interface DepositConfig {
     defaultSourceSymbol?: string;
     /** How to confirm deposit: 'auto_ui' (default), 'auto_silent', or 'manual' */
     depositConfirmationMode?: DepositConfirmationMode;
+    /** User's email address — used to pre-fill onramp provider flows (Stripe Link, Banxa, etc.) */
+    email?: string;
     onSuccess?: (data: DepositResult) => void;
     onError?: (error: DepositError) => void;
     /** Called when the user dismisses the deposit dialog (X button, Escape key, or programmatic close) */
@@ -138,11 +162,20 @@ interface DepositConfig {
 interface CheckoutResult {
     paymentIntentId: string;
     status: string;
+    method?: CheckoutMethod;
+    /**
+     * Full payment intent details at the time of success, mapped to SDK camelCase.
+     * Mirrors the `DepositResult.execution` field on the deposit side.
+     * Always populated for the terminal `succeeded` callback; may be undefined for
+     * intermediate `processing` callbacks fired right after a wallet confirmation.
+     */
+    paymentIntent?: CheckoutPaymentIntent;
 }
 interface CheckoutError {
     message: string;
     error?: unknown;
     code?: string;
+    method?: CheckoutMethod;
 }
 interface WithdrawResult {
     message: string;
@@ -173,6 +206,8 @@ interface CheckoutConfig {
     /** Optional callbacks (fired immediately when events occur) */
     onSuccess?: (data: CheckoutResult) => void;
     onError?: (error: CheckoutError) => void;
+    /** Called when checkout lifecycle events occur. */
+    onEvent?: (event: CheckoutEvent) => void;
     /** Called when the user dismisses the checkout dialog */
     onClose?: () => void;
 }

package/dist/index.d.ts

@@ -3,8 +3,8 @@ import React from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { ChainType, DepositConfirmationMode, DepositMethod, DepositModalInitialScreen, ThemeMode, ThemeConfig, FontConfig, ComponentConfig, WithdrawTransactionInfo, AllowedCountryResult } from '@unifold/ui-react';
 export { AllowedCountryResult, BrowserWalletAmountQuickSelect, Button, ButtonProps, ButtonTokens, CardTokens, ComponentConfig, ComponentTokens, ConfirmingView, ContainerTokens, CustomThemeColors, DepositConfirmationMode, DepositModalInitialScreen as DepositInitialScreen, DepositMethod, FontConfig, HeaderTokens, InputTokens, ListTokens, SearchTokens, ThemeColors, ThemeConfig, ThemeMode, UseSupportedDepositTokensOptions, WithdrawTransactionInfo, useSupportedDepositTokens } from '@unifold/ui-react';
-import { EvmContractCall, DirectExecutionSucceededEvent, DepositEvent, WithdrawDirectExecutionSucceededEvent, WithdrawEvent } from '@unifold/core';
-export { ActionType, AutoSwapRequest, AutoSwapResponse, ChainType, CreateDepositAddressRequest, DefaultTokenChain, DefaultTokenMetadata, DefaultTokenResponse, DepositAddressResponse, DepositEvent, DepositEventType, DepositQuote, DepositQuoteRequest, DestinationToken, DestinationTokenChain, DirectExecution, DirectExecutionResponse, ExecutionStatus, FeaturedToken, FiatCurrenciesResponse, FiatCurrency, I18nStrings, IconUrl, IpAddressResponse, LockedQuoteLimits, LockedQuotePreview, LockedQuotePreviewRequest, OnrampQuote, OnrampQuotesRequest, OnrampQuotesResponse, OnrampSessionCreatedData, OnrampSessionCreatedEvent, OnrampSessionRequest, OnrampSessionResponse, PaymentIntent, PaymentIntentDepositAddress, PaymentIntentStatus, PaymentIntentType, PaymentNetwork, ProjectConfigResponse, QueryExecutionsRequest, QueryExecutionsResponse, SOLANA_USDC_ADDRESS, SendSolanaTransactionRequest, SendSolanaTransactionResponse, SourceToken, SourceTokenNetwork, SupportedChain, SupportedDepositTokensResponse, SupportedDestinationTokensResponse, SupportedSourceTokensQuery, SupportedSourceTokensResponse, SupportedToken, TokenChain, TokenChainIconUrl, TokenChainsResponse, UserIpInfo, Wallet, WithdrawDirectExecutionSucceededEvent, WithdrawEvent, WithdrawEventType, createDepositAddress, createOnrampSession, generatePrefixedKSUID, getApiBaseUrl, getChainName, getDefaultOnrampToken, getDepositQuote, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getWalletByChainType, i18n, queryExecutions, retrievePaymentIntent, sendSolanaTransaction, setApiConfig, useUserIp } from '@unifold/core';
+import { CheckoutMethod, CheckoutPaymentIntent, CheckoutEvent, EvmContractCall, DirectExecutionSucceededEvent, DepositEvent, WithdrawDirectExecutionSucceededEvent, WithdrawEvent } from '@unifold/core';
+export { ActionType, AutoSwapRequest, AutoSwapResponse, ChainType, CheckoutEvent, CheckoutEventType, CheckoutMethod, CheckoutPaymentIntent, CheckoutPaymentIntentData, CheckoutPaymentIntentSucceededEvent, CreateDepositAddressRequest, DefaultTokenChain, DefaultTokenMetadata, DefaultTokenResponse, DepositAddressResponse, DepositEvent, DepositEventType, DepositQuote, DepositQuoteRequest, DestinationToken, DestinationTokenChain, DirectExecution, DirectExecutionResponse, ExecutionStatus, FeaturedToken, FiatCurrenciesResponse, FiatCurrency, I18nStrings, IconUrl, IpAddressResponse, LockedQuoteLimits, LockedQuotePreview, LockedQuotePreviewRequest, OnrampQuote, OnrampQuotesRequest, OnrampQuotesResponse, OnrampSessionCreatedData, OnrampSessionCreatedEvent, OnrampSessionRequest, OnrampSessionResponse, PaymentIntent, PaymentIntentDepositAddress, PaymentIntentStatus, PaymentIntentType, PaymentNetwork, ProjectConfigResponse, QueryExecutionsRequest, QueryExecutionsResponse, SOLANA_USDC_ADDRESS, SendSolanaTransactionRequest, SendSolanaTransactionResponse, SourceToken, SourceTokenNetwork, StripeAccessTokenResponse, StripeAuthIntentResponse, StripeConfigResponse, StripeConfirmRequest, StripeConsumerWallet, StripeCreateSessionRequest, StripeCryptoCustomer, StripeCustomerVerification, StripeDefaultTokenResponse, StripeListResponse, StripeOnrampSession, StripeOnrampTransactionDetails, StripePaymentToken, StripeQuoteRequest, StripeQuotesResponse, SupportedChain, SupportedDepositTokensResponse, SupportedDestinationTokensResponse, SupportedSourceTokensQuery, SupportedSourceTokensResponse, SupportedToken, TokenChain, TokenChainIconUrl, TokenChainsResponse, UserIpInfo, Wallet, WithdrawDirectExecutionSucceededEvent, WithdrawEvent, WithdrawEventType, createDepositAddress, createOnrampSession, generatePrefixedKSUID, getApiBaseUrl, getChainName, getDefaultOnrampToken, getDepositQuote, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getWalletByChainType, i18n, queryExecutions, retrievePaymentIntent, sendSolanaTransaction, setApiConfig, stripeConfirmSession, stripeCreateAuthIntent, stripeCreateSession, stripeExchangeTokens, stripeGetConfig, stripeGetCustomer, stripeGetDefaultToken, stripeGetQuotes, stripeGetSession, stripeListPaymentTokens, stripeListWallets, stripeRefreshQuote, stripeRefreshToken, useUserIp } from '@unifold/core';
 
 interface UnifoldConnectProviderConfig {
     publishableKey: string;
@@ -45,6 +45,19 @@ interface UnifoldConnectProviderConfig {
         enableConnectExchange?: boolean;
         /** Enable "Pay with Cash App" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableCashApp?: boolean;
+        /** Enable "Pay with Link" headless onramp option. Defaults to false. */
+        enableStripeLink?: boolean;
+        /**
+         * Enable "Pay with Apple Pay" (headless Coinbase) option. Overrides
+         * dashboard default. Resolves as flag ?? dashboard `apple_pay.enabled` ??
+         * true. The server still gates per-region (US-only, NY excluded at
+         * launch) at order-creation time.
+         */
+        enableApplePay?: boolean;
+        /** Main menu — Apple Pay row title. @default `"Pay with Apple Pay"` */
+        applePayTitle?: string;
+        /** Main menu — Apple Pay row subtitle. @default `"Instant"` */
+        applePaySubTitle?: string;
         /** Simple accent/primary color override (applies to both light and dark modes) */
         accentColor?: string;
         /** Full theme color customization per mode */
@@ -72,7 +85,7 @@ interface UnifoldConnectProviderConfig {
         /** Deposit with Card onramp: hide wallet address disclaimer. @default false */
         hideDisplayDescription?: boolean;
         /** Connect Wallet → Enter amount: `percentage` (10%, 25%, 50%, 75%, MAX) or `usd` ($25…). @default `percentage` */
-        browserWalletAmountQuickSelect?: "usd" | "percentage";
+        browserWalletAmountQuickSelect?: 'usd' | 'percentage';
     };
 }
 interface DepositResult {
@@ -96,6 +109,15 @@ interface DepositConfig {
     destinationTokenSymbol: string;
     /** Address that receives the deposited funds. */
     recipientAddress: string;
+    /**
+     * Pre-trusted email for the host platform's signed-in user. When provided,
+     * Apple Pay (headless Coinbase) skips both the localStorage email check and
+     * the email-OTP screen — it passes `email_already_verified: true` and uses
+     * this address directly. Phone OTP is still required (Coinbase mandates
+     * phone re-verification every 60 days). Has no effect on the other deposit
+     * flows.
+     */
+    externalUserEmail?: string;
     /**
      * Array of contract calls to execute on the destination chain when delivering funds.
      * Each entry specifies a target contract address, hex-encoded data, and optional value in wei (defaults to "0").
@@ -117,6 +139,8 @@ interface DepositConfig {
     defaultSourceSymbol?: string;
     /** How to confirm deposit: 'auto_ui' (default), 'auto_silent', or 'manual' */
     depositConfirmationMode?: DepositConfirmationMode;
+    /** User's email address — used to pre-fill onramp provider flows (Stripe Link, Banxa, etc.) */
+    email?: string;
     onSuccess?: (data: DepositResult) => void;
     onError?: (error: DepositError) => void;
     /** Called when the user dismisses the deposit dialog (X button, Escape key, or programmatic close) */
@@ -138,11 +162,20 @@ interface DepositConfig {
 interface CheckoutResult {
     paymentIntentId: string;
     status: string;
+    method?: CheckoutMethod;
+    /**
+     * Full payment intent details at the time of success, mapped to SDK camelCase.
+     * Mirrors the `DepositResult.execution` field on the deposit side.
+     * Always populated for the terminal `succeeded` callback; may be undefined for
+     * intermediate `processing` callbacks fired right after a wallet confirmation.
+     */
+    paymentIntent?: CheckoutPaymentIntent;
 }
 interface CheckoutError {
     message: string;
     error?: unknown;
     code?: string;
+    method?: CheckoutMethod;
 }
 interface WithdrawResult {
     message: string;
@@ -173,6 +206,8 @@ interface CheckoutConfig {
     /** Optional callbacks (fired immediately when events occur) */
     onSuccess?: (data: CheckoutResult) => void;
     onError?: (error: CheckoutError) => void;
+    /** Called when checkout lifecycle events occur. */
+    onEvent?: (event: CheckoutEvent) => void;
     /** Called when the user dismisses the checkout dialog */
     onClose?: () => void;
 }