@hawksightco/hawk-sdk 1.3.265 → 1.3.266

package/dist/classes/Util.d.ts

@@ -0,0 +1,87 @@
+import * as client from "@hawksightco/swagger-client";
+import { MeteoraDlmmActiveBin, ResponseWithStatus, UserPortfolioOut } from "../types";
+import { Client } from "./Client";
+/**
+ * Provides utility functions for interacting with the Meteora DLMM and Orca CLMM subsystems of the HawkSight API.
+ * This class enables fetching and manipulating data related to pools, positions, and other transaction-related information.
+ */
+export declare class Util {
+    private readonly client;
+    /**
+     * Initializes a new instance of the Util class.
+     *
+     * @param client The Client object through which API calls will be made.
+     */
+    constructor(client: Client);
+    /**
+     * Retrieves a list of pools managed by Meteora DLMM.
+     *
+     * @returns A Promise resolving to a response object containing the status and array of pool information.
+     */
+    meteoraDlmmPools(): Promise<ResponseWithStatus<client.InlineResponse2003[]>>;
+    /**
+     * Fetches positions held in Meteora DLMM pools, optionally filtered by a specific pool.
+     *
+     * @param params An object containing wallet address and an optional pool identifier.
+     * @returns A Promise resolving to a response object with the status and data of positions.
+     */
+    meteoraDlmmPositions(params: {
+        wallet: string;
+        pool?: string;
+    }): Promise<ResponseWithStatus<UserPortfolioOut>>;
+    /**
+     * Retrieves the active bin data for a specific set of parameters in Meteora DLMM.
+     *
+     * @param params The parameters required to define the active bin query.
+     * @returns A Promise resolving to a response with the status and data of the active bin.
+     */
+    meteoraDlmmActiveBin(params: client.UtilActiveBinBody): Promise<ResponseWithStatus<MeteoraDlmmActiveBin>>;
+    /**
+     * Retrieves a list of pools managed by Orca CLMM.
+     *
+     * @returns A Promise resolving to a response object containing the status and array of pool information.
+     */
+    orcaClmmPools(): Promise<ResponseWithStatus<any>>;
+    /**
+     * Fetches positions held in Orca CLMM pools, optionally filtered by a specific pool.
+     *
+     * @param params An object containing wallet address and an optional pool identifier.
+     * @returns A Promise resolving to a response object with the status and data of positions.
+     */
+    orcaPositions(params: {
+        wallet: string;
+        pool?: string;
+    }): Promise<ResponseWithStatus<any>>;
+    /**
+     * Retrieves the mint information of a specific position managed by Orca CLMM.
+     *
+     * @param params An object containing the identifier of the position.
+     * @returns A Promise resolving to a response object with the status and mint details of the position.
+     */
+    orcaGetPositionMint(params: {
+        position: string;
+    }): Promise<ResponseWithStatus<any>>;
+    /**
+     * Get single orca pool from hawksight api
+     *
+     * @param params Whirlpool address.
+     * @returns A Promise resolving to a response object with the status and mint details of the position.
+     */
+    orcaGetPosition(params: {
+        pool: string;
+    }): Promise<ResponseWithStatus<any>>;
+    /**
+     * Returns orca tick current index of given whirlpool(s)
+     *
+     * @param params
+     * @returns
+     */
+    orcaGetActiveTick(params: {
+        pools: string[];
+        commitment?: string;
+    }): Promise<{
+        status: any;
+        data: any;
+    }>;
+}
+//# sourceMappingURL=Util.d.ts.map

package/dist/classes/Util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../src/classes/Util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAiB,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACrG,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;GAGG;AACH,qBAAa,IAAI;IAOb,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB;;;;OAIG;gBAEgB,MAAM,EAAE,MAAM;IAGjC;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAQlF;;;;;OAKG;IACG,oBAAoB,CACxB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GACA,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IAQhD;;;;;OAKG;IACG,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;IAQ/G;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAQvD;;;;;OAKG;IACG,aAAa,CACjB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GACA,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAQnC;;;;;OAKG;IACG,mBAAmB,CACvB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAQnC;;;;;OAKG;IACG,eAAe,CACnB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;KACd,GACA,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAQnC;;;;;OAKG;IACG,iBAAiB,CACrB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB;;;;CAWJ"}

