@human-protocol/sdk 5.0.0-beta.3 → 5.1.0

package/dist/escrow.js

@@ -8,15 +8,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": 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"));
 const base_1 = require("./base");
 const constants_1 = require("./constants");
 const decorators_1 = require("./decorators");
@@ -142,8 +138,8 @@ class EscrowClient extends base_1.BaseEthersClient {
     /**
      * This function creates an escrow contract that uses the token passed to pay oracle fees and reward workers.
      *
-     * @param {string} tokenAddress Token address to use for payouts.
-     * @param {string} jobRequesterId Job Requester Id
+     * @param {string} tokenAddress - The address of the token to use for escrow funding.
+     * @param {string} jobRequesterId - Identifier for the job requester.
      * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
      * @returns {Promise<string>} Returns the address of the escrow created.
      *
@@ -173,7 +169,109 @@ class EscrowClient extends base_1.BaseEthersClient {
             throw error_1.ErrorInvalidTokenAddress;
         }
         try {
-            const result = await (await this.escrowFactoryContract.createEscrow(tokenAddress, jobRequesterId, this.applyTxDefaults(txOptions))).wait();
+            const result = await (await this.escrowFactoryContract.createEscrow(tokenAddress, 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;
+            }
+            return event.escrow;
+        }
+        catch (e) {
+            return (0, utils_1.throwError)(e);
+        }
+    }
+    verifySetupParameters(escrowConfig) {
+        const { recordingOracle, reputationOracle, exchangeOracle, recordingOracleFee, reputationOracleFee, exchangeOracleFee, manifest, manifestHash, } = escrowConfig;
+        if (!ethers_1.ethers.isAddress(recordingOracle)) {
+            throw error_1.ErrorInvalidRecordingOracleAddressProvided;
+        }
+        if (!ethers_1.ethers.isAddress(reputationOracle)) {
+            throw error_1.ErrorInvalidReputationOracleAddressProvided;
+        }
+        if (!ethers_1.ethers.isAddress(exchangeOracle)) {
+            throw error_1.ErrorInvalidExchangeOracleAddressProvided;
+        }
+        if (recordingOracleFee <= 0 ||
+            reputationOracleFee <= 0 ||
+            exchangeOracleFee <= 0) {
+            throw error_1.ErrorAmountMustBeGreaterThanZero;
+        }
+        if (recordingOracleFee + reputationOracleFee + exchangeOracleFee > 100) {
+            throw error_1.ErrorTotalFeeMustBeLessThanHundred;
+        }
+        const isManifestValid = (0, utils_1.isValidUrl)(manifest) || (0, utils_1.isValidJson)(manifest);
+        if (!isManifestValid) {
+            throw error_1.ErrorInvalidManifest;
+        }
+        if (!manifestHash) {
+            throw error_1.ErrorHashIsEmptyString;
+        }
+    }
+    /**
+     * Creates, funds, and sets up a new escrow contract in a single transaction.
+     *
+     * @param {string} tokenAddress - The ERC-20 token address used to fund the escrow.
+     * @param {bigint} amount - The token amount to fund the escrow with.
+     * @param {string} jobRequesterId - An off-chain identifier for the job requester.
+     * @param {IEscrowConfig} escrowConfig - Configuration parameters for escrow setup:
+     *   - `recordingOracle`: Address of the recording oracle.
+     *   - `reputationOracle`: Address of the reputation oracle.
+     *   - `exchangeOracle`: Address of the exchange oracle.
+     *   - `recordingOracleFee`: Fee (in basis points or percentage * 100) for the recording oracle.
+     *   - `reputationOracleFee`: Fee for the reputation oracle.
+     *   - `exchangeOracleFee`: Fee for the exchange oracle.
+     *   - `manifest`: URL to the manifest file.
+     *   - `manifestHash`: Hash of the manifest content.
+     * @param {Overrides} [txOptions] - Additional transaction parameters (optional, defaults to an empty object).
+     *
+     * @returns {Promise<string>} Returns the address of the escrow created.
+     *
+     * @example
+     * import { Wallet, ethers } from 'ethers';
+     * import { EscrowClient, IERC20__factory } from '@human-protocol/sdk';
+     *
+     * const rpcUrl = 'YOUR_RPC_URL';
+     * const privateKey = 'YOUR_PRIVATE_KEY';
+     * const provider = new ethers.JsonRpcProvider(rpcUrl);
+     * const signer = new Wallet(privateKey, provider);
+     *
+     * const escrowClient = await EscrowClient.build(signer);
+     *
+     * const tokenAddress = '0xTokenAddress';
+     * const amount = ethers.parseUnits('1000', 18);
+     * const jobRequesterId = 'requester-123';
+     *
+     * const token = IERC20__factory.connect(tokenAddress, signer);
+     * await token.approve(escrowClient.escrowFactoryContract.target, amount);
+     *
+     * const escrowConfig = {
+     *   recordingOracle: '0xRecordingOracle',
+     *   reputationOracle: '0xReputationOracle',
+     *   exchangeOracle: '0xExchangeOracle',
+     *   recordingOracleFee: 5n,
+     *   reputationOracleFee: 5n,
+     *   exchangeOracleFee: 5n,
+     *   manifest: 'https://example.com/manifest.json',
+     *   manifestHash: 'manifestHash-123',
+     * } satisfies IEscrowConfig;
+     *
+     * const escrowAddress = await escrowClient.createFundAndSetupEscrow(
+     *   tokenAddress,
+     *   amount,
+     *   jobRequesterId,
+     *   escrowConfig
+     * );
+     *
+     * console.log('Escrow created at:', escrowAddress);
+     */
+    async createFundAndSetupEscrow(tokenAddress, amount, jobRequesterId, escrowConfig, txOptions = {}) {
+        if (!ethers_1.ethers.isAddress(tokenAddress)) {
+            throw error_1.ErrorInvalidTokenAddress;
+        }
+        this.verifySetupParameters(escrowConfig);
+        const { recordingOracle, reputationOracle, exchangeOracle, recordingOracleFee, reputationOracleFee, exchangeOracleFee, manifest, manifestHash, } = escrowConfig;
+        try {
+            const result = await (await this.escrowFactoryContract.createFundAndSetupEscrow(tokenAddress, amount, jobRequesterId, reputationOracle, recordingOracle, exchangeOracle, reputationOracleFee, recordingOracleFee, exchangeOracleFee, manifest, manifestHash, 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;
@@ -224,39 +322,16 @@ class EscrowClient extends base_1.BaseEthersClient {
      */
     async setup(escrowAddress, escrowConfig, txOptions = {}) {
         const { recordingOracle, reputationOracle, exchangeOracle, recordingOracleFee, reputationOracleFee, exchangeOracleFee, manifest, manifestHash, } = escrowConfig;
-        if (!ethers_1.ethers.isAddress(recordingOracle)) {
-            throw error_1.ErrorInvalidRecordingOracleAddressProvided;
-        }
-        if (!ethers_1.ethers.isAddress(reputationOracle)) {
-            throw error_1.ErrorInvalidReputationOracleAddressProvided;
-        }
-        if (!ethers_1.ethers.isAddress(exchangeOracle)) {
-            throw error_1.ErrorInvalidExchangeOracleAddressProvided;
-        }
+        this.verifySetupParameters(escrowConfig);
         if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
-        if (recordingOracleFee <= 0 ||
-            reputationOracleFee <= 0 ||
-            exchangeOracleFee <= 0) {
-            throw error_1.ErrorAmountMustBeGreaterThanZero;
-        }
-        if (recordingOracleFee + reputationOracleFee + exchangeOracleFee > 100) {
-            throw error_1.ErrorTotalFeeMustBeLessThanHundred;
-        }
-        const isManifestValid = (0, utils_1.isValidUrl)(manifest) || (0, utils_1.isValidJson)(manifest);
-        if (!isManifestValid) {
-            throw error_1.ErrorInvalidManifest;
-        }
-        if (!manifestHash) {
-            throw error_1.ErrorHashIsEmptyString;
-        }
         if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
             throw error_1.ErrorEscrowAddressIsNotProvidedByFactory;
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await (await escrowContract.setup(reputationOracle, recordingOracle, exchangeOracle, reputationOracleFee, recordingOracleFee, exchangeOracleFee, manifest, manifestHash, this.applyTxDefaults(txOptions))).wait();
+            await (await escrowContract.setup(reputationOracle, recordingOracle, exchangeOracle, reputationOracleFee, recordingOracleFee, exchangeOracleFee, manifest, manifestHash, txOptions)).wait();
             return;
         }
         catch (e) {
@@ -303,7 +378,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, this.applyTxDefaults(txOptions))).wait();
+            await (await tokenContract.transfer(escrowAddress, amount, txOptions)).wait();
             return;
         }
         catch (e) {
@@ -332,10 +407,10 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             if (fundsToReserve !== null) {
-                await (await escrowContract['storeResults(string,string,uint256)'](url, hash, fundsToReserve, this.applyTxDefaults(txOptions))).wait();
+                await (await escrowContract['storeResults(string,string,uint256)'](url, hash, fundsToReserve, txOptions)).wait();
             }
             else {
-                await (await escrowContract['storeResults(string,string)'](url, hash, this.applyTxDefaults(txOptions))).wait();
+                await (await escrowContract['storeResults(string,string)'](url, hash, txOptions)).wait();
             }
         }
         catch (e) {
@@ -382,7 +457,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await (await escrowContract.complete(this.applyTxDefaults(txOptions))).wait();
+            await (await escrowContract.complete(txOptions)).wait();
             return;
         }
         catch (e) {
@@ -395,10 +470,10 @@ class EscrowClient extends base_1.BaseEthersClient {
         const idIsString = typeof id === 'string';
         try {
             if (idIsString) {
-                await (await escrowContract['bulkPayOut(address[],uint256[],string,string,string,bool)'](recipients, amounts, finalResultsUrl, finalResultsHash, id, forceComplete, this.applyTxDefaults(txOptions))).wait();
+                await (await escrowContract['bulkPayOut(address[],uint256[],string,string,string,bool)'](recipients, amounts, finalResultsUrl, finalResultsHash, id, forceComplete, txOptions)).wait();
             }
             else {
-                await (await escrowContract['bulkPayOut(address[],uint256[],string,string,uint256,bool)'](recipients, amounts, finalResultsUrl, finalResultsHash, id, forceComplete, this.applyTxDefaults(txOptions))).wait();
+                await (await escrowContract['bulkPayOut(address[],uint256[],string,string,uint256,bool)'](recipients, amounts, finalResultsUrl, finalResultsHash, id, forceComplete, txOptions)).wait();
             }
         }
         catch (e) {
@@ -444,7 +519,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await (await escrowContract.cancel(this.applyTxDefaults(txOptions))).wait();
+            await (await escrowContract.cancel(txOptions)).wait();
         }
         catch (e) {
             return (0, utils_1.throwError)(e);
@@ -484,7 +559,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            await (await escrowContract.requestCancellation(this.applyTxDefaults(txOptions))).wait();
+            await (await escrowContract.requestCancellation(txOptions)).wait();
         }
         catch (e) {
             return (0, utils_1.throwError)(e);
@@ -532,7 +607,7 @@ class EscrowClient extends base_1.BaseEthersClient {
         }
         try {
             const escrowContract = this.getEscrowContract(escrowAddress);
-            const transactionReceipt = await (await escrowContract.withdraw(tokenAddress, this.applyTxDefaults(txOptions))).wait();
+            const transactionReceipt = await (await escrowContract.withdraw(tokenAddress, txOptions)).wait();
             let amountTransferred = undefined;
             const tokenContract = typechain_types_1.ERC20__factory.connect(tokenAddress, this.runner);
             if (transactionReceipt)
@@ -603,7 +678,6 @@ class EscrowClient extends base_1.BaseEthersClient {
      * (await signer.sendTransaction(rawTransaction)).wait();
      */
     async createBulkPayoutTransaction(escrowAddress, recipients, amounts, finalResultsUrl, finalResultsHash, payoutId, forceComplete = false, txOptions = {}) {
-        txOptions = this.applyTxDefaults(txOptions);
         await this.ensureCorrectBulkPayoutInput(escrowAddress, recipients, amounts, finalResultsUrl, finalResultsHash);
         const signer = this.runner;
         try {
@@ -1184,6 +1258,12 @@ __decorate([
     __metadata("design:paramtypes", [String, String, Object]),
     __metadata("design:returntype", Promise)
 ], EscrowClient.prototype, "createEscrow", null);
+__decorate([
+    decorators_1.requiresSigner,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, BigInt, String, Object, Object]),
+    __metadata("design:returntype", Promise)
+], EscrowClient.prototype, "createFundAndSetupEscrow", null);
 __decorate([
     decorators_1.requiresSigner,
     __metadata("design:type", Function),
@@ -1356,6 +1436,7 @@ class EscrowUtils {
      *
      *
      * @param {IEscrowsFilter} filter Filter parameters.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {IEscrow[]} List of escrows that match the filter.
      *
      * **Code example**
@@ -1372,7 +1453,7 @@ class EscrowUtils {
      * const escrows = await EscrowUtils.getEscrows(filters);
      * ```
      */
-    static async getEscrows(filter) {
+    static async getEscrows(filter, options) {
         if (filter.launcher && !ethers_1.ethers.isAddress(filter.launcher)) {
             throw error_1.ErrorInvalidAddress;
         }
@@ -1397,7 +1478,7 @@ class EscrowUtils {
             statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
             statuses = statuses.map((status) => types_1.EscrowStatus[status]);
         }
-        const { escrows } = await (0, graphql_request_1.default)((0, utils_1.getSubgraphUrl)(networkData), (0, graphql_1.GET_ESCROWS_QUERY)(filter), {
+        const { escrows } = await (0, utils_1.customGqlFetch)((0, utils_1.getSubgraphUrl)(networkData), (0, graphql_1.GET_ESCROWS_QUERY)(filter), {
             ...filter,
             launcher: filter.launcher?.toLowerCase(),
             reputationOracle: filter.reputationOracle?.toLowerCase(),
@@ -1409,7 +1490,7 @@ class EscrowUtils {
             orderDirection: orderDirection,
             first: first,
             skip: skip,
-        });
+        }, options);
         return (escrows || []).map((e) => mapEscrow(e, networkData.chainId));
     }
     /**
@@ -1465,6 +1546,7 @@ class EscrowUtils {
      *
      * @param {ChainId} chainId Network in which the escrow has been deployed
      * @param {string} escrowAddress Address of the escrow
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IEscrow | null>} - Escrow data or null if not found.
      *
      * **Code example**
@@ -1475,7 +1557,7 @@ class EscrowUtils {
      * const escrow = new EscrowUtils.getEscrow(ChainId.POLYGON_AMOY, "0x1234567890123456789012345678901234567890");
      * ```
      */
-    static async getEscrow(chainId, escrowAddress) {
+    static async getEscrow(chainId, escrowAddress, options) {
         const networkData = constants_1.NETWORKS[chainId];
         if (!networkData) {
             throw error_1.ErrorUnsupportedChainID;
@@ -1483,7 +1565,7 @@ class EscrowUtils {
         if (escrowAddress && !ethers_1.ethers.isAddress(escrowAddress)) {
             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() });
+        const { escrow } = await (0, utils_1.customGqlFetch)((0, utils_1.getSubgraphUrl)(networkData), (0, graphql_1.GET_ESCROW_BY_ADDRESS_QUERY)(), { escrowAddress: escrowAddress.toLowerCase() }, options);
         if (!escrow)
             return null;
         return mapEscrow(escrow, networkData.chainId);
@@ -1524,6 +1606,7 @@ class EscrowUtils {
      * ```
      *
      * @param {IStatusEventFilter} filter Filter parameters.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<StatusEvent[]>} - Array of status events with their corresponding statuses.
      *
      * **Code example**
@@ -1544,7 +1627,7 @@ class EscrowUtils {
      * })();
      * ```
      */
-    static async getStatusEvents(filter) {
+    static async getStatusEvents(filter, options) {
         const { chainId, statuses, from, to, launcher, first = 10, skip = 0, orderDirection = enums_1.OrderDirection.DESC, } = filter;
         if (launcher && !ethers_1.ethers.isAddress(launcher)) {
             throw error_1.ErrorInvalidAddress;
@@ -1563,7 +1646,7 @@ class EscrowUtils {
             types_1.EscrowStatus.Cancelled,
         ];
         const statusNames = effectiveStatuses.map((status) => types_1.EscrowStatus[status]);
-        const data = await (0, graphql_request_1.default)((0, utils_1.getSubgraphUrl)(networkData), (0, graphql_1.GET_STATUS_UPDATES_QUERY)(from, to, launcher), {
+        const data = await (0, utils_1.customGqlFetch)((0, utils_1.getSubgraphUrl)(networkData), (0, graphql_1.GET_STATUS_UPDATES_QUERY)(from, to, launcher), {
             status: statusNames,
             from: from ? (0, utils_1.getUnixTimestamp)(from) : undefined,
             to: to ? (0, utils_1.getUnixTimestamp)(to) : undefined,
@@ -1571,7 +1654,7 @@ class EscrowUtils {
             orderDirection,
             first: Math.min(first, 1000),
             skip,
-        });
+        }, options);
         if (!data || !data['escrowStatusEvents']) {
             return [];
         }
@@ -1591,6 +1674,7 @@ class EscrowUtils {
      * Fetch payouts from the subgraph.
      *
      * @param {IPayoutFilter} filter Filter parameters.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IPayout[]>} List of payouts matching the filters.
      *
      * **Code example**
@@ -1608,7 +1692,7 @@ class EscrowUtils {
      * console.log(payouts);
      * ```
      */
-    static async getPayouts(filter) {
+    static async getPayouts(filter, options) {
         const networkData = constants_1.NETWORKS[filter.chainId];
         if (!networkData) {
             throw error_1.ErrorUnsupportedChainID;
@@ -1622,7 +1706,7 @@ class EscrowUtils {
         const first = filter.first !== undefined ? Math.min(filter.first, 1000) : 10;
         const skip = filter.skip || 0;
         const orderDirection = filter.orderDirection || enums_1.OrderDirection.DESC;
-        const { payouts } = await (0, graphql_request_1.default)((0, utils_1.getSubgraphUrl)(networkData), (0, graphql_1.GET_PAYOUTS_QUERY)(filter), {
+        const { payouts } = await (0, utils_1.customGqlFetch)((0, utils_1.getSubgraphUrl)(networkData), (0, graphql_1.GET_PAYOUTS_QUERY)(filter), {
             escrowAddress: filter.escrowAddress?.toLowerCase(),
             recipient: filter.recipient?.toLowerCase(),
             from: filter.from ? (0, utils_1.getUnixTimestamp)(filter.from) : undefined,
@@ -1630,7 +1714,7 @@ class EscrowUtils {
             first: Math.min(first, 1000),
             skip,
             orderDirection,
-        });
+        }, options);
         if (!payouts) {
             return [];
         }
@@ -1676,6 +1760,7 @@ class EscrowUtils {
      *
      *
      * @param {Object} filter Filter parameters.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<ICancellationRefund[]>} List of cancellation refunds matching the filters.
      *
      * **Code example**
@@ -1690,7 +1775,7 @@ class EscrowUtils {
      * console.log(cancellationRefunds);
      * ```
      */
-    static async getCancellationRefunds(filter) {
+    static async getCancellationRefunds(filter, options) {
         const networkData = constants_1.NETWORKS[filter.chainId];
         if (!networkData)
             throw error_1.ErrorUnsupportedChainID;
@@ -1703,7 +1788,7 @@ class EscrowUtils {
         const first = filter.first !== undefined ? Math.min(filter.first, 1000) : 10;
         const skip = filter.skip || 0;
         const orderDirection = filter.orderDirection || enums_1.OrderDirection.DESC;
-        const { cancellationRefundEvents } = await (0, graphql_request_1.default)((0, utils_1.getSubgraphUrl)(networkData), (0, graphql_1.GET_CANCELLATION_REFUNDS_QUERY)(filter), {
+        const { cancellationRefundEvents } = await (0, utils_1.customGqlFetch)((0, utils_1.getSubgraphUrl)(networkData), (0, graphql_1.GET_CANCELLATION_REFUNDS_QUERY)(filter), {
             escrowAddress: filter.escrowAddress?.toLowerCase(),
             receiver: filter.receiver?.toLowerCase(),
             from: filter.from ? (0, utils_1.getUnixTimestamp)(filter.from) : undefined,
@@ -1711,7 +1796,7 @@ class EscrowUtils {
             first,
             skip,
             orderDirection,
-        });
+        }, options);
         if (!cancellationRefundEvents || cancellationRefundEvents.length === 0) {
             return [];
         }
@@ -1760,6 +1845,7 @@ class EscrowUtils {
      *
      * @param {ChainId} chainId Network in which the escrow has been deployed
      * @param {string} escrowAddress Address of the escrow
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<ICancellationRefund>} Cancellation refund data
      *
      * **Code example**
@@ -1770,14 +1856,14 @@ class EscrowUtils {
      * const cancellationRefund = await EscrowUtils.getCancellationRefund(ChainId.POLYGON_AMOY, "0x1234567890123456789012345678901234567890");
      * ```
      */
-    static async getCancellationRefund(chainId, escrowAddress) {
+    static async getCancellationRefund(chainId, escrowAddress, options) {
         const networkData = constants_1.NETWORKS[chainId];
         if (!networkData)
             throw error_1.ErrorUnsupportedChainID;
         if (!ethers_1.ethers.isAddress(escrowAddress)) {
             throw error_1.ErrorInvalidEscrowAddressProvided;
         }
-        const { cancellationRefundEvents } = await (0, graphql_request_1.default)((0, utils_1.getSubgraphUrl)(networkData), (0, graphql_1.GET_CANCELLATION_REFUND_BY_ADDRESS_QUERY)(), { escrowAddress: escrowAddress.toLowerCase() });
+        const { cancellationRefundEvents } = await (0, utils_1.customGqlFetch)((0, utils_1.getSubgraphUrl)(networkData), (0, graphql_1.GET_CANCELLATION_REFUND_BY_ADDRESS_QUERY)(), { escrowAddress: escrowAddress.toLowerCase() }, options);
         if (!cancellationRefundEvents || cancellationRefundEvents.length === 0) {
             return null;
         }

package/dist/interfaces.d.ts

@@ -272,4 +272,13 @@ export interface IEscrowWithdraw {
     tokenAddress: string;
     withdrawnAmount: bigint;
 }
+/**
+ * Configuration options for subgraph requests with retry logic.
+ */
+export interface SubgraphOptions {
+    /** Maximum number of retry attempts */
+    maxRetries?: number;
+    /** Base delay between retries in milliseconds */
+    baseDelay?: number;
+}
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

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

package/dist/kvstore.d.ts

@@ -2,7 +2,7 @@ import { ContractRunner, Overrides } from 'ethers';
 import { BaseEthersClient } from './base';
 import { ChainId } from './enums';
 import { NetworkData } from './types';
-import { IKVStore } from './interfaces';
+import { IKVStore, SubgraphOptions } from './interfaces';
 /**
  * ## Introduction
  *
@@ -181,6 +181,7 @@ export declare class KVStoreClient extends BaseEthersClient {
      *
      * @param {string} address Address from which to get the key value.
      * @param {string} key Key to obtain the value.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {string} Value of the key.
      *
      *
@@ -240,6 +241,7 @@ export declare class KVStoreUtils {
      *
      * @param {ChainId} chainId Network in which the KVStore is deployed
      * @param {string} address Address of the KVStore
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<IKVStore[]>} KVStore data
      * @throws {ErrorUnsupportedChainID} - Thrown if the network's chainId is not supported
      * @throws {ErrorInvalidAddress} - Thrown if the Address sent is invalid
@@ -253,13 +255,14 @@ export declare class KVStoreUtils {
      * console.log(kvStoreData);
      * ```
      */
-    static getKVStoreData(chainId: ChainId, address: string): Promise<IKVStore[]>;
+    static getKVStoreData(chainId: ChainId, address: string, options?: SubgraphOptions): Promise<IKVStore[]>;
     /**
      * Gets the value of a key-value pair in the KVStore using the subgraph.
      *
      * @param {ChainId} chainId Network in which the KVStore is deployed
      * @param {string} address Address from which to get the key value.
      * @param {string} key Key to obtain the value.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<string>} Value of the key.
      * @throws {ErrorUnsupportedChainID} - Thrown if the network's chainId is not supported
      * @throws {ErrorInvalidAddress} - Thrown if the Address sent is invalid
@@ -278,13 +281,14 @@ export declare class KVStoreUtils {
      * console.log(value);
      * ```
      */
-    static get(chainId: ChainId, address: string, key: string): Promise<string>;
+    static get(chainId: ChainId, address: string, key: string, options?: SubgraphOptions): Promise<string>;
     /**
      * Gets the URL value of the given entity, and verifies its hash.
      *
      * @param {ChainId} chainId Network in which the KVStore is deployed
      * @param {string} address Address from which to get the URL value.
      * @param {string} urlKey Configurable URL key. `url` by default.
+     * @param {SubgraphOptions} options Optional configuration for subgraph requests.
      * @returns {Promise<string>} URL value for the given address if it exists, and the content is valid
      *
      * **Code example**
@@ -299,7 +303,7 @@ export declare class KVStoreUtils {
      * console.log(url);
      * ```
      */
-    static getFileUrlAndVerifyHash(chainId: ChainId, address: string, urlKey?: string): Promise<string>;
+    static getFileUrlAndVerifyHash(chainId: ChainId, address: string, urlKey?: string, options?: SubgraphOptions): Promise<string>;
     /**
      * Gets the public key of the given entity, and verifies its hash.
      *
@@ -319,6 +323,6 @@ export declare class KVStoreUtils {
      * console.log(publicKey);
      * ```
      */
-    static getPublicKey(chainId: ChainId, address: string): Promise<string>;
+    static getPublicKey(chainId: ChainId, address: string, options?: SubgraphOptions): Promise<string>;
 }
 //# sourceMappingURL=kvstore.d.ts.map

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;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"}
+{"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;AAWlC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAOtC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;IAuBhB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAYhE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,YAAY;IACvB;;;;;;;;;;;;;;;;;;OAkBG;WACiB,cAAc,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,QAAQ,EAAE,CAAC;IA0BtB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;WACiB,GAAG,CACrB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC;IAwBlB;;;;;;;;;;;;;;;;;;;;OAoBG;WACiB,uBAAuB,CACzC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,SAAQ,EACd,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC;IAqClB;;;;;;;;;;;;;;;;;;OAkBG;WACiB,YAAY,CAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC;CAgBnB"}