@human-protocol/sdk 5.1.0 → 6.0.0

package/src/graphql/queries/operator.ts

@@ -15,7 +15,9 @@ const LEADER_FRAGMENT = gql`
     jobTypes
     registrationNeeded
     registrationInstructions
-    reputationNetworks
+    reputationNetworks {
+      address
+    }
     name
     category
     staker {

package/src/graphql/types.ts

@@ -166,8 +166,10 @@ export interface IOperatorSubgraph {
   } | null;
 }
 
-export interface IReputationNetworkSubgraph
-  extends Omit<IReputationNetwork, 'operators'> {
+export interface IReputationNetworkSubgraph extends Omit<
+  IReputationNetwork,
+  'operators'
+> {
   operators: IOperatorSubgraph[];
 }
 

package/src/index.ts

@@ -1,9 +1,8 @@
 import { StakingClient, StakingUtils } from './staking';
-import { StorageClient } from './storage';
 import { KVStoreClient, KVStoreUtils } from './kvstore';
 import { EscrowClient, EscrowUtils } from './escrow';
-import { StatisticsClient } from './statistics';
-import { Encryption, EncryptionUtils } from './encryption';
+import { StatisticsUtils } from './statistics';
+import { Encryption, EncryptionUtils, MessageDataType } from './encryption';
 import { OperatorUtils } from './operator';
 import { TransactionUtils } from './transaction';
 import { WorkerUtils } from './worker';
@@ -27,16 +26,16 @@ export {
 
 export {
   StakingClient,
-  StorageClient,
   KVStoreClient,
   KVStoreUtils,
   EscrowClient,
   EscrowUtils,
-  StatisticsClient,
+  StatisticsUtils,
   Encryption,
   EncryptionUtils,
   OperatorUtils,
   TransactionUtils,
   WorkerUtils,
   StakingUtils,
+  MessageDataType,
 };

package/src/interfaces.ts

@@ -321,4 +321,9 @@ export interface SubgraphOptions {
   maxRetries?: number;
   /** Base delay between retries in milliseconds */
   baseDelay?: number;
+  /**
+   * Optional indexer identifier. When provided, requests target
+   * `{gateway}/deployments/id/<DEPLOYMENT_ID>/indexers/id/<INDEXER_ID>`.
+   */
+  indexerId?: string;
 }

package/src/kvstore.ts

@@ -26,12 +26,10 @@ import {
 import { KVStoreData } from './graphql';
 import { IKVStore, SubgraphOptions } from './interfaces';
 /**
- * ## Introduction
- *
- * This client enables performing actions on KVStore contract and obtaining information from both the contracts and subgraph.
+ * Client for interacting with the KVStore contract.
  *
  * 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.
+ * To use this client, it is recommended to initialize it using the static [`build`](/ts/classes/KVStoreClient/#build) method.
  *
  * ```ts
  * static async build(runner: ContractRunner): Promise<KVStoreClient>;
@@ -42,37 +40,25 @@ import { IKVStore, SubgraphOptions } from './interfaces';
  * - **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
- *
- * ### npm
- * ```bash
- * npm install @human-protocol/sdk
- * ```
- *
- * ### yarn
- * ```bash
- * yarn install @human-protocol/sdk
- * ```
- *
- * ## Code example
+ * @example
  *
- * ### Signer
+ * ###Using Signer
  *
- * **Using private key (backend)**
+ * ####Using private key (backend)
  *
  * ```ts
  * import { KVStoreClient } from '@human-protocol/sdk';
- * import { Wallet, providers } from 'ethers';
+ * import { Wallet, JsonRpcProvider } from 'ethers';
  *
  * const rpcUrl = 'YOUR_RPC_URL';
  * const privateKey = 'YOUR_PRIVATE_KEY';
  *
- * const provider = new providers.JsonRpcProvider(rpcUrl);
+ * const provider = new JsonRpcProvider(rpcUrl);
  * const signer = new Wallet(privateKey, provider);
  * const kvstoreClient = await KVStoreClient.build(signer);
  * ```
  *
- * **Using Wagmi (frontend)**
+ * ####Using Wagmi (frontend)
  *
  * ```ts
  * import { useSigner, useChainId } from 'wagmi';
@@ -82,27 +68,27 @@ import { IKVStore, SubgraphOptions } from './interfaces';
  * const kvstoreClient = await KVStoreClient.build(signer);
  * ```
  *