package/dist/classes/Util.js

@@ -0,0 +1,148 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Util = void 0;
+/**
+ * Provides utility functions for interacting with the Meteora DLMM and Orca CLMM subsystems of the HawkSight API.
+ * This class enables fetching and manipulating data related to pools, positions, and other transaction-related information.
+ */
+class Util {
+    /**
+     * Initializes a new instance of the Util class.
+     *
+     * @param client The Client object through which API calls will be made.
+     */
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a list of pools managed by Meteora DLMM.
+     *
+     * @returns A Promise resolving to a response object containing the status and array of pool information.
+     */
+    meteoraDlmmPools() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.client.meteoraDLMMUtilityFunctionsApi.meteoraDlmmUtilPoolsGet().catch(e => e.response);
+            return {
+                status: result.status,
+                data: result.data,
+            };
+        });
+    }
+    /**
+     * Fetches positions held in Meteora DLMM pools, optionally filtered by a specific pool.
+     *
+     * @param params An object containing wallet address and an optional pool identifier.
+     * @returns A Promise resolving to a response object with the status and data of positions.
+     */
+    meteoraDlmmPositions(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.client.meteoraDLMMUtilityFunctionsApi.meteoraDlmmUtilPositionsGet(params.wallet, params.pool).catch(e => e.response);
+            return {
+                status: result.status,
+                data: result.data,
+            };
+        });
+    }
+    /**
+     * Retrieves the active bin data for a specific set of parameters in Meteora DLMM.
+     *
+     * @param params The parameters required to define the active bin query.
+     * @returns A Promise resolving to a response with the status and data of the active bin.
+     */
+    meteoraDlmmActiveBin(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.client.meteoraDLMMUtilityFunctionsApi.meteoraDlmmUtilActiveBinPost(params).catch(e => e.response);
+            return {
+                status: result.status,
+                data: result.data,
+            };
+        });
+    }
+    /**
+     * Retrieves a list of pools managed by Orca CLMM.
+     *
+     * @returns A Promise resolving to a response object containing the status and array of pool information.
+     */
+    orcaClmmPools() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.client.orcaUtilityFunctionsApi.orcaUtilPoolsGet().catch(e => e.response);
+            return {
+                status: result.status,
+                data: result.data,
+            };
+        });
+    }
+    /**
+     * Fetches positions held in Orca CLMM pools, optionally filtered by a specific pool.
+     *
+     * @param params An object containing wallet address and an optional pool identifier.
+     * @returns A Promise resolving to a response object with the status and data of positions.
+     */
+    orcaPositions(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.client.orcaUtilityFunctionsApi.orcaUtilPositionsGet(params.wallet, params.pool).catch(e => e.response);
+            return {
+                status: result.status,
+                data: result.data,
+            };
+        });
+    }
+    /**
+     * Retrieves the mint information of a specific position managed by Orca CLMM.
+     *
+     * @param params An object containing the identifier of the position.
+     * @returns A Promise resolving to a response object with the status and mint details of the position.
+     */
+    orcaGetPositionMint(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.client.orcaUtilityFunctionsApi.orcaUtilGetPositionMintGet(params.position).catch(e => e.response);
+            return {
+                status: result.status,
+                data: result.data,
+            };
+        });
+    }
+    /**
+     * Get single orca pool from hawksight api
+     *
+     * @param params Whirlpool address.
+     * @returns A Promise resolving to a response object with the status and mint details of the position.
+     */
+    orcaGetPosition(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.client.generalEndpoints.poolGet(params.pool, "orca");
+            return {
+                status: result.status,
+                data: result.data,
+            };
+        });
+    }
+    /**
+     * Returns orca tick current index of given whirlpool(s)
+     *
+     * @param params
+     * @returns
+     */
+    orcaGetActiveTick(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.client.orcaUtilityFunctionsApi.orcaUtilActiveTickPost({
+                pools: params.pools,
+                commitment: params.commitment,
+            }).catch(e => e.response);
+            return {
+                status: result.status,
+                data: result.data,
+            };
+        });
+    }
+}
+exports.Util = Util;

package/dist/classes/account-cache/AccountCache.d.ts

