@lodestar/params 1.35.0-dev.feed916580 → 1.35.0-rc.0

package/src/index.ts

@@ -0,0 +1,311 @@
+import {PresetName} from "./presetName.js";
+import {presetStatus} from "./presetStatus.js";
+import {gnosisPreset} from "./presets/gnosis.js";
+import {mainnetPreset} from "./presets/mainnet.js";
+import {minimalPreset} from "./presets/minimal.js";
+import {userOverrides, userSelectedPreset} from "./setPreset.js";
+
+export * from "./forkName.js";
+export {presetToJson} from "./json.js";
+export type {BeaconPreset} from "./types.js";
+export {PresetName};
+
+const presets = {
+  [PresetName.mainnet]: mainnetPreset,
+  [PresetName.minimal]: minimalPreset,
+  [PresetName.gnosis]: gnosisPreset,
+};
+
+// Once this file is imported, freeze the preset so calling setActivePreset() will throw an error
+presetStatus.frozen = true;
+
+/**
+ * The preset name currently exported by this library
+ *
+ * The `LODESTAR_PRESET` environment variable is used to select the active preset
+ * If `LODESTAR_PRESET` is not set, the default is `mainnet`.
+ *
+ * The active preset can be manually overridden with `setActivePreset`
+ */
+export const ACTIVE_PRESET =
+  userSelectedPreset ??
+  (typeof process !== "undefined" ? PresetName[process?.env?.LODESTAR_PRESET as PresetName] : undefined) ??
+  PresetName.mainnet;
+export const activePreset = {...presets[ACTIVE_PRESET], ...userOverrides};
+
+// These variables must be exported individually and explicitly
+// in order to be accessible as top-level exports
+export const {
+  MAX_COMMITTEES_PER_SLOT,
+  TARGET_COMMITTEE_SIZE,
+  MAX_VALIDATORS_PER_COMMITTEE,
+  SHUFFLE_ROUND_COUNT,
+  HYSTERESIS_QUOTIENT,
+  HYSTERESIS_DOWNWARD_MULTIPLIER,
+  HYSTERESIS_UPWARD_MULTIPLIER,
+  MIN_DEPOSIT_AMOUNT,
+  MAX_EFFECTIVE_BALANCE,
+  EFFECTIVE_BALANCE_INCREMENT,
+  MIN_ATTESTATION_INCLUSION_DELAY,
+  SLOTS_PER_EPOCH,
+  MIN_SEED_LOOKAHEAD,
+  MAX_SEED_LOOKAHEAD,
+  EPOCHS_PER_ETH1_VOTING_PERIOD,
+  SLOTS_PER_HISTORICAL_ROOT,
+  MIN_EPOCHS_TO_INACTIVITY_PENALTY,
+  EPOCHS_PER_HISTORICAL_VECTOR,
+  EPOCHS_PER_SLASHINGS_VECTOR,
+  HISTORICAL_ROOTS_LIMIT,
+  VALIDATOR_REGISTRY_LIMIT,
+  BASE_REWARD_FACTOR,
+  WHISTLEBLOWER_REWARD_QUOTIENT,
+  PROPOSER_REWARD_QUOTIENT,
+  INACTIVITY_PENALTY_QUOTIENT,
+  MIN_SLASHING_PENALTY_QUOTIENT,
+  PROPORTIONAL_SLASHING_MULTIPLIER,
+  MAX_PROPOSER_SLASHINGS,
+  MAX_ATTESTER_SLASHINGS,
+  MAX_ATTESTATIONS,
+  MAX_DEPOSITS,
+  MAX_VOLUNTARY_EXITS,
+
+  SYNC_COMMITTEE_SIZE,
+  EPOCHS_PER_SYNC_COMMITTEE_PERIOD,
+  INACTIVITY_PENALTY_QUOTIENT_ALTAIR,
+  MIN_SLASHING_PENALTY_QUOTIENT_ALTAIR,
+  PROPORTIONAL_SLASHING_MULTIPLIER_ALTAIR,
+  MIN_SYNC_COMMITTEE_PARTICIPANTS,
+  UPDATE_TIMEOUT,
+
+  INACTIVITY_PENALTY_QUOTIENT_BELLATRIX,
+  MIN_SLASHING_PENALTY_QUOTIENT_BELLATRIX,
+  PROPORTIONAL_SLASHING_MULTIPLIER_BELLATRIX,
+  MAX_BYTES_PER_TRANSACTION,
+  MAX_TRANSACTIONS_PER_PAYLOAD,
+  BYTES_PER_LOGS_BLOOM,
+  MAX_EXTRA_DATA_BYTES,
+
+  MAX_BLS_TO_EXECUTION_CHANGES,
+  MAX_WITHDRAWALS_PER_PAYLOAD,
+  MAX_VALIDATORS_PER_WITHDRAWALS_SWEEP,
+
+  FIELD_ELEMENTS_PER_BLOB,
+  MAX_BLOB_COMMITMENTS_PER_BLOCK,
+  KZG_COMMITMENT_INCLUSION_PROOF_DEPTH,
+
+  MAX_EFFECTIVE_BALANCE_ELECTRA,
+  MIN_ACTIVATION_BALANCE,
+  PENDING_DEPOSITS_LIMIT,
+  PENDING_PARTIAL_WITHDRAWALS_LIMIT,
+  PENDING_CONSOLIDATIONS_LIMIT,
+  MIN_SLASHING_PENALTY_QUOTIENT_ELECTRA,
+  MAX_CONSOLIDATION_REQUESTS_PER_PAYLOAD,
+
+  MAX_DEPOSIT_REQUESTS_PER_PAYLOAD,
+  MAX_WITHDRAWAL_REQUESTS_PER_PAYLOAD,
+  MAX_ATTESTER_SLASHINGS_ELECTRA,
+  MAX_ATTESTATIONS_ELECTRA,
+  MAX_PENDING_PARTIALS_PER_WITHDRAWALS_SWEEP,
+  MAX_PENDING_DEPOSITS_PER_EPOCH,
+  WHISTLEBLOWER_REWARD_QUOTIENT_ELECTRA,
+
+  NUMBER_OF_COLUMNS,
+  CELLS_PER_EXT_BLOB,
+  FIELD_ELEMENTS_PER_CELL,
+  FIELD_ELEMENTS_PER_EXT_BLOB,
+  KZG_COMMITMENTS_INCLUSION_PROOF_DEPTH,
+
+  PTC_SIZE,
+  MAX_PAYLOAD_ATTESTATIONS,
+  BUILDER_PENDING_WITHDRAWALS_LIMIT,
+} = activePreset;
+
+////////////
+// Constants
+////////////
+
+// Exported directly on the index for faster accessing without commonjs compiled star import shenanigans
+
+// Misc
+
+export const GENESIS_SLOT = 0;
+export const GENESIS_EPOCH = 0;
+export const FAR_FUTURE_EPOCH = Infinity;
+export const BASE_REWARDS_PER_EPOCH = 4;
+export const DEPOSIT_CONTRACT_TREE_DEPTH = 2 ** 5; // 32
+export const JUSTIFICATION_BITS_LENGTH = 4;
+export const ZERO_HASH = Buffer.alloc(32, 0);
+export const ZERO_HASH_HEX = "0x" + "00".repeat(32);
+
+// Withdrawal prefixes
+// Since the prefixes are just 1 byte, we define and use them as number
+export const BLS_WITHDRAWAL_PREFIX = 0;
+export const ETH1_ADDRESS_WITHDRAWAL_PREFIX = 1;
+export const COMPOUNDING_WITHDRAWAL_PREFIX = 2;
+export const BUILDER_WITHDRAWAL_PREFIX = 3;
+
+// Domain types
+
+export const DOMAIN_BEACON_PROPOSER = Uint8Array.from([0, 0, 0, 0]);
+export const DOMAIN_BEACON_ATTESTER = Uint8Array.from([1, 0, 0, 0]);
+export const DOMAIN_RANDAO = Uint8Array.from([2, 0, 0, 0]);
+export const DOMAIN_DEPOSIT = Uint8Array.from([3, 0, 0, 0]);
+export const DOMAIN_VOLUNTARY_EXIT = Uint8Array.from([4, 0, 0, 0]);
+export const DOMAIN_SELECTION_PROOF = Uint8Array.from([5, 0, 0, 0]);
+export const DOMAIN_AGGREGATE_AND_PROOF = Uint8Array.from([6, 0, 0, 0]);
+export const DOMAIN_SYNC_COMMITTEE = Uint8Array.from([7, 0, 0, 0]);
+export const DOMAIN_SYNC_COMMITTEE_SELECTION_PROOF = Uint8Array.from([8, 0, 0, 0]);
+export const DOMAIN_CONTRIBUTION_AND_PROOF = Uint8Array.from([9, 0, 0, 0]);
+export const DOMAIN_BLS_TO_EXECUTION_CHANGE = Uint8Array.from([10, 0, 0, 0]);
+export const DOMAIN_BEACON_BUILDER = Uint8Array.from([27, 0, 0, 0]);
+export const DOMAIN_PTC_ATTESTER = Uint8Array.from([12, 0, 0, 0]);
+
+// Application specific domains
+
+/**
+ * `DOMAIN_APPLICATION_MASK` reserves the rest of the bitspace in `DomainType` for application
+ * usage. This means for some `DomainType` `DOMAIN_SOME_APPLICATION`, `DOMAIN_SOME_APPLICATION
+ * & DOMAIN_APPLICATION_MASK` **MUST** be non-zero. This expression for any other `DomainType`
+ * in the consensus specs **MUST** be zero.
+ */
+export const DOMAIN_APPLICATION_MASK = Uint8Array.from([0, 0, 0, 1]);
+export const DOMAIN_APPLICATION_BUILDER = Uint8Array.from([0, 0, 0, 1]);
+
+// Participation flag indices
+
+export const TIMELY_SOURCE_FLAG_INDEX = 0;
+export const TIMELY_TARGET_FLAG_INDEX = 1;
+export const TIMELY_HEAD_FLAG_INDEX = 2;
+
+// Incentivization weights
+
+export const TIMELY_SOURCE_WEIGHT = 14;
+export const TIMELY_TARGET_WEIGHT = 26;
+export const TIMELY_HEAD_WEIGHT = 14;
+export const SYNC_REWARD_WEIGHT = 2;
+export const PROPOSER_WEIGHT = 8;
+export const WEIGHT_DENOMINATOR = 64;
+
+// altair misc
+
+export const PARTICIPATION_FLAG_WEIGHTS = [TIMELY_SOURCE_WEIGHT, TIMELY_TARGET_WEIGHT, TIMELY_HEAD_WEIGHT];
+
+// phase0 validator
+
+export const TARGET_AGGREGATORS_PER_COMMITTEE = 16;
+export const RANDOM_SUBNETS_PER_VALIDATOR = 1;
+export const EPOCHS_PER_RANDOM_SUBNET_SUBSCRIPTION = 256;
+/** Rationale: https://github.com/ethereum/consensus-specs/blob/v1.1.10/specs/phase0/p2p-interface.md#why-are-there-attestation_subnet_count-attestation-subnets */
+export const ATTESTATION_SUBNET_COUNT = 64;
+export const SUBNETS_PER_NODE = 2;
+export const NODE_ID_BITS = 256;
+export const ATTESTATION_SUBNET_PREFIX_BITS = Math.log2(ATTESTATION_SUBNET_COUNT);
+export const EPOCHS_PER_SUBNET_SUBSCRIPTION = 256;
+
+// altair validator
+
+export const TARGET_AGGREGATORS_PER_SYNC_SUBCOMMITTEE = 16;
+export const SYNC_COMMITTEE_SUBNET_COUNT = 4;
+export const SYNC_COMMITTEE_SUBNET_SIZE = Math.floor(SYNC_COMMITTEE_SIZE / SYNC_COMMITTEE_SUBNET_COUNT);
+
+// Lightclient pre-computed
+/**
+ * ```ts
+ * config.types.altair.BeaconState.getPathGindex(["finalizedCheckpoint", "root"])
+ * ```
+ */
+export const FINALIZED_ROOT_GINDEX = 105;
+/**
+ * ```ts
+ * Math.floor(Math.log2(FINALIZED_ROOT_GINDEX))
+ * ```
+ */
+export const FINALIZED_ROOT_DEPTH = 6;
+export const FINALIZED_ROOT_INDEX = 41;
+
+/**
+ * ```ts
+ * types.ssz.capella.BeaconBlockBody.getPathInfo(['executionPayload']).gindex
+ * ```
+ */
+export const BLOCK_BODY_EXECUTION_PAYLOAD_GINDEX = 25;
+/**
+ * ```ts
+ * Math.floor(Math.log2(EXECUTION_PAYLOAD_GINDEX))
+ * ```
+ */
+export const BLOCK_BODY_EXECUTION_PAYLOAD_DEPTH = 4;
+export const BLOCK_BODY_EXECUTION_PAYLOAD_INDEX = 9;
+
+/**
+ * ```ts
+ * config.types.altair.BeaconState.getPathGindex(["currentSyncCommittee"])
+ * ```
+ */
+export const CURRENT_SYNC_COMMITTEE_GINDEX = 54;
+/**
+ * ```ts
+ * Math.floor(Math.log2(CURRENT_SYNC_COMMITTEE_GINDEX))
+ * ```
+ */
+export const CURRENT_SYNC_COMMITTEE_DEPTH = 5;
+export const CURRENT_SYNC_COMMITTEE_INDEX = 22;
+/**
+ * ```ts
+ * config.types.altair.BeaconState.getPathGindex(["nextSyncCommittee"])
+ * ```
+ */
+export const NEXT_SYNC_COMMITTEE_GINDEX = 55;
+/**
+ * ```ts
+ * Math.floor(Math.log2(NEXT_SYNC_COMMITTEE_GINDEX))
+ * ```
+ */
+export const NEXT_SYNC_COMMITTEE_DEPTH = 5;
+export const NEXT_SYNC_COMMITTEE_INDEX = 23;
+export const MAX_REQUEST_LIGHT_CLIENT_UPDATES = 128;
+export const MAX_REQUEST_LIGHT_CLIENT_COMMITTEE_HASHES = 128;
+
+/**
+ * Optimistic sync
+ */
+export const SAFE_SLOTS_TO_IMPORT_OPTIMISTICALLY = 128;
+export const INTERVALS_PER_SLOT = 3;
+
+// EIP-4844: Crypto const
+export const BYTES_PER_FIELD_ELEMENT = 32;
+export const BLOB_TX_TYPE = 0x03;
+export const VERSIONED_HASH_VERSION_KZG = 0x01;
+
+// ssz.deneb.BeaconBlockBody.getPathInfo(['blobKzgCommitments',0]).gindex
+export const KZG_COMMITMENT_GINDEX0 = 221184;
+export const KZG_COMMITMENT_SUBTREE_INDEX0 = KZG_COMMITMENT_GINDEX0 - 2 ** KZG_COMMITMENT_INCLUSION_PROOF_DEPTH;
+
+// ssz.deneb.BlobSidecars.elementType.fixedSize
+export const BLOBSIDECAR_FIXED_SIZE = 131928;
+
+// Electra Misc
+export const UNSET_DEPOSIT_REQUESTS_START_INDEX = 2n ** 64n - 1n;
+export const FULL_EXIT_REQUEST_AMOUNT = 0;
+export const FINALIZED_ROOT_GINDEX_ELECTRA = 169;
+export const FINALIZED_ROOT_DEPTH_ELECTRA = 7;
+export const FINALIZED_ROOT_INDEX_ELECTRA = 41;
+export const CURRENT_SYNC_COMMITTEE_GINDEX_ELECTRA = 86;
+export const CURRENT_SYNC_COMMITTEE_DEPTH_ELECTRA = 6;
+export const CURRENT_SYNC_COMMITTEE_INDEX_ELECTRA = 22;
+export const NEXT_SYNC_COMMITTEE_GINDEX_ELECTRA = 87;
+export const NEXT_SYNC_COMMITTEE_DEPTH_ELECTRA = 6;
+export const NEXT_SYNC_COMMITTEE_INDEX_ELECTRA = 23;
+export const DEPOSIT_REQUEST_TYPE = 0x00;
+export const WITHDRAWAL_REQUEST_TYPE = 0x01;
+export const CONSOLIDATION_REQUEST_TYPE = 0x02;
+
+export const BYTES_PER_CELL = FIELD_ELEMENTS_PER_CELL * BYTES_PER_FIELD_ELEMENT;
+
+// ssz.fulu.BeaconBlockBody.getPathInfo(['blobKzgCommitments']).gindex
+export const KZG_COMMITMENTS_GINDEX = 27;
+export const KZG_COMMITMENTS_SUBTREE_INDEX = KZG_COMMITMENTS_GINDEX - 2 ** KZG_COMMITMENTS_INCLUSION_PROOF_DEPTH;
+
+// Gloas Misc
+export const BUILDER_PAYMENT_THRESHOLD_NUMERATOR = 6;
+export const BUILDER_PAYMENT_THRESHOLD_DENOMINATOR = 10;

