@human-protocol/sdk 6.1.0 → 7.0.0

package/dist/staking/staking_utils.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StakingUtils = void 0;
+const ethers_1 = require("ethers");
+const constants_1 = require("../constants");
+const enums_1 = require("../enums");
+const error_1 = require("../error");
+const staking_1 = require("../graphql/queries/staking");
+const utils_1 = require("../utils");
+/**
+ * Utility helpers for Staking-related queries.
+ *
+ * @example
+ * ```ts
+ * import { StakingUtils, ChainId } from '@human-protocol/sdk';
+ *
+ * const staker = await StakingUtils.getStaker(
+ *   ChainId.POLYGON_AMOY,
+ *   '0xYourStakerAddress'
+ * );
+ * console.log('Staked amount:', staker.stakedAmount);
+ * ```
+ */
+class StakingUtils {
+    /**
+     * Gets staking info for a staker from the subgraph.
+     *
+     * @param chainId - Network in which the staking contract is deployed
+     * @param stakerAddress - Address of the staker
+     * @param options - Optional configuration for subgraph requests.
+     * @returns Staker info from subgraph
+     * @throws ErrorInvalidStakerAddressProvided If the staker address is invalid
+     * @throws ErrorUnsupportedChainID If the chain ID is not supported
+     * @throws ErrorStakerNotFound If the staker is not found
+     *
+     * @example
+     * ```ts
+     * import { StakingUtils, ChainId } from '@human-protocol/sdk';
+     *
+     * const staker = await StakingUtils.getStaker(
+     *   ChainId.POLYGON_AMOY,
+     *   '0xYourStakerAddress'
+     * );
+     * console.log('Staked amount:', staker.stakedAmount);
+     * ```
+     */
+    static async getStaker(chainId, stakerAddress, options) {
+        if (!ethers_1.ethers.isAddress(stakerAddress)) {
+            throw error_1.ErrorInvalidStakerAddressProvided;
+        }
+        const networkData = constants_1.NETWORKS[chainId];
+        if (!networkData) {
+            throw error_1.ErrorUnsupportedChainID;
+        }
+        const { staker } = await (0, utils_1.customGqlFetch)((0, utils_1.getSubgraphUrl)(networkData), staking_1.GET_STAKER_BY_ADDRESS_QUERY, { id: stakerAddress.toLowerCase() }, options);
+        if (!staker) {
+            throw error_1.ErrorStakerNotFound;
+        }
+        return mapStaker(staker);
+    }
+    /**
+     * Gets all stakers from the subgraph with filters, pagination and ordering.
+     *
+     * @param filter - Stakers filter with pagination and ordering
+     * @param options - Optional configuration for subgraph requests.
+     * @returns Array of stakers
+     * @throws ErrorUnsupportedChainID If the chain ID is not supported
+     *
+     * @example
+     * ```ts
+     * import { ChainId } from '@human-protocol/sdk';
+     *
+     * const filter = {
+     *   chainId: ChainId.POLYGON_AMOY,
+     *   minStakedAmount: '1000000000000000000', // 1 token in WEI
+     * };
+     * const stakers = await StakingUtils.getStakers(filter);
+     * console.log('Stakers:', stakers.length);
+     * ```
+     */
+    static async getStakers(filter, options) {
+        const first = filter.first !== undefined ? Math.min(filter.first, 1000) : 10;
+        const skip = filter.skip || 0;
+        const orderDirection = filter.orderDirection || enums_1.OrderDirection.DESC;
+        const orderBy = filter.orderBy || 'lastDepositTimestamp';
+        const networkData = constants_1.NETWORKS[filter.chainId];
+        if (!networkData) {
+            throw error_1.ErrorUnsupportedChainID;
+        }
+        const { stakers } = await (0, utils_1.customGqlFetch)((0, utils_1.getSubgraphUrl)(networkData), (0, staking_1.GET_STAKERS_QUERY)(filter), {
+            minStakedAmount: filter.minStakedAmount
+                ? filter.minStakedAmount
+                : undefined,
+            maxStakedAmount: filter.maxStakedAmount
+                ? filter.maxStakedAmount
+                : undefined,
+            minLockedAmount: filter.minLockedAmount
+                ? filter.minLockedAmount
+                : undefined,
+            maxLockedAmount: filter.maxLockedAmount
+                ? filter.maxLockedAmount
+                : undefined,
+            minWithdrawnAmount: filter.minWithdrawnAmount
+                ? filter.minWithdrawnAmount
+                : undefined,
+            maxWithdrawnAmount: filter.maxWithdrawnAmount
+                ? filter.maxWithdrawnAmount
+                : undefined,
+            minSlashedAmount: filter.minSlashedAmount
+                ? filter.minSlashedAmount
+                : undefined,
+            maxSlashedAmount: filter.maxSlashedAmount
+                ? filter.maxSlashedAmount
+                : undefined,
+            orderBy: orderBy,
+            orderDirection: orderDirection,
+            first: first,
+            skip: skip,
+        }, options);
+        if (!stakers) {
+            return [];
+        }
+        return stakers.map((s) => mapStaker(s));
+    }
+}
+exports.StakingUtils = StakingUtils;
+function mapStaker(s) {
+    return {
+        address: s.address,
+        stakedAmount: BigInt(s.stakedAmount),
+        lockedAmount: BigInt(s.lockedAmount),
+        withdrawableAmount: BigInt(s.withdrawnAmount),
+        slashedAmount: BigInt(s.slashedAmount),
+        lockedUntil: Number(s.lockedUntilTimestamp) * 1000,
+        lastDepositTimestamp: Number(s.lastDepositTimestamp) * 1000,
+    };
+}

