@human-protocol/sdk 3.0.1 → 3.0.3

package/dist/statistics.d.ts

@@ -1,5 +1,5 @@
-import { EscrowStatistics, HMTStatistics, PaymentStatistics, WorkerStatistics, HMTHolder } from './graphql';
-import { IHMTHoldersParams, IStatisticsParams } from './interfaces';
+import { EscrowStatistics, HMTStatistics, PaymentStatistics, WorkerStatistics, HMTHolder, DailyHMTData } from './graphql';
+import { IHMTHoldersParams, IStatisticsFilter } from './interfaces';
 import { NetworkData } from './types';
 /**
  * ## Introduction
@@ -54,10 +54,12 @@ export declare class StatisticsClient {
      * **Input parameters**
      *
      * ```ts
-     * interface IStatisticsParams {
+     * interface IStatisticsFilter {
      *   from?: Date;
      *   to?: Date;
-     *   limit?: number;
+     *   first?: number; // (Optional) Number of transactions per page. Default is 10.
+     *   skip?: number; // (Optional) Number of transactions to skip. Default is 0.
+     *   orderDirection?: OrderDirection; // (Optional) Order of the results. Default is ASC.
      * }
      * ```
      *
@@ -78,7 +80,7 @@ export declare class StatisticsClient {
      * ```
      *
      *
-     * @param {IStatisticsParams} params Statistics params with duration data
+     * @param {IStatisticsFilter} filter Statistics params with duration data
      * @returns {EscrowStatistics} Escrow statistics data.
      *
      *
@@ -96,7 +98,7 @@ export declare class StatisticsClient {
      * });
      * ```
      */
-    getEscrowStatistics(params?: IStatisticsParams): Promise<EscrowStatistics>;
+    getEscrowStatistics(filter?: IStatisticsFilter): Promise<EscrowStatistics>;
     /**
      * This function returns the statistical data of workers.
      *
@@ -104,10 +106,12 @@ export declare class StatisticsClient {
      * **Input parameters**
      *
      * ```ts
-     * interface IStatisticsParams {
+     * interface IStatisticsFilter {
      *   from?: Date;
      *   to?: Date;
-     *   limit?: number;
+     *   first?: number; // (Optional) Number of transactions per page. Default is 10.
+     *   skip?: number; // (Optional) Number of transactions to skip. Default is 0.
+     *   orderDirection?: OrderDirection; // (Optional) Order of the results. Default is ASC.
      * }
      * ```
      *
@@ -123,7 +127,7 @@ export declare class StatisticsClient {
      * ```
      *
      *
-     * @param {IStatisticsParams} params Statistics params with duration data
+     * @param {IStatisticsFilter} filter Statistics params with duration data
      * @returns {WorkerStatistics} Worker statistics data.
      *
      *
@@ -141,7 +145,7 @@ export declare class StatisticsClient {
      * });
      * ```
      */
-    getWorkerStatistics(params?: IStatisticsParams): Promise<WorkerStatistics>;
+    getWorkerStatistics(filter?: IStatisticsFilter): Promise<WorkerStatistics>;
     /**
      * This function returns the statistical data of payments.
      *
@@ -149,10 +153,12 @@ export declare class StatisticsClient {
      * **Input parameters**
      *
      * ```ts
-     * interface IStatisticsParams {
+     * interface IStatisticsFilter {
      *   from?: Date;
      *   to?: Date;
-     *   limit?: number;
+     *   first?: number; // (Optional) Number of transactions per page. Default is 10.
+     *   skip?: number; // (Optional) Number of transactions to skip. Default is 0.
+     *   orderDirection?: OrderDirection; // (Optional) Order of the results. Default is ASC.
      * }
      * ```
      *
@@ -170,7 +176,7 @@ export declare class StatisticsClient {
      * ```
      *
      *
-     * @param {IStatisticsParams} params Statistics params with duration data
+     * @param {IStatisticsFilter} filter Statistics params with duration data
      * @returns {PaymentStatistics} Payment statistics data.
      *
      *
@@ -209,44 +215,19 @@ export declare class StatisticsClient {
      * );
      * ```
      */
