@carrot-protocol/boost-http-client 0.3.3 → 0.4.0-stub-position-endpoints-dev-666335f

package/dist/api/index.d.ts

@@ -0,0 +1,14 @@
+import { AxiosInstance, AxiosResponse } from "axios";
+/**
+ * Base API Client
+ */
+export declare class ApiClient {
+    protected readonly baseUrl: string;
+    protected readonly http: AxiosInstance;
+    /**
+     * Create a new API client
+     * @param baseUrl Base URL for the API
+     */
+    constructor(baseUrl: string);
+    protected handleApiCall<T>(call: () => Promise<AxiosResponse<T>>): Promise<string>;
+}

package/dist/api/index.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+/**
+ * Base API Client
+ */
+class ApiClient {
+    /**
+     * Create a new API client
+     * @param baseUrl Base URL for the API
+     */
+    constructor(baseUrl) {
+        this.baseUrl = new URL(baseUrl).toString();
+        this.http = axios_1.default.create({
+            baseURL: this.baseUrl,
+            headers: {
+                "Content-Type": "application/json",
+            },
+        });
+    }
+    // Helper function to handle API calls
+    async handleApiCall(call) {
+        try {
+            const { data } = await call();
+            return JSON.stringify(data);
+        }
+        catch (e) {
+            if (axios_1.default.isAxiosError(e)) {
+                const res = e.response;
+                if (res && typeof res.data === "object") {
+                    const payload = res.data;
+                    throw new Error(`${payload.error}${payload.details ? ` ${payload.details}` : ""}`);
+                }
+                throw new Error(`${e.message}`);
+            }
+            throw e;
+        }
+    }
+}
+exports.ApiClient = ApiClient;

package/dist/api/types.d.ts

@@ -0,0 +1,6 @@
+export type ApiErrorPayload = {
+    error: string;
+    details?: unknown;
+    path: string;
+    timestamp: string;
+};

package/dist/api/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/charting/bank/index.d.ts

@@ -0,0 +1,11 @@
+import { web3 } from "@coral-xyz/anchor";
+import { ApyResponse } from "./types";
+import { ApiClient } from "../../api";
+export declare class BankChartingExtension extends ApiClient {
+    private readonly bank;
+    constructor(baseUrl: string, bank: web3.PublicKey);
+    getApy(options?: {
+        fromTime?: Date;
+        toTime?: Date;
+    }): Promise<ApyResponse[]>;
+}

package/dist/charting/bank/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BankChartingExtension = void 0;
+const api_1 = require("../../api");
+class BankChartingExtension extends api_1.ApiClient {
+    constructor(baseUrl, bank) {
+        super(baseUrl);
+        this.bank = bank;
+    }
+    async getApy(options = {}) {
+        const body = await this.handleApiCall(() => this.http.get(`/bank/apys`, {
+            params: {
+                bank: this.bank.toString(),
+                fromTime: options.fromTime?.toISOString(),
+                toTime: options.toTime?.toISOString(),
+            },
+        }));
+        const response = JSON.parse(body).map((apy) => ({
+            time: new Date(apy.time),
+            assetApy: Number(apy.supply_apy),
+            liabilityApy: Number(apy.borrow_apy),
+        }));
+        return response;
+    }
+}
+exports.BankChartingExtension = BankChartingExtension;

package/dist/charting/bank/types.d.ts

@@ -0,0 +1,5 @@
+export interface ApyResponse {
+    time: Date;
+    assetApy: number;
+    liabilityApy: number;
+}

package/dist/charting/bank/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/charting/group/index.d.ts

@@ -0,0 +1,11 @@
+import { web3 } from "@coral-xyz/anchor";
+import { PerformanceResponse } from "./types";
+import { ApiClient } from "../../api";
+export declare class GroupChartingExtension extends ApiClient {
+    private readonly group;
+    constructor(baseUrl: string, group: web3.PublicKey);
+    getPerformance(options?: {
+        fromTime?: Date;
+        toTime?: Date;
+    }): Promise<PerformanceResponse[]>;
+}

package/dist/charting/group/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupChartingExtension = void 0;
+const api_1 = require("../../api");
+class GroupChartingExtension extends api_1.ApiClient {
+    constructor(baseUrl, group) {
+        super(baseUrl);
+        this.group = group;
+    }
+    async getPerformance(options = {}) {
+        const body = await this.handleApiCall(() => this.http.get(`/group/pnls`, {
+            params: {
+                group: this.group.toString(),
+                fromTime: options.fromTime?.toISOString(),
+                toTime: options.toTime?.toISOString(),
+            },
+        }));
+        const response = JSON.parse(body).map((performance) => ({
+            time: new Date(performance.time),
+            costBasis: Number(performance.cost_basis),
+            netValueValue: Number(performance.net_value_value),
+            pnlValue: Number(performance.pnl_value),
+        }));
+        return response;
+    }
+}
+exports.GroupChartingExtension = GroupChartingExtension;

package/dist/charting/group/types.d.ts

@@ -0,0 +1,6 @@
+export interface PerformanceResponse {
+    time: Date;
+    costBasis: number;
+    netValueValue: number;
+    pnlValue: number;
+}

package/dist/charting/group/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/charting/position/index.d.ts

