@unifold/connect-react 0.1.34 → 0.1.36

package/README.md

@@ -134,6 +134,7 @@ Launches the deposit modal with the specified configuration. **Returns a Promise
 | `recipientAddress` | string | ✅ | Recipient wallet address |
 | `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. |
 
 **Returns:** `Promise<DepositResult>`
 
@@ -172,6 +173,16 @@ try {
   console.error('Error:', error);
 }
 
+// Standalone Transfer Crypto (geo checks + no back to menu by default)
+await beginDeposit({
+  externalUserId: 'user_123',
+  destinationChainId: '137',
+  destinationTokenAddress: '0x2791bca1f2de4661ed88a30c99a7a9449aa84174',
+  destinationTokenSymbol: 'USDC',
+  recipientAddress: '0x606C49ca2Fa4982F07016265040F777eD3DA3160',
+  initialScreen: 'transfer',
+});
+
 // Hybrid (promise + callbacks)
 const depositPromise = beginDeposit({
   userId: 'user_123',

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { ThemeMode, ThemeConfig, FontConfig, ComponentConfig, ChainType, DepositConfirmationMode, AllowedCountryResult } from '@unifold/ui-react';
-export { AllowedCountryResult, Button, ButtonProps, ButtonTokens, CardTokens, ComponentConfig, ComponentTokens, ContainerTokens, CustomThemeColors, DepositConfirmationMode, FontConfig, HeaderTokens, InputTokens, ListTokens, SearchTokens, ThemeColors, ThemeConfig, ThemeMode } from '@unifold/ui-react';
+import { ThemeMode, ThemeConfig, FontConfig, ComponentConfig, DepositModalInitialScreen, ChainType, DepositConfirmationMode, AllowedCountryResult } from '@unifold/ui-react';
+export { AllowedCountryResult, Button, ButtonProps, ButtonTokens, CardTokens, ComponentConfig, ComponentTokens, 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';
 
 interface UnifoldConnectProviderConfig {
@@ -29,6 +29,8 @@ interface UnifoldConnectProviderConfig {
         fonts?: FontConfig;
         /** Component-specific token overrides */
         components?: ComponentConfig;
+        /** Default `initialScreen` for `beginDeposit()` when the call omits it */
+        defaultInitialScreen?: DepositModalInitialScreen;
     };
 }
 interface DepositResult {
@@ -54,6 +56,13 @@ interface DepositConfig {
     onError?: (error: DepositError) => void;
     /** Called when the user dismisses the deposit dialog (X button, Escape key, or programmatic close) */
     onClose?: () => void;
+    /**
+     * Which screen opens first: menu (`main`, default), `transfer`, `card`, or `tracker`.
+     * `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.
+     */
+    initialScreen?: DepositModalInitialScreen;
 }
 declare function UnifoldProvider({ children, publishableKey, config, }: React.PropsWithChildren<UnifoldConnectProviderConfig>): react_jsx_runtime.JSX.Element;
 declare function useUnifold(): {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { ThemeMode, ThemeConfig, FontConfig, ComponentConfig, ChainType, DepositConfirmationMode, AllowedCountryResult } from '@unifold/ui-react';
-export { AllowedCountryResult, Button, ButtonProps, ButtonTokens, CardTokens, ComponentConfig, ComponentTokens, ContainerTokens, CustomThemeColors, DepositConfirmationMode, FontConfig, HeaderTokens, InputTokens, ListTokens, SearchTokens, ThemeColors, ThemeConfig, ThemeMode } from '@unifold/ui-react';
+import { ThemeMode, ThemeConfig, FontConfig, ComponentConfig, DepositModalInitialScreen, ChainType, DepositConfirmationMode, AllowedCountryResult } from '@unifold/ui-react';
+export { AllowedCountryResult, Button, ButtonProps, ButtonTokens, CardTokens, ComponentConfig, ComponentTokens, 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';
 
 interface UnifoldConnectProviderConfig {
@@ -29,6 +29,8 @@ interface UnifoldConnectProviderConfig {
         fonts?: FontConfig;
         /** Component-specific token overrides */
         components?: ComponentConfig;
+        /** Default `initialScreen` for `beginDeposit()` when the call omits it */
+        defaultInitialScreen?: DepositModalInitialScreen;
     };
 }
 interface DepositResult {
@@ -54,6 +56,13 @@ interface DepositConfig {
     onError?: (error: DepositError) => void;
     /** Called when the user dismisses the deposit dialog (X button, Escape key, or programmatic close) */
     onClose?: () => void;
+    /**
+     * Which screen opens first: menu (`main`, default), `transfer`, `card`, or `tracker`.
+     * `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.
+     */
+    initialScreen?: DepositModalInitialScreen;
 }
 declare function UnifoldProvider({ children, publishableKey, config, }: React.PropsWithChildren<UnifoldConnectProviderConfig>): react_jsx_runtime.JSX.Element;
 declare function useUnifold(): {