@carrot-protocol/boost-http-client 0.4.5 → 0.4.6

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { AnchorProvider, web3 } from "@coral-xyz/anchor";
-import { GetBankResponse, GetUserResponse, GetGroupResponse, GetUserRequest, GetGroupsResponse, GetAccountResponse, GetAccountRequest } from "./types";
+import { GetBankResponse, GetUserResponse, GetGroupResponse, GetUserRequest, GetGroupsResponse, GetAccountResponse, GetAccountRequest, GetWalletBalancesRequest, GetWalletBalancesResponse } from "./types";
 import { ApiClient } from "./api";
 import { PositionChartingExtension } from "./charting/position";
 import { BankChartingExtension } from "./charting/bank";
@@ -79,6 +79,12 @@ export declare class Client extends ApiClient {
      * @returns Withdraw emissions operation result
      */
     withdrawEmissions(clendAccount: web3.PublicKey): Promise<string>;
+    /**
+     * Get wallet balances timeseries grouped by group
+     * @param request Optional filters for groups, time range, and aggregation
+     * @returns Wallet balances grouped by group with timeseries data
+     */
+    getWalletBalances(request?: GetWalletBalancesRequest): Promise<GetWalletBalancesResponse>;
     getPerformanceChartingExtension(clendAccount: web3.PublicKey): Promise<PositionChartingExtension>;
     getGroupChartingExtension(group: web3.PublicKey): Promise<GroupChartingExtension>;
     getWalletChartingExtension(address?: web3.PublicKey): Promise<WalletChartingExtension>;

package/dist/index.js

@@ -451,6 +451,37 @@ class Client extends api_1.ApiClient {
         const txSig = await this.send(withdrawEmissionsResponse.unsignedBase64Tx, withdrawEmissionsResponse.userRequestId, req.useJito);
         return txSig;
     }
+    /**
+     * Get wallet balances timeseries grouped by group
+     * @param request Optional filters for groups, time range, and aggregation
+     * @returns Wallet balances grouped by group with timeseries data
+     */
+    async getWalletBalances(request = {}) {
+        const { groups, fromTime, toTime, aggregationMethod } = request;
+        const body = await this.handleApiCall(() => this.http.get(`/analytics/wallet-balances`, {
+            params: {
+                groups: groups?.map((g) => g.toString()).join(","),
+                fromTime: fromTime?.toISOString(),
+                toTime: toTime?.toISOString(),
+                aggregationMethod,
+            },
+        }));
+        const jsonResponse = JSON.parse(body);
+        const response = {
+            groups: jsonResponse.groups.map((groupData) => ({
+                group: new anchor_1.web3.PublicKey(groupData.group),
+                groupName: groupData.groupName,
+                wallets: groupData.wallets.map((walletData) => ({
+                    authority: new anchor_1.web3.PublicKey(walletData.authority),
+                    timeseries: walletData.timeseries.map((ts) => ({
+                        time: new Date(ts.time),
+                        netValue: Number(ts.netValue),
+                    })),
+                })),
+            })),
+        };
+        return response;
+    }
     async getPerformanceChartingExtension(clendAccount) {
         return new position_1.PositionChartingExtension(this.baseUrl, clendAccount);
     }

package/dist/types.d.ts

@@ -272,3 +272,25 @@ export type ChartingOptions = DateRangeOptions & {
 };
 export type ExtensionKey = "positionCharting" | "groupCharting" | "walletCharting" | "bankCharting";
 export type Extension = InstanceType<typeof PositionChartingExtension> | InstanceType<typeof GroupChartingExtension> | InstanceType<typeof WalletChartingExtension> | InstanceType<typeof BankChartingExtension>;
+export interface GetWalletBalancesRequest {
+    groups?: web3.PublicKey[];
+    fromTime?: Date;
+    toTime?: Date;
+    aggregationMethod?: AggregationMethod;
+}
+export interface WalletBalancesTimeseries {
+    time: Date;
+    netValue: number;
+}
+export interface WalletBalances {
+    authority: web3.PublicKey;
+    timeseries: WalletBalancesTimeseries[];
+}
+export interface GroupWalletBalances {
+    group: web3.PublicKey;
+    groupName: string;
+    wallets: WalletBalances[];
+}
+export interface GetWalletBalancesResponse {
+    groups: GroupWalletBalances[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carrot-protocol/boost-http-client",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "HTTP client for Carrot Boost",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,4 +28,4 @@
     "@carrot-protocol/clend-common": "^0.1.0",
     "@coral-xyz/anchor": "^0.29.0"
   }
-}
+}

package/src/index.ts

@@ -32,6 +32,11 @@ import {
   WithdrawResponse,
   GetAccountResponse,
   GetAccountRequest,
+  GetWalletBalancesRequest,
+  GetWalletBalancesResponse,
+  GroupWalletBalances,
+  WalletBalances,
+  WalletBalancesTimeseries,
 } from "./types";
 import encode from "bs58";
 import { ApiClient } from "./api";
@@ -643,6 +648,52 @@ export class Client extends ApiClient {
     return txSig;
   }
 
+  /**
+   * Get wallet balances timeseries grouped by group
+   * @param request Optional filters for groups, time range, and aggregation
+   * @returns Wallet balances grouped by group with timeseries data
+   */
+  async getWalletBalances(
+    request: GetWalletBalancesRequest = {},
+  ): Promise<GetWalletBalancesResponse> {
+    const { groups, fromTime, toTime, aggregationMethod } = request;
+
+    const body = await this.handleApiCall(() =>
+      this.http.get(`/analytics/wallet-balances`, {
+        params: {
+          groups: groups?.map((g) => g.toString()).join(","),
+          fromTime: fromTime?.toISOString(),
+          toTime: toTime?.toISOString(),
+          aggregationMethod,
+        },
+      }),
+    );
+
+    const jsonResponse: any = JSON.parse(body);
+
+    const response: GetWalletBalancesResponse = {
+      groups: jsonResponse.groups.map(
+        (groupData: any): GroupWalletBalances => ({
+          group: new web3.PublicKey(groupData.group),
+          groupName: groupData.groupName,
+          wallets: groupData.wallets.map(
+            (walletData: any): WalletBalances => ({
+              authority: new web3.PublicKey(walletData.authority),
+              timeseries: walletData.timeseries.map(
+                (ts: any): WalletBalancesTimeseries => ({
+                  time: new Date(ts.time),
+                  netValue: Number(ts.netValue),
+                }),
+              ),
+            }),
+          ),
+        }),
+      ),
+    };
+
+    return response;
+  }
+
   public async getPerformanceChartingExtension(
     clendAccount: web3.PublicKey,
   ): Promise<PositionChartingExtension> {

package/src/types.ts

@@ -321,3 +321,31 @@ export type Extension =
   | InstanceType<typeof GroupChartingExtension>
   | InstanceType<typeof WalletChartingExtension>
   | InstanceType<typeof BankChartingExtension>;
+
+// Analytics types
+export interface GetWalletBalancesRequest {
+  groups?: web3.PublicKey[];
+  fromTime?: Date;
+  toTime?: Date;
+  aggregationMethod?: AggregationMethod;
+}
+
+export interface WalletBalancesTimeseries {
+  time: Date;
+  netValue: number;
+}
+
+export interface WalletBalances {
+  authority: web3.PublicKey;
+  timeseries: WalletBalancesTimeseries[];
+}
+
+export interface GroupWalletBalances {
+  group: web3.PublicKey;
+  groupName: string;
+  wallets: WalletBalances[];
+}
+
+export interface GetWalletBalancesResponse {
+  groups: GroupWalletBalances[];
+}