@human-protocol/sdk 1.1.18 → 2.0.0

package/dist/escrow.js

@@ -13,6 +13,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EscrowUtils = exports.EscrowClient = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
 const typechain_types_1 = require("@human-protocol/core/typechain-types");
 const ethers_1 = require("ethers");
 const graphql_request_1 = __importDefault(require("graphql-request"));
@@ -20,19 +21,19 @@ const base_1 = require("./base");
 const constants_1 = require("./constants");
 const decorators_1 = require("./decorators");
 const error_1 = require("./error");
+const graphql_1 = require("./graphql");
 const types_1 = require("./types");
 const utils_1 = require("./utils");
-const graphql_1 = require("./graphql");
 /**
  * ## Introduction
  *
  * This client enables to perform actions on Escrow contracts and obtain information from both the contracts and subgraph.
  *
- * Internally, the SDK will use one network or another according to the network ID of the `signerOrProvider`.
+ * Internally, the SDK will use one network or another according to the network ID of the `runner`.
  * To use this client, it is recommended to initialize it using the static `build` method.
  *
  * ```ts
- * static async build(signerOrProvider: Signer | Provider);
+ * static async build(runner: ContractRunner);
  * ```
  *
  * A `Signer` or a `Provider` should be passed depending on the use case of this module:
@@ -96,41 +97,33 @@ class EscrowClient extends base_1.BaseEthersClient {
     /**
      * **EscrowClient constructor**
      *
-     * @param {Signer | Provider} signerOrProvider The Signer or Provider object to interact with the Ethereum network
+     * @param {ContractRunner} runner The Runner object to interact with the Ethereum network
      * @param {NetworkData} network The network information required to connect to the Escrow contract
-     * @param {number | undefined} gasPriceMultiplier The multiplier to apply to the gas price
      */