@@ -0,0 +1,19 @@
+import { web3 } from "@coral-xyz/anchor";
+import { ApyResponse, LoanBalanceResponse, PerformanceResponse } from "./types";
+import { ApiClient } from "../../api";
+export declare class PositionChartingExtension extends ApiClient {
+    private readonly clendAccount;
+    constructor(baseUrl: string, clendAccount: web3.PublicKey);
+    getLoanBalance(options?: {
+        fromTime?: Date;
+        toTime?: Date;
+    }): Promise<LoanBalanceResponse[]>;
+    getPerformance(options?: {
+        fromTime?: Date;
+        toTime?: Date;
+    }): Promise<PerformanceResponse[]>;
+    getApy(options?: {
+        fromTime?: Date;
+        toTime?: Date;
+    }): Promise<ApyResponse[]>;
+}

package/dist/charting/position/index.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PositionChartingExtension = void 0;
+const api_1 = require("../../api");
+class PositionChartingExtension extends api_1.ApiClient {
+    constructor(baseUrl, clendAccount) {
+        super(baseUrl);
+        this.clendAccount = clendAccount;
+    }
+    async getLoanBalance(options = {}) {
+        const body = await this.handleApiCall(() => this.http.get(`/account/balances`, {
+            params: {
+                account: this.clendAccount.toString(),
+                fromTime: options.fromTime?.toISOString(),
+                toTime: options.toTime?.toISOString(),
+            },
+        }));
+        const response = JSON.parse(body).map((balance) => ({
+            time: new Date(balance.time),
+            netAssetBalanceValue: Number(balance.net_asset_balance_value),
+            netLiabilityBalanceValue: Number(balance.net_liability_balance_value),
+            netValueValue: Number(balance.net_value_value),
+            notionalLeverage: Number(balance.notional_leverage),
+        }));
+        return response;
+    }
+    async getPerformance(options = {}) {
+        const body = await this.handleApiCall(() => this.http.get(`/account/performance`, {
+            params: {
+                account: this.clendAccount.toString(),
+                fromTime: options.fromTime?.toISOString(),
+                toTime: options.toTime?.toISOString(),
+            },
+        }));
+        const response = JSON.parse(body).map((performance) => ({
+            time: new Date(performance.time),
+            costBasis: Number(performance.cost_basis),
+            netValueValue: Number(performance.net_value_value),
+            pnlValue: Number(performance.pnl_value),
+        }));
+        return response;
+    }
+    async getApy(options = {}) {
+        const body = await this.handleApiCall(() => this.http.get(`/account/apys`, {
+            params: {
+                account: this.clendAccount.toString(),
+                fromTime: options.fromTime?.toISOString(),
+                toTime: options.toTime?.toISOString(),
+            },
+        }));
+        const response = JSON.parse(body).map((apy) => ({
+            time: new Date(apy.time),
+            assetApy: Number(apy.asset_apy),
+            liabilityApy: Number(apy.liability_apy),
+            netApy: Number(apy.net_apy),
+        }));
+        return response;
+    }
+}
+exports.PositionChartingExtension = PositionChartingExtension;

package/dist/charting/position/types.d.ts

@@ -0,0 +1,19 @@
+export interface LoanBalanceResponse {
+    time: Date;
+    netAssetBalanceValue: number;
+    netLiabilityBalanceValue: number;
+    netValueValue: number;
+    notionalLeverage: number;
+}
+export interface PerformanceResponse {
+    time: Date;
+    costBasis: number;
+    netValueValue: number;
+    pnlValue: number;
+}
+export interface ApyResponse {
+    time: Date;
+    assetApy: number;
+    liabilityApy: number;
+    netApy: number;
+}

package/dist/charting/position/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/charting/wallet/index.d.ts

@@ -0,0 +1,11 @@
+import { web3 } from "@coral-xyz/anchor";
+import { PerformanceResponse } from "./types";
+import { ApiClient } from "../../api";
+export declare class WalletChartingExtension extends ApiClient {
+    private readonly address;
+    constructor(baseUrl: string, address: web3.PublicKey);
+    getPerformance(options?: {
+        fromTime?: Date;
+        toTime?: Date;
+    }): Promise<PerformanceResponse[]>;
+}

package/dist/charting/wallet/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletChartingExtension = void 0;
+const api_1 = require("../../api");
+class WalletChartingExtension extends api_1.ApiClient {
+    constructor(baseUrl, address) {
+        super(baseUrl);
+        this.address = address;
+    }
+    async getPerformance(options = {}) {
+        const body = await this.handleApiCall(() => this.http.get(`/user/pnls`, {
+            params: {
+                authority: this.address.toString(),
+                fromTime: options.fromTime?.toISOString(),
+                toTime: options.toTime?.toISOString(),
+            },
+        }));
+        const response = JSON.parse(body).map((performance) => ({
+            time: new Date(performance.time),
+            costBasis: Number(performance.cost_basis),
+            netValueValue: Number(performance.net_value_value),
+            pnlValue: Number(performance.pnl_value),
+        }));
+        return response;
+    }
+}
+exports.WalletChartingExtension = WalletChartingExtension;

package/dist/charting/wallet/types.d.ts

@@ -0,0 +1,6 @@
+export interface PerformanceResponse {
+    time: Date;
+    costBasis: number;
+    netValueValue: number;
+    pnlValue: number;
+}

package/dist/charting/wallet/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -1,14 +1,17 @@
 import { AnchorProvider, web3 } from "@coral-xyz/anchor";
