@human-protocol/sdk 5.0.0 → 5.1.0

package/dist/statistics.d.ts

@@ -1,4 +1,4 @@
-import { IDailyHMT, IEscrowStatistics, IHMTHolder, IHMTHoldersParams, IHMTStatistics, IPaymentStatistics, IStatisticsFilter, IWorkerStatistics } from './interfaces';
+import { IDailyHMT, IEscrowStatistics, IHMTHolder, IHMTHoldersParams, IHMTStatistics, IPaymentStatistics, IStatisticsFilter, IWorkerStatistics, SubgraphOptions } from './interfaces';
 import { NetworkData } from './types';
 /**
  * ## Introduction
@@ -73,6 +73,7 @@ export declare class StatisticsClient {
      * ```
      *
      * @param {IStatisticsFilter} filter Statistics params with duration data
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IEscrowStatistics>} Escrow statistics data.
      *
      * **Code example**
@@ -89,7 +90,7 @@ export declare class StatisticsClient {
      * });
      * ```
      */
-    getEscrowStatistics(filter?: IStatisticsFilter): Promise<IEscrowStatistics>;
+    getEscrowStatistics(filter?: IStatisticsFilter, options?: SubgraphOptions): Promise<IEscrowStatistics>;
     /**
      * This function returns the statistical data of workers.
      *
@@ -117,6 +118,7 @@ export declare class StatisticsClient {
      * ```
      *
      * @param {IStatisticsFilter} filter Statistics params with duration data
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IWorkerStatistics>} Worker statistics data.
      *
      * **Code example**
@@ -133,7 +135,7 @@ export declare class StatisticsClient {
      * });
      * ```
      */
-    getWorkerStatistics(filter?: IStatisticsFilter): Promise<IWorkerStatistics>;
+    getWorkerStatistics(filter?: IStatisticsFilter, options?: SubgraphOptions): Promise<IWorkerStatistics>;
     /**
      * This function returns the statistical data of payments.
      *
@@ -163,6 +165,7 @@ export declare class StatisticsClient {
      * ```
      *
      * @param {IStatisticsFilter} filter Statistics params with duration data
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IPaymentStatistics>} Payment statistics data.
      *
      * **Code example**
@@ -200,7 +203,7 @@ export declare class StatisticsClient {
      * );
      * ```
      */
-    getPaymentStatistics(filter?: IStatisticsFilter): Promise<IPaymentStatistics>;
+    getPaymentStatistics(filter?: IStatisticsFilter, options?: SubgraphOptions): Promise<IPaymentStatistics>;
     /**
      * This function returns the statistical data of HMToken.
      *
@@ -212,6 +215,7 @@ export declare class StatisticsClient {
      * };
      * ```
      *
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IHMTStatistics>} HMToken statistics data.
      *
      * **Code example**
@@ -229,13 +233,14 @@ export declare class StatisticsClient {
      * });
      * ```
      */
-    getHMTStatistics(): Promise<IHMTStatistics>;
+    getHMTStatistics(options?: SubgraphOptions): Promise<IHMTStatistics>;
     /**
      * This function returns the holders of the HMToken with optional filters and ordering.
      *
      * **Input parameters**
      *
      * @param {IHMTHoldersParams} params HMT Holders params with filters and ordering
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IHMTHolder[]>} List of HMToken holders.
      *
      * **Code example**
@@ -255,7 +260,7 @@ export declare class StatisticsClient {
      * })));
      * ```
      */
-    getHMTHolders(params?: IHMTHoldersParams): Promise<IHMTHolder[]>;
+    getHMTHolders(params?: IHMTHoldersParams, options?: SubgraphOptions): Promise<IHMTHolder[]>;
     /**
      * This function returns the statistical data of HMToken day by day.
      *
@@ -282,6 +287,7 @@ export declare class StatisticsClient {
      * ```
      *
      * @param {IStatisticsFilter} filter Statistics params with duration data
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IDailyHMT[]>} Daily HMToken statistics data.
      *
      * **Code example**
@@ -303,6 +309,6 @@ export declare class StatisticsClient {
      * console.log('HMT statistics from 5/8 - 6/8:', hmtStatisticsRange);
      * ```
      */
