@obolnetwork/obol-sdk 1.0.8 → 1.0.9

package/README.md

@@ -6,4 +6,4 @@ This repo contains the Obol Software Development Kit, for creating Distributed V
 
 ## Getting Started
 
-Checkout our [docs](https://docs.obol.tech/docs/int/quickstart). Further guides and walkthroughs coming soon. 
+Checkout our [docs](https://docs.obol.tech/docs/int/quickstart/advanced/quickstart-sdk), [examples](https://github.com/ObolNetwork/obol-sdk-examples/), and SDK [reference](https://obolnetwork.github.io/obol-packages). Further guides and walkthroughs coming soon. 

package/dist/ajv.d.ts

@@ -1,4 +1,3 @@
 import { ErrorObject } from 'ajv';
-import { ClusterPayload } from './types';
-export declare function validateDefinition(data: ClusterPayload): ErrorObject[] | undefined | null;
+export declare function validatePayload(data: any, schema: any): ErrorObject[] | undefined | null | boolean;
 //# sourceMappingURL=ajv.d.ts.map

package/dist/ajv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ajv.d.ts","sourceRoot":"","sources":["../src/ajv.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW,EAAE,GAAG,SAAS,GAAG,IAAI,CAQzF"}
+{"version":3,"file":"ajv.d.ts","sourceRoot":"","sources":["../src/ajv.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAEvC,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,WAAW,EAAE,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAQlG"}

package/dist/constants.d.ts

@@ -5,6 +5,18 @@ export declare const CreatorConfigHashSigningTypes: {
         type: string;
     }[];
 };
+export declare const EnrSigningTypes: {
+    ENR: {
+        name: string;
+        type: string;
+    }[];
+};
+export declare const OperatorConfigHashSigningTypes: {
+    OperatorConfigHash: {
+        name: string;
+        type: string;
+    }[];
+};
 export declare const Domain: (chainId: number) => {
     name: string;
     version: string;
@@ -12,7 +24,7 @@ export declare const Domain: (chainId: number) => {
 };
 export declare const dkg_algorithm = "default";
 export declare const config_version = "v1.7.0";
-export declare const SDK_VERSION = "1.0.7";
+export declare const SDK_VERSION = "1.0.8";
 export declare const DEFAULT_BASE_URL = "https://api.obol.tech";
 export declare const DEFAULT_CHAIN_ID = 1;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,aAAa,CAAA;AAI5C,eAAO,MAAM,6BAA6B;;;;;CAEzC,CAAC;AACF,eAAO,MAAM,MAAM,YAAY,MAAM;;;;CAMpC,CAAA;AAGD,eAAO,MAAM,aAAa,YAAY,CAAC;AAEvC,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AACxD,eAAO,MAAM,gBAAgB,IAAI,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,aAAa,CAAA;AAG5C,eAAO,MAAM,6BAA6B;;;;;CAEzC,CAAC;AACF,eAAO,MAAM,eAAe;;;;;CAE3B,CAAC;AACF,eAAO,MAAM,8BAA8B;;;;;CAE1C,CAAC;AACF,eAAO,MAAM,MAAM,YAAa,MAAM;;;;CAMrC,CAAA;AACD,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,eAAO,MAAM,cAAc,WAAW,CAAC;AACvC,eAAO,MAAM,WAAW,UAAU,CAAC;AACnC,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AACxD,eAAO,MAAM,gBAAgB,IAAI,CAAC"}

package/dist/fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoF1B,CAAA;AAGF,eAAO,MAAM,aAAa;;;;;;;;;CAazB,CAAA"}
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoF3B,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;CAazB,CAAA"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Signer } from 'ethers';
 import { Base } from './base';
-import { ClusterDefintion, ClusterLock, ClusterPayload } from './types';
+import { ClusterDefintion, ClusterLock, ClusterPayload, OperatorPayload } from './types';
 export * from "./types";
 /**
  * Obol sdk Client can be used for creating, managing and activating distributed validators.
@@ -18,7 +18,7 @@ export declare class Client extends Base {
     constructor(config: {
         baseUrl?: string | undefined;
         chainId?: number | undefined;
-    }, signer: Signer);
+    }, signer?: Signer);
     /**
      * Creates a cluster definition which contains cluster configuration.
      * @param {ClusterPayload} newCluster - The new unique cluster.
@@ -29,6 +29,17 @@ export declare class Client extends Base {
      * [createObolCluster](https://github.com/ObolNetwork/obol-sdk-examples/blob/main/TS-Example/index.ts)
      */
     createClusterDefinition(newCluster: ClusterPayload): Promise<string>;
+    /**
+    * Approves joining a cluster with specific configuration.
+    * @param {OperatorPayload} operatorPayload - The operator data including signatures.
+    * @param {string} configHash - The config hash of the cluster which the operator confirms joining to.
+    * @returns {Promise<ClusterDefintion>} The cluster definition.
+    * @throws On unauthorized, duplicate entries, missing keys, not found cluster or invalid data.
+    *
+    * An example of how to use updateClusterDefinition:
+    * [updateClusterDefinition](https://github.com/ObolNetwork/obol-sdk-examples/blob/main/TS-Example/index.ts)
+    */
+    updateClusterDefinition(operatorPayload: OperatorPayload, configHash: string): Promise<ClusterDefintion>;
     /**
      * @returns {Promise<ClusterDefintion>} The  cluster definition for config hash
      * @throws On not found config hash.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGxE,cAAc,SAAS,CAAC;AAExB;;GAEG;AACH,qBAAa,MAAO,SAAQ,IAAI;IAC9B,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;;;;OAOG;gBACS,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,EAAE,MAAM,EAAE,MAAM;IAMlG;;;;;;;;OAQG;IACG,uBAAuB,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IA0C1E;;;;;;OAMG;IACG,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IASzE;;;;;;OAMG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAQ/D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAIzF,cAAc,SAAS,CAAC;AAExB;;GAEG;AACH,qBAAa,MAAO,SAAQ,IAAI;IAC9B,OAAO,CAAC,MAAM,CAAqB;IAEnC;;;;;;;OAOG;gBACS,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,EAAE,MAAM,CAAC,EAAE,MAAM;IAMnG;;;;;;;;OAQG;IACG,uBAAuB,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAyC1E;;;;;;;;;MASE;IACI,uBAAuB,CAAC,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgC9G;;;;;;OAMG;IACG,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IASzE;;;;;;OAMG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAQ/D"}

package/dist/index.es.js

@@ -69,6 +69,12 @@ const EIP712_DOMAIN_VERSION = "1";
 const CreatorConfigHashSigningTypes = {
     CreatorConfigHash: [{ name: "creator_config_hash", type: "string" }],
 };
+const EnrSigningTypes = {
+    ENR: [{ name: "enr", type: "string" }],
+};
+const OperatorConfigHashSigningTypes = {
+    OperatorConfigHash: [{ name: "operator_config_hash", type: "string" }],
+};
 const Domain = (chainId) => {
     return {
         name: EIP712_DOMAIN_NAME,
@@ -78,7 +84,7 @@ const Domain = (chainId) => {
 };
 const dkg_algorithm = "default";
 const config_version = "v1.7.0";
-const SDK_VERSION = "1.0.7";
+const SDK_VERSION = "1.0.8";
 const DEFAULT_BASE_URL = "https://api.obol.tech";
 const DEFAULT_CHAIN_ID = 1;
 
@@ -11291,11 +11297,11 @@ function getJsonPointer(parsedRef, { baseId, schema, root }) {
 
 var $id$1 = "https://raw.githubusercontent.com/ajv-validator/ajv/master/lib/refs/data.json#";
 var description = "Meta-schema for $data reference (JSON AnySchema extension proposal)";
-var type$2 = "object";
-var required$2 = [
+var type$1 = "object";
+var required$1 = [
 	"$data"
 ];
-var properties$3 = {
+var properties$2 = {
 	$data: {
 		type: "string",
 		anyOf: [
@@ -11312,9 +11318,9 @@ var additionalProperties$1 = false;
 var require$$9 = {
 	$id: $id$1,
 	description: description,
-	type: type$2,
-	required: required$2,
-	properties: properties$3,
+	type: type$1,
+	required: required$1,
+	properties: properties$2,
 	additionalProperties: additionalProperties$1
 };
 
@@ -13668,9 +13674,9 @@ const def$m = {
 };
 limitProperties.default = def$m;
 
-var required$1 = {};
+var required = {};
 
-Object.defineProperty(required$1, "__esModule", { value: true });
+Object.defineProperty(required, "__esModule", { value: true });
 const code_1$6 = requireCode();
 const codegen_1$f = requireCodegen();
 const util_1$h = util;
@@ -13746,7 +13752,7 @@ const def$l = {
         }
     },
 };
-required$1.default = def$l;
+required.default = def$l;
 
 var limitItems = {};
 
@@ -13927,7 +13933,7 @@ const multipleOf_1 = multipleOf;
 const limitLength_1 = limitLength;
 const pattern_1 = pattern;
 const limitProperties_1 = limitProperties;
-const required_1 = required$1;
+const required_1 = required;
 const limitItems_1 = limitItems;
 const uniqueItems_1 = uniqueItems;
 const const_1 = _const;
@@ -14433,9 +14439,9 @@ const def$a = {
 };
 additionalProperties.default = def$a;
 
-var properties$2 = {};
+var properties$1 = {};
 
-Object.defineProperty(properties$2, "__esModule", { value: true });
+Object.defineProperty(properties$1, "__esModule", { value: true });
 const validate_1 = requireValidate();
 const code_1$2 = requireCode();
 const util_1$7 = util;
@@ -14486,7 +14492,7 @@ const def$9 = {
         }
     },
 };
-properties$2.default = def$9;
+properties$1.default = def$9;
 
 var patternProperties = {};
 
@@ -14779,7 +14785,7 @@ const contains_1 = contains;
 const dependencies_1 = dependencies;
 const propertyNames_1 = propertyNames;
 const additionalProperties_1 = additionalProperties;
-const properties_1 = properties$2;
+const properties_1 = properties$1;
 const patternProperties_1 = patternProperties;
 const not_1 = not;
 const anyOf_1 = anyOf;
@@ -15107,11 +15113,11 @@ var definitions = {
 		]
 	}
 };
-var type$1 = [
+var type = [
 	"object",
 	"boolean"
 ];
-var properties$1 = {
+var properties = {
 	$id: {
 		type: "string",
 		format: "uri-reference"
@@ -15308,8 +15314,8 @@ var require$$3 = {
 	$id: $id,
 	title: title,
 	definitions: definitions,
-	type: type$1,
-	properties: properties$1,
+	type: type,
+	properties: properties,
 	"default": true
 };
 
@@ -15368,73 +15374,85 @@ ajv.exports;
 var ajvExports = ajv.exports;
 var Ajv = /*@__PURE__*/getDefaultExportFromCjs(ajvExports);
 
-var type = "object";
-var properties = {
-	name: {
-		type: "string"
-	},
-	operators: {
-		type: "array",
-		minItems: 4,
-		uniqueItems: true,
-		items: {
-			type: "object",
-			properties: {
-				address: {
-					type: "string",
-					minLength: 42,
-					maxLength: 42
-				}
-			},
-			required: [
-				"address"
-			]
-		}
-	},
-	validators: {
-		type: "array",
-		minItems: 1,
-		items: {
-			type: "object",
-			properties: {
-				fee_recipient_address: {
-					type: "string",
-					minLength: 42,
-					maxLength: 42
-				},
-				withdrawal_address: {
-					type: "string",
-					minLength: 42,
-					maxLength: 42
-				}
-			},
-			required: [
-				"fee_recipient_address",
-				"withdrawal_address"
-			]
-		}
-	}
-};
-var required = [
-	"name",
-	"operators",
-	"validators"
-];
-var definitionSchema = {
-	type: type,
-	properties: properties,
-	required: required
-};
-
-function validateDefinition(data) {
+function validatePayload(data, schema) {
     const ajv = new Ajv();
-    const validate = ajv.compile(definitionSchema);
+    const validate = ajv.compile(schema);
     const isValid = validate(data);
     if (!isValid) {
-        return validate.errors;
+        throw new Error(`Schema compilation errors', ${validate.errors && validate.errors[0].message}`);
     }
-    return null;
-}
+    return isValid;
+}
+
+const operatorPayloadSchema = {
+    type: "object",
+    properties: {
+        version: {
+            type: "string"
+        },
+        enr: {
+            type: "string"
+        },
+    },
+    required: [
+        "version",
+        "enr",
+    ]
+};
+const definitionSchema = {
+    type: "object",
+    properties: {
+        name: {
+            type: "string"
+        },
+        operators: {
+            type: "array",
+            minItems: 4,
+            uniqueItems: true,
+            items: {
+                type: "object",
+                properties: {
+                    address: {
+                        type: "string",
+                        minLength: 42,
+                        maxLength: 42
+                    }
+                },
+                required: [
+                    "address"
+                ]
+            }
+        },
+        validators: {
+            type: "array",
+            minItems: 1,
+            items: {
+                type: "object",
+                properties: {
+                    fee_recipient_address: {
+                        type: "string",
+                        minLength: 42,
+                        maxLength: 42
+                    },
+                    withdrawal_address: {
+                        type: "string",
+                        minLength: 42,
+                        maxLength: 42
+                    }
+                },
+                required: [
+                    "fee_recipient_address",
+                    "withdrawal_address"
+                ]
+            }
+        }
+    },
+    required: [
+        "name",
+        "operators",
+        "validators"
+    ]
+};
 
 /**
  * Obol sdk Client can be used for creating, managing and activating distributed validators.
@@ -15462,9 +15480,9 @@ class Client extends Base {
      * [createObolCluster](https://github.com/ObolNetwork/obol-sdk-examples/blob/main/TS-Example/index.ts)
      */
     async createClusterDefinition(newCluster) {
-        const isValid = validateDefinition(newCluster);
-        if (isValid !== null)
-            throw new Error(`An error occurred: ${isValid && isValid[0].message}`);
+        if (!this.signer)
+            throw "Signer is required in createClusterDefinition";
+        validatePayload(newCluster, definitionSchema);
         const clusterConfig = {
             ...newCluster,
             fork_version: this.fork_version,
@@ -15493,7 +15511,44 @@ class Client extends Base {
         catch (err) {
             if (err?.message == CONFLICT_ERROR_MSG)
                 throw new ConflictError();
-            throw err?.message;
+            throw err;
+        }
+    }
+    /**
+    * Approves joining a cluster with specific configuration.
+    * @param {OperatorPayload} operatorPayload - The operator data including signatures.
+    * @param {string} configHash - The config hash of the cluster which the operator confirms joining to.
+    * @returns {Promise<ClusterDefintion>} The cluster definition.
+    * @throws On unauthorized, duplicate entries, missing keys, not found cluster or invalid data.
+    *
+    * An example of how to use updateClusterDefinition:
+    * [updateClusterDefinition](https://github.com/ObolNetwork/obol-sdk-examples/blob/main/TS-Example/index.ts)
+    */
+    async updateClusterDefinition(operatorPayload, configHash) {
+        if (!this.signer)
+            throw "Signer is required in updateClusterDefinition";
+        validatePayload(operatorPayload, operatorPayloadSchema);
+        try {
+            const address = await this.signer.getAddress();
+            const operatorConfigSignature = await this.signer.signTypedData(Domain(this.chainId), OperatorConfigHashSigningTypes, { operator_config_hash: configHash });
+            const operatorENRSignature = await this.signer.signTypedData(Domain(this.chainId), EnrSigningTypes, { enr: operatorPayload.enr });
+            const operatorData = {
+                ...operatorPayload,
+                address,
+                enr_signature: operatorENRSignature,
+                fork_version: this.fork_version
+            };
+            const clusterDefinition = await this.request(`/dv/${configHash}`, {
+                method: 'PUT',
+                body: JSON.stringify(operatorData),
+                headers: {
+                    Authorization: `Bearer ${operatorConfigSignature}`,
+                }
+            });
+            return clusterDefinition;
+        }
+        catch (err) {
+            throw err;
         }
     }
     /**

package/dist/index.js

@@ -73,6 +73,12 @@ const EIP712_DOMAIN_VERSION = "1";
 const CreatorConfigHashSigningTypes = {
     CreatorConfigHash: [{ name: "creator_config_hash", type: "string" }],
 };
+const EnrSigningTypes = {
+    ENR: [{ name: "enr", type: "string" }],
+};
+const OperatorConfigHashSigningTypes = {
+    OperatorConfigHash: [{ name: "operator_config_hash", type: "string" }],
+};
 const Domain = (chainId) => {
     return {
         name: EIP712_DOMAIN_NAME,
@@ -82,7 +88,7 @@ const Domain = (chainId) => {
 };
 const dkg_algorithm = "default";
 const config_version = "v1.7.0";
-const SDK_VERSION = "1.0.7";
+const SDK_VERSION = "1.0.8";
 const DEFAULT_BASE_URL = "https://api.obol.tech";
 const DEFAULT_CHAIN_ID = 1;
 
@@ -11295,11 +11301,11 @@ function getJsonPointer(parsedRef, { baseId, schema, root }) {
 
 var $id$1 = "https://raw.githubusercontent.com/ajv-validator/ajv/master/lib/refs/data.json#";
 var description = "Meta-schema for $data reference (JSON AnySchema extension proposal)";
-var type$2 = "object";
-var required$2 = [
+var type$1 = "object";
+var required$1 = [
 	"$data"
 ];
-var properties$3 = {
+var properties$2 = {
 	$data: {
 		type: "string",
 		anyOf: [
@@ -11316,9 +11322,9 @@ var additionalProperties$1 = false;
 var require$$9 = {
 	$id: $id$1,
 	description: description,
-	type: type$2,
-	required: required$2,
-	properties: properties$3,
+	type: type$1,
+	required: required$1,
+	properties: properties$2,
 	additionalProperties: additionalProperties$1
 };
 
@@ -13672,9 +13678,9 @@ const def$m = {
 };
 limitProperties.default = def$m;
 
-var required$1 = {};
+var required = {};
 
-Object.defineProperty(required$1, "__esModule", { value: true });
+Object.defineProperty(required, "__esModule", { value: true });
 const code_1$6 = requireCode();
 const codegen_1$f = requireCodegen();
 const util_1$h = util;
@@ -13750,7 +13756,7 @@ const def$l = {
         }
     },
 };
-required$1.default = def$l;
+required.default = def$l;
 
 var limitItems = {};
 
@@ -13931,7 +13937,7 @@ const multipleOf_1 = multipleOf;
 const limitLength_1 = limitLength;
 const pattern_1 = pattern;
 const limitProperties_1 = limitProperties;
-const required_1 = required$1;
+const required_1 = required;
 const limitItems_1 = limitItems;
 const uniqueItems_1 = uniqueItems;
 const const_1 = _const;
@@ -14437,9 +14443,9 @@ const def$a = {
 };
 additionalProperties.default = def$a;
 
-var properties$2 = {};
+var properties$1 = {};
 
-Object.defineProperty(properties$2, "__esModule", { value: true });
+Object.defineProperty(properties$1, "__esModule", { value: true });
 const validate_1 = requireValidate();
 const code_1$2 = requireCode();
 const util_1$7 = util;
@@ -14490,7 +14496,7 @@ const def$9 = {
         }
     },
 };
-properties$2.default = def$9;
+properties$1.default = def$9;
 
 var patternProperties = {};
 
@@ -14783,7 +14789,7 @@ const contains_1 = contains;
 const dependencies_1 = dependencies;
 const propertyNames_1 = propertyNames;
 const additionalProperties_1 = additionalProperties;
-const properties_1 = properties$2;
+const properties_1 = properties$1;
 const patternProperties_1 = patternProperties;
 const not_1 = not;
 const anyOf_1 = anyOf;
@@ -15111,11 +15117,11 @@ var definitions = {
 		]
 	}
 };
-var type$1 = [
+var type = [
 	"object",
 	"boolean"
 ];
-var properties$1 = {
+var properties = {
 	$id: {
 		type: "string",
 		format: "uri-reference"
@@ -15312,8 +15318,8 @@ var require$$3 = {
 	$id: $id,
 	title: title,
 	definitions: definitions,
-	type: type$1,
-	properties: properties$1,
+	type: type,
+	properties: properties,
 	"default": true
 };
 
@@ -15372,73 +15378,85 @@ ajv.exports;
 var ajvExports = ajv.exports;
 var Ajv = /*@__PURE__*/getDefaultExportFromCjs(ajvExports);
 
-var type = "object";
-var properties = {
-	name: {
-		type: "string"
-	},
-	operators: {
-		type: "array",
-		minItems: 4,
-		uniqueItems: true,
-		items: {
-			type: "object",
-			properties: {
-				address: {
-					type: "string",
-					minLength: 42,
-					maxLength: 42
-				}
-			},
-			required: [
-				"address"
-			]
-		}
-	},
-	validators: {
-		type: "array",
-		minItems: 1,
-		items: {
-			type: "object",
-			properties: {
-				fee_recipient_address: {
-					type: "string",
-					minLength: 42,
-					maxLength: 42
-				},
-				withdrawal_address: {
-					type: "string",
-					minLength: 42,
-					maxLength: 42
-				}
-			},
-			required: [
-				"fee_recipient_address",
-				"withdrawal_address"
-			]
-		}
-	}
-};
-var required = [
-	"name",
-	"operators",
-	"validators"
-];
-var definitionSchema = {
-	type: type,
-	properties: properties,
-	required: required
-};
-
-function validateDefinition(data) {
+function validatePayload(data, schema) {
     const ajv = new Ajv();
-    const validate = ajv.compile(definitionSchema);
+    const validate = ajv.compile(schema);
     const isValid = validate(data);
     if (!isValid) {
-        return validate.errors;
+        throw new Error(`Schema compilation errors', ${validate.errors && validate.errors[0].message}`);
     }
-    return null;
-}
+    return isValid;
+}
+
+const operatorPayloadSchema = {
+    type: "object",
+    properties: {
+        version: {
+            type: "string"
+        },
+        enr: {
+            type: "string"
+        },
+    },
+    required: [
+        "version",
+        "enr",
+    ]
+};
+const definitionSchema = {
+    type: "object",
+    properties: {
+        name: {
+            type: "string"
+        },
+        operators: {
+            type: "array",
+            minItems: 4,
+            uniqueItems: true,
+            items: {
+                type: "object",
+                properties: {
+                    address: {
+                        type: "string",
+                        minLength: 42,
+                        maxLength: 42
+                    }
+                },
+                required: [
+                    "address"
+                ]
+            }
+        },
+        validators: {
+            type: "array",
+            minItems: 1,
+            items: {
+                type: "object",
+                properties: {
+                    fee_recipient_address: {
+                        type: "string",
+                        minLength: 42,
+                        maxLength: 42
+                    },
+                    withdrawal_address: {
+                        type: "string",
+                        minLength: 42,
+                        maxLength: 42
+                    }
+                },
+                required: [
+                    "fee_recipient_address",
+                    "withdrawal_address"
+                ]
+            }
+        }
+    },
+    required: [
+        "name",
+        "operators",
+        "validators"
+    ]
+};
 
 /**
  * Obol sdk Client can be used for creating, managing and activating distributed validators.
@@ -15466,9 +15484,9 @@ class Client extends Base {
      * [createObolCluster](https://github.com/ObolNetwork/obol-sdk-examples/blob/main/TS-Example/index.ts)
      */
     async createClusterDefinition(newCluster) {
-        const isValid = validateDefinition(newCluster);
-        if (isValid !== null)
-            throw new Error(`An error occurred: ${isValid && isValid[0].message}`);
+        if (!this.signer)
+            throw "Signer is required in createClusterDefinition";
+        validatePayload(newCluster, definitionSchema);
         const clusterConfig = {
             ...newCluster,
             fork_version: this.fork_version,
@@ -15497,7 +15515,44 @@ class Client extends Base {
         catch (err) {
             if (err?.message == CONFLICT_ERROR_MSG)
                 throw new ConflictError();
-            throw err?.message;
+            throw err;
+        }
+    }
+    /**
+    * Approves joining a cluster with specific configuration.
+    * @param {OperatorPayload} operatorPayload - The operator data including signatures.
+    * @param {string} configHash - The config hash of the cluster which the operator confirms joining to.
+    * @returns {Promise<ClusterDefintion>} The cluster definition.
+    * @throws On unauthorized, duplicate entries, missing keys, not found cluster or invalid data.
+    *
+    * An example of how to use updateClusterDefinition:
+    * [updateClusterDefinition](https://github.com/ObolNetwork/obol-sdk-examples/blob/main/TS-Example/index.ts)
+    */
+    async updateClusterDefinition(operatorPayload, configHash) {
+        if (!this.signer)
+            throw "Signer is required in updateClusterDefinition";
+        validatePayload(operatorPayload, operatorPayloadSchema);
+        try {
+            const address = await this.signer.getAddress();
+            const operatorConfigSignature = await this.signer.signTypedData(Domain(this.chainId), OperatorConfigHashSigningTypes, { operator_config_hash: configHash });
+            const operatorENRSignature = await this.signer.signTypedData(Domain(this.chainId), EnrSigningTypes, { enr: operatorPayload.enr });
+            const operatorData = {
+                ...operatorPayload,
+                address,
+                enr_signature: operatorENRSignature,
+                fork_version: this.fork_version
+            };
+            const clusterDefinition = await this.request(`/dv/${configHash}`, {
+                method: 'PUT',
+                body: JSON.stringify(operatorData),
+                headers: {
+                    Authorization: `Bearer ${operatorConfigSignature}`,
+                }
+            });
+            return clusterDefinition;
+        }
+        catch (err) {
+            throw err;
         }
     }
     /**

package/dist/schema.d.ts

@@ -0,0 +1,58 @@
+export declare const operatorPayloadSchema: {
+    type: string;
+    properties: {
+        version: {
+            type: string;
+        };
+        enr: {
+            type: string;
+        };
+    };
+    required: string[];
+};
+export declare const definitionSchema: {
+    type: string;
+    properties: {
+        name: {
+            type: string;
+        };
+        operators: {
+            type: string;
+            minItems: number;
+            uniqueItems: boolean;
+            items: {
+                type: string;
+                properties: {
+                    address: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                };
+                required: string[];
+            };
+        };
+        validators: {
+            type: string;
+            minItems: number;
+            items: {
+                type: string;
+                properties: {
+                    fee_recipient_address: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    withdrawal_address: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                };
+                required: string[];
+            };
+        };
+    };
+    required: string[];
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB;;;;;;;;;;;CAcjC,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqD5B,CAAA"}

package/dist/types.d.ts

@@ -28,6 +28,10 @@ export declare type ClusterOperator = {
     /** The operator configuration signature. */
     config_signature?: string;
 };
+/**
+ * A partial view of `ClusterOperator` with `enr` and `version` as required properties.
+ */
+export declare type OperatorPayload = Partial<ClusterOperator> & Required<Pick<ClusterOperator, 'enr' | 'version'>>;
 /**
  * Cluster Creator
  */

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@obolnetwork/obol-sdk",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "A package for creating Distributed Validators using the Obol API.",
   "main": "dist/index.js",
   "module": "dist/index.es.js",
@@ -20,7 +20,7 @@
     "generate-typedoc": "typedoc",
     "ds:release:major": "npm version $(semver $npm_package_version -i major) && npm publish --tag latest",
     "ds:release:minor": "npm version $(semver $npm_package_version -i minor) && npm publish --tag latest",
-    "ds:release:patch": "npm config list && npm version $(semver $npm_package_version -i patch) && npm publish --tag latest"
+    "ds:release:patch": "npm version $(semver $npm_package_version -i patch) && npm publish --tag latest"
   },
   "author": "Obol Labs (https://obol.tech)",
   "repository": {