@human-protocol/sdk 4.2.0 → 4.4.0

package/dist/base.d.ts

@@ -1,4 +1,4 @@
-import { ContractRunner } from 'ethers';
+import { ContractRunner, Overrides } from 'ethers';
 import { NetworkData } from './types';
 /**
  * ## Introduction
@@ -16,5 +16,14 @@ export declare abstract class BaseEthersClient {
      * @param {NetworkData} networkData The network information required to connect to the contracts
      */
     constructor(runner: ContractRunner, networkData: NetworkData);
+    /**
+     * Internal helper to enrich transaction overrides with network specific defaults.
+     *
+     * Aurora networks use a fixed gas price. We always override any user provided
+     * gasPrice with the canonical DEFAULT_AURORA_GAS_PRICE to avoid mismatches
+     * or tx failures due to an unexpected value. For other networks the user
+     * supplied fee parameters are left untouched.
+     */
+    protected applyTxDefaults(txOptions?: Overrides): Overrides;
 }
 //# sourceMappingURL=base.d.ts.map

package/dist/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;;GAKG;AACH,8BAAsB,gBAAgB;IACpC,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC;IAC1B,WAAW,EAAE,WAAW,CAAC;IAEhC;;;;;OAKG;gBACS,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW;CAI7D"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAItC;;;;;GAKG;AACH,8BAAsB,gBAAgB;IACpC,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC;IAC1B,WAAW,EAAE,WAAW,CAAC;IAEhC;;;;;OAKG;gBACS,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW;IAK5D;;;;;;;OAOG;IACH,SAAS,CAAC,eAAe,CAAC,SAAS,GAAE,SAAc,GAAG,SAAS;CAWhE"}

package/dist/base.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseEthersClient = void 0;
+const enums_1 = require("./enums");
+const constants_1 = require("./constants");
 /**
  * ## Introduction
  *
@@ -18,5 +20,24 @@ class BaseEthersClient {
         this.networkData = networkData;
         this.runner = runner;
     }
+    /**
+     * Internal helper to enrich transaction overrides with network specific defaults.
+     *
+     * Aurora networks use a fixed gas price. We always override any user provided
+     * gasPrice with the canonical DEFAULT_AURORA_GAS_PRICE to avoid mismatches
+     * or tx failures due to an unexpected value. For other networks the user
+     * supplied fee parameters are left untouched.
+     */
+    applyTxDefaults(txOptions = {}) {
+        if (this.networkData.chainId === enums_1.ChainId.AURORA_TESTNET) {
+            return {
+                ...txOptions,
+                gasPrice: constants_1.DEFAULT_AURORA_GAS_PRICE,
+                maxFeePerGas: undefined,
+                maxPriorityFeePerGas: undefined,
+            };
+        }
+        return txOptions;
+    }
 }
 exports.BaseEthersClient = BaseEthersClient;

package/dist/constants.d.ts

@@ -5,6 +5,7 @@ export declare const DEFAULT_ENDPOINT = "localhost";
 export declare const DEFAULT_REGION = "eu";
 export declare const DEFAULT_PORT = 9000;
 export declare const DEFAULT_USE_SSL = false;
