@glowlabs-org/utils 0.2.142 → 0.2.145

package/dist/esm/index.d.ts

@@ -10,3 +10,4 @@ export { RegionRouter } from "./lib/control-api/region-router";
 export { KickstarterRouter } from "./lib/control-api/kickstarter-router";
 export { WalletsRouter } from "./lib/control-api/wallets-router";
 export { FarmsRouter } from "./lib/control-api/farms-router";
+export { configureSentry, type SentryClientLike } from "./utils/sentry";

package/dist/esm/index.js

@@ -13,8 +13,8 @@ import { parseUnits, formatUnits } from 'viem';
 import { MerkleTree } from 'merkletreejs';
 import { solidityPackedKeccak256, keccak256 } from 'ethers';
 import Decimal from 'decimal.js';
-import { H as HUB_URL, U as USDG_WEIGHT_DECIMAL_PRECISION, G as GLOW_WEIGHT_DECIMAL_PRECISION, M as MAX_WEIGHT } from './farms-router-Cxbn5Hap.js';
-export { C as ControlRouter, F as FarmsRouter, c as KICKSTARTER_STATUS, K as KickstarterRouter, O as OFF_CHAIN_PAYMENT_CURRENCIES, P as PAYMENT_CURRENCIES, b as REGIONS, R as RegionRouter, S as STAKING_DIRECTIONS, T as TRANSFER_TYPES, W as WalletsRouter, u as useForwarder, a as useOffchainFractions } from './farms-router-Cxbn5Hap.js';
+import { H as HUB_URL, U as USDG_WEIGHT_DECIMAL_PRECISION, G as GLOW_WEIGHT_DECIMAL_PRECISION, M as MAX_WEIGHT } from './farms-router-C_7Ys4An.js';
+export { C as ControlRouter, F as FarmsRouter, d as KICKSTARTER_STATUS, K as KickstarterRouter, O as OFF_CHAIN_PAYMENT_CURRENCIES, P as PAYMENT_CURRENCIES, b as REGIONS, R as RegionRouter, S as STAKING_DIRECTIONS, T as TRANSFER_TYPES, W as WalletsRouter, c as configureSentry, u as useForwarder, a as useOffchainFractions } from './farms-router-C_7Ys4An.js';
 
 const GENESIS_TIMESTAMP = 1700352000;
 

package/dist/esm/lib/control-api/region-router.d.ts

