@unifold/connect-react 0.1.68-beta.2 → 0.1.69

package/README.md

@@ -136,6 +136,7 @@ Launches the deposit modal with the specified configuration. **Returns a Promise
 | `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. |
+| `prefilledAmountUsd` | string | - | Optional USD amount prefilled for deposit amount inputs (Connect Wallet, Deposit with Card, Bank Transfer, Cash App). It is applied as initial typed input and does not enable checkout mode. |
 | `onSuccess` | function | - | Success callback (fired immediately) |
 | `onError` | function | - | Error callback (fired immediately) |
 | `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. |
@@ -187,6 +188,17 @@ await beginDeposit({
   initialScreen: 'transfer',
 });
 
+// Deposit mode with pre-filled amount (no Payment Intent required)
+await beginDeposit({
+  externalUserId: 'user_123',
+  destinationChainId: '137',
+  destinationTokenAddress: '0x2791bca1f2de4661ed88a30c99a7a9449aa84174',
+  destinationTokenSymbol: 'USDC',
+  recipientAddress: '0x606C49ca2Fa4982F07016265040F777eD3DA3160',
+  initialScreen: 'wallet_connect',
+  prefilledAmountUsd: '25.00',
+});
+
 // Hybrid (promise + callbacks)
 const depositPromise = beginDeposit({
   userId: 'user_123',

package/dist/index.d.mts

@@ -144,6 +144,12 @@ interface DepositConfig {
     defaultSourceTokenAddress?: string;
     /** Source token symbol (e.g. `"USDC"`). Must be paired with `defaultSourceChainType` + `defaultSourceChainId` to match. */
     defaultSourceSymbol?: string;
+    /**
+     * Pre-fill USD amount inputs in deposit flows as initial typed input.
+     * Useful for "deposit mode" flows that skip Payment Intent and still want a
+     * suggested amount.
+     */
+    prefilledAmountUsd?: string;
     /** How to confirm deposit: 'auto_ui' (default), 'auto_silent', or 'manual' */
     depositConfirmationMode?: DepositConfirmationMode;
     onSuccess?: (data: DepositResult) => void;

package/dist/index.d.ts

@@ -144,6 +144,12 @@ interface DepositConfig {
     defaultSourceTokenAddress?: string;
     /** Source token symbol (e.g. `"USDC"`). Must be paired with `defaultSourceChainType` + `defaultSourceChainId` to match. */
     defaultSourceSymbol?: string;
+    /**
+     * Pre-fill USD amount inputs in deposit flows as initial typed input.
+     * Useful for "deposit mode" flows that skip Payment Intent and still want a
+     * suggested amount.
+     */
+    prefilledAmountUsd?: string;
     /** How to confirm deposit: 'auto_ui' (default), 'auto_silent', or 'manual' */
     depositConfirmationMode?: DepositConfirmationMode;
     onSuccess?: (data: DepositResult) => void;