do not merge: code example to skip user facing error

src/shared/errors.ts

@@ -1,3 +1,14 @@
+/**
+ * Thrown when an error is caused by user input rather than a system failure.
+ * These are intentionally excluded from Sentry to avoid noise.
+ */
+export class UserFacingError extends Error {
+  constructor(message: string) {
+    super(message)
+    this.name = 'UserFacingError'
+  }
+}
+
 export function isErrorWithMessage(error: unknown): error is Error {
   return error !== undefined && error !== null && typeof error === 'object' && 'message' in error
 }

src/shared/thirdweb/emailAuth.ts

@@ -1,4 +1,5 @@
 import { inAppWallet, preAuthenticate } from 'thirdweb/wallets'
+import { UserFacingError, isErrorWithMessage } from '../errors'
 import { getThirdwebClient } from './client'
 
 // Store the wallet instance for reuse
@@ -81,6 +82,9 @@ export const verifyEmailOTPAndConnect = async (email: string, verificationCode:
     return account
   } catch (error) {
     console.error('[Thirdweb] Error verifying OTP:', error)
+    if (isErrorWithMessage(error) && /verify|invalid|expired/i.test(error.message)) {
+      throw new UserFacingError(error.message)
+    }
     throw error
   }
 }

src/shared/utils/errorHandler.ts

@@ -1,6 +1,6 @@
 import { captureException } from '@sentry/react'
 import { TrackingEvents } from '../../modules/analytics/types'
-import { isErrorWithMessage } from '../errors'
+import { UserFacingError, isErrorWithMessage } from '../errors'
 import { trackEvent } from './analytics'
 import { ErrorContext, HandleErrorOptions } from './errorHandler.types'
 
@@ -11,10 +11,12 @@ const handleError = (error: unknown, context: string, options?: HandleErrorOptio
     console.error(`${context}:`, errorMessage)
   }
 
-  captureException(error, {
-    tags: options?.sentryTags,
-    extra: options?.sentryExtra
-  })
+  if (!options?.skipSentry && !(error instanceof UserFacingError)) {
+    captureException(error, {
+      tags: options?.sentryTags,
+      extra: options?.sentryExtra
+    })
+  }
 
   if (!options?.skipTracking) {
     const trackingEvent = (options?.trackingEvent as TrackingEvents) || TrackingEvents.LOGIN_ERROR

src/shared/utils/errorHandler.types.ts

@@ -71,5 +71,6 @@ export interface HandleErrorOptions {
   sentryExtra?: SentryExtra
   skipLogging?: boolean
   skipTracking?: boolean
+  skipSentry?: boolean
   trackingEvent?: string
 }