@obolnetwork/obol-sdk 1.0.16 → 2.0.0

package/src/verification/v1.7.0.ts

@@ -1,32 +1,62 @@
-import { type UintNumberByteLen, UintNumberType } from '@chainsafe/ssz/lib/type/uint'
-import { strToUint8Array } from '../utils'
-import { builderRegistrationContainer, type creatorAddressWrapperType, type creatorContainerType, depositDataContainer, newCreatorContainerType, newOperatorContainerType, type operatorAddressWrapperType, type operatorContainerType, validatorsContainerType } from './sszTypes'
-import { ByteListType, ByteVectorType, ContainerType, ListCompositeType, fromHexString } from '@chainsafe/ssz'
-import { type ValueOfFields } from '@chainsafe/ssz/lib/view/container'
-import { type ClusterDefinition, type ClusterLock, type DepositData } from '../types'
-import { verifyBuilderRegistration, verifyDepositData, verifyNodeSignatures } from './common'
-import { aggregateSignatures, verifyAggregate, verifyMultiple } from '@chainsafe/bls'
-
-// cluster defintion
+import {
+  type UintNumberByteLen,
+  UintNumberType,
+} from '@chainsafe/ssz/lib/type/uint';
+import { strToUint8Array } from '../utils';
+import {
+  builderRegistrationContainer,
+  type creatorAddressWrapperType,
+  type creatorContainerType,
+  depositDataContainer,
+  newCreatorContainerType,
+  newOperatorContainerType,
+  type operatorAddressWrapperType,
+  type operatorContainerType,
+  validatorsContainerType,
+} from './sszTypes';
+import {
+  ByteListType,
+  ByteVectorType,
+  ContainerType,
+  ListCompositeType,
+  fromHexString,
+} from '@chainsafe/ssz';
+import { type ValueOfFields } from '@chainsafe/ssz/lib/view/container';
+import {
+  type ClusterDefinition,
+  type ClusterLock,
+  type DepositData,
+} from '../types';
+import {
+  verifyBuilderRegistration,
+  verifyDepositData,
+  verifyNodeSignatures,
+} from './common';
+import {
+  aggregateSignatures,
+  verifyAggregate,
+  verifyMultiple,
+} from '@chainsafe/bls';
+
+// cluster definition
 type DefinitionFieldsV1X7 = {
-    uuid: ByteListType
-    name: ByteListType
-    version: ByteListType
-    timestamp: ByteListType
-    num_validators: UintNumberType
-    threshold: UintNumberType
-    dkg_algorithm: ByteListType
-    fork_version: ByteVectorType
-    operators: ListCompositeType<
-        typeof operatorContainerType | typeof operatorAddressWrapperType
-    >
-    creator: typeof creatorContainerType | typeof creatorAddressWrapperType
-    validators: ListCompositeType<typeof validatorsContainerType>
-    config_hash?: ByteVectorType
-}
-
-type DefinitionContainerTypeV1X7 =
-    ContainerType<DefinitionFieldsV1X7>
+  uuid: ByteListType;
+  name: ByteListType;
+  version: ByteListType;
+  timestamp: ByteListType;
+  num_validators: UintNumberType;
+  threshold: UintNumberType;
+  dkg_algorithm: ByteListType;
+  fork_version: ByteVectorType;
+  operators: ListCompositeType<
+    typeof operatorContainerType | typeof operatorAddressWrapperType
+  >;
+  creator: typeof creatorContainerType | typeof creatorAddressWrapperType;
+  validators: ListCompositeType<typeof validatorsContainerType>;
+  config_hash?: ByteVectorType;
+};
+
+type DefinitionContainerTypeV1X7 = ContainerType<DefinitionFieldsV1X7>;
 
 /**
  * Returns the containerized cluster definition
@@ -34,241 +64,246 @@ type DefinitionContainerTypeV1X7 =
  * @returns SSZ Containerized type of cluster input
  */
 export const clusterDefinitionContainerTypeV1X7 = (
-    configOnly: boolean,
+  configOnly: boolean,
 ): DefinitionContainerTypeV1X7 => {
-    let returnedContainerType: any = {
-        uuid: new ByteListType(64),
-        name: new ByteListType(256),
-        version: new ByteListType(16),
-        timestamp: new ByteListType(32),
-        num_validators: new UintNumberType(8 as UintNumberByteLen),
-        threshold: new UintNumberType(8 as UintNumberByteLen),
-        dkg_algorithm: new ByteListType(32),
-        fork_version: new ByteVectorType(4),
-        operators: new ListCompositeType(newOperatorContainerType(configOnly), 256),
-        creator: newCreatorContainerType(configOnly),
-        validators: new ListCompositeType(validatorsContainerType, 65536),
-    }
-
-    if (!configOnly) {
-        returnedContainerType = {
-            ...returnedContainerType,
-            config_hash: new ByteVectorType(32),
-        }
-    }
-
-    return new ContainerType(returnedContainerType)
-}
+  let returnedContainerType: any = {
+    uuid: new ByteListType(64),
+    name: new ByteListType(256),
+    version: new ByteListType(16),
+    timestamp: new ByteListType(32),
+    num_validators: new UintNumberType(8 as UintNumberByteLen),
+    threshold: new UintNumberType(8 as UintNumberByteLen),
+    dkg_algorithm: new ByteListType(32),
+    fork_version: new ByteVectorType(4),
+    operators: new ListCompositeType(newOperatorContainerType(configOnly), 256),
+    creator: newCreatorContainerType(configOnly),
+    validators: new ListCompositeType(validatorsContainerType, 65536),
+  };
+
+  if (!configOnly) {
+    returnedContainerType = {
+      ...returnedContainerType,
+      config_hash: new ByteVectorType(32),
+    };
+  }
+
+  return new ContainerType(returnedContainerType);
+};
 
 export const hashClusterDefinitionV1X7 = (
-    cluster: ClusterDefinition,
-    configOnly: boolean,
+  cluster: ClusterDefinition,
+  configOnly: boolean,
 ): ValueOfFields<DefinitionFieldsV1X7> => {
-    const definitionType = clusterDefinitionContainerTypeV1X7(configOnly)
-
-    const val = definitionType.defaultValue()
-
-    // order should be same as charon https://github.com/ObolNetwork/charon/blob/main/cluster/ssz.go#L276
-    val.uuid = strToUint8Array(cluster.uuid)
-    val.name = strToUint8Array(cluster.name)
-    val.version = strToUint8Array(cluster.version)
-    val.timestamp = strToUint8Array(cluster.timestamp)
-    val.num_validators = cluster.num_validators
-    val.threshold = cluster.threshold
-    val.dkg_algorithm = strToUint8Array(cluster.dkg_algorithm)
-    val.fork_version = fromHexString(cluster.fork_version)
-    val.operators = cluster.operators.map(operator => {
-        return configOnly
-            ? { address: fromHexString(operator.address) }
-            : {
-                address: fromHexString(operator.address),
-                enr: strToUint8Array(operator.enr as string),
-                config_signature: fromHexString(operator.config_signature as string),
-                enr_signature: fromHexString(operator.enr_signature as string),
-            }
-    })
-    val.creator = configOnly
-        ? { address: fromHexString(cluster.creator.address) }
-        : {
-            address: fromHexString(cluster.creator.address),
-            config_signature: fromHexString(cluster.creator.config_signature as string),
-        }
-    val.validators = cluster.validators.map((validator) => {
-        return {
-            fee_recipient_address: fromHexString(validator.fee_recipient_address),
-            withdrawal_address: fromHexString(validator.withdrawal_address),
-        }
-    })
-
-    if (!configOnly) {
-        val.config_hash = fromHexString(cluster.config_hash)
-    }
-    return val
-}
+  const definitionType = clusterDefinitionContainerTypeV1X7(configOnly);
+
+  const val = definitionType.defaultValue();
+
+  // order should be same as charon https://github.com/ObolNetwork/charon/blob/main/cluster/ssz.go#L276
+  val.uuid = strToUint8Array(cluster.uuid);
+  val.name = strToUint8Array(cluster.name);
+  val.version = strToUint8Array(cluster.version);
+  val.timestamp = strToUint8Array(cluster.timestamp);
+  val.num_validators = cluster.num_validators;
+  val.threshold = cluster.threshold;
+  val.dkg_algorithm = strToUint8Array(cluster.dkg_algorithm);
+  val.fork_version = fromHexString(cluster.fork_version);
+  val.operators = cluster.operators.map(operator => {
+    return configOnly
+      ? { address: fromHexString(operator.address) }
+      : {
+          address: fromHexString(operator.address),
+          enr: strToUint8Array(operator.enr as string),
+          config_signature: fromHexString(operator.config_signature as string),
+          enr_signature: fromHexString(operator.enr_signature as string),
+        };
+  });
+  val.creator = configOnly
+    ? { address: fromHexString(cluster.creator.address) }
+    : {
+        address: fromHexString(cluster.creator.address),
+        config_signature: fromHexString(
+          cluster.creator.config_signature as string,
+        ),
+      };
+  val.validators = cluster.validators.map(validator => {
+    return {
+      fee_recipient_address: fromHexString(validator.fee_recipient_address),
+      withdrawal_address: fromHexString(validator.withdrawal_address),
+    };
+  });
+
+  if (!configOnly) {
+    val.config_hash = fromHexString(cluster.config_hash);
+  }
+  return val;
+};
 
 // cluster lock
 
 const dvContainerTypeV1X7 = new ContainerType({
-    distributed_public_key: new ByteVectorType(48),
-    public_shares: new ListCompositeType(new ByteVectorType(48), 256),
-    deposit_data: depositDataContainer,
-    builder_registration: builderRegistrationContainer,
-})
+  distributed_public_key: new ByteVectorType(48),
+  public_shares: new ListCompositeType(new ByteVectorType(48), 256),
+  deposit_data: depositDataContainer,
+  builder_registration: builderRegistrationContainer,
+});
 
 type LockContainerTypeV1X7 = ContainerType<{
-    cluster_definition: DefinitionContainerTypeV1X7
-    distributed_validators: ListCompositeType<typeof dvContainerTypeV1X7>
-}>
+  cluster_definition: DefinitionContainerTypeV1X7;
+  distributed_validators: ListCompositeType<typeof dvContainerTypeV1X7>;
+}>;
 
 /**
  * @returns SSZ Containerized type of cluster lock
  */
 const clusterLockContainerTypeV1X7 = (): LockContainerTypeV1X7 => {
-    return new ContainerType({
-        cluster_definition: clusterDefinitionContainerTypeV1X7(false),
-        distributed_validators: new ListCompositeType(dvContainerTypeV1X7, 65536),
-    })
-}
+  return new ContainerType({
+    cluster_definition: clusterDefinitionContainerTypeV1X7(false),
+    distributed_validators: new ListCompositeType(dvContainerTypeV1X7, 65536),
+  });
+};
 
 /**
  * @param cluster The published cluster lock
  * @returns The lock hash in of the corresponding cluster
  */
 export const hashClusterLockV1X7 = (cluster: ClusterLock): string => {
-    const lockType = clusterLockContainerTypeV1X7()
-
-    const val = lockType.defaultValue()
-
-    // Check if we can replace with definition_hash
-    val.cluster_definition = hashClusterDefinitionV1X7(
-        cluster.cluster_definition,
-        false,
-    )
-    val.distributed_validators = cluster.distributed_validators.map(
-        (dValidator) => {
-            return {
-                distributed_public_key: fromHexString(dValidator.distributed_public_key),
-                public_shares: dValidator.public_shares.map((publicShare) =>
-                    fromHexString(publicShare),
-                ),
-                deposit_data: {
-                    pubkey: fromHexString(dValidator.deposit_data?.pubkey as string),
-                    withdrawal_credentials: fromHexString(
-                        dValidator.deposit_data?.withdrawal_credentials as string,
-                    ),
-                    amount: parseInt(dValidator.deposit_data?.amount as string),
-                    signature: fromHexString(dValidator.deposit_data?.signature as string),
-                },
-                builder_registration: {
-                    message: {
-                        fee_recipient: fromHexString(
-                            dValidator.builder_registration?.message.fee_recipient as string,
-                        ),
-                        gas_limit: dValidator.builder_registration?.message.gas_limit as number,
-                        timestamp: dValidator.builder_registration?.message.timestamp as number,
-                        pubkey: fromHexString(
-                            dValidator.builder_registration?.message.pubkey as string,
-                        ),
-                    },
-                    signature: fromHexString(dValidator.builder_registration?.signature as string),
-                },
-            }
+  const lockType = clusterLockContainerTypeV1X7();
+
+  const val = lockType.defaultValue();
+
+  // Check if we can replace with definition_hash
+  val.cluster_definition = hashClusterDefinitionV1X7(
+    cluster.cluster_definition,
+    false,
+  );
+  val.distributed_validators = cluster.distributed_validators.map(
+    dValidator => {
+      return {
+        distributed_public_key: fromHexString(
+          dValidator.distributed_public_key,
+        ),
+        public_shares: dValidator.public_shares.map(publicShare =>
+          fromHexString(publicShare),
+        ),
+        deposit_data: {
+          pubkey: fromHexString(dValidator.deposit_data?.pubkey as string),
+          withdrawal_credentials: fromHexString(
+            dValidator.deposit_data?.withdrawal_credentials as string,
+          ),
+          amount: parseInt(dValidator.deposit_data?.amount as string),
+          signature: fromHexString(
+            dValidator.deposit_data?.signature as string,
+          ),
         },
-    )
+        builder_registration: {
+          message: {
+            fee_recipient: fromHexString(
+              dValidator.builder_registration?.message.fee_recipient as string,
+            ),
+            gas_limit: dValidator.builder_registration?.message
+              .gas_limit as number,
+            timestamp: dValidator.builder_registration?.message
+              .timestamp as number,
+            pubkey: fromHexString(
+              dValidator.builder_registration?.message.pubkey as string,
+            ),
+          },
+          signature: fromHexString(
+            dValidator.builder_registration?.signature as string,
+          ),
+        },
+      };
+    },
+  );
 
-    return '0x' + Buffer.from(lockType.hashTreeRoot(val).buffer).toString('hex')
-}
+  return '0x' + Buffer.from(lockType.hashTreeRoot(val).buffer).toString('hex');
+};
 
 // DV verification
 export const verifyDVV1X7 = (clusterLock: ClusterLock): boolean => {
-    const validators = clusterLock.distributed_validators
-
-    const pubShares = []
-
-    const pubKeys = []
-    const builderRegistrationAndDepositDataMessages = []
-    const blsSignatures = []
-
-    for (let i = 0; i < validators.length; i++) {
-        const validator = validators[i]
-        const validatorPublicShares = validator.public_shares
-        const distributedPublicKey = validator.distributed_public_key
-
-        // Needed in signature_aggregate verification
-        for (const element of validatorPublicShares) {
-            pubShares.push(fromHexString(element))
-        }
-
-        // Deposit Data Verification
-        const { isValidDepositData, depositDataMsg } = verifyDepositData(
-            distributedPublicKey,
-            validator.deposit_data as Partial<DepositData>,
-            clusterLock.cluster_definition.validators[i].withdrawal_address,
-            clusterLock.cluster_definition.fork_version
-        )
-
-        if (
-            !isValidDepositData
-        ) {
-            return false
-        }
-
-        pubKeys.push(fromHexString(distributedPublicKey))
-        builderRegistrationAndDepositDataMessages.push(depositDataMsg)
-        blsSignatures.push(fromHexString(validator.deposit_data?.signature as string))
-
-        // Builder Registration Verification
-        const { isValidBuilderRegistration, builderRegistrationMsg } = verifyBuilderRegistration(
-            validator,
-            clusterLock.cluster_definition.validators[i].fee_recipient_address,
-            clusterLock.cluster_definition.fork_version
-        )
-
-        if (
-            !isValidBuilderRegistration
-        ) {
-            return false
-        }
-
-        pubKeys.push(fromHexString(distributedPublicKey))
-        builderRegistrationAndDepositDataMessages.push(builderRegistrationMsg)
-        blsSignatures.push(
-            fromHexString(validator.builder_registration?.signature as string),
-        )
-    }
+  const validators = clusterLock.distributed_validators;
+
+  const pubShares = [];
+
+  const pubKeys = [];
+  const builderRegistrationAndDepositDataMessages = [];
+  const blsSignatures = [];
+
+  for (let i = 0; i < validators.length; i++) {
+    const validator = validators[i];
+    const validatorPublicShares = validator.public_shares;
+    const distributedPublicKey = validator.distributed_public_key;
 
-    // BLS signatures verification
-    const aggregateBLSSignature = aggregateSignatures(blsSignatures)
-
-    if (
-        !verifyMultiple(
-            pubKeys,
-            builderRegistrationAndDepositDataMessages,
-            aggregateBLSSignature,
-        )
-    ) {
-        return false
+    // Needed in signature_aggregate verification
+    for (const element of validatorPublicShares) {
+      pubShares.push(fromHexString(element));
     }
 
-    // Node Signatures verification
-    if (
-        !verifyNodeSignatures(
-            clusterLock
-        )
-    ) {
-        return false
+    // Deposit Data Verification
+    const { isValidDepositData, depositDataMsg } = verifyDepositData(
+      distributedPublicKey,
+      validator.deposit_data as Partial<DepositData>,
+      clusterLock.cluster_definition.validators[i].withdrawal_address,
+      clusterLock.cluster_definition.fork_version,
+    );
+
+    if (!isValidDepositData) {
+      return false;
     }
 
-    // signature_aggregate verification
-    if (
-        !verifyAggregate(
-            pubShares,
-            fromHexString(clusterLock.lock_hash),
-            fromHexString(clusterLock.signature_aggregate),
-        )
-    ) {
-        return false
+    pubKeys.push(fromHexString(distributedPublicKey));
+    builderRegistrationAndDepositDataMessages.push(depositDataMsg);
+    blsSignatures.push(
+      fromHexString(validator.deposit_data?.signature as string),
+    );
+
+    // Builder Registration Verification
+    const { isValidBuilderRegistration, builderRegistrationMsg } =
+      verifyBuilderRegistration(
+        validator,
+        clusterLock.cluster_definition.validators[i].fee_recipient_address,
+        clusterLock.cluster_definition.fork_version,
+      );
+
+    if (!isValidBuilderRegistration) {
+      return false;
     }
 
-    return true
-}
+    pubKeys.push(fromHexString(distributedPublicKey));
+    builderRegistrationAndDepositDataMessages.push(builderRegistrationMsg);
+    blsSignatures.push(
+      fromHexString(validator.builder_registration?.signature as string),
+    );
+  }
+
+  // BLS signatures verification
+  const aggregateBLSSignature = aggregateSignatures(blsSignatures);
+
+  if (
+    !verifyMultiple(
+      pubKeys,
+      builderRegistrationAndDepositDataMessages,
+      aggregateBLSSignature,
+    )
+  ) {
+    return false;
+  }
+
+  // Node Signatures verification
+  if (!verifyNodeSignatures(clusterLock)) {
+    return false;
+  }
+
+  // signature_aggregate verification
+  if (
+    !verifyAggregate(
+      pubShares,
+      fromHexString(clusterLock.lock_hash),
+      fromHexString(clusterLock.signature_aggregate),
+    )
+  ) {
+    return false;
+  }
+
+  return true;
+};