@obolnetwork/obol-sdk 2.4.5 → 2.5.0

package/README.md

@@ -19,7 +19,7 @@ If you're integrating this SDK with a **backend** (e.g., in Node.js), and you st
 
 ## ⚡️ Integration with Safe Wallet
 
-When integrating the Obol SDK with a **Safe Wallet**, you will need to provide the `RPC_MAINNET` or `RPC_HOLESKY` or `RPC_GNOSIS` or `RPC_SEPOLIA` environment variable, pointing to the correct network's RPC URL. This is required to interact with Safe kit.
+When integrating the Obol SDK with a **Safe Wallet**, you can either pass an RPC URL OR provide the `RPC_MAINNET` or `RPC_HOLESKY` or `RPC_GNOSIS` or `RPC_SEPOLIA` environment variable, pointing to the correct network's RPC URL. This is required to interact with Safe kit.
 
 
 ## Contributing

package/dist/cjs/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@obolnetwork/obol-sdk",
-    "version": "2.4.5",
+    "version": "2.5.0",
     "description": "A package for creating Distributed Validators using the Obol API.",
     "bugs": {
         "url": "https://github.com/obolnetwork/obol-sdk/issues"
@@ -49,6 +49,8 @@
         "@safe-global/safe-core-sdk-types": "5.1.0",
         "@types/pdf-parse": "^1.1.4",
         "ajv": "^8.12.0",
+        "ajv-formats": "^3.0.1",
+        "ajv-keywords": "^5.1.0",
         "cross-fetch": "^3.1.5",
         "dotenv": "^16.4.7",
         "elliptic": "^6.5.4",
@@ -56,7 +58,7 @@
         "eslint-plugin-import": "^2.29.1",
         "eslint-plugin-n": "^16.6.2",
         "eslint-plugin-promise": "^6.1.1",
-        "ethers": "6.4.0",
+        "ethers": "^6.13.5",
         "nock": "^13.5.3",
         "pdf-parse": "^1.1.1",
         "semver": "^7.6.0",

package/dist/cjs/src/ajv.js

@@ -3,58 +3,84 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validatePayload = void 0;
-const ajv_1 = __importDefault(require("ajv"));
+exports.validatePayload = exports.VALID_NON_COMPOUNDING_AMOUNTS = exports.VALID_DEPOSIT_AMOUNTS = void 0;
+const ajv_formats_1 = __importDefault(require("ajv-formats"));
+const ajv_keywords_1 = __importDefault(require("ajv-keywords"));
 const ethers_1 = require("ethers");
+const ajv_1 = __importDefault(require("ajv"));
 const constants_1 = require("./constants");
-const validDepositAmounts = (data, deposits) => {
-    let sum = 0;
-    // from ether togwei is same as from gwei to wei
-    const maxDeposit = Number((0, ethers_1.parseUnits)('32', 'gwei'));
-    const minDeposit = Number((0, ethers_1.parseUnits)('1', 'gwei'));
-    for (const element of deposits) {
-        const amountInGWei = Number(element);
-        if (!Number.isInteger(amountInGWei) ||
-            amountInGWei > maxDeposit ||
-            amountInGWei < minDeposit) {
-            return false;
-        }
-        sum += amountInGWei;
+exports.VALID_DEPOSIT_AMOUNTS = [
+    (0, ethers_1.parseUnits)('1', 'gwei').toString(),
+    (0, ethers_1.parseUnits)('32', 'gwei').toString(),
+    (0, ethers_1.parseUnits)('8', 'gwei').toString(),
+    (0, ethers_1.parseUnits)('256', 'gwei').toString(),
+];
+exports.VALID_NON_COMPOUNDING_AMOUNTS = [
+    (0, ethers_1.parseUnits)('1', 'gwei').toString(),
+    (0, ethers_1.parseUnits)('32', 'gwei').toString(),
+];
+// They dont see defaults set in schema
+const validateRewardsSplitRecipients = (_, data) => {
+    var _a;
+    const obolRAFSplit = (_a = data.ObolRAFSplit) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_RETROACTIVE_FUNDING_REWARDS_ONLY_SPLIT;
+    const splitPercentage = data.splitRecipients.reduce((acc, curr) => acc + curr.percentAllocation, 0);
+    return splitPercentage + obolRAFSplit === 100;
+};
+const validateTotalSplitRecipients = (_, data) => {
+    var _a;
+    const obolRAFSplit = (_a = data.ObolRAFSplit) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_RETROACTIVE_FUNDING_TOTAL_SPLIT;
+    const splitPercentage = data.splitRecipients.reduce((acc, curr) => acc + curr.percentAllocation, 0);
+    return splitPercentage + obolRAFSplit === 100;
+};
+const validateUniqueAddresses = (_, operators) => {
+    if (!operators) {
+        return false;
     }
-    if (sum / minDeposit !== 32) {
+    if (operators.length < 4) {
         return false;
     }
-    else {
+    if (operators.every(op => op.address === '')) {
         return true;
     }
+    if (operators.some(op => op.address.length !== 42)) {
+        return false;
+    }
+    const addresses = operators.map(op => op.address);
+    const uniqueAddresses = new Set(addresses);
+    const isUnique = uniqueAddresses.size === addresses.length;
+    return isUnique;
 };
-const validateSplitRecipients = (_, data) => {
-    const splitPercentage = data.splitRecipients.reduce((acc, curr) => acc + curr.percentAllocation, 0);
-    const ObolRAFSplitParam = data.ObolRAFSplit
-        ? data.ObolRAFSplit
-        : 'principalRecipient' in data
-            ? constants_1.DEFAULT_RETROACTIVE_FUNDING_REWARDS_ONLY_SPLIT
-            : constants_1.DEFAULT_RETROACTIVE_FUNDING_TOTAL_SPLIT;
-    return splitPercentage + ObolRAFSplitParam === 100;
-};
+const ajv = new ajv_1.default({
+    allErrors: true,
+    useDefaults: true,
+    strict: false,
+    $data: true,
+});
+(0, ajv_formats_1.default)(ajv);
+(0, ajv_keywords_1.default)(ajv, ['patternRequired']);
+ajv.addKeyword({
+    keyword: 'validateRewardsSplitRecipients',
+    validate: validateRewardsSplitRecipients,
+    schemaType: 'boolean',
+});
+ajv.addKeyword({
+    keyword: 'validateTotalSplitRecipients',
+    validate: validateTotalSplitRecipients,
+    schemaType: 'boolean',
+});
+ajv.addKeyword({
+    keyword: 'validateUniqueAddresses',
+    validate: validateUniqueAddresses,
+    schemaType: 'boolean',
+});
 function validatePayload(data, schema) {
     var _a;
-    const ajv = new ajv_1.default();
-    ajv.addKeyword({
-        keyword: 'validDepositAmounts',
-        validate: validDepositAmounts,
-        errors: true,
-    });
-    ajv.addKeyword({
-        keyword: 'validateSplitRecipients',
-        validate: validateSplitRecipients,
-        errors: true,
-    });
     const validate = ajv.compile(schema);
-    const isValid = validate(data);
-    if (!isValid) {
-        throw new Error(`Schema compilation errors', ${(_a = validate.errors) === null || _a === void 0 ? void 0 : _a[0].message}`);
+    const valid = validate(data);
+    if (!valid) {
+        const errors = (_a = validate.errors) === null || _a === void 0 ? void 0 : _a.map(e => `${e.instancePath} ${e.message}`).join(', ');
+        throw new Error(`Validation failed: ${errors}`);
     }
-    return isValid;
+    return data;
 }
 exports.validatePayload = validatePayload;

package/dist/cjs/src/constants.js

@@ -110,7 +110,7 @@ const signEnrPayload = (payload, chainId) => {
 };
 exports.signEnrPayload = signEnrPayload;
 exports.DKG_ALGORITHM = 'default';
-exports.CONFIG_VERSION = 'v1.8.0';
+exports.CONFIG_VERSION = 'v1.10.0';
 exports.SDK_VERSION = package_json_1.default.version;
 exports.DOMAIN_APPLICATION_BUILDER = '00000001';
 exports.DOMAIN_DEPOSIT = '03000000';

package/dist/cjs/src/incentiveHelpers.js

@@ -12,7 +12,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isClaimedFromMerkleDistributor = exports.claimIncentivesFromMerkleDistributor = void 0;
 const ethers_1 = require("ethers");
 const MerkleDistributorWithDeadline_1 = require("./abi/MerkleDistributorWithDeadline");
-const utils_1 = require("./utils");
 const claimIncentivesFromMerkleDistributor = (incentivesData) => __awaiter(void 0, void 0, void 0, function* () {
     try {
         const contract = new ethers_1.Contract(incentivesData.contractAddress, MerkleDistributorWithDeadline_1.MerkleDistributorABI.abi, incentivesData.signer);
@@ -26,10 +25,9 @@ const claimIncentivesFromMerkleDistributor = (incentivesData) => __awaiter(void
     }
 });
 exports.claimIncentivesFromMerkleDistributor = claimIncentivesFromMerkleDistributor;
-const isClaimedFromMerkleDistributor = (chainId, contractAddress, index, provider) => __awaiter(void 0, void 0, void 0, function* () {
+const isClaimedFromMerkleDistributor = (contractAddress, index, provider) => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        const clientProvider = provider !== null && provider !== void 0 ? provider : (0, utils_1.getProvider)(chainId);
-        const contract = new ethers_1.Contract(contractAddress, MerkleDistributorWithDeadline_1.MerkleDistributorABI.abi, clientProvider);
+        const contract = new ethers_1.Contract(contractAddress, MerkleDistributorWithDeadline_1.MerkleDistributorABI.abi, provider);
         const claimed = yield contract.isClaimed(BigInt(index));
         return claimed;
     }

package/dist/cjs/src/incentives.js

@@ -95,7 +95,7 @@ class Incentives {
      */
     isClaimed(contractAddress, index) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield (0, incentiveHelpers_1.isClaimedFromMerkleDistributor)(this.chainId, contractAddress, index, this.provider);
+            return yield (0, incentiveHelpers_1.isClaimedFromMerkleDistributor)(contractAddress, index, this.provider);
         });
     }
     /**

package/dist/cjs/src/index.js

@@ -24,7 +24,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Client = exports.Incentives = void 0;
-const ethers_1 = require("ethers");
 const uuid_1 = require("uuid");
 const base_js_1 = require("./base.js");
 const constants_js_1 = require("./constants.js");
@@ -39,6 +38,7 @@ __exportStar(require("./types.js"), exports);
 __exportStar(require("./services.js"), exports);
 __exportStar(require("./verification/signature-validator.js"), exports);
 __exportStar(require("./verification/common.js"), exports);
+__exportStar(require("./constants.js"), exports);
 var incentives_js_2 = require("./incentives.js");
 Object.defineProperty(exports, "Incentives", { enumerable: true, get: function () { return incentives_js_2.Incentives; } });
 /**
@@ -120,13 +120,13 @@ class Client extends base_js_1.Base {
      * [createObolRewardsSplit](https://github.com/ObolNetwork/obol-sdk-examples/blob/main/TS-Example/index.ts#L141)
      */
     // add the example reference
-    createObolRewardsSplit({ splitRecipients, principalRecipient, etherAmount, ObolRAFSplit = constants_js_1.DEFAULT_RETROACTIVE_FUNDING_REWARDS_ONLY_SPLIT, distributorFee = 0, controllerAddress = ethers_1.ZeroAddress, recoveryAddress = ethers_1.ZeroAddress, }) {
+    createObolRewardsSplit({ splitRecipients, principalRecipient, etherAmount, ObolRAFSplit = constants_js_1.DEFAULT_RETROACTIVE_FUNDING_REWARDS_ONLY_SPLIT, distributorFee, controllerAddress, recoveryAddress, }) {
         return __awaiter(this, void 0, void 0, function* () {
             // This method doesnt require T&C signature
             if (!this.signer) {
                 throw new Error('Signer is required in createObolRewardsSplit');
             }
-            (0, ajv_js_1.validatePayload)({
+            const validatedPayload = (0, ajv_js_1.validatePayload)({
                 splitRecipients,
                 principalRecipient,
                 etherAmount,
@@ -149,9 +149,9 @@ class Client extends base_js_1.Base {
             }
             const retroActiveFundingRecipient = {
                 account: constants_js_1.CHAIN_CONFIGURATION[this.chainId].RETROACTIVE_FUNDING_ADDRESS.address,
-                percentAllocation: ObolRAFSplit,
+                percentAllocation: validatedPayload.ObolRAFSplit,
             };
-            const copiedSplitRecipients = [...splitRecipients];
+            const copiedSplitRecipients = [...validatedPayload.splitRecipients];
             copiedSplitRecipients.push(retroActiveFundingRecipient);
             const { accounts, percentAllocations } = (0, splitHelpers_js_1.formatSplitRecipients)(copiedSplitRecipients);
             const predictedSplitterAddress = yield (0, splitHelpers_js_1.predictSplitterAddress)({
@@ -159,8 +159,8 @@ class Client extends base_js_1.Base {
                 accounts,
                 percentAllocations,
                 chainId: this.chainId,
-                distributorFee,
-                controllerAddress,
+                distributorFee: validatedPayload.distributorFee,
+                controllerAddress: validatedPayload.controllerAddress,
             });
             const isSplitterDeployed = yield (0, utils_js_1.isContractAvailable)(predictedSplitterAddress, this.signer.provider);
             const { withdrawal_address, fee_recipient_address } = yield (0, splitHelpers_js_1.handleDeployOWRAndSplitter)({
@@ -169,12 +169,12 @@ class Client extends base_js_1.Base {
                 predictedSplitterAddress,
                 accounts,
                 percentAllocations,
-                principalRecipient,
-                etherAmount,
+                principalRecipient: validatedPayload.principalRecipient,
+                etherAmount: validatedPayload.etherAmount,
                 chainId: this.chainId,
-                distributorFee,
-                controllerAddress,
-                recoveryAddress,
+                distributorFee: validatedPayload.distributorFee,
+                controllerAddress: validatedPayload.controllerAddress,
+                recoveryAddress: validatedPayload.recoveryAddress,
             });
             return { withdrawal_address, fee_recipient_address };
         });
@@ -193,13 +193,13 @@ class Client extends base_js_1.Base {
      * [createObolTotalSplit](https://github.com/ObolNetwork/obol-sdk-examples/blob/main/TS-Example/index.ts#L168)
      */
     // add the example reference
-    createObolTotalSplit({ splitRecipients, ObolRAFSplit = constants_js_1.DEFAULT_RETROACTIVE_FUNDING_TOTAL_SPLIT, distributorFee = 0, controllerAddress = ethers_1.ZeroAddress, }) {
+    createObolTotalSplit({ splitRecipients, ObolRAFSplit, distributorFee, controllerAddress, }) {
         return __awaiter(this, void 0, void 0, function* () {
             // This method doesnt require T&C signature
             if (!this.signer) {
                 throw new Error('Signer is required in createObolTotalSplit');
             }
-            (0, ajv_js_1.validatePayload)({
+            const validatedPayload = (0, ajv_js_1.validatePayload)({
                 splitRecipients,
                 ObolRAFSplit,
                 distributorFee,
@@ -215,9 +215,9 @@ class Client extends base_js_1.Base {
             }
             const retroActiveFundingRecipient = {
                 account: constants_js_1.CHAIN_CONFIGURATION[this.chainId].RETROACTIVE_FUNDING_ADDRESS.address,
-                percentAllocation: ObolRAFSplit,
+                percentAllocation: validatedPayload.ObolRAFSplit,
             };
-            const copiedSplitRecipients = [...splitRecipients];
+            const copiedSplitRecipients = [...validatedPayload.splitRecipients];
             copiedSplitRecipients.push(retroActiveFundingRecipient);
             const { accounts, percentAllocations } = (0, splitHelpers_js_1.formatSplitRecipients)(copiedSplitRecipients);
             const predictedSplitterAddress = yield (0, splitHelpers_js_1.predictSplitterAddress)({
@@ -225,8 +225,8 @@ class Client extends base_js_1.Base {
                 accounts,
                 percentAllocations,
                 chainId: this.chainId,
-                distributorFee,
-                controllerAddress,
+                distributorFee: validatedPayload.distributorFee,
+                controllerAddress: validatedPayload.controllerAddress,
             });
             const isSplitterDeployed = yield (0, utils_js_1.isContractAvailable)(predictedSplitterAddress, this.signer.provider);
             if (!isSplitterDeployed) {
@@ -235,8 +235,8 @@ class Client extends base_js_1.Base {
                     accounts,
                     percentAllocations,
                     chainId: this.chainId,
-                    distributorFee,
-                    controllerAddress,
+                    distributorFee: validatedPayload.distributorFee,
+                    controllerAddress: validatedPayload.controllerAddress,
                 });
                 return {
                     withdrawal_address: splitterAddress,
@@ -283,10 +283,8 @@ class Client extends base_js_1.Base {
             if (!this.signer) {
                 throw new Error('Signer is required in createClusterDefinition');
             }
-            (0, ajv_js_1.validatePayload)(newCluster, schema_js_1.definitionSchema);
-            const clusterConfig = Object.assign(Object.assign({}, newCluster), { fork_version: this.fork_version, dkg_algorithm: constants_js_1.DKG_ALGORITHM, version: constants_js_1.CONFIG_VERSION, uuid: (0, uuid_1.v4)(), timestamp: new Date().toISOString(), threshold: Math.ceil((2 * newCluster.operators.length) / 3), num_validators: newCluster.validators.length, deposit_amounts: newCluster.deposit_amounts
-                    ? newCluster.deposit_amounts
-                    : ['32000000000'] });
+            const validatedCluster = (0, ajv_js_1.validatePayload)(newCluster, schema_js_1.definitionSchema);
+            const clusterConfig = Object.assign(Object.assign({}, validatedCluster), { fork_version: this.fork_version, dkg_algorithm: constants_js_1.DKG_ALGORITHM, version: constants_js_1.CONFIG_VERSION, uuid: (0, uuid_1.v4)(), timestamp: new Date().toISOString(), threshold: Math.ceil((2 * validatedCluster.operators.length) / 3), num_validators: validatedCluster.validators.length });
             try {
                 const address = yield this.signer.getAddress();
                 clusterConfig.creator = { address };
@@ -325,12 +323,12 @@ class Client extends base_js_1.Base {
             if (!this.signer) {
                 throw new Error('Signer is required in acceptClusterDefinition');
             }
-            (0, ajv_js_1.validatePayload)(operatorPayload, schema_js_1.operatorPayloadSchema);
+            const validatedPayload = (0, ajv_js_1.validatePayload)(operatorPayload, schema_js_1.operatorPayloadSchema);
             try {
                 const address = yield this.signer.getAddress();
                 const operatorConfigSignature = yield this.signer.signTypedData((0, constants_js_1.Domain)(this.chainId), constants_js_1.OperatorConfigHashSigningTypes, { operator_config_hash: configHash });
-                const operatorENRSignature = yield this.signer.signTypedData((0, constants_js_1.Domain)(this.chainId), constants_js_1.EnrSigningTypes, { enr: operatorPayload.enr });
-                const operatorData = Object.assign(Object.assign({}, operatorPayload), { address, enr_signature: operatorENRSignature, fork_version: this.fork_version });
+                const operatorENRSignature = yield this.signer.signTypedData((0, constants_js_1.Domain)(this.chainId), constants_js_1.EnrSigningTypes, { enr: validatedPayload.enr });
+                const operatorData = Object.assign(Object.assign({}, validatedPayload), { address, enr_signature: operatorENRSignature, fork_version: this.fork_version });
                 const clusterDefinition = yield this.request(`/${constants_js_1.DEFAULT_BASE_VERSION}/definition/${configHash}`, {
                     method: 'PUT',
                     body: JSON.stringify(operatorData),

package/dist/cjs/src/schema.js

@@ -1,40 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.rewardsSplitterPayloadSchema = exports.totalSplitterPayloadSchema = exports.definitionSchema = exports.operatorPayloadSchema = void 0;
+const ethers_1 = require("ethers");
 const constants_1 = require("./constants");
+const ajv_1 = require("./ajv");
 exports.operatorPayloadSchema = {
     type: 'object',
     properties: {
-        version: {
-            type: 'string',
-        },
-        enr: {
-            type: 'string',
-        },
+        version: { type: 'string' },
+        enr: { type: 'string' },
     },
     required: ['version', 'enr'],
 };
 exports.definitionSchema = {
     type: 'object',
     properties: {
-        name: {
-            type: 'string',
-        },
+        name: { type: 'string' },
         operators: {
             type: 'array',
             minItems: 4,
-            uniqueItems: true,
             items: {
                 type: 'object',
                 properties: {
                     address: {
                         type: 'string',
-                        minLength: 42,
-                        maxLength: 42,
                     },
                 },
                 required: ['address'],
             },
+            validateUniqueAddresses: true,
         },
         validators: {
             type: 'array',
@@ -55,12 +49,39 @@ exports.definitionSchema = {
             },
         },
         deposit_amounts: {
-            type: 'array',
+            type: ['array', 'null'],
             items: {
                 type: 'string',
                 pattern: '^[0-9]+$',
             },
-            validDepositAmounts: true,
+            if: {
+                $data: '1/compounding',
+            },
+            then: {
+                items: {
+                    enum: ajv_1.VALID_DEPOSIT_AMOUNTS,
+                },
+            },
+            else: {
+                items: {
+                    enum: ajv_1.VALID_NON_COMPOUNDING_AMOUNTS,
+                },
+            },
+            default: null,
+        },
+        compounding: {
+            type: 'boolean',
+            default: true,
+        },
+        target_gas_limit: {
+            type: 'number',
+            minimum: 1,
+            default: 36000000,
+        },
+        consensus_protocol: {
+            type: 'string',
+            enum: ['qbft', ''],
+            default: '',
         },
     },
     required: ['name', 'operators', 'validators'],
@@ -77,9 +98,7 @@ exports.totalSplitterPayloadSchema = {
                         type: 'string',
                         pattern: '^0x[a-fA-F0-9]{40}$',
                     },
-                    percentAllocation: {
-                        type: 'number',
-                    },
+                    percentAllocation: { type: 'number' },
                 },
                 required: ['account', 'percentAllocation'],
             },
@@ -87,29 +106,37 @@ exports.totalSplitterPayloadSchema = {
         ObolRAFSplit: {
             type: 'number',
             minimum: constants_1.DEFAULT_RETROACTIVE_FUNDING_TOTAL_SPLIT,
+            default: constants_1.DEFAULT_RETROACTIVE_FUNDING_TOTAL_SPLIT,
         },
         distributorFee: {
             type: 'number',
             maximum: 10,
             multipleOf: 0.01,
+            default: 0,
         },
         controllerAddress: {
             type: 'string',
             pattern: '^0x[a-fA-F0-9]{40}$',
+            default: ethers_1.ZeroAddress,
         },
-        validateSplitRecipients: true,
     },
+    validateTotalSplitRecipients: true,
     required: ['splitRecipients'],
 };
-exports.rewardsSplitterPayloadSchema = Object.assign(Object.assign({}, exports.totalSplitterPayloadSchema), { properties: Object.assign(Object.assign({}, exports.totalSplitterPayloadSchema.properties), { ObolRAFSplit: {
+exports.rewardsSplitterPayloadSchema = {
+    type: 'object',
+    properties: Object.assign(Object.assign({}, exports.totalSplitterPayloadSchema.properties), { ObolRAFSplit: {
             type: 'number',
             minimum: constants_1.DEFAULT_RETROACTIVE_FUNDING_REWARDS_ONLY_SPLIT,
+            default: constants_1.DEFAULT_RETROACTIVE_FUNDING_REWARDS_ONLY_SPLIT,
         }, recoveryAddress: {
             type: 'string',
             pattern: '^0x[a-fA-F0-9]{40}$',
-        }, etherAmount: {
-            type: 'number',
-        }, principalRecipient: {
+            default: ethers_1.ZeroAddress,
+        }, etherAmount: { type: 'number' }, principalRecipient: {
             type: 'string',
             pattern: '^0x[a-fA-F0-9]{40}$',
-        } }), required: ['splitRecipients', 'principalRecipient', 'etherAmount'] });
+        } }),
+    validateRewardsSplitRecipients: true,
+    required: ['splitRecipients', 'principalRecipient', 'etherAmount'],
+};

package/dist/cjs/src/services.js

@@ -14,15 +14,16 @@ const common_js_1 = require("./verification/common.js");
 /**
  * Verifies Cluster Lock's validity.
  * @param lock - cluster lock
+ * @param safeRpcUrl - optional safeRpcUrl for safe wallet verification
  * @returns {Promise<{ result: boolean }> } boolean result to indicate if lock is valid
  * @throws on missing keys or values.
  *
  * An example of how to use validateClusterLock:
  * [validateClusterLock](https://github.com/ObolNetwork/obol-sdk-examples/blob/main/TS-Example/index.ts#L127)
  */
-const validateClusterLock = (lock) => __awaiter(void 0, void 0, void 0, function* () {
+const validateClusterLock = (lock, safeRpcUrl) => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        const isLockValid = yield (0, common_js_1.isValidClusterLock)(lock);
+        const isLockValid = yield (0, common_js_1.isValidClusterLock)(lock, safeRpcUrl);
         return isLockValid;
     }
     catch (err) {

package/dist/cjs/src/utils.js

@@ -67,11 +67,11 @@ const isContractAvailable = (contractAddress, provider, bytecode) => __awaiter(v
     return !!code && code !== '0x' && code !== '0x0';
 });
 exports.isContractAvailable = isContractAvailable;
-const getProvider = (chainId) => {
-    const rpcUrl = constants_1.PROVIDER_MAP[chainId];
-    if (!rpcUrl || rpcUrl === 'undefined') {
+const getProvider = (chainId, rpcUrl) => {
+    const resolvedRpcUrl = rpcUrl !== null && rpcUrl !== void 0 ? rpcUrl : constants_1.PROVIDER_MAP[chainId];
+    if (chainId && (!resolvedRpcUrl || resolvedRpcUrl === 'undefined')) {
         throw new Error(`No provider configured for ${types_1.FORK_NAMES[chainId]}`);
     }
-    return new ethers_1.ethers.JsonRpcProvider(rpcUrl);
+    return new ethers_1.ethers.JsonRpcProvider(resolvedRpcUrl);
 };
 exports.getProvider = getProvider;

package/dist/cjs/src/verification/common.js

@@ -131,7 +131,7 @@ const clusterLockHash = (clusterLock) => {
 exports.clusterLockHash = clusterLockHash;
 // Lock verification
 // cluster-definition signatures verification
-const validatePOSTConfigHashSigner = (address, signature, configHash, chainId) => __awaiter(void 0, void 0, void 0, function* () {
+const validatePOSTConfigHashSigner = (address, signature, configHash, chainId, safeRpcUrl) => __awaiter(void 0, void 0, void 0, function* () {
     try {
         const data = (0, constants_js_1.signCreatorConfigHashPayload)({ creator_config_hash: configHash }, chainId);
         return yield (0, signature_validator_js_1.validateAddressSignature)({
@@ -139,13 +139,14 @@ const validatePOSTConfigHashSigner = (address, signature, configHash, chainId) =
             token: signature,
             data,
             chainId,
+            safeRpcUrl,
         });
     }
     catch (err) {
         throw err;
     }
 });
-const validatePUTConfigHashSigner = (address, signature, configHash, chainId) => __awaiter(void 0, void 0, void 0, function* () {
+const validatePUTConfigHashSigner = (address, signature, configHash, chainId, safeRpcUrl) => __awaiter(void 0, void 0, void 0, function* () {
     try {
         const data = (0, constants_js_1.signOperatorConfigHashPayload)({ operator_config_hash: configHash }, chainId);
         return yield (0, signature_validator_js_1.validateAddressSignature)({
@@ -153,13 +154,14 @@ const validatePUTConfigHashSigner = (address, signature, configHash, chainId) =>
             token: signature,
             data,
             chainId,
+            safeRpcUrl,
         });
     }
     catch (err) {
         throw err;
     }
 });
-const validateEnrSigner = (address, signature, payload, chainId) => __awaiter(void 0, void 0, void 0, function* () {
+const validateEnrSigner = (address, signature, payload, chainId, safeRpcUrl) => __awaiter(void 0, void 0, void 0, function* () {
     try {
         const data = (0, constants_js_1.signEnrPayload)({ enr: payload }, chainId);
         return yield (0, signature_validator_js_1.validateAddressSignature)({
@@ -167,18 +169,19 @@ const validateEnrSigner = (address, signature, payload, chainId) => __awaiter(vo
             token: signature,
             data,
             chainId,
+            safeRpcUrl,
         });
     }
     catch (err) {
         throw err;
     }
 });
-const verifyDefinitionSignatures = (clusterDefinition, definitionType) => __awaiter(void 0, void 0, void 0, function* () {
+const verifyDefinitionSignatures = (clusterDefinition, definitionType, safeRpcUrl) => __awaiter(void 0, void 0, void 0, function* () {
     if (definitionType === constants_js_1.DefinitionFlow.Charon) {
         return true;
     }
     else {
-        const isPOSTConfigHashSignerValid = yield validatePOSTConfigHashSigner(clusterDefinition.creator.address, clusterDefinition.creator.config_signature, clusterDefinition.config_hash, types_js_1.FORK_MAPPING[clusterDefinition.fork_version]);
+        const isPOSTConfigHashSignerValid = yield validatePOSTConfigHashSigner(clusterDefinition.creator.address, clusterDefinition.creator.config_signature, clusterDefinition.config_hash, types_js_1.FORK_MAPPING[clusterDefinition.fork_version], safeRpcUrl);
         if (!isPOSTConfigHashSignerValid) {
             return false;
         }
@@ -186,8 +189,8 @@ const verifyDefinitionSignatures = (clusterDefinition, definitionType) => __awai
             return true;
         }
         for (const operator of clusterDefinition.operators) {
-            const isPUTConfigHashSignerValid = yield validatePUTConfigHashSigner(operator.address, operator.config_signature, clusterDefinition.config_hash, types_js_1.FORK_MAPPING[clusterDefinition.fork_version]);
-            const isENRSignerValid = yield validateEnrSigner(operator.address, operator.enr_signature, operator.enr, types_js_1.FORK_MAPPING[clusterDefinition.fork_version]);
+            const isPUTConfigHashSignerValid = yield validatePUTConfigHashSigner(operator.address, operator.config_signature, clusterDefinition.config_hash, types_js_1.FORK_MAPPING[clusterDefinition.fork_version], safeRpcUrl);
+            const isENRSignerValid = yield validateEnrSigner(operator.address, operator.enr_signature, operator.enr, types_js_1.FORK_MAPPING[clusterDefinition.fork_version], safeRpcUrl);
             if (!isPUTConfigHashSignerValid || !isENRSignerValid) {
                 return false;
             }
@@ -322,13 +325,13 @@ const verifyLockData = (clusterLock) => __awaiter(void 0, void 0, void 0, functi
     }
     return false;
 });
-const isValidClusterLock = (clusterLock) => __awaiter(void 0, void 0, void 0, function* () {
+const isValidClusterLock = (clusterLock, safeRpcUrl) => __awaiter(void 0, void 0, void 0, function* () {
     try {
         const definitionType = (0, utils_js_1.definitionFlow)(clusterLock.cluster_definition);
         if (definitionType == null) {
             return false;
         }
-        const isValidDefinitionData = yield verifyDefinitionSignatures(clusterLock.cluster_definition, definitionType);
+        const isValidDefinitionData = yield verifyDefinitionSignatures(clusterLock.cluster_definition, definitionType, safeRpcUrl);
         if (!isValidDefinitionData) {
             return false;
         }