@unifold/connect-react 0.1.61 → 0.1.63

package/README.md

@@ -132,13 +132,13 @@ Launches the deposit modal with the specified configuration. **Returns a Promise
 | `destinationTokenAddress` | string | ✅ | Token contract address |
 | `destinationTokenSymbol` | string | ✅ | Token symbol (e.g., "USDC") |
 | `recipientAddress` | string | ✅ | Recipient wallet address |
-| `defaultSourceChainType` | string | - | Pre-select source chain type in Transfer Crypto (e.g. `"solana"`, `"ethereum"`). Must be paired with `defaultSourceChainId` + symbol or token address. If omitted or no match, defaults to the first token from `/supported_deposit_tokens`. |
+| `defaultSourceChainType` | string | - | Prefer source chain type in Transfer Crypto, Wallet Connect, and Connect Exchange (e.g. `"solana"`, `"ethereum"`). Must be paired with `defaultSourceChainId` + symbol or token address. If omitted or no match, each flow uses its normal ordering. |
 | `defaultSourceChainId` | string | - | Source chain ID (e.g. `"mainnet"`, `"137"`). Paired with `defaultSourceChainType`. |
 | `defaultSourceTokenAddress` | string | - | Source token contract address. Paired with chain type + chain ID. |
 | `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

@@ -28,15 +28,17 @@ interface UnifoldConnectProviderConfig {
         appearance?: ThemeMode | 'auto';
         /** Transfer input variant: 'single_input' or 'double_input'. Defaults to 'double_input' */
         transferInputVariant?: 'single_input' | 'double_input';
-        /** Enable browser wallet connection option. Defaults to false */
+        /** Enable "Transfer Crypto" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
+        enableTransferCrypto?: boolean;
+        /** Enable browser wallet connection option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableConnectWallet?: boolean;
-        /** Enable "Pay with Exchange" option. Overrides dashboard default. Defaults to dashboard value or true. */
+        /** Enable "Pay with Exchange" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enablePayWithExchange?: boolean;
-        /** Enable the fiat on-ramp option (shown as "Deposit with Card"). Overrides dashboard default. Defaults to dashboard value or true. */
+        /** Enable the fiat on-ramp option (shown as "Deposit with Card"). Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableFiatOnramp?: boolean;
-        /** Enable "Connect Exchange" option for direct Coinbase Connect integration. Defaults to false. */
+        /** Enable "Connect Exchange" option for direct Coinbase Connect integration. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableConnectExchange?: boolean;
-        /** Enable "Pay with Cash App" option. Defaults to false. */
+        /** Enable "Pay with Cash App" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableCashApp?: boolean;
         /** Simple accent/primary color override (applies to both light and dark modes) */
         accentColor?: string;
@@ -93,9 +95,9 @@ interface DepositConfig {
      */
     contractCalls?: EvmContractCall[];
     /**
-     * Pre-select source token/chain in the Transfer Crypto view.
+     * Prefer a source token/chain in Transfer Crypto, Wallet Connect, and Connect Exchange flows.
      * All four props are optional. To match a specific token, provide `chainType` + `chainId` + (`symbol` OR `tokenAddress`).
-     * If omitted or no match is found in `/supported_deposit_tokens`, the first available token and chain are used.
+     * If omitted or no match is found in `/supported_deposit_tokens`, each flow uses its normal ordering.
      */
     defaultSourceChainType?: ChainType;
     /** Source chain ID (e.g. `"mainnet"`, `"137"`). Must be paired with `defaultSourceChainType` and a symbol or token address. */
@@ -113,10 +115,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;
 }
@@ -142,9 +148,9 @@ interface CheckoutConfig {
     /** The client_secret from a PaymentIntent created on your server */
     clientSecret: string;
     /**
-     * Pre-select source token/chain in the Transfer Crypto view.
+     * Prefer a source token/chain in Transfer Crypto and Wallet Connect flows.
      * All four props are optional. To match a specific token, provide `chainType` + `chainId` + (`symbol` OR `tokenAddress`).
-     * If omitted or no match is found in `/supported_deposit_tokens`, the first available token and chain are used.
+     * If omitted or no match is found in `/supported_deposit_tokens`, each flow uses its normal ordering.
      */
     defaultSourceChainType?: ChainType;
     /** Source chain ID (e.g. `"mainnet"`, `"137"`). Must be paired with `defaultSourceChainType` + symbol or token address. */

package/dist/index.d.ts

@@ -28,15 +28,17 @@ interface UnifoldConnectProviderConfig {
         appearance?: ThemeMode | 'auto';
         /** Transfer input variant: 'single_input' or 'double_input'. Defaults to 'double_input' */
         transferInputVariant?: 'single_input' | 'double_input';
-        /** Enable browser wallet connection option. Defaults to false */
+        /** Enable "Transfer Crypto" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
+        enableTransferCrypto?: boolean;
+        /** Enable browser wallet connection option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableConnectWallet?: boolean;
-        /** Enable "Pay with Exchange" option. Overrides dashboard default. Defaults to dashboard value or true. */
+        /** Enable "Pay with Exchange" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enablePayWithExchange?: boolean;
-        /** Enable the fiat on-ramp option (shown as "Deposit with Card"). Overrides dashboard default. Defaults to dashboard value or true. */
+        /** Enable the fiat on-ramp option (shown as "Deposit with Card"). Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableFiatOnramp?: boolean;
-        /** Enable "Connect Exchange" option for direct Coinbase Connect integration. Defaults to false. */
+        /** Enable "Connect Exchange" option for direct Coinbase Connect integration. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableConnectExchange?: boolean;
-        /** Enable "Pay with Cash App" option. Defaults to false. */
+        /** Enable "Pay with Cash App" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableCashApp?: boolean;
         /** Simple accent/primary color override (applies to both light and dark modes) */
         accentColor?: string;
@@ -93,9 +95,9 @@ interface DepositConfig {
      */
     contractCalls?: EvmContractCall[];
     /**
-     * Pre-select source token/chain in the Transfer Crypto view.
+     * Prefer a source token/chain in Transfer Crypto, Wallet Connect, and Connect Exchange flows.
      * All four props are optional. To match a specific token, provide `chainType` + `chainId` + (`symbol` OR `tokenAddress`).
-     * If omitted or no match is found in `/supported_deposit_tokens`, the first available token and chain are used.
+     * If omitted or no match is found in `/supported_deposit_tokens`, each flow uses its normal ordering.
      */
     defaultSourceChainType?: ChainType;
     /** Source chain ID (e.g. `"mainnet"`, `"137"`). Must be paired with `defaultSourceChainType` and a symbol or token address. */
@@ -113,10 +115,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;
 }
@@ -142,9 +148,9 @@ interface CheckoutConfig {
     /** The client_secret from a PaymentIntent created on your server */
     clientSecret: string;
     /**
-     * Pre-select source token/chain in the Transfer Crypto view.
+     * Prefer a source token/chain in Transfer Crypto and Wallet Connect flows.
      * All four props are optional. To match a specific token, provide `chainType` + `chainId` + (`symbol` OR `tokenAddress`).
-     * If omitted or no match is found in `/supported_deposit_tokens`, the first available token and chain are used.
+     * If omitted or no match is found in `/supported_deposit_tokens`, each flow uses its normal ordering.
      */
     defaultSourceChainType?: ChainType;
     /** Source chain ID (e.g. `"mainnet"`, `"137"`). Must be paired with `defaultSourceChainType` + symbol or token address. */