@nexus-cross/dapp-ui 1.3.10-beta.6 → 1.3.10-beta.8

package/dist/index.d.cts

@@ -2191,6 +2191,14 @@ interface RelayDepositProps extends RelayWalletProps {
     /** Controlled recipient; when provided the recipient input is hidden and no wallet
      * connection is required to fetch a deposit address. Defaults to `walletAddress`. */
     recipient?: string;
+    /** Require a valid connected wallet before the deposit flow can issue an
+     * address, quote an amount, or start live order/recovery reads. When enabled,
+     * the recipient is pinned to `walletAddress`; a controlled `recipient` cannot
+     * redirect the connected user's deposit. Defaults to `true` when
+     * `showRecipientInput` is explicitly `false`, otherwise `false` for the
+     * low-level public-address integration. `CrossRelayDeposit` always enables
+     * this guard. */
+    requireWalletConnection?: boolean;
     /** Hide the editable recipient input even when `recipient` is NOT controlled
      * (default `true` = original behavior). Hosts that lock the recipient to the
      * connected wallet set this `false` so a disconnected user sees a connect
@@ -2232,10 +2240,9 @@ interface RelayDepositProps extends RelayWalletProps {
     onDeposited?: (txHash: string) => void;
     onError?: (error: Error) => void;
     /** Called by the `Connect Wallet` CTA under the locked card that stands in for the QR
-     * while there is neither a connected wallet nor a usable recipient (host-supplied or
-     * typed). Omitted — the locked card renders as text only, with no button. The rest of
-     * the screen stays usable either way: typing a valid recipient is a supported,
-     * wallet-free path to a deposit address. */
+     * while the required connected wallet (or, in low-level public-address mode,
+     * a usable recipient) is absent. Omitted — the locked card renders as text
+     * only, with no button. */
     onRequestConnect?: () => void;
     /** @deprecated The Deposit footer entry was removed. Retained as a no-op
      * compatibility prop so existing hosts do not need an immediate migration. */
@@ -2282,9 +2289,10 @@ interface RelayRecoveryProps extends RelayWalletProps {
      */
     environment?: Environment;
     /**
-     * Whose forwarder to check/recover. Defaults to `walletAddress`; when
-     * neither resolves to a valid address the modal renders a short connect note
-     * and makes ZERO requests (no catalog, no recovery lookup).
+     * Optional assertion of whose forwarder to check/recover. Recovery is always
+     * pinned to the valid connected `walletAddress`; when this value is supplied
+     * it must match that wallet. A missing/invalid wallet or mismatch renders a
+     * short note and makes ZERO requests (no catalog, no recovery lookup).
      */
     recipient?: string;
     /**

package/dist/index.d.ts

@@ -2191,6 +2191,14 @@ interface RelayDepositProps extends RelayWalletProps {
     /** Controlled recipient; when provided the recipient input is hidden and no wallet
      * connection is required to fetch a deposit address. Defaults to `walletAddress`. */
     recipient?: string;
+    /** Require a valid connected wallet before the deposit flow can issue an
+     * address, quote an amount, or start live order/recovery reads. When enabled,
+     * the recipient is pinned to `walletAddress`; a controlled `recipient` cannot
+     * redirect the connected user's deposit. Defaults to `true` when
+     * `showRecipientInput` is explicitly `false`, otherwise `false` for the
+     * low-level public-address integration. `CrossRelayDeposit` always enables
+     * this guard. */
+    requireWalletConnection?: boolean;
     /** Hide the editable recipient input even when `recipient` is NOT controlled
      * (default `true` = original behavior). Hosts that lock the recipient to the
      * connected wallet set this `false` so a disconnected user sees a connect
@@ -2232,10 +2240,9 @@ interface RelayDepositProps extends RelayWalletProps {
     onDeposited?: (txHash: string) => void;
     onError?: (error: Error) => void;
     /** Called by the `Connect Wallet` CTA under the locked card that stands in for the QR
-     * while there is neither a connected wallet nor a usable recipient (host-supplied or
-     * typed). Omitted — the locked card renders as text only, with no button. The rest of
-     * the screen stays usable either way: typing a valid recipient is a supported,
-     * wallet-free path to a deposit address. */
+     * while the required connected wallet (or, in low-level public-address mode,
+     * a usable recipient) is absent. Omitted — the locked card renders as text
+     * only, with no button. */
     onRequestConnect?: () => void;
     /** @deprecated The Deposit footer entry was removed. Retained as a no-op
      * compatibility prop so existing hosts do not need an immediate migration. */
@@ -2282,9 +2289,10 @@ interface RelayRecoveryProps extends RelayWalletProps {
      */
     environment?: Environment;
     /**
-     * Whose forwarder to check/recover. Defaults to `walletAddress`; when
-     * neither resolves to a valid address the modal renders a short connect note
-     * and makes ZERO requests (no catalog, no recovery lookup).
+     * Optional assertion of whose forwarder to check/recover. Recovery is always
+     * pinned to the valid connected `walletAddress`; when this value is supplied
+     * it must match that wallet. A missing/invalid wallet or mismatch renders a
+     * short note and makes ZERO requests (no catalog, no recovery lookup).
      */
     recipient?: string;
     /**