@unifold/connect-react 0.1.41 → 0.1.43

package/dist/index.d.mts

@@ -1,13 +1,15 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { ThemeMode, ThemeConfig, FontConfig, ComponentConfig, DepositModalInitialScreen, ChainType, DepositConfirmationMode, AllowedCountryResult } from '@unifold/ui-react';
-export { AllowedCountryResult, BrowserWalletAmountQuickSelect, Button, ButtonProps, ButtonTokens, CardTokens, ComponentConfig, ComponentTokens, ConfirmingView, ContainerTokens, CustomThemeColors, DepositConfirmationMode, DepositModalInitialScreen as DepositInitialScreen, FontConfig, HeaderTokens, InputTokens, ListTokens, SearchTokens, ThemeColors, ThemeConfig, ThemeMode } from '@unifold/ui-react';
-export { AutoSwapRequest, AutoSwapResponse, ChainType, CreateDepositAddressRequest, DefaultTokenChain, DefaultTokenMetadata, DefaultTokenResponse, DepositAddressResponse, ExecutionStatus, FeaturedToken, FiatCurrenciesResponse, FiatCurrency, I18nStrings, IconUrl, IpAddressResponse, OnrampQuote, OnrampQuotesRequest, OnrampQuotesResponse, OnrampSessionRequest, OnrampSessionResponse, PaymentNetwork, ProjectConfigResponse, QueryExecutionsRequest, QueryExecutionsResponse, SOLANA_USDC_ADDRESS, SupportedChain, SupportedDepositTokensResponse, SupportedToken, TokenChain, TokenChainIconUrl, TokenChainsResponse, UserIpInfo, Wallet, createDepositAddress, createOnrampSession, getApiBaseUrl, getChainName, getDefaultOnrampToken, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getWalletByChainType, i18n, queryExecutions, setApiConfig, useUserIp } from '@unifold/core';
+import { ThemeMode, ThemeConfig, FontConfig, ComponentConfig, DepositModalInitialScreen, ChainType, DepositConfirmationMode, WithdrawTransactionInfo, AllowedCountryResult } from '@unifold/ui-react';
+export { AllowedCountryResult, BrowserWalletAmountQuickSelect, Button, ButtonProps, ButtonTokens, CardTokens, ComponentConfig, ComponentTokens, ConfirmingView, ContainerTokens, CustomThemeColors, DepositConfirmationMode, DepositModalInitialScreen as DepositInitialScreen, FontConfig, HeaderTokens, InputTokens, ListTokens, SearchTokens, ThemeColors, ThemeConfig, ThemeMode, WithdrawTransactionInfo } from '@unifold/ui-react';
+export { ActionType, AutoSwapRequest, AutoSwapResponse, ChainType, CreateDepositAddressRequest, DefaultTokenChain, DefaultTokenMetadata, DefaultTokenResponse, DepositAddressResponse, DestinationToken, DestinationTokenChain, ExecutionStatus, FeaturedToken, FiatCurrenciesResponse, FiatCurrency, I18nStrings, IconUrl, IpAddressResponse, OnrampQuote, OnrampQuotesRequest, OnrampQuotesResponse, OnrampSessionRequest, OnrampSessionResponse, PaymentIntent, PaymentIntentDepositAddress, PaymentNetwork, ProjectConfigResponse, QueryExecutionsRequest, QueryExecutionsResponse, SOLANA_USDC_ADDRESS, SendSolanaTransactionRequest, SendSolanaTransactionResponse, SupportedChain, SupportedDepositTokensResponse, SupportedDestinationTokensResponse, SupportedToken, TokenChain, TokenChainIconUrl, TokenChainsResponse, UserIpInfo, Wallet, createDepositAddress, createOnrampSession, getApiBaseUrl, getChainName, getDefaultOnrampToken, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getWalletByChainType, i18n, queryExecutions, sendSolanaTransaction, setApiConfig, useUserIp } from '@unifold/core';
 
 interface UnifoldConnectProviderConfig {
     publishableKey: string;
     config?: {
         modalTitle?: string;
+        /** Custom title for the withdraw modal. @default `"Withdraw"` */
+        withdrawModalTitle?: string;
         hideDepositTracker?: boolean;
         /** Show balance in deposit modal header. Defaults to true */
         showBalanceHeader?: boolean;
@@ -92,11 +94,76 @@ interface DepositConfig {
      */
     initialScreen?: DepositModalInitialScreen;
 }
+interface CheckoutResult {
+    paymentIntentId: string;
+    status: string;
+}
+interface CheckoutError {
+    message: string;
+    error?: unknown;
+    code?: string;
+}
+interface WithdrawResult {
+    message: string;
+    transaction?: unknown;
+}
+interface WithdrawError {
+    message: string;
+    error?: unknown;
+    code?: string;
+}
+interface CheckoutConfig {
+    /** The client_secret from a PaymentIntent created on your server */
+    clientSecret: string;
+    /** Optional callbacks (fired immediately when events occur) */
+    onSuccess?: (data: CheckoutResult) => void;
+    onError?: (error: CheckoutError) => void;
+    /** Called when the user dismisses the checkout dialog */
+    onClose?: () => void;
+}
+interface WithdrawConfig {
+    /** External user ID — required, same as deposit */
+    externalUserId: string;
+    /** Source token chain type (e.g. 'ethereum', 'solana'). Must be a supported stablecoin. */
+    sourceChainType: ChainType;
+    /** Source token chain ID (e.g. '8453', 'mainnet') */
+    sourceChainId: string;
+    /** Source token contract address */
+    sourceTokenAddress: string;
+    /** Source token symbol (e.g. 'USDC'). Optional but recommended for display. */
+    sourceTokenSymbol?: string;
+    /** Optional: pre-fill the recipient address the user is withdrawing to */
+    recipientAddress?: string;
+    /**
+     * The user's wallet address (the sender). Used to:
+     * 1. Fetch balance for quick-select chips (25%/50%/75%/MAX)
+     * 2. Detect if a matching browser wallet is connected
+     */
+    senderAddress: string;
+    /**
+     * Callback invoked with transaction details when user confirms withdrawal.
+     * The platform must implement the actual transaction signing/sending since
+     * we don't have the private key.
+     *
+     * Optional — if omitted, the user must have a matching connected browser wallet
+     * to execute the withdrawal. If neither `withdraw` nor a connected wallet is available,
+     * the modal will show an error.
+     */
+    withdraw?: (txInfo: WithdrawTransactionInfo) => void | Promise<void>;
+    onSuccess?: (data: WithdrawResult) => void;
+    onError?: (error: WithdrawError) => void;
+    onClose?: () => void;
+}
+
 declare function UnifoldProvider({ children, publishableKey, config, }: React.PropsWithChildren<UnifoldConnectProviderConfig>): react_jsx_runtime.JSX.Element;
 declare function useUnifold(): {
     publishableKey: string;
     beginDeposit: (config: DepositConfig) => Promise<DepositResult>;
     closeDeposit: () => void;
+    beginCheckout: (config: CheckoutConfig) => Promise<CheckoutResult>;
+    closeCheckout: () => void;
+    beginWithdraw: (config: WithdrawConfig) => Promise<WithdrawResult>;
+    closeWithdraw: () => void;
 };
 /**
  * Convenience wrapper for useAllowedCountry that automatically passes publishableKey from context
@@ -122,4 +189,4 @@ declare function useUnifold(): {
  */
 declare function useAllowedCountry(): AllowedCountryResult;
 
-export { type DepositConfig, type DepositError, type DepositResult, type UnifoldConnectProviderConfig, UnifoldProvider, useAllowedCountry, useUnifold };
+export { type CheckoutConfig, type CheckoutError, type CheckoutResult, type DepositConfig, type DepositError, type DepositResult, type UnifoldConnectProviderConfig, UnifoldProvider, type WithdrawConfig, type WithdrawError, type WithdrawResult, useAllowedCountry, useUnifold };

package/dist/index.d.ts

@@ -1,13 +1,15 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { ThemeMode, ThemeConfig, FontConfig, ComponentConfig, DepositModalInitialScreen, ChainType, DepositConfirmationMode, AllowedCountryResult } from '@unifold/ui-react';
-export { AllowedCountryResult, BrowserWalletAmountQuickSelect, Button, ButtonProps, ButtonTokens, CardTokens, ComponentConfig, ComponentTokens, ConfirmingView, ContainerTokens, CustomThemeColors, DepositConfirmationMode, DepositModalInitialScreen as DepositInitialScreen, FontConfig, HeaderTokens, InputTokens, ListTokens, SearchTokens, ThemeColors, ThemeConfig, ThemeMode } from '@unifold/ui-react';
-export { AutoSwapRequest, AutoSwapResponse, ChainType, CreateDepositAddressRequest, DefaultTokenChain, DefaultTokenMetadata, DefaultTokenResponse, DepositAddressResponse, ExecutionStatus, FeaturedToken, FiatCurrenciesResponse, FiatCurrency, I18nStrings, IconUrl, IpAddressResponse, OnrampQuote, OnrampQuotesRequest, OnrampQuotesResponse, OnrampSessionRequest, OnrampSessionResponse, PaymentNetwork, ProjectConfigResponse, QueryExecutionsRequest, QueryExecutionsResponse, SOLANA_USDC_ADDRESS, SupportedChain, SupportedDepositTokensResponse, SupportedToken, TokenChain, TokenChainIconUrl, TokenChainsResponse, UserIpInfo, Wallet, createDepositAddress, createOnrampSession, getApiBaseUrl, getChainName, getDefaultOnrampToken, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getWalletByChainType, i18n, queryExecutions, setApiConfig, useUserIp } from '@unifold/core';
+import { ThemeMode, ThemeConfig, FontConfig, ComponentConfig, DepositModalInitialScreen, ChainType, DepositConfirmationMode, WithdrawTransactionInfo, AllowedCountryResult } from '@unifold/ui-react';
+export { AllowedCountryResult, BrowserWalletAmountQuickSelect, Button, ButtonProps, ButtonTokens, CardTokens, ComponentConfig, ComponentTokens, ConfirmingView, ContainerTokens, CustomThemeColors, DepositConfirmationMode, DepositModalInitialScreen as DepositInitialScreen, FontConfig, HeaderTokens, InputTokens, ListTokens, SearchTokens, ThemeColors, ThemeConfig, ThemeMode, WithdrawTransactionInfo } from '@unifold/ui-react';
+export { ActionType, AutoSwapRequest, AutoSwapResponse, ChainType, CreateDepositAddressRequest, DefaultTokenChain, DefaultTokenMetadata, DefaultTokenResponse, DepositAddressResponse, DestinationToken, DestinationTokenChain, ExecutionStatus, FeaturedToken, FiatCurrenciesResponse, FiatCurrency, I18nStrings, IconUrl, IpAddressResponse, OnrampQuote, OnrampQuotesRequest, OnrampQuotesResponse, OnrampSessionRequest, OnrampSessionResponse, PaymentIntent, PaymentIntentDepositAddress, PaymentNetwork, ProjectConfigResponse, QueryExecutionsRequest, QueryExecutionsResponse, SOLANA_USDC_ADDRESS, SendSolanaTransactionRequest, SendSolanaTransactionResponse, SupportedChain, SupportedDepositTokensResponse, SupportedDestinationTokensResponse, SupportedToken, TokenChain, TokenChainIconUrl, TokenChainsResponse, UserIpInfo, Wallet, createDepositAddress, createOnrampSession, getApiBaseUrl, getChainName, getDefaultOnrampToken, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getWalletByChainType, i18n, queryExecutions, sendSolanaTransaction, setApiConfig, useUserIp } from '@unifold/core';
 
 interface UnifoldConnectProviderConfig {
     publishableKey: string;
     config?: {
         modalTitle?: string;
+        /** Custom title for the withdraw modal. @default `"Withdraw"` */
+        withdrawModalTitle?: string;
         hideDepositTracker?: boolean;
         /** Show balance in deposit modal header. Defaults to true */
         showBalanceHeader?: boolean;
@@ -92,11 +94,76 @@ interface DepositConfig {
      */
     initialScreen?: DepositModalInitialScreen;
 }
+interface CheckoutResult {
+    paymentIntentId: string;
+    status: string;
+}
+interface CheckoutError {
+    message: string;
+    error?: unknown;
+    code?: string;
+}
+interface WithdrawResult {
+    message: string;
+    transaction?: unknown;
+}
+interface WithdrawError {
+    message: string;
+    error?: unknown;
+    code?: string;
+}
+interface CheckoutConfig {
+    /** The client_secret from a PaymentIntent created on your server */
+    clientSecret: string;
+    /** Optional callbacks (fired immediately when events occur) */
+    onSuccess?: (data: CheckoutResult) => void;
+    onError?: (error: CheckoutError) => void;
+    /** Called when the user dismisses the checkout dialog */
+    onClose?: () => void;
+}
+interface WithdrawConfig {
+    /** External user ID — required, same as deposit */
+    externalUserId: string;
+    /** Source token chain type (e.g. 'ethereum', 'solana'). Must be a supported stablecoin. */
+    sourceChainType: ChainType;
+    /** Source token chain ID (e.g. '8453', 'mainnet') */
+    sourceChainId: string;
+    /** Source token contract address */
+    sourceTokenAddress: string;
+    /** Source token symbol (e.g. 'USDC'). Optional but recommended for display. */
+    sourceTokenSymbol?: string;
+    /** Optional: pre-fill the recipient address the user is withdrawing to */
+    recipientAddress?: string;
+    /**
+     * The user's wallet address (the sender). Used to:
+     * 1. Fetch balance for quick-select chips (25%/50%/75%/MAX)
+     * 2. Detect if a matching browser wallet is connected
+     */
+    senderAddress: string;
+    /**
+     * Callback invoked with transaction details when user confirms withdrawal.
+     * The platform must implement the actual transaction signing/sending since
+     * we don't have the private key.
+     *
+     * Optional — if omitted, the user must have a matching connected browser wallet
+     * to execute the withdrawal. If neither `withdraw` nor a connected wallet is available,
+     * the modal will show an error.
+     */
+    withdraw?: (txInfo: WithdrawTransactionInfo) => void | Promise<void>;
+    onSuccess?: (data: WithdrawResult) => void;
+    onError?: (error: WithdrawError) => void;
+    onClose?: () => void;
+}
+
 declare function UnifoldProvider({ children, publishableKey, config, }: React.PropsWithChildren<UnifoldConnectProviderConfig>): react_jsx_runtime.JSX.Element;
 declare function useUnifold(): {
     publishableKey: string;
     beginDeposit: (config: DepositConfig) => Promise<DepositResult>;
     closeDeposit: () => void;
+    beginCheckout: (config: CheckoutConfig) => Promise<CheckoutResult>;
+    closeCheckout: () => void;
+    beginWithdraw: (config: WithdrawConfig) => Promise<WithdrawResult>;
+    closeWithdraw: () => void;
 };
 /**
  * Convenience wrapper for useAllowedCountry that automatically passes publishableKey from context
@@ -122,4 +189,4 @@ declare function useUnifold(): {
  */
 declare function useAllowedCountry(): AllowedCountryResult;
 
-export { type DepositConfig, type DepositError, type DepositResult, type UnifoldConnectProviderConfig, UnifoldProvider, useAllowedCountry, useUnifold };
+export { type CheckoutConfig, type CheckoutError, type CheckoutResult, type DepositConfig, type DepositError, type DepositResult, type UnifoldConnectProviderConfig, UnifoldProvider, type WithdrawConfig, type WithdrawError, type WithdrawResult, useAllowedCountry, useUnifold };