-    constructor(signerOrProvider, networkData, gasPriceMultiplier) {
-        super(signerOrProvider, networkData, gasPriceMultiplier);
-        this.escrowFactoryContract = typechain_types_1.EscrowFactory__factory.connect(networkData.factoryAddress, signerOrProvider);
+    constructor(runner, networkData) {
+        super(runner, networkData);
+        this.escrowFactoryContract = typechain_types_1.EscrowFactory__factory.connect(networkData.factoryAddress, runner);
     }
     /**
-     * Creates an instance of EscrowClient from a Signer or Provider.
+     * Creates an instance of EscrowClient from a Runner.
      *
-     * @param {Signer | Provider} signerOrProvider The Signer or Provider object to interact with the Ethereum network
-     * @param {number | undefined} gasPriceMultiplier The multiplier to apply to the gas price
+     * @param {ContractRunner} runner The Runner object to interact with the Ethereum network
      *
      * @returns {Promise<EscrowClient>} An instance of EscrowClient
      * @throws {ErrorProviderDoesNotExist} Thrown if the provider does not exist for the provided Signer
      * @throws {ErrorUnsupportedChainID} Thrown if the network's chainId is not supported
      */
-    static async build(signerOrProvider, gasPriceMultiplier) {
-        let network;
-        if (ethers_1.Signer.isSigner(signerOrProvider)) {
-            if (!signerOrProvider.provider) {
-                throw error_1.ErrorProviderDoesNotExist;
-            }
-            network = await signerOrProvider.provider.getNetwork();
+    static async build(runner) {
+        if (!runner.provider) {
+            throw error_1.ErrorProviderDoesNotExist;
         }
-        else {
-            network = await signerOrProvider.getNetwork();
-        }
-        const chainId = network.chainId;
+        const network = await runner.provider?.getNetwork();
+        const chainId = Number(network?.chainId);
         const networkData = constants_1.NETWORKS[chainId];
         if (!networkData) {
             throw error_1.ErrorUnsupportedChainID;
         }
-        return new EscrowClient(signerOrProvider, networkData, gasPriceMultiplier);
+        return new EscrowClient(runner, networkData);
     }
     /**
      * Connects to the escrow contract
@@ -139,7 +132,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      */
     getEscrowContract(escrowAddress) {
         try {
-            return typechain_types_1.Escrow__factory.connect(escrowAddress, this.signerOrProvider);
+            return typechain_types_1.Escrow__factory.connect(escrowAddress, this.runner);
         }
         catch (e) {
             return (0, utils_1.throwError)(e);
@@ -151,6 +144,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * @param {string} tokenAddress Token address to use for pay outs.
      * @param {string[]} trustedHandlers Array of addresses that can perform actions on the contract.
      * @param {string} jobRequesterId Job Requester Id
+     * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns {Promise<string>} Return the address of the escrow created.
      *
      *
@@ -175,20 +169,18 @@ class EscrowClient extends base_1.BaseEthersClient {
      * const escrowAddress = await escrowClient.createEscrow(tokenAddress, trustedHandlers, jobRequesterId);
      * ```
      */
-    async createEscrow(tokenAddress, trustedHandlers, jobRequesterId) {
-        if (!ethers_1.ethers.utils.isAddress(tokenAddress)) {
+    async createEscrow(tokenAddress, trustedHandlers, jobRequesterId, txOptions = {}) {
+        if (!ethers_1.ethers.isAddress(tokenAddress)) {
             throw error_1.ErrorInvalidTokenAddress;
         }
         trustedHandlers.forEach((trustedHandler) => {
-            if (!ethers_1.ethers.utils.isAddress(trustedHandler)) {
+            if (!ethers_1.ethers.isAddress(trustedHandler)) {
                 throw new error_1.InvalidEthereumAddressError(trustedHandler);
             }
         });
         try {
-            const result = await (await this.escrowFactoryContract.createEscrow(tokenAddress, trustedHandlers, jobRequesterId, {
-                ...(await this.gasPriceOptions()),
-            })).wait();
-            const event = result.events?.find(({ topics }) => topics.includes(ethers_1.ethers.utils.id('LaunchedV2(address,address,string)')))?.args;
+            const result = await (await this.escrowFactoryContract.createEscrow(tokenAddress, trustedHandlers, jobRequesterId, 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;
             }
@@ -203,6 +195,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      *
      * @param {string} escrowAddress Address of the escrow to set up.
      * @param {IEscrowConfig} escrowConfig Escrow configuration parameters.
+     * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
      *
@@ -226,35 +219,35 @@ class EscrowClient extends base_1.BaseEthersClient {
      *    recordingOracle: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
      *    reputationOracle: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
      *    exchangeOracle: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
-     *    recordingOracleFee: BigNumber.from('10'),
-     *    reputationOracleFee: BigNumber.from('10'),
-     *    exchangeOracleFee: BigNumber.from('10'),
+     *    recordingOracleFee: bigint.from('10'),
+     *    reputationOracleFee: bigint.from('10'),
+     *    exchangeOracleFee: bigint.from('10'),
      *    manifestUrl: 'htttp://localhost/manifest.json',
      *    manifestHash: 'b5dad76bf6772c0f07fd5e048f6e75a5f86ee079',
      * };
      * await escrowClient.setup(escrowAddress, escrowConfig);
      * ```
      */
-    async setup(escrowAddress, escrowConfig) {
+    async setup(escrowAddress, escrowConfig, txOptions = {}) {
         const { recordingOracle, reputationOracle, exchangeOracle, recordingOracleFee, reputationOracleFee, exchangeOracleFee, manifestUrl, manifestHash, } = escrowConfig;
-        if (!ethers_1.ethers.utils.isAddress(recordingOracle)) {
+        if (!ethers_1.ethers.isAddress(recordingOracle)) {
             throw error_1.ErrorInvalidRecordingOracleAddressProvided;
         }
-        if (!ethers_1.ethers.utils.isAddress(reputationOracle)) {
+        if (!ethers_1.ethers.isAddress(reputationOracle)) {
             throw error_1.ErrorInvalidReputationOracleAddressProvided;
         }
-        if (!ethers_1.ethers.utils.isAddress(exchangeOracle)) {
+        if (!ethers_1.ethers.isAddress(exchangeOracle)) {
             throw error_1.ErrorInvalidExchangeOracleAddressProvided;
         }
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
-        if (recordingOracleFee.lte(0) ||
-            reputationOracleFee.lte(0) ||
-            exchangeOracleFee.lte(0)) {
+        if (recordingOracleFee <= 0 ||
+            reputationOracleFee <= 0 ||
+            exchangeOracleFee <= 0) {
             throw error_1.ErrorAmountMustBeGreaterThanZero;
         }
-        if (recordingOracleFee.add(reputationOracleFee).add(exchangeOracleFee).gt(100)) {
+        if (recordingOracleFee + reputationOracleFee + exchangeOracleFee > 100) {
             throw error_1.ErrorTotalFeeMustBeLessThanHundred;
         }
         if (!manifestUrl) {
@@ -271,9 +264,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await escrowContract.setup(reputationOracle, recordingOracle, exchangeOracle, reputationOracleFee, recordingOracleFee, exchangeOracleFee, manifestUrl, manifestHash, {
-                ...(await this.gasPriceOptions()),
-            });
+            await (await escrowContract.setup(reputationOracle, recordingOracle, exchangeOracle, reputationOracleFee, recordingOracleFee, exchangeOracleFee, manifestUrl, manifestHash, txOptions)).wait();
             return;
         }
         catch (e) {
@@ -311,9 +302,9 @@ class EscrowClient extends base_1.BaseEthersClient {
      *    recordingOracle: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
      *    reputationOracle: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
      *    exchangeOracle: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
-     *    recordingOracleFee: BigNumber.from('10'),
-     *    reputationOracleFee: BigNumber.from('10'),
-     *    exchangeOracleFee: BigNumber.from('10'),
+     *    recordingOracleFee: bigint.from('10'),
+     *    reputationOracleFee: bigint.from('10'),
+     *    exchangeOracleFee: bigint.from('10'),
      *    manifestUrl: 'htttp://localhost/manifest.json',
      *    manifestHash: 'b5dad76bf6772c0f07fd5e048f6e75a5f86ee079',
      * };
@@ -335,7 +326,8 @@ class EscrowClient extends base_1.BaseEthersClient {
      * This function adds funds of the chosen token to the escrow.
      *
      * @param {string} escrowAddress Address of the escrow to fund.
-     * @param {BigNumber} amount Amount to be added as funds.
+     * @param {bigint} amount Amount to be added as funds.
+     * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
      *
@@ -352,15 +344,15 @@ class EscrowClient extends base_1.BaseEthersClient {
      * const signer = new Wallet(privateKey, provider);
      * const escrowClient = await EscrowClient.build(signer);
      *
-     * const amount = ethers.utils.parseUnits(5, 'ether'); //convert from ETH to WEI
+     * const amount = ethers.parseUnits(5, 'ether'); //convert from ETH to WEI
      * await escrowClient.fund('0x62dD51230A30401C455c8398d06F85e4EaB6309f', amount);
      * ```
      */
-    async fund(escrowAddress, amount) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+    async fund(escrowAddress, amount, txOptions = {}) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
-        if (amount.lte(0)) {
+        if (amount <= 0n) {
             throw error_1.ErrorAmountMustBeGreaterThanZero;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -369,10 +361,8 @@ class EscrowClient extends base_1.BaseEthersClient {
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
             const tokenAddress = await escrowContract.token();
-            const tokenContract = typechain_types_1.HMToken__factory.connect(tokenAddress, this.signerOrProvider);
-            await tokenContract.transfer(escrowAddress, amount, {
-                ...(await this.gasPriceOptions()),
-            });
+            const tokenContract = typechain_types_1.HMToken__factory.connect(tokenAddress, this.runner);
+            await (await tokenContract.transfer(escrowAddress, amount, txOptions)).wait;
             return;
         }
         catch (e) {
@@ -385,6 +375,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * @param {string} escrowAddress Address of the escrow.
      * @param {string} url Results file url.
      * @param {string} hash Results file hash.
+     * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
      *
@@ -406,8 +397,8 @@ class EscrowClient extends base_1.BaseEthersClient {
      * await storeResults.storeResults('0x62dD51230A30401C455c8398d06F85e4EaB6309f', 'http://localhost/results.json', 'b5dad76bf6772c0f07fd5e048f6e75a5f86ee079');
      * ```
      */
-    async storeResults(escrowAddress, url, hash) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+    async storeResults(escrowAddress, url, hash, txOptions = {}) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!url) {
@@ -424,9 +415,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await escrowContract.storeResults(url, hash, {
-                ...(await this.gasPriceOptions()),
-            });
+            await (await escrowContract.storeResults(url, hash, txOptions)).wait();
             return;
         }
         catch (e) {
@@ -437,6 +426,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * This function sets the status of an escrow to completed.
      *
      * @param {string} escrowAddress Address of the escrow.
+     * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
      *
@@ -458,8 +448,8 @@ class EscrowClient extends base_1.BaseEthersClient {
      * await escrowClient.complete('0x62dD51230A30401C455c8398d06F85e4EaB6309f');
      * ```
      */
-    async complete(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+    async complete(escrowAddress, txOptions = {}) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -467,9 +457,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await escrowContract.complete({
-                ...(await this.gasPriceOptions()),
-            });
+            await (await escrowContract.complete(txOptions)).wait();
             return;
         }
         catch (e) {
@@ -481,9 +469,10 @@ class EscrowClient extends base_1.BaseEthersClient {
      *
      * @param {string} escrowAddress Escrow address to payout.
      * @param {string[]} recipients Array of recipient addresses.
-     * @param {BigNumber[]} amounts Array of amounts the recipients will receive.
+     * @param {bigint[]} amounts Array of amounts the recipients will receive.
      * @param {string} finalResultsUrl Final results file url.
      * @param {string} finalResultsHash Final results file hash.
+     * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
      *
@@ -503,15 +492,15 @@ class EscrowClient extends base_1.BaseEthersClient {
      * const escrowClient = await EscrowClient.build(signer);
      *
      * const recipients = ['0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266', '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'];
-     * const amounts = [ethers.utils.parseUnits(5, 'ether'), ethers.utils.parseUnits(10, 'ether')];
+     * const amounts = [ethers.parseUnits(5, 'ether'), ethers.parseUnits(10, 'ether')];
      * const resultsUrl = 'http://localhost/results.json';
      * const resultsHash'b5dad76bf6772c0f07fd5e048f6e75a5f86ee079';
      *
      * await escrowClient.bulkPayOut('0x62dD51230A30401C455c8398d06F85e4EaB6309f', recipients, amounts, resultsUrl, resultsHash);
      * ```
      */
-    async bulkPayOut(escrowAddress, recipients, amounts, finalResultsUrl, finalResultsHash) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+    async bulkPayOut(escrowAddress, recipients, amounts, finalResultsUrl, finalResultsHash, txOptions = {}) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (recipients.length === 0) {
@@ -524,7 +513,7 @@ class EscrowClient extends base_1.BaseEthersClient {
             throw error_1.ErrorRecipientAndAmountsMustBeSameLength;
         }
         recipients.forEach((recipient) => {
-            if (!ethers_1.ethers.utils.isAddress(recipient)) {
+            if (!ethers_1.ethers.isAddress(recipient)) {
                 throw new error_1.InvalidEthereumAddressError(recipient);
             }
         });
@@ -538,11 +527,11 @@ class EscrowClient extends base_1.BaseEthersClient {
             throw error_1.ErrorHashIsEmptyString;
         }
         const balance = await this.getBalance(escrowAddress);
-        let totalAmount = ethers_1.BigNumber.from(0);
+        let totalAmount = 0n;
         amounts.forEach((amount) => {
-            totalAmount = totalAmount.add(amount);
+            totalAmount = totalAmount + amount;
         });
-        if (balance.lt(totalAmount)) {
+        if (balance < totalAmount) {
             throw error_1.ErrorEscrowDoesNotHaveEnoughBalance;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -550,9 +539,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await escrowContract.bulkPayOut(recipients, amounts, finalResultsUrl, finalResultsHash, constants_1.DEFAULT_TX_ID, {
-                ...(await this.gasPriceOptions()),
-            });
+            await (await escrowContract.bulkPayOut(recipients, amounts, finalResultsUrl, finalResultsHash, constants_1.DEFAULT_TX_ID, txOptions)).wait();
             return;
         }
         catch (e) {
@@ -563,6 +550,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * This function cancels the specified escrow and sends the balance to the canceler.
      *
      * @param {string} escrowAddress Address of the escrow to cancel.
+     * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns {EscrowCancel} Returns the escrow cancellation data including transaction hash and refunded amount. Throws error if any.
      *
      *
@@ -584,8 +572,8 @@ class EscrowClient extends base_1.BaseEthersClient {
      * await escrowClient.cancel('0x62dD51230A30401C455c8398d06F85e4EaB6309f');
      * ```
      */
-    async cancel(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+    async cancel(escrowAddress, txOptions = {}) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -593,28 +581,29 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            const tx = await escrowContract.cancel({
-                ...(await this.gasPriceOptions()),
-            });
-            const transactionReceipt = await tx.wait();
+            const transactionReceipt = await (await escrowContract.cancel(txOptions)).wait();
             let amountTransferred = undefined;
             const tokenAddress = await escrowContract.token();
-            const tokenContract = typechain_types_1.HMToken__factory.connect(tokenAddress, this.signerOrProvider);
-            for (const log of transactionReceipt.logs) {
-                if (log.address === tokenAddress) {
-                    const parsedLog = tokenContract.interface.parseLog(log);
-                    const from = parsedLog.args[0];
-                    if (parsedLog.name === 'Transfer' && from === escrowAddress) {
-                        amountTransferred = parsedLog.args[2];
-                        break;
+            const tokenContract = typechain_types_1.HMToken__factory.connect(tokenAddress, this.runner);
+            if (transactionReceipt)
+                for (const log of transactionReceipt.logs) {
+                    if (log.address === tokenAddress) {
+                        const parsedLog = tokenContract.interface.parseLog({
+                            topics: log.topics,
+                            data: log.data,
+                        });
+                        const from = parsedLog?.args[0];
+                        if (parsedLog?.name === 'Transfer' && from === escrowAddress) {
+                            amountTransferred = parsedLog?.args[2];
+                            break;
+                        }
                     }
                 }
-            }
             if (amountTransferred === undefined) {
                 throw error_1.ErrorTransferEventNotFoundInTransactionLogs;
             }
             const escrowCancelData = {
-                txHash: transactionReceipt.transactionHash,
+                txHash: transactionReceipt?.hash || '',
                 amountRefunded: amountTransferred,
             };
             return escrowCancelData;
@@ -627,6 +616,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * This function cancels the specified escrow, sends the balance to the canceler and selfdestructs the escrow contract.
      *
      * @param {string} escrowAddress Address of the escrow.
+     * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
      *
@@ -648,8 +638,8 @@ class EscrowClient extends base_1.BaseEthersClient {
      * await escrowClient.abort('0x62dD51230A30401C455c8398d06F85e4EaB6309f');
      * ```
      */
-    async abort(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+    async abort(escrowAddress, txOptions = {}) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -657,9 +647,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await escrowContract.abort({
-                ...(await this.gasPriceOptions()),
-            });
+            await (await escrowContract.abort(txOptions)).wait();
             return;
         }
         catch (e) {
@@ -671,6 +659,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      *
      * @param {string} escrowAddress Address of the escrow.
      * @param {string[]} trustedHandlers Array of addresses of trusted handlers to add.
+     * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns Returns void if successful. Throws error if any.
      *
      *
@@ -693,15 +682,15 @@ class EscrowClient extends base_1.BaseEthersClient {
      * await escrowClient.addTrustedHandlers('0x62dD51230A30401C455c8398d06F85e4EaB6309f', trustedHandlers);
      * ```
      */
-    async addTrustedHandlers(escrowAddress, trustedHandlers) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+    async addTrustedHandlers(escrowAddress, trustedHandlers, txOptions = {}) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (trustedHandlers.length === 0) {
             throw error_1.ErrorListOfHandlersCannotBeEmpty;
         }
         trustedHandlers.forEach((trustedHandler) => {
-            if (!ethers_1.ethers.utils.isAddress(trustedHandler)) {
+            if (!ethers_1.ethers.isAddress(trustedHandler)) {
                 throw new error_1.InvalidEthereumAddressError(trustedHandler);
             }
         });
@@ -710,9 +699,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await escrowContract.addTrustedHandlers(trustedHandlers, {
-                ...(await this.gasPriceOptions()),
-            });
+            await (await escrowContract.addTrustedHandlers(trustedHandlers, txOptions)).wait();
             return;
         }
         catch (e) {
@@ -723,7 +710,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * This function returns the balance for a specified escrow address.
      *
      * @param {string} escrowAddress Address of the escrow.
-     * @returns {BigNumber} Balance of the escrow in the token used to fund it.
+     * @returns {bigint} Balance of the escrow in the token used to fund it.
      *
      * **Code example**
      *
@@ -740,7 +727,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * ```
      */
     async getBalance(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -775,7 +762,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * ```
      */
     async getManifestHash(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -810,7 +797,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * ```
      */
     async getManifestUrl(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -845,7 +832,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * ```
      */
     async getResultsUrl(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -880,7 +867,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * ```
      */
     async getIntermediateResultsUrl(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -915,7 +902,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * ```
      */
     async getTokenAddress(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -950,7 +937,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * ```
      */
     async getStatus(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -958,7 +945,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            return escrowContract.status();
+            return Number(await escrowContract.status());
         }
         catch (e) {
             return (0, utils_1.throwError)(e);
@@ -985,7 +972,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * ```
      */
     async getRecordingOracleAddress(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -1020,7 +1007,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * ```
      */
     async getJobLauncherAddress(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -1055,7 +1042,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * ```
      */
     async getReputationOracleAddress(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -1090,7 +1077,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * ```
      */
     async getExchangeOracleAddress(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -1125,7 +1112,7 @@ class EscrowClient extends base_1.BaseEthersClient {
      * ```
      */
     async getFactoryAddress(escrowAddress) {
-        if (!ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
@@ -1143,13 +1130,13 @@ class EscrowClient extends base_1.BaseEthersClient {
 __decorate([
     decorators_1.requiresSigner,
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, Array, String]),
+    __metadata("design:paramtypes", [String, Array, String, Object]),
     __metadata("design:returntype", Promise)
 ], EscrowClient.prototype, "createEscrow", null);
 __decorate([
     decorators_1.requiresSigner,
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:paramtypes", [String, Object, Object]),
     __metadata("design:returntype", Promise)
 ], EscrowClient.prototype, "setup", null);
 __decorate([
@@ -1161,43 +1148,43 @@ __decorate([
 __decorate([
     decorators_1.requiresSigner,
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, ethers_1.BigNumber]),
+    __metadata("design:paramtypes", [String, BigInt, Object]),
     __metadata("design:returntype", Promise)
 ], EscrowClient.prototype, "fund", null);
 __decorate([
     decorators_1.requiresSigner,
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:paramtypes", [String, String, String, Object]),
     __metadata("design:returntype", Promise)
 ], EscrowClient.prototype, "storeResults", null);
 __decorate([
     decorators_1.requiresSigner,
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String]),
+    __metadata("design:paramtypes", [String, Object]),
     __metadata("design:returntype", Promise)
 ], EscrowClient.prototype, "complete", null);
 __decorate([
     decorators_1.requiresSigner,
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, Array, Array, String, String]),
+    __metadata("design:paramtypes", [String, Array, Array, String, String, Object]),
     __metadata("design:returntype", Promise)
 ], EscrowClient.prototype, "bulkPayOut", null);
 __decorate([
     decorators_1.requiresSigner,
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String]),
+    __metadata("design:paramtypes", [String, Object]),
     __metadata("design:returntype", Promise)
 ], EscrowClient.prototype, "cancel", null);
 __decorate([
     decorators_1.requiresSigner,
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String]),
+    __metadata("design:paramtypes", [String, Object]),
     __metadata("design:returntype", Promise)
 ], EscrowClient.prototype, "abort", null);
 __decorate([
     decorators_1.requiresSigner,
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, Array]),
+    __metadata("design:paramtypes", [String, Array, Object]),
     __metadata("design:returntype", Promise)
 ], EscrowClient.prototype, "addTrustedHandlers", null);
 exports.EscrowClient = EscrowClient;
@@ -1334,19 +1321,16 @@ class EscrowUtils {
         if (!filter?.networks?.length) {
             throw error_1.ErrorUnsupportedChainID;
         }
-        if (filter.launcher && !ethers_1.ethers.utils.isAddress(filter.launcher)) {
+        if (filter.launcher && !ethers_1.ethers.isAddress(filter.launcher)) {
             throw error_1.ErrorInvalidAddress;
         }
-        if (filter.recordingOracle &&
-            !ethers_1.ethers.utils.isAddress(filter.recordingOracle)) {
+        if (filter.recordingOracle && !ethers_1.ethers.isAddress(filter.recordingOracle)) {
             throw error_1.ErrorInvalidAddress;
         }
-        if (filter.reputationOracle &&
-            !ethers_1.ethers.utils.isAddress(filter.reputationOracle)) {
+        if (filter.reputationOracle && !ethers_1.ethers.isAddress(filter.reputationOracle)) {
             throw error_1.ErrorInvalidAddress;
         }
-        if (filter.exchangeOracle &&
-            !ethers_1.ethers.utils.isAddress(filter.exchangeOracle)) {
+        if (filter.exchangeOracle && !ethers_1.ethers.isAddress(filter.exchangeOracle)) {
             throw error_1.ErrorInvalidAddress;
         }
         try {
@@ -1451,7 +1435,7 @@ class EscrowUtils {
         if (!networkData) {
             throw error_1.ErrorUnsupportedChainID;
         }
-        if (escrowAddress && !ethers_1.ethers.utils.isAddress(escrowAddress)) {
+        if (escrowAddress && !ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidAddress;
         }
         try {