package/dist/statistics/index.d.ts

@@ -0,0 +1,2 @@
+export { StatisticsUtils } from './statistics_utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/statistics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/statistics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/statistics/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatisticsUtils = void 0;
+var statistics_utils_1 = require("./statistics_utils");
+Object.defineProperty(exports, "StatisticsUtils", { enumerable: true, get: function () { return statistics_utils_1.StatisticsUtils; } });

package/dist/{statistics.d.ts → statistics/statistics_utils.d.ts}

@@ -1,5 +1,5 @@
-import { IDailyHMT, IEscrowStatistics, IHMTHolder, IHMTHoldersParams, IHMTStatistics, IPaymentStatistics, IStatisticsFilter, IWorkerStatistics, SubgraphOptions } from './interfaces';
-import { NetworkData } from './types';
+import { IDailyHMT, IEscrowStatistics, IHMTHolder, IHMTHoldersParams, IHMTStatistics, IPaymentStatistics, IStatisticsFilter, IWorkerStatistics, SubgraphOptions } from '../interfaces';
+import { NetworkData } from '../types';
 /**
  * Utility class for statistics-related queries.
  *
@@ -139,9 +139,7 @@ export declare class StatisticsUtils {
      * ```ts
      * interface IDailyPayment {
      *   timestamp: number;
-     *   totalAmountPaid: bigint;
      *   totalCount: number;
-     *   averageAmountPerWorker: bigint;
      * };
      *
      * interface IPaymentStatistics {
@@ -160,14 +158,7 @@ export declare class StatisticsUtils {
      *
      * const networkData = NETWORKS[ChainId.POLYGON_AMOY];
      * const paymentStats = await StatisticsUtils.getPaymentStatistics(networkData);
-     * console.log(
-     *   'Payment statistics:',
-     *   paymentStats.dailyPaymentsData.map((p) => ({
-     *     ...p,
-     *     totalAmountPaid: p.totalAmountPaid.toString(),
-     *     averageAmountPerWorker: p.averageAmountPerWorker.toString(),
-     *   }))
-     * );
+     * console.log('Payment statistics:', paymentStats.dailyPaymentsData);
      *
      * const paymentStatsRange = await StatisticsUtils.getPaymentStatistics(
      *   networkData,
@@ -281,4 +272,4 @@ export declare class StatisticsUtils {
      */
     static getHMTDailyData(networkData: NetworkData, filter?: IStatisticsFilter, options?: SubgraphOptions): Promise<IDailyHMT[]>;
 }
