@human-protocol/sdk 5.0.0-beta.0 → 5.0.0-beta.2

package/dist/staking.js

@@ -171,7 +171,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) {
@@ -213,7 +213,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) {
@@ -254,7 +254,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) {
@@ -287,7 +287,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) {
@@ -336,7 +336,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) {

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": "5.0.0-beta.0",
+  "version": "5.0.0-beta.2",
   "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,7 +38,7 @@
     ]
   },
   "dependencies": {
-    "@human-protocol/core": "x",
+    "@human-protocol/core": "5.0.0-beta.2",
     "axios": "^1.4.0",
     "ethers": "~6.15.0",
     "graphql": "^16.8.1",
@@ -47,6 +47,7 @@
     "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,
@@ -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/QmVYn12ZqBeZf9J9orq9RYV1C9iQ9uyWWF5vsWFJiKR68e',
+      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmaDx3yapopC5xbXqqpkuZ5yLNPjs35wui9kyLS2oX55uE',
     oldSubgraphUrl: '',
     oldFactoryAddress: '',
   },
@@ -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/QmfRiMaGaL224Z5ii4JAJjfyT64KysYM9gFFWbkDW9QwK1',
+      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/Qmezp2vvVWXasTeyBmLHUaMA8WyX253r7RXcs1M4Zw2hN8',
     oldSubgraphUrl:
       'https://api.thegraph.com/subgraphs/name/humanprotocol/bsctest',
     oldFactoryAddress: '0xaae6a2646c1f88763e62e0cd08ad050ea66ac46f',
@@ -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/QmRHsvZo2wW2Y3fDHz6xsHd6wBQyacbzKmFfNYQ8Zy3KLy',
+      'https://gateway-arbitrum.network.thegraph.com/api/[SUBGRAPH_API_KEY]/deployments/id/QmZq6nAyJZgTqCEChm95xqntPpHJ7mnMBi9iDPDAQSyxZa',
     oldSubgraphUrl: '',
     oldFactoryAddress: '',
   },

package/src/escrow.ts

@@ -245,7 +245,7 @@ export class EscrowClient extends BaseEthersClient {
         await this.escrowFactoryContract.createEscrow(
           tokenAddress,
           jobRequesterId,
-          txOptions
+          this.applyTxDefaults(txOptions)
         )
       ).wait();
 
@@ -374,7 +374,7 @@ export class EscrowClient extends BaseEthersClient {
           exchangeOracleFee,
           manifest,
           manifestHash,
-          txOptions
+          this.applyTxDefaults(txOptions)
         )
       ).wait();
 
@@ -438,7 +438,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;
@@ -559,7 +563,7 @@ export class EscrowClient extends BaseEthersClient {
             url,
             hash,
             fundsToReserve,
-            txOptions
+            this.applyTxDefaults(txOptions)
           )
         ).wait();
       } else {
@@ -567,7 +571,7 @@ export class EscrowClient extends BaseEthersClient {
           await escrowContract['storeResults(string,string)'](
             url,
             hash,
-            txOptions
+            this.applyTxDefaults(txOptions)
           )
         ).wait();
       }
@@ -623,7 +627,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);
@@ -763,7 +769,7 @@ export class EscrowClient extends BaseEthersClient {
             finalResultsHash,
             id,
             forceComplete,
-            txOptions
+            this.applyTxDefaults(txOptions)
           )
         ).wait();
       } else {
@@ -777,7 +783,7 @@ export class EscrowClient extends BaseEthersClient {
             finalResultsHash,
             id,
             forceComplete,
-            txOptions
+            this.applyTxDefaults(txOptions)
           )
         ).wait();
       }