@@ -0,0 +1,54 @@
+import * as web3 from "@solana/web3.js";
+type AccountInfoInternal = {
+    refetch: boolean;
+    info: web3.AccountInfo<Buffer>;
+};
+type _AccountCache = Record<string, AccountInfoInternal>;
+export declare abstract class AccountCache {
+    protected connection: web3.Connection;
+    /**
+     * Cache of accounts.
+     */
+    protected static accounts: _AccountCache;
+    /**
+     * Promise that resolves when the accounts are fetched.
+     * This is used to wait for the accounts to be fetched before using them.
+     */
+    protected pending: Promise<void> | null;
+    /**
+     * Instantiate the AccountCache class
+     *
+     * @param connection - The connection to the blockchain.
+     */
+    constructor(connection: web3.Connection);
+    /**
+     * Criteria of accounts to be fetched must be only owned by the given programs
+     */
+    protected abstract mustOwnedByEitherPrograms(): web3.PublicKey[];
+    /**
+     * Whether the account query should require the account to exist.
+     */
+    protected abstract requireToExist(): boolean;
+    /**
+     * Get account info from cache
+     *
+     * @param key
+     * @returns
+     */
+    static get(key: web3.PublicKey): AccountInfoInternal | undefined;
+    /**
+     * Mark accounts to be refetched
+     */
+    refetch(pubkeys: web3.PublicKey[]): this;
+    /**
+     * The goal of this function is to batch 100 accounts at a time as it is the max number of accounts that can be fetched at once.
+     * Skips accounts that are already fetched.
+     *
+     * @param pubkeys - The accounts to fetch.
+     * @returns - A promise that resolves to an array of TokenAccountInfo objects.
+     */
+    getBatchedMultipleAccountsInfo(pubkeys: web3.PublicKey[], commitment?: web3.Commitment): this;
+    waitForResult(): Promise<_AccountCache>;
+}
+export {};
+//# sourceMappingURL=AccountCache.d.ts.map

package/dist/classes/account-cache/AccountCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountCache.d.ts","sourceRoot":"","sources":["../../../src/classes/account-cache/AccountCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAExC,KAAK,mBAAmB,GAAG;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;CAChC,CAAA;AAED,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEzD,8BAAsB,YAAY;IAmB9B,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU;IAjBvC;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAM;IAE9C;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAQ;IAE/C;;;;OAIG;gBAES,UAAU,EAAE,IAAI,CAAC,UAAU;IAGvC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,yBAAyB,IAAI,IAAI,CAAC,SAAS,EAAE;IAEhE;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,cAAc,IAAI,OAAO;IAE5C;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,GAAG,mBAAmB,GAAG,SAAS;IAIhE;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI;IASxC;;;;;;OAMG;IACH,8BAA8B,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,UAAU,GAAE,IAAI,CAAC,UAAwB,GAAG,IAAI;IA2CpG,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;CAM9C"}

package/dist/classes/account-cache/AccountCache.js