-//# sourceMappingURL=statistics.d.ts.map
+//# sourceMappingURL=statistics_utils.d.ts.map

package/dist/statistics/statistics_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statistics_utils.d.ts","sourceRoot":"","sources":["../../src/statistics/statistics_utils.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AASvC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;IAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqDG;WACU,mBAAmB,CAC9B,WAAW,EAAE,WAAW,EACxB,MAAM,GAAE,iBAAsB,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC;IA6C7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgDG;WACU,mBAAmB,CAC9B,WAAW,EAAE,WAAW,EACxB,MAAM,GAAE,iBAAsB,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC;IAkC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgDG;WACU,oBAAoB,CAC/B,WAAW,EAAE,WAAW,EACxB,MAAM,GAAE,iBAAsB,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,kBAAkB,CAAC;IAkC9B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;WACU,gBAAgB,CAC3B,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC;IAiB1B;;;;;;;;;;;;;;;;;;;;;OAqBG;WACU,aAAa,CACxB,WAAW,EAAE,WAAW,EACxB,MAAM,GAAE,iBAAsB,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC;IA0BxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+CG;WACU,eAAe,CAC1B,WAAW,EAAE,WAAW,EACxB,MAAM,GAAE,iBAAsB,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,SAAS,EAAE,CAAC;CAkCxB"}

package/dist/{statistics.js → statistics/statistics_utils.js}

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StatisticsUtils = void 0;
 /* eslint-disable @typescript-eslint/no-explicit-any */