@@ -831,7 +837,9 @@ export class EscrowClient extends BaseEthersClient {
 
     try {
       const escrowContract = this.getEscrowContract(escrowAddress);
-      await (await escrowContract.cancel(txOptions)).wait();
+      await (
+        await escrowContract.cancel(this.applyTxDefaults(txOptions))
+      ).wait();
     } catch (e) {
       return throwError(e);
     }
@@ -877,7 +885,11 @@ export class EscrowClient extends BaseEthersClient {
 
     try {
       const escrowContract = this.getEscrowContract(escrowAddress);
-      await (await escrowContract.requestCancellation(txOptions)).wait();
+      await (
+        await escrowContract.requestCancellation(
+          this.applyTxDefaults(txOptions)
+        )
+      ).wait();
     } catch (e) {
       return throwError(e);
     }
@@ -935,7 +947,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;
@@ -1027,6 +1042,7 @@ export class EscrowClient extends BaseEthersClient {
     forceComplete = false,
     txOptions: Overrides = {}
   ): Promise<TransactionLikeWithNonce> {
+    txOptions = this.applyTxDefaults(txOptions);
     await this.ensureCorrectBulkPayoutInput(
       escrowAddress,
       recipients,
@@ -1913,7 +1929,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**
    *
@@ -1926,7 +1942,7 @@ export class EscrowUtils {
   public static async getEscrow(
     chainId: ChainId,
     escrowAddress: string
-  ): Promise<IEscrow> {
+  ): Promise<IEscrow | null> {
     const networkData = NETWORKS[chainId];
 
     if (!networkData) {

package/src/graphql/queries/escrow.ts

@@ -9,8 +9,10 @@ const ESCROW_FRAGMENT = gql`
     count
     factoryAddress
     finalResultsUrl
+    finalResultsHash
     id
     intermediateResultsUrl
+    intermediateResultsHash
     jobRequesterId
     launcher
     manifestHash
@@ -18,6 +20,9 @@ const ESCROW_FRAGMENT = gql`
     recordingOracle
     reputationOracle
     exchangeOracle
+    recordingOracleFee
+    reputationOracleFee
+    exchangeOracleFee
     status
     token
     totalFundedAmount

package/src/graphql/types.ts

@@ -8,13 +8,18 @@ export type EscrowData = {
   count: string;
   factoryAddress: string;
   finalResultsUrl?: string;
+  finalResultsHash?: string;
   intermediateResultsUrl?: string;
+  intermediateResultsHash?: string;
   launcher: string;
   manifestHash?: string;
   manifestUrl?: string;
   recordingOracle?: string;
   reputationOracle?: string;
   exchangeOracle?: string;
+  recordingOracleFee?: string;
+  reputationOracleFee?: string;
+  exchangeOracleFee?: string;
   status: string;
   token: string;
   totalFundedAmount: string;

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/interfaces.ts

@@ -82,13 +82,18 @@ export interface IEscrow {
   count: string;
   factoryAddress: string;
   finalResultsUrl?: string;
+  finalResultsHash?: string;
   intermediateResultsUrl?: string;
+  intermediateResultsHash?: string;
   launcher: string;
   manifestHash?: string;
   manifest?: string;
   recordingOracle?: string;
   reputationOracle?: string;
   exchangeOracle?: string;
+  recordingOracleFee?: string;
+  reputationOracleFee?: string;
+  exchangeOracleFee?: string;
   status: string;
   token: string;
   totalFundedAmount: 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/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 null as any;
+      return null;
     }
 
     return mapOperator(operator, chainId);

package/src/staking.ts

@@ -213,7 +213,7 @@ export class StakingClient extends BaseEthersClient {
         await this.tokenContract.approve(
           await this.stakingContract.getAddress(),
           amount,
-          txOptions
+          this.applyTxDefaults(txOptions)
         )
       ).wait();
       return;
@@ -260,7 +260,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);
@@ -307,7 +312,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);
@@ -341,7 +351,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);
@@ -408,7 +420,7 @@ export class StakingClient extends BaseEthersClient {
           staker,
           escrowAddress,
           amount,
-          txOptions
+          this.applyTxDefaults(txOptions)
         )
       ).wait();
 

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;
     }