@unifold/connect-react 0.1.66 → 0.1.67

package/dist/index.d.mts

@@ -1,10 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import { QueryClient } from '@tanstack/react-query';
-import { ChainType, DepositConfirmationMode, 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, FontConfig, HeaderTokens, InputTokens, ListTokens, SearchTokens, ThemeColors, ThemeConfig, ThemeMode, UseSupportedDepositTokensOptions, WithdrawTransactionInfo, useSupportedDepositTokens } from '@unifold/ui-react';
-import { EvmContractCall, DepositEvent } from '@unifold/core';
-export { ActionType, AutoSwapRequest, AutoSwapResponse, ChainType, CreateDepositAddressRequest, DefaultTokenChain, DefaultTokenMetadata, DefaultTokenResponse, DepositAddressResponse, DepositEvent, DepositEventType, DepositQuote, DepositQuoteRequest, DestinationToken, DestinationTokenChain, 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, 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 { 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';
 
 interface UnifoldConnectProviderConfig {
     publishableKey: string;
@@ -79,11 +79,14 @@ interface DepositResult {
     message: string;
     transaction?: unknown;
     executionId?: string;
+    execution?: DirectExecutionSucceededEvent;
+    method?: DepositMethod;
 }
 interface DepositError {
     message: string;
     error?: unknown;
     code?: string;
+    method?: DepositMethod;
 }
 interface DepositConfig {
     externalUserId: string;
@@ -144,6 +147,8 @@ interface CheckoutError {
 interface WithdrawResult {
     message: string;
     transaction?: unknown;
+    executionId?: string;
+    execution?: WithdrawDirectExecutionSucceededEvent;
 }
 interface WithdrawError {
     message: string;
@@ -210,6 +215,8 @@ interface WithdrawConfig {
     withdraw: (txInfo: WithdrawTransactionInfo) => void | Promise<void>;
     onSuccess?: (data: WithdrawResult) => void;
     onError?: (error: WithdrawError) => void;
+    /** Called when withdraw lifecycle events occur. */
+    onEvent?: (event: WithdrawEvent) => void;
     onClose?: () => void;
 }
 

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import { QueryClient } from '@tanstack/react-query';
-import { ChainType, DepositConfirmationMode, 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, FontConfig, HeaderTokens, InputTokens, ListTokens, SearchTokens, ThemeColors, ThemeConfig, ThemeMode, UseSupportedDepositTokensOptions, WithdrawTransactionInfo, useSupportedDepositTokens } from '@unifold/ui-react';
-import { EvmContractCall, DepositEvent } from '@unifold/core';
-export { ActionType, AutoSwapRequest, AutoSwapResponse, ChainType, CreateDepositAddressRequest, DefaultTokenChain, DefaultTokenMetadata, DefaultTokenResponse, DepositAddressResponse, DepositEvent, DepositEventType, DepositQuote, DepositQuoteRequest, DestinationToken, DestinationTokenChain, 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, 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 { 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';
 
 interface UnifoldConnectProviderConfig {
     publishableKey: string;
@@ -79,11 +79,14 @@ interface DepositResult {
     message: string;
     transaction?: unknown;
     executionId?: string;
+    execution?: DirectExecutionSucceededEvent;
+    method?: DepositMethod;
 }
 interface DepositError {
     message: string;
     error?: unknown;
     code?: string;
+    method?: DepositMethod;
 }
 interface DepositConfig {
     externalUserId: string;
@@ -144,6 +147,8 @@ interface CheckoutError {
 interface WithdrawResult {
     message: string;
     transaction?: unknown;
+    executionId?: string;
+    execution?: WithdrawDirectExecutionSucceededEvent;
 }
 interface WithdrawError {
     message: string;
@@ -210,6 +215,8 @@ interface WithdrawConfig {
     withdraw: (txInfo: WithdrawTransactionInfo) => void | Promise<void>;
     onSuccess?: (data: WithdrawResult) => void;
     onError?: (error: WithdrawError) => void;
+    /** Called when withdraw lifecycle events occur. */
+    onEvent?: (event: WithdrawEvent) => void;
     onClose?: () => void;
 }
 

package/dist/index.js

@@ -1159,6 +1159,7 @@ __export(index_exports, {
   ExecutionStatus: () => ExecutionStatus,
   SOLANA_USDC_ADDRESS: () => SOLANA_USDC_ADDRESS,
   UnifoldProvider: () => UnifoldProvider2,
+  WithdrawEventType: () => WithdrawEventType,
   createDepositAddress: () => createDepositAddress,
   createOnrampSession: () => createOnrampSession,
   generatePrefixedKSUID: () => generatePrefixedKSUID,
@@ -7155,8 +7156,13 @@ async function sendHypercoreTransaction(request, publishableKey) {
 }
 var DepositEventType = /* @__PURE__ */ ((DepositEventType2) => {
   DepositEventType2["ONRAMP_SESSION_CREATED"] = "onramp_session.created";
+  DepositEventType2["DIRECT_EXECUTION_SUCCEEDED"] = "direct_execution.succeeded";
   return DepositEventType2;
 })(DepositEventType || {});
+var WithdrawEventType = /* @__PURE__ */ ((WithdrawEventType2) => {
+  WithdrawEventType2["DIRECT_EXECUTION_SUCCEEDED"] = "direct_execution.succeeded";
+  return WithdrawEventType2;
+})(WithdrawEventType || {});
 function useUserIp() {
   const {
     data: userIpInfo,
@@ -15126,6 +15132,31 @@ function useDepositPolling({
   onDepositSuccess,
   onDepositError
 }) {
+  const createExecutionSuccessEvent = (execution) => ({
+    id: generatePrefixedKSUID("sevt"),
+    type: DepositEventType.DIRECT_EXECUTION_SUCCEEDED,
+    created: execution.updated_at ? Math.floor(new Date(execution.updated_at).getTime() / 1e3) : execution.created_at ? Math.floor(new Date(execution.created_at).getTime() / 1e3) : Math.floor(Date.now() / 1e3),
+    data: { object: mapToDirectExecution(execution) }
+  });
+  const mapToDirectExecution = (execution) => ({
+    id: execution.id,
+    transactionHash: execution.transaction_hash,
+    recipientAddress: execution.recipient_address,
+    depositAddress: execution.deposit_wallet?.address,
+    sourceChainType: execution.source_chain_type,
+    sourceChainId: execution.source_chain_id,
+    sourceTokenAddress: execution.source_token_address,
+    destinationChainType: execution.destination_chain_type,
+    destinationChainId: execution.destination_chain_id,
+    destinationTokenAddress: execution.destination_token_address,
+    sourceAmountBaseUnit: execution.source_amount_base_unit,
+    sourceAmountUsd: execution.source_amount_usd,
+    destinationAmountBaseUnit: execution.destination_amount_base_unit,
+    destinationAmountUsd: execution.destination_amount_usd,
+    destinationTransactionHashes: execution.destination_transaction_hashes,
+    status: execution.status,
+    failureReason: execution.failure_reason
+  });
   const [executions, setExecutions] = (0, import_react12.useState)([]);
   const [isPolling, setIsPolling] = (0, import_react12.useState)(false);
   const [pollingEnabled, setPollingEnabled] = (0, import_react12.useState)(false);
@@ -15239,7 +15270,9 @@ function useDepositPolling({
             onDepositSuccessRef.current?.({
               message: "Deposit completed successfully",
               executionId: execution.id,
-              transaction: execution
+              // Backward compatibility: keep transaction in API response shape.
+              transaction: execution,
+              execution: createExecutionSuccessEvent(execution)
             });
           } else if (execution.status === ExecutionStatus.FAILED && previousStatus !== ExecutionStatus.FAILED) {
             onDepositErrorRef.current?.({
@@ -21420,6 +21453,8 @@ function CoinbaseConnect({
   destinationChainId,
   destinationChainType,
   onTransferSuccess,
+  onDepositSuccess,
+  onDepositError,
   onTransferError,
   onClose,
   onBack: parentOnBack,
@@ -21567,10 +21602,14 @@ function CoinbaseConnect({
     depositWalletId: transferDepositWalletId,
     enabled: view === "success" && !!transferDepositWalletId,
     immediateDirectPolling: true,
-    onDepositSuccess: onTransferSuccess ? () => {
-      if (confirmResult) onTransferSuccess(confirmResult);
+    onDepositSuccess: onDepositSuccess || onTransferSuccess ? (data) => {
+      onDepositSuccess?.(data);
+      if (onTransferSuccess && confirmResult) onTransferSuccess(confirmResult);
     } : void 0,
-    onDepositError: onTransferError
+    onDepositError: onDepositError || onTransferError ? (error) => {
+      onDepositError?.(error);
+      onTransferError?.({ message: error.message });
+    } : void 0
   });
   (0, import_react20.useEffect)(() => {
     onExecutionsChange?.(depositExecutions);
@@ -28021,6 +28060,23 @@ function DepositModal({
   depositTrackerSubTitle = t7.depositTracker.subtitle
 }) {
   const { colors: colors2, fonts, components } = useTheme();
+  const onDepositSuccessFor = (0, import_react8.useCallback)(
+    (method) => onDepositSuccess || onEvent ? (data) => {
+      const payload = { ...data, method };
+      onDepositSuccess?.(payload);
+      if (payload.execution) {
+        onEvent?.({
+          ...payload.execution,
+          method
+        });
+      }
+    } : void 0,
+    [onDepositSuccess, onEvent]
+  );
+  const onDepositErrorFor = (0, import_react8.useCallback)(
+    (method) => onDepositError ? (error) => onDepositError({ ...error, method }) : void 0,
+    [onDepositError]
+  );
   const effectiveInitialScreen = (0, import_react8.useMemo)(() => {
     const s = initialScreen ?? "main";
     if (s === "tracker" && hideDepositTracker === true) return "main";
@@ -28705,8 +28761,8 @@ function DepositModal({
                     defaultSourceSymbol,
                     depositConfirmationMode,
                     onExecutionsChange: setDepositExecutions,
-                    onDepositSuccess,
-                    onDepositError,
+                    onDepositSuccess: onDepositSuccessFor("transfer"),
+                    onDepositError: onDepositErrorFor("transfer"),
                     wallets
                   }
                 ) : /* @__PURE__ */ (0, import_jsx_runtime72.jsx)(
@@ -28724,8 +28780,8 @@ function DepositModal({
                     defaultSourceSymbol,
                     depositConfirmationMode,
                     onExecutionsChange: setDepositExecutions,
-                    onDepositSuccess,
-                    onDepositError,
+                    onDepositSuccess: onDepositSuccessFor("transfer"),
+                    onDepositError: onDepositErrorFor("transfer"),
                     wallets
                   }
                 ),
@@ -28790,8 +28846,8 @@ function DepositModal({
                     destinationChainType,
                     destinationChainId,
                     destinationTokenAddress,
-                    onDepositSuccess,
-                    onDepositError,
+                    onDepositSuccess: onDepositSuccessFor("card"),
+                    onDepositError: onDepositErrorFor("card"),
                     onEvent,
                     themeClass,
                     wallets,
@@ -28826,8 +28882,8 @@ function DepositModal({
                     destinationChainType,
                     destinationChainId,
                     destinationTokenAddress,
-                    onDepositSuccess,
-                    onDepositError,
+                    onDepositSuccess: onDepositSuccessFor("pay_with_exchange"),
+                    onDepositError: onDepositErrorFor("pay_with_exchange"),
                     wallets,
                     defaultToken: defaultToken ?? null
                   }
@@ -28845,14 +28901,10 @@ function DepositModal({
                   destinationTokenAddress: destinationTokenAddress ?? "",
                   destinationChainId: destinationChainId ?? "",
                   destinationChainType: destinationChainType ?? "",
-                  onTransferSuccess: (result) => {
-                    onDepositSuccess?.({
-                      message: "Transfer completed via Coinbase Connect",
-                      transaction: result
-                    });
-                  },
+                  onDepositSuccess: onDepositSuccessFor("exchange_connect"),
+                  onDepositError: onDepositErrorFor("exchange_connect"),
                   onTransferError: (error) => {
-                    onDepositError?.({
+                    onDepositErrorFor("exchange_connect")?.({
                       message: error.message,
                       error
                     });
@@ -28881,20 +28933,14 @@ function DepositModal({
                   publishableKey,
                   assetCdnUrl: projectConfig?.asset_cdn_url,
                   projectName: projectConfig?.project_name,
-                  onSuccess: (txHash) => {
-                    onDepositSuccess?.({
-                      message: "Transaction sent successfully",
-                      transaction: { txHash }
-                    });
-                  },
                   onError: (error) => {
-                    onDepositError?.({
+                    onDepositErrorFor("wallet_connect")?.({
                       message: error.message,
                       error
                     });
                   },
-                  onDepositSuccess,
-                  onDepositError,
+                  onDepositSuccess: onDepositSuccessFor("wallet_connect"),
+                  onDepositError: onDepositErrorFor("wallet_connect"),
                   amountQuickSelect: browserWalletAmountQuickSelect,
                   onWalletDisconnect: handleWalletDisconnect,
                   onWalletConnected: (info, dw) => {
@@ -28938,8 +28984,8 @@ function DepositModal({
                     onViewChange: setCashAppView,
                     onAmountChange: setCashAppAmount,
                     onEvent,
-                    onDepositSuccess,
-                    onDepositError
+                    onDepositSuccess: onDepositSuccessFor("cashapp"),
+                    onDepositError: onDepositErrorFor("cashapp")
                   }
                 ),
                 depositPoweredByFooter
@@ -29777,6 +29823,31 @@ function useWithdrawPolling({
   onWithdrawSuccess,
   onWithdrawError
 }) {
+  const createExecutionSuccessEvent = (execution) => ({
+    id: generatePrefixedKSUID("sevt"),
+    type: WithdrawEventType.DIRECT_EXECUTION_SUCCEEDED,
+    created: execution.updated_at ? Math.floor(new Date(execution.updated_at).getTime() / 1e3) : execution.created_at ? Math.floor(new Date(execution.created_at).getTime() / 1e3) : Math.floor(Date.now() / 1e3),
+    data: { object: mapToDirectExecution(execution) }
+  });
+  const mapToDirectExecution = (execution) => ({
+    id: execution.id,
+    transactionHash: execution.transaction_hash,
+    recipientAddress: execution.recipient_address,
+    depositAddress: execution.deposit_wallet?.address,
+    sourceChainType: execution.source_chain_type,
+    sourceChainId: execution.source_chain_id,
+    sourceTokenAddress: execution.source_token_address,
+    destinationChainType: execution.destination_chain_type,
+    destinationChainId: execution.destination_chain_id,
+    destinationTokenAddress: execution.destination_token_address,
+    sourceAmountBaseUnit: execution.source_amount_base_unit,
+    sourceAmountUsd: execution.source_amount_usd,
+    destinationAmountBaseUnit: execution.destination_amount_base_unit,
+    destinationAmountUsd: execution.destination_amount_usd,
+    destinationTransactionHashes: execution.destination_transaction_hashes,
+    status: execution.status,
+    failureReason: execution.failure_reason
+  });
   const [executions, setExecutions] = (0, import_react30.useState)([]);
   const [isPolling, setIsPolling] = (0, import_react30.useState)(false);
   const enabledAtRef = (0, import_react30.useRef)(/* @__PURE__ */ new Date());
@@ -29844,7 +29915,13 @@ function useWithdrawPolling({
             return [...list, ex];
           });
           if (ex.status === ExecutionStatus.SUCCEEDED && (!prev || inProgress.includes(prev))) {
-            onSuccessRef.current?.({ message: "Withdrawal completed successfully", executionId: ex.id, transaction: ex });
+            onSuccessRef.current?.({
+              message: "Withdrawal completed successfully",
+              executionId: ex.id,
+              // Backward compatibility: keep transaction in API response shape.
+              transaction: ex,
+              execution: createExecutionSuccessEvent(ex)
+            });
           } else if (ex.status === ExecutionStatus.FAILED && prev !== ExecutionStatus.FAILED) {
             onErrorRef.current?.({ message: "Withdrawal failed", code: "WITHDRAW_FAILED", error: ex });
           }
@@ -31046,9 +31123,19 @@ function WithdrawModal({
   onWithdraw,
   onWithdrawSuccess,
   onWithdrawError,
+  onEvent,
   theme = "dark",
   hideOverlay = false
 }) {
+  const onWithdrawSuccessFor = (0, import_react29.useCallback)(
+    (data) => {
+      onWithdrawSuccess?.(data);
+      if (data.execution) {
+        onEvent?.(data.execution);
+      }
+    },
+    [onWithdrawSuccess, onEvent]
+  );
   const { colors: colors2, fonts, components } = useTheme();
   const [containerEl, setContainerEl] = (0, import_react29.useState)(null);
   const containerCallbackRef = (0, import_react29.useCallback)((el) => {
@@ -31110,7 +31197,7 @@ function WithdrawModal({
     publishableKey,
     depositWalletId: withdrawDepositWalletId,
     enabled: !!withdrawDepositWalletId && open,
-    onWithdrawSuccess: onWithdrawSuccess ? (d) => onWithdrawSuccess({ message: d.message, transaction: d.transaction }) : void 0,
+    onWithdrawSuccess: onWithdrawSuccess || onEvent ? onWithdrawSuccessFor : void 0,
     onWithdrawError
   });
   const { data: allWithdrawalsData } = useExecutions(externalUserId, publishableKey, {
@@ -31610,6 +31697,7 @@ function UnifoldProvider2({
             onWithdraw: withdrawConfig.withdraw,
             onWithdrawSuccess: handleWithdrawSuccess,
             onWithdrawError: handleWithdrawError,
+            onEvent: withdrawConfig.onEvent,
             theme: resolvedTheme
           }
         ),
@@ -31705,6 +31793,7 @@ function useAllowedCountry2() {
   ExecutionStatus,
   SOLANA_USDC_ADDRESS,
   UnifoldProvider,
+  WithdrawEventType,
   createDepositAddress,
   createOnrampSession,
   generatePrefixedKSUID,

package/dist/index.mjs

@@ -7128,8 +7128,13 @@ async function sendHypercoreTransaction(request, publishableKey) {
 }
 var DepositEventType = /* @__PURE__ */ ((DepositEventType2) => {
   DepositEventType2["ONRAMP_SESSION_CREATED"] = "onramp_session.created";
+  DepositEventType2["DIRECT_EXECUTION_SUCCEEDED"] = "direct_execution.succeeded";
   return DepositEventType2;
 })(DepositEventType || {});
+var WithdrawEventType = /* @__PURE__ */ ((WithdrawEventType2) => {
+  WithdrawEventType2["DIRECT_EXECUTION_SUCCEEDED"] = "direct_execution.succeeded";
+  return WithdrawEventType2;
+})(WithdrawEventType || {});
 function useUserIp() {
   const {
     data: userIpInfo,
@@ -15112,6 +15117,31 @@ function useDepositPolling({
   onDepositSuccess,
   onDepositError
 }) {
+  const createExecutionSuccessEvent = (execution) => ({
+    id: generatePrefixedKSUID("sevt"),
+    type: DepositEventType.DIRECT_EXECUTION_SUCCEEDED,
+    created: execution.updated_at ? Math.floor(new Date(execution.updated_at).getTime() / 1e3) : execution.created_at ? Math.floor(new Date(execution.created_at).getTime() / 1e3) : Math.floor(Date.now() / 1e3),
+    data: { object: mapToDirectExecution(execution) }
+  });
+  const mapToDirectExecution = (execution) => ({
+    id: execution.id,
+    transactionHash: execution.transaction_hash,
+    recipientAddress: execution.recipient_address,
+    depositAddress: execution.deposit_wallet?.address,
+    sourceChainType: execution.source_chain_type,
+    sourceChainId: execution.source_chain_id,
+    sourceTokenAddress: execution.source_token_address,
+    destinationChainType: execution.destination_chain_type,
+    destinationChainId: execution.destination_chain_id,
+    destinationTokenAddress: execution.destination_token_address,
+    sourceAmountBaseUnit: execution.source_amount_base_unit,
+    sourceAmountUsd: execution.source_amount_usd,
+    destinationAmountBaseUnit: execution.destination_amount_base_unit,
+    destinationAmountUsd: execution.destination_amount_usd,
+    destinationTransactionHashes: execution.destination_transaction_hashes,
+    status: execution.status,
+    failureReason: execution.failure_reason
+  });
   const [executions, setExecutions] = useState52([]);
   const [isPolling, setIsPolling] = useState52(false);
   const [pollingEnabled, setPollingEnabled] = useState52(false);
@@ -15225,7 +15255,9 @@ function useDepositPolling({
             onDepositSuccessRef.current?.({
               message: "Deposit completed successfully",
               executionId: execution.id,
-              transaction: execution
+              // Backward compatibility: keep transaction in API response shape.
+              transaction: execution,
+              execution: createExecutionSuccessEvent(execution)
             });
           } else if (execution.status === ExecutionStatus.FAILED && previousStatus !== ExecutionStatus.FAILED) {
             onDepositErrorRef.current?.({
@@ -21406,6 +21438,8 @@ function CoinbaseConnect({
   destinationChainId,
   destinationChainType,
   onTransferSuccess,
+  onDepositSuccess,
+  onDepositError,
   onTransferError,
   onClose,
   onBack: parentOnBack,
@@ -21553,10 +21587,14 @@ function CoinbaseConnect({
     depositWalletId: transferDepositWalletId,
     enabled: view === "success" && !!transferDepositWalletId,
     immediateDirectPolling: true,
-    onDepositSuccess: onTransferSuccess ? () => {
-      if (confirmResult) onTransferSuccess(confirmResult);
+    onDepositSuccess: onDepositSuccess || onTransferSuccess ? (data) => {
+      onDepositSuccess?.(data);
+      if (onTransferSuccess && confirmResult) onTransferSuccess(confirmResult);
     } : void 0,
-    onDepositError: onTransferError
+    onDepositError: onDepositError || onTransferError ? (error) => {
+      onDepositError?.(error);
+      onTransferError?.({ message: error.message });
+    } : void 0
   });
   useEffect172(() => {
     onExecutionsChange?.(depositExecutions);
@@ -28007,6 +28045,23 @@ function DepositModal({
   depositTrackerSubTitle = t7.depositTracker.subtitle
 }) {
   const { colors: colors2, fonts, components } = useTheme();
+  const onDepositSuccessFor = useCallback52(
+    (method) => onDepositSuccess || onEvent ? (data) => {
+      const payload = { ...data, method };
+      onDepositSuccess?.(payload);
+      if (payload.execution) {
+        onEvent?.({
+          ...payload.execution,
+          method
+        });
+      }
+    } : void 0,
+    [onDepositSuccess, onEvent]
+  );
+  const onDepositErrorFor = useCallback52(
+    (method) => onDepositError ? (error) => onDepositError({ ...error, method }) : void 0,
+    [onDepositError]
+  );
   const effectiveInitialScreen = useMemo10(() => {
     const s = initialScreen ?? "main";
     if (s === "tracker" && hideDepositTracker === true) return "main";
@@ -28691,8 +28746,8 @@ function DepositModal({
                     defaultSourceSymbol,
                     depositConfirmationMode,
                     onExecutionsChange: setDepositExecutions,
-                    onDepositSuccess,
-                    onDepositError,
+                    onDepositSuccess: onDepositSuccessFor("transfer"),
+                    onDepositError: onDepositErrorFor("transfer"),
                     wallets
                   }
                 ) : /* @__PURE__ */ jsx55(
@@ -28710,8 +28765,8 @@ function DepositModal({
                     defaultSourceSymbol,
                     depositConfirmationMode,
                     onExecutionsChange: setDepositExecutions,
-                    onDepositSuccess,
-                    onDepositError,
+                    onDepositSuccess: onDepositSuccessFor("transfer"),
+                    onDepositError: onDepositErrorFor("transfer"),
                     wallets
                   }
                 ),
@@ -28776,8 +28831,8 @@ function DepositModal({
                     destinationChainType,
                     destinationChainId,
                     destinationTokenAddress,
-                    onDepositSuccess,
-                    onDepositError,
+                    onDepositSuccess: onDepositSuccessFor("card"),
+                    onDepositError: onDepositErrorFor("card"),
                     onEvent,
                     themeClass,
                     wallets,
@@ -28812,8 +28867,8 @@ function DepositModal({
                     destinationChainType,
                     destinationChainId,
                     destinationTokenAddress,
-                    onDepositSuccess,
-                    onDepositError,
+                    onDepositSuccess: onDepositSuccessFor("pay_with_exchange"),
+                    onDepositError: onDepositErrorFor("pay_with_exchange"),
                     wallets,
                     defaultToken: defaultToken ?? null
                   }
@@ -28831,14 +28886,10 @@ function DepositModal({
                   destinationTokenAddress: destinationTokenAddress ?? "",
                   destinationChainId: destinationChainId ?? "",
                   destinationChainType: destinationChainType ?? "",
-                  onTransferSuccess: (result) => {
-                    onDepositSuccess?.({
-                      message: "Transfer completed via Coinbase Connect",
-                      transaction: result
-                    });
-                  },
+                  onDepositSuccess: onDepositSuccessFor("exchange_connect"),
+                  onDepositError: onDepositErrorFor("exchange_connect"),
                   onTransferError: (error) => {
-                    onDepositError?.({
+                    onDepositErrorFor("exchange_connect")?.({
                       message: error.message,
                       error
                     });
@@ -28867,20 +28918,14 @@ function DepositModal({
                   publishableKey,
                   assetCdnUrl: projectConfig?.asset_cdn_url,
                   projectName: projectConfig?.project_name,
-                  onSuccess: (txHash) => {
-                    onDepositSuccess?.({
-                      message: "Transaction sent successfully",
-                      transaction: { txHash }
-                    });
-                  },
                   onError: (error) => {
-                    onDepositError?.({
+                    onDepositErrorFor("wallet_connect")?.({
                       message: error.message,
                       error
                     });
                   },
-                  onDepositSuccess,
-                  onDepositError,
+                  onDepositSuccess: onDepositSuccessFor("wallet_connect"),
+                  onDepositError: onDepositErrorFor("wallet_connect"),
                   amountQuickSelect: browserWalletAmountQuickSelect,
                   onWalletDisconnect: handleWalletDisconnect,
                   onWalletConnected: (info, dw) => {
@@ -28924,8 +28969,8 @@ function DepositModal({
                     onViewChange: setCashAppView,
                     onAmountChange: setCashAppAmount,
                     onEvent,
-                    onDepositSuccess,
-                    onDepositError
+                    onDepositSuccess: onDepositSuccessFor("cashapp"),
+                    onDepositError: onDepositErrorFor("cashapp")
                   }
                 ),
                 depositPoweredByFooter
@@ -29763,6 +29808,31 @@ function useWithdrawPolling({
   onWithdrawSuccess,
   onWithdrawError
 }) {
+  const createExecutionSuccessEvent = (execution) => ({
+    id: generatePrefixedKSUID("sevt"),
+    type: WithdrawEventType.DIRECT_EXECUTION_SUCCEEDED,
+    created: execution.updated_at ? Math.floor(new Date(execution.updated_at).getTime() / 1e3) : execution.created_at ? Math.floor(new Date(execution.created_at).getTime() / 1e3) : Math.floor(Date.now() / 1e3),
+    data: { object: mapToDirectExecution(execution) }
+  });
+  const mapToDirectExecution = (execution) => ({
+    id: execution.id,
+    transactionHash: execution.transaction_hash,
+    recipientAddress: execution.recipient_address,
+    depositAddress: execution.deposit_wallet?.address,
+    sourceChainType: execution.source_chain_type,
+    sourceChainId: execution.source_chain_id,
+    sourceTokenAddress: execution.source_token_address,
+    destinationChainType: execution.destination_chain_type,
+    destinationChainId: execution.destination_chain_id,
+    destinationTokenAddress: execution.destination_token_address,
+    sourceAmountBaseUnit: execution.source_amount_base_unit,
+    sourceAmountUsd: execution.source_amount_usd,
+    destinationAmountBaseUnit: execution.destination_amount_base_unit,
+    destinationAmountUsd: execution.destination_amount_usd,
+    destinationTransactionHashes: execution.destination_transaction_hashes,
+    status: execution.status,
+    failureReason: execution.failure_reason
+  });
   const [executions, setExecutions] = useState34([]);
   const [isPolling, setIsPolling] = useState34(false);
   const enabledAtRef = useRef112(/* @__PURE__ */ new Date());
@@ -29830,7 +29900,13 @@ function useWithdrawPolling({
             return [...list, ex];
           });
           if (ex.status === ExecutionStatus.SUCCEEDED && (!prev || inProgress.includes(prev))) {
-            onSuccessRef.current?.({ message: "Withdrawal completed successfully", executionId: ex.id, transaction: ex });
+            onSuccessRef.current?.({
+              message: "Withdrawal completed successfully",
+              executionId: ex.id,
+              // Backward compatibility: keep transaction in API response shape.
+              transaction: ex,
+              execution: createExecutionSuccessEvent(ex)
+            });
           } else if (ex.status === ExecutionStatus.FAILED && prev !== ExecutionStatus.FAILED) {
             onErrorRef.current?.({ message: "Withdrawal failed", code: "WITHDRAW_FAILED", error: ex });
           }
@@ -31032,9 +31108,19 @@ function WithdrawModal({
   onWithdraw,
   onWithdrawSuccess,
   onWithdrawError,
+  onEvent,
   theme = "dark",
   hideOverlay = false
 }) {
+  const onWithdrawSuccessFor = useCallback82(
+    (data) => {
+      onWithdrawSuccess?.(data);
+      if (data.execution) {
+        onEvent?.(data.execution);
+      }
+    },
+    [onWithdrawSuccess, onEvent]
+  );
   const { colors: colors2, fonts, components } = useTheme();
   const [containerEl, setContainerEl] = useState37(null);
   const containerCallbackRef = useCallback82((el) => {
@@ -31096,7 +31182,7 @@ function WithdrawModal({
     publishableKey,
     depositWalletId: withdrawDepositWalletId,
     enabled: !!withdrawDepositWalletId && open,
-    onWithdrawSuccess: onWithdrawSuccess ? (d) => onWithdrawSuccess({ message: d.message, transaction: d.transaction }) : void 0,
+    onWithdrawSuccess: onWithdrawSuccess || onEvent ? onWithdrawSuccessFor : void 0,
     onWithdrawError
   });
   const { data: allWithdrawalsData } = useExecutions(externalUserId, publishableKey, {
@@ -31596,6 +31682,7 @@ function UnifoldProvider2({
             onWithdraw: withdrawConfig.withdraw,
             onWithdrawSuccess: handleWithdrawSuccess,
             onWithdrawError: handleWithdrawError,
+            onEvent: withdrawConfig.onEvent,
             theme: resolvedTheme
           }
         ),
@@ -31690,6 +31777,7 @@ export {
   ExecutionStatus,
   SOLANA_USDC_ADDRESS,
   UnifoldProvider2 as UnifoldProvider,
+  WithdrawEventType,
   createDepositAddress,
   createOnrampSession,
   generatePrefixedKSUID,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unifold/connect-react",
-  "version": "0.1.66",
+  "version": "0.1.67",
   "description": "Unifold Connect React - Complete React SDK with UI components for crypto deposits",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -26,9 +26,9 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.90.11",
-    "@unifold/core": "0.1.66",
-    "@unifold/ui-react": "0.1.66",
-    "@unifold/react-provider": "0.1.66"
+    "@unifold/core": "0.1.67",
+    "@unifold/react-provider": "0.1.67",
+    "@unifold/ui-react": "0.1.67"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",