@lodestar/config 1.46.0-dev.8fc4e297d2 → 1.46.0-dev.9b97bb94f2

package/lib/chainConfig/index.d.ts

@@ -1,6 +1,7 @@
 import { ChainConfig } from "./types.js";
 export * from "./default.js";
 export { chainConfigFromJson, chainConfigToJson, deserializeBlobSchedule, specValuesToJson } from "./json.js";
+export { NotEqualParamsError, assertEqualParams } from "./params.js";
 export * from "./types.js";
 /**
  * Create an `ChainConfig`, filling in missing values with preset defaults

package/lib/chainConfig/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chainConfig/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAEvC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAC,mBAAmB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,gBAAgB,EAAC,MAAM,WAAW,CAAC;AAC5G,cAAc,YAAY,CAAC;AAE3B;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAqB1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chainConfig/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAEvC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAC,mBAAmB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,gBAAgB,EAAC,MAAM,WAAW,CAAC;AAC5G,OAAO,EAAC,mBAAmB,EAAE,iBAAiB,EAAC,MAAM,aAAa,CAAC;AACnE,cAAc,YAAY,CAAC;AAE3B;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAqB1E"}

package/lib/chainConfig/index.js

@@ -2,6 +2,7 @@ import { ACTIVE_PRESET } from "@lodestar/params";
 import { defaultChainConfig } from "./default.js";
 export * from "./default.js";
 export { chainConfigFromJson, chainConfigToJson, deserializeBlobSchedule, specValuesToJson } from "./json.js";
+export { NotEqualParamsError, assertEqualParams } from "./params.js";
 export * from "./types.js";
 /**
  * Create an `ChainConfig`, filling in missing values with preset defaults

package/lib/chainConfig/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chainConfig/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAC,kBAAkB,EAAC,MAAM,cAAc,CAAC;AAGhD,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAC,mBAAmB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,gBAAgB,EAAC,MAAM,WAAW,CAAC;AAC5G,cAAc,YAAY,CAAC;AAE3B;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA2B,EAAe;IAC1E,MAAM,MAAM,GAAG;QACb,kDAAkD;QAClD,GAAG,kBAAkB;QACrB,sBAAsB;QACtB,GAAG,KAAK;KACT,CAAC;IAEF,oFAAoF;IACpF,gEAAgE;IAChE,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC3D,CAAC;IAED,mDAAmD;IACnD,IAAI,MAAM,CAAC,WAAW,KAAK,aAAa,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,iEAAiE,aAAa,gBAAgB,MAAM,CAAC,WAAW,EAAE,CACnH,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAAA,CACf"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chainConfig/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAC,kBAAkB,EAAC,MAAM,cAAc,CAAC;AAGhD,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAC,mBAAmB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,gBAAgB,EAAC,MAAM,WAAW,CAAC;AAC5G,OAAO,EAAC,mBAAmB,EAAE,iBAAiB,EAAC,MAAM,aAAa,CAAC;AACnE,cAAc,YAAY,CAAC;AAE3B;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA2B,EAAe;IAC1E,MAAM,MAAM,GAAG;QACb,kDAAkD;QAClD,GAAG,kBAAkB;QACrB,sBAAsB;QACtB,GAAG,KAAK;KACT,CAAC;IAEF,oFAAoF;IACpF,gEAAgE;IAChE,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC3D,CAAC;IAED,mDAAmD;IACnD,IAAI,MAAM,CAAC,WAAW,KAAK,aAAa,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,iEAAiE,aAAa,gBAAgB,MAAM,CAAC,WAAW,EAAE,CACnH,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAAA,CACf"}

package/lib/chainConfig/params.d.ts

@@ -0,0 +1,20 @@
+import { ChainConfig, SpecJson } from "./types.js";
+export declare class NotEqualParamsError extends Error {
+}
+/**
+ * Assert localConfig values match externalSpecJson. externalSpecJson may contain more values than localConfig.
+ *
+ * This check ensures that the validator is connected to a beacon node of the exact same network and params.
+ * Otherwise, signatures may be rejected, time may be un-equal and other bugs that are harder to debug caused
+ * by different parameters.
+ *
+ * This check however can't compare the full config as is, since some parameters are not critical to the spec and
+ * can be changed un-expectedly. Also, fork parameters can change un-expectedly, like their _FORK_VERSION or _EPOCH.
+ * Note that the config API endpoint is not precisely specified, so each clients can return a different set of
+ * parameters.
+ *
+ * So this check only compares a specific list of parameters that are consensus critical, ignoring the rest. Typed
+ * config and preset ensure new parameters are labeled critical or ignore, facilitating maintenance of the list.
+ */
+export declare function assertEqualParams(localConfig: ChainConfig, externalSpecJson: SpecJson): void;
+//# sourceMappingURL=params.d.ts.map

package/lib/chainConfig/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/chainConfig/params.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,WAAW,EAAE,QAAQ,EAAC,MAAM,YAAY,CAAC;AAEpE,qBAAa,mBAAoB,SAAQ,KAAK;CAAG;AAIjD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,GAAG,IAAI,CAyE5F"}

package/lib/chainConfig/params.js

