@glowlabs-org/utils 0.2.121 → 0.2.122

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

@@ -1,9 +1,10 @@
-import type { Kickstarter, CreateKickstarterPayload, KickstarterCreateResponse, CommitKickstarterPayload, CommitKickstarterResponse, KickstarterDetails } from "../types";
+import type { Kickstarter, CreateKickstarterPayload, KickstarterCreateResponse, CommitKickstarterPayload, CommitKickstarterResponse, KickstarterDetails, KickstarterCommitmentsQuery, KickstarterCommitmentsResponse } from "../types";
 export declare function KickstarterRouter(baseUrl: string): {
     readonly fetchKickstarters: () => Promise<Kickstarter[]>;
     readonly fetchKickstarter: (idOrSlug: string) => Promise<KickstarterDetails>;
     readonly fetchKickstartersByWallet: (wallet: string) => Promise<Kickstarter[]>;
     readonly commitKickstarter: (kickstarterId: string, payload: CommitKickstarterPayload) => Promise<CommitKickstarterResponse>;
     readonly createKickstarter: (payload: CreateKickstarterPayload) => Promise<KickstarterCreateResponse>;
+    readonly fetchRegionCommitments: (regionId: number, query?: KickstarterCommitmentsQuery) => Promise<KickstarterCommitmentsResponse>;
     readonly isCreatingKickstarter: boolean;
 };

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

@@ -237,6 +237,25 @@ export interface CommitKickstarterResponse {
     success: true;
     regionId: number;
 }
+export interface KickstarterCommitmentEvent {
+    id: string;
+    epoch: number;
+    wallet: string;
+    regionId: number;
+    amount: string;
+    ts: string;
+    isFinalized: boolean;
+}
+export interface KickstarterCommitmentsQuery {
+    page?: number;
+    limit?: number;
+    finalized?: boolean;
+}
+export interface KickstarterCommitmentsResponse {
+    page: number;
+    limit: number;
+    events: KickstarterCommitmentEvent[];
+}
 export interface ActivationEvent {
     id: string;
     regionId: number;

package/package.json

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

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

@@ -8,6 +8,8 @@ import type {
   CommitKickstarterPayload,
   CommitKickstarterResponse,
   KickstarterDetails,
+  KickstarterCommitmentsQuery,
+  KickstarterCommitmentsResponse,
 } from "../types";
 
 function parseApiError(error: unknown): string {
@@ -109,12 +111,40 @@ export function KickstarterRouter(baseUrl: string) {
     }
   };
 
+  // Build pagination query helper
+  const buildPaginationQuery = (page?: number, limit?: number) => {
+    const p = page ?? 1;
+    const l = limit ?? 50;
+    return `?page=${p}&limit=${l}`;
+  };
+
+  const fetchRegionCommitments = async (
+    regionId: number,
+    query?: KickstarterCommitmentsQuery
+  ): Promise<KickstarterCommitmentsResponse> => {
+    try {
+      const base = `/kickstarters/region/${regionId}/commitments${buildPaginationQuery(
+        query?.page,
+        query?.limit
+      )}`;
+      const finalQuery =
+        query?.finalized !== undefined
+          ? `${base}&finalized=${query.finalized}`
+          : base;
+      const data = await request<KickstarterCommitmentsResponse>(finalQuery);
+      return data;
+    } catch (error) {
+      throw new Error(parseApiError(error));
+    }
+  };
+
   return {
     fetchKickstarters,
     fetchKickstarter,
     fetchKickstartersByWallet,
     commitKickstarter,
     createKickstarter,
+    fetchRegionCommitments,
     get isCreatingKickstarter() {
       return isCreatingKickstarter;
     },

package/src/lib/types/index.ts

@@ -293,6 +293,28 @@ export interface CommitKickstarterResponse {
   regionId: number;
 }
 
+export interface KickstarterCommitmentEvent {
+  id: string;
+  epoch: number;
+  wallet: string;
+  regionId: number;
+  amount: string; // atomic GCTL (6 decimals)
+  ts: string; // ISO 8601
+  isFinalized: boolean;
+}
+
+export interface KickstarterCommitmentsQuery {
+  page?: number; // default 1
+  limit?: number; // default 50, max 100
+  finalized?: boolean; // optional filter on isFinalized
+}
+
+export interface KickstarterCommitmentsResponse {
+  page: number;
+  limit: number;
+  events: KickstarterCommitmentEvent[];
+}
+
 export interface ActivationEvent {
   id: string;
   regionId: number;