@obolnetwork/obol-sdk 2.11.9 → 2.11.12

package/dist/types/src/splits/splits.d.ts

@@ -1,11 +1,32 @@
 import { type ClusterValidator, type ProviderType, type SignerType, type OVMRewardsSplitPayload, type OVMTotalSplitPayload, type OVMRequestWithdrawalPayload, type OVMDepositPayload } from '../types.js';
 /**
- * ObolSplits can be used for creating and managing Obol splits.
- * @class
- * @internal Access it through Client.splits.
+ * Deploys and manages Obol Validator Manager (OVM) and SplitV2 contracts
+ * for automated reward and principal splitting among cluster participants.
+ *
+ * Do not instantiate directly; access via `client.splits`.
+ *
+ * Available methods:
+ * - {@link ObolSplits.createValidatorManagerAndRewardsSplit} – rewards-only split (single principal recipient)
+ * - {@link ObolSplits.createValidatorManagerAndTotalSplit} – total split (principal also split)
+ * - {@link ObolSplits.requestWithdrawal} – request withdrawal from an OVM contract
+ * - {@link ObolSplits.deposit} – deposit to an OVM contract
+ *
+ * All write methods send on-chain transactions and require a signer with ETH for gas.
+ *
  * @example
- * const obolClient = new Client(config);
- * await obolClient.splits.createValidatorManagerAndRewardsSplit(OVMRewardsSplitPayload);
+ * ```typescript
+ * const client = new Client({ chainId: 560048 }, signer);
+ *
+ * const { withdrawal_address, fee_recipient_address } =
+ *   await client.splits.createValidatorManagerAndRewardsSplit({
+ *     rewardSplitRecipients: [
+ *       { address: "0xOp1...", percentAllocation: 50 },
+ *       { address: "0xOp2...", percentAllocation: 49 },
+ *     ],
+ *     principalRecipient: "0xPrincipal...",
+ *     OVMOwnerAddress: "0xOwner...",
+ *   });
+ * ```
  */
 export declare class ObolSplits {
     private readonly signer;
@@ -13,100 +34,110 @@ export declare class ObolSplits {
     readonly provider: ProviderType | undefined | null;
     constructor(signer: SignerType | undefined, chainId: number, provider: ProviderType | undefined | null);
     /**
-     * Creates an Obol OVM and Pull split configuration for rewards-only scenario.
+     * Deploys an OVM and SplitV2 contract for a **rewards-only** split scenario.
      *
-     * This method deploys OVM and SplitV2 contracts for managing validator rewards only.
-     * Principal is handled by a single address, while rewards are split among recipients.
+     * Principal goes to a single address; only validator rewards are split among
+     * the configured recipients. Automatically appends the Obol RAF recipient.
      *
-     * @remarks
-     * **⚠️ Important:**  If you're storing the private key in an `.env` file, ensure it is securely managed
-     * and not pushed to version control.
+     * - Sends one or more on-chain transactions (irreversible).
+     * - Only supported on chains with OVM factory contracts (Mainnet, Hoodi).
      *
-     * **📌 Note:** The Obol Validator Manager (OVM) feature is only enabled on Hoodi on launchpad.
+     * @param payload - Configuration for the OVM and SplitV2 deployment.
+     * @returns The OVM address as `withdrawal_address` and splitter as `fee_recipient_address`.
+     * @throws {SignerRequiredError} If no signer was provided.
+     * @throws {UnsupportedChainError} If the chain does not support splitters.
      *
-     * @param {OVMRewardsSplitPayload} payload - Data needed to deploy OVM and SplitV2
-     * @returns {Promise<ClusterValidator>} OVM address as withdrawal address and splitter as fee recipient
-     * @throws Will throw an error if the splitter configuration is not supported or deployment fails
-     *
-     * An example of how to use createValidatorManagerAndRewardsSplit:
-     * [createValidatorManagerAndRewardsSplit](https://github.com/ObolNetwork/obol-sdk-examples/blob/main/TS-Example/index.ts#L333)
+     * @example
+     * ```typescript
+     * const { withdrawal_address, fee_recipient_address } =
+     *   await client.splits.createValidatorManagerAndRewardsSplit({
+     *     rewardSplitRecipients: [
+     *       { address: "0xOp1...", percentAllocation: 50 },
+     *       { address: "0xOp2...", percentAllocation: 49 },
+     *     ],
+     *     principalRecipient: "0xPrincipal...",
+     *     OVMOwnerAddress: "0xOwner...",
+     *   });
+     * ```
      */
     createValidatorManagerAndRewardsSplit(payload: OVMRewardsSplitPayload): Promise<ClusterValidator>;
     /**
-     * Creates an Obol OVM and Total split configuration for total split scenario.
+     * Deploys an OVM and SplitV2 contract for a **total split** scenario.
      *
-     * This method deploys OVM and SplitV2 contracts for managing both validator rewards and principal.
-     * Both rewards and principal are split among recipients, with rewards including RAF recipient.
+     * Both principal and rewards are split among recipients via separate SplitV2
+     * contracts. Automatically appends the Obol RAF recipient to rewards.
      *
-     * @remarks
-     * **⚠️ Important:**  If you're storing the private key in an `.env` file, ensure it is securely managed
-     * and not pushed to version control.
+     * - Sends one or more on-chain transactions (irreversible).
+     * - Only supported on chains with OVM factory contracts (Mainnet, Hoodi).
      *
-     * **📌 Note:** The Obol Validator Manager (OVM) feature is only enabled on Hoodi on launchpad.
+     * @param payload - Configuration for the OVM and SplitV2 deployment.
+     * @returns The OVM address as `withdrawal_address` and rewards splitter as `fee_recipient_address`.
+     * @throws {SignerRequiredError} If no signer was provided.
+     * @throws {UnsupportedChainError} If the chain does not support splitters.
      *
-     * @param {OVMTotalSplitPayload} payload - Data needed to deploy OVM and SplitV2
-     * @returns {Promise<ClusterValidator>} OVM address as withdrawal address and splitter as fee recipient
-     * @throws Will throw an error if the splitter configuration is not supported or deployment fails
-     *
-     * An example of how to use createValidatorManagerAndTotalSplit:
-     * [createValidatorManagerAndTotalSplit](https://github.com/ObolNetwork/obol-sdk-examples/blob/main/TS-Example/index.ts#340)
+     * @example
+     * ```typescript
+     * const { withdrawal_address, fee_recipient_address } =
+     *   await client.splits.createValidatorManagerAndTotalSplit({
+     *     rewardSplitRecipients: [
+     *       { address: "0xOp1...", percentAllocation: 50 },
+     *       { address: "0xOp2...", percentAllocation: 49 },
+     *     ],
+     *     principalSplitRecipients: [
+     *       { address: "0xOp1...", percentAllocation: 50 },
+     *       { address: "0xOp2...", percentAllocation: 50 },
+     *     ],
+     *     OVMOwnerAddress: "0xOwner...",
+     *   });
+     * ```
      */
     createValidatorManagerAndTotalSplit(payload: OVMTotalSplitPayload): Promise<ClusterValidator>;
     /**
-     * Requests withdrawal from an OVM contract.
-     *
-     * This method allows requesting withdrawal of validator funds from an OVM contract.
-     * The withdrawal request includes OVM address, validator public keys and corresponding withdrawal amounts.
+     * Requests withdrawal of validator funds from an OVM contract.
      *
-     * @remarks
-     * **⚠️ Important:**  If you're storing the private key in an `.env` file, ensure it is securely managed
-     * and not pushed to version control.
+     * Sends an on-chain transaction to the OVM contract requesting withdrawal
+     * for the specified validator public keys and amounts.
      *
-     * @param {OVMRequestWithdrawalPayload} payload - Data needed to request withdrawal
-     * @returns {Promise<{txHash: string}>} Transaction hash of the withdrawal request
-     * @throws Will throw an error if the signer is not provided, OVM address is invalid, or the request fails
+     * @param payload - Withdrawal request data including OVM address, validator
+     *   public keys, amounts, and fees.
+     * @returns The transaction hash of the withdrawal request.
+     * @throws {SignerRequiredError} If no signer was provided.
      *
-     * An example of how to use requestWithdrawal:
+     * @example
      * ```typescript
-     * const result = await client.splits.requestWithdrawal({
-     *   ovmAddress: '0x1234567890123456789012345678901234567890',
-     *   pubKeys: ['0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456'],
-     *   amounts: ['32000000000'], // 32 ETH in gwei
-     *   withdrawalFees: '1000000000000000' // Total fees in wei
+     * const { txHash } = await client.splits.requestWithdrawal({
+     *   ovmAddress: "0xOVM...",
+     *   pubKeys: ["0xValidatorPubkey..."],
+     *   amounts: ["32000000000"],
+     *   withdrawalFees: "1000000000000000",
      * });
-     * console.log('Withdrawal requested:', result.txHash);
      * ```
      */
     requestWithdrawal(payload: OVMRequestWithdrawalPayload): Promise<{
         txHash: string;
     }>;
     /**
-     * Deposits to OVM contract by sending individual transactions for each deposit.
-     *
-     * This method allows depositing to an OVM contract. Each deposit is sent as a separate transaction
-     * Each deposit includes validator public key, withdrawal credentials, signature, deposit data root, and amount.
-     *
-     * @remarks
-     * **⚠️ Important:**  If you're storing the private key in an `.env` file, ensure it is securely managed
-     * and not pushed to version control.
+     * Deposits validators to an OVM contract. Each deposit is sent as a separate
+     * on-chain transaction.
      *
-     * @param {OVMDepositPayload} payload - Data needed to deposit to OVM
-     * @returns {Promise<{txHashes: string[]}>} Array of transaction hashes, one for each deposit
-     * @throws Will throw an error if the signer is not provided, OVM address is invalid, or the deposit fails
+     * @param payload - Deposit data including the OVM address and an array of
+     *   validator deposit objects (pubkey, withdrawal_credentials, signature,
+     *   deposit_data_root, amount).
+     * @returns An array of transaction hashes, one per deposit.
+     * @throws {SignerRequiredError} If no signer was provided.
      *
-     * An example of how to use deposit:
+     * @example
      * ```typescript
-     * const result = await client.splits.deposit({
-     *   ovmAddress: '0x1234567890123456789012345678901234567890',
+     * const { txHashes } = await client.splits.deposit({
+     *   ovmAddress: "0xOVM...",
      *   deposits: [{
-     *     pubkey: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
-     *     withdrawal_credentials: '0x1234567890123456789012345678901234567890',
-     *     signature: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
-     *     deposit_data_root: '0x1234567890123456789012345678901234567890123456789012345678901234',
-     *     amount: '32000000000000000000' // 32 ETH in wei
-     *   }]
+     *     pubkey: "0x...",
+     *     withdrawal_credentials: "0x...",
+     *     signature: "0x...",
+     *     deposit_data_root: "0x...",
+     *     amount: "32000000000000000000",
+     *   }],
      * });
-     * console.log('Deposits completed:', result.txHashes);
      * ```
      */
     deposit(payload: OVMDepositPayload): Promise<{

package/dist/types/src/types.d.ts

@@ -1,16 +1,18 @@
 import { type Wallet, type ethers, type JsonRpcApiProvider, type JsonRpcProvider, type JsonRpcSigner, type Provider } from 'ethers';
 /**
- * Permitted ChainID's
+ * Maps Ethereum consensus-layer fork versions (hex) to execution-layer chain IDs.
+ *
+ * Supported networks:
+ * - `0x00000000` → 1 (Mainnet)
+ * - `0x00000064` → 100 (Gnosis Chain)
+ * - `0x90000069` → 11155111 (Sepolia)
+ * - `0x10000910` → 560048 (Hoodi)
  */
 export declare enum FORK_MAPPING {
     /** Mainnet. */
     '0x00000000' = 1,
-    /** Goerli/Prater. */
-    '0x00001020' = 5,
     /** Gnosis Chain. */
     '0x00000064' = 100,
-    /** Holesky. */
-    '0x01017000' = 17000,
     /** Sepolia. */
     '0x90000069' = 11155111,
     /** Hoodi Chain. */
@@ -18,7 +20,11 @@ export declare enum FORK_MAPPING {
 }
 export declare const FORK_NAMES: Record<number, string>;
 /**
- * Node operator data
+ * Represents a node operator in a distributed validator cluster.
+ *
+ * When creating a cluster definition via {@link Client.createClusterDefinition},
+ * only `address` is required. The remaining fields are populated during the
+ * cluster acceptance and DKG process.
  */
 export type ClusterOperator = {
     /** The operator address. */
@@ -35,7 +41,11 @@ export type ClusterOperator = {
     config_signature?: string;
 };
 /**
- * A partial view of `ClusterOperator` with `enr` and `version` as required properties.
+ * Payload an operator provides when joining a cluster via
+ * {@link Client.acceptClusterDefinition}.
+ *
+ * Requires at minimum `enr` (Ethereum Node Record) and `version`.
+ * Other `ClusterOperator` fields are optional overrides.
  */
 export type OperatorPayload = Partial<ClusterOperator> & Required<Pick<ClusterOperator, 'enr' | 'version'>>;
 /**
@@ -57,7 +67,11 @@ export type ClusterValidator = {
     withdrawal_address: string;
 };
 /**
- * Cluster configuration
+ * Input payload for creating a new cluster definition via
+ * {@link Client.createClusterDefinition}.
+ *
+ * Required fields: `name`, `operators`, `validators`.
+ * Optional fields have sensible defaults applied by the SDK.
  */
 export type ClusterPayload = {
     /** The cluster name. */
@@ -76,7 +90,11 @@ export type ClusterPayload = {
     consensus_protocol?: string;
 };
 /**
- * Cluster definition data needed for dkg
+ * Full cluster definition as stored by the Obol API. Extends {@link ClusterPayload}
+ * with server-generated metadata (uuid, timestamp, config_hash, etc.).
+ *
+ * Returned by {@link Client.createClusterDefinition},
+ * {@link Client.acceptClusterDefinition}, and {@link Client.getClusterDefinition}.
  */
 export interface ClusterDefinition extends ClusterPayload {
     /** The creator of the cluster. */
@@ -107,7 +125,8 @@ export interface ClusterDefinition extends ClusterPayload {
     compounding?: boolean;
 }
 /**
- * Split Recipient Keys
+ * A recipient in a V1 splitter contract configuration.
+ * Used with {@link Client.createObolRewardsSplit} and {@link Client.createObolTotalSplit}.
  */
 export type SplitRecipient = {
     /** The split recipient address. */
@@ -116,7 +135,8 @@ export type SplitRecipient = {
     percentAllocation: number;
 };
 /**
- * Split Proxy Params
+ * Input payload for {@link Client.createObolTotalSplit}.
+ * Deploys a splitter that splits **both principal and rewards**.
  */
 export type TotalSplitPayload = {
     /** The split recipients addresses and splits. */
@@ -129,7 +149,8 @@ export type TotalSplitPayload = {
     controllerAddress?: string;
 };
 /**
- * OWR and Split Proxy Params
+ * Input payload for {@link Client.createObolRewardsSplit}.
+ * Deploys an OWR (principal goes to one address) and a splitter (rewards split among recipients).
  */
 export interface RewardsSplitPayload extends TotalSplitPayload {
     /** Address that will reclaim validator principal after exit. */
@@ -140,7 +161,9 @@ export interface RewardsSplitPayload extends TotalSplitPayload {
     recoveryAddress?: string;
 }
 /**
- * OVM and SplitV2 Base Params
+ * Base parameters shared by both OVM split scenarios (rewards-only and total split).
+ * Used with {@link ObolSplits.createValidatorManagerAndRewardsSplit} and
+ * {@link ObolSplits.createValidatorManagerAndTotalSplit}.
  */
 export type OVMBaseSplitPayload = {
     /** The split recipients addresses and splits. */
@@ -155,21 +178,25 @@ export type OVMBaseSplitPayload = {
     distributorFeePercent?: number;
 };
 /**
- * OVM and SplitV2 Params for rewards-only split
+ * Input payload for {@link ObolSplits.createValidatorManagerAndRewardsSplit}.
+ * Principal goes to a single address; rewards are split among recipients.
  */
 export type OVMRewardsSplitPayload = OVMBaseSplitPayload & {
     /** Principal recipient address (single address for rewards-only split). */
     principalRecipient: string;
 };
 /**
- * OVM and SplitV2 Params for total split scenario
+ * Input payload for {@link ObolSplits.createValidatorManagerAndTotalSplit}.
+ * Both principal and rewards are split among recipients.
  */
 export type OVMTotalSplitPayload = OVMBaseSplitPayload & {
     /** Principal recipients addresses and splits (array for total split scenario). */
     principalSplitRecipients: SplitV2Recipient[];
 };
 /**
- * Union type for both OVM split scenarios
+ * Union type covering both OVM split scenarios.
+ * Discriminate by checking for `principalRecipient` (rewards-only) vs
+ * `principalSplitRecipients` (total split).
  */
 export type OVMSplitPayload = OVMRewardsSplitPayload | OVMTotalSplitPayload;
 /**
@@ -230,7 +257,8 @@ export type DepositData = {
     signature: string;
 };
 /**
- * Required deposit data for validator activation
+ * A distributed validator within a cluster lock.
+ * Contains the aggregate public key, per-operator public shares, and deposit data.
  */
 export type DistributedValidator = {
     /** The public key of the distributed validator. */
@@ -245,7 +273,12 @@ export type DistributedValidator = {
     builder_registration?: BuilderRegistration;
 };
 /**
- * Cluster Details after DKG is complete
+ * Cluster lock – the finalized cluster state after a successful DKG ceremony.
+ *
+ * Contains the distributed validators with their public key shares and deposit data,
+ * plus the aggregated BLS signature.
+ *
+ * Returned by {@link Client.getClusterLock} and {@link Client.getClusterLockByHash}.
  */
 export type ClusterLock = {
     /** The cluster definition. */
@@ -275,11 +308,12 @@ export type ClaimableIncentives = {
     contract_address: string;
 };
 /**
- * String expected to be Ethereum Address
+ * A string expected to be a checksummed or lowercase Ethereum address (e.g. `"0xAbC...123"`).
  */
 export type ETH_ADDRESS = string;
 /**
- * Provider Types
+ * Accepted ethers provider types for on-chain reads.
+ * Pass any of these as the third argument to `new Client(config, signer, provider)`.
  */
 export type ProviderType = Provider | JsonRpcProvider | JsonRpcApiProvider | ethers.BrowserProvider;
 /**
@@ -287,7 +321,8 @@ export type ProviderType = Provider | JsonRpcProvider | JsonRpcApiProvider | eth
  */
 export type SafeRpcUrl = string;
 /**
- * Signer Types
+ * Accepted ethers signer types for signing transactions and EIP-712 messages.
+ * Pass as the second argument to `new Client(config, signer)`.
  */
 export type SignerType = JsonRpcSigner | Wallet;
 /**
@@ -479,7 +514,8 @@ export type ChainConfig = {
     };
 };
 /**
- * Payload for requesting withdrawal from OVM contract
+ * Input payload for {@link ObolSplits.requestWithdrawal}.
+ * Requests withdrawal of validator funds from an OVM contract.
  */
 export type OVMRequestWithdrawalPayload = {
     /** request withdrawal fees in wei */
@@ -492,7 +528,7 @@ export type OVMRequestWithdrawalPayload = {
     amounts: string[];
 };
 /**
- * Payload for requesting withdrawal from EOA contract
+ * Input payload for {@link EOA.requestWithdrawal}.
  */
 export type EOAWithdrawalPayload = {
     /** Validator public key in hex format */
@@ -503,7 +539,8 @@ export type EOAWithdrawalPayload = {
     requiredFee: string;
 };
 /**
- * Payload for depositing to OVM contract with multicall3
+ * Input payload for {@link ObolSplits.deposit}.
+ * Deposits one or more validators to an OVM contract.
  */
 export type OVMDepositPayload = {
     /** OVM contract address */
@@ -523,7 +560,8 @@ export type OVMDepositPayload = {
     }>;
 };
 /**
- * Payload for depositing to batch deposit contract
+ * Input payload for {@link EOA.deposit}.
+ * Batch-deposits validators to the beacon chain via the Pier Two batch deposit contract.
  */
 export type EOADepositPayload = {
     /** Array of deposit objects */

package/dist/types/test/fixtures.d.ts

@@ -9,7 +9,7 @@ export declare const TEST_ADDRESSES: {
     readonly ZERO_ADDRESS: string;
 };
 export declare const enr = "enr:-HW4QLlrtMjFLGkFT1bwdGbvZQlH8hLi0M2g44JAxEYP3BZmYpcsy9Q56HPPD87fMucjvLv4-obEFacpsg0ehRilbHeAgmlkgnY0iXNlY3AyNTZrMaEDRaa5o2aSgqyFq_ERZcQTztrOij1mFtXX1bJuVI6ieak";
-export declare const clusterLockV1X6: {
+export declare const clusterLockSoloV1X10: {
     cluster_definition: {
         name: string;
         creator: {
@@ -33,68 +33,23 @@ export declare const clusterLockV1X6: {
         }[];
         dkg_algorithm: string;
         fork_version: string;
+        deposit_amounts: string[];
         config_hash: string;
         definition_hash: string;
+        consensus_protocol: string;
+        target_gas_limit: number;
+        compounding: boolean;
     };
     distributed_validators: {
         distributed_public_key: string;
         public_shares: string[];
-        deposit_data: {
+        partial_deposit_data: {
             pubkey: string;
             withdrawal_credentials: string;
             amount: string;
             signature: string;
-        };
-    }[];
-    signature_aggregate: string;
-    lock_hash: string;
-};
-export declare const clusterConfigV1X7: {
-    name: string;
-    operators: {
-        address: string;
-    }[];
-    validators: {
-        fee_recipient_address: string;
-        withdrawal_address: string;
-    }[];
-};
-export declare const clusterLockV1X7: {
-    cluster_definition: {
-        name: string;
-        creator: {
-            address: string;
-            config_signature: string;
-        };
-        operators: {
-            address: string;
-            enr: string;
-            config_signature: string;
-            enr_signature: string;
-        }[];
-        uuid: string;
-        version: string;
-        timestamp: string;
-        num_validators: number;
-        threshold: number;
-        validators: {
-            fee_recipient_address: string;
-            withdrawal_address: string;
+            deposit_data_root: string;
         }[];
-        dkg_algorithm: string;
-        fork_version: string;
-        config_hash: string;
-        definition_hash: string;
-    };
-    distributed_validators: {
-        distributed_public_key: string;
-        public_shares: string[];
-        deposit_data: {
-            pubkey: string;
-            withdrawal_credentials: string;
-            amount: string;
-            signature: string;
-        };
         builder_registration: {
             message: {
                 fee_recipient: string;
@@ -109,57 +64,6 @@ export declare const clusterLockV1X7: {
     lock_hash: string;
     node_signatures: string[];
 };
-export declare const clusterLockV1X8: {
-    cluster_definition: {
-        name: string;
-        creator: {
-            address: string;
-            config_signature: string;
-        };
-        operators: {
-            address: string;
-            enr: string;
-            config_signature: string;
-            enr_signature: string;
-        }[];
-        uuid: string;
-        version: string;
-        timestamp: string;
-        num_validators: number;
-        threshold: number;
-        validators: {
-            fee_recipient_address: string;
-            withdrawal_address: string;
-        }[];
-        dkg_algorithm: string;
-        fork_version: string;
-        deposit_amounts: string[];
-        config_hash: string;
-        definition_hash: string;
-    };
-    distributed_validators: {
-        distributed_public_key: string;
-        public_shares: string[];
-        builder_registration: {
-            message: {
-                fee_recipient: string;
-                gas_limit: number;
-                timestamp: number;
-                pubkey: string;
-            };
-            signature: string;
-        };
-        partial_deposit_data: {
-            pubkey: string;
-            withdrawal_credentials: string;
-            amount: string;
-            signature: string;
-        }[];
-    }[];
-    signature_aggregate: string;
-    lock_hash: string;
-    node_signatures: string[];
-};
 export declare const nullDepositAmountsClusterLockV1X8: {
     cluster_definition: {
         name: string;
@@ -235,7 +139,10 @@ export declare const clusterLockWithSafe: {
         }[];
         dkg_algorithm: string;
         fork_version: string;
-        deposit_amounts: string[];
+        deposit_amounts: null;
+        consensus_protocol: string;
+        target_gas_limit: number;
+        compounding: boolean;
         config_hash: string;
         definition_hash: string;
     };
@@ -310,16 +217,23 @@ export declare const clusterLockV1X10: {
         }[];
         dkg_algorithm: string;
         fork_version: string;
-        deposit_amounts: null;
+        deposit_amounts: string[];
+        config_hash: string;
+        definition_hash: string;
         consensus_protocol: string;
         target_gas_limit: number;
         compounding: boolean;
-        config_hash: string;
-        definition_hash: string;
     };
     distributed_validators: {
         distributed_public_key: string;
         public_shares: string[];
+        partial_deposit_data: {
+            pubkey: string;
+            withdrawal_credentials: string;
+            amount: string;
+            signature: string;
+            deposit_data_root: string;
+        }[];
         builder_registration: {
             message: {
                 fee_recipient: string;
@@ -329,12 +243,6 @@ export declare const clusterLockV1X10: {
             };
             signature: string;
         };
-        partial_deposit_data: {
-            pubkey: string;
-            withdrawal_credentials: string;
-            amount: string;
-            signature: string;
-        }[];
     }[];
     signature_aggregate: string;
     lock_hash: string;
@@ -364,16 +272,23 @@ export declare const clusterLockWithCompoundingWithdrawals: {
         }[];
         dkg_algorithm: string;
         fork_version: string;
-        deposit_amounts: null;
+        deposit_amounts: string[];
+        config_hash: string;
+        definition_hash: string;
         consensus_protocol: string;
         target_gas_limit: number;
         compounding: boolean;
-        config_hash: string;
-        definition_hash: string;
     };
     distributed_validators: {
         distributed_public_key: string;
         public_shares: string[];
+        partial_deposit_data: {
+            pubkey: string;
+            withdrawal_credentials: string;
+            amount: string;
+            signature: string;
+            deposit_data_root: string;
+        }[];
         builder_registration: {
             message: {
                 fee_recipient: string;
@@ -383,12 +298,6 @@ export declare const clusterLockWithCompoundingWithdrawals: {
             };
             signature: string;
         };
-        partial_deposit_data: {
-            pubkey: string;
-            withdrawal_credentials: string;
-            amount: string;
-            signature: string;
-        }[];
     }[];
     signature_aggregate: string;
     lock_hash: string;