- * ### Provider
+ * ###Using Provider
  *
  * ```ts
  * import { KVStoreClient } from '@human-protocol/sdk';
- * import { providers } from 'ethers';
+ * import { JsonRpcProvider } from 'ethers';
  *
  * const rpcUrl = 'YOUR_RPC_URL';
  *
- * const provider = new providers.JsonRpcProvider(rpcUrl);
+ * const provider = new JsonRpcProvider(rpcUrl);
  * const kvstoreClient = await KVStoreClient.build(provider);
  * ```
  */
 
 export class KVStoreClient extends BaseEthersClient {
-  private contract: KVStore;
+  public contract: KVStore;
 
   /**
    * **KVStoreClient constructor**
    *
-   * @param {ContractRunner} runner - The Runner object to interact with the Ethereum network
-   * @param {NetworkData} networkData - The network information required to connect to the KVStore contract
+   * @param runner - The Runner object to interact with the Ethereum network
+   * @param networkData - The network information required to connect to the KVStore contract
    */
   constructor(runner: ContractRunner, networkData: NetworkData) {
     super(runner, networkData);
@@ -116,11 +102,23 @@ export class KVStoreClient extends BaseEthersClient {
   /**
    * Creates an instance of KVStoreClient from a runner.
    *
-   * @param {ContractRunner} runner - The Runner object to interact with the Ethereum network
+   * @param runner - The Runner object to interact with the Ethereum network
+   * @returns An instance of KVStoreClient
+   * @throws ErrorProviderDoesNotExist If the provider does not exist for the provided Signer
+   * @throws ErrorUnsupportedChainID If the network's chainId is not supported
    *
-   * @returns {Promise<KVStoreClient>} - An instance of KVStoreClient
-   * @throws {ErrorProviderDoesNotExist} - Thrown if the provider does not exist for the provided Signer
-   * @throws {ErrorUnsupportedChainID} - Thrown if the network's chainId is not supported
+   * @example
+   * ```ts
+   * import { KVStoreClient } from '@human-protocol/sdk';
+   * import { Wallet, JsonRpcProvider } from 'ethers';
+   *
+   * const rpcUrl = 'YOUR_RPC_URL';
+   * const privateKey = 'YOUR_PRIVATE_KEY';
+   *
+   * const provider = new JsonRpcProvider(rpcUrl);
+   * const signer = new Wallet(privateKey, provider);
+   * const kvstoreClient = await KVStoreClient.build(signer);
+   * ```
    */
   public static async build(runner: ContractRunner): Promise<KVStoreClient> {
     if (!runner.provider) {
@@ -142,27 +140,15 @@ export class KVStoreClient extends BaseEthersClient {
   /**
    * This function sets a key-value pair associated with the address that submits the transaction.
    *
-   * @param {string} key Key of the key-value pair
-   * @param {string} value Value of the key-value pair
-   * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
-   * @returns Returns void if successful. Throws error if any.
-   *
-   *
-   * **Code example**
-   *
-   * > Need to have available stake.
+   * @param key - Key of the key-value pair
+   * @param value - Value of the key-value pair
+   * @param txOptions - Additional transaction parameters (optional, defaults to an empty object).
+   * @returns -
+   * @throws ErrorKVStoreEmptyKey If the key is empty
+   * @throws Error If the transaction fails
    *
+   * @example
    * ```ts
-   * import { Wallet, providers } from 'ethers';
-   * import { KVStoreClient } from '@human-protocol/sdk';
-   *
-   * const rpcUrl = 'YOUR_RPC_URL';
-   * const privateKey = 'YOUR_PRIVATE_KEY';
-   *
-   * const provider = new providers.JsonRpcProvider(rpcUrl);
-   * const signer = new Wallet(privateKey, provider);
-   * const kvstoreClient = await KVStoreClient.build(signer);
-   *
    * await kvstoreClient.set('Role', 'RecordingOracle');
    * ```
    */
@@ -183,27 +169,16 @@ export class KVStoreClient extends BaseEthersClient {
   /**
    * This function sets key-value pairs in bulk associated with the address that submits the transaction.
    *
-   * @param {string[]} keys Array of keys (keys and value must have the same order)
-   * @param {string[]} values Array of values
-   * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
-   * @returns Returns void if successful. Throws error if any.
-   *
-   *
-   * **Code example**
-   *
-   * > Need to have available stake.
+   * @param keys - Array of keys (keys and value must have the same order)
+   * @param values - Array of values
+   * @param txOptions - Additional transaction parameters (optional, defaults to an empty object).
+   * @returns -
+   * @throws ErrorKVStoreArrayLength If keys and values arrays have different lengths
+   * @throws ErrorKVStoreEmptyKey If any key is empty
+   * @throws Error If the transaction fails
    *
+   * @example
    * ```ts
-   * import { Wallet, providers } from 'ethers';
-   * import { KVStoreClient } from '@human-protocol/sdk';
-   *
-   * const rpcUrl = 'YOUR_RPC_URL';
-   * const privateKey = 'YOUR_PRIVATE_KEY';
-   *
-   * const provider = new providers.JsonRpcProvider(rpcUrl);
-   * const signer = new Wallet(privateKey, provider);
-   * const kvstoreClient = await KVStoreClient.build(signer);
-   *
    * const keys = ['role', 'webhook_url'];
    * const values = ['RecordingOracle', 'http://localhost'];
    * await kvstoreClient.setBulk(keys, values);
@@ -229,25 +204,15 @@ export class KVStoreClient extends BaseEthersClient {
   /**
    * Sets a URL value for the address that submits the transaction, and its hash.
    *
-   * @param {string} url URL to set
-   * @param {string | undefined} urlKey Configurable URL key. `url` by default.
-   * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
-   * @returns Returns void if successful. Throws error if any.
-   *
-   *
-   * **Code example**
+   * @param url - URL to set
+   * @param urlKey - Configurable URL key. `url` by default.
+   * @param txOptions - Additional transaction parameters (optional, defaults to an empty object).
+   * @returns -
+   * @throws ErrorInvalidUrl If the URL is invalid
+   * @throws Error If the transaction fails
    *
+   * @example
    * ```ts
-   * import { Wallet, providers } from 'ethers';
-   * import { KVStoreClient } from '@human-protocol/sdk';
-   *
-   * const rpcUrl = 'YOUR_RPC_URL';
-   * const privateKey = 'YOUR_PRIVATE_KEY';
-   *
-   * const provider = new providers.JsonRpcProvider(rpcUrl);
-   * const signer = new Wallet(privateKey, provider);
-   * const kvstoreClient = await KVStoreClient.build(signer);
-   *
    * await kvstoreClient.setFileUrlAndHash('example.com');
    * await kvstoreClient.setFileUrlAndHash('linkedin.com/example', 'linkedin_url');
    * ```
@@ -283,26 +248,17 @@ export class KVStoreClient extends BaseEthersClient {
   /**
    * Gets the value of a key-value pair in the contract.
    *
-   * @param {string} address Address from which to get the key value.
-   * @param {string} key Key to obtain the value.
-   * @param {SubgraphOptions} options Optional configuration for subgraph requests.
-   * @returns {string} Value of the key.
-   *
-   *
-   * **Code example**
-   *
-   * > Need to have available stake.
+   * @param address - Address from which to get the key value.
+   * @param key - Key to obtain the value.
+   * @returns Value of the key.
+   * @throws ErrorKVStoreEmptyKey If the key is empty
+   * @throws ErrorInvalidAddress If the address is invalid
+   * @throws Error If the contract call fails
    *
+   * @example
    * ```ts
-   * import { providers } from 'ethers';
-   * import { KVStoreClient } from '@human-protocol/sdk';
-   *
-   * const rpcUrl = 'YOUR_RPC_URL';
-   *
-   * const provider = new providers.JsonRpcProvider(rpcUrl);
-   * const kvstoreClient = await KVStoreClient.build(provider);
-   *
    * const value = await kvstoreClient.get('0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266', 'Role');
+   * console.log('Value:', value);
    * ```
    */
   public async get(address: string, key: string): Promise<string> {
@@ -320,55 +276,37 @@ export class KVStoreClient extends BaseEthersClient {
 }
 
 /**
- * ## Introduction
- *
- * Utility class for KVStore-related operations.
- *
- * ## Installation
- *
- * ### npm
- * ```bash
- * npm install @human-protocol/sdk
- * ```
- *
- * ### yarn
- * ```bash
- * yarn install @human-protocol/sdk
- * ```
- *
- * ## Code example
- *
- * ### Signer
- *
- * **Using private key (backend)**
+ * Utility helpers for KVStore-related queries.
  *
+ * @example
  * ```ts
  * import { ChainId, KVStoreUtils } from '@human-protocol/sdk';
  *
- * const KVStoreAddresses = await KVStoreUtils.getKVStoreData(
+ * const kvStoreData = await KVStoreUtils.getKVStoreData(
  *   ChainId.POLYGON_AMOY,
  *   "0x1234567890123456789012345678901234567890"
  * );
+ * console.log('KVStore data:', kvStoreData);
  * ```
  */
 export class KVStoreUtils {
   /**
    * This function returns the KVStore data for a given address.
    *
-   * @param {ChainId} chainId Network in which the KVStore is deployed
-   * @param {string} address Address of the KVStore
-   * @param {SubgraphOptions} options Optional configuration for subgraph requests.
-   * @returns {Promise<IKVStore[]>} KVStore data
-   * @throws {ErrorUnsupportedChainID} - Thrown if the network's chainId is not supported
-   * @throws {ErrorInvalidAddress} - Thrown if the Address sent is invalid
-   *
-   * **Code example**
+   * @param chainId - Network in which the KVStore is deployed
+   * @param address - Address of the KVStore
+   * @param options - Optional configuration for subgraph requests.
+   * @returns KVStore data
+   * @throws ErrorUnsupportedChainID If the network's chainId is not supported
+   * @throws ErrorInvalidAddress If the address is invalid
    *
+   * @example
    * ```ts
-   * import { ChainId, KVStoreUtils } from '@human-protocol/sdk';
-   *
-   * const kvStoreData = await KVStoreUtils.getKVStoreData(ChainId.POLYGON_AMOY, "0x1234567890123456789012345678901234567890");
-   * console.log(kvStoreData);
+   * const kvStoreData = await KVStoreUtils.getKVStoreData(
+   *   ChainId.POLYGON_AMOY,
+   *   "0x1234567890123456789012345678901234567890"
+   * );
+   * console.log('KVStore data:', kvStoreData);
    * ```
    */
   public static async getKVStoreData(
@@ -404,26 +342,24 @@ export class KVStoreUtils {
   /**
    * Gets the value of a key-value pair in the KVStore using the subgraph.
    *
-   * @param {ChainId} chainId Network in which the KVStore is deployed
-   * @param {string} address Address from which to get the key value.
-   * @param {string} key Key to obtain the value.
-   * @param {SubgraphOptions} options Optional configuration for subgraph requests.
-   * @returns {Promise<string>} Value of the key.
-   * @throws {ErrorUnsupportedChainID} - Thrown if the network's chainId is not supported
-   * @throws {ErrorInvalidAddress} - Thrown if the Address sent is invalid
-   * @throws {ErrorKVStoreEmptyKey} - Thrown if the key is empty
-   *
-   * **Code example**
-   *
+   * @param chainId - Network in which the KVStore is deployed
+   * @param address - Address from which to get the key value.
+   * @param key - Key to obtain the value.
+   * @param options - Optional configuration for subgraph requests.
+   * @returns Value of the key.
+   * @throws ErrorUnsupportedChainID If the network's chainId is not supported
+   * @throws ErrorInvalidAddress If the address is invalid
+   * @throws ErrorKVStoreEmptyKey If the key is empty
+   * @throws InvalidKeyError If the key is not found
+   *
+   * @example
    * ```ts
-   * import { ChainId, KVStoreUtils } from '@human-protocol/sdk';
-   *
-   * const chainId = ChainId.POLYGON_AMOY;
-   * const address = '0x1234567890123456789012345678901234567890';
-   * const key = 'role';
-   *
-   * const value = await KVStoreUtils.get(chainId, address, key);
-   * console.log(value);
+   * const value = await KVStoreUtils.get(
+   *   ChainId.POLYGON_AMOY,
+   *   '0x1234567890123456789012345678901234567890',
+   *   'role'
+   * );
+   * console.log('Value:', value);
    * ```
    */
   public static async get(
@@ -458,22 +394,22 @@ export class KVStoreUtils {
   /**
    * Gets the URL value of the given entity, and verifies its hash.
    *
-   * @param {ChainId} chainId Network in which the KVStore is deployed
-   * @param {string} address Address from which to get the URL value.
-   * @param {string} urlKey Configurable URL key. `url` by default.
-   * @param {SubgraphOptions} options Optional configuration for subgraph requests.
-   * @returns {Promise<string>} URL value for the given address if it exists, and the content is valid
-   *
-   * **Code example**
+   * @param chainId - Network in which the KVStore is deployed
+   * @param address - Address from which to get the URL value.
+   * @param urlKey - Configurable URL key. `url` by default.
+   * @param options - Optional configuration for subgraph requests.
+   * @returns URL value for the given address if it exists, and the content is valid
+   * @throws ErrorInvalidAddress If the address is invalid
+   * @throws ErrorInvalidHash If the hash verification fails
+   * @throws Error If fetching URL or hash fails
    *
+   * @example
    * ```ts
-   * import { ChainId, KVStoreUtils } from '@human-protocol/sdk';
-   *
-   * const chainId = ChainId.POLYGON_AMOY;
-   * const address = '0x1234567890123456789012345678901234567890';
-   *
-   * const url = await KVStoreUtils.getFileUrlAndVerifyHash(chainId, address);
-   * console.log(url);
+   * const url = await KVStoreUtils.getFileUrlAndVerifyHash(
+   *   ChainId.POLYGON_AMOY,
+   *   '0x1234567890123456789012345678901234567890'
+   * );
+   * console.log('Verified URL:', url);
    * ```
    */
   public static async getFileUrlAndVerifyHash(
@@ -521,20 +457,21 @@ export class KVStoreUtils {
   /**
    * Gets the public key of the given entity, and verifies its hash.
    *
-   * @param {ChainId} chainId Network in which the KVStore is deployed
-   * @param {string} address Address from which to get the public key.
-   * @returns {Promise<string>} Public key for the given address if it exists, and the content is valid
-   *
-   * **Code example**
+   * @param chainId - Network in which the KVStore is deployed
+   * @param address - Address from which to get the public key.
+   * @param options - Optional configuration for subgraph requests.
+   * @returns Public key for the given address if it exists, and the content is valid
+   * @throws ErrorInvalidAddress If the address is invalid
+   * @throws ErrorInvalidHash If the hash verification fails
+   * @throws Error If fetching the public key fails
    *
+   * @example
    * ```ts
-   * import { ChainId, KVStoreUtils } from '@human-protocol/sdk';
-   *
-   * const chainId = ChainId.POLYGON_AMOY;
-   * const address = '0x1234567890123456789012345678901234567890';
-   *
-   * const publicKey = await KVStoreUtils.getPublicKey(chainId, address);
-   * console.log(publicKey);
+   * const publicKey = await KVStoreUtils.getPublicKey(
+   *   ChainId.POLYGON_AMOY,
+   *   '0x1234567890123456789012345678901234567890'
+   * );
+   * console.log('Public key:', publicKey);
    * ```
    */
   public static async getPublicKey(

package/src/operator.ts

@@ -26,21 +26,40 @@ import { getSubgraphUrl, customGqlFetch } from './utils';
 import { ChainId, OrderDirection } from './enums';
 import { NETWORKS } from './constants';
 
+/**
+ * Utility helpers for operator-related queries.
+ *
+ * @example
+ * ```ts
+ * import { OperatorUtils, ChainId } from '@human-protocol/sdk';
+ *
+ * const operator = await OperatorUtils.getOperator(
+ *   ChainId.POLYGON_AMOY,
+ *   '0x62dD51230A30401C455c8398d06F85e4EaB6309f'
+ * );
+ * console.log('Operator:', operator);
+ * ```
+ */
 export class OperatorUtils {
   /**
    * This function returns the operator data for the given address.
    *
-   * @param {ChainId} chainId Network in which the operator is deployed
-   * @param {string} address Operator address.
-   * @param {SubgraphOptions} options Optional configuration for subgraph requests.
-   * @returns {Promise<IOperator | null>} - Returns the operator details or null if not found.
-   *
-   * **Code example**
+   * @param chainId - Network in which the operator is deployed
+   * @param address - Operator address.
+   * @param options - Optional configuration for subgraph requests.
+   * @returns Returns the operator details or null if not found.
+   * @throws ErrorInvalidStakerAddressProvided If the address is invalid
+   * @throws ErrorUnsupportedChainID If the chain ID is not supported
    *
+   * @example
    * ```ts
    * import { OperatorUtils, ChainId } from '@human-protocol/sdk';
    *
-   * const operator = await OperatorUtils.getOperator(ChainId.POLYGON_AMOY, '0x62dD51230A30401C455c8398d06F85e4EaB6309f');
+   * const operator = await OperatorUtils.getOperator(
+   *   ChainId.POLYGON_AMOY,
+   *   '0x62dD51230A30401C455c8398d06F85e4EaB6309f'
+   * );
+   * console.log('Operator:', operator);
    * ```
    */
   public static async getOperator(
@@ -74,19 +93,20 @@ export class OperatorUtils {
   /**
    * This function returns all the operator details of the protocol.
    *
-   * @param {IOperatorsFilter} filter Filter for the operators.
-   * @param {SubgraphOptions} options Optional configuration for subgraph requests.
-   * @returns {Promise<IOperator[]>} Returns an array with all the operator details.
-   *
-   * **Code example**
+   * @param filter - Filter for the operators.
+   * @param options - Optional configuration for subgraph requests.
+   * @returns Returns an array with all the operator details.
+   * @throws ErrorUnsupportedChainID If the chain ID is not supported
    *
+   * @example
    * ```ts
-   * import { OperatorUtils, ChainId } from '@human-protocol/sdk';
+   * import { ChainId } from '@human-protocol/sdk';
    *
-   * const filter: IOperatorsFilter = {
-   *  chainId: ChainId.POLYGON
+   * const filter = {
+   *   chainId: ChainId.POLYGON_AMOY
    * };
    * const operators = await OperatorUtils.getOperators(filter);
+   * console.log('Operators:', operators.length);
    * ```
    */
   public static async getOperators(
@@ -142,18 +162,22 @@ export class OperatorUtils {
   /**
    * Retrieves the reputation network operators of the specified address.
    *
-   * @param {ChainId} chainId Network in which the reputation network is deployed
-   * @param {string} address Address of the reputation oracle.
-   * @param {string} [role] - (Optional) Role of the operator.
-   * @param {SubgraphOptions} options Optional configuration for subgraph requests.
-   * @returns {Promise<IOperator[]>} - Returns an array of operator details.
-   *
-   * **Code example**
+   * @param chainId - Network in which the reputation network is deployed
+   * @param address - Address of the reputation oracle.
+   * @param role - Role of the operator (optional).
+   * @param options - Optional configuration for subgraph requests.
+   * @returns Returns an array of operator details.
+   * @throws ErrorUnsupportedChainID If the chain ID is not supported
    *
+   * @example
    * ```ts
    * import { OperatorUtils, ChainId } from '@human-protocol/sdk';
    *
-   * const operators = await OperatorUtils.getReputationNetworkOperators(ChainId.POLYGON_AMOY, '0x62dD51230A30401C455c8398d06F85e4EaB6309f');
+   * const operators = await OperatorUtils.getReputationNetworkOperators(
+   *   ChainId.POLYGON_AMOY,
+   *   '0x62dD51230A30401C455c8398d06F85e4EaB6309f'
+   * );
+   * console.log('Operators:', operators.length);
    * ```
    */
   public static async getReputationNetworkOperators(
@@ -189,17 +213,22 @@ export class OperatorUtils {
   /**
    * This function returns information about the rewards for a given slasher address.
    *
-   * @param {ChainId} chainId Network in which the rewards are deployed
-   * @param {string} slasherAddress Slasher address.
-   * @param {SubgraphOptions} options Optional configuration for subgraph requests.
-   * @returns {Promise<IReward[]>} Returns an array of Reward objects that contain the rewards earned by the user through slashing other users.
-   *
-   * **Code example**
+   * @param chainId - Network in which the rewards are deployed
+   * @param slasherAddress - Slasher address.
+   * @param options - Optional configuration for subgraph requests.
+   * @returns Returns an array of Reward objects that contain the rewards earned by the user through slashing other users.
+   * @throws ErrorInvalidSlasherAddressProvided If the slasher address is invalid
+   * @throws ErrorUnsupportedChainID If the chain ID is not supported
    *
+   * @example
    * ```ts
    * import { OperatorUtils, ChainId } from '@human-protocol/sdk';
    *
-   * const rewards = await OperatorUtils.getRewards(ChainId.POLYGON_AMOY, '0x62dD51230A30401C455c8398d06F85e4EaB6309f');
+   * const rewards = await OperatorUtils.getRewards(
+   *   ChainId.POLYGON_AMOY,
+   *   '0x62dD51230A30401C455c8398d06F85e4EaB6309f'
+   * );
+   * console.log('Rewards:', rewards.length);
    * ```
    */
   public static async getRewards(