@@ -0,0 +1,298 @@
+import { activePreset, presetToJson } from "@lodestar/params";
+import { chainConfigToJson, deserializeBlobSchedule } from "./json.js";
+export class NotEqualParamsError extends Error {
+}
+/**
+ * Assert localConfig values match externalSpecJson. externalSpecJson may contain more values than localConfig.
+ *
+ * This check ensures that the validator is connected to a beacon node of the exact same network and params.
+ * Otherwise, signatures may be rejected, time may be un-equal and other bugs that are harder to debug caused
+ * by different parameters.
+ *
+ * This check however can't compare the full config as is, since some parameters are not critical to the spec and
+ * can be changed un-expectedly. Also, fork parameters can change un-expectedly, like their _FORK_VERSION or _EPOCH.
+ * Note that the config API endpoint is not precisely specified, so each clients can return a different set of
+ * parameters.
+ *
+ * So this check only compares a specific list of parameters that are consensus critical, ignoring the rest. Typed
+ * config and preset ensure new parameters are labeled critical or ignore, facilitating maintenance of the list.
+ */
+export function assertEqualParams(localConfig, externalSpecJson) {
+    // Before comparing, add preset which is bundled in api impl config route.
+    // config and preset must be serialized to JSON for safe comparisions.
+    const localSpecJson = {
+        ...chainConfigToJson(localConfig),
+        ...presetToJson(activePreset),
+    };
+    // Get list of keys to check, and keys to ignore. Otherwise this function throws for false positives
+    const criticalParams = getSpecCriticalParams(localConfig);
+    // Accumulate errors first and print all of them at once
+    const errors = [];
+    for (const key of Object.keys(criticalParams)) {
+        if (
+        // Ignore non-critical params
+        !criticalParams[key] ||
+            // This condition should never be true, but just in case
+            localSpecJson[key] === undefined ||
+            // The config/spec endpoint is poorly specified, so in practice each client returns a custom selection of keys.
+            // For example Lighthouse returns a manually selected list of keys that may be updated at any time.
+            // https://github.com/sigp/lighthouse/blob/bac7c3fa544495a257722aaad9cd8f72fee2f2b4/consensus/types/src/chain_spec.rs#L941
+            //
+            // So if we assert that spec critical keys are present in the spec we may break interoperability unexpectedly.
+            // So it's best to ignore keys are not defined in both specs and trust that the ones defined are sufficient
+            // to detect spec discrepancies in all cases.
+            externalSpecJson[key] === undefined) {
+            continue;
+        }
+        if (key === "BLOB_SCHEDULE") {
+            const localBlobSchedule = deserializeBlobSchedule(localSpecJson[key]).sort((a, b) => a.EPOCH - b.EPOCH);
+            const remoteBlobSchedule = deserializeBlobSchedule(externalSpecJson[key]).sort((a, b) => a.EPOCH - b.EPOCH);
+            if (localBlobSchedule.length !== remoteBlobSchedule.length) {
+                errors.push(`BLOB_SCHEDULE different length: ${localBlobSchedule.length} != ${remoteBlobSchedule.length}`);
+                // Skip per entry comparison
+                continue;
+            }
+            for (let i = 0; i < localBlobSchedule.length; i++) {
+                const localEntry = localBlobSchedule[i];
+                const remoteEntry = remoteBlobSchedule[i];
+                for (const entryKey of ["EPOCH", "MAX_BLOBS_PER_BLOCK"]) {
+                    const localValue = String(localEntry[entryKey]);
+                    const remoteValue = String(remoteEntry[entryKey]);
+                    if (localValue !== remoteValue) {
+                        errors.push(`BLOB_SCHEDULE[${i}].${entryKey} different value: ${localValue} != ${remoteValue}`);
+                    }
+                }
+            }
+            // Skip generic string comparison
+            continue;
+        }
+        // Must compare JSON serialized specs, to ensure all strings are rendered in the same way
+        // Must compare as lowercase to ensure checksum addresses and names have same capilatization
+        const localValue = String(localSpecJson[key]).toLocaleLowerCase();
+        const remoteValue = String(externalSpecJson[key]).toLocaleLowerCase();
+        if (localValue !== remoteValue) {
+            errors.push(`${key} different value: ${localValue} != ${remoteValue}`);
+        }
+    }
+    if (errors.length > 0) {
+        throw new NotEqualParamsError("Local and remote configs are different\n" + errors.join("\n"));
+    }
+}
+function getSpecCriticalParams(localConfig) {
+    const altairForkRelevant = localConfig.ALTAIR_FORK_EPOCH < Infinity;
+    const bellatrixForkRelevant = localConfig.BELLATRIX_FORK_EPOCH < Infinity;
+    const capellaForkRelevant = localConfig.CAPELLA_FORK_EPOCH < Infinity;
+    const denebForkRelevant = localConfig.DENEB_FORK_EPOCH < Infinity;
+    const electraForkRelevant = localConfig.ELECTRA_FORK_EPOCH < Infinity;
+    const fuluForkRelevant = localConfig.FULU_FORK_EPOCH < Infinity;
+    const gloasForkRelevant = localConfig.GLOAS_FORK_EPOCH < Infinity;
+    return {
+        // # Config
+        ///////////
+        PRESET_BASE: false, // Not relevant, each preset value is checked below
+        CONFIG_NAME: false, // Arbitrary string, not relevant
+        // Deprecated - All networks have completed the merge transition
+        TERMINAL_TOTAL_DIFFICULTY: false,
+        TERMINAL_BLOCK_HASH: false,
+        TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH: false,
+        // Genesis
+        MIN_GENESIS_ACTIVE_VALIDATOR_COUNT: true,
+        MIN_GENESIS_TIME: true,
+        GENESIS_FORK_VERSION: true,
+        GENESIS_DELAY: true,
+        // Forking
+        // Altair
+        ALTAIR_FORK_VERSION: altairForkRelevant,
+        ALTAIR_FORK_EPOCH: altairForkRelevant,
+        // Bellatrix
+        BELLATRIX_FORK_VERSION: bellatrixForkRelevant,
+        BELLATRIX_FORK_EPOCH: bellatrixForkRelevant,
+        // Capella
+        CAPELLA_FORK_VERSION: capellaForkRelevant,
+        CAPELLA_FORK_EPOCH: capellaForkRelevant,
+        // Deneb
+        DENEB_FORK_VERSION: denebForkRelevant,
+        DENEB_FORK_EPOCH: denebForkRelevant,
+        // electra
+        ELECTRA_FORK_VERSION: electraForkRelevant,
+        ELECTRA_FORK_EPOCH: electraForkRelevant,
+        // fulu
+        FULU_FORK_VERSION: fuluForkRelevant,
+        FULU_FORK_EPOCH: fuluForkRelevant,
+        // gloas
+        GLOAS_FORK_VERSION: gloasForkRelevant,
+        GLOAS_FORK_EPOCH: gloasForkRelevant,
+        // Time parameters
+        SECONDS_PER_SLOT: false, // Deprecated
+        SLOT_DURATION_MS: true,
+        SECONDS_PER_ETH1_BLOCK: false, // Legacy
+        MIN_VALIDATOR_WITHDRAWABILITY_DELAY: true,
+        SHARD_COMMITTEE_PERIOD: true,
+        ETH1_FOLLOW_DISTANCE: true,
+        PROPOSER_REORG_CUTOFF_BPS: true,
+        ATTESTATION_DUE_BPS: true,
+        AGGREGATE_DUE_BPS: true,
+        // Altair
+        SYNC_MESSAGE_DUE_BPS: altairForkRelevant,
+        CONTRIBUTION_DUE_BPS: altairForkRelevant,
+        // Validator cycle
+        INACTIVITY_SCORE_BIAS: true,
+        INACTIVITY_SCORE_RECOVERY_RATE: true,
+        EJECTION_BALANCE: true,
+        MIN_PER_EPOCH_CHURN_LIMIT: true,
+        MAX_PER_EPOCH_ACTIVATION_CHURN_LIMIT: denebForkRelevant,
+        CHURN_LIMIT_QUOTIENT: true,
+        // Fork choice
+        PROPOSER_SCORE_BOOST: false, // Ignored as it's changing https://github.com/ethereum/consensus-specs/pull/2895
+        REORG_HEAD_WEIGHT_THRESHOLD: false, // Non-critical since proposer boost reorg is optional feature
+        REORG_PARENT_WEIGHT_THRESHOLD: false, // Non-critical since proposer boost reorg is optional feature
+        REORG_MAX_EPOCHS_SINCE_FINALIZATION: false, // Non-critical since proposer boost reorg is optional feature
+        // Deposit contract
+        DEPOSIT_CHAIN_ID: false, // Non-critical
+        DEPOSIT_NETWORK_ID: false, // Non-critical
+        DEPOSIT_CONTRACT_ADDRESS: true,
+        // Networking (non-critical as those do not affect consensus)
+        MAX_PAYLOAD_SIZE: false,
+        EPOCHS_PER_SUBNET_SUBSCRIPTION: false,
+        ATTESTATION_PROPAGATION_SLOT_RANGE: false,
+        MAXIMUM_GOSSIP_CLOCK_DISPARITY: false,
+        MESSAGE_DOMAIN_INVALID_SNAPPY: false,
+        MESSAGE_DOMAIN_VALID_SNAPPY: false,
+        SUBNETS_PER_NODE: false,
+        MAX_REQUEST_BLOCKS: false,
+        MAX_REQUEST_BLOCKS_DENEB: false,
+        MIN_EPOCHS_FOR_BLOCK_REQUESTS: false,
+        MIN_EPOCHS_FOR_BLOB_SIDECARS_REQUESTS: false,
+        MIN_EPOCHS_FOR_DATA_COLUMN_SIDECARS_REQUESTS: false,
+        BLOB_SIDECAR_SUBNET_COUNT: false,
+        BLOB_SIDECAR_SUBNET_COUNT_ELECTRA: false,
+        DATA_COLUMN_SIDECAR_SUBNET_COUNT: false,
+        MAX_REQUEST_BLOB_SIDECARS: false,
+        MAX_REQUEST_BLOB_SIDECARS_ELECTRA: false,
+        MAX_REQUEST_DATA_COLUMN_SIDECARS: false,
+        MAX_REQUEST_PAYLOADS: false,
+        // # Phase0Preset
+        /////////////////
+        MAX_COMMITTEES_PER_SLOT: true,
+        TARGET_COMMITTEE_SIZE: true,
+        MAX_VALIDATORS_PER_COMMITTEE: true,
+        SHUFFLE_ROUND_COUNT: true,
+        HYSTERESIS_QUOTIENT: true,
+        HYSTERESIS_DOWNWARD_MULTIPLIER: true,
+        HYSTERESIS_UPWARD_MULTIPLIER: true,
+        // Gwei Values
+        MIN_DEPOSIT_AMOUNT: true,
+        MAX_EFFECTIVE_BALANCE: true,
+        EFFECTIVE_BALANCE_INCREMENT: true,
+        // Time parameters
+        MIN_ATTESTATION_INCLUSION_DELAY: true,
+        SLOTS_PER_EPOCH: true,
+        MIN_SEED_LOOKAHEAD: true,
+        MAX_SEED_LOOKAHEAD: true,
+        EPOCHS_PER_ETH1_VOTING_PERIOD: true,
+        SLOTS_PER_HISTORICAL_ROOT: true,
+        MIN_EPOCHS_TO_INACTIVITY_PENALTY: true,
+        // State vector lengths
+        EPOCHS_PER_HISTORICAL_VECTOR: true,
+        EPOCHS_PER_SLASHINGS_VECTOR: true,
+        HISTORICAL_ROOTS_LIMIT: true,
+        VALIDATOR_REGISTRY_LIMIT: true,
+        // Reward and penalty quotients
+        BASE_REWARD_FACTOR: true,
+        WHISTLEBLOWER_REWARD_QUOTIENT: true,
+        PROPOSER_REWARD_QUOTIENT: true,
+        INACTIVITY_PENALTY_QUOTIENT: true,
+        MIN_SLASHING_PENALTY_QUOTIENT: true,
+        PROPORTIONAL_SLASHING_MULTIPLIER: true,
+        // Max operations per block
+        MAX_PROPOSER_SLASHINGS: true,
+        MAX_ATTESTER_SLASHINGS: true,
+        MAX_ATTESTATIONS: true,
+        MAX_DEPOSITS: true,
+        MAX_VOLUNTARY_EXITS: true,
+        // # AltairPreset
+        /////////////////
+        SYNC_COMMITTEE_SIZE: altairForkRelevant,
+        EPOCHS_PER_SYNC_COMMITTEE_PERIOD: altairForkRelevant,
+        INACTIVITY_PENALTY_QUOTIENT_ALTAIR: altairForkRelevant,
+        MIN_SLASHING_PENALTY_QUOTIENT_ALTAIR: altairForkRelevant,
+        PROPORTIONAL_SLASHING_MULTIPLIER_ALTAIR: altairForkRelevant,
+        MIN_SYNC_COMMITTEE_PARTICIPANTS: false, // Only relevant for lightclients
+        UPDATE_TIMEOUT: false, // Only relevant for lightclients
+        // # BellatrixPreset
+        /////////////////
+        INACTIVITY_PENALTY_QUOTIENT_BELLATRIX: bellatrixForkRelevant,
+        MIN_SLASHING_PENALTY_QUOTIENT_BELLATRIX: bellatrixForkRelevant,
+        PROPORTIONAL_SLASHING_MULTIPLIER_BELLATRIX: bellatrixForkRelevant,
+        MAX_BYTES_PER_TRANSACTION: bellatrixForkRelevant,
+        MAX_TRANSACTIONS_PER_PAYLOAD: bellatrixForkRelevant,
+        BYTES_PER_LOGS_BLOOM: bellatrixForkRelevant,
+        MAX_EXTRA_DATA_BYTES: bellatrixForkRelevant,
+        // # CapellaPreset
+        /////////////////
+        MAX_BLS_TO_EXECUTION_CHANGES: capellaForkRelevant,
+        MAX_WITHDRAWALS_PER_PAYLOAD: capellaForkRelevant,
+        MAX_VALIDATORS_PER_WITHDRAWALS_SWEEP: capellaForkRelevant,
+        // # DenebPreset
+        /////////////////
+        FIELD_ELEMENTS_PER_BLOB: denebForkRelevant,
+        MAX_BLOB_COMMITMENTS_PER_BLOCK: denebForkRelevant,
+        KZG_COMMITMENT_INCLUSION_PROOF_DEPTH: denebForkRelevant,
+        MAX_BLOBS_PER_BLOCK: denebForkRelevant,
+        // ELECTRA
+        MAX_DEPOSIT_REQUESTS_PER_PAYLOAD: electraForkRelevant,
+        MAX_WITHDRAWAL_REQUESTS_PER_PAYLOAD: electraForkRelevant,
+        MAX_ATTESTER_SLASHINGS_ELECTRA: electraForkRelevant,
+        MAX_ATTESTATIONS_ELECTRA: electraForkRelevant,
+        MAX_PENDING_PARTIALS_PER_WITHDRAWALS_SWEEP: electraForkRelevant,
+        MAX_PENDING_DEPOSITS_PER_EPOCH: electraForkRelevant,
+        MAX_EFFECTIVE_BALANCE_ELECTRA: electraForkRelevant,
+        MIN_SLASHING_PENALTY_QUOTIENT_ELECTRA: electraForkRelevant,
+        MIN_ACTIVATION_BALANCE: electraForkRelevant,
+        PENDING_DEPOSITS_LIMIT: electraForkRelevant,
+        PENDING_PARTIAL_WITHDRAWALS_LIMIT: electraForkRelevant,
+        PENDING_CONSOLIDATIONS_LIMIT: electraForkRelevant,
+        MAX_CONSOLIDATION_REQUESTS_PER_PAYLOAD: electraForkRelevant,
+        WHISTLEBLOWER_REWARD_QUOTIENT_ELECTRA: electraForkRelevant,
+        MAX_PER_EPOCH_ACTIVATION_EXIT_CHURN_LIMIT: electraForkRelevant,
+        MIN_PER_EPOCH_CHURN_LIMIT_ELECTRA: electraForkRelevant,
+        MAX_BLOBS_PER_BLOCK_ELECTRA: electraForkRelevant,
+        // FULU
+        /////////////////
+        CELLS_PER_EXT_BLOB: fuluForkRelevant,
+        FIELD_ELEMENTS_PER_CELL: fuluForkRelevant,
+        FIELD_ELEMENTS_PER_EXT_BLOB: fuluForkRelevant,
+        KZG_COMMITMENTS_INCLUSION_PROOF_DEPTH: fuluForkRelevant,
+        NUMBER_OF_COLUMNS: fuluForkRelevant,
+        NUMBER_OF_CUSTODY_GROUPS: fuluForkRelevant,
+        SAMPLES_PER_SLOT: fuluForkRelevant,
+        CUSTODY_REQUIREMENT: fuluForkRelevant,
+        VALIDATOR_CUSTODY_REQUIREMENT: fuluForkRelevant,
+        BALANCE_PER_ADDITIONAL_CUSTODY_GROUP: fuluForkRelevant,
+        BLOB_SCHEDULE: fuluForkRelevant,
+        // GLOAS
+        ATTESTATION_DUE_BPS_GLOAS: gloasForkRelevant,
+        AGGREGATE_DUE_BPS_GLOAS: gloasForkRelevant,
+        SYNC_MESSAGE_DUE_BPS_GLOAS: gloasForkRelevant,
+        CONTRIBUTION_DUE_BPS_GLOAS: gloasForkRelevant,
+        PAYLOAD_ATTESTATION_DUE_BPS: gloasForkRelevant,
+        PAYLOAD_DUE_BPS: gloasForkRelevant,
+        PTC_SIZE: gloasForkRelevant,
+        MAX_PAYLOAD_ATTESTATIONS: gloasForkRelevant,
+        MAX_BUILDER_DEPOSIT_REQUESTS_PER_PAYLOAD: gloasForkRelevant,
+        MAX_BUILDER_EXIT_REQUESTS_PER_PAYLOAD: gloasForkRelevant,
+        MAX_BUILDERS_PER_WITHDRAWALS_SWEEP: gloasForkRelevant,
+        MAX_SIGNED_AGGREGATE_AND_PROOF_SIZE: false,
+        MAX_ATTESTER_SLASHING_SIZE: false,
+        MAX_DATA_COLUMN_SIDECAR_SIZE: false,
+        MAX_PARTIAL_DATA_COLUMN_SIDECAR_SIZE: false,
+        MAX_SIGNED_EXECUTION_PAYLOAD_BID_SIZE: false,
+        MIN_BUILDER_WITHDRAWABILITY_DELAY: gloasForkRelevant,
+        // FastConfirmationRule
+        CONFIRMATION_BYZANTINE_THRESHOLD: false,
+        CHURN_LIMIT_QUOTIENT_GLOAS: gloasForkRelevant,
+        CONSOLIDATION_CHURN_LIMIT_QUOTIENT: gloasForkRelevant,
+        MAX_PER_EPOCH_ACTIVATION_CHURN_LIMIT_GLOAS: gloasForkRelevant,
+    };
+}
+//# sourceMappingURL=params.js.map

