@glowlabs-org/utils 0.2.142 → 0.2.145

package/src/lib/hooks/use-offchain-fractions.ts

@@ -11,6 +11,10 @@ import {
   parseViemError,
   waitForViemTransactionWithRetry,
 } from "../../utils/transaction-utils";
+import {
+  sentryAddBreadcrumb,
+  sentryCaptureException,
+} from "../../utils/sentry";
 
 export enum OffchainFractionsError {
   CONTRACT_NOT_AVAILABLE = "Contract not available",
@@ -195,6 +199,24 @@ export function useOffchainFractions(
     try {
       setIsProcessing(true);
 
+      sentryAddBreadcrumb({
+        category: "offchain-fractions",
+        message: "createFraction.start",
+        level: "info",
+        data: {
+          chainId: walletClient?.chain?.id,
+          contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+          id: params.id,
+          token: params.token,
+          step: params.step.toString(),
+          totalSteps: params.totalSteps.toString(),
+          to: params.to,
+          expiration: params.expiration,
+          minSharesToRaise: params.minSharesToRaise.toString(),
+          closer: params.closer,
+        },
+      });
+
       const {
         id,
         token,
@@ -240,6 +262,12 @@ export function useOffchainFractions(
           account: walletClient.account!,
         });
       } catch (simulationError) {
+        sentryCaptureException(simulationError, {
+          action: "createFraction.simulate",
+          chainId: walletClient?.chain?.id,
+          contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+          id: params.id,
+        });
         throw new Error(parseViemError(simulationError));
       }
 
@@ -267,6 +295,13 @@ export function useOffchainFractions(
 
       return hash;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "createFraction",
+        chainId: walletClient?.chain?.id,
+        contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+        id: params.id,
+        token: params.token,
+      });
       throw new Error(parseViemError(error));
     } finally {
       setIsProcessing(false);
@@ -284,6 +319,24 @@ export function useOffchainFractions(
     try {
       setIsProcessing(true);
 
+      sentryAddBreadcrumb({
+        category: "offchain-fractions",
+        message: "buyFractions.start",
+        level: "info",
+        data: {
+          chainId: walletClient?.chain?.id,
+          contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+          creator: params.creator,
+          id: params.id,
+          stepsToBuy: params.stepsToBuy.toString(),
+          minStepsToBuy: params.minStepsToBuy.toString(),
+          refundTo: params.refundTo,
+          creditTo: params.creditTo,
+          useCounterfactualAddressForRefund:
+            params.useCounterfactualAddressForRefund,
+        },
+      });
+
       const {
         creator,
         id,
@@ -354,6 +407,13 @@ export function useOffchainFractions(
           account: walletClient.account!,
         });
       } catch (simulationError) {
+        sentryCaptureException(simulationError, {
+          action: "buyFractions.simulate",
+          chainId: walletClient?.chain?.id,
+          contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+          creator: params.creator,
+          id: params.id,
+        });
         throw new Error(parseViemError(simulationError));
       }
 
@@ -379,6 +439,14 @@ export function useOffchainFractions(
 
       return hash;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "buyFractions",
+        chainId: walletClient?.chain?.id,
+        contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+        creator: params.creator,
+        id: params.id,
+        stepsToBuy: params.stepsToBuy.toString(),
+      });
       throw new Error(parseViemError(error));
     } finally {
       setIsProcessing(false);
@@ -402,6 +470,19 @@ export function useOffchainFractions(
     try {
       setIsProcessing(true);
 
+      sentryAddBreadcrumb({
+        category: "offchain-fractions",
+        message: "claimRefund.start",
+        level: "info",
+        data: {
+          chainId: walletClient?.chain?.id,
+          contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+          user,
+          creator,
+          id,
+        },
+      });
+
       // Normalize addresses to lowercase for consistency
       const normalizedUser = user?.toLowerCase();
       const normalizedCreator = creator?.toLowerCase();
@@ -452,7 +533,14 @@ export function useOffchainFractions(
           account: walletClient.account!,
         });
       } catch (simulationError) {
-        console.error("Simulation failed:", simulationError);
+        sentryCaptureException(simulationError, {
+          action: "claimRefund.simulate",
+          chainId: walletClient?.chain?.id,
+          contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+          user,
+          creator,
+          id,
+        });
         throw new Error(parseViemError(simulationError));
       }
 
@@ -470,6 +558,14 @@ export function useOffchainFractions(
 
       return hash;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "claimRefund",
+        chainId: walletClient?.chain?.id,
+        contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+        user,
+        creator,
+        id,
+      });
       throw new Error(parseViemError(error));
     } finally {
       setIsProcessing(false);
@@ -488,6 +584,18 @@ export function useOffchainFractions(
     try {
       setIsProcessing(true);
 
+      sentryAddBreadcrumb({
+        category: "offchain-fractions",
+        message: "closeFraction.start",
+        level: "info",
+        data: {
+          chainId: walletClient?.chain?.id,
+          contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+          creator,
+          id,
+        },
+      });
+
       // Validate parameters
       if (!creator || !id) {
         throw new Error(OffchainFractionsError.INVALID_PARAMETERS);
@@ -508,6 +616,13 @@ export function useOffchainFractions(
           account: walletClient.account!,
         });
       } catch (simulationError) {
+        sentryCaptureException(simulationError, {
+          action: "closeFraction.simulate",
+          chainId: walletClient?.chain?.id,
+          contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+          creator,
+          id,
+        });
         throw new Error(parseViemError(simulationError));
       }
 
@@ -525,6 +640,13 @@ export function useOffchainFractions(
 
       return hash;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "closeFraction",
+        chainId: walletClient?.chain?.id,
+        contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+        creator,
+        id,
+      });
       throw new Error(parseViemError(error));
     } finally {
       setIsProcessing(false);
@@ -672,6 +794,20 @@ export function useOffchainFractions(
     try {
       setIsProcessing(true);
 
+      sentryAddBreadcrumb({
+        category: "offchain-fractions",
+        message: "setRefundDetails.start",
+        level: "info",
+        data: {
+          chainId: walletClient?.chain?.id,
+          contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+          creator,
+          id,
+          refundTo,
+          useCounterfactualAddress,
+        },
+      });
+
       // Validate parameters
       if (!creator || !id || !refundTo) {
         throw new Error(OffchainFractionsError.INVALID_PARAMETERS);
@@ -697,6 +833,13 @@ export function useOffchainFractions(
           account: walletClient.account!,
         });
       } catch (simulationError) {
+        sentryCaptureException(simulationError, {
+          action: "setRefundDetails.simulate",
+          chainId: walletClient?.chain?.id,
+          contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+          creator,
+          id,
+        });
         throw new Error(parseViemError(simulationError));
       }
 
@@ -719,6 +862,14 @@ export function useOffchainFractions(
 
       return hash;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "setRefundDetails",
+        chainId: walletClient?.chain?.id,
+        contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+        creator,
+        id,
+        refundTo,
+      });
       throw new Error(parseViemError(error));
     } finally {
       setIsProcessing(false);
@@ -740,6 +891,18 @@ export function useOffchainFractions(
     try {
       setIsProcessing(true);
 
+      sentryAddBreadcrumb({
+        category: "offchain-fractions",
+        message: "setRefundOperatorStatus.start",
+        level: "info",
+        data: {
+          chainId: walletClient?.chain?.id,
+          contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+          refundOperator,
+          isApproved,
+        },
+      });
+
       // Validate parameters
       if (!refundOperator) {
         throw new Error(OffchainFractionsError.INVALID_PARAMETERS);
@@ -760,6 +923,13 @@ export function useOffchainFractions(
           account: walletClient.account!,
         });
       } catch (simulationError) {
+        sentryCaptureException(simulationError, {
+          action: "setRefundOperatorStatus.simulate",
+          chainId: walletClient?.chain?.id,
+          contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+          refundOperator,
+          isApproved,
+        });
         throw new Error(parseViemError(simulationError));
       }
 
@@ -777,6 +947,13 @@ export function useOffchainFractions(
 
       return hash;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "setRefundOperatorStatus",
+        chainId: walletClient?.chain?.id,
+        contract: ADDRESSES.OFFCHAIN_FRACTIONS,
+        refundOperator,
+        isApproved,
+      });
       throw new Error(parseViemError(error));
     } finally {
       setIsProcessing(false);

package/src/utils/sentry.ts

@@ -0,0 +1,89 @@
+"use strict";
+
+export interface SentryBreadcrumb {
+  category: string;
+  message?: string;
+  level?: "error" | "warning" | "info" | "debug";
+  data?: Record<string, unknown>;
+}
+
+export interface SentryClientLike {
+  captureException: (
+    error: unknown,
+    context?: { extra?: Record<string, unknown> }
+  ) => void;
+  addBreadcrumb?: (breadcrumb: SentryBreadcrumb) => void;
+}
+
+type SentryConfig = {
+  enabled?: boolean;
+  client?: SentryClientLike | null;
+  defaultContext?: Record<string, unknown>;
+};
+
+let configuredClient: SentryClientLike | null = null;
+let isEnabled = true;
+let defaultExtra: Record<string, unknown> = {};
+
+function getSentry(): SentryClientLike | null {
+  const client =
+    configuredClient ??
+    ((globalThis as any)?.Sentry as SentryClientLike | undefined);
+  if (!client || typeof client.captureException !== "function") return null;
+  return client;
+}
+
+export function configureSentry(config: SentryConfig): void {
+  if (config.enabled !== undefined) isEnabled = !!config.enabled;
+  if (config.client !== undefined) configuredClient = config.client;
+  if (config.defaultContext) defaultExtra = { ...config.defaultContext };
+}
+
+function shouldSkipSentry(error: unknown): boolean {
+  try {
+    const possible: any = error;
+    const code: string | undefined = possible?.code || possible?.cause?.code;
+    const name: string | undefined = possible?.name || possible?.cause?.name;
+    const message: string = String(
+      possible?.message || possible?.cause?.message || ""
+    );
+
+    // User rejected wallet request (ethers/viem/common providers)
+    if (code === "ACTION_REJECTED") return true;
+    if (name === "UserRejectedRequestError") return true;
+    if (/user rejected/i.test(message)) return true;
+
+    // Terminal waitForViemTransactionWithRetry error (retries exhausted)
+    if (/Transaction failed after\s+\d+\s+attempts:/i.test(message)) {
+      return true;
+    }
+
+    return false;
+  } catch {
+    return false;
+  }
+}
+
+export function sentryAddBreadcrumb(breadcrumb: SentryBreadcrumb): void {
+  try {
+    if (!isEnabled) return;
+    getSentry()?.addBreadcrumb?.(breadcrumb);
+  } catch {}
+}
+
+export function sentryCaptureException(
+  error: unknown,
+  extra?: Record<string, unknown>
+): void {
+  try {
+    if (!isEnabled) return;
+    if (shouldSkipSentry(error)) return;
+    const client = getSentry();
+    if (!client) return;
+    const merged = extra ? { ...defaultExtra, ...extra } : defaultExtra;
+    client.captureException(
+      error,
+      Object.keys(merged).length ? { extra: merged } : undefined
+    );
+  } catch {}
+}