package/src/json.ts

@@ -0,0 +1,58 @@
+import {BeaconPreset, beaconPresetTypes} from "./types.js";
+
+/**
+ * Render BeaconPreset to JSON strings
+ * - Numbers: Render as a quoted decimal string
+ */
+export function presetToJson(preset: BeaconPreset): Record<string, string> {
+  const json: Record<string, string> = {};
+
+  for (const key of Object.keys(preset) as (keyof BeaconPreset)[]) {
+    json[key] = serializePresetValue(preset[key]);
+  }
+
+  return json;
+}
+
+/**
+ * Type Wrapper to ensure that all values of BeaconPreset are number.
+ * If there are more types, expand this function with a type switch
+ */
+function serializePresetValue(value: number): string {
+  return value.toString(10);
+}
+
+/**
+ * Parse JSON strings of BeaconPreset
+ * - Numbers: Convert quoted decimal string to number
+ */
+export function presetFromJson(json: Record<string, unknown>): Partial<BeaconPreset> {
+  const beaconPreset = {} as BeaconPreset;
+
+  for (const key of Object.keys(beaconPresetTypes) as (keyof BeaconPreset)[]) {
+    const value = json[key];
+    if (value !== undefined) {
+      beaconPreset[key] = deserializePresetValue(value, key);
+    }
+  }
+
+  return beaconPreset;
+}
+
+/**
+ * Ensure that all values of parsed BeaconPreset are numbers
+ * If there are more types, expand this function with a type switch
+ */
+function deserializePresetValue(valueStr: unknown, keyName: string): number {
+  if (typeof valueStr !== "string") {
+    throw Error(`Invalid ${keyName} value ${valueStr as string} expected string`);
+  }
+
+  const value = parseInt(valueStr, 10);
+
+  if (Number.isNaN(value)) {
+    throw Error(`Invalid ${keyName} value ${valueStr} expected number`);
+  }
+
+  return value;
+}

