@human-protocol/sdk 4.1.5 → 4.3.0

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/utils.d.ts

@@ -13,6 +13,13 @@ export declare const throwError: (e: any) => never;
  * @returns
  */
 export declare const isValidUrl: (url: string) => boolean;
+/**
+ * **Check if a string is a valid JSON.*
+ *
+ * @param {string} input
+ * @returns {boolean}
+ */
+export declare const isValidJson: (input: string) => boolean;
 /**
  * **Get the subgraph URL.*
  *

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,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":"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"}

package/dist/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getUnixTimestamp = exports.getSubgraphUrl = exports.isValidUrl = exports.throwError = void 0;
+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 enums_1 = require("./enums");
@@ -52,6 +52,22 @@ const isValidUrl = (url) => {
     }
 };
 exports.isValidUrl = isValidUrl;
+/**
+ * **Check if a string is a valid JSON.*
+ *
+ * @param {string} input
+ * @returns {boolean}
+ */
+const isValidJson = (input) => {
+    try {
+        JSON.parse(input);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+exports.isValidJson = isValidJson;
 /**
  * **Get the subgraph URL.*
  *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@human-protocol/sdk",
   "description": "Human Protocol SDK",
-  "version": "4.1.5",
+  "version": "4.3.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,9 +38,9 @@
     ]
   },
   "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",

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,
@@ -36,7 +39,7 @@ export const NETWORKS: {
     subgraphUrl:
       'https://api.studio.thegraph.com/query/74256/ethereum/version/latest',
     subgraphUrlApiKey:
-      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmSxVvFd4STZkR9gwfuJ76YUpYGcWcBJ6Sm3kqBJHFdUw2',
+      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmQwp4Rr2J4UbPFykb9eXg2t7GPcGRS6WT7QzExZtv32jK',
     oldSubgraphUrl: '',
     oldFactoryAddress: '',
   },
@@ -51,7 +54,7 @@ export const NETWORKS: {
     subgraphUrl:
       'https://api.studio.thegraph.com/query/74256/sepolia/version/latest',
     subgraphUrlApiKey:
-      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmP3Ma4hZ6ZBxNTL2ip2BCkB33vMgRKRLpw74KcwZShzvk',
+      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmURrhnEXimGnRzjeN3B4VMmioUeBHUBg4WJ7KZzJ7em8g',
     oldSubgraphUrl: '',
     oldFactoryAddress: '',
   },
@@ -66,7 +69,7 @@ export const NETWORKS: {
     subgraphUrl:
       'https://api.studio.thegraph.com/query/74256/bsc/version/latest',
     subgraphUrlApiKey:
-      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmW54Mzx63QNVdvk2V9kRaoHicfeJFuDSt7xSGDHpZg9AW',
+      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmT2VoBLjAfc4pQzDmeCGra6weoLuk2jPRgnRz5iSMUw1t',
     oldSubgraphUrl: 'https://api.thegraph.com/subgraphs/name/humanprotocol/bsc',
     oldFactoryAddress: '0xc88bC422cAAb2ac8812de03176402dbcA09533f4',
   },
@@ -81,7 +84,7 @@ export const NETWORKS: {
     subgraphUrl:
       'https://api.studio.thegraph.com/query/74256/bsc-testnet/version/latest',
     subgraphUrlApiKey:
-      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmWaq9orii1Xkw9uCVJ7akDnjY2fuewBRU5LiUKT12XVui',
+      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmZHqbiyAAwrmqsVJLhTEdejVGYJpXfJAkJXUw7C2VV1TD',
     oldSubgraphUrl:
       'https://api.thegraph.com/subgraphs/name/humanprotocol/bsctest',
     oldFactoryAddress: '0xaae6a2646c1f88763e62e0cd08ad050ea66ac46f',
@@ -97,7 +100,7 @@ export const NETWORKS: {
     subgraphUrl:
       'https://api.studio.thegraph.com/query/74256/polygon/version/latest',
     subgraphUrlApiKey:
-      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmVmsQCdB3dGjt9tKG2Y96PRsHUCgGPK8oWtyVw8HMypTc',
+      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmT72ecfx6Zaje21kLNi17kDJTpPKFYvzQETDyLpQgDrPu',
     oldSubgraphUrl:
       'https://api.thegraph.com/subgraphs/name/humanprotocol/polygon',
     oldFactoryAddress: '0x45eBc3eAE6DA485097054ae10BA1A0f8e8c7f794',
@@ -113,7 +116,7 @@ export const NETWORKS: {
     subgraphUrl:
       'https://api.studio.thegraph.com/query/74256/amoy/version/latest',
     subgraphUrlApiKey:
-      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmPD243cnyp6ApUT2zpsNLKmtM75RLHNwUGT7NRTDds7QN',
+      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmeeE9bVkat1mkbQg1R6SXLuLadXxoNCY5b7CEQkmu6cQi',
     oldSubgraphUrl: '',
     oldFactoryAddress: '',
   },
@@ -128,7 +131,7 @@ export const NETWORKS: {
     subgraphUrl:
       'https://api.studio.thegraph.com/query/74256/amoy/version/latest',
     subgraphUrlApiKey:
-      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmVQuank2mwaZg3mcLUH15QEP8KaVS4NNsRaWxnq5mRWoo',
+      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmQiLaFKusXLzKrpZvQDg7vETLhdfPgzWJN3Uxp3bE9K9W',
     oldSubgraphUrl: '',
     oldFactoryAddress: '',
   },

package/src/error.ts

@@ -202,9 +202,9 @@ export const ErrorManifestFileDoesNotExist = new Error(
 export const ErrorInvalidUrl = new Error('Invalid URL string');
 
 /**
- * @constant {Error} - URL is an empty string.
+ * @constant {Error} - Invalid manifest.
  */
-export const ErrorUrlIsEmptyString = new Error('URL is an empty string');
+export const ErrorInvalidManifest = new Error('Invalid manifest');
 
 /**
  * @constant {Error} - List of handlers cannot be empty.

package/src/escrow.ts

@@ -24,6 +24,7 @@ import {
   ErrorInvalidAddress,
   ErrorInvalidEscrowAddressProvided,
   ErrorInvalidExchangeOracleAddressProvided,
+  ErrorInvalidManifest,
   ErrorInvalidRecordingOracleAddressProvided,
   ErrorInvalidReputationOracleAddressProvided,
   ErrorInvalidTokenAddress,
@@ -37,7 +38,6 @@ import {
   ErrorTotalFeeMustBeLessThanHundred,
   ErrorTransferEventNotFoundInTransactionLogs,
   ErrorUnsupportedChainID,
-  ErrorUrlIsEmptyString,
   InvalidEthereumAddressError,
 } from './error';
 import {
@@ -66,6 +66,7 @@ import {
 import {
   getSubgraphUrl,
   getUnixTimestamp,
+  isValidJson,
   isValidUrl,
   throwError,
 } from './utils';
@@ -250,7 +251,7 @@ export class EscrowClient extends BaseEthersClient {
           tokenAddress,
           trustedHandlers,
           jobRequesterId,
-          txOptions
+          this.applyTxDefaults(txOptions)
         )
       ).wait();
 
@@ -302,7 +303,7 @@ export class EscrowClient extends BaseEthersClient {
    *    recordingOracleFee: BigInt('10'),
    *    reputationOracleFee: BigInt('10'),
    *    exchangeOracleFee: BigInt('10'),
-   *    manifestUrl: 'http://localhost/manifest.json',
+   *    manifest: 'http://localhost/manifest.json',
    *    manifestHash: 'b5dad76bf6772c0f07fd5e048f6e75a5f86ee079',
    * };
    * await escrowClient.setup(escrowAddress, escrowConfig);
@@ -321,7 +322,7 @@ export class EscrowClient extends BaseEthersClient {
       recordingOracleFee,
       reputationOracleFee,
       exchangeOracleFee,
-      manifestUrl,
+      manifest,
       manifestHash,
     } = escrowConfig;
 
@@ -353,12 +354,9 @@ export class EscrowClient extends BaseEthersClient {
       throw ErrorTotalFeeMustBeLessThanHundred;
     }
 
-    if (!manifestUrl) {
-      throw ErrorUrlIsEmptyString;
-    }
-
-    if (!isValidUrl(manifestUrl)) {
-      throw ErrorInvalidUrl;
+    const isManifestValid = isValidUrl(manifest) || isValidJson(manifest);
+    if (!isManifestValid) {
+      throw ErrorInvalidManifest;
     }
 
     if (!manifestHash) {
@@ -380,9 +378,9 @@ export class EscrowClient extends BaseEthersClient {
           reputationOracleFee,
           recordingOracleFee,
           exchangeOracleFee,
-          manifestUrl,
+          manifest,
           manifestHash,
-          txOptions
+          this.applyTxDefaults(txOptions)
         )
       ).wait();
 
@@ -446,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;
@@ -495,7 +497,7 @@ export class EscrowClient extends BaseEthersClient {
     }
 
     if (!url) {
-      throw ErrorUrlIsEmptyString;
+      throw ErrorInvalidUrl;
     }
 
     if (!isValidUrl(url)) {
@@ -513,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) {
@@ -563,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);
@@ -640,7 +650,7 @@ export class EscrowClient extends BaseEthersClient {
             finalResultsHash,
             txId,
             forceComplete,
-            txOptions
+            this.applyTxDefaults(txOptions)
           )
         ).wait();
       } else {
@@ -653,7 +663,7 @@ export class EscrowClient extends BaseEthersClient {
             finalResultsUrl,
             finalResultsHash,
             txId,
-            txOptions
+            this.applyTxDefaults(txOptions)
           )
         ).wait();
       }
@@ -706,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;
@@ -803,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) {
@@ -863,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;
@@ -955,6 +971,7 @@ export class EscrowClient extends BaseEthersClient {
     forceComplete = false,
     txOptions: Overrides = {}
   ): Promise<TransactionLikeWithNonce> {
+    txOptions = this.applyTxDefaults(txOptions);
     await this.ensureCorrectBulkPayoutInput(
       escrowAddress,
       recipients,
@@ -1043,7 +1060,7 @@ export class EscrowClient extends BaseEthersClient {
     });
 
     if (!finalResultsUrl) {
-      throw ErrorUrlIsEmptyString;
+      throw ErrorInvalidUrl;
     }
 
     if (!isValidUrl(finalResultsUrl)) {
@@ -1153,7 +1170,7 @@ export class EscrowClient extends BaseEthersClient {
   }
 
   /**
-   * This function returns the manifest file URL.
+   * This function returns the manifest. Could be a URL or a JSON string.
    *
    * @param {string} escrowAddress Address of the escrow.
    * @returns {Promise<string>} Url of the manifest.
@@ -1169,10 +1186,10 @@ export class EscrowClient extends BaseEthersClient {
    * const provider = new providers.JsonRpcProvider(rpcUrl);
    * const escrowClient = await EscrowClient.build(provider);
    *
-   * const manifestUrl = await escrowClient.getManifestUrl('0x62dD51230A30401C455c8398d06F85e4EaB6309f');
+   * const manifest = await escrowClient.getManifest('0x62dD51230A30401C455c8398d06F85e4EaB6309f');
    * ```
    */
-  async getManifestUrl(escrowAddress: string): Promise<string> {
+  async getManifest(escrowAddress: string): Promise<string> {
     if (!ethers.isAddress(escrowAddress)) {
       throw ErrorInvalidEscrowAddressProvided;
     }
@@ -1631,7 +1648,7 @@ export class EscrowUtils {
    *   intermediateResultsUrl?: string;
    *   launcher: string;
    *   manifestHash?: string;
-   *   manifestUrl?: string;
+   *   manifest?: string;
    *   recordingOracle?: string;
    *   reputationOracle?: string;
    *   exchangeOracle?: string;
@@ -1752,7 +1769,7 @@ export class EscrowUtils {
    *   intermediateResultsUrl?: string;
    *   launcher: string;
    *   manifestHash?: string;
-   *   manifestUrl?: string;
+   *   manifest?: string;
    *   recordingOracle?: string;
    *   reputationOracle?: string;
    *   exchangeOracle?: string;

package/src/graphql/queries/escrow.ts

@@ -14,7 +14,7 @@ const ESCROW_FRAGMENT = gql`
     jobRequesterId
     launcher
     manifestHash
-    manifestUrl
+    manifest
     recordingOracle
     reputationOracle
     exchangeOracle

package/src/interfaces.ts

@@ -75,7 +75,7 @@ export interface IEscrow {
   intermediateResultsUrl?: string;
   launcher: string;
   manifestHash?: string;
-  manifestUrl?: string;
+  manifest?: string;
   recordingOracle?: string;
   reputationOracle?: string;
   exchangeOracle?: string;
@@ -105,7 +105,7 @@ export interface IEscrowConfig {
   recordingOracleFee: bigint;
   reputationOracleFee: bigint;
   exchangeOracleFee: bigint;
-  manifestUrl: string;
+  manifest: string;
   manifestHash: string;
 }
 

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/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 =