@@ -1,4 +1,4 @@
-import type { RegionWithMetadata, ActivationConfig, CreateRegionPayload, ActivationEvent, RegionDetails, SponsoredFarm } from "../types";
+import type { RegionWithMetadata, ActivationConfig, ActivationEvent, RegionDetails, SponsoredFarm } from "../types";
 export declare function RegionRouter(baseUrl: string): {
     readonly fetchRegions: (params?: {
         isActive?: boolean;
@@ -8,8 +8,6 @@ export declare function RegionRouter(baseUrl: string): {
     readonly fetchRegionByIdOrSlug: (idOrSlug: string) => Promise<RegionDetails>;
     readonly fetchRegionSolarFarms: (regionId: number) => Promise<SponsoredFarm[]>;
     readonly getRegionByCode: (code: string) => RegionWithMetadata | null;
-    readonly createRegion: (payload: CreateRegionPayload) => Promise<void>;
     readonly regions: RegionWithMetadata[];
     readonly isLoading: boolean;
-    readonly isCreatingRegion: boolean;
 };

package/dist/esm/utils/sentry.d.ts

@@ -0,0 +1,21 @@
+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>;
+};
+export declare function configureSentry(config: SentryConfig): void;
+export declare function sentryAddBreadcrumb(breadcrumb: SentryBreadcrumb): void;
+export declare function sentryCaptureException(error: unknown, extra?: Record<string, unknown>): void;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glowlabs-org/utils",
-  "version": "0.2.142",
+  "version": "0.2.145",
   "description": "A library containing all typechain types and addresses relating to the glow guarded launch",
   "keywords": [],
   "author": "",

package/src/browser.ts

@@ -14,3 +14,4 @@ export * from "./constants/weights";
 export * from "./constants/urls";
 export * from "./utils/stake-control";
 export * from "./utils/transaction-utils";
+export { configureSentry, type SentryClientLike } from "./utils/sentry";

package/src/index.ts

@@ -13,3 +13,4 @@ export { RegionRouter } from "./lib/control-api/region-router";
 export { KickstarterRouter } from "./lib/control-api/kickstarter-router";
 export { WalletsRouter } from "./lib/control-api/wallets-router";
 export { FarmsRouter } from "./lib/control-api/farms-router";
+export { configureSentry, type SentryClientLike } from "./utils/sentry";

package/src/lib/control-api/control-router.ts

@@ -20,6 +20,10 @@ import type {
   RestakeRequest,
   MigrationAmountResponse,
 } from "../types";
+import {
+  sentryAddBreadcrumb,
+  sentryCaptureException,
+} from "../../utils/sentry";
 
 export interface PayProtocolDepositUsingStakedControlRequest {
   wallet: string;
@@ -288,6 +292,16 @@ export function ControlRouter(baseUrl: string) {
   const stakeGctl = async (stakeRequest: StakeRequest): Promise<boolean> => {
     isStaking = true;
     try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /stake",
+        level: "info",
+        data: {
+          baseUrl,
+          wallet: stakeRequest.wallet,
+          regionId: stakeRequest.regionId,
+        },
+      });
       await request(`/stake`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -295,6 +309,14 @@ export function ControlRouter(baseUrl: string) {
       });
       return true;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "stakeGctl",
+        baseUrl,
+        wallet: stakeRequest.wallet,
+        regionId: stakeRequest.regionId,
+        amount: stakeRequest.amount,
+        deadline: stakeRequest.deadline,
+      });
       throw new Error(parseApiError(error));
     } finally {
       isStaking = false;
@@ -306,6 +328,16 @@ export function ControlRouter(baseUrl: string) {
   ): Promise<boolean> => {
     isUnstaking = true;
     try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /unstake",
+        level: "info",
+        data: {
+          baseUrl,
+          wallet: unstakeRequest.wallet,
+          regionId: unstakeRequest.regionId,
+        },
+      });
       await request(`/unstake`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -313,6 +345,14 @@ export function ControlRouter(baseUrl: string) {
       });
       return true;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "unstakeGctl",
+        baseUrl,
+        wallet: unstakeRequest.wallet,
+        regionId: unstakeRequest.regionId,
+        amount: unstakeRequest.amount,
+        deadline: unstakeRequest.deadline,
+      });
       throw new Error(parseApiError(error));
     } finally {
       isUnstaking = false;
@@ -324,6 +364,17 @@ export function ControlRouter(baseUrl: string) {
   ): Promise<boolean> => {
     isRestaking = true;
     try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /restake",
+        level: "info",
+        data: {
+          baseUrl,
+          wallet: restakeRequest.wallet,
+          fromZoneId: restakeRequest.fromZoneId,
+          toZoneId: restakeRequest.toZoneId,
+        },
+      });
       await request(`/restake`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -331,6 +382,15 @@ export function ControlRouter(baseUrl: string) {
       });
       return true;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "restakeGctl",
+        baseUrl,
+        wallet: restakeRequest.wallet,
+        fromZoneId: restakeRequest.fromZoneId,
+        toZoneId: restakeRequest.toZoneId,
+        amount: restakeRequest.amount,
+        deadline: restakeRequest.deadline,
+      });
       throw new Error(parseApiError(error));
     } finally {
       isRestaking = false;
@@ -342,12 +402,23 @@ export function ControlRouter(baseUrl: string) {
   ): Promise<boolean> => {
     isRetryingFailedOperation = true;
     try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /operations/failed/:id/retry",
+        level: "info",
+        data: { baseUrl, operationId },
+      });
       await request(`/operations/failed/${operationId}/retry`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
       });
       return true;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "retryFailedOperation",