package/src/presetName.ts

@@ -0,0 +1,5 @@
+export enum PresetName {
+  mainnet = "mainnet",
+  minimal = "minimal",
+  gnosis = "gnosis",
+}

package/src/presetStatus.ts

@@ -0,0 +1,3 @@
+export const presetStatus = {
+  frozen: false,
+};

package/src/presets/gnosis.ts

@@ -0,0 +1,22 @@
+import {BeaconPreset} from "../types.js";
+import {mainnetPreset} from "./mainnet.js";
+
+// Gnosis preset
+// https://github.com/gnosischain/specs/tree/master/consensus/preset/gnosis
+
+export const gnosisPreset: BeaconPreset = {
+  ...mainnetPreset,
+
+  /// NOTE: Only add diff values
+
+  // phase0
+  BASE_REWARD_FACTOR: 25,
+  SLOTS_PER_EPOCH: 16,
+
+  // altair
+  EPOCHS_PER_SYNC_COMMITTEE_PERIOD: 512,
+
+  // capella
+  MAX_WITHDRAWALS_PER_PAYLOAD: 8,
+  MAX_VALIDATORS_PER_WITHDRAWALS_SWEEP: 8192,
+};

package/src/presets/mainnet.ts

@@ -0,0 +1,149 @@
+import {BeaconPreset} from "../types.js";
+
+// Mainnet preset
+// https://github.com/ethereum/consensus-specs/tree/dev/presets/mainnet
+
+export const mainnetPreset: BeaconPreset = {
+  // Misc
+  // ---------------------------------------------------------------
+  // 2**6 (= 64)
+  MAX_COMMITTEES_PER_SLOT: 64,
+  // 2**7 (= 128)
+  TARGET_COMMITTEE_SIZE: 128,
+  // 2**11 (= 2,048)
+  MAX_VALIDATORS_PER_COMMITTEE: 2048,
+  // See issue 563
+  SHUFFLE_ROUND_COUNT: 90,
+  // 4
+  HYSTERESIS_QUOTIENT: 4,
+  // 1 (minus 0.25)
+  HYSTERESIS_DOWNWARD_MULTIPLIER: 1,
+  // 5 (plus 1.25)
+  HYSTERESIS_UPWARD_MULTIPLIER: 5,
+
+  // Gwei values
+  // ---------------------------------------------------------------
+  // 2**0 * 10**9 (= 1,000,000,000) Gwei
+  MIN_DEPOSIT_AMOUNT: 1000000000,
+  // 2**5 * 10**9 (= 32,000,000,000) Gwei
+  MAX_EFFECTIVE_BALANCE: 32000000000,
+  // 2**0 * 10**9 (= 1,000,000,000) Gwei
+  EFFECTIVE_BALANCE_INCREMENT: 1000000000,
+
+  // Time parameters
+  // ---------------------------------------------------------------
+  // 2**0 (= 1) slots 12 seconds
+  MIN_ATTESTATION_INCLUSION_DELAY: 1,
+  // 2**5 (= 32) slots 6.4 minutes
+  SLOTS_PER_EPOCH: 32,
+  // 2**0 (= 1) epochs 6.4 minutes
+  MIN_SEED_LOOKAHEAD: 1,
+  // 2**2 (= 4) epochs 25.6 minutes
+  MAX_SEED_LOOKAHEAD: 4,
+  // 2**6 (= 64) epochs ~6.8 hours
+  EPOCHS_PER_ETH1_VOTING_PERIOD: 64,
+  // 2**13 (= 8,192) slots ~13 hours
+  SLOTS_PER_HISTORICAL_ROOT: 8192,
+  // 2**2 (= 4) epochs 25.6 minutes
+  MIN_EPOCHS_TO_INACTIVITY_PENALTY: 4,
+
+  // State vector lengths
+  // ---------------------------------------------------------------
+  // 2**16 (= 65,536) epochs ~0.8 years
+  EPOCHS_PER_HISTORICAL_VECTOR: 65536,
+  // 2**13 (= 8,192) epochs ~36 days
+  EPOCHS_PER_SLASHINGS_VECTOR: 8192,
+  // 2**24 (= 16,777,216) historical roots, ~26,131 years
+  HISTORICAL_ROOTS_LIMIT: 16777216,
+  // 2**40 (= 1,099,511,627,776) validator spots
+  VALIDATOR_REGISTRY_LIMIT: 1099511627776,
+
+  // Reward and penalty quotients
+  // ---------------------------------------------------------------
+  // 2**6 (= 64)
+  BASE_REWARD_FACTOR: 64,
+  // 2**9 (= 512)
+  WHISTLEBLOWER_REWARD_QUOTIENT: 512,
+  // 2**3 (= 8)
+  PROPOSER_REWARD_QUOTIENT: 8,
+  // 2**26 (= 67,108,864)
+  INACTIVITY_PENALTY_QUOTIENT: 67108864,
+  // 2**7 (= 128) (lower safety margin at Phase 0 genesis)
+  MIN_SLASHING_PENALTY_QUOTIENT: 128,
+  PROPORTIONAL_SLASHING_MULTIPLIER: 1,
+
+  // Max operations per block
+  // ---------------------------------------------------------------
+  // 2**4 (= 16)
+  MAX_PROPOSER_SLASHINGS: 16,
+  // 2**1 (= 2)
+  MAX_ATTESTER_SLASHINGS: 2,
+  // 2**7 (= 128)
+  MAX_ATTESTATIONS: 128,
+  // 2**4 (= 16)
+  MAX_DEPOSITS: 16,
+  // 2**4 (= 16)
+  MAX_VOLUNTARY_EXITS: 16,
+
+  // ALTAIR
+  /////////
+  SYNC_COMMITTEE_SIZE: 512,
+  EPOCHS_PER_SYNC_COMMITTEE_PERIOD: 256,
+  INACTIVITY_PENALTY_QUOTIENT_ALTAIR: 50331648,
+  MIN_SLASHING_PENALTY_QUOTIENT_ALTAIR: 64,
+  PROPORTIONAL_SLASHING_MULTIPLIER_ALTAIR: 2,
+  MIN_SYNC_COMMITTEE_PARTICIPANTS: 1,
+  UPDATE_TIMEOUT: 8192,
+
+  // BELLATRIX
+  ////////////
+  INACTIVITY_PENALTY_QUOTIENT_BELLATRIX: 16777216,
+  MIN_SLASHING_PENALTY_QUOTIENT_BELLATRIX: 32,
+  PROPORTIONAL_SLASHING_MULTIPLIER_BELLATRIX: 3,
+  MAX_BYTES_PER_TRANSACTION: 1073741824,
+  MAX_TRANSACTIONS_PER_PAYLOAD: 1048576,
+  BYTES_PER_LOGS_BLOOM: 256,
+  MAX_EXTRA_DATA_BYTES: 32,
+
+  // CAPELLA
+  //////////
+  MAX_BLS_TO_EXECUTION_CHANGES: 16,
+  MAX_WITHDRAWALS_PER_PAYLOAD: 16,
+  MAX_VALIDATORS_PER_WITHDRAWALS_SWEEP: 16384,
+
+  // DENEB
+  ///////////
+  FIELD_ELEMENTS_PER_BLOB: 4096,
+  MAX_BLOB_COMMITMENTS_PER_BLOCK: 4096,
+  KZG_COMMITMENT_INCLUSION_PROOF_DEPTH: 17,
+
+  // ELECTRA
+  MAX_DEPOSIT_REQUESTS_PER_PAYLOAD: 8192,
+  MAX_WITHDRAWAL_REQUESTS_PER_PAYLOAD: 16,
+  MAX_ATTESTER_SLASHINGS_ELECTRA: 1,
+  MAX_ATTESTATIONS_ELECTRA: 8,
+  MAX_PENDING_PARTIALS_PER_WITHDRAWALS_SWEEP: 8,
+  MAX_PENDING_DEPOSITS_PER_EPOCH: 16,
+  // 2**11 * 10**9 (= 2,048,000,000,000) Gwei
+  MAX_EFFECTIVE_BALANCE_ELECTRA: 2048000000000,
+  MIN_SLASHING_PENALTY_QUOTIENT_ELECTRA: 4096,
+  MIN_ACTIVATION_BALANCE: 32000000000,
+  PENDING_DEPOSITS_LIMIT: 134217728,
+  PENDING_PARTIAL_WITHDRAWALS_LIMIT: 134217728,
+  PENDING_CONSOLIDATIONS_LIMIT: 262144,
+  MAX_CONSOLIDATION_REQUESTS_PER_PAYLOAD: 2,
+  WHISTLEBLOWER_REWARD_QUOTIENT_ELECTRA: 4096,
+
+  // FULU
+  ///////////
+  NUMBER_OF_COLUMNS: 128,
+  CELLS_PER_EXT_BLOB: 128,
+  FIELD_ELEMENTS_PER_CELL: 64,
+  FIELD_ELEMENTS_PER_EXT_BLOB: 8192,
+  KZG_COMMITMENTS_INCLUSION_PROOF_DEPTH: 4,
+
+  // GLOAS
+  PTC_SIZE: 512,
+  MAX_PAYLOAD_ATTESTATIONS: 4,
+  BUILDER_PENDING_WITHDRAWALS_LIMIT: 1048576, // 2**20
+};