package/lib/chainConfig/params.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lodestar/config",
-  "version": "1.46.0-dev.8fc4e297d2",
+  "version": "1.46.0-dev.9b97bb94f2",
   "description": "Chain configuration required for lodestar",
   "author": "ChainSafe Systems",
   "license": "Apache-2.0",
@@ -11,27 +11,27 @@
   "type": "module",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
+      "typescript": "./src/index.ts",
       "types": "./lib/index.d.ts",
       "import": "./lib/index.js"
     },
     "./default": {
-      "bun": "./src/default.ts",
+      "typescript": "./src/default.ts",
       "types": "./lib/default.d.ts",
       "import": "./lib/default.js"
     },
     "./networks": {
-      "bun": "./src/networks.ts",
+      "typescript": "./src/networks.ts",
       "types": "./lib/networks.d.ts",
       "import": "./lib/networks.js"
     },
     "./configs": {
-      "bun": "./src/configs.ts",
+      "typescript": "./src/configs.ts",
       "types": "./lib/configs.d.ts",
       "import": "./lib/configs.js"
     },
     "./test-utils": {
-      "bun": "./src/testUtils/index.ts",
+      "typescript": "./src/testUtils/index.ts",
       "types": "./lib/testUtils/index.d.ts",
       "import": "./lib/testUtils/index.js"
     }