-    getPaymentStatistics(params?: IStatisticsParams): Promise<PaymentStatistics>;
+    getPaymentStatistics(filter?: IStatisticsFilter): Promise<PaymentStatistics>;
     /**
      * This function returns the statistical data of HMToken.
      *
      *
-     * **Input parameters**
-     *
-     * ```ts
-     * interface IStatisticsParams {
-     *   from?: Date;
-     *   to?: Date;
-     *   limit?: number;
-     * }
-     * ```
-     *
-     * ```ts
-     * type HMTHolder = {
-     *   address: string;
-     *   balance: BigNumber;
-     * }
-     *
-     * type DailyHMTData = {
-     *   timestamp: Date;
-     *   totalTransactionAmount: BigNumber;
-     *   totalTransactionCount: number;
-     * };
-     *
      * type HMTStatistics = {
      *   totalTransferAmount: BigNumber;
      *   totalTransferCount: BigNumber;
      *   totalHolders: number;
-     *   holders: HMTHolder[];
-     *   dailyHMTData: DailyHMTData[];
      * };
      * ```
      *
      *
-     * @param {IStatisticsParams} params Statistics params with duration data
      * @returns {HMTStatistics} HMToken statistics data.
      *
      *
@@ -262,36 +243,10 @@ export declare class StatisticsClient {
      * console.log('HMT statistics:', {
      *   ...hmtStatistics,
      *   totalTransferAmount: hmtStatistics.totalTransferAmount.toString(),
-     *   holders: hmtStatistics.holders.map((h) => ({
-     *     ...h,
-     *     balance: h.balance.toString(),
-     *   })),
-     *   dailyHMTData: hmtStatistics.dailyHMTData.map((d) => ({
-     *     ...d,
-     *     totalTransactionAmount: d.totalTransactionAmount.toString(),
-     *   })),
-     * });
-     *
-     * const hmtStatisticsRange = await statisticsClient.getHMTStatistics({
-     *   from: new Date(2023, 4, 8),
-     *   to: new Date(2023, 5, 8),
-     * });
-     *
-     * console.log('HMT statistics from 5/8 - 6/8:', {
-     *   ...hmtStatisticsRange,
-     *   totalTransferAmount: hmtStatisticsRange.totalTransferAmount.toString(),
-     *   holders: hmtStatisticsRange.holders.map((h) => ({
-     *     ...h,
-     *     balance: h.balance.toString(),
-     *   })),
-     *   dailyHMTData: hmtStatisticsRange.dailyHMTData.map((d) => ({
-     *     ...d,
-     *     totalTransactionAmount: d.totalTransactionAmount.toString(),
-     *   })),
      * });
      * ```
      */
-    getHMTStatistics(params?: IStatisticsParams): Promise<HMTStatistics>;
+    getHMTStatistics(): Promise<HMTStatistics>;
     /**
      * This function returns the holders of the HMToken with optional filters and ordering.
      *
@@ -318,5 +273,56 @@ export declare class StatisticsClient {
      * ```
      */
     getHMTHolders(params?: IHMTHoldersParams): Promise<HMTHolder[]>;
