@glowlabs-org/utils 0.2.151 → 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-Cpy_o4_u.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-Cpy_o4_u.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/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,14 +311,17 @@ export interface RegionDetails extends RegionWithMetadata {
     carbonCreditsIssued: number;
     carbonCreditsPerWeek: number;
 }
-export interface ActiveRegionSnapshot {
+export interface ActiveRegionDataPoint {
     epoch: number;
-    totals: {
-        gctlStaked: string;
-        pendingUnstake: string;
-        pendingRestakeOut: string;
-        pendingRestakeIn: string;
-    };
+    timestamp: number;
+    gctlStaked: string;
+    pendingUnstake: string;
+    pendingRestakeOut: string;
+    pendingRestakeIn: string;
+    netPending: string;
+    eventCount: number;
+    firstEventTimestamp?: number;
+    lastEventTimestamp?: number;
 }
 export interface ActiveRegionSummary {
     id: number;
@@ -326,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;
-    snapshots: ActiveRegionSnapshot[];
+    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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glowlabs-org/utils",
-  "version": "0.2.151",
+  "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/region-router.ts

@@ -1,58 +1,5 @@
 "use strict";
 
-/**
- * # Regions Router
- *
- * This router wraps the Control API endpoints that power Kickstarter-style
- * activation across geographic regions. It surfaces read APIs for activation
- * progress plus the installer certification mutation.
- *
- * ## Components
- * - **router.ts**: exports the `RegionRouter` factory with helpers for each
- *   endpoint:
- *   - `GET /regions/all` – list regions with activation progress (stake, farms,
- *     installers). Accepts optional `?isActive=true|false` filter.
- *   - `GET /regions/:idOrSlug` – return region VCR view.
- *   - `GET /regions/active/summary` – aggregate GLW/week distribution, pending
- *     restakes, and recent epoch snapshots for active regions.
- *   - `GET /regions/solar-farms/:regionId` – list sponsored farms for a region.
- *   - `POST /regions/installers/apply` – certify an installer via signature.
- *   - `GET /regions/activation-events` – activation-event timeline, optional
- *     `regionId` filter.
- *   - `GET /regions/activation-config` – static activation thresholds and
- *     campaign duration for a region code.
- * - **getters.ts**: shared data aggregation utilities used by the router
- *   implementation.
- * - **db/schema.ts**: Drizzle schema for `regions`, `region_kickstarters`,
- *   `solar_farms`, `certified_installers`, and `region_activation_events`.
- * - **constants**: activation thresholds imported from `@src/constants`:
- *   ```ts
- *   import {
- *     MIN_FARMS,
- *     US_STAKE_THRESHOLD,
- *     NON_US_STAKE_THRESHOLD,
- *     CAMPAIGN_DURATION_DAYS,
- *     MIN_INSTALLERS,
- *     US_STAKED_TRESHOLD_BIGINT,
- *     NON_US_STAKED_TRESHOLD_BIGINT,
- *   } from "@src/constants";
- *   ```
- * - Region metadata: `regionMetadata` from `@glowlabs-org/utils/browser` feeds
- *   `/activation-config` responses.
- * - Kickstarter endpoints live in `KickstarterRouter`.
- *
- * ## Activation Criteria
- * A region activates when it satisfies all of:
- * 1. Stake threshold met (≥ 20 000 GCTL for US, ≥ 200 000 GCTL otherwise).
- * 2. At least 10 solar farms registered.
- * 3. At least 1 certified installer.
- *
- * ## API Responses
- * All numeric stake values are returned as strings (atomic units) to avoid
- * precision loss. Dates are ISO 8601 strings. The router exposes typed helpers
- * for the full dataset described above.
- */
-
 import { generateSlug } from "src/utils/generate-slug";
 import { regionMetadata } from "../region-metadata";
 import type {
@@ -62,6 +9,7 @@ import type {
   RegionDetails,
   SponsoredFarm,
   ActiveRegionsSummaryResponse,
+  RecentRegionActivityResponse,
   InstallerApplicationPayload,
   InstallerApplicationResponse,
 } from "../types";
@@ -186,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> => {
@@ -258,6 +217,7 @@ export function RegionRouter(baseUrl: string) {
     fetchRegionByIdOrSlug,
     fetchRegionSolarFarms,
     fetchActiveSummary,
+    fetchRecentActivity,
     getRegionByCode,
     applyInstallerCertification,
 

package/src/lib/types/index.ts

@@ -377,14 +377,17 @@ export interface RegionDetails extends RegionWithMetadata {
   carbonCreditsPerWeek: number;
 }
 
-export interface ActiveRegionSnapshot {
+export interface ActiveRegionDataPoint {
   epoch: number;
-  totals: {
-    gctlStaked: string;
-    pendingUnstake: string;
-    pendingRestakeOut: string;
-    pendingRestakeIn: string;
-  };
+  timestamp: number;
+  gctlStaked: string;
+  pendingUnstake: string;
+  pendingRestakeOut: string;
+  pendingRestakeIn: string;
+  netPending: string;
+  eventCount: number;
+  firstEventTimestamp?: number;
+  lastEventTimestamp?: number;
 }
 
 export interface ActiveRegionSummary {
@@ -393,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;
-  snapshots: ActiveRegionSnapshot[];
+  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 {