package/src/presets/minimal.ts

@@ -0,0 +1,150 @@
+import {BeaconPreset} from "../types.js";
+
+// Minimal preset
+// https://github.com/ethereum/consensus-specs/tree/dev/presets/minimal
+
+export const minimalPreset: BeaconPreset = {
+  // Misc
+  // ---------------------------------------------------------------
+  // [customized] Just 4 committees for slot for testing purposes
+  MAX_COMMITTEES_PER_SLOT: 4,
+  // [customized] unsecure, but fast
+  TARGET_COMMITTEE_SIZE: 4,
+  // 2**11 (= 2,048)
+  MAX_VALIDATORS_PER_COMMITTEE: 2048,
+  // [customized] Faster, but unsecure.
+  SHUFFLE_ROUND_COUNT: 10,
+  // 4
+  HYSTERESIS_QUOTIENT: 4,
+  // 1 (minus 0.25)
+  HYSTERESIS_DOWNWARD_MULTIPLIER: 1,
+  // 5 (plus 1.25)
+  HYSTERESIS_UPWARD_MULTIPLIER: 5,
+
+  // Gwei values
+  // ---------------------------------------------------------------
+  // 2**0 * 10**9 (= 1,000,000,000) Gwei
+  MIN_DEPOSIT_AMOUNT: 1000000000,
+  // 2**5 * 10**9 (= 32,000,000,000) Gwei
+  MAX_EFFECTIVE_BALANCE: 32000000000,
+  // 2**0 * 10**9 (= 1,000,000,000) Gwei
+  EFFECTIVE_BALANCE_INCREMENT: 1000000000,
+
+  // Time parameters
+  // ---------------------------------------------------------------
+  // 2**0 (= 1) slots 6 seconds
+  MIN_ATTESTATION_INCLUSION_DELAY: 1,
+  // [customized] fast epochs
+  SLOTS_PER_EPOCH: 8,
+  // 2**0 (= 1) epochs
+  MIN_SEED_LOOKAHEAD: 1,
+  // 2**2 (= 4) epochs
+  MAX_SEED_LOOKAHEAD: 4,
+  // [customized] higher frequency new deposits from eth1 for testing
+  EPOCHS_PER_ETH1_VOTING_PERIOD: 4,
+  // [customized] smaller state
+  SLOTS_PER_HISTORICAL_ROOT: 64,
+  // 2**2 (= 4) epochs
+  MIN_EPOCHS_TO_INACTIVITY_PENALTY: 4,
+
+  // State vector lengths
+  // ---------------------------------------------------------------
+  // [customized] smaller state
+  EPOCHS_PER_HISTORICAL_VECTOR: 64,
+  // [customized] smaller state
+  EPOCHS_PER_SLASHINGS_VECTOR: 64,
+  // 2**24 (= 16,777,216) historical roots
+  HISTORICAL_ROOTS_LIMIT: 16777216,
+  // 2**40 (= 1,099,511,627,776) validator spots
+  VALIDATOR_REGISTRY_LIMIT: 1099511627776,
+
+  // Reward and penalty quotients
+  // ---------------------------------------------------------------
+  // 2**6 (= 64)
+  BASE_REWARD_FACTOR: 64,
+  // 2**9 (= 512)
+  WHISTLEBLOWER_REWARD_QUOTIENT: 512,
+  // 2**3 (= 8)
+  PROPOSER_REWARD_QUOTIENT: 8,
+  // [customized] 2**25 (= 33,554,432)
+  INACTIVITY_PENALTY_QUOTIENT: 33554432,
+  // [customized] 2**6 (= 64)
+  MIN_SLASHING_PENALTY_QUOTIENT: 64,
+  // [customized] 2 (lower safety margin than Phase 0 genesis but different than mainnet config for testing)
+  PROPORTIONAL_SLASHING_MULTIPLIER: 2,
+
+  // Max operations per block
+  // ---------------------------------------------------------------
+  // 2**4 (= 16)
+  MAX_PROPOSER_SLASHINGS: 16,
+  // 2**1 (= 2)
+  MAX_ATTESTER_SLASHINGS: 2,
+  // 2**7 (= 128)
+  MAX_ATTESTATIONS: 128,
+  // 2**4 (= 16)
+  MAX_DEPOSITS: 16,
+  // 2**4 (= 16)
+  MAX_VOLUNTARY_EXITS: 16,
+
+  // ALTAIR
+  /////////
+  SYNC_COMMITTEE_SIZE: 32,
+  EPOCHS_PER_SYNC_COMMITTEE_PERIOD: 8,
+  INACTIVITY_PENALTY_QUOTIENT_ALTAIR: 50331648,
+  MIN_SLASHING_PENALTY_QUOTIENT_ALTAIR: 64,
+  PROPORTIONAL_SLASHING_MULTIPLIER_ALTAIR: 2,
+  MIN_SYNC_COMMITTEE_PARTICIPANTS: 1,
+  UPDATE_TIMEOUT: 64,
+
+  // BELLATRIX
+  ////////////
+  INACTIVITY_PENALTY_QUOTIENT_BELLATRIX: 16777216,
+  MIN_SLASHING_PENALTY_QUOTIENT_BELLATRIX: 32,
+  PROPORTIONAL_SLASHING_MULTIPLIER_BELLATRIX: 3,
+  MAX_BYTES_PER_TRANSACTION: 1073741824,
+  MAX_TRANSACTIONS_PER_PAYLOAD: 1048576,
+  BYTES_PER_LOGS_BLOOM: 256,
+  MAX_EXTRA_DATA_BYTES: 32,
+
+  // CAPELLA
+  //////////
+  MAX_BLS_TO_EXECUTION_CHANGES: 16,
+  MAX_WITHDRAWALS_PER_PAYLOAD: 4,
+  MAX_VALIDATORS_PER_WITHDRAWALS_SWEEP: 16,
+
+  // DENEB
+  ///////////
+  FIELD_ELEMENTS_PER_BLOB: 4096,
+
+  // ELECTRA
+  MAX_DEPOSIT_REQUESTS_PER_PAYLOAD: 8192,
+  MAX_WITHDRAWAL_REQUESTS_PER_PAYLOAD: 16,
+  MAX_ATTESTER_SLASHINGS_ELECTRA: 1,
+  MAX_ATTESTATIONS_ELECTRA: 8,
+  MAX_PENDING_PARTIALS_PER_WITHDRAWALS_SWEEP: 2,
+  MAX_PENDING_DEPOSITS_PER_EPOCH: 16,
+  // 2**11 * 10**9 (= 2,048,000,000,000) Gwei
+  MAX_EFFECTIVE_BALANCE_ELECTRA: 2048000000000,
+  MIN_SLASHING_PENALTY_QUOTIENT_ELECTRA: 4096,
+  MIN_ACTIVATION_BALANCE: 32000000000,
+  PENDING_DEPOSITS_LIMIT: 134217728,
+  PENDING_PARTIAL_WITHDRAWALS_LIMIT: 64,
+  PENDING_CONSOLIDATIONS_LIMIT: 64,
+  MAX_CONSOLIDATION_REQUESTS_PER_PAYLOAD: 2,
+  WHISTLEBLOWER_REWARD_QUOTIENT_ELECTRA: 4096,
+  MAX_BLOB_COMMITMENTS_PER_BLOCK: 4096,
+  KZG_COMMITMENT_INCLUSION_PROOF_DEPTH: 17,
+
+  // FULU
+  ///////////
+  NUMBER_OF_COLUMNS: 128,
+  CELLS_PER_EXT_BLOB: 128,
+  FIELD_ELEMENTS_PER_CELL: 64,
+  FIELD_ELEMENTS_PER_EXT_BLOB: 8192,
+  KZG_COMMITMENTS_INCLUSION_PROOF_DEPTH: 4,
+
+  // GLOAS
+  PTC_SIZE: 2,
+  MAX_PAYLOAD_ATTESTATIONS: 4,
+  BUILDER_PENDING_WITHDRAWALS_LIMIT: 1048576, // 2**20
+};