@rhinestone/deposit-modal 0.12.2 → 0.14.0

package/dist/{chunk-2TPSF77V.mjs → chunk-CFKC77SV.mjs}

@@ -1,8 +1,13 @@
+import {
+  RecoveryError,
+  submitSignedRecovery
+} from "./chunk-ZEO6ADM3.mjs";
 import {
   ListRow
-} from "./chunk-JE4R5VA3.mjs";
+} from "./chunk-WUJIKCFU.mjs";
 import {
   AlertTriangleIcon,
+  AnalyticsSession,
   BodyHeader,
   Button,
   Callout,
@@ -21,30 +26,26 @@ import {
   applyTheme,
   checkBackendUrl,
   createDepositService,
-  debugError,
-  debugLog,
   formatTokenAmount,
   formatUserError,
+  useClaimAnalyticsEmitter,
   useExplorerTxUrl,
   useLatestRef,
   useStableRpcUrls
-} from "./chunk-FXXUIK4E.mjs";
-import {
-  SERVICE_HEADERS
-} from "./chunk-IAGFDSNC.mjs";
+} from "./chunk-IN77XSWO.mjs";
 import {
   getChainIcon,
   getChainName,
   getTokenDecimalsByAddress,
   getTokenSymbol,
   tokenIconUrl
-} from "./chunk-3STTWRAN.mjs";
+} from "./chunk-VUATPOWJ.mjs";
 
 // src/ClaimModal.tsx
 import {
   useCallback,
   useEffect,
-  useMemo,
+  useMemo as useMemo2,
   useReducer,
   useRef,
   useState
@@ -76,144 +77,193 @@ var Input = forwardRef(
 );
 Input.displayName = "Input";
 
-// src/core/recovery.ts
-var RECOVER_DOMAIN = {
-  name: "Rhinestone Deposit Recovery",
-  version: "1"
-};
-var RECOVER_TYPES = {
-  RecoverDeposit: [
-    { name: "depositId", type: "uint256" },
-    { name: "destination", type: "address" }
-  ]
-};
-var RecoveryError = class extends Error {
-  constructor(message, status, code, retryable = false) {
-    super(message);
-    this.name = "RecoveryError";
-    this.status = status;
-    this.code = code;
-    this.retryable = retryable;
-  }
-};
-function formatRecoveryError(status, code, serverMessage) {
-  switch (code) {
+// src/core/claim-analytics.tsx
+import {
+  createContext,
+  useContext,
+  useMemo
+} from "react";
+import { jsx as jsx2 } from "react/jsx-runtime";
+function claimFailureReasonForError(error) {
+  if (!(error instanceof RecoveryError)) return "refund_failed";
+  switch (error.code) {
+    case "SIGNATURE_INVALID":
+      return "signature_invalid";
     case "DEPOSIT_NOT_RECOVERABLE":
-      return {
-        message: "This deposit can't be recovered \u2014 it may already have been claimed.",
-        retryable: false
-      };
+      return "recovery_deposit_not_recoverable";
     case "RECOVERY_UNSUPPORTED":
-      return {
-        message: "This deposit can't be recovered automatically. Contact support to get your funds back.",
-        retryable: false
-      };
-    case "SIGNATURE_INVALID":
-      return {
-        message: "That signature wasn't accepted for this wallet. Contact support to recover this deposit.",
-        retryable: false
-      };
+      return "recovery_unsupported";
     case "VERIFICATION_UNAVAILABLE":
-      return {
-        message: "Couldn't verify your signature just now. Try again shortly.",
-        retryable: true
-      };
+      return "signature_verification_unavailable";
     case "REFUND_RECONCILIATION_REQUIRED":
-      return {
-        message: "Your recovery is being reviewed. Contact support with this deposit if it doesn't arrive.",
-        retryable: false
-      };
+      return "refund_reconciliation_required";
     case "REFUND_FAILED":
-      return {
-        message: serverMessage ?? "The recovery couldn't be completed. Please try again or contact support.",
-        retryable: true
-      };
+      return "refund_failed";
     default:
-      if (status === 0) {
-        return {
-          message: "Couldn't reach the recovery service. Check your connection and try again.",
-          retryable: true
-        };
-      }
-      return {
-        message: serverMessage ?? "The recovery couldn't be completed. Please try again or contact support.",
-        retryable: true
-      };
+      if (error.phase === "signature") return "signature_rejected";
+      if (error.phase === "request") return "refund_service_unreachable";
+      return "refund_failed";
   }
 }
-async function submitSignedRecovery(params) {
-  const { backendUrl, depositId, signer, destination, signRecovery, debug } = params;
-  const scope = "service:recovery";
-  const typedData = {
-    domain: RECOVER_DOMAIN,
-    types: RECOVER_TYPES,
-    primaryType: "RecoverDeposit",
-    message: { depositId: BigInt(depositId), destination }
+function createClaimAnalyticsController(emit) {
+  let step = null;
+  let afterHandoff = false;
+  let opened = false;
+  let closed = false;
+  const dedupe = /* @__PURE__ */ new Set();
+  const send = (payload) => {
+    controller.openSession();
+    emit(payload);
   };
-  let signature;
-  try {
-    signature = await signRecovery({ typedData, signer, depositId, destination });
-  } catch (error) {
-    debugError(debug, scope, "signRecovery:failed", error);
-    throw new RecoveryError(
-      "Signature request was declined. Approve it in your wallet to recover this deposit.",
-      0,
-      void 0,
-      true
-    );
-  }
-  if (!signature) {
-    throw new RecoveryError(
-      "Signature request was declined. Approve it in your wallet to recover this deposit.",
-      0,
-      void 0,
-      true
-    );
-  }
-  const url = `${backendUrl.replace(/\/$/, "")}/deposits/recover`;
-  debugLog(debug, scope, "submitSignedRecovery:request", {
-    url,
-    depositId,
-    signer
-  });
-  let response;
-  try {
-    response = await fetch(url, {
-      method: "POST",
-      // The shared const, so recovery carries `x-deposit-modal-version` like
-      // every other backend call. Without it this path would be invisible in the
-      // per-client version telemetry the processor records.
-      headers: SERVICE_HEADERS,
-      // `depositId` as a string: it is a uint256 upstream and JSON numbers lose
-      // precision well before that range.
-      body: JSON.stringify({ depositId, destination, signature })
-    });
-  } catch (error) {
-    debugError(debug, scope, "submitSignedRecovery:network", error);
-    const { message, retryable } = formatRecoveryError(0);
-    throw new RecoveryError(message, 0, void 0, retryable);
-  }
-  if (!response.ok) {
-    const body = await response.json().catch(() => ({}));
-    debugError(debug, scope, "submitSignedRecovery:failed", body, {
-      status: response.status
-    });
-    const { message, retryable } = formatRecoveryError(
-      response.status,
-      body.code,
-      body.error
-    );
-    throw new RecoveryError(message, response.status, body.code, retryable);
-  }
-  const result = await response.json();
-  debugLog(debug, scope, "submitSignedRecovery:success", {
-    transactionHash: result.transactionHash
-  });
-  return result;
+  const emitOnce = (key, payload) => {
+    if (dedupe.has(key)) return;
+    dedupe.add(key);
+    send(payload);
+  };
+  const rearmStep = (rearmed) => {
+    for (const key of [...dedupe]) {
+      if (key.includes(`:${rearmed}:`)) dedupe.delete(key);
+    }
+  };
+  const controller = {
+    openSession() {
+      if (opened) return;
+      opened = true;
+      emit({ type: "claim_modal_open" });
+    },
+    openStep(nextStep) {
+      controller.openSession();
+      if (step === nextStep) return;
+      step = nextStep;
+      emitOnce(`step-open:${nextStep}`, {
+        type: "claim_modal_step_open",
+        step: nextStep
+      });
+    },
+    completeStep(completedStep = step ?? void 0) {
+      if (!completedStep) return;
+      emitOnce(`step-complete:${completedStep}`, {
+        type: "claim_modal_step_complete",
+        step: completedStep
+      });
+    },
+    rearmStep(rearmed) {
+      rearmStep(rearmed);
+    },
+    // One per submitted search, never deduplicated: the searched hash is
+    // deliberately not in the stream, so collapsing two searches that returned
+    // the same counts would make the second one unrecoverable.
+    lookupResult(matches, eligible) {
+      send({
+        type: "claim_modal_lookup_result",
+        matches,
+        eligible
+      });
+    },
+    selectDeposit({ depositId, transactionHash, autoSelected }) {
+      emitOnce(`deposit-selected:${depositId}`, {
+        type: "claim_modal_deposit_selected",
+        deposit_id: depositId,
+        transaction_hash: transactionHash,
+        auto_selected: autoSelected
+      });
+    },
+    friction(reason, eventStep = step ?? void 0) {
+      if (!eventStep) return;
+      emitOnce(`friction:${eventStep}:${reason}`, {
+        type: "claim_modal_friction",
+        step: eventStep,
+        reason
+      });
+    },
+    failure(reason, retryable, eventStep = step ?? void 0) {
+      if (!eventStep) return;
+      emitOnce(`failure:${eventStep}:${reason}`, {
+        type: "claim_modal_failure",
+        step: eventStep,
+        reason,
+        retryable
+      });
+    },
+    retry(reason, eventStep = step ?? void 0) {
+      if (!eventStep) return;
+      send({ type: "claim_modal_retry", step: eventStep, reason });
+      rearmStep(eventStep);
+    },
+    handoff({ depositId, transactionHash, refundTransactionHash }, eventStep) {
+      const handoffStep = eventStep ?? step ?? "submit";
+      if (step !== handoffStep) controller.openStep(handoffStep);
+      afterHandoff = true;
+      emitOnce(`handoff:${refundTransactionHash}`, {
+        type: "claim_modal_handoff",
+        step: handoffStep,
+        deposit_id: depositId,
+        transaction_hash: transactionHash,
+        refund_transaction_hash: refundTransactionHash
+      });
+    },
+    // Keyed by step so a retry re-arms it: a second failed submit is a second
+    // terminal outcome, not a duplicate of the first.
+    outcome(outcome) {
+      if (!step) return;
+      emitOnce(`outcome:${step}:${outcome}`, {
+        type: "claim_modal_ui_outcome",
+        step,
+        outcome
+      });
+    },
+    abandon(reason) {
+      if (!step || afterHandoff) return;
+      emitOnce(`abandon:${step}:${reason}`, {
+        type: "claim_modal_abandoned",
+        step,
+        reason
+      });
+    },
+    close(source) {
+      if (closed) return;
+      closed = true;
+      send({
+        type: "claim_modal_close",
+        source,
+        step,
+        after_handoff: afterHandoff
+      });
+    },
+    /** "Claim another deposit" on the success screen: a fresh attempt in the
+     *  same session, so the envelope and its session id stay. */
+    resetAttempt() {
+      step = null;
+      afterHandoff = false;
+      dedupe.clear();
+    },
+    get step() {
+      return step;
+    },
+    get afterHandoff() {
+      return afterHandoff;
+    }
+  };
+  return controller;
+}
+var ClaimAnalyticsControllerContext = createContext(null);
+var noopController = createClaimAnalyticsController(() => {
+});
+function ClaimAnalyticsControllerProvider({
+  children,
+  controllerRef
+}) {
+  const emit = useClaimAnalyticsEmitter();
+  const controller = useMemo(() => createClaimAnalyticsController(emit), [emit]);
+  if (controllerRef) controllerRef.current = controller;
+  return /* @__PURE__ */ jsx2(ClaimAnalyticsControllerContext.Provider, { value: controller, children });
+}
+function useClaimAnalyticsController() {
+  return useContext(ClaimAnalyticsControllerContext) ?? noopController;
 }
 
 // src/ClaimModal.tsx
-import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+import { Fragment, jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 function evmChainIdFromCaip2(chain) {
   if (!chain?.startsWith("eip155:")) return null;
   const id = Number.parseInt(chain.slice("eip155:".length), 10);
@@ -306,6 +356,27 @@ function claimReducer(state, action) {
       return state;
   }
 }
+function buildClaimAnalyticsSessionProperties({
+  inline = false,
+  closeOnOverlayClick = false,
+  defaultTxHash,
+  defaultRefundDestination
+}) {
+  return {
+    presentation: inline ? "inline" : "overlay",
+    overlay_close_enabled: !inline && closeOnOverlayClick,
+    prefills: {
+      transaction_hash: defaultTxHash !== void 0,
+      refund_destination: defaultRefundDestination !== void 0
+    }
+  };
+}
+function analyticsStepForClaimStep(step) {
+  if (step === "lookup") return "lookup";
+  if (step === "select") return "select";
+  if (step === "review") return "review";
+  return "submit";
+}
 function ClaimModal({
   signRecovery,
   isOpen,
@@ -323,16 +394,21 @@ function ClaimModal({
   onLifecycle,
   onEvent,
   onError,
-  debug
+  enableAnalyticsIngest,
+  analyticsIngestUrl,
+  debug,
+  onUiState
 }) {
   checkBackendUrl("ClaimModal", backendUrl);
   const modalRef = useRef(null);
   const onReadyRef = useLatestRef(onReady);
   const onLifecycleRef = useLatestRef(onLifecycle);
-  const onEventRef = useLatestRef(onEvent);
   const onErrorRef = useLatestRef(onError);
+  const analyticsControllerRef = useRef(null);
+  const lastSubmitFailureRef = useRef(null);
+  const previousOpenRef = useRef(isOpen);
   const rpcUrls = useStableRpcUrls(rpcUrlsProp);
-  const service = useMemo(
+  const service = useMemo2(
     () => createDepositService(backendUrl, { debug, debugScope: "service:claim" }),
     [backendUrl, debug]
   );
@@ -341,80 +417,144 @@ function ClaimModal({
   const isOpenRef = useRef(isOpen);
   isOpenRef.current = isOpen;
   useEffect(() => {
-    if (isOpen && modalRef.current) applyTheme(modalRef.current, theme);
+    if (!isOpen || !modalRef.current) return;
+    return applyTheme(modalRef.current, theme);
   }, [isOpen, theme]);
   useEffect(() => {
     if (isOpen) {
       onReadyRef.current?.();
-      onEventRef.current?.({ type: "claim_modal_open" });
     }
-  }, [isOpen, onReadyRef, onEventRef]);
+  }, [isOpen, onReadyRef]);
+  useEffect(() => {
+    if (previousOpenRef.current && !isOpen) {
+      const analytics = analyticsControllerRef.current;
+      analytics?.abandon("modal_close");
+      analytics?.close("host_controlled");
+    }
+    previousOpenRef.current = isOpen;
+  }, [isOpen]);
   useEffect(() => {
     if (!isOpen) {
       operationEpochRef.current += 1;
       dispatch({ type: "reset" });
     }
   }, [isOpen]);
-  const handleClose = useCallback(() => {
-    if (state.step !== "processing") {
+  const closeWithSource = useCallback(
+    (source) => {
+      const analytics = analyticsControllerRef.current;
+      if (state.step === "processing") {
+        analytics?.friction("modal_close_refused_in_flight", "submit");
+        return;
+      }
+      analytics?.abandon("modal_close");
+      analytics?.close(source);
       operationEpochRef.current += 1;
       onClose();
+    },
+    [state.step, onClose]
+  );
+  const handleModalDismiss = useCallback(
+    (reason) => {
+      closeWithSource(
+        reason === "escape" ? "escape" : reason === "overlay" ? "overlay" : "header_button"
+      );
+    },
+    [closeWithSource]
+  );
+  const goBack = useCallback(() => {
+    const analytics = analyticsControllerRef.current;
+    const previousFailure = lastSubmitFailureRef.current;
+    if (state.step === "failed" && previousFailure?.retryable) {
+      lastSubmitFailureRef.current = null;
+      analytics?.retry(previousFailure.reason, "submit");
+    } else {
+      if (state.step === "failed") {
+        lastSubmitFailureRef.current = null;
+        analytics?.rearmStep("submit");
+      }
+      analytics?.abandon("back");
     }
-  }, [state.step, onClose]);
+    dispatch({ type: "back" });
+  }, [state.step]);
   const canGoBack = state.step === "select" || state.step === "review" || state.step === "failed";
+  const onUiStateRef = useLatestRef(onUiState);
+  useEffect(() => {
+    onUiStateRef.current?.({
+      screen: state.step,
+      back: canGoBack ? goBack : void 0,
+      submitting: state.step === "processing"
+    });
+  }, [state.step, canGoBack, goBack, onUiStateRef]);
   const showBackButton = uiConfig?.showBackButton ?? true;
-  return /* @__PURE__ */ jsx2(RpcUrlsProvider, { value: rpcUrls, children: /* @__PURE__ */ jsx2(ChainCatalogProvider, { service, rpcUrls, children: /* @__PURE__ */ jsx2(
+  return /* @__PURE__ */ jsx3(RpcUrlsProvider, { value: rpcUrls, children: /* @__PURE__ */ jsx3(ChainCatalogProvider, { service, rpcUrls, children: /* @__PURE__ */ jsx3(
     Modal,
     {
       isOpen,
-      onClose: handleClose,
+      onClose: handleModalDismiss,
       className,
       inline,
       closeOnOverlayClick,
-      children: /* @__PURE__ */ jsxs2("div", { ref: modalRef, className: "rs-modal", children: [
-        /* @__PURE__ */ jsxs2("div", { className: "rs-modal-header--redesigned", children: [
-          /* @__PURE__ */ jsx2("div", { className: "rs-modal-header-nav-left", children: showBackButton && canGoBack && /* @__PURE__ */ jsx2(
-            "button",
-            {
-              type: "button",
-              className: "rs-modal-header-back",
-              "aria-label": "Go back",
-              onClick: () => dispatch({ type: "back" }),
-              children: /* @__PURE__ */ jsx2(ChevronLeftIcon, {})
-            }
-          ) }),
-          /* @__PURE__ */ jsx2("div", { className: "rs-modal-header-nav-right", children: /* @__PURE__ */ jsx2(
-            "button",
-            {
-              type: "button",
-              onClick: handleClose,
-              disabled: state.step === "processing",
-              className: "rs-modal-close",
-              "aria-label": "Close",
-              children: /* @__PURE__ */ jsx2(CloseIcon, {})
-            }
-          ) })
-        ] }),
-        /* @__PURE__ */ jsx2("div", { className: "rs-modal-body", children: /* @__PURE__ */ jsx2(
-          ClaimBody,
-          {
-            state,
-            dispatch,
-            service,
-            signRecovery,
-            backendUrl,
-            debug,
+      children: /* @__PURE__ */ jsx3(
+        AnalyticsSession,
+        {
+          modal: "claim",
+          sessionProperties: buildClaimAnalyticsSessionProperties({
+            inline,
+            closeOnOverlayClick,
             defaultTxHash,
-            defaultRefundDestination,
-            onClose: handleClose,
-            operationEpochRef,
-            isOpenRef,
-            onLifecycleRef,
-            onEventRef,
-            onErrorRef
-          }
-        ) })
-      ] })
+            defaultRefundDestination
+          }),
+          onEvent,
+          backendUrl,
+          enableIngest: enableAnalyticsIngest,
+          ingestUrl: analyticsIngestUrl,
+          children: /* @__PURE__ */ jsx3(ClaimAnalyticsControllerProvider, { controllerRef: analyticsControllerRef, children: /* @__PURE__ */ jsxs2("div", { ref: modalRef, className: "rs-modal", children: [
+            /* @__PURE__ */ jsxs2("div", { className: "rs-modal-header--redesigned", children: [
+              /* @__PURE__ */ jsx3("div", { className: "rs-modal-header-nav-left", children: showBackButton && canGoBack && /* @__PURE__ */ jsx3(
+                "button",
+                {
+                  type: "button",
+                  className: "rs-modal-header-back",
+                  "aria-label": "Go back",
+                  onClick: goBack,
+                  children: /* @__PURE__ */ jsx3(ChevronLeftIcon, {})
+                }
+              ) }),
+              /* @__PURE__ */ jsx3("div", { className: "rs-modal-header-nav-right", children: /* @__PURE__ */ jsx3(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => closeWithSource("header_button"),
+                  disabled: state.step === "processing",
+                  className: "rs-modal-close",
+                  "aria-label": "Close",
+                  children: /* @__PURE__ */ jsx3(CloseIcon, {})
+                }
+              ) })
+            ] }),
+            /* @__PURE__ */ jsx3("div", { className: "rs-modal-body", children: /* @__PURE__ */ jsx3(
+              ClaimBody,
+              {
+                state,
+                dispatch,
+                service,
+                signRecovery,
+                backendUrl,
+                debug,
+                defaultTxHash,
+                defaultRefundDestination,
+                onClose: closeWithSource,
+                onBack: goBack,
+                operationEpochRef,
+                isOpenRef,
+                lastSubmitFailureRef,
+                onLifecycleRef,
+                onErrorRef
+              }
+            ) })
+          ] }) })
+        }
+      )
     }
   ) }) });
 }
@@ -428,15 +568,21 @@ function ClaimBody({
   defaultTxHash,
   defaultRefundDestination,
   onClose,
+  onBack,
   operationEpochRef,
   isOpenRef,
+  lastSubmitFailureRef,
   onLifecycleRef,
-  onEventRef,
   onErrorRef
 }) {
+  const analytics = useClaimAnalyticsController();
+  useEffect(() => {
+    analytics.openSession();
+    analytics.openStep(analyticsStepForClaimStep(state.step));
+  }, [analytics, state.step]);
   switch (state.step) {
     case "lookup":
-      return /* @__PURE__ */ jsx2(
+      return /* @__PURE__ */ jsx3(
         LookupStep,
         {
           service,
@@ -446,24 +592,29 @@ function ClaimBody({
           onResults: (deposits) => {
             const eligible = deposits.filter(isEligible);
             const autoSelect = deposits.length === 1 && eligible.length === 1 ? deposits[0] : null;
+            analytics.completeStep("lookup");
+            if (autoSelect) reportSelection(autoSelect, true);
             dispatch({ type: "lookup/results", deposits, autoSelect });
           },
           onLifecycleRef,
-          onEventRef,
           onErrorRef
         }
       );
     case "select":
-      return /* @__PURE__ */ jsx2(
+      return /* @__PURE__ */ jsx3(
         SelectStep,
         {
           deposits: state.deposits,
-          onSelect: (deposit) => dispatch({ type: "select", deposit })
+          onSelect: (deposit) => {
+            analytics.completeStep("select");
+            reportSelection(deposit, false);
+            dispatch({ type: "select", deposit });
+          }
         }
       );
     case "review":
     case "processing":
-      return /* @__PURE__ */ jsx2(
+      return /* @__PURE__ */ jsx3(
         ReviewStep,
         {
           deposit: state.selected,
@@ -473,27 +624,51 @@ function ClaimBody({
         }
       );
     case "complete":
-      return /* @__PURE__ */ jsx2(ResultStep, { result: state.result, onClose, onReset: () => dispatch({ type: "reset" }) });
+      return /* @__PURE__ */ jsx3(
+        ResultStep,
+        {
+          result: state.result,
+          onClose: () => onClose("success_done"),
+          onReset: () => {
+            analytics.resetAttempt();
+            dispatch({ type: "reset" });
+          }
+        }
+      );
     case "failed":
-      return /* @__PURE__ */ jsx2(
+      return /* @__PURE__ */ jsx3(
         ResultStep,
         {
           error: state.error,
-          onClose,
-          onRetry: state.retryable ? () => dispatch({ type: "back" }) : void 0
+          onClose: () => onClose("failure_cancel"),
+          onRetry: state.retryable ? onBack : void 0
         }
       );
     default:
       return null;
   }
+  function reportSelection(deposit, autoSelected) {
+    if (!deposit.id) return;
+    analytics.selectDeposit({
+      depositId: deposit.id,
+      transactionHash: deposit.txHash ?? null,
+      autoSelected
+    });
+  }
   async function submitRecoveryRequest(destination) {
     const deposit = state.selected;
     if (!deposit) return;
     const sourceChainId = evmChainIdFromCaip2(deposit.chain);
     if (sourceChainId == null || !deposit.id || !deposit.recipient || !deposit.depositAddress || !deposit.token || !deposit.chain) {
+      analytics.failure("recovery_deposit_data_incomplete", false, "review");
+      analytics.outcome("failed");
       dispatch({
         type: "failed",
-        error: "Deposit is missing data required to recover it."
+        error: "Deposit is missing data required to recover it.",
+        // The missing fields come off the backend row already in memory, so a
+        // retry re-reads nothing and fails identically. Offering one would be a
+        // dead end, and would also contradict the `retryable` reported above.
+        retryable: false
       });
       return;
     }
@@ -502,11 +677,9 @@ function ClaimBody({
     const token = deposit.token;
     const operationEpoch = operationEpochRef.current;
     const isCurrentOperation = () => isOpenRef.current && operationEpochRef.current === operationEpoch;
+    analytics.completeStep("review");
+    analytics.openStep("submit");
     dispatch({ type: "submit" });
-    onEventRef.current?.({
-      type: "claim_modal_refund_click",
-      chain: `eip155:${sourceChainId}`
-    });
     onLifecycleRef.current?.({
       type: "refund_requested",
       account,
@@ -516,6 +689,7 @@ function ClaimBody({
     try {
       const result = await submitSignedRecovery({
         backendUrl,
+        chainId: sourceChainId,
         depositId: deposit.id,
         signer,
         destination,
@@ -539,10 +713,16 @@ function ClaimBody({
         destination: paidTo,
         chain: sourceChainId
       });
-      onEventRef.current?.({
-        type: "claim_modal_complete",
-        chain: `eip155:${sourceChainId}`
-      });
+      analytics.handoff(
+        {
+          depositId: deposit.id,
+          transactionHash: deposit.txHash ?? null,
+          refundTransactionHash: result.transactionHash
+        },
+        "submit"
+      );
+      analytics.completeStep("submit");
+      analytics.outcome("completed");
       onLifecycleRef.current?.({
         type: "complete",
         txHash: result.transactionHash,
@@ -559,16 +739,16 @@ function ClaimBody({
       const message = recoveryError?.message ?? formatUserError(
         err instanceof Error ? err.message : "Recovery failed"
       );
+      const retryable = recoveryError?.retryable ?? true;
       dispatch({
         type: "failed",
         error: message,
-        retryable: recoveryError?.retryable ?? true
-      });
-      onEventRef.current?.({
-        type: "claim_modal_failed",
-        chain: `eip155:${sourceChainId}`,
-        status
+        retryable
       });
+      const reason = claimFailureReasonForError(err);
+      lastSubmitFailureRef.current = { reason, retryable };
+      analytics.failure(reason, retryable, "submit");
+      analytics.outcome("failed");
       onLifecycleRef.current?.({ type: "failed", status, error: message });
       onErrorRef.current?.({ message, code: "CLAIM_FAILED" });
     }
@@ -581,19 +761,25 @@ function LookupStep({
   isOpenRef,
   onResults,
   onLifecycleRef,
-  onEventRef,
   onErrorRef
 }) {
+  const analytics = useClaimAnalyticsController();
   const [txHash, setTxHash] = useState(defaultTxHash ?? "");
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState(null);
   const trimmed = txHash.trim();
   const validTxHash = /^0x[a-fA-F0-9]{64}$/.test(trimmed);
+  useEffect(() => {
+    if (trimmed.length > 0 && !validTxHash) {
+      analytics.friction("lookup_transaction_hash_invalid", "lookup");
+    }
+  }, [analytics, trimmed, validTxHash]);
   const handleLookup = useCallback(async () => {
     const operationEpoch = operationEpochRef.current;
     const isCurrentOperation = () => isOpenRef.current && operationEpochRef.current === operationEpoch;
     setError(null);
     setLoading(true);
+    analytics.rearmStep("lookup");
     try {
       const deposits = await service.lookupRecoverableDeposits({
         txHash: trimmed
@@ -604,15 +790,15 @@ function LookupStep({
         txHash: trimmed,
         matches: deposits.length
       });
-      onEventRef.current?.({
-        type: "claim_modal_lookup",
-        matches: deposits.length
-      });
+      const eligible = deposits.filter(isEligible);
+      analytics.lookupResult(deposits.length, eligible.length);
       if (deposits.length === 0) {
+        analytics.friction("lookup_no_deposits_found", "lookup");
         setError("No deposits found for this transaction.");
         return;
       }
-      if (!deposits.some(isEligible)) {
+      if (eligible.length === 0) {
+        analytics.friction("lookup_no_eligible_deposits", "lookup");
         setError(
           "This transaction has no failed or rejected deposits available to recover."
         );
@@ -624,32 +810,33 @@ function LookupStep({
       const message = formatUserError(
         err instanceof Error ? err.message : "Lookup failed"
       );
+      analytics.failure("lookup_failed", true, "lookup");
       setError(message);
       onErrorRef.current?.({ message, code: "CLAIM_LOOKUP_FAILED" });
     } finally {
       if (isCurrentOperation()) setLoading(false);
     }
   }, [
+    analytics,
     trimmed,
     service,
     operationEpochRef,
     isOpenRef,
     onResults,
     onLifecycleRef,
-    onEventRef,
     onErrorRef
   ]);
   return /* @__PURE__ */ jsxs2("div", { className: "rs-screen", children: [
     /* @__PURE__ */ jsxs2("div", { className: "rs-screen-body rs-screen-body--gap-32", children: [
-      /* @__PURE__ */ jsx2(
+      /* @__PURE__ */ jsx3(
         BodyHeader,
         {
-          icon: /* @__PURE__ */ jsx2(HandCoinsIcon, {}),
+          icon: /* @__PURE__ */ jsx3(HandCoinsIcon, {}),
           title: "Claim a deposit",
           subtitle: "Get funds from a failed deposit sent back to you on the source chain."
         }
       ),
-      /* @__PURE__ */ jsx2(
+      /* @__PURE__ */ jsx3(
         Input,
         {
           label: "Transaction hash",
@@ -659,8 +846,8 @@ function LookupStep({
           error: trimmed.length > 0 && !validTxHash ? "Enter a valid transaction hash" : void 0
         }
       ),
-      error && /* @__PURE__ */ jsx2(Callout, { variant: "error", children: error }),
-      /* @__PURE__ */ jsx2(
+      error && /* @__PURE__ */ jsx3(Callout, { variant: "error", children: error }),
+      /* @__PURE__ */ jsx3(
         Button,
         {
           onClick: handleLookup,
@@ -672,7 +859,7 @@ function LookupStep({
         }
       )
     ] }),
-    /* @__PURE__ */ jsx2(PoweredBy, {})
+    /* @__PURE__ */ jsx3(PoweredBy, {})
   ] });
 }
 function SelectStep({
@@ -681,18 +868,18 @@ function SelectStep({
 }) {
   return /* @__PURE__ */ jsxs2("div", { className: "rs-screen", children: [
     /* @__PURE__ */ jsxs2("div", { className: "rs-screen-body rs-screen-body--gap-32", children: [
-      /* @__PURE__ */ jsx2(
+      /* @__PURE__ */ jsx3(
         BodyHeader,
         {
-          icon: /* @__PURE__ */ jsx2(CoinsIcon, {}),
+          icon: /* @__PURE__ */ jsx3(CoinsIcon, {}),
           title: "Select a deposit",
           subtitle: "This transaction produced multiple deposits. Choose the one to claim."
         }
       ),
-      /* @__PURE__ */ jsx2("div", { className: "rs-list", children: deposits.map((row) => {
+      /* @__PURE__ */ jsx3("div", { className: "rs-list", children: deposits.map((row) => {
         const { symbol, amount, chainName } = describeDeposit(row);
         const eligible = isEligible(row);
-        return /* @__PURE__ */ jsx2(
+        return /* @__PURE__ */ jsx3(
           ListRow,
           {
             leadingMedia: tokenIconUrl(symbol),
@@ -706,7 +893,7 @@ function SelectStep({
         );
       }) })
     ] }),
-    /* @__PURE__ */ jsx2(PoweredBy, {})
+    /* @__PURE__ */ jsx3(PoweredBy, {})
   ] });
 }
 function ReviewStep({
@@ -715,41 +902,47 @@ function ReviewStep({
   defaultRefundDestination,
   onSubmit
 }) {
+  const analytics = useClaimAnalyticsController();
   const { chainId, symbol, amount, chainName, chainIcon } = describeDeposit(deposit);
   const explorerTxUrl = useExplorerTxUrl();
   const [destination, setDestination] = useState(defaultRefundDestination ?? "");
   const destinationValid = isAddress(destination);
+  useEffect(() => {
+    if (destination.length > 0 && !destinationValid) {
+      analytics.friction("refund_destination_invalid", "review");
+    }
+  }, [analytics, destination, destinationValid]);
   return /* @__PURE__ */ jsxs2("div", { className: "rs-screen", children: [
     /* @__PURE__ */ jsxs2("div", { className: "rs-screen-body rs-screen-body--gap-32", children: [
-      /* @__PURE__ */ jsx2(
+      /* @__PURE__ */ jsx3(
         BodyHeader,
         {
-          icon: /* @__PURE__ */ jsx2(HandCoinsIcon, {}),
+          icon: /* @__PURE__ */ jsx3(HandCoinsIcon, {}),
           title: "Review refund",
           subtitle: "This returns the funds on the source chain. It does not retry the original bridge."
         }
       ),
       /* @__PURE__ */ jsxs2("div", { className: "rs-review-details", children: [
         /* @__PURE__ */ jsxs2("div", { className: "rs-review-detail-row", children: [
-          /* @__PURE__ */ jsx2("span", { children: "Amount" }),
+          /* @__PURE__ */ jsx3("span", { children: "Amount" }),
           /* @__PURE__ */ jsxs2("span", { className: "rs-review-detail-value", children: [
             /* @__PURE__ */ jsxs2("span", { children: [
               amount,
               " ",
               symbol
             ] }),
-            /* @__PURE__ */ jsx2("span", { className: "rs-review-detail-icon", children: /* @__PURE__ */ jsx2(TokenIcon, { symbol }) })
+            /* @__PURE__ */ jsx3("span", { className: "rs-review-detail-icon", children: /* @__PURE__ */ jsx3(TokenIcon, { symbol }) })
           ] })
         ] }),
         /* @__PURE__ */ jsxs2("div", { className: "rs-review-detail-row", children: [
-          /* @__PURE__ */ jsx2("span", { children: "Source chain" }),
+          /* @__PURE__ */ jsx3("span", { children: "Source chain" }),
           /* @__PURE__ */ jsxs2("span", { className: "rs-review-detail-value", children: [
-            /* @__PURE__ */ jsx2("span", { children: chainName }),
-            chainIcon && /* @__PURE__ */ jsx2("span", { className: "rs-review-detail-icon", children: /* @__PURE__ */ jsx2(CdnIcon, { src: chainIcon }) })
+            /* @__PURE__ */ jsx3("span", { children: chainName }),
+            chainIcon && /* @__PURE__ */ jsx3("span", { className: "rs-review-detail-icon", children: /* @__PURE__ */ jsx3(CdnIcon, { src: chainIcon }) })
           ] })
         ] }),
         /* @__PURE__ */ jsxs2("div", { className: "rs-review-detail-row", children: [
-          /* @__PURE__ */ jsx2("span", { children: "Deposit transaction" }),
+          /* @__PURE__ */ jsx3("span", { children: "Deposit transaction" }),
           (() => {
             const url = deposit.txHash ? explorerTxUrl(chainId, deposit.txHash) : null;
             const short = deposit.txHash ? shortenHash(deposit.txHash) : "\u2014";
@@ -762,14 +955,14 @@ function ReviewStep({
                 rel: "noreferrer",
                 children: [
                   short,
-                  /* @__PURE__ */ jsx2(ExternalLinkIcon, {})
+                  /* @__PURE__ */ jsx3(ExternalLinkIcon, {})
                 ]
               }
-            ) : /* @__PURE__ */ jsx2("span", { className: "rs-review-detail-value", children: short });
+            ) : /* @__PURE__ */ jsx3("span", { className: "rs-review-detail-value", children: short });
           })()
         ] })
       ] }),
-      /* @__PURE__ */ jsx2(
+      /* @__PURE__ */ jsx3(
         Input,
         {
           label: "Send to",
@@ -779,7 +972,7 @@ function ReviewStep({
           error: destination.length > 0 && !destinationValid ? "Enter a valid address" : void 0
         }
       ),
-      /* @__PURE__ */ jsx2(
+      /* @__PURE__ */ jsx3(
         Button,
         {
           onClick: () => destinationValid && onSubmit(destination),
@@ -791,7 +984,7 @@ function ReviewStep({
         }
       )
     ] }),
-    /* @__PURE__ */ jsx2(PoweredBy, {})
+    /* @__PURE__ */ jsx3(PoweredBy, {})
   ] });
 }
 function ResultStep({
@@ -805,10 +998,10 @@ function ResultStep({
   const explorerTxUrl = useExplorerTxUrl();
   return /* @__PURE__ */ jsxs2("div", { className: "rs-screen", children: [
     /* @__PURE__ */ jsxs2("div", { className: "rs-screen-body rs-screen-body--gap-32", children: [
-      /* @__PURE__ */ jsx2(
+      /* @__PURE__ */ jsx3(
         BodyHeader,
         {
-          icon: success ? /* @__PURE__ */ jsx2(CheckIcon, {}) : /* @__PURE__ */ jsx2(AlertTriangleIcon, {}),
+          icon: success ? /* @__PURE__ */ jsx3(CheckIcon, {}) : /* @__PURE__ */ jsx3(AlertTriangleIcon, {}),
           variant: success ? "success" : "error",
           title: success ? "Refund submitted" : "Refund failed",
           subtitle: success ? "Your funds are being returned on the source chain." : void 0
@@ -816,22 +1009,22 @@ function ResultStep({
       ),
       success ? /* @__PURE__ */ jsxs2("div", { className: "rs-review-details", children: [
         /* @__PURE__ */ jsxs2("div", { className: "rs-review-detail-row", children: [
-          /* @__PURE__ */ jsx2("span", { children: "Amount" }),
+          /* @__PURE__ */ jsx3("span", { children: "Amount" }),
           /* @__PURE__ */ jsxs2("span", { className: "rs-review-detail-value", children: [
             /* @__PURE__ */ jsxs2("span", { children: [
               result.amountDisplay,
               " ",
               result.symbol
             ] }),
-            /* @__PURE__ */ jsx2("span", { className: "rs-review-detail-icon", children: /* @__PURE__ */ jsx2(TokenIcon, { symbol: result.symbol }) })
+            /* @__PURE__ */ jsx3("span", { className: "rs-review-detail-icon", children: /* @__PURE__ */ jsx3(TokenIcon, { symbol: result.symbol }) })
           ] })
         ] }),
         /* @__PURE__ */ jsxs2("div", { className: "rs-review-detail-row", children: [
-          /* @__PURE__ */ jsx2("span", { children: "Sent to" }),
-          /* @__PURE__ */ jsx2("span", { className: "rs-review-detail-value", children: shortenAddress(result.destination) })
+          /* @__PURE__ */ jsx3("span", { children: "Sent to" }),
+          /* @__PURE__ */ jsx3("span", { className: "rs-review-detail-value", children: shortenAddress(result.destination) })
         ] }),
         /* @__PURE__ */ jsxs2("div", { className: "rs-review-detail-row", children: [
-          /* @__PURE__ */ jsx2("span", { children: "Transaction" }),
+          /* @__PURE__ */ jsx3("span", { children: "Transaction" }),
           (() => {
             const url = explorerTxUrl(result.chain, result.txHash);
             const short = shortenHash(result.txHash);
@@ -844,25 +1037,26 @@ function ResultStep({
                 rel: "noreferrer",
                 children: [
                   short,
-                  /* @__PURE__ */ jsx2(ExternalLinkIcon, {})
+                  /* @__PURE__ */ jsx3(ExternalLinkIcon, {})
                 ]
               }
-            ) : /* @__PURE__ */ jsx2("span", { className: "rs-review-detail-value", children: short });
+            ) : /* @__PURE__ */ jsx3("span", { className: "rs-review-detail-value", children: short });
           })()
         ] })
-      ] }) : /* @__PURE__ */ jsx2(Callout, { variant: "error", children: error }),
-      /* @__PURE__ */ jsx2("div", { className: "rs-screen-button-row", children: success ? /* @__PURE__ */ jsxs2(Fragment, { children: [
-        onReset && /* @__PURE__ */ jsx2(Button, { variant: "outline", onClick: onReset, fullWidth: true, children: "Claim another deposit" }),
-        /* @__PURE__ */ jsx2(Button, { onClick: onClose, fullWidth: true, children: "Done" })
+      ] }) : /* @__PURE__ */ jsx3(Callout, { variant: "error", children: error }),
+      /* @__PURE__ */ jsx3("div", { className: "rs-screen-button-row", children: success ? /* @__PURE__ */ jsxs2(Fragment, { children: [
+        onReset && /* @__PURE__ */ jsx3(Button, { variant: "outline", onClick: onReset, fullWidth: true, children: "Claim another deposit" }),
+        /* @__PURE__ */ jsx3(Button, { onClick: onClose, fullWidth: true, children: "Done" })
       ] }) : /* @__PURE__ */ jsxs2(Fragment, { children: [
-        /* @__PURE__ */ jsx2(Button, { variant: "outline", onClick: onClose, fullWidth: true, children: "Cancel" }),
-        onRetry && /* @__PURE__ */ jsx2(Button, { onClick: onRetry, fullWidth: true, children: "Try again" })
+        /* @__PURE__ */ jsx3(Button, { variant: "outline", onClick: onClose, fullWidth: true, children: "Cancel" }),
+        onRetry && /* @__PURE__ */ jsx3(Button, { onClick: onRetry, fullWidth: true, children: "Try again" })
       ] }) })
     ] }),
-    /* @__PURE__ */ jsx2(PoweredBy, {})
+    /* @__PURE__ */ jsx3(PoweredBy, {})
   ] });
 }
 
 export {
+  buildClaimAnalyticsSessionProperties,
   ClaimModal
 };