@@ -67,9 +67,9 @@
   "dependencies": {
     "@chainsafe/as-sha256": "^1.2.4",
     "@chainsafe/ssz": "^1.6.2",
-    "@lodestar/params": "^1.46.0-dev.8fc4e297d2",
-    "@lodestar/types": "^1.46.0-dev.8fc4e297d2",
-    "@lodestar/utils": "^1.46.0-dev.8fc4e297d2"
+    "@lodestar/params": "^1.46.0-dev.9b97bb94f2",
+    "@lodestar/types": "^1.46.0-dev.9b97bb94f2",
+    "@lodestar/utils": "^1.46.0-dev.9b97bb94f2"
   },
-  "gitHead": "c2a9e6cb14fc9deaf272eca7289ef323ebbe2e47"
+  "gitHead": "31e8100601cb10f866cb2b79797b605fa9914774"
 }

package/src/chainConfig/index.ts

@@ -4,6 +4,7 @@ import {ChainConfig} from "./types.js";
 
 export * from "./default.js";
 export {chainConfigFromJson, chainConfigToJson, deserializeBlobSchedule, specValuesToJson} from "./json.js";
+export {NotEqualParamsError, assertEqualParams} from "./params.js";
 export * from "./types.js";
 
 /**

package/src/chainConfig/params.ts

@@ -0,0 +1,345 @@
+import {BeaconPreset, activePreset, presetToJson} from "@lodestar/params";
+import {chainConfigToJson, deserializeBlobSchedule} from "./json.js";
+import {BlobScheduleEntry, ChainConfig, SpecJson} from "./types.js";
+
+export class NotEqualParamsError extends Error {}
+
+type ConfigWithPreset = ChainConfig & BeaconPreset;
+
+/**
+ * Assert localConfig values match externalSpecJson. externalSpecJson may contain more values than localConfig.
+ *
+ * This check ensures that the validator is connected to a beacon node of the exact same network and params.
+ * Otherwise, signatures may be rejected, time may be un-equal and other bugs that are harder to debug caused
+ * by different parameters.
+ *
+ * This check however can't compare the full config as is, since some parameters are not critical to the spec and
+ * can be changed un-expectedly. Also, fork parameters can change un-expectedly, like their _FORK_VERSION or _EPOCH.
+ * Note that the config API endpoint is not precisely specified, so each clients can return a different set of
+ * parameters.
+ *
+ * So this check only compares a specific list of parameters that are consensus critical, ignoring the rest. Typed
+ * config and preset ensure new parameters are labeled critical or ignore, facilitating maintenance of the list.
+ */
+export function assertEqualParams(localConfig: ChainConfig, externalSpecJson: SpecJson): void {
+  // Before comparing, add preset which is bundled in api impl config route.
+  // config and preset must be serialized to JSON for safe comparisions.
+  const localSpecJson = {
+    ...chainConfigToJson(localConfig),
+    ...presetToJson(activePreset),
+  };
+
+  // Get list of keys to check, and keys to ignore. Otherwise this function throws for false positives
+  const criticalParams = getSpecCriticalParams(localConfig);
+
+  // Accumulate errors first and print all of them at once
+  const errors: string[] = [];
+
+  for (const key of Object.keys(criticalParams) as (keyof typeof criticalParams)[]) {
+    if (
+      // Ignore non-critical params
+      !criticalParams[key] ||
+      // This condition should never be true, but just in case
+      localSpecJson[key] === undefined ||
+      // The config/spec endpoint is poorly specified, so in practice each client returns a custom selection of keys.
+      // For example Lighthouse returns a manually selected list of keys that may be updated at any time.
+      // https://github.com/sigp/lighthouse/blob/bac7c3fa544495a257722aaad9cd8f72fee2f2b4/consensus/types/src/chain_spec.rs#L941
+      //
+      // So if we assert that spec critical keys are present in the spec we may break interoperability unexpectedly.
+      // So it's best to ignore keys are not defined in both specs and trust that the ones defined are sufficient
+      // to detect spec discrepancies in all cases.
+      externalSpecJson[key] === undefined
+    ) {
+      continue;
+    }
+
+    if (key === "BLOB_SCHEDULE") {
+      const localBlobSchedule = deserializeBlobSchedule(localSpecJson[key]).sort((a, b) => a.EPOCH - b.EPOCH);
+      const remoteBlobSchedule = deserializeBlobSchedule(externalSpecJson[key]).sort((a, b) => a.EPOCH - b.EPOCH);
+
+      if (localBlobSchedule.length !== remoteBlobSchedule.length) {
+        errors.push(`BLOB_SCHEDULE different length: ${localBlobSchedule.length} != ${remoteBlobSchedule.length}`);
+
+        // Skip per entry comparison
+        continue;
+      }
+
+      for (let i = 0; i < localBlobSchedule.length; i++) {
+        const localEntry = localBlobSchedule[i];
+        const remoteEntry = remoteBlobSchedule[i];
+
+        for (const entryKey of ["EPOCH", "MAX_BLOBS_PER_BLOCK"] as Array<keyof BlobScheduleEntry>) {
+          const localValue = String(localEntry[entryKey]);
+          const remoteValue = String(remoteEntry[entryKey]);
+
+          if (localValue !== remoteValue) {
+            errors.push(`BLOB_SCHEDULE[${i}].${entryKey} different value: ${localValue} != ${remoteValue}`);
+          }
+        }
+      }
+
+      // Skip generic string comparison
+      continue;
+    }
+
+    // Must compare JSON serialized specs, to ensure all strings are rendered in the same way
+    // Must compare as lowercase to ensure checksum addresses and names have same capilatization
+    const localValue = String(localSpecJson[key]).toLocaleLowerCase();
+    const remoteValue = String(externalSpecJson[key]).toLocaleLowerCase();
+    if (localValue !== remoteValue) {
+      errors.push(`${key} different value: ${localValue} != ${remoteValue}`);
+    }
+  }
+
+  if (errors.length > 0) {
+    throw new NotEqualParamsError("Local and remote configs are different\n" + errors.join("\n"));
+  }
+}
+
+function getSpecCriticalParams(localConfig: ChainConfig): Record<keyof ConfigWithPreset, boolean> {
+  const altairForkRelevant = localConfig.ALTAIR_FORK_EPOCH < Infinity;
+  const bellatrixForkRelevant = localConfig.BELLATRIX_FORK_EPOCH < Infinity;
+  const capellaForkRelevant = localConfig.CAPELLA_FORK_EPOCH < Infinity;
+  const denebForkRelevant = localConfig.DENEB_FORK_EPOCH < Infinity;
+  const electraForkRelevant = localConfig.ELECTRA_FORK_EPOCH < Infinity;
+  const fuluForkRelevant = localConfig.FULU_FORK_EPOCH < Infinity;
+  const gloasForkRelevant = localConfig.GLOAS_FORK_EPOCH < Infinity;
+
+  return {
+    // # Config
+    ///////////
+
+    PRESET_BASE: false, // Not relevant, each preset value is checked below
+    CONFIG_NAME: false, // Arbitrary string, not relevant
+
+    // Deprecated - All networks have completed the merge transition
+    TERMINAL_TOTAL_DIFFICULTY: false,
+    TERMINAL_BLOCK_HASH: false,
+    TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH: false,
+
+    // Genesis
+    MIN_GENESIS_ACTIVE_VALIDATOR_COUNT: true,
+    MIN_GENESIS_TIME: true,
+    GENESIS_FORK_VERSION: true,
+    GENESIS_DELAY: true,
+
+    // Forking
+    // Altair
+    ALTAIR_FORK_VERSION: altairForkRelevant,
+    ALTAIR_FORK_EPOCH: altairForkRelevant,
+    // Bellatrix
+    BELLATRIX_FORK_VERSION: bellatrixForkRelevant,
+    BELLATRIX_FORK_EPOCH: bellatrixForkRelevant,
+    // Capella
+    CAPELLA_FORK_VERSION: capellaForkRelevant,
+    CAPELLA_FORK_EPOCH: capellaForkRelevant,
+    // Deneb
+    DENEB_FORK_VERSION: denebForkRelevant,
+    DENEB_FORK_EPOCH: denebForkRelevant,
+    // electra
+    ELECTRA_FORK_VERSION: electraForkRelevant,
+    ELECTRA_FORK_EPOCH: electraForkRelevant,
+    // fulu
+    FULU_FORK_VERSION: fuluForkRelevant,
+    FULU_FORK_EPOCH: fuluForkRelevant,
+    // gloas
+    GLOAS_FORK_VERSION: gloasForkRelevant,
+    GLOAS_FORK_EPOCH: gloasForkRelevant,
+
+    // Time parameters
+    SECONDS_PER_SLOT: false, // Deprecated
+    SLOT_DURATION_MS: true,
+    SECONDS_PER_ETH1_BLOCK: false, // Legacy
+    MIN_VALIDATOR_WITHDRAWABILITY_DELAY: true,
+    SHARD_COMMITTEE_PERIOD: true,
+    ETH1_FOLLOW_DISTANCE: true,
+    PROPOSER_REORG_CUTOFF_BPS: true,
+    ATTESTATION_DUE_BPS: true,
+    AGGREGATE_DUE_BPS: true,
+    // Altair
+    SYNC_MESSAGE_DUE_BPS: altairForkRelevant,
+    CONTRIBUTION_DUE_BPS: altairForkRelevant,
+
+    // Validator cycle
+    INACTIVITY_SCORE_BIAS: true,
+    INACTIVITY_SCORE_RECOVERY_RATE: true,
+    EJECTION_BALANCE: true,
+    MIN_PER_EPOCH_CHURN_LIMIT: true,
+    MAX_PER_EPOCH_ACTIVATION_CHURN_LIMIT: denebForkRelevant,
+    CHURN_LIMIT_QUOTIENT: true,
+
+    // Fork choice
+    PROPOSER_SCORE_BOOST: false, // Ignored as it's changing https://github.com/ethereum/consensus-specs/pull/2895
+    REORG_HEAD_WEIGHT_THRESHOLD: false, // Non-critical since proposer boost reorg is optional feature
+    REORG_PARENT_WEIGHT_THRESHOLD: false, // Non-critical since proposer boost reorg is optional feature
+    REORG_MAX_EPOCHS_SINCE_FINALIZATION: false, // Non-critical since proposer boost reorg is optional feature
+
+    // Deposit contract
+    DEPOSIT_CHAIN_ID: false, // Non-critical
+    DEPOSIT_NETWORK_ID: false, // Non-critical
+    DEPOSIT_CONTRACT_ADDRESS: true,
+
+    // Networking (non-critical as those do not affect consensus)
+    MAX_PAYLOAD_SIZE: false,
+    EPOCHS_PER_SUBNET_SUBSCRIPTION: false,
+    ATTESTATION_PROPAGATION_SLOT_RANGE: false,
+    MAXIMUM_GOSSIP_CLOCK_DISPARITY: false,
+    MESSAGE_DOMAIN_INVALID_SNAPPY: false,
+    MESSAGE_DOMAIN_VALID_SNAPPY: false,
+    SUBNETS_PER_NODE: false,
+    MAX_REQUEST_BLOCKS: false,
+    MAX_REQUEST_BLOCKS_DENEB: false,
+    MIN_EPOCHS_FOR_BLOCK_REQUESTS: false,
+    MIN_EPOCHS_FOR_BLOB_SIDECARS_REQUESTS: false,
+    MIN_EPOCHS_FOR_DATA_COLUMN_SIDECARS_REQUESTS: false,
+    BLOB_SIDECAR_SUBNET_COUNT: false,
+    BLOB_SIDECAR_SUBNET_COUNT_ELECTRA: false,
+    DATA_COLUMN_SIDECAR_SUBNET_COUNT: false,
+    MAX_REQUEST_BLOB_SIDECARS: false,
+    MAX_REQUEST_BLOB_SIDECARS_ELECTRA: false,
+    MAX_REQUEST_DATA_COLUMN_SIDECARS: false,
+    MAX_REQUEST_PAYLOADS: false,
+
+    // # Phase0Preset
+    /////////////////
+
+    MAX_COMMITTEES_PER_SLOT: true,
+    TARGET_COMMITTEE_SIZE: true,
+    MAX_VALIDATORS_PER_COMMITTEE: true,
+
+    SHUFFLE_ROUND_COUNT: true,
+
+    HYSTERESIS_QUOTIENT: true,
+    HYSTERESIS_DOWNWARD_MULTIPLIER: true,
+    HYSTERESIS_UPWARD_MULTIPLIER: true,
+
+    // Gwei Values
+    MIN_DEPOSIT_AMOUNT: true,
+    MAX_EFFECTIVE_BALANCE: true,
+    EFFECTIVE_BALANCE_INCREMENT: true,
+
+    // Time parameters
+    MIN_ATTESTATION_INCLUSION_DELAY: true,
+    SLOTS_PER_EPOCH: true,
+    MIN_SEED_LOOKAHEAD: true,
+    MAX_SEED_LOOKAHEAD: true,
+    EPOCHS_PER_ETH1_VOTING_PERIOD: true,
+    SLOTS_PER_HISTORICAL_ROOT: true,
+    MIN_EPOCHS_TO_INACTIVITY_PENALTY: true,
+
+    // State vector lengths
+    EPOCHS_PER_HISTORICAL_VECTOR: true,
+    EPOCHS_PER_SLASHINGS_VECTOR: true,
+    HISTORICAL_ROOTS_LIMIT: true,
+    VALIDATOR_REGISTRY_LIMIT: true,
+
+    // Reward and penalty quotients
+    BASE_REWARD_FACTOR: true,
+    WHISTLEBLOWER_REWARD_QUOTIENT: true,
+    PROPOSER_REWARD_QUOTIENT: true,
+    INACTIVITY_PENALTY_QUOTIENT: true,
+    MIN_SLASHING_PENALTY_QUOTIENT: true,
+    PROPORTIONAL_SLASHING_MULTIPLIER: true,
+
+    // Max operations per block
+    MAX_PROPOSER_SLASHINGS: true,
+    MAX_ATTESTER_SLASHINGS: true,
+    MAX_ATTESTATIONS: true,
+    MAX_DEPOSITS: true,
+    MAX_VOLUNTARY_EXITS: true,
+
+    // # AltairPreset
+    /////////////////
+
+    SYNC_COMMITTEE_SIZE: altairForkRelevant,
+    EPOCHS_PER_SYNC_COMMITTEE_PERIOD: altairForkRelevant,
+    INACTIVITY_PENALTY_QUOTIENT_ALTAIR: altairForkRelevant,
+    MIN_SLASHING_PENALTY_QUOTIENT_ALTAIR: altairForkRelevant,
+    PROPORTIONAL_SLASHING_MULTIPLIER_ALTAIR: altairForkRelevant,
+    MIN_SYNC_COMMITTEE_PARTICIPANTS: false, // Only relevant for lightclients
+    UPDATE_TIMEOUT: false, // Only relevant for lightclients
+
+    // # BellatrixPreset
+    /////////////////
+
+    INACTIVITY_PENALTY_QUOTIENT_BELLATRIX: bellatrixForkRelevant,
+    MIN_SLASHING_PENALTY_QUOTIENT_BELLATRIX: bellatrixForkRelevant,
+    PROPORTIONAL_SLASHING_MULTIPLIER_BELLATRIX: bellatrixForkRelevant,
+    MAX_BYTES_PER_TRANSACTION: bellatrixForkRelevant,
+    MAX_TRANSACTIONS_PER_PAYLOAD: bellatrixForkRelevant,
+    BYTES_PER_LOGS_BLOOM: bellatrixForkRelevant,
+    MAX_EXTRA_DATA_BYTES: bellatrixForkRelevant,
+
+    // # CapellaPreset
+    /////////////////
+    MAX_BLS_TO_EXECUTION_CHANGES: capellaForkRelevant,
+    MAX_WITHDRAWALS_PER_PAYLOAD: capellaForkRelevant,
+    MAX_VALIDATORS_PER_WITHDRAWALS_SWEEP: capellaForkRelevant,
+
+    // # DenebPreset
+    /////////////////
+    FIELD_ELEMENTS_PER_BLOB: denebForkRelevant,
+    MAX_BLOB_COMMITMENTS_PER_BLOCK: denebForkRelevant,
+    KZG_COMMITMENT_INCLUSION_PROOF_DEPTH: denebForkRelevant,
+    MAX_BLOBS_PER_BLOCK: denebForkRelevant,
+
+    // ELECTRA
+    MAX_DEPOSIT_REQUESTS_PER_PAYLOAD: electraForkRelevant,
+    MAX_WITHDRAWAL_REQUESTS_PER_PAYLOAD: electraForkRelevant,
+    MAX_ATTESTER_SLASHINGS_ELECTRA: electraForkRelevant,
+    MAX_ATTESTATIONS_ELECTRA: electraForkRelevant,
+    MAX_PENDING_PARTIALS_PER_WITHDRAWALS_SWEEP: electraForkRelevant,
+    MAX_PENDING_DEPOSITS_PER_EPOCH: electraForkRelevant,
+    MAX_EFFECTIVE_BALANCE_ELECTRA: electraForkRelevant,
+    MIN_SLASHING_PENALTY_QUOTIENT_ELECTRA: electraForkRelevant,
+    MIN_ACTIVATION_BALANCE: electraForkRelevant,
+    PENDING_DEPOSITS_LIMIT: electraForkRelevant,
+    PENDING_PARTIAL_WITHDRAWALS_LIMIT: electraForkRelevant,
+    PENDING_CONSOLIDATIONS_LIMIT: electraForkRelevant,
+    MAX_CONSOLIDATION_REQUESTS_PER_PAYLOAD: electraForkRelevant,
+    WHISTLEBLOWER_REWARD_QUOTIENT_ELECTRA: electraForkRelevant,
+    MAX_PER_EPOCH_ACTIVATION_EXIT_CHURN_LIMIT: electraForkRelevant,
+    MIN_PER_EPOCH_CHURN_LIMIT_ELECTRA: electraForkRelevant,
+    MAX_BLOBS_PER_BLOCK_ELECTRA: electraForkRelevant,
+
+    // FULU
+    /////////////////
+    CELLS_PER_EXT_BLOB: fuluForkRelevant,
+    FIELD_ELEMENTS_PER_CELL: fuluForkRelevant,
+    FIELD_ELEMENTS_PER_EXT_BLOB: fuluForkRelevant,
+    KZG_COMMITMENTS_INCLUSION_PROOF_DEPTH: fuluForkRelevant,
+    NUMBER_OF_COLUMNS: fuluForkRelevant,
+    NUMBER_OF_CUSTODY_GROUPS: fuluForkRelevant,
+    SAMPLES_PER_SLOT: fuluForkRelevant,
+    CUSTODY_REQUIREMENT: fuluForkRelevant,
+    VALIDATOR_CUSTODY_REQUIREMENT: fuluForkRelevant,
+    BALANCE_PER_ADDITIONAL_CUSTODY_GROUP: fuluForkRelevant,
+    BLOB_SCHEDULE: fuluForkRelevant,
+
+    // GLOAS
+    ATTESTATION_DUE_BPS_GLOAS: gloasForkRelevant,
+    AGGREGATE_DUE_BPS_GLOAS: gloasForkRelevant,
+    SYNC_MESSAGE_DUE_BPS_GLOAS: gloasForkRelevant,
+    CONTRIBUTION_DUE_BPS_GLOAS: gloasForkRelevant,
+    PAYLOAD_ATTESTATION_DUE_BPS: gloasForkRelevant,
+    PAYLOAD_DUE_BPS: gloasForkRelevant,
+    PTC_SIZE: gloasForkRelevant,
+    MAX_PAYLOAD_ATTESTATIONS: gloasForkRelevant,
+    MAX_BUILDER_DEPOSIT_REQUESTS_PER_PAYLOAD: gloasForkRelevant,
+    MAX_BUILDER_EXIT_REQUESTS_PER_PAYLOAD: gloasForkRelevant,
+    MAX_BUILDERS_PER_WITHDRAWALS_SWEEP: gloasForkRelevant,
+    MAX_SIGNED_AGGREGATE_AND_PROOF_SIZE: false,
+    MAX_ATTESTER_SLASHING_SIZE: false,
+    MAX_DATA_COLUMN_SIDECAR_SIZE: false,
+    MAX_PARTIAL_DATA_COLUMN_SIDECAR_SIZE: false,
+    MAX_SIGNED_EXECUTION_PAYLOAD_BID_SIZE: false,
+    MIN_BUILDER_WITHDRAWABILITY_DELAY: gloasForkRelevant,
+
+    // FastConfirmationRule
+    CONFIRMATION_BYZANTINE_THRESHOLD: false,
+
+    CHURN_LIMIT_QUOTIENT_GLOAS: gloasForkRelevant,
+    CONSOLIDATION_CHURN_LIMIT_QUOTIENT: gloasForkRelevant,
+    MAX_PER_EPOCH_ACTIVATION_CHURN_LIMIT_GLOAS: gloasForkRelevant,
+  };
+}