@unifold/connect-react 0.1.79 → 0.1.80

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;
@@ -89,7 +89,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 +100,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 +314,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;
@@ -89,7 +89,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 +100,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 +314,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;