-const enums_1 = require("./enums");
-const graphql_1 = require("./graphql");
-const utils_1 = require("./utils");
+const enums_1 = require("../enums");
+const graphql_1 = require("../graphql");
+const utils_1 = require("../utils");
 /**
  * Utility class for statistics-related queries.
  *
@@ -198,9 +198,7 @@ class StatisticsUtils {
      * ```ts
      * interface IDailyPayment {
      *   timestamp: number;
-     *   totalAmountPaid: bigint;
      *   totalCount: number;
-     *   averageAmountPerWorker: bigint;
      * };
      *
      * interface IPaymentStatistics {
@@ -219,14 +217,7 @@ class StatisticsUtils {
      *
      * const networkData = NETWORKS[ChainId.POLYGON_AMOY];
      * const paymentStats = await StatisticsUtils.getPaymentStatistics(networkData);
-     * console.log(
-     *   'Payment statistics:',
-     *   paymentStats.dailyPaymentsData.map((p) => ({
-     *     ...p,
-     *     totalAmountPaid: p.totalAmountPaid.toString(),
-     *     averageAmountPerWorker: p.averageAmountPerWorker.toString(),
-     *   }))
-     * );
+     * console.log('Payment statistics:', paymentStats.dailyPaymentsData);
      *
      * const paymentStatsRange = await StatisticsUtils.getPaymentStatistics(
      *   networkData,
@@ -254,12 +245,7 @@ class StatisticsUtils {
             return {
                 dailyPaymentsData: eventDayDatas.map((eventDayData) => ({
                     timestamp: +eventDayData.timestamp * 1000,
-                    totalAmountPaid: BigInt(eventDayData.dailyHMTPayoutAmount),
                     totalCount: +eventDayData.dailyPayoutCount,
-                    averageAmountPerWorker: eventDayData.dailyWorkerCount === '0'
-                        ? BigInt(0)
-                        : BigInt(eventDayData.dailyHMTPayoutAmount) /
-                            BigInt(eventDayData.dailyWorkerCount),
                 })),
             };
         }
@@ -296,7 +282,7 @@ class StatisticsUtils {
      */
     static async getHMTStatistics(networkData, options) {
         try {
-            const subgraphUrl = (0, utils_1.getSubgraphUrl)(networkData);
+            const subgraphUrl = (0, utils_1.getHMTSubgraphUrl)(networkData);
             const { hmtokenStatistics } = await (0, utils_1.customGqlFetch)(subgraphUrl, graphql_1.GET_HMTOKEN_STATISTICS_QUERY, options);
             return {
                 totalTransferAmount: BigInt(hmtokenStatistics.totalValueTransfered),
@@ -332,7 +318,7 @@ class StatisticsUtils {
      */
     static async getHMTHolders(networkData, params = {}, options) {
         try {
-            const subgraphUrl = (0, utils_1.getSubgraphUrl)(networkData);
+            const subgraphUrl = (0, utils_1.getHMTSubgraphUrl)(networkData);
             const { address, orderDirection } = params;
             const query = (0, graphql_1.GET_HOLDERS_QUERY)(address);
             const { holders } = await (0, utils_1.customGqlFetch)(subgraphUrl, query, {
@@ -399,11 +385,11 @@ class StatisticsUtils {
      */
     static async getHMTDailyData(networkData, filter = {}, options) {
         try {
-            const subgraphUrl = (0, utils_1.getSubgraphUrl)(networkData);
+            const subgraphUrl = (0, utils_1.getHMTSubgraphUrl)(networkData);
             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, utils_1.customGqlFetch)(subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(filter), {
+            const { eventDayDatas } = await (0, utils_1.customGqlFetch)(subgraphUrl, (0, graphql_1.GET_HMT_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,

package/dist/transaction/index.d.ts

@@ -0,0 +1,2 @@
+export { TransactionUtils } from './transaction_utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/transaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/transaction/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionUtils = void 0;
+var transaction_utils_1 = require("./transaction_utils");
+Object.defineProperty(exports, "TransactionUtils", { enumerable: true, get: function () { return transaction_utils_1.TransactionUtils; } });

package/dist/{transaction.d.ts → transaction/transaction_utils.d.ts}

@@ -1,5 +1,5 @@
-import { ChainId } from './enums';
-import { ITransaction, ITransactionsFilter, SubgraphOptions } from './interfaces';
+import { ChainId } from '../enums';
+import { ITransaction, ITransactionsFilter, SubgraphOptions } from '../interfaces';
 /**
  * Utility class for transaction-related queries.
  *
@@ -142,4 +142,4 @@ export declare class TransactionUtils {
      */
     static getTransactions(filter: ITransactionsFilter, options?: SubgraphOptions): Promise<ITransaction[]>;
 }
-//# sourceMappingURL=transaction.d.ts.map
+//# sourceMappingURL=transaction_utils.d.ts.map

package/dist/transaction/transaction_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction_utils.d.ts","sourceRoot":"","sources":["../../src/transaction/transaction_utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAkB,MAAM,UAAU,CAAC;AAWnD,OAAO,EAEL,YAAY,EACZ,mBAAmB,EACnB,eAAe,EAChB,MAAM,eAAe,CAAC;AAGvB;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgDG;WACiB,cAAc,CAChC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAyB/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0EG;WACiB,eAAe,CACjC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,YAAY,EAAE,CAAC;CAgD3B"}

package/dist/{transaction.js → transaction/transaction_utils.js}

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TransactionUtils = void 0;
 const ethers_1 = require("ethers");
-const constants_1 = require("./constants");
-const enums_1 = require("./enums");
-const error_1 = require("./error");
-const transaction_1 = require("./graphql/queries/transaction");
-const utils_1 = require("./utils");
+const constants_1 = require("../constants");
+const enums_1 = require("../enums");
+const error_1 = require("../error");
+const transaction_1 = require("../graphql/queries/transaction");
+const utils_1 = require("../utils");
 /**
  * Utility class for transaction-related queries.
  *

package/dist/types.d.ts

@@ -74,6 +74,14 @@ export type NetworkData = {
      * Subgraph URL API key
      */
     subgraphUrlApiKey: string;
+    /**
+     * HMT statistics subgraph URL
+     */
+    hmtSubgraphUrl?: string;
+    /**
+     * HMT statistics subgraph URL API key
+     */
+    hmtSubgraphUrlApiKey?: string;
     /**
      * Old subgraph URL
      */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEpD;;;;GAIG;AACH,oBAAY,YAAY;IACtB;;OAEG;IACH,QAAQ,IAAA;IACR;;OAEG;IACH,OAAO,IAAA;IACP;;OAEG;IACH,OAAO,IAAA;IACP;;OAEG;IACH,IAAI,IAAA;IACJ;;OAEG;IACH,QAAQ,IAAA;IACR;;OAEG;IACH,SAAS,IAAA;IACT;;OAEG;IACH,QAAQ,IAAA;CACT;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,WAAW,CAAC;AAE3D,MAAM,MAAM,wBAAwB,GAAG,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEpD;;;;GAIG;AACH,oBAAY,YAAY;IACtB;;OAEG;IACH,QAAQ,IAAA;IACR;;OAEG;IACH,OAAO,IAAA;IACP;;OAEG;IACH,OAAO,IAAA;IACP;;OAEG;IACH,IAAI,IAAA;IACJ;;OAEG;IACH,QAAQ,IAAA;IACR;;OAEG;IACH,SAAS,IAAA;IACT;;OAEG;IACH,QAAQ,IAAA;CACT;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,WAAW,CAAC;AAE3D,MAAM,MAAM,wBAAwB,GAAG,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/utils.d.ts

@@ -27,6 +27,13 @@ export declare const isValidUrl: (url: string) => boolean;
  * @returns True if the string is valid JSON, false otherwise
  */
 export declare const isValidJson: (input: string) => boolean;
+/**
+ * Extracts a readable message from unknown error values.
+ *
+ * @param error - Unknown error value
+ * @returns Human-readable error message
+ */
+export declare const getErrorMessage: (error: unknown) => string;
 /**
  * Gets the subgraph URL for the given network, using API key if available.
  *
@@ -34,6 +41,14 @@ export declare const isValidJson: (input: string) => boolean;
  * @returns The subgraph URL with API key if available
  */
 export declare const getSubgraphUrl: (networkData: NetworkData) => string;
+/**
+ * Gets the HMT statistics subgraph URL for the given network.
+ * Falls back to the default subgraph URL when a dedicated HMT endpoint is not configured.
+ *
+ * @param networkData - The network data containing subgraph URLs
+ * @returns The HMT statistics subgraph URL with API key if available
+ */
+export declare const getHMTSubgraphUrl: (networkData: NetworkData) => string;
 /**
  * Converts a Date object to Unix timestamp (seconds since epoch).
  *

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;;;;;;;;GAWG;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,WAUtD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,IAAI,KAAG,MAE7C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,GAAG,KAAG,OAS3C,CAAC;AAaF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,GAAU,CAAC,GAAG,GAAG,EAC1C,KAAK,MAAM,EACX,OAAO,GAAG,EACV,YAAY,GAAG,EACf,UAAU,eAAe,KACxB,OAAO,CAAC,CAAC,CA4CX,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;;;;;;;;GAWG;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,eAAe,GAAI,OAAO,OAAO,KAAG,MAUhD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,WAAW,WAUtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,aAAa,WAAW,WAWzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,IAAI,KAAG,MAE7C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,GAAG,KAAG,OAS3C,CAAC;AA6CF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,GAAU,CAAC,GAAG,GAAG,EAC1C,KAAK,MAAM,EACX,OAAO,GAAG,EACV,YAAY,GAAG,EACf,UAAU,eAAe,KACxB,OAAO,CAAC,CAAC,CAiDX,CAAC"}

package/dist/utils.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.customGqlFetch = exports.isIndexerError = exports.getUnixTimestamp = exports.getSubgraphUrl = exports.isValidJson = exports.isValidUrl = exports.throwError = void 0;
+exports.customGqlFetch = exports.isIndexerError = exports.getUnixTimestamp = exports.getHMTSubgraphUrl = exports.getSubgraphUrl = exports.getErrorMessage = 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"));
@@ -76,6 +76,24 @@ const isValidJson = (input) => {
     }
 };
 exports.isValidJson = isValidJson;
+/**
+ * Extracts a readable message from unknown error values.
+ *
+ * @param error - Unknown error value
+ * @returns Human-readable error message
+ */
+const getErrorMessage = (error) => {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    try {
+        return JSON.stringify(error);
+    }
+    catch {
+        return String(error);
+    }
+};
+exports.getErrorMessage = getErrorMessage;
 /**
  * Gets the subgraph URL for the given network, using API key if available.
  *
@@ -94,6 +112,26 @@ const getSubgraphUrl = (networkData) => {
     return subgraphUrl;
 };
 exports.getSubgraphUrl = getSubgraphUrl;
+/**
+ * Gets the HMT statistics subgraph URL for the given network.
+ * Falls back to the default subgraph URL when a dedicated HMT endpoint is not configured.
+ *
+ * @param networkData - The network data containing subgraph URLs
+ * @returns The HMT statistics subgraph URL with API key if available
+ */
+const getHMTSubgraphUrl = (networkData) => {
+    let subgraphUrl = networkData.hmtSubgraphUrl || networkData.subgraphUrl;
+    if (process.env.SUBGRAPH_API_KEY) {
+        subgraphUrl =
+            networkData.hmtSubgraphUrlApiKey || networkData.subgraphUrlApiKey;
+    }
+    else if (networkData.chainId !== enums_1.ChainId.LOCALHOST) {
+        // eslint-disable-next-line no-console
+        console.warn(error_1.WarnSubgraphApiKeyNotProvided);
+    }
+    return subgraphUrl;
+};
+exports.getHMTSubgraphUrl = getHMTSubgraphUrl;
 /**
  * Converts a Date object to Unix timestamp (seconds since epoch).
  *
@@ -114,6 +152,29 @@ const isIndexerError = (error) => {
     return errorMessage.toLowerCase().includes('bad indexers');
 };
 exports.isIndexerError = isIndexerError;
+const getSubgraphErrorMessage = (error) => {
+    return (error?.response?.errors?.[0]?.message ||
+        error?.message ||
+        error?.toString?.() ||
+        'Subgraph request failed');
+};
+const getSubgraphStatusCode = (error) => {
+    if (typeof error?.response?.status === 'number') {
+        return error.response.status;
+    }
+    if (typeof error?.status === 'number') {
+        return error.status;
+    }
+    return undefined;
+};
+const toSubgraphError = (error, url) => {
+    const message = getSubgraphErrorMessage(error);
+    const statusCode = getSubgraphStatusCode(error);
+    if ((0, exports.isIndexerError)(error)) {
+        return new error_1.SubgraphBadIndexerError(message, url, statusCode);
+    }
+    return new error_1.SubgraphRequestError(message, url, statusCode);
+};
 const sleep = (ms) => {
     return new Promise((resolve) => setTimeout(resolve, ms));
 };
@@ -143,7 +204,12 @@ const customGqlFetch = async (url, query, variables, options) => {
         }
         : undefined;
     if (!options) {
-        return await (0, graphql_request_1.default)(url, query, variables, headers);
+        try {
+            return await (0, graphql_request_1.default)(url, query, variables, headers);
+        }
+        catch (error) {
+            throw toSubgraphError(error, url);
+        }
     }
     const hasMaxRetries = options.maxRetries !== undefined;
     const hasBaseDelay = options.baseDelay !== undefined;
@@ -162,9 +228,10 @@ const customGqlFetch = async (url, query, variables, options) => {
             return await (0, graphql_request_1.default)(targetUrl, query, variables, headers);
         }
         catch (error) {
-            lastError = error;
+            const wrappedError = toSubgraphError(error, targetUrl);
+            lastError = wrappedError;
             if (attempt === maxRetries || !(0, exports.isIndexerError)(error)) {
-                throw error;
+                throw wrappedError;
             }
             const delay = baseDelay * attempt;
             await sleep(delay);

package/dist/worker/index.d.ts

@@ -0,0 +1,2 @@
+export { WorkerUtils } from './worker_utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/worker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/worker/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerUtils = void 0;
+var worker_utils_1 = require("./worker_utils");
+Object.defineProperty(exports, "WorkerUtils", { enumerable: true, get: function () { return worker_utils_1.WorkerUtils; } });

package/dist/{worker.d.ts → worker/worker_utils.d.ts}

@@ -1,5 +1,5 @@
-import { ChainId } from './enums';
-import { IWorker, IWorkersFilter, SubgraphOptions } from './interfaces';
+import { ChainId } from '../enums';
+import { IWorker, IWorkersFilter, SubgraphOptions } from '../interfaces';
 /**
  * Utility class for worker-related operations.
  *
@@ -83,4 +83,4 @@ export declare class WorkerUtils {
      */
     static getWorkers(filter: IWorkersFilter, options?: SubgraphOptions): Promise<IWorker[]>;
 }
-//# sourceMappingURL=worker.d.ts.map
+//# sourceMappingURL=worker_utils.d.ts.map

package/dist/worker/worker_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker_utils.d.ts","sourceRoot":"","sources":["../../src/worker/worker_utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAkB,MAAM,UAAU,CAAC;AAInD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGzE;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;IACtB;;;;;;;;;;;;;;;;;;;;OAoBG;WACiB,SAAS,CAC3B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IA0B1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;WACiB,UAAU,CAC5B,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,OAAO,EAAE,CAAC;CAoCtB"}

package/dist/{worker.js → worker/worker_utils.js}

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkerUtils = void 0;
 const ethers_1 = require("ethers");
-const constants_1 = require("./constants");
-const enums_1 = require("./enums");
-const error_1 = require("./error");
-const worker_1 = require("./graphql/queries/worker");
-const utils_1 = require("./utils");
+const constants_1 = require("../constants");
+const enums_1 = require("../enums");
+const error_1 = require("../error");
+const worker_1 = require("../graphql/queries/worker");
+const utils_1 = require("../utils");
 /**
  * Utility class for worker-related operations.
  *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@human-protocol/sdk",
   "description": "Human Protocol SDK",
-  "version": "6.1.0",
+  "version": "7.0.0",
   "files": [
     "src",
     "dist"
@@ -38,7 +38,7 @@
     ]
   },
   "dependencies": {
-    "@human-protocol/core": "5.0.1",
+    "@human-protocol/core": "6.0.0",
     "axios": "^1.4.0",
     "ethers": "~6.15.0",
     "graphql": "^16.8.1",
@@ -47,7 +47,7 @@
     "openpgp": "^6.2.2",
     "secp256k1": "^5.0.1",
     "validator": "^13.12.0",
-    "vitest": "^3.0.9"
+    "vitest": "^4.0.18"
   },
   "devDependencies": {
     "@types/validator": "^13.15.4",
@@ -55,7 +55,7 @@
     "eslint-plugin-jest": "^28.9.0",
     "eslint-plugin-prettier": "^5.5.5",
     "glob": "^13.0.0",
-    "prettier": "^3.7.4",
+    "prettier": "^3.8.1",
     "ts-node": "^10.9.2",
     "typedoc": "^0.28.15",
     "typedoc-plugin-markdown": "^4.9.0",