@glowlabs-org/utils 0.2.150 → 0.2.152

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-wk3VSuCV.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-wk3VSuCV.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-C0g4hf2Z.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-C0g4hf2Z.js';
 
 const GENESIS_TIMESTAMP = 1700352000;
 

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

@@ -1,4 +1,4 @@
-import type { StakeRequest, RegionStake, WalletRegionStake, WalletRegionUnlocked, WalletRegionCommittedBalance, TransferDetails, GlwRegionRewardsResponse, MintedEventsResponse, StakeEventsResponse, FailedOperationsResponse, PendingTransfersResponse, PendingTransferType, RestakeRequest, MigrationAmountResponse } from "../types";
+import type { StakeRequest, RegionStake, WalletRegionStake, WalletRegionUnlocked, WalletRegionCommittedBalance, TransferDetails, GlwRegionRewardsResponse, MintedEventsResponse, StakeEventsResponse, FailedOperationsResponse, PendingTransfersResponse, PendingTransferType, RestakeRequest, MigrationAmountResponse, RetryFailedOperationResponse, FarmRewardSplit } from "../types";
 export interface PayProtocolDepositUsingStakedControlRequest {
     wallet: string;
     regionId: number;
@@ -28,6 +28,7 @@ export declare function ControlRouter(baseUrl: string): {
     readonly fetchGctlPrice: () => Promise<string>;
     readonly fetchGlwPrice: () => Promise<string>;
     readonly fetchCirculatingSupply: () => Promise<string>;
+    readonly fetchHoldersCount: () => Promise<number>;
     readonly fetchLastNonce: (wallet: string) => Promise<string>;
     readonly fetchMintedEvents: (page?: number, limit?: number) => Promise<MintedEventsResponse>;
     readonly fetchStakeEvents: (page?: number, limit?: number, regionId?: number) => Promise<StakeEventsResponse>;
@@ -39,11 +40,12 @@ export declare function ControlRouter(baseUrl: string): {
     readonly fetchWalletRegionCommittedBalance: (wallet: string, regionId: number) => Promise<WalletRegionCommittedBalance>;
     readonly fetchTransferDetails: (txId: string) => Promise<TransferDetails>;
     readonly fetchGlwRegionRewards: () => Promise<GlwRegionRewardsResponse>;
+    readonly fetchFarmRewardSplits: (farmId: string) => Promise<FarmRewardSplit[]>;
     readonly fetchMigrationAmount: (wallet: string) => Promise<MigrationAmountResponse>;
     readonly stakeGctl: (stakeRequest: StakeRequest) => Promise<boolean>;
     readonly unstakeGctl: (unstakeRequest: StakeRequest) => Promise<boolean>;
     readonly restakeGctl: (restakeRequest: RestakeRequest) => Promise<boolean>;
-    readonly retryFailedOperation: (operationId: string) => Promise<boolean>;
+    readonly retryFailedOperation: (operationId: string) => Promise<RetryFailedOperationResponse>;
     readonly payProtocolDepositUsingStakedControl: (paymentRequest: PayProtocolDepositUsingStakedControlRequest) => Promise<PayProtocolDepositUsingStakedControlResponse>;
     readonly migrateUser: (migrateRequest: MigrateUserRequest) => Promise<MigrateUserResponse>;
     readonly isStaking: boolean;

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

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

package/dist/esm/lib/types/index.d.ts

@@ -311,18 +311,17 @@ export interface RegionDetails extends RegionWithMetadata {
     carbonCreditsIssued: number;
     carbonCreditsPerWeek: number;
 }
-export interface ActiveRegionStakeEvent {
-    id: string;
-    regionId: number;
-    wallet: string;
+export interface ActiveRegionDataPoint {
     epoch: number;
-    amount: string;
-    direction: string;
-    ts: string;
-    processed: boolean;
-    progressClaimed: string;
-    progressMoved: string;
-    actionSignatureData: unknown | null;
+    timestamp: number;
+    gctlStaked: string;
+    pendingUnstake: string;
+    pendingRestakeOut: string;
+    pendingRestakeIn: string;
+    netPending: string;
+    eventCount: number;
+    firstEventTimestamp?: number;
+    lastEventTimestamp?: number;
 }
 export interface ActiveRegionSummary {
     id: number;
@@ -330,20 +329,47 @@ export interface ActiveRegionSummary {
     code: string;
     slug: string;
     isUs: boolean;
-    gctlStaked: string;
+    currentGctlStaked: string;
     glwRewardPerWeek: string;
     rewardShare: string;
-    pendingUnstake: string;
-    pendingRestakeOut: string;
-    pendingRestakeIn: string;
-    events: ActiveRegionStakeEvent[];
+    data: ActiveRegionDataPoint[];
 }
 export interface ActiveRegionsSummaryResponse {
+    metadata: {
+        epochs: number[];
+        epochTimestamps: {
+            [epoch: string]: number;
+        };
+        currentEpoch: number;
+    };
     total: {
         totalGctlStaked: string;
         totalGlwRewards: string;
     };
     regions: ActiveRegionSummary[];
+    aggregate: {
+        epochs: number[];
+        timestamps: number[];
+        totalGctlStaked: string[];
+        totalPendingUnstake: string[];
+        totalNetPending: string[];
+    };
+}
+export interface RegionActivityPeriod {
+    stakes: number;
+    unstakes: number;
+    restakes: number;
+    immediateUnstakes: number;
+    netChange: string;
+}
+export interface RegionActivity {
+    regionId: number;
+    regionName: string;
+    last24h: RegionActivityPeriod;
+    last7d: RegionActivityPeriod;
+}
+export interface RecentRegionActivityResponse {
+    activity: RegionActivity[];
 }
 export interface InstallerApplicationPayload {
     wallet: string;
@@ -577,4 +603,11 @@ export interface FarmRewardSplitsResponse {
 export interface FarmRewardSplitsErrorResponse {
     error: string;
 }
+export interface HoldersCountResponse {
+    holders: number;
+}
+export interface RetryFailedOperationResponse {
+    success?: boolean;
+    queued?: boolean;
+}
 export type { MintedEvent as ControlMintedEvent };

package/package.json

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

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

@@ -19,7 +19,20 @@ import type {
   PendingTransferType,
   RestakeRequest,
   MigrationAmountResponse,
+  HoldersCountResponse,
+  RetryFailedOperationResponse,
+  FarmRewardSplitsResponse,
+  FarmRewardSplitsErrorResponse,
+  FarmRewardSplit,
 } from "../types";
+
+interface FetchGctlBalanceResponse {
+  gctl_balance: string;
+}
+
+interface FetchCommittedBalanceResponse {
+  gctl_committed_balance: string;
+}
 import {
   sentryAddBreadcrumb,
   sentryCaptureException,
@@ -69,6 +82,9 @@ function parseApiError(error: unknown): string {
 // --------------------------------------------------------------------------
 
 export function ControlRouter(baseUrl: string) {
+  if (!baseUrl) {
+    throw new Error("CONTROL API base URL is not set");
+  }
   // ----------------------- Internal helpers --------------------------------
   const request = async <T>(path: string, init?: RequestInit): Promise<T> => {
     const res = await fetch(`${baseUrl}${path}`, init);
@@ -82,7 +98,7 @@ export function ControlRouter(baseUrl: string) {
   // ----------------------- GETters -----------------------------------------
   const fetchGctlBalance = async (wallet: string): Promise<string> => {
     try {
-      const data = await request<{ gctl_balance: string }>(
+      const data = await request<FetchGctlBalanceResponse>(
         `/balance/${wallet}`
       );
       return (data?.gctl_balance ?? "0").toString();
@@ -93,7 +109,7 @@ export function ControlRouter(baseUrl: string) {
 
   const fetchCommittedBalance = async (wallet: string): Promise<string> => {
     try {
-      const data = await request<{ gctl_committed_balance: string }>(
+      const data = await request<FetchCommittedBalanceResponse>(
         `/committed-balance/${wallet}`
       );
       return (data?.gctl_committed_balance ?? "0").toString();
@@ -138,6 +154,15 @@ export function ControlRouter(baseUrl: string) {
     }
   };
 
+  const fetchHoldersCount = async (): Promise<number> => {
+    try {
+      const data = await request<HoldersCountResponse>(`/holders/count`);
+      return data.holders;
+    } catch (error) {
+      throw new Error(parseApiError(error));
+    }
+  };
+
   // Build pagination query helper
   const buildPaginationQuery = (page?: number, limit?: number) => {
     const p = page ?? 1;
@@ -225,6 +250,21 @@ export function ControlRouter(baseUrl: string) {
     }
   };
 
+  const fetchFarmRewardSplits = async (
+    farmId: string
+  ): Promise<FarmRewardSplit[]> => {
+    try {
+      if (!farmId) throw new Error("Farm ID is required");
+      const data = await request<
+        FarmRewardSplitsResponse | FarmRewardSplitsErrorResponse
+      >(`/farms/${encodeURIComponent(farmId)}/reward-splits`);
+      if ("error" in data) throw new Error(data.error);
+      return data.rewardSplits ?? [];
+    } catch (error) {
+      throw new Error(parseApiError(error));
+    }
+  };
+
   // Exposed query with error parsing
   const getTransferDetails = async (txId: string): Promise<TransferDetails> => {
     try {
@@ -399,7 +439,7 @@ export function ControlRouter(baseUrl: string) {
 
   const retryFailedOperation = async (
     operationId: string
-  ): Promise<boolean> => {
+  ): Promise<RetryFailedOperationResponse> => {
     isRetryingFailedOperation = true;
     try {
       sentryAddBreadcrumb({
@@ -408,11 +448,14 @@ export function ControlRouter(baseUrl: string) {
         level: "info",
         data: { baseUrl, operationId },
       });
-      await request(`/operations/failed/${operationId}/retry`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-      });
-      return true;
+      const response = await request<RetryFailedOperationResponse>(
+        `/operations/failed/${operationId}/retry`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+        }
+      );
+      return response;
     } catch (error) {
       sentryCaptureException(error, {
         action: "retryFailedOperation",
@@ -520,6 +563,7 @@ export function ControlRouter(baseUrl: string) {
     fetchGctlPrice,
     fetchGlwPrice,
     fetchCirculatingSupply,
+    fetchHoldersCount,
     fetchLastNonce,
     fetchMintedEvents,
     fetchStakeEvents,
@@ -531,6 +575,7 @@ export function ControlRouter(baseUrl: string) {
     fetchWalletRegionCommittedBalance,
     fetchTransferDetails: getTransferDetails,
     fetchGlwRegionRewards,
+    fetchFarmRewardSplits,
     fetchMigrationAmount,
 
     // Mutations

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

@@ -9,6 +9,7 @@ import type {
   RegionDetails,
   SponsoredFarm,
   ActiveRegionsSummaryResponse,
+  RecentRegionActivityResponse,
   InstallerApplicationPayload,
   InstallerApplicationResponse,
 } from "../types";
@@ -133,6 +134,17 @@ export function RegionRouter(baseUrl: string) {
       }
     };
 
+  const fetchRecentActivity =
+    async (): Promise<RecentRegionActivityResponse> => {
+      try {
+        return await request<RecentRegionActivityResponse>(
+          `/regions/active/recent-activity`
+        );
+      } catch (error) {
+        throw new Error(parseApiError(error));
+      }
+    };
+
   const applyInstallerCertification = async (
     payload: InstallerApplicationPayload
   ): Promise<InstallerApplicationResponse> => {
@@ -205,6 +217,7 @@ export function RegionRouter(baseUrl: string) {
     fetchRegionByIdOrSlug,
     fetchRegionSolarFarms,
     fetchActiveSummary,
+    fetchRecentActivity,
     getRegionByCode,
     applyInstallerCertification,
 

package/src/lib/types/index.ts

@@ -377,18 +377,17 @@ export interface RegionDetails extends RegionWithMetadata {
   carbonCreditsPerWeek: number;
 }
 
-export interface ActiveRegionStakeEvent {
-  id: string;
-  regionId: number;
-  wallet: string;
+export interface ActiveRegionDataPoint {
   epoch: number;
-  amount: string;
-  direction: string;
-  ts: string; // ISO 8601 timestamp
-  processed: boolean;
-  progressClaimed: string;
-  progressMoved: string;
-  actionSignatureData: unknown | null;
+  timestamp: number;
+  gctlStaked: string;
+  pendingUnstake: string;
+  pendingRestakeOut: string;
+  pendingRestakeIn: string;
+  netPending: string;
+  eventCount: number;
+  firstEventTimestamp?: number;
+  lastEventTimestamp?: number;
 }
 
 export interface ActiveRegionSummary {
@@ -397,21 +396,49 @@ export interface ActiveRegionSummary {
   code: string;
   slug: string;
   isUs: boolean;
-  gctlStaked: string;
+  currentGctlStaked: string;
   glwRewardPerWeek: string;
   rewardShare: string;
-  pendingUnstake: string;
-  pendingRestakeOut: string;
-  pendingRestakeIn: string;
-  events: ActiveRegionStakeEvent[];
+  data: ActiveRegionDataPoint[];
 }
 
 export interface ActiveRegionsSummaryResponse {
+  metadata: {
+    epochs: number[];
+    epochTimestamps: { [epoch: string]: number };
+    currentEpoch: number;
+  };
   total: {
     totalGctlStaked: string;
     totalGlwRewards: string;
   };
   regions: ActiveRegionSummary[];
+  aggregate: {
+    epochs: number[];
+    timestamps: number[];
+    totalGctlStaked: string[];
+    totalPendingUnstake: string[];
+    totalNetPending: string[];
+  };
+}
+
+export interface RegionActivityPeriod {
+  stakes: number;
+  unstakes: number;
+  restakes: number;
+  immediateUnstakes: number;
+  netChange: string; // atomic units (can be negative)
+}
+
+export interface RegionActivity {
+  regionId: number;
+  regionName: string;
+  last24h: RegionActivityPeriod;
+  last7d: RegionActivityPeriod;
+}
+
+export interface RecentRegionActivityResponse {
+  activity: RegionActivity[];
 }
 
 export interface InstallerApplicationPayload {
@@ -703,6 +730,15 @@ export interface FarmRewardSplitsErrorResponse {
   error: string;
 }
 
+export interface HoldersCountResponse {
+  holders: number;
+}
+
+export interface RetryFailedOperationResponse {
+  success?: boolean;
+  queued?: boolean;
+}
+
 // ---------------------------------------------------------------------------
 // Barrel exports (convenience)
 // ---------------------------------------------------------------------------