-import { GetBankResponse, GetUserResponse, GetGroupResponse, GetGroupsResponse, GetAccountResponse, GetAccountRequest } from "./types";
+import { GetBankResponse, GetUserResponse, GetGroupResponse, GetUserRequest, GetGroupsResponse, GetAccountResponse, GetAccountRequest, ExtensionKey } from "./types";
+import { ApiClient } from "./api";
+import { PositionChartingExtension } from "./charting/position";
+import { BankChartingExtension } from "./charting/bank";
+import { WalletChartingExtension } from "./charting/wallet";
+import { GroupChartingExtension } from "./charting/group";
 export * from "./types";
 export * from "./utils";
 export * as Common from "@carrot-protocol/clend-common";
 /**
  * HTTP Client for Carrot Boost API
  */
-export declare class Client {
-    private readonly baseUrl;
-    private readonly http;
+export declare class Client extends ApiClient {
     private readonly provider;
     private readonly dryRun;
     /**
@@ -32,7 +35,7 @@ export declare class Client {
      */
     private parseClendAccountSummary;
     private parseClendAccountWithSummary;
-    getUser(user: web3.PublicKey, groups: web3.PublicKey[], getClendAccountSummary: boolean): Promise<GetUserResponse>;
+    getUser(user: GetUserRequest["user"], groups: GetUserRequest["groups"], getClendAccountSummary: GetUserRequest["getClendAccountSummary"]): Promise<GetUserResponse>;
     /**
      * Get all groups
      * @param includeBankData Whether to include bank data in the response, if not strictly necessary keep false
@@ -76,4 +79,5 @@ export declare class Client {
      * @returns Withdraw emissions operation result
      */
     withdrawEmissions(clendAccount: web3.PublicKey): Promise<string>;
+    getExtension(extension: ExtensionKey): Promise<((clendAccount: web3.PublicKey) => PositionChartingExtension) | ((group: web3.PublicKey) => GroupChartingExtension) | ((address?: web3.PublicKey) => WalletChartingExtension) | ((bank: web3.PublicKey) => BankChartingExtension)>;
 }

package/dist/index.js

@@ -40,9 +40,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Client = exports.Common = void 0;
-const axios_1 = __importDefault(require("axios"));
 const anchor_1 = require("@coral-xyz/anchor");
 const bs58_1 = __importDefault(require("bs58"));
+const api_1 = require("./api");
+const position_1 = require("./charting/position");
+const bank_1 = require("./charting/bank");
+const wallet_1 = require("./charting/wallet");
+const group_1 = require("./charting/group");
 // Re-export types
 __exportStar(require("./types"), exports);
 __exportStar(require("./utils"), exports);
@@ -51,19 +55,13 @@ exports.Common = __importStar(require("@carrot-protocol/clend-common"));
 /**
  * HTTP Client for Carrot Boost API
  */
-class Client {
+class Client extends api_1.ApiClient {
     /**
      * Create a new Carrot Boost API client
      * @param baseUrl Base URL for the API
      */
     constructor(baseUrl, provider, dryRun) {
-        this.baseUrl = new URL(baseUrl).toString();
-        this.http = axios_1.default.create({
-            baseURL: this.baseUrl,
-            headers: {
-                "Content-Type": "application/json",
-            },
-        });
+        super(baseUrl);
         if (!provider) {
             provider = getDummyProvider();
         }
@@ -95,7 +93,7 @@ class Client {
             txns: [encodedAndSignedTx],
         };
         // send to api
-        await handleApiCall(() => this.http.post(`send`, sendRequest));
+        await this.handleApiCall(() => this.http.post(`send`, sendRequest));
         // return txsig
         return bs58_1.default.encode(txSig);
     }
@@ -104,13 +102,18 @@ class Client {
      * @returns Index details
      */
     async index() {
-        return handleApiCall(() => this.http.get(""));
+        return this.handleApiCall(() => this.http.get(""));
     }
     /**
      * Fetch and parse a single clend account by pubkey
      */
     async getAccount(account, getClendAccountSummary) {
-        const body = await handleApiCall(() => this.http.get(`/account?account=${account.toString()}&getClendAccountSummary=${getClendAccountSummary}`));
+        const body = await this.handleApiCall(() => this.http.get(`/account`, {
+            params: {
+                account: account.toString(),
+                getClendAccountSummary,
+            },
+        }));
         const jsonRawResponse = JSON.parse(body);
         return this.parseClendAccountWithSummary(jsonRawResponse, getClendAccountSummary);
     }
@@ -222,7 +225,13 @@ class Client {
     }
     async getUser(user, groups, getClendAccountSummary) {
         // Make the API call to fetch the raw user data as a string.
-        const body = await handleApiCall(() => this.http.get(`/user?user=${user.toString()}&groups=${groups.map((g) => g.toString()).join(",")}&getClendAccountSummary=${getClendAccountSummary}`));
+        const body = await this.handleApiCall(() => this.http.get(`/user`, {
+            params: {
+                user: user.toString(),
+                groups: groups.map((g) => g.toString()).join(","),
+                getClendAccountSummary,
+            },
+        }));
         // Parse the raw string body into a JSON object.
         const jsonRawResponse = JSON.parse(body);
         // 1. Parse Wallet Balances
@@ -251,7 +260,11 @@ class Client {
      * @returns All groups
      */
     async getGroups(includeBankData) {
-        const body = await handleApiCall(() => this.http.get(`/groups?includeBankData=${includeBankData}`));
+        const body = await this.handleApiCall(() => this.http.get(`/groups`, {
+            params: {
+                includeBankData,
+            },
+        }));
         const marketJson = JSON.parse(body);
         const groups = [];
         for (const groupJson of marketJson.groups) {
@@ -275,7 +288,11 @@ class Client {
      * @returns Group Details, which is really just all the bank data for that group
      */
     async getGroup(groupAddress) {
-        const body = await handleApiCall(() => this.http.get(`/group?group=${groupAddress.toString()}`));
+        const body = await this.handleApiCall(() => this.http.get(`/group`, {
+            params: {
+                group: groupAddress.toString(),
+            },
+        }));
         const marketJson = JSON.parse(body);
         const group = {
             group: new anchor_1.web3.PublicKey(marketJson.group.group),
@@ -297,7 +314,11 @@ class Client {
      * @returns Bank details
      */
     async getBank(bankAddress) {
-        const body = await handleApiCall(() => this.http.get(`/bank?bank=${bankAddress.toString()}`));
+        const body = await this.handleApiCall(() => this.http.get(`/bank`, {
+            params: {
+                bank: bankAddress.toString(),
+            },
+        }));
         const bankJson = JSON.parse(body);
         const bank = parseBank(bankJson.bank);
         const response = {
@@ -313,7 +334,7 @@ class Client {
             inputTokenMint,
             depositAmountUi: uiAmount,
         };
-        const body = await handleApiCall(() => this.http.post("deposit", JSON.stringify(req)));
+        const body = await this.handleApiCall(() => this.http.post("deposit", JSON.stringify(req)));
         const depositResponse = JSON.parse(body);
         const txSig = await this.send(depositResponse.unsignedBase64Tx, depositResponse.userRequestId);
         return txSig;
@@ -325,7 +346,7 @@ class Client {
             withdrawAmountUi: uiAmount,
             withdrawAll,
         };
-        const body = await handleApiCall(() => this.http.post("withdraw", JSON.stringify(req)));
+        const body = await this.handleApiCall(() => this.http.post("withdraw", JSON.stringify(req)));
         const withdrawResponse = JSON.parse(body);
         const txSig = await this.send(withdrawResponse.unsignedBase64Tx, withdrawResponse.userRequestId);
         return txSig;
@@ -351,7 +372,7 @@ class Client {
             leverage,
             slippageBps,
         };
-        const body = await handleApiCall(() => this.http.post("leverage/deposit", JSON.stringify(req)));
+        const body = await this.handleApiCall(() => this.http.post("leverage/deposit", JSON.stringify(req)));
         const depositLeverageResponse = JSON.parse(body);
         const txSig = await this.send(depositLeverageResponse.unsignedBase64Tx, depositLeverageResponse.userRequestId);
         return txSig;
@@ -369,7 +390,7 @@ class Client {
             leverage,
             slippageBps,
         };
-        const body = await handleApiCall(() => this.http.post("leverage/adjust", JSON.stringify(req)));
+        const body = await this.handleApiCall(() => this.http.post("leverage/adjust", JSON.stringify(req)));
         const adjustLeverageResponse = JSON.parse(body);
         const txSig = await this.send(adjustLeverageResponse.unsignedBase64Tx, adjustLeverageResponse.userRequestId);
         return txSig;
@@ -389,7 +410,7 @@ class Client {
             slippageBps,
             withdrawAll,
         };
-        const body = await handleApiCall(() => this.http.post("leverage/withdraw", JSON.stringify(req)));
+        const body = await this.handleApiCall(() => this.http.post("leverage/withdraw", JSON.stringify(req)));
         const withdrawLeverageResponse = JSON.parse(body);
         const txSig = await this.send(withdrawLeverageResponse.unsignedBase64Tx, withdrawLeverageResponse.userRequestId);
         return txSig;
@@ -402,31 +423,27 @@ class Client {
         const req = {
             clendAccount,
         };
-        const body = await handleApiCall(() => this.http.post("emissions/withdraw", JSON.stringify(req)));
+        const body = await this.handleApiCall(() => this.http.post("emissions/withdraw", JSON.stringify(req)));
         const withdrawEmissionsResponse = JSON.parse(body);
         const txSig = await this.send(withdrawEmissionsResponse.unsignedBase64Tx, withdrawEmissionsResponse.userRequestId);
         return txSig;
     }
-}
-exports.Client = Client;
-// Helper function to handle API calls
-async function handleApiCall(call) {
-    try {
-        const { data } = await call();
-        return JSON.stringify(data);
-    }
-    catch (e) {
-        if (axios_1.default.isAxiosError(e)) {
-            const res = e.response;
-            if (res && typeof res.data === "object") {
-                const payload = res.data;
-                throw new Error(`${payload.error}${payload.details ? ` ${payload.details}` : ""}`);
-            }
-            throw new Error(`${e.message}`);
+    async getExtension(extension) {
+        switch (extension) {
+            case "positionCharting":
+                return (clendAccount) => new position_1.PositionChartingExtension(this.baseUrl, clendAccount);
+            case "groupCharting":
+                return (group) => new group_1.GroupChartingExtension(this.baseUrl, group);
+            case "walletCharting":
+                return (address) => new wallet_1.WalletChartingExtension(this.baseUrl, address ?? this.address());
+            case "bankCharting":
+                return (bank) => new bank_1.BankChartingExtension(this.baseUrl, bank);
+            default:
+                throw new Error(`Unknown extension: ${extension}`);
         }
-        throw e;
     }
 }
+exports.Client = Client;
 function getDummyProvider() {
     return new anchor_1.AnchorProvider(new anchor_1.web3.Connection("http://localhost:8899"), new anchor_1.Wallet(anchor_1.web3.Keypair.generate()), {
         skipPreflight: true,

package/dist/types.d.ts

@@ -1,4 +1,8 @@
 import { BN, web3 } from "@coral-xyz/anchor";
+import { PositionChartingExtension } from "./charting/position";
+import { BankChartingExtension } from "./charting/bank";
+import { WalletChartingExtension } from "./charting/wallet";
+import { GroupChartingExtension } from "./charting/group";
 export interface SendRequest {
     userRequestId: string;
     txns: string[];
@@ -247,3 +251,5 @@ export interface UserRequest {
     openPosition: boolean | null;
     closePosition: boolean | null;
 }
+export type ExtensionKey = "positionCharting" | "groupCharting" | "walletCharting" | "bankCharting";
+export type Extension = InstanceType<typeof PositionChartingExtension> | InstanceType<typeof GroupChartingExtension> | InstanceType<typeof WalletChartingExtension> | InstanceType<typeof BankChartingExtension>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carrot-protocol/boost-http-client",
-  "version": "0.3.3",
+  "version": "0.4.0-stub-position-endpoints-dev-666335f",
   "description": "HTTP client for Carrot Boost",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,8 +13,8 @@
     "version-check": "current_version=$(node -p -e \"require('./package.json').version\") && if npm view @carrot-protocol/boost-http-client@$current_version > /dev/null 2>&1; then echo \"Version $current_version already exists. Please bump it in package.json\"; exit 1; fi"
   },
   "dependencies": {
+    "@carrot-protocol/clend-common": "^0.1.0",
     "@coral-xyz/anchor": "^0.29.0",
-    "@carrot-protocol/clend-common": "0.1.8-group-refactor1-dev-19efede",
     "axios": "^1.8.3",
     "bs58": "^6.0.0",
     "decimal.js": "^10.5.0"
@@ -25,7 +25,7 @@
     "typescript": "^5.3.3"
   },
   "peerDependencies": {
-    "@coral-xyz/anchor": "^0.29.0",
-    "@carrot-protocol/clend-common": "^0.1.0"
+    "@carrot-protocol/clend-common": "^0.1.0",
+    "@coral-xyz/anchor": "^0.29.0"
   }
 }

package/src/api/index.ts

@@ -0,0 +1,46 @@
+import axios, { AxiosInstance, AxiosResponse } from "axios";
+import { ApiErrorPayload } from "./types";
+
+/**
+ * Base API Client
+ */
+export class ApiClient {
+  protected readonly baseUrl: string;
+  protected readonly http: AxiosInstance;
+
+  /**
+   * Create a new API client
+   * @param baseUrl Base URL for the API
+   */
+  constructor(baseUrl: string) {
+    this.baseUrl = new URL(baseUrl).toString();
+    this.http = axios.create({
+      baseURL: this.baseUrl,
+      headers: {
+        "Content-Type": "application/json",
+      },
+    });
+  }
+
+  // Helper function to handle API calls
+  protected async handleApiCall<T>(
+    call: () => Promise<AxiosResponse<T>>,
+  ): Promise<string> {
+    try {
+      const { data } = await call();
+      return JSON.stringify(data);
+    } catch (e) {
+      if (axios.isAxiosError(e)) {
+        const res = e.response;
+        if (res && typeof res.data === "object") {
+          const payload = res.data as ApiErrorPayload;
+          throw new Error(
+            `${payload.error}${payload.details ? ` ${payload.details}` : ""}`,
+          );
+        }
+        throw new Error(`${e.message}`);
+      }
+      throw e;
+    }
+  }
+}

package/src/api/types.ts

@@ -0,0 +1,6 @@
+export type ApiErrorPayload = {
+  error: string;
+  details?: unknown;
+  path: string;
+  timestamp: string;
+};

package/src/charting/bank/index.ts

@@ -0,0 +1,35 @@
+import { web3 } from "@coral-xyz/anchor";
+import { ApyResponse } from "./types";
+import { ApiClient } from "../../api";
+
+export class BankChartingExtension extends ApiClient {
+  private readonly bank: web3.PublicKey;
+
+  constructor(baseUrl: string, bank: web3.PublicKey) {
+    super(baseUrl);
+    this.bank = bank;
+  }
+
+  public async getApy(
+    options: { fromTime?: Date; toTime?: Date } = {},
+  ): Promise<ApyResponse[]> {
+    const body = await this.handleApiCall(() =>
+      this.http.get(`/bank/apys`, {
+        params: {
+          bank: this.bank.toString(),
+          fromTime: options.fromTime?.toISOString(),
+          toTime: options.toTime?.toISOString(),
+        },
+      }),
+    );
+
+    const response: ApyResponse[] = JSON.parse(body).map(
+      (apy: { time: string; supply_apy: string; borrow_apy: string }) => ({
+        time: new Date(apy.time),
+        assetApy: Number(apy.supply_apy),
+        liabilityApy: Number(apy.borrow_apy),
+      }),
+    );
+    return response;
+  }
+}

package/src/charting/bank/types.ts

@@ -0,0 +1,5 @@
+export interface ApyResponse {
+  time: Date;
+  assetApy: number;
+  liabilityApy: number;
+}

package/src/charting/group/index.ts

@@ -0,0 +1,41 @@
+import { web3 } from "@coral-xyz/anchor";
+import { PerformanceResponse } from "./types";
+import { ApiClient } from "../../api";
+
+export class GroupChartingExtension extends ApiClient {
+  private readonly group: web3.PublicKey;
+
+  constructor(baseUrl: string, group: web3.PublicKey) {
+    super(baseUrl);
+    this.group = group;
+  }
+
+  public async getPerformance(
+    options: { fromTime?: Date; toTime?: Date } = {},
+  ): Promise<PerformanceResponse[]> {
+    const body = await this.handleApiCall(() =>
+      this.http.get(`/group/pnls`, {
+        params: {
+          group: this.group.toString(),
+          fromTime: options.fromTime?.toISOString(),
+          toTime: options.toTime?.toISOString(),
+        },
+      }),
+    );
+
+    const response: PerformanceResponse[] = JSON.parse(body).map(
+      (performance: {
+        time: string;
+        cost_basis: string;
+        net_value_value: string;
+        pnl_value: string;
+      }) => ({
+        time: new Date(performance.time),
+        costBasis: Number(performance.cost_basis),
+        netValueValue: Number(performance.net_value_value),
+        pnlValue: Number(performance.pnl_value),
+      }),
+    );
+    return response;
+  }
+}

package/src/charting/group/types.ts

@@ -0,0 +1,6 @@
+export interface PerformanceResponse {
+  time: Date;
+  costBasis: number;
+  netValueValue: number;
+  pnlValue: number;
+}

package/src/charting/position/index.ts

@@ -0,0 +1,101 @@
+import { web3 } from "@coral-xyz/anchor";
+import { ApyResponse, LoanBalanceResponse, PerformanceResponse } from "./types";
+import { ApiClient } from "../../api";
+
+export class PositionChartingExtension extends ApiClient {
+  private readonly clendAccount: web3.PublicKey;
+
+  constructor(baseUrl: string, clendAccount: web3.PublicKey) {
+    super(baseUrl);
+    this.clendAccount = clendAccount;
+  }
+
+  public async getLoanBalance(
+    options: { fromTime?: Date; toTime?: Date } = {},
+  ): Promise<LoanBalanceResponse[]> {
+    const body = await this.handleApiCall(() =>
+      this.http.get(`/account/balances`, {
+        params: {
+          account: this.clendAccount.toString(),
+          fromTime: options.fromTime?.toISOString(),
+          toTime: options.toTime?.toISOString(),
+        },
+      }),
+    );
+
+    const response: LoanBalanceResponse[] = JSON.parse(body).map(
+      (balance: {
+        time: string;
+        net_asset_balance_value: string;
+        net_liability_balance_value: string;
+        net_value_value: string;
+        notional_leverage: string;
+      }) => ({
+        time: new Date(balance.time),
+        netAssetBalanceValue: Number(balance.net_asset_balance_value),
+        netLiabilityBalanceValue: Number(balance.net_liability_balance_value),
+        netValueValue: Number(balance.net_value_value),
+        notionalLeverage: Number(balance.notional_leverage),
+      }),
+    );
+    return response;
+  }
+
+  public async getPerformance(
+    options: { fromTime?: Date; toTime?: Date } = {},
+  ): Promise<PerformanceResponse[]> {
+    const body = await this.handleApiCall(() =>
+      this.http.get(`/account/performance`, {
+        params: {
+          account: this.clendAccount.toString(),
+          fromTime: options.fromTime?.toISOString(),
+          toTime: options.toTime?.toISOString(),
+        },
+      }),
+    );
+
+    const response: PerformanceResponse[] = JSON.parse(body).map(
+      (performance: {
+        time: string;
+        cost_basis: string;
+        net_value_value: string;
+        pnl_value: string;
+      }) => ({
+        time: new Date(performance.time),
+        costBasis: Number(performance.cost_basis),
+        netValueValue: Number(performance.net_value_value),
+        pnlValue: Number(performance.pnl_value),
+      }),
+    );
+    return response;
+  }
+
+  public async getApy(
+    options: { fromTime?: Date; toTime?: Date } = {},
+  ): Promise<ApyResponse[]> {
+    const body = await this.handleApiCall(() =>
+      this.http.get(`/account/apys`, {
+        params: {
+          account: this.clendAccount.toString(),
+          fromTime: options.fromTime?.toISOString(),
+          toTime: options.toTime?.toISOString(),
+        },
+      }),
+    );
+
+    const response: ApyResponse[] = JSON.parse(body).map(
+      (apy: {
+        time: string;
+        asset_apy: string;
+        liability_apy: string;
+        net_apy: string;
+      }) => ({
+        time: new Date(apy.time),
+        assetApy: Number(apy.asset_apy),
+        liabilityApy: Number(apy.liability_apy),
+        netApy: Number(apy.net_apy),
+      }),
+    );
+    return response;
+  }
+}

package/src/charting/position/types.ts

@@ -0,0 +1,21 @@
+export interface LoanBalanceResponse {
+  time: Date;
+  netAssetBalanceValue: number;
+  netLiabilityBalanceValue: number;
+  netValueValue: number;
+  notionalLeverage: number;
+}
+
+export interface PerformanceResponse {
+  time: Date;
+  costBasis: number;
+  netValueValue: number;
+  pnlValue: number;
+}
+
+export interface ApyResponse {
+  time: Date;
+  assetApy: number;
+  liabilityApy: number;
+  netApy: number;
+}

package/src/charting/wallet/index.ts

@@ -0,0 +1,41 @@
+import { web3 } from "@coral-xyz/anchor";
+import { PerformanceResponse } from "./types";
+import { ApiClient } from "../../api";
+
+export class WalletChartingExtension extends ApiClient {
+  private readonly address: web3.PublicKey;
+
+  constructor(baseUrl: string, address: web3.PublicKey) {
+    super(baseUrl);
+    this.address = address;
+  }
+
+  public async getPerformance(
+    options: { fromTime?: Date; toTime?: Date } = {},
+  ): Promise<PerformanceResponse[]> {
+    const body = await this.handleApiCall(() =>
+      this.http.get(`/user/pnls`, {
+        params: {
+          authority: this.address.toString(),
+          fromTime: options.fromTime?.toISOString(),
+          toTime: options.toTime?.toISOString(),
+        },
+      }),
+    );
+
+    const response: PerformanceResponse[] = JSON.parse(body).map(
+      (performance: {
+        time: string;
+        cost_basis: string;
+        net_value_value: string;
+        pnl_value: string;
+      }) => ({
+        time: new Date(performance.time),
+        costBasis: Number(performance.cost_basis),
+        netValueValue: Number(performance.net_value_value),
+        pnlValue: Number(performance.pnl_value),
+      }),
+    );
+    return response;
+  }
+}

package/src/charting/wallet/types.ts

@@ -0,0 +1,6 @@
+export interface PerformanceResponse {
+  time: Date;
+  costBasis: number;
+  netValueValue: number;
+  pnlValue: number;
+}

package/src/index.ts

@@ -1,4 +1,3 @@
-import axios, { AxiosInstance, AxiosError, AxiosResponse } from "axios";
 import { AnchorProvider, BN, Wallet, web3 } from "@coral-xyz/anchor";
 import {
   DepositLeverageRequest,
@@ -33,8 +32,15 @@ import {
   WithdrawResponse,
   GetAccountResponse,
   GetAccountRequest,
+  ExtensionKey,
+  Extension,
 } from "./types";
 import encode from "bs58";
+import { ApiClient } from "./api";
+import { PositionChartingExtension } from "./charting/position";
+import { BankChartingExtension } from "./charting/bank";
+import { WalletChartingExtension } from "./charting/wallet";
+import { GroupChartingExtension } from "./charting/group";
 
 // Re-export types
 export * from "./types";
@@ -46,9 +52,7 @@ export * as Common from "@carrot-protocol/clend-common";
 /**
  * HTTP Client for Carrot Boost API
  */
-export class Client {
-  private readonly baseUrl: string;
-  private readonly http: AxiosInstance;
+export class Client extends ApiClient {
   private readonly provider: AnchorProvider;
   private readonly dryRun: boolean;
 
@@ -57,13 +61,7 @@ export class Client {
    * @param baseUrl Base URL for the API
    */
   constructor(baseUrl: string, provider?: AnchorProvider, dryRun?: boolean) {
-    this.baseUrl = new URL(baseUrl).toString();
-    this.http = axios.create({
-      baseURL: this.baseUrl,
-      headers: {
-        "Content-Type": "application/json",
-      },
-    });
+    super(baseUrl);
     if (!provider) {
       provider = getDummyProvider();
     }
@@ -107,7 +105,7 @@ export class Client {
     };
 
     // send to api
-    await handleApiCall(() => this.http.post(`send`, sendRequest));
+    await this.handleApiCall(() => this.http.post(`send`, sendRequest));
 
     // return txsig
     return encode.encode(txSig);
@@ -118,7 +116,7 @@ export class Client {
    * @returns Index details
    */
   async index(): Promise<any> {
-    return handleApiCall(() => this.http.get(""));
+    return this.handleApiCall(() => this.http.get(""));
   }
 
   /**
@@ -128,10 +126,13 @@ export class Client {
     account: GetAccountRequest["account"],
     getClendAccountSummary: GetAccountRequest["getClendAccountSummary"],
   ): Promise<GetAccountResponse> {
-    const body = await handleApiCall(() =>
-      this.http.get(
-        `/account?account=${account.toString()}&getClendAccountSummary=${getClendAccountSummary}`,
-      ),
+    const body = await this.handleApiCall(() =>
+      this.http.get(`/account`, {
+        params: {
+          account: account.toString(),
+          getClendAccountSummary,
+        },
+      }),
     );
     const jsonRawResponse: any = JSON.parse(body);
     return this.parseClendAccountWithSummary(
@@ -271,15 +272,19 @@ export class Client {
   }
 
   async getUser(
-    user: web3.PublicKey,
-    groups: web3.PublicKey[],
-    getClendAccountSummary: boolean,
+    user: GetUserRequest["user"],
+    groups: GetUserRequest["groups"],
+    getClendAccountSummary: GetUserRequest["getClendAccountSummary"],
   ): Promise<GetUserResponse> {
     // Make the API call to fetch the raw user data as a string.
-    const body = await handleApiCall(() =>
-      this.http.get(
-        `/user?user=${user.toString()}&groups=${groups.map((g) => g.toString()).join(",")}&getClendAccountSummary=${getClendAccountSummary}`,
-      ),
+    const body = await this.handleApiCall(() =>
+      this.http.get(`/user`, {
+        params: {
+          user: user.toString(),
+          groups: groups.map((g) => g.toString()).join(","),
+          getClendAccountSummary,
+        },
+      }),
     );
 
     // Parse the raw string body into a JSON object.
@@ -319,8 +324,12 @@ export class Client {
    * @returns All groups
    */
   async getGroups(includeBankData: boolean): Promise<GetGroupsResponse> {
-    const body = await handleApiCall(() =>
-      this.http.get(`/groups?includeBankData=${includeBankData}`),
+    const body = await this.handleApiCall(() =>
+      this.http.get(`/groups`, {
+        params: {
+          includeBankData,
+        },
+      }),
     );
 
     const marketJson: any = JSON.parse(body);
@@ -349,8 +358,12 @@ export class Client {
    * @returns Group Details, which is really just all the bank data for that group
    */
   async getGroup(groupAddress: web3.PublicKey): Promise<GetGroupResponse> {
-    const body = await handleApiCall(() =>
-      this.http.get(`/group?group=${groupAddress.toString()}`),
+    const body = await this.handleApiCall(() =>
+      this.http.get(`/group`, {
+        params: {
+          group: groupAddress.toString(),
+        },
+      }),
     );
 
     const marketJson: any = JSON.parse(body);
@@ -377,8 +390,12 @@ export class Client {
    * @returns Bank details
    */
   async getBank(bankAddress: web3.PublicKey): Promise<GetBankResponse> {
-    const body = await handleApiCall(() =>
-      this.http.get(`/bank?bank=${bankAddress.toString()}`),
+    const body = await this.handleApiCall(() =>
+      this.http.get(`/bank`, {
+        params: {
+          bank: bankAddress.toString(),
+        },
+      }),
     );
 
     const bankJson: any = JSON.parse(body);
@@ -405,7 +422,7 @@ export class Client {
       depositAmountUi: uiAmount,
     };
 
-    const body = await handleApiCall(() =>
+    const body = await this.handleApiCall(() =>
       this.http.post("deposit", JSON.stringify(req)),
     );
 
@@ -432,7 +449,7 @@ export class Client {
       withdrawAll,
     };
 
-    const body = await handleApiCall(() =>
+    const body = await this.handleApiCall(() =>
       this.http.post("withdraw", JSON.stringify(req)),
     );
 
@@ -481,7 +498,7 @@ export class Client {
       leverage,
       slippageBps,
     };
-    const body = await handleApiCall(() =>
+    const body = await this.handleApiCall(() =>
       this.http.post("leverage/deposit", JSON.stringify(req)),
     );
 
@@ -514,7 +531,7 @@ export class Client {
       leverage,
       slippageBps,
     };
-    const body = await handleApiCall(() =>
+    const body = await this.handleApiCall(() =>
       this.http.post("leverage/adjust", JSON.stringify(req)),
     );
 
@@ -551,7 +568,7 @@ export class Client {
       slippageBps,
       withdrawAll,
     };
-    const body = await handleApiCall(() =>
+    const body = await this.handleApiCall(() =>
       this.http.post("leverage/withdraw", JSON.stringify(req)),
     );
 
@@ -574,7 +591,7 @@ export class Client {
       clendAccount,
     };
 
-    const body = await handleApiCall(() =>
+    const body = await this.handleApiCall(() =>
       this.http.post("emissions/withdraw", JSON.stringify(req)),
     );
 
@@ -588,34 +605,24 @@ export class Client {
 
     return txSig;
   }
-}
 
-type ApiErrorPayload = {
-  error: string;
-  details?: unknown;
-  path: string;
-  timestamp: string;
-};
-
-// Helper function to handle API calls
-async function handleApiCall<T>(
-  call: () => Promise<AxiosResponse<T>>,
-): Promise<string> {
-  try {
-    const { data } = await call();
-    return JSON.stringify(data);
-  } catch (e) {
-    if (axios.isAxiosError(e)) {
-      const res = e.response;
-      if (res && typeof res.data === "object") {
-        const payload = res.data as ApiErrorPayload;
-        throw new Error(
-          `${payload.error}${payload.details ? ` ${payload.details}` : ""}`,
-        );
-      }
-      throw new Error(`${e.message}`);
+  public async getExtension(extension: ExtensionKey) {
+    switch (extension) {
+      case "positionCharting":
+        return (clendAccount: web3.PublicKey) =>
+          new PositionChartingExtension(this.baseUrl, clendAccount);
+      case "groupCharting":
+        return (group: web3.PublicKey) =>
+          new GroupChartingExtension(this.baseUrl, group);
+      case "walletCharting":
+        return (address?: web3.PublicKey) =>
+          new WalletChartingExtension(this.baseUrl, address ?? this.address());
+      case "bankCharting":
+        return (bank: web3.PublicKey) =>
+          new BankChartingExtension(this.baseUrl, bank);
+      default:
+        throw new Error(`Unknown extension: ${extension}`);
     }
-    throw e;
   }
 }
 

package/src/types.ts

@@ -1,4 +1,8 @@
 import { BN, web3 } from "@coral-xyz/anchor";
+import { PositionChartingExtension } from "./charting/position";
+import { BankChartingExtension } from "./charting/bank";
+import { WalletChartingExtension } from "./charting/wallet";
+import { GroupChartingExtension } from "./charting/group";
 
 // Send a tx
 export interface SendRequest {
@@ -283,3 +287,15 @@ export interface UserRequest {
   openPosition: boolean | null;
   closePosition: boolean | null;
 }
+
+export type ExtensionKey =
+  | "positionCharting"
+  | "groupCharting"
+  | "walletCharting"
+  | "bankCharting";
+
+export type Extension =
+  | InstanceType<typeof PositionChartingExtension>
+  | InstanceType<typeof GroupChartingExtension>
+  | InstanceType<typeof WalletChartingExtension>
+  | InstanceType<typeof BankChartingExtension>;