@human-protocol/sdk 3.0.8 → 4.0.1

package/dist/staking.d.ts

@@ -2,22 +2,23 @@ import { EscrowFactory, HMToken, Staking } from '@human-protocol/core/typechain-
 import { ContractRunner, Overrides } from 'ethers';
 import { BaseEthersClient } from './base';
 import { NetworkData } from './types';
+import { StakerInfo } from './interfaces';
 /**
  * ## Introduction
  *
- * This client enables to perform actions on staking contracts and obtain staking information from both the contracts and subgraph.
+ * This client enables performing actions on staking contracts and obtaining staking information from both the contracts and subgraph.
  *
  * Internally, the SDK will use one network or another according to the network ID of the `runner`.
  * To use this client, it is recommended to initialize it using the static `build` method.
  *
  * ```ts
- * static async build(runner: ContractRunner);
+ * static async build(runner: ContractRunner): Promise<StakingClient>;
  * ```
  *
  * A `Signer` or a `Provider` should be passed depending on the use case of this module:
  *
- * - **Signer**: when the user wants to use this model in order to send transactions caling the contract functions.
- * - **Provider**: when the user wants to use this model in order to get information from the contracts or subgraph.
+ * - **Signer**: when the user wants to use this model to send transactions calling the contract functions.
+ * - **Provider**: when the user wants to use this model to get information from the contracts or subgraph.
  *
  * ## Installation
  *
@@ -35,21 +36,21 @@ import { NetworkData } from './types';
  *
  * ### Signer
  *
- * **Using private key(backend)**
+ * **Using private key (backend)**
  *
  * ```ts
  * import { StakingClient } from '@human-protocol/sdk';
  * import { Wallet, providers } from 'ethers';
  *
  * const rpcUrl = 'YOUR_RPC_URL';
- * const privateKey = 'YOUR_PRIVATE_KEY'
+ * const privateKey = 'YOUR_PRIVATE_KEY';
  *
  * const provider = new providers.JsonRpcProvider(rpcUrl);
  * const signer = new Wallet(privateKey, provider);
  * const stakingClient = await StakingClient.build(signer);
  * ```
  *
- * **Using Wagmi(frontend)**
+ * **Using Wagmi (frontend)**
  *
  * ```ts
  * import { useSigner, useChainId } from 'wagmi';
@@ -105,7 +106,6 @@ export declare class StakingClient extends BaseEthersClient {
      * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
-     *
      * **Code example**
      *
      * ```ts
@@ -113,7 +113,7 @@ export declare class StakingClient extends BaseEthersClient {
      * import { StakingClient } from '@human-protocol/sdk';
      *
      * const rpcUrl = 'YOUR_RPC_URL';
-     * const privateKey = 'YOUR_PRIVATE_KEY'
+     * const privateKey = 'YOUR_PRIVATE_KEY';
      *
      * const provider = new providers.JsonRpcProvider(rpcUrl);
      * const signer = new Wallet(privateKey, provider);
@@ -133,7 +133,6 @@ export declare class StakingClient extends BaseEthersClient {
      * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
-     *
      * **Code example**
      *
      * ```ts
@@ -141,7 +140,7 @@ export declare class StakingClient extends BaseEthersClient {
      * import { StakingClient } from '@human-protocol/sdk';
      *
      * const rpcUrl = 'YOUR_RPC_URL';
-     * const privateKey = 'YOUR_PRIVATE_KEY'
+     * const privateKey = 'YOUR_PRIVATE_KEY';
      *
      * const provider = new providers.JsonRpcProvider(rpcUrl);
      * const signer = new Wallet(privateKey, provider);
@@ -149,7 +148,7 @@ export declare class StakingClient extends BaseEthersClient {
      *
      * const amount = ethers.parseUnits(5, 'ether'); //convert from ETH to WEI
      * await stakingClient.approveStake(amount); // if it was already approved before, this is not necessary
-     * await stakingClient.approveStake(amount);
+     * await stakingClient.stake(amount);
      * ```
      */
     stake(amount: bigint, txOptions?: Overrides): Promise<void>;