+    /**
+     * This function returns the statistical data of HMToken day by day.
+     *
+     *
+     * **Input parameters**
+     *
+     * ```ts
+     * interface IStatisticsFilter {
+     *   from?: Date;
+     *   to?: Date;
+     *   first?: number; // (Optional) Number of transactions per page. Default is 10.
+     *   skip?: number; // (Optional) Number of transactions to skip. Default is 0.
+     *   orderDirection?: OrderDirection; // (Optional) Order of the results. Default is ASC.
+     * }
+     * ```
+     *
+     * ```ts
+     * type DailyHMTData = {
+     *   timestamp: Date;
+     *   totalTransactionAmount: bigint;
+     *   totalTransactionCount: number;
+     *   dailyUniqueSenders: number;
+     *   dailyUniqueReceivers: number;
+     * }
+     * ```
+     *
+     *
+     * @param {IStatisticsFilter} filter Statistics params with duration data
+     * @returns {DailyHMTData[]} Daily HMToken statistics data.
+     *
+     *
+     * **Code example**
+     *
+     * ```ts
+     * import { StatisticsClient, ChainId, NETWORKS } from '@human-protocol/sdk';
+     *
+     * const statisticsClient = new StatisticsClient(NETWORKS[ChainId.POLYGON_AMOY]);
+     *
+     * const dailyHMTStats = await statisticsClient.getHMTStatistics();
+     *
+     * console.log('Daily HMT statistics:', dailyHMTStats);
+     *
+     * const hmtStatisticsRange = await statisticsClient.getHMTStatistics({
+     *   from: new Date(2023, 4, 8),
+     *   to: new Date(2023, 5, 8),
+     * });
+     *
+     * console.log('HMT statistics from 5/8 - 6/8:', hmtStatisticsRange);
+     * ```
+     */
+    getHMTDailyData(filter?: IStatisticsFilter): Promise<DailyHMTData[]>;
 }
 //# sourceMappingURL=statistics.d.ts.map