+        baseUrl,
+        operationId,
+      });
       throw new Error(parseApiError(error));
     } finally {
       isRetryingFailedOperation = false;
@@ -359,6 +430,18 @@ export function ControlRouter(baseUrl: string) {
   ): Promise<PayProtocolDepositUsingStakedControlResponse> => {
     isPayingProtocolDepositUsingStakedControl = true;
     try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /pay-protocol-deposit-staked",
+        level: "info",
+        data: {
+          baseUrl,
+          wallet: paymentRequest.wallet,
+          regionId: paymentRequest.regionId,
+          applicationId: paymentRequest.applicationId,
+          amount: paymentRequest.amount,
+        },
+      });
       const response =
         await request<PayProtocolDepositUsingStakedControlResponse>(
           `/pay-protocol-deposit-staked`,
@@ -370,6 +453,14 @@ export function ControlRouter(baseUrl: string) {
         );
       return response;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "payProtocolDepositUsingStakedControl",
+        baseUrl,
+        wallet: paymentRequest.wallet,
+        regionId: paymentRequest.regionId,
+        applicationId: paymentRequest.applicationId,
+        amount: paymentRequest.amount,
+      });
       throw new Error(parseApiError(error));
     } finally {
       isPayingProtocolDepositUsingStakedControl = false;
@@ -381,6 +472,15 @@ export function ControlRouter(baseUrl: string) {
   ): Promise<MigrateUserResponse> => {
     isMigratingUser = true;
     try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /migrate-user",
+        level: "info",
+        data: {
+          baseUrl,
+          wallet: migrateRequest.wallet,
+        },
+      });
       const response = await request<MigrateUserResponse>(`/migrate-user`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -388,6 +488,12 @@ export function ControlRouter(baseUrl: string) {
       });
       return response;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "migrateUser",
+        baseUrl,
+        wallet: migrateRequest.wallet,
+        deadline: migrateRequest.deadline,
+      });
       throw new Error(parseApiError(error));
     } finally {
       isMigratingUser = false;

package/src/lib/control-api/farms-router.ts

@@ -47,6 +47,10 @@ import type {
   MiningScoresBatchParams,
   MiningScoresBatchResponse,
 } from "../types";
+import {
+  sentryAddBreadcrumb,
+  sentryCaptureException,
+} from "../../utils/sentry";
 
 function parseApiError(error: unknown): string {
   if (!error) return "Unknown error";
@@ -128,6 +132,12 @@ export function FarmsRouter(baseUrl: string) {
     params: EstimateRewardScoreParams
   ): Promise<RewardScoreResponse> => {
     try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /farms/estimate-reward-score",
+        level: "info",
+        data: { baseUrl, regionId: params.regionId, userId: params.userId },
+      });
       const data = await request<
         RewardScoreResponse | EstimateRewardScoreErrorResponse
       >("/farms/estimate-reward-score", {
@@ -147,6 +157,13 @@ export function FarmsRouter(baseUrl: string) {
       // All fields are required in the success response based on the API spec
       return data as RewardScoreResponse;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "estimateRewardScore",
+        baseUrl,
+        userId: params.userId,
+        regionId: params.regionId,
+        paymentCurrency: params.paymentCurrency,
+      });
       throw new Error(parseApiError(error));
     }
   };
@@ -155,6 +172,12 @@ export function FarmsRouter(baseUrl: string) {
     params: EstimateRewardScoresBatchParams
   ): Promise<EstimateRewardScoresBatchResponse> => {
     try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /farms/estimate-reward-scores-batch",
+        level: "info",
+        data: { baseUrl },
+      });
       const data = await request<EstimateRewardScoresBatchResponse>(
         "/farms/estimate-reward-scores-batch",
         {
@@ -168,6 +191,11 @@ export function FarmsRouter(baseUrl: string) {
 
       return data;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "estimateRewardScoresBatch",
+        baseUrl,
+        farmsCount: params.farms?.length,
+      });
       throw new Error(parseApiError(error));
     }
   };
