@unifold/connect-react 0.1.60 → 0.1.62

package/README.md

@@ -138,7 +138,7 @@ Launches the deposit modal with the specified configuration. **Returns a Promise
 | `defaultSourceSymbol` | string | - | Source token symbol (e.g. `"USDC"`). Paired with chain type + chain ID. |
 | `onSuccess` | function | - | Success callback (fired immediately) |
 | `onError` | function | - | Error callback (fired immediately) |
-| `initialScreen` | `'main' \| 'transfer' \| 'card' \| 'tracker'` | - | `main` (default) = deposit menu. `transfer` / `card` use the **same geo/validation gates** as the menu. `tracker` opens the list **without** those gates. If not `main`, the header **back** is hidden (standalone); from `main`, back returns to the menu. Card quotes/onramp and tracker detail still show back for inner steps. |
+| `initialScreen` | `'main' \| 'transfer' \| 'card' \| 'cashapp' \| 'tracker' \| 'pay_with_exchange' \| 'exchange_connect' \| 'wallet_connect'` | - | `main` (default) = deposit menu. `transfer` / `card` use the **same geo/validation gates** as the menu. `tracker` opens the list **without** those gates. `cashapp`, `pay_with_exchange`, `exchange_connect`, `wallet_connect` open their respective flows and **fall back to `main`** when the matching feature flag (`enableCashApp`, `enablePayWithExchange`, `enableConnectExchange`, `enableConnectWallet`) is disabled. If not `main`, the header **back** is hidden at the flow root (standalone); from `main`, back returns to the menu. Inner steps (card quotes/onramp, tracker detail, exchange pending, cashapp payment) still show back. |
 
 **Returns:** `Promise<DepositResult>`
 

package/dist/index.d.mts

@@ -3,7 +3,7 @@ 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 { DepositEvent } from '@unifold/core';
+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';
 
 interface UnifoldConnectProviderConfig {
@@ -85,6 +85,13 @@ interface DepositConfig {
     destinationTokenAddress: string;
     destinationTokenSymbol: string;
     recipientAddress: 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").
+     * Only supported when destinationChainType is "ethereum" and
+     * destinationChainId is one of: "1", "8453", "42161", "4326".
+     */
+    contractCalls?: EvmContractCall[];
     /**
      * Pre-select source token/chain in the Transfer Crypto view.
      * All four props are optional. To match a specific token, provide `chainType` + `chainId` + (`symbol` OR `tokenAddress`).
@@ -106,10 +113,14 @@ interface DepositConfig {
     /** Called when deposit lifecycle events occur. Use {@link DepositEventType} to narrow the event type. See {@link DepositEvent} for the full union. */
     onEvent?: (event: DepositEvent) => void;
     /**
-     * Which screen opens first: menu (`main`, default), `transfer`, `card`, or `tracker`.
+     * Which screen opens first. One of: `main` (menu, default), `transfer`, `card`, `cashapp`,
+     * `tracker`, `pay_with_exchange` (Pay with Exchange), `exchange_connect` (Connect Exchange), or
+     * `wallet_connect` (Connect Wallet).
      * `transfer` and `card` run the same geo / recipient checks as the menu before the flow. `tracker` does not
-     * (deposit history is always reachable). If not `main`, the header back control is hidden (nothing to return to);
-     * card quotes/onramp and tracker detail still show back for inner navigation.
+     * (deposit history is always reachable). A screen falls back to `main` when its feature flag is disabled
+     * (e.g. `cashapp` without `enableCashApp`, `exchange_connect` without `enableConnectExchange`).
+     * If not `main`, the header back control is hidden at the flow's root (nothing to return to); inner steps
+     * (card quotes/onramp, tracker detail, exchange pending, cashapp payment, etc.) still show back for inner navigation.
      */
     initialScreen?: DepositModalInitialScreen;
 }

package/dist/index.d.ts

@@ -3,7 +3,7 @@ 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 { DepositEvent } from '@unifold/core';
+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';
 
 interface UnifoldConnectProviderConfig {
@@ -85,6 +85,13 @@ interface DepositConfig {
     destinationTokenAddress: string;
     destinationTokenSymbol: string;
     recipientAddress: 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").
+     * Only supported when destinationChainType is "ethereum" and
+     * destinationChainId is one of: "1", "8453", "42161", "4326".
+     */
+    contractCalls?: EvmContractCall[];
     /**
      * Pre-select source token/chain in the Transfer Crypto view.
      * All four props are optional. To match a specific token, provide `chainType` + `chainId` + (`symbol` OR `tokenAddress`).
@@ -106,10 +113,14 @@ interface DepositConfig {
     /** Called when deposit lifecycle events occur. Use {@link DepositEventType} to narrow the event type. See {@link DepositEvent} for the full union. */
     onEvent?: (event: DepositEvent) => void;
     /**
-     * Which screen opens first: menu (`main`, default), `transfer`, `card`, or `tracker`.
+     * Which screen opens first. One of: `main` (menu, default), `transfer`, `card`, `cashapp`,
+     * `tracker`, `pay_with_exchange` (Pay with Exchange), `exchange_connect` (Connect Exchange), or
+     * `wallet_connect` (Connect Wallet).
      * `transfer` and `card` run the same geo / recipient checks as the menu before the flow. `tracker` does not
-     * (deposit history is always reachable). If not `main`, the header back control is hidden (nothing to return to);
-     * card quotes/onramp and tracker detail still show back for inner navigation.
+     * (deposit history is always reachable). A screen falls back to `main` when its feature flag is disabled
+     * (e.g. `cashapp` without `enableCashApp`, `exchange_connect` without `enableConnectExchange`).
+     * If not `main`, the header back control is hidden at the flow's root (nothing to return to); inner steps
+     * (card quotes/onramp, tracker detail, exchange pending, cashapp payment, etc.) still show back for inner navigation.
      */
     initialScreen?: DepositModalInitialScreen;
 }