+export declare const DEFAULT_AURORA_GAS_PRICE: bigint;
 export declare enum HttpStatus {
     OK = 200,
     CREATED = 201,

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,oBAAY,UAAU;IACpB,EAAE,MAAM;IACR,OAAO,MAAM;IACb,WAAW,MAAM;IACjB,YAAY,MAAM;IAClB,gBAAgB,MAAM;IACtB,SAAS,MAAM;IACf,SAAS,MAAM;IACf,qBAAqB,MAAM;CAC5B;AAED,eAAO,MAAM,QAAQ,EAAE;KACpB,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,WAAW;CA0HnC,CAAC;AAEF,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAavB,CAAC;AAEF,eAAO,MAAM,IAAI;;;;;CAKhB,CAAC;AAEF,eAAO,MAAM,4BAA4B,uBAAuB,CAAC;AAEjE,eAAO,MAAM,4BAA4B,KAAK,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,eAAO,MAAM,wBAAwB,QAAoC,CAAC;AAE1E,oBAAY,UAAU;IACpB,EAAE,MAAM;IACR,OAAO,MAAM;IACb,WAAW,MAAM;IACjB,YAAY,MAAM;IAClB,gBAAgB,MAAM;IACtB,SAAS,MAAM;IACf,SAAS,MAAM;IACf,qBAAqB,MAAM;CAC5B;AAED,eAAO,MAAM,QAAQ,EAAE;KACpB,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,WAAW;CA0HnC,CAAC;AAEF,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAavB,CAAC;AAEF,eAAO,MAAM,IAAI;;;;;CAKhB,CAAC;AAEF,eAAO,MAAM,4BAA4B,uBAAuB,CAAC;AAEjE,eAAO,MAAM,4BAA4B,KAAK,CAAC"}

package/dist/constants.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ESCROW_BULK_PAYOUT_MAX_ITEMS = exports.SUBGRAPH_API_KEY_PLACEHOLDER = exports.Role = exports.KVStoreKeys = exports.NETWORKS = exports.HttpStatus = exports.DEFAULT_USE_SSL = exports.DEFAULT_PORT = exports.DEFAULT_REGION = exports.DEFAULT_ENDPOINT = exports.DEFAULT_PUBLIC_BUCKET = void 0;
+exports.ESCROW_BULK_PAYOUT_MAX_ITEMS = exports.SUBGRAPH_API_KEY_PLACEHOLDER = exports.Role = exports.KVStoreKeys = exports.NETWORKS = exports.HttpStatus = exports.DEFAULT_AURORA_GAS_PRICE = exports.DEFAULT_USE_SSL = exports.DEFAULT_PORT = exports.DEFAULT_REGION = exports.DEFAULT_ENDPOINT = exports.DEFAULT_PUBLIC_BUCKET = void 0;
+const ethers_1 = require("ethers");
 const enums_1 = require("./enums");
 exports.DEFAULT_PUBLIC_BUCKET = 'escrow-public-results';
 exports.DEFAULT_ENDPOINT = 'localhost';
 exports.DEFAULT_REGION = 'eu';
 exports.DEFAULT_PORT = 9000;
 exports.DEFAULT_USE_SSL = false;
+exports.DEFAULT_AURORA_GAS_PRICE = ethers_1.ethers.parseUnits('0.07', 'gwei');
 var HttpStatus;
 (function (HttpStatus) {
     HttpStatus[HttpStatus["OK"] = 200] = "OK";

package/dist/escrow.d.ts

@@ -849,7 +849,7 @@ export declare class EscrowUtils {
      *
      * @param {ChainId} chainId Network in which the escrow has been deployed
      * @param {string} escrowAddress Address of the escrow
-     * @returns {IEscrow} Escrow data
+     * @returns {Promise<IEscrow | null>} - Escrow data or null if not found.
      *
      * **Code example**
      *
@@ -859,7 +859,7 @@ export declare class EscrowUtils {
      * const escrow = new EscrowUtils.getEscrow(ChainId.POLYGON_AMOY, "0x1234567890123456789012345678901234567890");
      * ```
      */
-    static getEscrow(chainId: ChainId, escrowAddress: string): Promise<IEscrow>;
+    static getEscrow(chainId: ChainId, escrowAddress: string): Promise<IEscrow | null>;
     /**
      * This function returns the status events for a given set of networks within an optional date range.
      *

package/dist/escrow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"escrow.d.ts","sourceRoot":"","sources":["../src/escrow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"escrow.d.ts","sourceRoot":"","sources":["../src/escrow.ts"],"names":[],"mappings":"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"}

package/dist/escrow.js

@@ -180,7 +180,7 @@ class EscrowClient extends base_1.BaseEthersClient {
             }
         });
         try {
-            const result = await (await this.escrowFactoryContract.createEscrow(tokenAddress, trustedHandlers, jobRequesterId, txOptions)).wait();
+            const result = await (await this.escrowFactoryContract.createEscrow(tokenAddress, trustedHandlers, jobRequesterId, this.applyTxDefaults(txOptions))).wait();
             const event = result?.logs?.find(({ topics }) => topics.includes(ethers_1.ethers.id('LaunchedV2(address,address,string)')))?.args;
             if (!event) {
                 throw error_1.ErrorLaunchedEventIsNotEmitted;
@@ -263,7 +263,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await (await escrowContract.setup(reputationOracle, recordingOracle, exchangeOracle, reputationOracleFee, recordingOracleFee, exchangeOracleFee, manifest, manifestHash, txOptions)).wait();
+            await (await escrowContract.setup(reputationOracle, recordingOracle, exchangeOracle, reputationOracleFee, recordingOracleFee, exchangeOracleFee, manifest, manifestHash, this.applyTxDefaults(txOptions))).wait();
             return;
         }
         catch (e) {
@@ -310,7 +310,7 @@ class EscrowClient extends base_1.BaseEthersClient {
             const escrowContract = this.getEscrowContract(escrowAddress);
             const tokenAddress = await escrowContract.token();
             const tokenContract = typechain_types_1.HMToken__factory.connect(tokenAddress, this.runner);
-            await (await tokenContract.transfer(escrowAddress, amount, txOptions)).wait();
+            await (await tokenContract.transfer(escrowAddress, amount, this.applyTxDefaults(txOptions))).wait();
             return;
         }
         catch (e) {
@@ -363,7 +363,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await (await escrowContract.storeResults(url, hash, txOptions)).wait();
+            await (await escrowContract.storeResults(url, hash, this.applyTxDefaults(txOptions))).wait();
             return;
         }
         catch (e) {
@@ -405,7 +405,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await (await escrowContract.complete(txOptions)).wait();
+            await (await escrowContract.complete(this.applyTxDefaults(txOptions))).wait();
             return;
         }
         catch (e) {
@@ -455,10 +455,10 @@ class EscrowClient extends base_1.BaseEthersClient {
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
             if (forceComplete) {
-                await (await escrowContract['bulkPayOut(address[],uint256[],string,string,uint256,bool)'](recipients, amounts, finalResultsUrl, finalResultsHash, txId, forceComplete, txOptions)).wait();
+                await (await escrowContract['bulkPayOut(address[],uint256[],string,string,uint256,bool)'](recipients, amounts, finalResultsUrl, finalResultsHash, txId, forceComplete, this.applyTxDefaults(txOptions))).wait();
             }
             else {
-                await (await escrowContract['bulkPayOut(address[],uint256[],string,string,uint256)'](recipients, amounts, finalResultsUrl, finalResultsHash, txId, txOptions)).wait();
+                await (await escrowContract['bulkPayOut(address[],uint256[],string,string,uint256)'](recipients, amounts, finalResultsUrl, finalResultsHash, txId, this.applyTxDefaults(txOptions))).wait();
             }
             return;
         }
@@ -501,7 +501,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            const transactionReceipt = await (await escrowContract.cancel(txOptions)).wait();
+            const transactionReceipt = await (await escrowContract.cancel(this.applyTxDefaults(txOptions))).wait();
             let amountTransferred = undefined;
             const tokenAddress = await escrowContract.token();
             const tokenContract = typechain_types_1.HMToken__factory.connect(tokenAddress, this.runner);
@@ -577,7 +577,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await (await escrowContract.addTrustedHandlers(trustedHandlers, txOptions)).wait();
+            await (await escrowContract.addTrustedHandlers(trustedHandlers, this.applyTxDefaults(txOptions))).wait();
             return;
         }
         catch (e) {
@@ -626,7 +626,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            const transactionReceipt = await (await escrowContract.withdraw(tokenAddress, txOptions)).wait();
+            const transactionReceipt = await (await escrowContract.withdraw(tokenAddress, this.applyTxDefaults(txOptions))).wait();
             let amountTransferred = undefined;
             const tokenContract = typechain_types_1.ERC20__factory.connect(tokenAddress, this.runner);
             if (transactionReceipt)
@@ -698,6 +698,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * (await signer.sendTransaction(rawTransaction)).wait();
      */
     async createBulkPayoutTransaction(escrowAddress, recipients, amounts, finalResultsUrl, finalResultsHash, txId, forceComplete = false, txOptions = {}) {
+        txOptions = this.applyTxDefaults(txOptions);
         await this.ensureCorrectBulkPayoutInput(escrowAddress, recipients, amounts, finalResultsUrl, finalResultsHash);
         const signer = this.runner;
         try {
@@ -1481,7 +1482,7 @@ class EscrowUtils {
      *
      * @param {ChainId} chainId Network in which the escrow has been deployed
      * @param {string} escrowAddress Address of the escrow
-     * @returns {IEscrow} Escrow data
+     * @returns {Promise<IEscrow | null>} - Escrow data or null if not found.
      *
      * **Code example**
      *
@@ -1500,6 +1501,7 @@ class EscrowUtils {
             throw error_1.ErrorInvalidAddress;
         }
         const { escrow } = await (0, graphql_request_1.default)((0, utils_1.getSubgraphUrl)(networkData), (0, graphql_1.GET_ESCROW_BY_ADDRESS_QUERY)(), { escrowAddress: escrowAddress.toLowerCase() });
+        escrow.chainId = networkData.chainId;
         return escrow || null;
     }
     /**

package/dist/index.d.ts

@@ -11,5 +11,6 @@ export * from './constants';
 export * from './types';
 export * from './enums';
 export * from './interfaces';
+export { EthereumError, InvalidArgumentError, ReplacementUnderpriced, NumericFault, NonceExpired, TransactionReplaced, ContractExecutionError, InvalidEthereumAddressError, InvalidKeyError, } from './error';
 export { StakingClient, StorageClient, KVStoreClient, KVStoreUtils, EscrowClient, EscrowUtils, StatisticsClient, Encryption, EncryptionUtils, OperatorUtils, TransactionUtils, WorkerUtils, };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAE7B,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,WAAW,GACZ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAE7B,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,WAAW,GACZ,CAAC"}

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkerUtils = exports.TransactionUtils = exports.OperatorUtils = exports.EncryptionUtils = exports.Encryption = exports.StatisticsClient = exports.EscrowUtils = exports.EscrowClient = exports.KVStoreUtils = exports.KVStoreClient = exports.StorageClient = exports.StakingClient = void 0;
+exports.WorkerUtils = exports.TransactionUtils = exports.OperatorUtils = exports.EncryptionUtils = exports.Encryption = exports.StatisticsClient = exports.EscrowUtils = exports.EscrowClient = exports.KVStoreUtils = exports.KVStoreClient = exports.StorageClient = exports.StakingClient = exports.InvalidKeyError = exports.InvalidEthereumAddressError = exports.ContractExecutionError = exports.TransactionReplaced = exports.NonceExpired = exports.NumericFault = exports.ReplacementUnderpriced = exports.InvalidArgumentError = exports.EthereumError = void 0;
 const staking_1 = require("./staking");
 Object.defineProperty(exports, "StakingClient", { enumerable: true, get: function () { return staking_1.StakingClient; } });
 const storage_1 = require("./storage");
@@ -40,3 +40,13 @@ __exportStar(require("./constants"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./enums"), exports);
 __exportStar(require("./interfaces"), exports);
+var error_1 = require("./error");
+Object.defineProperty(exports, "EthereumError", { enumerable: true, get: function () { return error_1.EthereumError; } });
+Object.defineProperty(exports, "InvalidArgumentError", { enumerable: true, get: function () { return error_1.InvalidArgumentError; } });
+Object.defineProperty(exports, "ReplacementUnderpriced", { enumerable: true, get: function () { return error_1.ReplacementUnderpriced; } });
+Object.defineProperty(exports, "NumericFault", { enumerable: true, get: function () { return error_1.NumericFault; } });
+Object.defineProperty(exports, "NonceExpired", { enumerable: true, get: function () { return error_1.NonceExpired; } });
+Object.defineProperty(exports, "TransactionReplaced", { enumerable: true, get: function () { return error_1.TransactionReplaced; } });
+Object.defineProperty(exports, "ContractExecutionError", { enumerable: true, get: function () { return error_1.ContractExecutionError; } });
+Object.defineProperty(exports, "InvalidEthereumAddressError", { enumerable: true, get: function () { return error_1.InvalidEthereumAddressError; } });
+Object.defineProperty(exports, "InvalidKeyError", { enumerable: true, get: function () { return error_1.InvalidKeyError; } });

package/dist/kvstore.d.ts

@@ -176,6 +176,31 @@ export declare class KVStoreClient extends BaseEthersClient {
      * ```
      */
     setFileUrlAndHash(url: string, urlKey?: string, txOptions?: Overrides): Promise<void>;
+    /**
+     * 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.
+     * @returns {string} Value of the key.
+     *
+     *
+     * **Code example**
+     *
+     * > Need to have available stake.
+     *
+     * ```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');
+     * ```
+     */
+    get(address: string, key: string): Promise<string>;
 }
 /**
  * ## Introduction

package/dist/kvstore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kvstore.d.ts","sourceRoot":"","sources":["../src/kvstore.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAU,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAG1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAYlC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAOtC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AAEH,qBAAa,aAAc,SAAQ,gBAAgB;IACjD,OAAO,CAAC,QAAQ,CAAU;IAE1B;;;;;OAKG;gBACS,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW;IAS5D;;;;;;;;OAQG;WACiB,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBzE;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IAEU,GAAG,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IAEU,OAAO,CAClB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IAEU,iBAAiB,CAC5B,GAAG,EAAE,MAAM,EACX,MAAM,SAAQ,EACd,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;CAuBjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,YAAY;IACvB;;;;;;;;;;;;;;;;;OAiBG;WACiB,cAAc,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,QAAQ,EAAE,CAAC;IAyBtB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;WACiB,GAAG,CACrB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC;IAuBlB;;;;;;;;;;;;;;;;;;;OAmBG;WACiB,uBAAuB,CACzC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,SAAQ,GACb,OAAO,CAAC,MAAM,CAAC;IAqClB;;;;;;;;;;;;;;;;;;OAkBG;WACiB,YAAY,CAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;CAenB"}
+{"version":3,"file":"kvstore.d.ts","sourceRoot":"","sources":["../src/kvstore.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAU,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAG1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAYlC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAOtC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AAEH,qBAAa,aAAc,SAAQ,gBAAgB;IACjD,OAAO,CAAC,QAAQ,CAAU;IAE1B;;;;;OAKG;gBACS,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW;IAS5D;;;;;;;;OAQG;WACiB,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBzE;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IAEU,GAAG,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;IAWhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IAEU,OAAO,CAClB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IAEU,iBAAiB,CAC5B,GAAG,EAAE,MAAM,EACX,MAAM,SAAQ,EACd,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAYhE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,YAAY;IACvB;;;;;;;;;;;;;;;;;OAiBG;WACiB,cAAc,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,QAAQ,EAAE,CAAC;IAyBtB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;WACiB,GAAG,CACrB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC;IAuBlB;;;;;;;;;;;;;;;;;;;OAmBG;WACiB,uBAAuB,CACzC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,SAAQ,GACb,OAAO,CAAC,MAAM,CAAC;IAqClB;;;;;;;;;;;;;;;;;;OAkBG;WACiB,YAAY,CAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;CAenB"}

package/dist/kvstore.js

@@ -154,7 +154,7 @@ class KVStoreClient extends base_1.BaseEthersClient {
         if (key === '')
             throw error_1.ErrorKVStoreEmptyKey;
         try {
-            await (await this.contract.set(key, value, txOptions)).wait();
+            await (await this.contract.set(key, value, this.applyTxDefaults(txOptions))).wait();
         }
         catch (e) {
             if (e instanceof Error)
@@ -196,7 +196,7 @@ class KVStoreClient extends base_1.BaseEthersClient {
         if (keys.includes(''))
             throw error_1.ErrorKVStoreEmptyKey;
         try {
-            await (await this.contract.setBulk(keys, values, txOptions)).wait();
+            await (await this.contract.setBulk(keys, values, this.applyTxDefaults(txOptions))).wait();
         }
         catch (e) {
             if (e instanceof Error)
@@ -237,13 +237,52 @@ class KVStoreClient extends base_1.BaseEthersClient {
         const contentHash = ethers_1.ethers.keccak256(ethers_1.ethers.toUtf8Bytes(content));
         const hashKey = urlKey + '_hash';
         try {
-            await (await this.contract.setBulk([urlKey, hashKey], [url, contentHash], txOptions)).wait();
+            await (await this.contract.setBulk([urlKey, hashKey], [url, contentHash], this.applyTxDefaults(txOptions))).wait();
         }
         catch (e) {
             if (e instanceof Error)
                 throw Error(`Failed to set URL and hash: ${e.message}`);
         }
     }
+    /**
+     * 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.
+     * @returns {string} Value of the key.
+     *
+     *
+     * **Code example**
+     *
+     * > Need to have available stake.
+     *
+     * ```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');
+     * ```
+     */
+    async get(address, key) {
+        if (key === '')
+            throw error_1.ErrorKVStoreEmptyKey;
+        if (!ethers_1.ethers.isAddress(address))
+            throw error_1.ErrorInvalidAddress;
+        try {
+            const result = await this.contract?.get(address, key);
+            return result;
+        }
+        catch (e) {
+            if (e instanceof Error)
+                throw Error(`Failed to get value: ${e.message}`);
+            return e;
+        }
+    }
 }
 exports.KVStoreClient = KVStoreClient;
 __decorate([

package/dist/operator.d.ts

@@ -6,7 +6,7 @@ export declare class OperatorUtils {
      *
      * @param {ChainId} chainId Network in which the operator is deployed
      * @param {string} address Operator address.
-     * @returns {Promise<IOperator>} Returns the operator details.
+     * @returns {Promise<IOperator | null>} - Returns the operator details or null if not found.
      *
      * **Code example**
      *
@@ -16,7 +16,7 @@ export declare class OperatorUtils {
      * const operator = await OperatorUtils.getOperator(ChainId.POLYGON_AMOY, '0x62dD51230A30401C455c8398d06F85e4EaB6309f');
      * ```
      */
-    static getOperator(chainId: ChainId, address: string): Promise<IOperator>;
+    static getOperator(chainId: ChainId, address: string): Promise<IOperator | null>;
     /**
      * This function returns all the operator details of the protocol.
      *

package/dist/operator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operator.d.ts","sourceRoot":"","sources":["../src/operator.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EAET,gBAAgB,EAEhB,OAAO,EACR,MAAM,cAAc,CAAC;AAetB,OAAO,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAC;AAGlD,qBAAa,aAAa;IACxB;;;;;;;;;;;;;;OAcG;WACiB,WAAW,CAC7B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC;IA8CrB;;;;;;;;;;;;;;;;OAgBG;WACiB,YAAY,CAC9B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,SAAS,EAAE,CAAC;IA+DvB;;;;;;;;;;;;;;;OAeG;WACiB,6BAA6B,CAC/C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,EAAE,CAAC;IAmCvB;;;;;;;;;;;;;;OAcG;WACiB,UAAU,CAC5B,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,EAAE,CAAC;CAyBtB"}
+{"version":3,"file":"operator.d.ts","sourceRoot":"","sources":["../src/operator.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EAET,gBAAgB,EAEhB,OAAO,EACR,MAAM,cAAc,CAAC;AAetB,OAAO,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAC;AAGlD,qBAAa,aAAa;IACxB;;;;;;;;;;;;;;OAcG;WACiB,WAAW,CAC7B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IA8C5B;;;;;;;;;;;;;;;;OAgBG;WACiB,YAAY,CAC9B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,SAAS,EAAE,CAAC;IA+DvB;;;;;;;;;;;;;;;OAeG;WACiB,6BAA6B,CAC/C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,EAAE,CAAC;IAmCvB;;;;;;;;;;;;;;OAcG;WACiB,UAAU,CAC5B,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,EAAE,CAAC;CAyBtB"}

package/dist/operator.js

@@ -19,7 +19,7 @@ class OperatorUtils {
      *
      * @param {ChainId} chainId Network in which the operator is deployed
      * @param {string} address Operator address.
-     * @returns {Promise<IOperator>} Returns the operator details.
+     * @returns {Promise<IOperator | null>} - Returns the operator details or null if not found.
      *
      * **Code example**
      *
@@ -41,7 +41,7 @@ class OperatorUtils {
             address: address.toLowerCase(),
         });
         if (!operator) {
-            return operator || null;
+            return null;
         }
         let jobTypes = [];
         let reputationNetworks = [];

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;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"}
+{"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;IAsB5E;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IAEU,OAAO,CAClB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC,IAAI,CAAC;IAsBhB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IAEU,QAAQ,CAAC,SAAS,GAAE,SAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/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;CAiCvE"}

package/dist/staking.js

@@ -165,7 +165,7 @@ class StakingClient extends base_1.BaseEthersClient {
             throw error_1.ErrorInvalidStakingValueSign;
         }
         try {
-            await (await this.tokenContract.approve(await this.stakingContract.getAddress(), amount, txOptions)).wait();
+            await (await this.tokenContract.approve(await this.stakingContract.getAddress(), amount, this.applyTxDefaults(txOptions))).wait();
             return;
         }
         catch (e) {
@@ -207,7 +207,7 @@ class StakingClient extends base_1.BaseEthersClient {
             throw error_1.ErrorInvalidStakingValueSign;
         }
         try {
-            await (await this.stakingContract.stake(amount, txOptions)).wait();
+            await (await this.stakingContract.stake(amount, this.applyTxDefaults(txOptions))).wait();
             return;
         }
         catch (e) {
@@ -248,7 +248,7 @@ class StakingClient extends base_1.BaseEthersClient {
             throw error_1.ErrorInvalidStakingValueSign;
         }
         try {
-            await (await this.stakingContract.unstake(amount, txOptions)).wait();
+            await (await this.stakingContract.unstake(amount, this.applyTxDefaults(txOptions))).wait();
             return;
         }
         catch (e) {
@@ -281,7 +281,7 @@ class StakingClient extends base_1.BaseEthersClient {
      */
     async withdraw(txOptions = {}) {
         try {
-            await (await this.stakingContract.withdraw(txOptions)).wait();
+            await (await this.stakingContract.withdraw(this.applyTxDefaults(txOptions))).wait();
             return;
         }
         catch (e) {
@@ -330,7 +330,7 @@ class StakingClient extends base_1.BaseEthersClient {
         }
         await this.checkValidEscrow(escrowAddress);
         try {
-            await (await this.stakingContract.slash(slasher, staker, escrowAddress, amount, txOptions)).wait();
+            await (await this.stakingContract.slash(slasher, staker, escrowAddress, amount, this.applyTxDefaults(txOptions))).wait();
             return;
         }
         catch (e) {
@@ -363,6 +363,7 @@ class StakingClient extends base_1.BaseEthersClient {
         }
         try {
             const stakerInfo = await this.stakingContract.stakes(stakerAddress);
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
             const currentBlock = await this.runner.provider.getBlockNumber();
             const tokensWithdrawable = stakerInfo.tokensLockedUntil !== 0n &&
                 currentBlock >= stakerInfo.tokensLockedUntil

package/dist/transaction.d.ts

@@ -22,7 +22,7 @@ export declare class TransactionUtils {
      *
      * @param {ChainId} chainId The chain ID.
      * @param {string} hash The transaction hash.
-     * @returns {Promise<ITransaction>} Returns the transaction details.
+     * @returns {Promise<ITransaction | null>} - Returns the transaction details or null if not found.
      *
      * **Code example**
      *
@@ -32,7 +32,7 @@ export declare class TransactionUtils {
      * const transaction = await TransactionUtils.getTransaction(ChainId.POLYGON, '0x62dD51230A30401C455c8398d06F85e4EaB6309f');
      * ```
      */
-    static getTransaction(chainId: ChainId, hash: string): Promise<ITransaction>;
+    static getTransaction(chainId: ChainId, hash: string): Promise<ITransaction | null>;
     /**
      * This function returns all transaction details based on the provided filter.
      *

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;AAUlD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGjE,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;WACiB,cAAc,CAChC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC;IAmBxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2DG;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":"AAIA,OAAO,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAC;AAUlD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGjE,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;WACiB,cAAc,CAChC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAmB/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2DG;WACiB,eAAe,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;CA2C3B"}

package/dist/transaction.js

@@ -34,7 +34,7 @@ class TransactionUtils {
      *
      * @param {ChainId} chainId The chain ID.
      * @param {string} hash The transaction hash.
-     * @returns {Promise<ITransaction>} Returns the transaction details.
+     * @returns {Promise<ITransaction | null>} - Returns the transaction details or null if not found.
      *
      * **Code example**
      *

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,GAAG,UAgBhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,YAOrC,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":"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"}

package/dist/utils.js

@@ -3,9 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 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 validator_1 = require("validator");
+const constants_1 = require("./constants");
 const enums_1 = require("./enums");
 const error_1 = require("./error");
-const constants_1 = require("./constants");
 /**
  * **Handle and throw the error.*
  *
@@ -43,13 +44,11 @@ exports.throwError = throwError;
  * @returns
  */
 const isValidUrl = (url) => {
-    try {
-        new URL(url);
-        return true;
-    }
-    catch (err) {
-        return false;
-    }
+    return (0, validator_1.isURL)(url, {
+        require_protocol: true,
+        protocols: ['http', 'https'],
+        require_tld: false,
+    });
 };
 exports.isValidUrl = isValidUrl;
 /**

package/dist/worker.d.ts

@@ -6,7 +6,7 @@ export declare class WorkerUtils {
      *
      * @param {ChainId} chainId The chain ID.
      * @param {string} address The worker address.
-     * @returns {Promise<IWorker>} Returns the worker details.
+     * @returns {Promise<IWorker | null>} - Returns the worker details or null if not found.
      *
      * **Code example**
      *

package/dist/worker.js

@@ -17,7 +17,7 @@ class WorkerUtils {
      *
      * @param {ChainId} chainId The chain ID.
      * @param {string} address The worker address.
-     * @returns {Promise<IWorker>} Returns the worker details.
+     * @returns {Promise<IWorker | null>} - Returns the worker details or null if not found.
      *
      * **Code example**
      *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@human-protocol/sdk",
   "description": "Human Protocol SDK",
-  "version": "4.2.0",
+  "version": "4.4.0",
   "files": [
     "src",
     "dist"
@@ -11,13 +11,13 @@
   "scripts": {
     "clean": "tsc --build --clean && rm -rf ./dist",
     "clean:doc": "rm -rf ../../../../docs/sdk/typescript/",
-    "build": "tsc --build",
+    "build": "yarn clean && tsc --build",
     "build:doc": "yarn clean:doc && typedoc --plugin typedoc-plugin-markdown --out ../../../../docs/sdk/typescript/",
-    "prepublish": "yarn build",
     "test": "vitest -u",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
-    "format": "prettier --write '**/*.{ts,json}'"
+    "format": "prettier --write '**/*.{ts,json}'",
+    "prepack": "[ \"${SKIP_PREPACK:-}\" = \"true\" ] && exit 0 || yarn build"
   },
   "repository": {
     "url": "https://github.com/humanprotocol/human-protocol.git",
@@ -38,15 +38,16 @@
     ]
   },
   "dependencies": {
-    "@human-protocol/core": "x",
+    "@human-protocol/core": "4.2.1",
     "axios": "^1.4.0",
-    "ethers": "~6.13.5",
+    "ethers": "~6.15.0",
     "graphql": "^16.8.1",
     "graphql-request": "^6.1.0",
     "graphql-tag": "^2.12.6",
     "minio": "7.1.3",
     "openpgp": "^5.11.2",
     "secp256k1": "^5.0.1",
+    "validator": "^13.12.0",
     "vitest": "^3.0.9"
   },
   "devDependencies": {

package/src/base.ts

@@ -1,5 +1,7 @@
-import { ContractRunner } from 'ethers';
+import { ContractRunner, Overrides } from 'ethers';
 import { NetworkData } from './types';
+import { ChainId } from './enums';
+import { DEFAULT_AURORA_GAS_PRICE } from './constants';
 
 /**
  * ## Introduction
@@ -21,4 +23,24 @@ export abstract class BaseEthersClient {
     this.networkData = networkData;
     this.runner = runner;
   }
+
+  /**
+   * Internal helper to enrich transaction overrides with network specific defaults.
+   *
+   * Aurora networks use a fixed gas price. We always override any user provided
+   * gasPrice with the canonical DEFAULT_AURORA_GAS_PRICE to avoid mismatches
+   * or tx failures due to an unexpected value. For other networks the user
+   * supplied fee parameters are left untouched.
+   */
+  protected applyTxDefaults(txOptions: Overrides = {}): Overrides {
+    if (this.networkData.chainId === ChainId.AURORA_TESTNET) {
+      return {
+        ...txOptions,
+        gasPrice: DEFAULT_AURORA_GAS_PRICE,
+        maxFeePerGas: undefined,
+        maxPriorityFeePerGas: undefined,
+      } as Overrides;
+    }
+    return txOptions;
+  }
 }

package/src/constants.ts

@@ -1,3 +1,4 @@
+import { ethers } from 'ethers';
 import { ChainId } from './enums';
 import { NetworkData } from './types';
 
@@ -11,6 +12,8 @@ export const DEFAULT_PORT = 9000;
 
 export const DEFAULT_USE_SSL = false;
 
+export const DEFAULT_AURORA_GAS_PRICE = ethers.parseUnits('0.07', 'gwei');
+
 export enum HttpStatus {
   OK = 200,
   CREATED = 201,

package/src/escrow.ts

@@ -251,7 +251,7 @@ export class EscrowClient extends BaseEthersClient {
           tokenAddress,
           trustedHandlers,
           jobRequesterId,
-          txOptions
+          this.applyTxDefaults(txOptions)
         )
       ).wait();
 
@@ -380,7 +380,7 @@ export class EscrowClient extends BaseEthersClient {
           exchangeOracleFee,
           manifest,
           manifestHash,
-          txOptions
+          this.applyTxDefaults(txOptions)
         )
       ).wait();
 
@@ -444,7 +444,11 @@ export class EscrowClient extends BaseEthersClient {
         this.runner
       );
       await (
-        await tokenContract.transfer(escrowAddress, amount, txOptions)
+        await tokenContract.transfer(
+          escrowAddress,
+          amount,
+          this.applyTxDefaults(txOptions)
+        )
       ).wait();
 
       return;
@@ -511,7 +515,13 @@ export class EscrowClient extends BaseEthersClient {
     try {
       const escrowContract = this.getEscrowContract(escrowAddress);
 
-      await (await escrowContract.storeResults(url, hash, txOptions)).wait();
+      await (
+        await escrowContract.storeResults(
+          url,
+          hash,
+          this.applyTxDefaults(txOptions)
+        )
+      ).wait();
 
       return;
     } catch (e) {
@@ -561,7 +571,9 @@ export class EscrowClient extends BaseEthersClient {
     try {
       const escrowContract = this.getEscrowContract(escrowAddress);
 
-      await (await escrowContract.complete(txOptions)).wait();
+      await (
+        await escrowContract.complete(this.applyTxDefaults(txOptions))
+      ).wait();
       return;
     } catch (e) {
       return throwError(e);
@@ -638,7 +650,7 @@ export class EscrowClient extends BaseEthersClient {
             finalResultsHash,
             txId,
             forceComplete,
-            txOptions
+            this.applyTxDefaults(txOptions)
           )
         ).wait();
       } else {
@@ -651,7 +663,7 @@ export class EscrowClient extends BaseEthersClient {
             finalResultsUrl,
             finalResultsHash,
             txId,
-            txOptions
+            this.applyTxDefaults(txOptions)
           )
         ).wait();
       }
@@ -704,7 +716,7 @@ export class EscrowClient extends BaseEthersClient {
       const escrowContract = this.getEscrowContract(escrowAddress);
 
       const transactionReceipt = await (
-        await escrowContract.cancel(txOptions)
+        await escrowContract.cancel(this.applyTxDefaults(txOptions))
       ).wait();
 
       let amountTransferred: bigint | undefined = undefined;
@@ -801,7 +813,10 @@ export class EscrowClient extends BaseEthersClient {
       const escrowContract = this.getEscrowContract(escrowAddress);
 
       await (
-        await escrowContract.addTrustedHandlers(trustedHandlers, txOptions)
+        await escrowContract.addTrustedHandlers(
+          trustedHandlers,
+          this.applyTxDefaults(txOptions)
+        )
       ).wait();
       return;
     } catch (e) {
@@ -861,7 +876,10 @@ export class EscrowClient extends BaseEthersClient {
       const escrowContract = this.getEscrowContract(escrowAddress);
 
       const transactionReceipt = await (
-        await escrowContract.withdraw(tokenAddress, txOptions)
+        await escrowContract.withdraw(
+          tokenAddress,
+          this.applyTxDefaults(txOptions)
+        )
       ).wait();
 
       let amountTransferred: bigint | undefined = undefined;
@@ -953,6 +971,7 @@ export class EscrowClient extends BaseEthersClient {
     forceComplete = false,
     txOptions: Overrides = {}
   ): Promise<TransactionLikeWithNonce> {
+    txOptions = this.applyTxDefaults(txOptions);
     await this.ensureCorrectBulkPayoutInput(
       escrowAddress,
       recipients,
@@ -1764,7 +1783,7 @@ export class EscrowUtils {
    *
    * @param {ChainId} chainId Network in which the escrow has been deployed
    * @param {string} escrowAddress Address of the escrow
-   * @returns {IEscrow} Escrow data
+   * @returns {Promise<IEscrow | null>} - Escrow data or null if not found.
    *
    * **Code example**
    *
@@ -1777,7 +1796,7 @@ export class EscrowUtils {
   public static async getEscrow(
     chainId: ChainId,
     escrowAddress: string
-  ): Promise<IEscrow> {
+  ): Promise<IEscrow | null> {
     const networkData = NETWORKS[chainId];
 
     if (!networkData) {
@@ -1793,6 +1812,7 @@ export class EscrowUtils {
       GET_ESCROW_BY_ADDRESS_QUERY(),
       { escrowAddress: escrowAddress.toLowerCase() }
     );
+    escrow.chainId = networkData.chainId;
 
     return escrow || null;
   }

package/src/index.ts

@@ -13,6 +13,18 @@ export * from './types';
 export * from './enums';
 export * from './interfaces';
 
+export {
+  EthereumError,
+  InvalidArgumentError,
+  ReplacementUnderpriced,
+  NumericFault,
+  NonceExpired,
+  TransactionReplaced,
+  ContractExecutionError,
+  InvalidEthereumAddressError,
+  InvalidKeyError,
+} from './error';
+
 export {
   StakingClient,
   StorageClient,

package/src/kvstore.ts

@@ -175,7 +175,9 @@ export class KVStoreClient extends BaseEthersClient {
   ): Promise<void> {
     if (key === '') throw ErrorKVStoreEmptyKey;
     try {
-      await (await this.contract.set(key, value, txOptions)).wait();
+      await (
+        await this.contract.set(key, value, this.applyTxDefaults(txOptions))
+      ).wait();
     } catch (e) {
       if (e instanceof Error) throw Error(`Failed to set value: ${e.message}`);
     }
@@ -220,7 +222,13 @@ export class KVStoreClient extends BaseEthersClient {
     if (keys.includes('')) throw ErrorKVStoreEmptyKey;
 
     try {
-      await (await this.contract.setBulk(keys, values, txOptions)).wait();
+      await (
+        await this.contract.setBulk(
+          keys,
+          values,
+          this.applyTxDefaults(txOptions)
+        )
+      ).wait();
     } catch (e) {
       if (e instanceof Error)
         throw Error(`Failed to set bulk values: ${e.message}`);
@@ -273,7 +281,7 @@ export class KVStoreClient extends BaseEthersClient {
         await this.contract.setBulk(
           [urlKey, hashKey],
           [url, contentHash],
-          txOptions
+          this.applyTxDefaults(txOptions)
         )
       ).wait();
     } catch (e) {
@@ -281,6 +289,42 @@ export class KVStoreClient extends BaseEthersClient {
         throw Error(`Failed to set URL and hash: ${e.message}`);
     }
   }
+  /**
+   * 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.
+   * @returns {string} Value of the key.
+   *
+   *
+   * **Code example**
+   *
+   * > Need to have available stake.
+   *
+   * ```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');
+   * ```
+   */
+  public async get(address: string, key: string): Promise<string> {
+    if (key === '') throw ErrorKVStoreEmptyKey;
+    if (!ethers.isAddress(address)) throw ErrorInvalidAddress;
+
+    try {
+      const result = await this.contract?.get(address, key);
+      return result;
+    } catch (e) {
+      if (e instanceof Error) throw Error(`Failed to get value: ${e.message}`);
+      return e;
+    }
+  }
 }
 
 /**

package/src/operator.ts

@@ -30,7 +30,7 @@ export class OperatorUtils {
    *
    * @param {ChainId} chainId Network in which the operator is deployed
    * @param {string} address Operator address.
-   * @returns {Promise<IOperator>} Returns the operator details.
+   * @returns {Promise<IOperator | null>} - Returns the operator details or null if not found.
    *
    * **Code example**
    *
@@ -43,7 +43,7 @@ export class OperatorUtils {
   public static async getOperator(
     chainId: ChainId,
     address: string
-  ): Promise<IOperator> {
+  ): Promise<IOperator | null> {
     if (!ethers.isAddress(address)) {
       throw ErrorInvalidStakerAddressProvided;
     }
@@ -60,7 +60,7 @@ export class OperatorUtils {
     });
 
     if (!operator) {
-      return (operator as IOperator) || null;
+      return null;
     }
 
     let jobTypes: string[] = [];

package/src/staking.ts

@@ -207,7 +207,7 @@ export class StakingClient extends BaseEthersClient {
         await this.tokenContract.approve(
           await this.stakingContract.getAddress(),
           amount,
-          txOptions
+          this.applyTxDefaults(txOptions)
         )
       ).wait();
       return;
@@ -254,7 +254,12 @@ export class StakingClient extends BaseEthersClient {
     }
 
     try {
-      await (await this.stakingContract.stake(amount, txOptions)).wait();
+      await (
+        await this.stakingContract.stake(
+          amount,
+          this.applyTxDefaults(txOptions)
+        )
+      ).wait();
       return;
     } catch (e) {
       return throwError(e);
@@ -301,7 +306,12 @@ export class StakingClient extends BaseEthersClient {
     }
 
     try {
-      await (await this.stakingContract.unstake(amount, txOptions)).wait();
+      await (
+        await this.stakingContract.unstake(
+          amount,
+          this.applyTxDefaults(txOptions)
+        )
+      ).wait();
       return;
     } catch (e) {
       return throwError(e);
@@ -335,7 +345,9 @@ export class StakingClient extends BaseEthersClient {
   @requiresSigner
   public async withdraw(txOptions: Overrides = {}): Promise<void> {
     try {
-      await (await this.stakingContract.withdraw(txOptions)).wait();
+      await (
+        await this.stakingContract.withdraw(this.applyTxDefaults(txOptions))
+      ).wait();
       return;
     } catch (e) {
       return throwError(e);
@@ -402,7 +414,7 @@ export class StakingClient extends BaseEthersClient {
           staker,
           escrowAddress,
           amount,
-          txOptions
+          this.applyTxDefaults(txOptions)
         )
       ).wait();
 
@@ -439,6 +451,7 @@ export class StakingClient extends BaseEthersClient {
 
     try {
       const stakerInfo = await this.stakingContract.stakes(stakerAddress);
+      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
       const currentBlock = await this.runner.provider!.getBlockNumber();
 
       const tokensWithdrawable =

package/src/transaction.ts

@@ -37,7 +37,7 @@ export class TransactionUtils {
    *
    * @param {ChainId} chainId The chain ID.
    * @param {string} hash The transaction hash.
-   * @returns {Promise<ITransaction>} Returns the transaction details.
+   * @returns {Promise<ITransaction | null>} - Returns the transaction details or null if not found.
    *
    * **Code example**
    *
@@ -50,7 +50,7 @@ export class TransactionUtils {
   public static async getTransaction(
     chainId: ChainId,
     hash: string
-  ): Promise<ITransaction> {
+  ): Promise<ITransaction | null> {
     if (!ethers.isHexString(hash)) {
       throw ErrorInvalidHashProvided;
     }

package/src/utils.ts

@@ -1,6 +1,8 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 import { ethers } from 'ethers';
 
+import { isURL } from 'validator';
+import { SUBGRAPH_API_KEY_PLACEHOLDER } from './constants';
 import { ChainId } from './enums';
 import {
   ContractExecutionError,
@@ -13,7 +15,6 @@ import {
   WarnSubgraphApiKeyNotProvided,
 } from './error';
 import { NetworkData } from './types';
-import { SUBGRAPH_API_KEY_PLACEHOLDER } from './constants';
 
 /**
  * **Handle and throw the error.*
@@ -45,13 +46,12 @@ export const throwError = (e: any) => {
  * @param {string} url
  * @returns
  */
-export const isValidUrl = (url: string) => {
-  try {
-    new URL(url);
-    return true;
-  } catch (err) {
-    return false;
-  }
+export const isValidUrl = (url: string): boolean => {
+  return isURL(url, {
+    require_protocol: true,
+    protocols: ['http', 'https'],
+    require_tld: false,
+  });
 };
 
 /**

package/src/worker.ts

@@ -13,7 +13,7 @@ export class WorkerUtils {
    *
    * @param {ChainId} chainId The chain ID.
    * @param {string} address The worker address.
-   * @returns {Promise<IWorker>} Returns the worker details.
+   * @returns {Promise<IWorker | null>} - Returns the worker details or null if not found.
    *
    * **Code example**
    *