-    getHMTDailyData(filter?: IStatisticsFilter): Promise<IDailyHMT[]>;
+    getHMTDailyData(filter?: IStatisticsFilter, options?: SubgraphOptions): Promise<IDailyHMT[]>;
 }
 //# 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":"AAcA,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,gBAAgB;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;gBACS,WAAW,EAAE,WAAW;IAKpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+CG;IACG,mBAAmB,CACvB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IAuC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACG,mBAAmB,CACvB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IA4B7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiEG;IACG,oBAAoB,CACxB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,kBAAkB,CAAC;IAkC9B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,gBAAgB,IAAI,OAAO,CAAC,cAAc,CAAC;IAgBjD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,aAAa,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAwB1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACG,eAAe,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CA4B5E"}
+{"version":3,"file":"statistics.d.ts","sourceRoot":"","sources":["../src/statistics.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAQtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;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,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC;IA4C7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACG,mBAAmB,CACvB,MAAM,GAAE,iBAAsB,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC;IAiC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkEG;IACG,oBAAoB,CACxB,MAAM,GAAE,iBAAsB,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,kBAAkB,CAAC;IAuC9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,gBAAgB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAgB1E;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,aAAa,CACjB,MAAM,GAAE,iBAAsB,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC;IAyBxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+CG;IACG,eAAe,CACnB,MAAM,GAAE,iBAAsB,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,SAAS,EAAE,CAAC;CAiCxB"}

package/dist/statistics.js

@@ -1,11 +1,7 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StatisticsClient = void 0;
 /* eslint-disable @typescript-eslint/no-explicit-any */
-const graphql_request_1 = __importDefault(require("graphql-request"));
 const enums_1 = require("./enums");
 const graphql_1 = require("./graphql");
 const utils_1 = require("./utils");
@@ -83,6 +79,7 @@ class StatisticsClient {
      * ```
      *
      * @param {IStatisticsFilter} filter Statistics params with duration data
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IEscrowStatistics>} Escrow statistics data.
      *
      * **Code example**
@@ -99,19 +96,19 @@ class StatisticsClient {
      * });
      * ```
      */
-    async getEscrowStatistics(filter = {}) {
+    async getEscrowStatistics(filter = {}, options) {
         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)(filter), {
+            const { escrowStatistics } = await (0, utils_1.customGqlFetch)(this.subgraphUrl, graphql_1.GET_ESCROW_STATISTICS_QUERY, options);
+            const { eventDayDatas } = await (0, utils_1.customGqlFetch)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(filter), {
                 from: filter.from ? (0, utils_1.getUnixTimestamp)(filter.from) : undefined,
                 to: filter.to ? (0, utils_1.getUnixTimestamp)(filter.to) : undefined,
                 orderDirection: orderDirection,
                 first: first,
                 skip: skip,
-            });
+            }, options);
             return {
                 totalEscrows: escrowStatistics?.totalEscrowCount
                     ? +escrowStatistics.totalEscrowCount
@@ -157,6 +154,7 @@ class StatisticsClient {
      * ```
      *
      * @param {IStatisticsFilter} filter Statistics params with duration data
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IWorkerStatistics>} Worker statistics data.
      *
      * **Code example**
@@ -173,18 +171,18 @@ class StatisticsClient {
      * });
      * ```
      */
-    async getWorkerStatistics(filter = {}) {
+    async getWorkerStatistics(filter = {}, options) {
         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), {
+            const { eventDayDatas } = await (0, utils_1.customGqlFetch)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(filter), {
                 from: filter.from ? (0, utils_1.getUnixTimestamp)(filter.from) : undefined,
                 to: filter.to ? (0, utils_1.getUnixTimestamp)(filter.to) : undefined,
                 orderDirection: orderDirection,
                 first: first,
                 skip: skip,
-            });
+            }, options);
             return {
                 dailyWorkersData: eventDayDatas.map((eventDayData) => ({
                     timestamp: +eventDayData.timestamp * 1000,
@@ -225,6 +223,7 @@ class StatisticsClient {
      * ```
      *
      * @param {IStatisticsFilter} filter Statistics params with duration data
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IPaymentStatistics>} Payment statistics data.
      *
      * **Code example**
@@ -262,18 +261,18 @@ class StatisticsClient {
      * );
      * ```
      */
-    async getPaymentStatistics(filter = {}) {
+    async getPaymentStatistics(filter = {}, options) {
         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), {
+            const { eventDayDatas } = await (0, utils_1.customGqlFetch)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(filter), {
                 from: filter.from ? (0, utils_1.getUnixTimestamp)(filter.from) : undefined,
                 to: filter.to ? (0, utils_1.getUnixTimestamp)(filter.to) : undefined,
                 orderDirection: orderDirection,
                 first: first,
                 skip: skip,
-            });
+            }, options);
             return {
                 dailyPaymentsData: eventDayDatas.map((eventDayData) => ({
                     timestamp: +eventDayData.timestamp * 1000,
@@ -301,6 +300,7 @@ class StatisticsClient {
      * };
      * ```
      *
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IHMTStatistics>} HMToken statistics data.
      *
      * **Code example**
@@ -318,9 +318,9 @@ class StatisticsClient {
      * });
      * ```
      */
-    async getHMTStatistics() {
+    async getHMTStatistics(options) {
         try {
-            const { hmtokenStatistics } = await (0, graphql_request_1.default)(this.subgraphUrl, graphql_1.GET_HMTOKEN_STATISTICS_QUERY);
+            const { hmtokenStatistics } = await (0, utils_1.customGqlFetch)(this.subgraphUrl, graphql_1.GET_HMTOKEN_STATISTICS_QUERY, options);
             return {
                 totalTransferAmount: BigInt(hmtokenStatistics.totalValueTransfered),
                 totalTransferCount: +hmtokenStatistics.totalTransferEventCount,
@@ -337,6 +337,7 @@ class StatisticsClient {
      * **Input parameters**
      *
      * @param {IHMTHoldersParams} params HMT Holders params with filters and ordering
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IHMTHolder[]>} List of HMToken holders.
      *
      * **Code example**
@@ -356,15 +357,15 @@ class StatisticsClient {
      * })));
      * ```
      */
-    async getHMTHolders(params = {}) {
+    async getHMTHolders(params = {}, options) {
         try {
             const { address, orderDirection } = params;
             const query = (0, graphql_1.GET_HOLDERS_QUERY)(address);
-            const { holders } = await (0, graphql_request_1.default)(this.subgraphUrl, query, {
+            const { holders } = await (0, utils_1.customGqlFetch)(this.subgraphUrl, query, {
                 address,
                 orderBy: 'balance',
                 orderDirection,
-            });
+            }, options);
             return holders.map((holder) => ({
                 address: holder.address,
                 balance: BigInt(holder.balance),
@@ -400,6 +401,7 @@ class StatisticsClient {
      * ```
      *
      * @param {IStatisticsFilter} filter Statistics params with duration data
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IDailyHMT[]>} Daily HMToken statistics data.
      *
      * **Code example**
@@ -421,18 +423,18 @@ class StatisticsClient {
      * console.log('HMT statistics from 5/8 - 6/8:', hmtStatisticsRange);
      * ```
      */
-    async getHMTDailyData(filter = {}) {
+    async getHMTDailyData(filter = {}, options) {
         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), {
+            const { eventDayDatas } = await (0, utils_1.customGqlFetch)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(filter), {
                 from: filter.from ? (0, utils_1.getUnixTimestamp)(filter.from) : undefined,
                 to: filter.to ? (0, utils_1.getUnixTimestamp)(filter.to) : undefined,
                 orderDirection: orderDirection,
                 first: first,
                 skip: skip,
-            });
+            }, options);
             return eventDayDatas.map((eventDayData) => ({
                 timestamp: +eventDayData.timestamp * 1000,
                 totalTransactionAmount: BigInt(eventDayData.dailyHMTTransferAmount),

package/dist/transaction.d.ts

@@ -1,5 +1,5 @@
 import { ChainId } from './enums';
-import { ITransaction, ITransactionsFilter } from './interfaces';
+import { ITransaction, ITransactionsFilter, SubgraphOptions } from './interfaces';
 export declare class TransactionUtils {
     /**
      * This function returns the transaction data for the given hash.
@@ -34,6 +34,7 @@ export declare class TransactionUtils {
      *
      * @param {ChainId} chainId The chain ID.
      * @param {string} hash The transaction hash.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<ITransaction | null>} - Returns the transaction details or null if not found.
      *
      * **Code example**
@@ -44,7 +45,7 @@ export declare class TransactionUtils {
      * const transaction = await TransactionUtils.getTransaction(ChainId.POLYGON, '0x62dD51230A30401C455c8398d06F85e4EaB6309f');
      * ```
      */
-    static getTransaction(chainId: ChainId, hash: string): Promise<ITransaction | null>;
+    static getTransaction(chainId: ChainId, hash: string, options?: SubgraphOptions): Promise<ITransaction | null>;
     /**
      * This function returns all transaction details based on the provided filter.
      *
@@ -99,6 +100,7 @@ export declare class TransactionUtils {
      * ```
      *
      * @param {ITransactionsFilter} filter Filter for the transactions.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<ITransaction[]>} Returns an array with all the transaction details.
      *
      * **Code example**
@@ -117,6 +119,6 @@ export declare class TransactionUtils {
      * const transactions = await TransactionUtils.getTransactions(filter);
      * ```
      */
-    static getTransactions(filter: ITransactionsFilter): Promise<ITransaction[]>;
+    static getTransactions(filter: ITransactionsFilter, options?: SubgraphOptions): Promise<ITransaction[]>;
 }
 //# sourceMappingURL=transaction.d.ts.map

package/dist/transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAC;AAWlD,OAAO,EAEL,YAAY,EACZ,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAGtB,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;WACiB,cAAc,CAChC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAoB/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuEG;WACiB,eAAe,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;CA2C3B"}
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAC;AAWlD,OAAO,EAEL,YAAY,EACZ,mBAAmB,EACnB,eAAe,EAChB,MAAM,cAAc,CAAC;AAGtB,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;WACiB,cAAc,CAChC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAyB/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwEG;WACiB,eAAe,CACjC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,YAAY,EAAE,CAAC;CAgD3B"}

package/dist/transaction.js

@@ -1,12 +1,8 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TransactionUtils = void 0;
 /* eslint-disable @typescript-eslint/no-explicit-any */
 const ethers_1 = require("ethers");
-const graphql_request_1 = __importDefault(require("graphql-request"));
 const constants_1 = require("./constants");
 const enums_1 = require("./enums");
 const error_1 = require("./error");
@@ -46,6 +42,7 @@ class TransactionUtils {
      *
      * @param {ChainId} chainId The chain ID.
      * @param {string} hash The transaction hash.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<ITransaction | null>} - Returns the transaction details or null if not found.
      *
      * **Code example**
@@ -56,7 +53,7 @@ class TransactionUtils {
      * const transaction = await TransactionUtils.getTransaction(ChainId.POLYGON, '0x62dD51230A30401C455c8398d06F85e4EaB6309f');
      * ```
      */
-    static async getTransaction(chainId, hash) {
+    static async getTransaction(chainId, hash, options) {
         if (!ethers_1.ethers.isHexString(hash)) {
             throw error_1.ErrorInvalidHashProvided;
         }
@@ -64,9 +61,9 @@ class TransactionUtils {
         if (!networkData) {
             throw error_1.ErrorUnsupportedChainID;
         }
-        const { transaction } = await (0, graphql_request_1.default)((0, utils_1.getSubgraphUrl)(networkData), transaction_1.GET_TRANSACTION_QUERY, {
+        const { transaction } = await (0, utils_1.customGqlFetch)((0, utils_1.getSubgraphUrl)(networkData), transaction_1.GET_TRANSACTION_QUERY, {
             hash: hash.toLowerCase(),
-        });
+        }, options);
         if (!transaction)
             return null;
         return mapTransaction(transaction);
@@ -125,6 +122,7 @@ class TransactionUtils {
      * ```
      *
      * @param {ITransactionsFilter} filter Filter for the transactions.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<ITransaction[]>} Returns an array with all the transaction details.
      *
      * **Code example**
@@ -143,7 +141,7 @@ class TransactionUtils {
      * const transactions = await TransactionUtils.getTransactions(filter);
      * ```
      */
-    static async getTransactions(filter) {
+    static async getTransactions(filter, options) {
         if ((!!filter.startDate || !!filter.endDate) &&
             (!!filter.startBlock || !!filter.endBlock)) {
             throw error_1.ErrorCannotUseDateAndBlockSimultaneously;
@@ -155,7 +153,7 @@ class TransactionUtils {
         if (!networkData) {
             throw error_1.ErrorUnsupportedChainID;
         }
-        const { transactions } = await (0, graphql_request_1.default)((0, utils_1.getSubgraphUrl)(networkData), (0, transaction_1.GET_TRANSACTIONS_QUERY)(filter), {
+        const { transactions } = await (0, utils_1.customGqlFetch)((0, utils_1.getSubgraphUrl)(networkData), (0, transaction_1.GET_TRANSACTIONS_QUERY)(filter), {
             fromAddress: filter?.fromAddress,
             toAddress: filter?.toAddress,
             startDate: filter?.startDate
@@ -170,7 +168,7 @@ class TransactionUtils {
             orderDirection: orderDirection,
             first: first,
             skip: skip,
-        });
+        }, options);
         if (!transactions) {
             return [];
         }

package/dist/utils.d.ts

@@ -1,4 +1,5 @@
 import { NetworkData } from './types';
+import { SubgraphOptions } from './interfaces';
 /**
  * **Handle and throw the error.*
  *
@@ -34,4 +35,10 @@ export declare const getSubgraphUrl: (networkData: NetworkData) => string;
  * @returns {number}
  */
 export declare const getUnixTimestamp: (date: Date) => number;
+export declare const isIndexerError: (error: any) => boolean;
+/**
+ * Execute a GraphQL request with automatic retry logic for bad indexer errors.
+ * Only retries if options is provided.
+ */
+export declare const customGqlFetch: <T = any>(url: string, query: any, variables?: any, options?: SubgraphOptions) => Promise<T>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,GAAG,UAgBhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,OAMxC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,OAO3C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,WAAW,WAatD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,IAAI,KAAG,MAE7C,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,GAAG,UAgBhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,OAMxC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,OAO3C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,WAAW,WAatD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,IAAI,KAAG,MAE7C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,GAAG,KAAG,OAS3C,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,CAAC,GAAG,GAAG,EAC1C,KAAK,MAAM,EACX,OAAO,GAAG,EACV,YAAY,GAAG,EACf,UAAU,eAAe,KACxB,OAAO,CAAC,CAAC,CAmCX,CAAC"}

package/dist/utils.js

@@ -1,8 +1,12 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getUnixTimestamp = exports.getSubgraphUrl = exports.isValidJson = exports.isValidUrl = exports.throwError = void 0;
+exports.customGqlFetch = exports.isIndexerError = exports.getUnixTimestamp = exports.getSubgraphUrl = exports.isValidJson = exports.isValidUrl = exports.throwError = void 0;
 /* eslint-disable @typescript-eslint/no-explicit-any */
 const ethers_1 = require("ethers");
+const graphql_request_1 = __importDefault(require("graphql-request"));
 const validator_1 = require("validator");
 const constants_1 = require("./constants");
 const enums_1 = require("./enums");
@@ -95,3 +99,49 @@ const getUnixTimestamp = (date) => {
     return Math.floor(date.getTime() / 1000);
 };
 exports.getUnixTimestamp = getUnixTimestamp;
+const isIndexerError = (error) => {
+    if (!error)
+        return false;
+    const errorMessage = error.response?.errors?.[0]?.message ||
+        error.message ||
+        error.toString() ||
+        '';
+    return errorMessage.toLowerCase().includes('bad indexers');
+};
+exports.isIndexerError = isIndexerError;
+const sleep = (ms) => {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+};
+/**
+ * Execute a GraphQL request with automatic retry logic for bad indexer errors.
+ * Only retries if options is provided.
+ */
+const customGqlFetch = async (url, query, variables, options) => {
+    if (!options) {
+        return await (0, graphql_request_1.default)(url, query, variables);
+    }
+    if ((options.maxRetries && options.baseDelay === undefined) ||
+        (options.baseDelay && options.maxRetries === undefined)) {
+        throw error_1.ErrorRetryParametersMissing;
+    }
+    let lastError;
+    for (let attempt = 0; attempt <= options.maxRetries; attempt++) {
+        try {
+            const result = await (0, graphql_request_1.default)(url, query, variables);
+            return result;
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === options.maxRetries) {
+                throw error;
+            }
+            if (!(0, exports.isIndexerError)(error)) {
+                throw error;
+            }
+            const delay = options.baseDelay * attempt;
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+};
+exports.customGqlFetch = customGqlFetch;

package/dist/worker.d.ts

@@ -1,11 +1,12 @@
 import { ChainId } from './enums';
-import { IWorker, IWorkersFilter } from './interfaces';
+import { IWorker, IWorkersFilter, SubgraphOptions } from './interfaces';
 export declare class WorkerUtils {
     /**
      * This function returns the worker data for the given address.
      *
      * @param {ChainId} chainId The chain ID.
      * @param {string} address The worker address.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IWorker | null>} - Returns the worker details or null if not found.
      *
      * **Code example**
@@ -16,7 +17,7 @@ export declare class WorkerUtils {
      * const worker = await WorkerUtils.getWorker(ChainId.POLYGON, '0x1234567890abcdef1234567890abcdef12345678');
      * ```
      */
-    static getWorker(chainId: ChainId, address: string): Promise<IWorker | null>;
+    static getWorker(chainId: ChainId, address: string, options?: SubgraphOptions): Promise<IWorker | null>;
     /**
      * This function returns all worker details based on the provided filter.
      *
@@ -43,6 +44,7 @@ export declare class WorkerUtils {
      * ```
      *
      * @param {IWorkersFilter} filter Filter for the workers.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IWorker[]>} Returns an array with all the worker details.
      *
      * **Code example**
@@ -58,6 +60,6 @@ export declare class WorkerUtils {
      * const workers = await WorkerUtils.getWorkers(filter);
      * ```
      */
-    static getWorkers(filter: IWorkersFilter): Promise<IWorker[]>;
+    static getWorkers(filter: IWorkersFilter, options?: SubgraphOptions): Promise<IWorker[]>;
 }
 //# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAC;AAIlD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGvD,qBAAa,WAAW;IACtB;;;;;;;;;;;;;;OAcG;WACiB,SAAS,CAC3B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAqB1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;WACiB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CA+B3E"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAC;AAIlD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGxE,qBAAa,WAAW;IACtB;;;;;;;;;;;;;;;OAeG;WACiB,SAAS,CAC3B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IA0B1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;WACiB,UAAU,CAC5B,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,OAAO,EAAE,CAAC;CAoCtB"}

package/dist/worker.js

@@ -1,11 +1,7 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkerUtils = void 0;
 const ethers_1 = require("ethers");
-const graphql_request_1 = __importDefault(require("graphql-request"));
 const constants_1 = require("./constants");
 const enums_1 = require("./enums");
 const error_1 = require("./error");
@@ -17,6 +13,7 @@ class WorkerUtils {
      *
      * @param {ChainId} chainId The chain ID.
      * @param {string} address The worker address.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IWorker | null>} - Returns the worker details or null if not found.
      *
      * **Code example**
@@ -27,7 +24,7 @@ class WorkerUtils {
      * const worker = await WorkerUtils.getWorker(ChainId.POLYGON, '0x1234567890abcdef1234567890abcdef12345678');
      * ```
      */
-    static async getWorker(chainId, address) {
+    static async getWorker(chainId, address, options) {
         const networkData = constants_1.NETWORKS[chainId];
         if (!networkData) {
             throw error_1.ErrorUnsupportedChainID;
@@ -35,9 +32,9 @@ class WorkerUtils {
         if (!ethers_1.ethers.isAddress(address)) {
             throw error_1.ErrorInvalidAddress;
         }
-        const { worker } = await (0, graphql_request_1.default)((0, utils_1.getSubgraphUrl)(networkData), worker_1.GET_WORKER_QUERY, {
+        const { worker } = await (0, utils_1.customGqlFetch)((0, utils_1.getSubgraphUrl)(networkData), worker_1.GET_WORKER_QUERY, {
             address: address.toLowerCase(),
-        });
+        }, options);
         if (!worker)
             return null;
         return mapWorker(worker);
@@ -68,6 +65,7 @@ class WorkerUtils {
      * ```
      *
      * @param {IWorkersFilter} filter Filter for the workers.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IWorker[]>} Returns an array with all the worker details.
      *
      * **Code example**
@@ -83,7 +81,7 @@ class WorkerUtils {
      * const workers = await WorkerUtils.getWorkers(filter);
      * ```
      */
-    static async getWorkers(filter) {
+    static async getWorkers(filter, options) {
         const first = filter.first !== undefined ? Math.min(filter.first, 1000) : 10;
         const skip = filter.skip || 0;
         const orderBy = filter.orderBy || 'payoutCount';
@@ -95,13 +93,13 @@ class WorkerUtils {
         if (filter.address && !ethers_1.ethers.isAddress(filter.address)) {
             throw error_1.ErrorInvalidAddress;
         }
-        const { workers } = await (0, graphql_request_1.default)((0, utils_1.getSubgraphUrl)(networkData), (0, worker_1.GET_WORKERS_QUERY)(filter), {
+        const { workers } = await (0, utils_1.customGqlFetch)((0, utils_1.getSubgraphUrl)(networkData), (0, worker_1.GET_WORKERS_QUERY)(filter), {
             address: filter?.address?.toLowerCase(),
             first: first,
             skip: skip,
             orderBy: orderBy,
             orderDirection: orderDirection,
-        });
+        }, options);
         if (!workers) {
             return [];
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@human-protocol/sdk",
   "description": "Human Protocol SDK",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "files": [
     "src",
     "dist"
@@ -51,6 +51,7 @@
     "vitest": "^3.0.9"
   },
   "devDependencies": {
+    "@types/validator": "^13.15.4",
     "eslint": "^8.55.0",
     "prettier": "^3.4.2",
     "ts-node": "^10.9.2",