@@ -176,6 +204,12 @@ export function FarmsRouter(baseUrl: string) {
     params: MiningScoresBatchParams
   ): Promise<MiningScoresBatchResponse> => {
     try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /farms/mining-scores-batch",
+        level: "info",
+        data: { baseUrl },
+      });
       const data = await request<MiningScoresBatchResponse>(
         "/farms/mining-scores-batch",
         {
@@ -189,6 +223,11 @@ export function FarmsRouter(baseUrl: string) {
 
       return data;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "calculateMiningScoresBatch",
+        baseUrl,
+        farmsCount: params.farms?.length,
+      });
       throw new Error(parseApiError(error));
     }
   };

package/src/lib/control-api/kickstarter-router.ts

@@ -11,6 +11,10 @@ import type {
   KickstarterCommitmentsQuery,
   KickstarterCommitmentsResponse,
 } from "../types";
+import {
+  sentryAddBreadcrumb,
+  sentryCaptureException,
+} from "../../utils/sentry";
 
 function parseApiError(error: unknown): string {
   if (!error) return "Unknown error";
@@ -49,6 +53,16 @@ export function KickstarterRouter(baseUrl: string) {
   ): Promise<KickstarterCreateResponse> => {
     isCreatingKickstarter = true;
     try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /kickstarters",
+        level: "info",
+        data: {
+          baseUrl,
+          code: payload.code,
+          creatorWallet: payload.creatorWallet,
+        },
+      });
       const exists = Boolean(regionMetadata[payload.code]);
       if (!exists) {
         throw new Error(`Unknown region code: ${payload.code}`);
@@ -60,6 +74,14 @@ export function KickstarterRouter(baseUrl: string) {
       });
       return data;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "createKickstarter",
+        baseUrl,
+        code: payload.code,
+        creatorWallet: payload.creatorWallet,
+        title: payload.title,
+        regionName: payload.regionName,
+      });
       throw new Error(parseApiError(error));
     } finally {
       isCreatingKickstarter = false;
@@ -97,6 +119,12 @@ export function KickstarterRouter(baseUrl: string) {
     payload: CommitKickstarterPayload
   ): Promise<CommitKickstarterResponse> => {
     try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /kickstarters/commit/:id",
+        level: "info",
+        data: { baseUrl, kickstarterId },
+      });
       const data = await request<CommitKickstarterResponse>(
         `/kickstarters/commit/${encodeURIComponent(kickstarterId)}`,
         {
@@ -107,6 +135,13 @@ export function KickstarterRouter(baseUrl: string) {
       );
       return data;
     } catch (error) {
+      sentryCaptureException(error, {
+        action: "commitKickstarter",
+        baseUrl,
+        kickstarterId,
+        wallet: payload.wallet,
+        amount: payload.amount,
+      });
       throw new Error(parseApiError(error));
     }
   };

package/src/lib/control-api/region-router.ts

@@ -5,7 +5,6 @@ import { regionMetadata } from "../region-metadata";
 import type {
   RegionWithMetadata,
   ActivationConfig,
-  CreateRegionPayload,
   ActivationEvent,
   RegionDetails,
   SponsoredFarm,
@@ -43,7 +42,6 @@ export function RegionRouter(baseUrl: string) {
   // -------------------------------------------------------------------------
   let cachedRegions: RegionWithMetadata[] = [];
   let isLoading = false;
-  let isCreatingRegion = false;
 
   // -------------------------------------------------------------------------
   // Queries
@@ -121,26 +119,6 @@ export function RegionRouter(baseUrl: string) {
     }
   };
 
-  // -------------------------------------------------------------------------
-  // Mutations
-  // -------------------------------------------------------------------------
-  const createRegion = async (payload: CreateRegionPayload): Promise<void> => {
-    isCreatingRegion = true;
-    try {
-      await request(`/regions/create`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(payload),
-      });
-      // Refresh the local cache after successful creation
-      await fetchRegions();
-    } catch (error) {
-      throw new Error(parseApiError(error));
-    } finally {
-      isCreatingRegion = false;
-    }
-  };
-
   // Kickstarter-related logic moved to kickstarter-router.ts
 
   // -------------------------------------------------------------------------