@@ -0,0 +1,143 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountCache = void 0;
+const web3 = __importStar(require("@solana/web3.js"));
+class AccountCache {
+    /**
+     * Instantiate the AccountCache class
+     *
+     * @param connection - The connection to the blockchain.
+     */
+    constructor(connection) {
+        this.connection = connection;
+        /**
+         * Promise that resolves when the accounts are fetched.
+         * This is used to wait for the accounts to be fetched before using them.
+         */
+        this.pending = null;
+    }
+    /**
+     * Get account info from cache
+     *
+     * @param key
+     * @returns
+     */
+    static get(key) {
+        return AccountCache.accounts[key.toString()];
+    }
+    /**
+     * Mark accounts to be refetched
+     */
+    refetch(pubkeys) {
+        for (const pubkey of pubkeys) {
+            if (!!AccountCache.accounts[pubkey.toString()]) {
+                AccountCache.accounts[pubkey.toString()].refetch = true;
+            }
+        }
+        return this;
+    }
+    /**
+     * The goal of this function is to batch 100 accounts at a time as it is the max number of accounts that can be fetched at once.
+     * Skips accounts that are already fetched.
+     *
+     * @param pubkeys - The accounts to fetch.
+     * @returns - A promise that resolves to an array of TokenAccountInfo objects.
+     */
+    getBatchedMultipleAccountsInfo(pubkeys, commitment = "confirmed") {
+        // Check first if account is already fetched. Skips accounts that are marked to be refetched.
+        const pubkeysToFetch = pubkeys.filter(pubkey => {
+            const cache = AccountCache.accounts[pubkey.toString()];
+            if (cache) {
+                return cache.refetch;
+            }
+            return true;
+        });
+        const batchSize = 100;
+        const batches = [];
+        for (let i = 0; i < pubkeysToFetch.length; i += batchSize) {
+            batches.push(pubkeysToFetch.slice(i, i + batchSize));
+        }
+        const pending = Promise.all(batches.map(batch => this.connection.getMultipleAccountsInfo(batch, commitment))).then(batch => {
+            const result = batch.flat();
+            for (let i = 0; i < result.length; i++) {
+                const pubkey = pubkeysToFetch[i];
+                const info = result[i];
+                if (info !== null) {
+                    // Throw error if account fetching requires program ownership
+                    const mustBeOwnedByEither = this.mustOwnedByEitherPrograms();
+                    const requiredToExist = this.requireToExist();
+                    const doesNotExist = info.owner.equals(web3.SystemProgram.programId) && info.data.length === 0;
+                    if (doesNotExist && !requiredToExist) {
+                        return;
+                    }
+                    else if (mustBeOwnedByEither.length > 0 && !mustBeOwnedByEither.some(program => info.owner.equals(program))) {
+                        throw new Error(`Account ${pubkey.toString()} is not owned by any of the programs ${mustBeOwnedByEither.map(program => program.toString()).join(", ")}`);
+                    }
+                    else {
+                        AccountCache.accounts[pubkey.toString()] = { refetch: false, info };
+                    }
+                }
+                else if (this.requireToExist()) {
+                    throw new Error(`Account ${pubkey.toString()} does not exist`);
+                }
+            }
+        });
+        this.pending = pending;
+        return this;
+    }
+    waitForResult() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.pending) {
+                yield this.pending;
+            }
+            return AccountCache.accounts;
+        });
+    }
+}
+exports.AccountCache = AccountCache;
+/**
+ * Cache of accounts.
+ */
+AccountCache.accounts = {};

package/dist/classes/account-cache/MintCache.d.ts

@@ -0,0 +1,33 @@
+import * as web3 from "@solana/web3.js";
+import { AccountCache } from "./AccountCache";
+/**
+ * Singleton instance of AccountCache for mint accounts.
+ */
+export declare class MintCache extends AccountCache {
+    /**
+     * Singleton instance of MintCache
+     */
+    private static _instance;
+    /**
+     * Instantiate the MintCache class
+     *
+     * @param connection The Solana connection
+     */
+    private constructor();
+    /**
+     * Get the singleton instance of MintCache
+     *
+     * @param connection The Solana connection
+     * @returns The MintCache instance
+     */
+    static instance(connection: web3.Connection): MintCache;
+    /**
+     * Criteria of accounts to be fetched must be only owned by the given programs
+     */
+    protected mustOwnedByEitherPrograms(): web3.PublicKey[];
+    /**
+     * Whether the account query should require the account to exist.
+     */
+    protected requireToExist(): boolean;
+}
+//# sourceMappingURL=MintCache.d.ts.map

package/dist/classes/account-cache/MintCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MintCache.d.ts","sourceRoot":"","sources":["../../../src/classes/account-cache/MintCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAY;IAEzC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS,CAA0B;IAElD;;;;OAIG;IACH,OAAO;IAIP;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,GAAG,SAAS;IAOvD;;OAEG;IACH,SAAS,CAAC,yBAAyB,IAAI,IAAI,CAAC,SAAS,EAAE;IAIvD;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,OAAO;CAGpC"}

package/dist/classes/account-cache/MintCache.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MintCache = void 0;
+const AccountCache_1 = require("./AccountCache");
+const spl_token_1 = require("@solana/spl-token");
+/**
+ * Singleton instance of AccountCache for mint accounts.
+ */
+class MintCache extends AccountCache_1.AccountCache {
+    /**
+     * Instantiate the MintCache class
+     *
+     * @param connection The Solana connection
+     */
+    constructor(connection) {
+        super(connection);
+    }
+    /**
+     * Get the singleton instance of MintCache
+     *
+     * @param connection The Solana connection
+     * @returns The MintCache instance
+     */
+    static instance(connection) {
+        if (!MintCache._instance) {
+            MintCache._instance = new MintCache(connection);
+        }
+        return MintCache._instance;
+    }
+    /**
+     * Criteria of accounts to be fetched must be only owned by the given programs
+     */
+    mustOwnedByEitherPrograms() {
+        return [spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.TOKEN_2022_PROGRAM_ID];
+    }
+    /**
+     * Whether the account query should require the account to exist.
+     */
+    requireToExist() {
+        return true;
+    }
+}
+exports.MintCache = MintCache;
+/**
+ * Singleton instance of MintCache
+ */
+MintCache._instance = null;