@@ -162,7 +161,6 @@ export declare class StakingClient extends BaseEthersClient {
      * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
-     *
      * **Code example**
      *
      * ```ts
@@ -170,7 +168,7 @@ export declare class StakingClient extends BaseEthersClient {
      * import { StakingClient } from '@human-protocol/sdk';
      *
      * const rpcUrl = 'YOUR_RPC_URL';
-     * const privateKey = 'YOUR_PRIVATE_KEY'
+     * const privateKey = 'YOUR_PRIVATE_KEY';
      *
      * const provider = new providers.JsonRpcProvider(rpcUrl);
      * const signer = new Wallet(privateKey, provider);
@@ -182,14 +180,13 @@ export declare class StakingClient extends BaseEthersClient {
      */
     unstake(amount: bigint, txOptions?: Overrides): Promise<void>;
     /**
-     * This function withdraws unstaked and non locked tokens form staking contract to the user wallet.
+     * This function withdraws unstaked and non-locked tokens from staking contract to the user wallet.
      *
      * > Must have tokens available to withdraw
      *
      * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
-     *
      * **Code example**
      *
      * ```ts
@@ -197,7 +194,7 @@ export declare class StakingClient extends BaseEthersClient {
      * import { StakingClient } from '@human-protocol/sdk';
      *
      * const rpcUrl = 'YOUR_RPC_URL';
-     * const privateKey = 'YOUR_PRIVATE_KEY'
+     * const privateKey = 'YOUR_PRIVATE_KEY';
      *
      * const provider = new providers.JsonRpcProvider(rpcUrl);
      * const signer = new Wallet(privateKey, provider);
@@ -208,16 +205,15 @@ export declare class StakingClient extends BaseEthersClient {
      */
     withdraw(txOptions?: Overrides): Promise<void>;
     /**
-     * This function reduces the allocated amount by an staker in an escrow and transfers those tokens to the reward pool. This allows the slasher to claim them later.
+     * This function reduces the allocated amount by a staker in an escrow and transfers those tokens to the reward pool. This allows the slasher to claim them later.
      *
      * @param {string} slasher Wallet address from who requested the slash
      * @param {string} staker Wallet address from who is going to be slashed
      * @param {string} escrowAddress Address of the escrow that the slash is made
+     * @param {bigint} amount Amount in WEI of tokens to slash.
      * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
-     * @param {bigint} amount Amount in WEI of tokens to unstake.
      * @returns Returns void if successful. Throws error if any.
      *
-     *
      * **Code example**
      *
      * ```ts
@@ -225,7 +221,7 @@ export declare class StakingClient extends BaseEthersClient {
      * import { StakingClient } from '@human-protocol/sdk';
      *
      * const rpcUrl = 'YOUR_RPC_URL';
-     * const privateKey = 'YOUR_PRIVATE_KEY'
+     * const privateKey = 'YOUR_PRIVATE_KEY';
      *
      * const provider = new providers.JsonRpcProvider(rpcUrl);
      * const signer = new Wallet(privateKey, provider);
@@ -236,5 +232,26 @@ export declare class StakingClient extends BaseEthersClient {
      * ```
      */
     slash(slasher: string, staker: string, escrowAddress: string, amount: bigint, txOptions?: Overrides): Promise<void>;
+    /**
+     * Retrieves comprehensive staking information for a staker.
+     *
+     * @param {string} stakerAddress - The address of the staker.
+     * @returns {Promise<StakerInfo>}
+     *
+     * **Code example**
+     *
+     * ```ts
+     * import { StakingClient } from '@human-protocol/sdk';
+     *
+     * const rpcUrl = 'YOUR_RPC_URL';
+     *
+     * const provider = new providers.JsonRpcProvider(rpcUrl);
+     * const stakingClient = await StakingClient.build(provider);
+     *
+     * const stakingInfo = await stakingClient.getStakerInfo('0xYourStakerAddress');
+     * console.log(stakingInfo.tokensStaked);
+     * ```
+     */
+    getStakerInfo(stakerAddress: string): Promise<StakerInfo>;
 }
 //# sourceMappingURL=staking.d.ts.map

package/dist/staking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"staking.d.ts","sourceRoot":"","sources":["../src/staking.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,OAAO,EAEP,OAAO,EAER,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAU,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAc1C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,qBAAa,aAAc,SAAQ,gBAAgB;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,qBAAqB,EAAE,aAAa,CAAC;IAE5C;;;;;OAKG;gBACS,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW;IAmB5D;;;;;;;;OAQG;WACiB,KAAK,CAAC,MAAM,EAAE,cAAc;IAiBhD;;;;OAIG;YACW,gBAAgB;IAU9B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IAEU,YAAY,CACvB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IAEU,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,SAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5E;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IAEU,OAAO,CAClB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;IAiBhB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IAEU,QAAQ,CAAC,SAAS,GAAE,SAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IAEU,KAAK,CAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;CAmCjB"}
+{"version":3,"file":"staking.d.ts","sourceRoot":"","sources":["../src/staking.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,OAAO,EAEP,OAAO,EAER,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAU,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAc1C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,qBAAa,aAAc,SAAQ,gBAAgB;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,qBAAqB,EAAE,aAAa,CAAC;IAE5C;;;;;OAKG;gBACS,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW;IAmB5D;;;;;;;;OAQG;WACiB,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBzE;;;;OAIG;YACW,gBAAgB;IAU9B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IAEU,YAAY,CACvB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IAEU,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,SAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5E;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IAEU,OAAO,CAClB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;IAiBhB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IAEU,QAAQ,CAAC,SAAS,GAAE,SAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IAEU,KAAK,CAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;IAoChB;;;;;;;;;;;;;;;;;;;OAmBG;IACU,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAgCvE"}

package/dist/staking.js

@@ -20,19 +20,19 @@ const utils_1 = require("./utils");
 /**
  * ## Introduction
  *
- * This client enables to perform actions on staking contracts and obtain staking information from both the contracts and subgraph.
+ * This client enables performing actions on staking contracts and obtaining staking information from both the contracts and subgraph.
  *
  * Internally, the SDK will use one network or another according to the network ID of the `runner`.
  * To use this client, it is recommended to initialize it using the static `build` method.
  *
  * ```ts
- * static async build(runner: ContractRunner);
+ * static async build(runner: ContractRunner): Promise<StakingClient>;
  * ```
  *
  * A `Signer` or a `Provider` should be passed depending on the use case of this module:
  *
- * - **Signer**: when the user wants to use this model in order to send transactions caling the contract functions.
- * - **Provider**: when the user wants to use this model in order to get information from the contracts or subgraph.
+ * - **Signer**: when the user wants to use this model to send transactions calling the contract functions.
+ * - **Provider**: when the user wants to use this model to get information from the contracts or subgraph.
  *
  * ## Installation
  *
@@ -50,21 +50,21 @@ const utils_1 = require("./utils");
  *
  * ### Signer
  *
- * **Using private key(backend)**
+ * **Using private key (backend)**
  *
  * ```ts
  * import { StakingClient } from '@human-protocol/sdk';
  * import { Wallet, providers } from 'ethers';
  *
  * const rpcUrl = 'YOUR_RPC_URL';
- * const privateKey = 'YOUR_PRIVATE_KEY'
+ * const privateKey = 'YOUR_PRIVATE_KEY';
  *
  * const provider = new providers.JsonRpcProvider(rpcUrl);
  * const signer = new Wallet(privateKey, provider);
  * const stakingClient = await StakingClient.build(signer);
  * ```
  *
- * **Using Wagmi(frontend)**
+ * **Using Wagmi (frontend)**
  *
  * ```ts
  * import { useSigner, useChainId } from 'wagmi';
@@ -140,7 +140,6 @@ class StakingClient extends base_1.BaseEthersClient {
      * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
-     *
      * **Code example**
      *
      * ```ts
@@ -148,7 +147,7 @@ class StakingClient extends base_1.BaseEthersClient {
      * import { StakingClient } from '@human-protocol/sdk';
      *
      * const rpcUrl = 'YOUR_RPC_URL';
-     * const privateKey = 'YOUR_PRIVATE_KEY'
+     * const privateKey = 'YOUR_PRIVATE_KEY';
      *
      * const provider = new providers.JsonRpcProvider(rpcUrl);
      * const signer = new Wallet(privateKey, provider);
@@ -182,7 +181,6 @@ class StakingClient extends base_1.BaseEthersClient {
      * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
-     *
      * **Code example**
      *
      * ```ts
@@ -190,7 +188,7 @@ class StakingClient extends base_1.BaseEthersClient {
      * import { StakingClient } from '@human-protocol/sdk';
      *
      * const rpcUrl = 'YOUR_RPC_URL';
-     * const privateKey = 'YOUR_PRIVATE_KEY'
+     * const privateKey = 'YOUR_PRIVATE_KEY';
      *
      * const provider = new providers.JsonRpcProvider(rpcUrl);
      * const signer = new Wallet(privateKey, provider);
@@ -198,7 +196,7 @@ class StakingClient extends base_1.BaseEthersClient {
      *
      * const amount = ethers.parseUnits(5, 'ether'); //convert from ETH to WEI
      * await stakingClient.approveStake(amount); // if it was already approved before, this is not necessary
-     * await stakingClient.approveStake(amount);
+     * await stakingClient.stake(amount);
      * ```
      */
     async stake(amount, txOptions = {}) {
@@ -225,7 +223,6 @@ class StakingClient extends base_1.BaseEthersClient {
      * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
-     *
      * **Code example**
      *
      * ```ts
@@ -233,7 +230,7 @@ class StakingClient extends base_1.BaseEthersClient {
      * import { StakingClient } from '@human-protocol/sdk';
      *
      * const rpcUrl = 'YOUR_RPC_URL';
-     * const privateKey = 'YOUR_PRIVATE_KEY'
+     * const privateKey = 'YOUR_PRIVATE_KEY';
      *
      * const provider = new providers.JsonRpcProvider(rpcUrl);
      * const signer = new Wallet(privateKey, provider);
@@ -259,14 +256,13 @@ class StakingClient extends base_1.BaseEthersClient {
         }
     }
     /**
-     * This function withdraws unstaked and non locked tokens form staking contract to the user wallet.
+     * This function withdraws unstaked and non-locked tokens from staking contract to the user wallet.
      *
      * > Must have tokens available to withdraw
      *
      * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
-     *
      * **Code example**
      *
      * ```ts
@@ -274,7 +270,7 @@ class StakingClient extends base_1.BaseEthersClient {
      * import { StakingClient } from '@human-protocol/sdk';
      *
      * const rpcUrl = 'YOUR_RPC_URL';
-     * const privateKey = 'YOUR_PRIVATE_KEY'
+     * const privateKey = 'YOUR_PRIVATE_KEY';
      *
      * const provider = new providers.JsonRpcProvider(rpcUrl);
      * const signer = new Wallet(privateKey, provider);
@@ -293,16 +289,15 @@ class StakingClient extends base_1.BaseEthersClient {
         }
     }
     /**
-     * This function reduces the allocated amount by an staker in an escrow and transfers those tokens to the reward pool. This allows the slasher to claim them later.
+     * This function reduces the allocated amount by a staker in an escrow and transfers those tokens to the reward pool. This allows the slasher to claim them later.
      *
      * @param {string} slasher Wallet address from who requested the slash
      * @param {string} staker Wallet address from who is going to be slashed
      * @param {string} escrowAddress Address of the escrow that the slash is made
+     * @param {bigint} amount Amount in WEI of tokens to slash.
      * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
-     * @param {bigint} amount Amount in WEI of tokens to unstake.
      * @returns Returns void if successful. Throws error if any.
      *
-     *
      * **Code example**
      *
      * ```ts
@@ -310,7 +305,7 @@ class StakingClient extends base_1.BaseEthersClient {
      * import { StakingClient } from '@human-protocol/sdk';
      *
      * const rpcUrl = 'YOUR_RPC_URL';
-     * const privateKey = 'YOUR_PRIVATE_KEY'
+     * const privateKey = 'YOUR_PRIVATE_KEY';
      *
      * const provider = new providers.JsonRpcProvider(rpcUrl);
      * const signer = new Wallet(privateKey, provider);
@@ -342,6 +337,52 @@ class StakingClient extends base_1.BaseEthersClient {
             return (0, utils_1.throwError)(e);
         }
     }
+    /**
+     * Retrieves comprehensive staking information for a staker.
+     *
+     * @param {string} stakerAddress - The address of the staker.
+     * @returns {Promise<StakerInfo>}
+     *
+     * **Code example**
+     *
+     * ```ts
+     * import { StakingClient } from '@human-protocol/sdk';
+     *
+     * const rpcUrl = 'YOUR_RPC_URL';
+     *
+     * const provider = new providers.JsonRpcProvider(rpcUrl);
+     * const stakingClient = await StakingClient.build(provider);
+     *
+     * const stakingInfo = await stakingClient.getStakerInfo('0xYourStakerAddress');
+     * console.log(stakingInfo.tokensStaked);
+     * ```
+     */
+    async getStakerInfo(stakerAddress) {
+        if (!ethers_1.ethers.isAddress(stakerAddress)) {
+            throw error_1.ErrorInvalidStakerAddressProvided;
+        }
+        try {
+            const stakerInfo = await this.stakingContract.stakes(stakerAddress);
+            const currentBlock = await this.runner.provider.getBlockNumber();
+            const tokensWithdrawable = stakerInfo.tokensLockedUntil !== 0n &&
+                currentBlock >= stakerInfo.tokensLockedUntil
+                ? stakerInfo.tokensLocked
+                : 0n;
+            const adjustedLockedAmount = stakerInfo.tokensLockedUntil !== 0n &&
+                currentBlock >= stakerInfo.tokensLockedUntil
+                ? 0n
+                : stakerInfo.tokensLocked;
+            return {
+                stakedAmount: stakerInfo.tokensStaked,
+                lockedAmount: adjustedLockedAmount,
+                lockedUntil: adjustedLockedAmount === 0n ? 0n : stakerInfo.tokensLockedUntil,
+                withdrawableAmount: tokensWithdrawable,
+            };
+        }
+        catch (error) {
+            return (0, utils_1.throwError)(error);
+        }
+    }
 }
 exports.StakingClient = StakingClient;
 __decorate([

package/dist/statistics.d.ts

@@ -4,20 +4,15 @@ import { NetworkData } from './types';
 /**
  * ## Introduction
  *
- * This client enables to obtain statistical information from the subgraph.
+ * This client enables obtaining statistical information from the subgraph.
  *
- * Unlikely from the other SDK clients, `StatisticsClient` does not require `signer` or `provider` to be provided.
- * We just need to create client object using relevant network data.
+ * Unlike other SDK clients, `StatisticsClient` does not require `signer` or `provider` to be provided.
+ * We just need to create a client object using relevant network data.
  *
  * ```ts
  * constructor(network: NetworkData)
  * ```
  *
- * A `Signer` or a `Provider` should be passed depending on the use case of this module:
- *
- * - **Signer**: when the user wants to use this model in order to send transactions caling the contract functions.
- * - **Provider**: when the user wants to use this model in order to get information from the contracts or subgraph.
- *
  * ## Installation
  *
  * ### npm
@@ -50,7 +45,6 @@ export declare class StatisticsClient {
     /**
      * This function returns the statistical data of escrows.
      *
-     *
      * **Input parameters**
      *
      * ```ts
@@ -79,10 +73,8 @@ export declare class StatisticsClient {
      * };
      * ```
      *
-     *
      * @param {IStatisticsFilter} filter Statistics params with duration data
-     * @returns {EscrowStatistics} Escrow statistics data.
-     *
+     * @returns {Promise<EscrowStatistics>} Escrow statistics data.
      *
      * **Code example**
      *
@@ -102,7 +94,6 @@ export declare class StatisticsClient {
     /**
      * This function returns the statistical data of workers.
      *
-     *
      * **Input parameters**
      *
      * ```ts
@@ -126,10 +117,8 @@ export declare class StatisticsClient {
      * };
      * ```
      *
-     *
      * @param {IStatisticsFilter} filter Statistics params with duration data
-     * @returns {WorkerStatistics} Worker statistics data.
-     *
+     * @returns {Promise<WorkerStatistics>} Worker statistics data.
      *
      * **Code example**
      *
@@ -149,7 +138,6 @@ export declare class StatisticsClient {
     /**
      * This function returns the statistical data of payments.
      *
-     *
      * **Input parameters**
      *
      * ```ts
@@ -175,10 +163,8 @@ export declare class StatisticsClient {
      * };
      * ```
      *
-     *
      * @param {IStatisticsFilter} filter Statistics params with duration data
-     * @returns {PaymentStatistics} Payment statistics data.
-     *
+     * @returns {Promise<PaymentStatistics>} Payment statistics data.
      *
      * **Code example**
      *
@@ -219,7 +205,7 @@ export declare class StatisticsClient {
     /**
      * This function returns the statistical data of HMToken.
      *
-     *
+     * ```ts
      * type HMTStatistics = {
      *   totalTransferAmount: BigNumber;
      *   totalTransferCount: BigNumber;
@@ -227,9 +213,7 @@ export declare class StatisticsClient {
      * };
      * ```
      *
-     *
-     * @returns {HMTStatistics} HMToken statistics data.
-     *
+     * @returns {Promise<HMTStatistics>} HMToken statistics data.
      *
      * **Code example**
      *
@@ -253,7 +237,7 @@ export declare class StatisticsClient {
      * **Input parameters**
      *
      * @param {IHMTHoldersParams} params HMT Holders params with filters and ordering
-     * @returns {HMTHolder[]} List of HMToken holders.
+     * @returns {Promise<HMTHolder[]>} List of HMToken holders.
      *
      * **Code example**
      *
@@ -276,7 +260,6 @@ export declare class StatisticsClient {
     /**
      * This function returns the statistical data of HMToken day by day.
      *
-     *
      * **Input parameters**
      *
      * ```ts
@@ -299,10 +282,8 @@ export declare class StatisticsClient {
      * }
      * ```
      *
-     *
      * @param {IStatisticsFilter} filter Statistics params with duration data
-     * @returns {DailyHMTData[]} Daily HMToken statistics data.
-     *
+     * @returns {Promise<DailyHMTData[]>} Daily HMToken statistics data.
      *
      * **Code example**
      *

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,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;IAuC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,gBAAgB,CAAC;IAuC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACG,mBAAmB,CACvB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,gBAAgB,CAAC;IA4B5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiEG;IACG,oBAAoB,CACxB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IAkC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAkBhD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,aAAa,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAwBzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACG,eAAe,CACnB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC;CA8B3B"}