@unifold/connect-react 0.1.79 → 0.1.81

package/README.md

@@ -24,6 +24,11 @@ function App() {
       config={{
         modalTitle: 'Deposit Crypto',
         hideDepositTracker: false,
+        display: {
+          transferCrypto: {
+            exchangeRate: true,
+          },
+        },
       }}
     >
       <YourApp />
@@ -93,6 +98,8 @@ Wraps your application and provides the Unifold context.
     - `'dark'`: Force dark mode (default)
     - `'auto'`: Use system preference and respond to changes
   - `layout` (optional): Deposit menu layout and its options - `{ type, tabOrder }` (`type` defaults to `'tabs'`)
+  - `display` (optional): Surface-specific presentation toggles
+    - `display.transferCrypto.exchangeRate` (optional): Show exchange rate on Transfer Crypto screens (defaults to `false`)
 - `children` (required): Your React components
 
 ```tsx
@@ -522,6 +529,11 @@ const providerConfig: UnifoldConnectProviderConfig = {
   config: {
     modalTitle: 'Deposit',
     hideDepositTracker: false,
+    display: {
+      transferCrypto: {
+        exchangeRate: true,
+      },
+    },
   },
 };
 

package/dist/index.d.mts

@@ -21,9 +21,9 @@ interface UnifoldConnectProviderConfig {
     queryClient?: QueryClient;
     config?: {
         /**
-         * UI language as a BCP-47 tag (e.g. "en", "zh", "zh-CN", "zh-TW"). When
-         * omitted, the browser locale is auto-detected. Unsupported locales fall
-         * back to English.
+         * UI language as a BCP-47 tag (e.g. "en", "zh", "fr", "ja", "ko", "th").
+         * When omitted, the browser locale is auto-detected. Unsupported locales
+         * fall back to English.
          */
         locale?: string;
         modalTitle?: string;
@@ -80,6 +80,18 @@ interface UnifoldConnectProviderConfig {
              */
             incidentBanner?: boolean;
         };
+        /**
+         * Display preferences for specific deposit surfaces.
+         */
+        display?: {
+            transferCrypto?: {
+                /**
+                 * Show the reference exchange-rate row on Transfer Crypto screens.
+                 * Defaults to false.
+                 */
+                exchangeRate?: boolean;
+            };
+        };
         /**
          * Enable "Pay with Apple Pay" (headless Coinbase) option. Overrides
          * dashboard default. Resolves as flag ?? dashboard `apple_pay.enabled` ??
@@ -89,7 +101,7 @@ interface UnifoldConnectProviderConfig {
         enableApplePay?: boolean;
         /** Main menu — Apple Pay row title. @default `"Pay with Apple Pay"` (localized when omitted) */
         applePayTitle?: string;
-        /** Main menu — Apple Pay row subtitle. @default `"Instant"` (localized when omitted) */
+        /** Main menu — Apple Pay row subtitle. @default `"Instant • Debit card only"` (localized when omitted) */
         applePaySubTitle?: string;
         /**
          * Enable "Pay with Google Pay" (headless Coinbase) option. Overrides
@@ -100,7 +112,7 @@ interface UnifoldConnectProviderConfig {
         enableGooglePay?: boolean;
         /** Main menu — Google Pay row title. @default `"Pay with Google Pay"` (localized when omitted) */
         googlePayTitle?: string;
-        /** Main menu — Google Pay row subtitle. @default `"Instant"` (localized when omitted) */
+        /** Main menu — Google Pay row subtitle. @default `"Instant • Debit card only"` (localized when omitted) */
         googlePaySubTitle?: string;
         /** Simple accent/primary color override (applies to both light and dark modes) */
         accentColor?: string;
@@ -314,14 +326,37 @@ interface WithdrawConfig {
     defaultDestinationSymbol?: string;
     /**
      * The user's wallet address (the sender). Used to:
-     * 1. Fetch balance for quick-select chips (25%/50%/75%/MAX)
+     * 1. Fetch balance for max / over-balance (unless `balanceInBaseUnit` is provided)
      * 2. Detect if a matching browser wallet is connected
      */
     senderAddress: string;
+    /**
+     * Sender token balance in smallest units (e.g. `"1500000"` for 1.5 USDC).
+     * When provided, the modal skips `/addresses/balance` and uses this as the
+     * source of truth for max withdraw, over-balance checks, and amount conversion.
+     */
+    balanceInBaseUnit?: string;
+    /**
+     * USD value of {@link WithdrawConfig.balanceInBaseUnit}. When provided with
+     * `balanceInBaseUnit`, used for fiat display, max, and crypto↔USD conversion
+     * with no extra network calls. When omitted, the modal prices the token
+     * (stablecoins assume $1) to compute USD.
+     */
+    balanceUsd?: string | number;
+    /**
+     * Source token decimals (e.g. `6` for USDC). Used with `balanceInBaseUnit`
+     * to format the human amount without waiting on the token catalog. Falls
+     * back to catalog decimals when omitted.
+     */
+    sourceTokenDecimals?: number;
     /**
      * Callback invoked with transaction details when the user confirms withdrawal.
      * The host app is responsible for signing and submitting the transaction — the
      * SDK does not have access to the user's private key.
+     *
+     * Move `txInfo.amountBaseUnit` to `txInfo.withdrawIntentAddress`. That address
+     * is not always on `sourceChainType`: withdrawing off a chain Unifold can't
+     * monitor (N1) hands back a Solana address to bridge to instead.
      */
     withdraw: (txInfo: WithdrawTransactionInfo) => void | Promise<void>;
     onSuccess?: (data: WithdrawResult) => void;

package/dist/index.d.ts

@@ -21,9 +21,9 @@ interface UnifoldConnectProviderConfig {
     queryClient?: QueryClient;
     config?: {
         /**
-         * UI language as a BCP-47 tag (e.g. "en", "zh", "zh-CN", "zh-TW"). When
-         * omitted, the browser locale is auto-detected. Unsupported locales fall
-         * back to English.
+         * UI language as a BCP-47 tag (e.g. "en", "zh", "fr", "ja", "ko", "th").
+         * When omitted, the browser locale is auto-detected. Unsupported locales
+         * fall back to English.
          */
         locale?: string;
         modalTitle?: string;
@@ -80,6 +80,18 @@ interface UnifoldConnectProviderConfig {
              */
             incidentBanner?: boolean;
         };
+        /**
+         * Display preferences for specific deposit surfaces.
+         */
+        display?: {
+            transferCrypto?: {
+                /**
+                 * Show the reference exchange-rate row on Transfer Crypto screens.
+                 * Defaults to false.
+                 */
+                exchangeRate?: boolean;
+            };
+        };
         /**
          * Enable "Pay with Apple Pay" (headless Coinbase) option. Overrides
          * dashboard default. Resolves as flag ?? dashboard `apple_pay.enabled` ??
@@ -89,7 +101,7 @@ interface UnifoldConnectProviderConfig {
         enableApplePay?: boolean;
         /** Main menu — Apple Pay row title. @default `"Pay with Apple Pay"` (localized when omitted) */
         applePayTitle?: string;
-        /** Main menu — Apple Pay row subtitle. @default `"Instant"` (localized when omitted) */
+        /** Main menu — Apple Pay row subtitle. @default `"Instant • Debit card only"` (localized when omitted) */
         applePaySubTitle?: string;
         /**
          * Enable "Pay with Google Pay" (headless Coinbase) option. Overrides
@@ -100,7 +112,7 @@ interface UnifoldConnectProviderConfig {
         enableGooglePay?: boolean;
         /** Main menu — Google Pay row title. @default `"Pay with Google Pay"` (localized when omitted) */
         googlePayTitle?: string;
-        /** Main menu — Google Pay row subtitle. @default `"Instant"` (localized when omitted) */
+        /** Main menu — Google Pay row subtitle. @default `"Instant • Debit card only"` (localized when omitted) */
         googlePaySubTitle?: string;
         /** Simple accent/primary color override (applies to both light and dark modes) */
         accentColor?: string;
@@ -314,14 +326,37 @@ interface WithdrawConfig {
     defaultDestinationSymbol?: string;
     /**
      * The user's wallet address (the sender). Used to:
-     * 1. Fetch balance for quick-select chips (25%/50%/75%/MAX)
+     * 1. Fetch balance for max / over-balance (unless `balanceInBaseUnit` is provided)
      * 2. Detect if a matching browser wallet is connected
      */
     senderAddress: string;
+    /**
+     * Sender token balance in smallest units (e.g. `"1500000"` for 1.5 USDC).
+     * When provided, the modal skips `/addresses/balance` and uses this as the
+     * source of truth for max withdraw, over-balance checks, and amount conversion.
+     */
+    balanceInBaseUnit?: string;
+    /**
+     * USD value of {@link WithdrawConfig.balanceInBaseUnit}. When provided with
+     * `balanceInBaseUnit`, used for fiat display, max, and crypto↔USD conversion
+     * with no extra network calls. When omitted, the modal prices the token
+     * (stablecoins assume $1) to compute USD.
+     */
+    balanceUsd?: string | number;
+    /**
+     * Source token decimals (e.g. `6` for USDC). Used with `balanceInBaseUnit`
+     * to format the human amount without waiting on the token catalog. Falls
+     * back to catalog decimals when omitted.
+     */
+    sourceTokenDecimals?: number;
     /**
      * Callback invoked with transaction details when the user confirms withdrawal.
      * The host app is responsible for signing and submitting the transaction — the
      * SDK does not have access to the user's private key.
+     *
+     * Move `txInfo.amountBaseUnit` to `txInfo.withdrawIntentAddress`. That address
+     * is not always on `sourceChainType`: withdrawing off a chain Unifold can't
+     * monitor (N1) hands back a Solana address to bridge to instead.
      */
     withdraw: (txInfo: WithdrawTransactionInfo) => void | Promise<void>;
     onSuccess?: (data: WithdrawResult) => void;