@@ -196,7 +174,6 @@ export function RegionRouter(baseUrl: string) {
     fetchRegionByIdOrSlug,
     fetchRegionSolarFarms,
     getRegionByCode,
-    createRegion,
 
     // Cached data & flags
     get regions() {
@@ -205,8 +182,5 @@ export function RegionRouter(baseUrl: string) {
     get isLoading() {
       return isLoading;
     },
-    get isCreatingRegion() {
-      return isCreatingRegion;
-    },
   } as const;
 }

package/src/lib/hooks/use-forwarder.ts

@@ -8,6 +8,10 @@ import {
   parseEthersError,
   waitForEthersTransactionWithRetry,
 } from "../../utils/transaction-utils";
+import {
+  sentryAddBreadcrumb,
+  sentryCaptureException,
+} from "../../utils/sentry";
 
 export enum ForwarderError {
   CONTRACT_NOT_AVAILABLE = "Contract not available",
@@ -260,6 +264,23 @@ export function useForwarder(signer: Signer | undefined, CHAIN_ID: number) {
       if (!tokenContract)
         throw new Error(ForwarderError.CONTRACT_NOT_AVAILABLE);
 
+      sentryAddBreadcrumb({
+        category: "forwarder",
+        message: "forwardTokens.start",
+        level: "info",
+        data: {
+          chainId: CHAIN_ID,
+          type: params.type,
+          amount: amount.toString(),
+          currency,
+          applicationId: params.applicationId,
+          farmId: params.farmId,
+          regionId: params.regionId,
+          kickstarterId: params.kickstarterId,
+          userAddress: params.userAddress,
+        },
+      });
+
       const owner = await signer.getAddress();
 
       // Construct the appropriate message for this forward type
@@ -292,6 +313,13 @@ export function useForwarder(signer: Signer | undefined, CHAIN_ID: number) {
           );
           await waitForEthersTransactionWithRetry(signer, approveTx.hash);
         } catch (approveError) {
+          sentryCaptureException(approveError, {
+            action: "forwardTokens.approve",
+            chainId: CHAIN_ID,
+            spender: ADDRESSES.FORWARDER,
+            amount: MaxUint256.toString(),
+            currency,
+          });
           throw new Error(
             parseEthersError(approveError) || "Token approval failed"
           );
@@ -346,6 +374,18 @@ export function useForwarder(signer: Signer | undefined, CHAIN_ID: number) {
             );
         }
       } catch (staticError) {
+        sentryCaptureException(staticError, {
+          action: "forwardTokens.staticCall",
+          chainId: CHAIN_ID,
+          function:
+            !isAuditFees && currency === "USDC"
+              ? "swapUSDCAndForwardUSDG"
+              : "forward",
+          tokenAddress,
+          amount: amount.toString(),
+          currency,
+          isAuditFees,
+        });
         throw new Error(parseEthersError(staticError));
       }
 
@@ -373,6 +413,18 @@ export function useForwarder(signer: Signer | undefined, CHAIN_ID: number) {
 
       return tx.hash;
     } catch (txError: any) {
+      sentryCaptureException(txError, {
+        action: "forwardTokens",
+        chainId: CHAIN_ID,
+        type: params.type,
+        amount: params.amount.toString(),
+        currency: params.currency ?? "USDC",
+        applicationId: params.applicationId,
+        farmId: params.farmId,
+        regionId: params.regionId,
+        kickstarterId: params.kickstarterId,
+        userAddress: params.userAddress,
+      });
       throw new Error(parseEthersError(txError));
     } finally {
       setIsProcessing(false);