package/dist/classes/account-cache/TokenCache.d.ts

@@ -0,0 +1,33 @@
+import * as web3 from "@solana/web3.js";
+import { AccountCache } from "./AccountCache";
+/**
+ * Singleton instance of AccountCache for mint accounts.
+ */
+export declare class TokenCache extends AccountCache {
+    /**
+     * Singleton instance of TokenCache
+     */
+    private static _instance;
+    /**
+     * Instantiate the TokenCache class
+     *
+     * @param connection The Solana connection
+     */
+    private constructor();
+    /**
+     * Get the singleton instance of TokenCache
+     *
+     * @param connection The Solana connection
+     * @returns The TokenCache instance
+     */
+    static instance(connection: web3.Connection): TokenCache;
+    /**
+     * Criteria of accounts to be fetched must be only owned by the given programs
+     */
+    protected mustOwnedByEitherPrograms(): web3.PublicKey[];
+    /**
+     * Whether the account query should require the account to exist.
+     */
+    protected requireToExist(): boolean;
+}
+//# sourceMappingURL=TokenCache.d.ts.map

package/dist/classes/account-cache/TokenCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenCache.d.ts","sourceRoot":"","sources":["../../../src/classes/account-cache/TokenCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;GAEG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAE1C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS,CAA2B;IAEnD;;;;OAIG;IACH,OAAO;IAIP;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,GAAG,UAAU;IAOxD;;OAEG;IACH,SAAS,CAAC,yBAAyB,IAAI,IAAI,CAAC,SAAS,EAAE;IAIvD;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,OAAO;CAGpC"}

package/dist/classes/account-cache/TokenCache.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenCache = void 0;
+const AccountCache_1 = require("./AccountCache");
+const spl_token_1 = require("@solana/spl-token");
+/**
+ * Singleton instance of AccountCache for mint accounts.
+ */
+class TokenCache extends AccountCache_1.AccountCache {
+    /**
+     * Instantiate the TokenCache class
+     *
+     * @param connection The Solana connection
+     */
+    constructor(connection) {
+        super(connection);
+    }
+    /**
+     * Get the singleton instance of TokenCache
+     *
+     * @param connection The Solana connection
+     * @returns The TokenCache instance
+     */
+    static instance(connection) {
+        if (!TokenCache._instance) {
+            TokenCache._instance = new TokenCache(connection);
+        }
+        return TokenCache._instance;
+    }
+    /**
+     * Criteria of accounts to be fetched must be only owned by the given programs
+     */
+    mustOwnedByEitherPrograms() {
+        return [spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.TOKEN_2022_PROGRAM_ID];
+    }
+    /**
+     * Whether the account query should require the account to exist.
+     */
+    requireToExist() {
+        return false;
+    }
+}
+exports.TokenCache = TokenCache;
+/**
+ * Singleton instance of TokenCache
+ */
+TokenCache._instance = null;

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+export declare class AppError extends Error {
+    readonly isErrorHandled: boolean;
+    readonly stackTrace: string[];
+    readonly errorMsg: string;
+    constructor(message: string, _module: string, stackTrace?: string);
+    static handleErrorAsync<T>(fn: () => Promise<T>): Promise<T>;
+    static handleErrorSync<T>(fn: () => T): T;
+}
+export declare class UniversalErrorHandler {
+    static catchErrorsAsync<T>(moduleName: string, fn: () => Promise<T>): Promise<T>;
+    static catchErrorsSync<T>(moduleName: string, fn: () => T): T;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,qBAAa,QAAS,SAAQ,KAAK;IAEjC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAQ;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;WAgCpD,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASlE,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;CAQ1C;AAGD,qBAAa,qBAAqB;WACnB,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAatF,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;CAY9D"}