package/dist/statistics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"statistics.d.ts","sourceRoot":"","sources":["../src/statistics.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,gBAAgB,EAGhB,aAAa,EAEb,iBAAiB,EACjB,gBAAgB,EAEhB,SAAS,EACV,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,gBAAgB;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;gBACS,WAAW,EAAE,WAAW;IAKpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgDG;IACG,mBAAmB,CACvB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,gBAAgB,CAAC;IA6B5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACG,mBAAmB,CACvB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,gBAAgB,CAAC;IAoB5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkEG;IACG,oBAAoB,CACxB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IA0B7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgFG;IACG,gBAAgB,CACpB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,aAAa,CAAC;IA0CzB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,aAAa,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAuB1E"}
+{"version":3,"file":"statistics.d.ts","sourceRoot":"","sources":["../src/statistics.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,gBAAgB,EAGhB,aAAa,EAEb,iBAAiB,EACjB,gBAAgB,EAEhB,SAAS,EACT,YAAY,EACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAItC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,gBAAgB;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;gBACS,WAAW,EAAE,WAAW;IAKpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDG;IACG,mBAAmB,CACvB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,gBAAgB,CAAC;IAqC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACG,mBAAmB,CACvB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,gBAAgB,CAAC;IA4B5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoEG;IACG,oBAAoB,CACxB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IAkC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAkBhD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,aAAa,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAwBzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiDG;IACG,eAAe,CACnB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC;CA8B3B"}

package/dist/statistics.js

@@ -9,6 +9,7 @@ const ethers_1 = require("ethers");
 const graphql_request_1 = __importDefault(require("graphql-request"));
 const graphql_1 = require("./graphql");
 const utils_1 = require("./utils");
+const enums_1 = require("./enums");
 /**
  * ## Introduction
  *
@@ -63,10 +64,12 @@ class StatisticsClient {
      * **Input parameters**
      *
      * ```ts
-     * interface IStatisticsParams {
+     * interface IStatisticsFilter {
      *   from?: Date;
      *   to?: Date;
-     *   limit?: number;
+     *   first?: number; // (Optional) Number of transactions per page. Default is 10.
+     *   skip?: number; // (Optional) Number of transactions to skip. Default is 0.
+     *   orderDirection?: OrderDirection; // (Optional) Order of the results. Default is ASC.
      * }
      * ```
      *
@@ -87,7 +90,7 @@ class StatisticsClient {
      * ```
      *
      *
-     * @param {IStatisticsParams} params Statistics params with duration data
+     * @param {IStatisticsFilter} filter Statistics params with duration data
      * @returns {EscrowStatistics} Escrow statistics data.
      *
      *
@@ -105,12 +108,18 @@ class StatisticsClient {
      * });
      * ```
      */
-    async getEscrowStatistics(params = {}) {
+    async getEscrowStatistics(filter = {}) {
         try {
+            const first = filter.first !== undefined ? Math.min(filter.first, 1000) : 10;
+            const skip = filter.skip || 0;
+            const orderDirection = filter.orderDirection || enums_1.OrderDirection.ASC;
             const { escrowStatistics } = await (0, graphql_request_1.default)(this.subgraphUrl, graphql_1.GET_ESCROW_STATISTICS_QUERY);
-            const { eventDayDatas } = await (0, graphql_request_1.default)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(params), {
-                from: params.from ? params.from.getTime() / 1000 : undefined,
-                to: params.to ? params.to.getTime() / 1000 : undefined,
+            const { eventDayDatas } = await (0, graphql_request_1.default)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(filter), {
+                from: filter.from ? filter.from.getTime() / 1000 : undefined,
+                to: filter.to ? filter.to.getTime() / 1000 : undefined,
+                orderDirection: orderDirection,
+                first: first,
+                skip: skip,
             });
             return {
                 totalEscrows: +escrowStatistics.totalEscrowCount,
@@ -135,10 +144,12 @@ class StatisticsClient {
      * **Input parameters**
      *
      * ```ts
-     * interface IStatisticsParams {
+     * interface IStatisticsFilter {
      *   from?: Date;
      *   to?: Date;
-     *   limit?: number;
+     *   first?: number; // (Optional) Number of transactions per page. Default is 10.
+     *   skip?: number; // (Optional) Number of transactions to skip. Default is 0.
+     *   orderDirection?: OrderDirection; // (Optional) Order of the results. Default is ASC.
      * }
      * ```
      *
@@ -154,7 +165,7 @@ class StatisticsClient {
      * ```
      *
      *
-     * @param {IStatisticsParams} params Statistics params with duration data
+     * @param {IStatisticsFilter} filter Statistics params with duration data
      * @returns {WorkerStatistics} Worker statistics data.
      *
      *
@@ -172,11 +183,17 @@ class StatisticsClient {
      * });
      * ```
      */
-    async getWorkerStatistics(params = {}) {
+    async getWorkerStatistics(filter = {}) {
         try {
-            const { eventDayDatas } = await (0, graphql_request_1.default)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(params), {
-                from: params.from ? params.from.getTime() / 1000 : undefined,
-                to: params.to ? params.to.getTime() / 1000 : undefined,
+            const first = filter.first !== undefined ? Math.min(filter.first, 1000) : 10;
+            const skip = filter.skip || 0;
+            const orderDirection = filter.orderDirection || enums_1.OrderDirection.ASC;
+            const { eventDayDatas } = await (0, graphql_request_1.default)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(filter), {
+                from: filter.from ? filter.from.getTime() / 1000 : undefined,
+                to: filter.to ? filter.to.getTime() / 1000 : undefined,
+                orderDirection: orderDirection,
+                first: first,
+                skip: skip,
             });
             return {
                 dailyWorkersData: eventDayDatas.map((eventDayData) => ({
@@ -196,10 +213,12 @@ class StatisticsClient {
      * **Input parameters**
      *
      * ```ts
-     * interface IStatisticsParams {
+     * interface IStatisticsFilter {
      *   from?: Date;
      *   to?: Date;
-     *   limit?: number;
+     *   first?: number; // (Optional) Number of transactions per page. Default is 10.
+     *   skip?: number; // (Optional) Number of transactions to skip. Default is 0.
+     *   orderDirection?: OrderDirection; // (Optional) Order of the results. Default is ASC.
      * }
      * ```
      *
@@ -217,7 +236,7 @@ class StatisticsClient {
      * ```
      *
      *
-     * @param {IStatisticsParams} params Statistics params with duration data
+     * @param {IStatisticsFilter} filter Statistics params with duration data
      * @returns {PaymentStatistics} Payment statistics data.
      *
      *
@@ -256,11 +275,17 @@ class StatisticsClient {
      * );
      * ```
      */
-    async getPaymentStatistics(params = {}) {
+    async getPaymentStatistics(filter = {}) {
         try {
-            const { eventDayDatas } = await (0, graphql_request_1.default)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(params), {
-                from: params.from ? params.from.getTime() / 1000 : undefined,
-                to: params.to ? params.to.getTime() / 1000 : undefined,
+            const first = filter.first !== undefined ? Math.min(filter.first, 1000) : 10;
+            const skip = filter.skip || 0;
+            const orderDirection = filter.orderDirection || enums_1.OrderDirection.ASC;
+            const { eventDayDatas } = await (0, graphql_request_1.default)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(filter), {
+                from: filter.from ? filter.from.getTime() / 1000 : undefined,
+                to: filter.to ? filter.to.getTime() / 1000 : undefined,
+                orderDirection: orderDirection,
+                first: first,
+                skip: skip,
             });
             return {
                 dailyPaymentsData: eventDayDatas.map((eventDayData) => ({
@@ -282,39 +307,14 @@ class StatisticsClient {
      * This function returns the statistical data of HMToken.
      *
      *
-     * **Input parameters**
-     *
-     * ```ts
-     * interface IStatisticsParams {
-     *   from?: Date;
-     *   to?: Date;
-     *   limit?: number;
-     * }
-     * ```
-     *
-     * ```ts
-     * type HMTHolder = {
-     *   address: string;
-     *   balance: BigNumber;
-     * }
-     *
-     * type DailyHMTData = {
-     *   timestamp: Date;
-     *   totalTransactionAmount: BigNumber;
-     *   totalTransactionCount: number;
-     * };
-     *
      * type HMTStatistics = {
      *   totalTransferAmount: BigNumber;
      *   totalTransferCount: BigNumber;
      *   totalHolders: number;
-     *   holders: HMTHolder[];
-     *   dailyHMTData: DailyHMTData[];
      * };
      * ```
      *
      *
-     * @param {IStatisticsParams} params Statistics params with duration data
      * @returns {HMTStatistics} HMToken statistics data.
      *
      *
@@ -330,58 +330,16 @@ class StatisticsClient {
      * console.log('HMT statistics:', {
      *   ...hmtStatistics,
      *   totalTransferAmount: hmtStatistics.totalTransferAmount.toString(),
-     *   holders: hmtStatistics.holders.map((h) => ({
-     *     ...h,
-     *     balance: h.balance.toString(),
-     *   })),
-     *   dailyHMTData: hmtStatistics.dailyHMTData.map((d) => ({
-     *     ...d,
-     *     totalTransactionAmount: d.totalTransactionAmount.toString(),
-     *   })),
-     * });
-     *
-     * const hmtStatisticsRange = await statisticsClient.getHMTStatistics({
-     *   from: new Date(2023, 4, 8),
-     *   to: new Date(2023, 5, 8),
-     * });
-     *
-     * console.log('HMT statistics from 5/8 - 6/8:', {
-     *   ...hmtStatisticsRange,
-     *   totalTransferAmount: hmtStatisticsRange.totalTransferAmount.toString(),
-     *   holders: hmtStatisticsRange.holders.map((h) => ({
-     *     ...h,
-     *     balance: h.balance.toString(),
-     *   })),
-     *   dailyHMTData: hmtStatisticsRange.dailyHMTData.map((d) => ({
-     *     ...d,
-     *     totalTransactionAmount: d.totalTransactionAmount.toString(),
-     *   })),
      * });
      * ```
      */
-    async getHMTStatistics(params = {}) {
+    async getHMTStatistics() {
         try {
             const { hmtokenStatistics } = await (0, graphql_request_1.default)(this.subgraphUrl, graphql_1.GET_HMTOKEN_STATISTICS_QUERY);
-            const { holders } = await (0, graphql_request_1.default)(this.subgraphUrl, (0, graphql_1.GET_HOLDERS_QUERY)());
-            const { eventDayDatas } = await (0, graphql_request_1.default)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(params), {
-                from: params.from ? params.from.getTime() / 1000 : undefined,
-                to: params.to ? params.to.getTime() / 1000 : undefined,
-            });
             return {
                 totalTransferAmount: ethers_1.ethers.toBigInt(hmtokenStatistics.totalValueTransfered),
                 totalTransferCount: Number(hmtokenStatistics.totalTransferEventCount),
                 totalHolders: +hmtokenStatistics.holders,
-                holders: holders.map((holder) => ({
-                    address: holder.address,
-                    balance: ethers_1.ethers.toBigInt(holder.balance),
-                })),
-                dailyHMTData: eventDayDatas.map((eventDayData) => ({
-                    timestamp: new Date(+eventDayData.timestamp * 1000),
-                    totalTransactionAmount: ethers_1.ethers.toBigInt(eventDayData.dailyHMTTransferAmount),
-                    totalTransactionCount: +eventDayData.dailyHMTTransferCount,
-                    dailyUniqueSenders: +eventDayData.dailyUniqueSenders,
-                    dailyUniqueReceivers: +eventDayData.dailyUniqueReceivers,
-                })),
             };
         }
         catch (e) {
@@ -431,5 +389,79 @@ class StatisticsClient {
             return (0, utils_1.throwError)(e);
         }
     }
+    /**
+     * This function returns the statistical data of HMToken day by day.
+     *
+     *
+     * **Input parameters**
+     *
+     * ```ts
+     * interface IStatisticsFilter {
+     *   from?: Date;
+     *   to?: Date;
+     *   first?: number; // (Optional) Number of transactions per page. Default is 10.
+     *   skip?: number; // (Optional) Number of transactions to skip. Default is 0.
+     *   orderDirection?: OrderDirection; // (Optional) Order of the results. Default is ASC.
+     * }
+     * ```
+     *
+     * ```ts
+     * type DailyHMTData = {
+     *   timestamp: Date;
+     *   totalTransactionAmount: bigint;
+     *   totalTransactionCount: number;
+     *   dailyUniqueSenders: number;
+     *   dailyUniqueReceivers: number;
+     * }
+     * ```
+     *
+     *
+     * @param {IStatisticsFilter} filter Statistics params with duration data
+     * @returns {DailyHMTData[]} Daily HMToken statistics data.
+     *
+     *
+     * **Code example**
+     *
+     * ```ts
+     * import { StatisticsClient, ChainId, NETWORKS } from '@human-protocol/sdk';
+     *
+     * const statisticsClient = new StatisticsClient(NETWORKS[ChainId.POLYGON_AMOY]);
+     *
+     * const dailyHMTStats = await statisticsClient.getHMTStatistics();
+     *
+     * console.log('Daily HMT statistics:', dailyHMTStats);
+     *
+     * const hmtStatisticsRange = await statisticsClient.getHMTStatistics({
+     *   from: new Date(2023, 4, 8),
+     *   to: new Date(2023, 5, 8),
+     * });
+     *
+     * console.log('HMT statistics from 5/8 - 6/8:', hmtStatisticsRange);
+     * ```
+     */
+    async getHMTDailyData(filter = {}) {
+        try {
+            const first = filter.first !== undefined ? Math.min(filter.first, 1000) : 10;
+            const skip = filter.skip || 0;
+            const orderDirection = filter.orderDirection || enums_1.OrderDirection.ASC;
+            const { eventDayDatas } = await (0, graphql_request_1.default)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(filter), {
+                from: filter.from ? filter.from.getTime() / 1000 : undefined,
+                to: filter.to ? filter.to.getTime() / 1000 : undefined,
+                orderDirection: orderDirection,
+                first: first,
+                skip: skip,
+            });
+            return eventDayDatas.map((eventDayData) => ({
+                timestamp: new Date(+eventDayData.timestamp * 1000),
+                totalTransactionAmount: ethers_1.ethers.toBigInt(eventDayData.dailyHMTTransferAmount),
+                totalTransactionCount: +eventDayData.dailyHMTTransferCount,
+                dailyUniqueSenders: +eventDayData.dailyUniqueSenders,
+                dailyUniqueReceivers: +eventDayData.dailyUniqueReceivers,
+            }));
+        }
+        catch (e) {
+            return (0, utils_1.throwError)(e);
+        }
+    }
 }
 exports.StatisticsClient = StatisticsClient;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@human-protocol/sdk",
   "description": "Human Protocol SDK",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "files": [
     "src",
     "dist"