@chainsafe/lodestar 1.38.0 → 1.39.0-dev.2fe8de2346

package/src/networks/ephemery.ts

@@ -1,6 +1,5 @@
 export {ephemeryChainConfig as chainConfig} from "@lodestar/config/networks";
 
-export const depositContractDeployBlock = 0;
 export const genesisFileUrl = "https://ephemery.dev/latest/genesis.ssz";
 export const genesisStateRoot = null;
 export const bootnodesFileUrl = "https://ephemery.dev/latest/bootstrap_nodes.txt";

package/src/networks/gnosis.ts

@@ -1,7 +1,5 @@
 export {gnosisChainConfig as chainConfig} from "@lodestar/config/networks";
 
-// eth1.providerUrls suggestion: https://rpc.gnosischain.com
-export const depositContractDeployBlock = 19469077;
 export const genesisFileUrl = "https://raw.githubusercontent.com/gnosischain/configs/main/mainnet/genesis.ssz";
 export const genesisStateRoot = "0x1511578d6de70428bf3529ab92102f21070694cb205443437fae359a7f220537";
 export const bootnodesFileUrl = "https://raw.githubusercontent.com/gnosischain/configs/main/mainnet/bootnodes.yaml";

package/src/networks/hoodi.ts

@@ -1,6 +1,5 @@
 export {hoodiChainConfig as chainConfig} from "@lodestar/config/networks";
 
-export const depositContractDeployBlock = 0;
 export const genesisFileUrl = "https://media.githubusercontent.com/media/eth-clients/hoodi/main/metadata/genesis.ssz";
 export const genesisStateRoot = "0x2683ebc120f91f740c7bed4c866672d01e1ba51b4cc360297138465ee5df40f0";
 export const bootnodesFileUrl =

package/src/networks/index.ts

@@ -49,7 +49,6 @@ const GET_STATE_LOG_INTERVAL = 30 * 1000;
 
 export function getNetworkData(network: NetworkName): {
   chainConfig: ChainConfig;
-  depositContractDeployBlock: number;
   genesisFileUrl: string | null;
   genesisStateRoot: string | null;
   bootnodesFileUrl: string | null;

package/src/networks/mainnet.ts

@@ -1,6 +1,5 @@
 export {mainnetChainConfig as chainConfig} from "@lodestar/config/networks";
 
-export const depositContractDeployBlock = 11052984;
 export const genesisFileUrl =
   "https://raw.githubusercontent.com/eth-clients/mainnet/refs/heads/main/metadata/genesis.ssz";
 export const genesisStateRoot = "0x7e76880eb67bbdc86250aa578958e9d0675e64e714337855204fb5abaaf82c2b";

package/src/networks/sepolia.ts

@@ -1,6 +1,5 @@
 export {sepoliaChainConfig as chainConfig} from "@lodestar/config/networks";
 
-export const depositContractDeployBlock = 1273020;
 export const genesisFileUrl = "https://github.com/eth-clients/sepolia/raw/main/metadata/genesis.ssz";
 export const genesisStateRoot = "0xfb9afe32150fa39f4b346be2519a67e2a4f5efcd50a1dc192c3f6b3d013d2798";
 export const bootnodesFileUrl =

package/src/options/beaconNodeOptions/chain.ts

@@ -23,7 +23,6 @@ export type ChainArgs = {
   "chain.computeUnrealized"?: boolean;
   "chain.assertCorrectProgressiveBalances"?: boolean;
   "chain.maxSkipSlots"?: number;
-  "safe-slots-to-import-optimistically": number;
   emitPayloadAttributes?: boolean;
   broadcastValidationStrictness?: string;
   "chain.minSameMessageSignatureSetsToBatch"?: number;
@@ -63,7 +62,6 @@ export function parseArgs(args: ChainArgs): IBeaconNodeOptions["chain"] {
     computeUnrealized: args["chain.computeUnrealized"],
     assertCorrectProgressiveBalances: args["chain.assertCorrectProgressiveBalances"],
     maxSkipSlots: args["chain.maxSkipSlots"],
-    safeSlotsToImportOptimistically: args["safe-slots-to-import-optimistically"],
     emitPayloadAttributes: args.emitPayloadAttributes,
     broadcastValidationStrictness: args.broadcastValidationStrictness,
     minSameMessageSignatureSetsToBatch:
@@ -227,15 +225,6 @@ Will double processing times. Use only for debugging purposes.",
     group: "chain",
   },
 
-  "safe-slots-to-import-optimistically": {
-    hidden: true,
-    type: "number",
-    description:
-      "Slots from current (clock) slot till which its safe to import a block optimistically if the merge is not justified yet.",
-    default: defaultOptions.chain.safeSlotsToImportOptimistically,
-    group: "chain",
-  },
-
   "chain.archiveStateEpochFrequency": {
     description: "Minimum number of epochs between archived states",
     default: defaultOptions.chain.archiveStateEpochFrequency,

package/src/options/beaconNodeOptions/eth1.ts

@@ -1,58 +1,40 @@
-import fs from "node:fs";
-import {IBeaconNodeOptions, defaultOptions} from "@lodestar/beacon-node";
 import {CliCommandOptions} from "@lodestar/utils";
-import {extractJwtHexSecret} from "../../util/index.js";
-import {ExecutionEngineArgs} from "./execution.js";
 
+/**
+ * @deprecated These options are no longer used since eth1 deposit tracking was removed.
+ */
 export type Eth1Args = {
+  /** @deprecated */
   eth1?: boolean;
+  /** @deprecated */
   "eth1.providerUrls"?: string[];
+  /** @deprecated */
   "eth1.depositContractDeployBlock"?: number;
+  /** @deprecated */
   "eth1.disableEth1DepositDataTracker"?: boolean;
+  /** @deprecated */
   "eth1.unsafeAllowDepositDataOverwrite"?: boolean;
+  /** @deprecated */
   "eth1.forcedEth1DataVote"?: string;
 };
 
-export function parseArgs(args: Eth1Args & Partial<ExecutionEngineArgs>): IBeaconNodeOptions["eth1"] {
-  let jwtSecretHex: string | undefined;
-  let jwtId: string | undefined;
-
-  let providerUrls = args["eth1.providerUrls"];
-
-  // If no providerUrls are explicitly provided, we should pick the execution endpoint
-  // because as per Kiln spec v2.1, execution *must* host the `eth_` methods necessary
-  // for deposit and merge trackers on engine endpoints as well protected by a
-  // jwt auth mechanism.
-  if (providerUrls === undefined && args["execution.urls"]) {
-    providerUrls = args["execution.urls"];
-    jwtSecretHex = args.jwtSecret ? extractJwtHexSecret(fs.readFileSync(args.jwtSecret, "utf-8").trim()) : undefined;
-    jwtId = args.jwtId;
-  }
-
-  return {
-    enabled: args.eth1,
-    providerUrls,
-    jwtSecretHex,
-    jwtId,
-    depositContractDeployBlock: args["eth1.depositContractDeployBlock"],
-    disableEth1DepositDataTracker: args["eth1.disableEth1DepositDataTracker"],
-    unsafeAllowDepositDataOverwrite: args["eth1.unsafeAllowDepositDataOverwrite"],
-    forcedEth1DataVote: args["eth1.forcedEth1DataVote"],
-  };
-}
-
+/**
+ * @deprecated These options are no longer used since eth1 deposit tracking was removed.
+ */
 export const options: CliCommandOptions<Eth1Args> = {
   eth1: {
+    hidden: true,
+    deprecated: true,
     description: "Whether to follow the eth1 chain",
     type: "boolean",
-    defaultDescription: String(defaultOptions.eth1.enabled),
     group: "eth1",
   },
 
   "eth1.providerUrls": {
+    hidden: true,
+    deprecated: true,
     description:
       "Urls to Eth1 node with enabled rpc. If not explicitly provided and execution endpoint provided via execution.urls, it will use execution.urls. Otherwise will try connecting on the specified default(s)",
-    defaultDescription: defaultOptions.eth1.providerUrls?.join(","),
     type: "array",
     string: true,
     coerce: (urls: string[]): string[] =>
@@ -63,31 +45,32 @@ export const options: CliCommandOptions<Eth1Args> = {
 
   "eth1.depositContractDeployBlock": {
     hidden: true,
+    deprecated: true,
     description: "Block number at which the deposit contract contract was deployed",
     type: "number",
-    defaultDescription: String(defaultOptions.eth1.depositContractDeployBlock),
     group: "eth1",
   },
 
   "eth1.disableEth1DepositDataTracker": {
     hidden: true,
+    deprecated: true,
     description: "Disable Eth1DepositDataTracker modules",
     type: "boolean",
-    defaultDescription: String(defaultOptions.eth1.disableEth1DepositDataTracker),
     group: "eth1",
   },
 
   "eth1.unsafeAllowDepositDataOverwrite": {
     hidden: true,
+    deprecated: true,
     description:
       "Allow the deposit tracker to overwrite previously fetched and saved deposit event data. Warning!!! This is an unsafe operation, so enable this flag only if you know what you are doing.",
     type: "boolean",
-    defaultDescription: String(defaultOptions.eth1.unsafeAllowDepositDataOverwrite),
     group: "eth1",
   },
 
   "eth1.forcedEth1DataVote": {
     hidden: true,
+    deprecated: true,
     description: "Vote for a specific eth1_data regardless of all conditions. Hex encoded ssz serialized Eth1Data type",
     type: "string",
     group: "eth1",

package/src/options/beaconNodeOptions/index.ts

@@ -27,7 +27,6 @@ export function parseBeaconNodeArgs(args: BeaconNodeArgs): RecursivePartial<IBea
     api: api.parseArgs(args),
     chain: chain.parseArgs(args),
     // db: {},
-    eth1: eth1.parseArgs(args),
     executionEngine: execution.parseArgs(args),
     executionBuilder: builder.parseArgs(args),
     metrics: metrics.parseArgs(args),

package/src/options/paramsOptions.ts

@@ -1,4 +1,4 @@
-import {ChainConfig, chainConfigTypes} from "@lodestar/config";
+import {chainConfigTypes} from "@lodestar/config";
 import {CliCommandOptions, CliOptionDefinition} from "@lodestar/utils";
 import {IBeaconParamsUnparsed} from "../config/types.js";
 import {ObjectKeys} from "../util/index.js";
@@ -7,12 +7,7 @@ import {ObjectKeys} from "../util/index.js";
 // If an arbitrary key notation is used, it removes type safety on most of this CLI arg parsing code.
 // Params will be parsed from an args object assuming to contain the required keys
 
-export type ITerminalPowArgs = {
-  "terminal-total-difficulty-override"?: string;
-  "terminal-block-hash-override"?: string;
-  "terminal-block-hash-epoch-override"?: string;
-};
-export type IParamsArgs = Record<never, never> & ITerminalPowArgs;
+export type IParamsArgs = Record<never, never>;
 
 const getArgKey = (key: keyof IBeaconParamsUnparsed): string => `params.${key}`;
 
@@ -24,7 +19,7 @@ export function parseBeaconParamsArgs(args: Record<string, string | number>): IB
   }, {});
 }
 
-const paramsOptionsByName = ObjectKeys(chainConfigTypes).reduce(
+export const paramsOptions: CliCommandOptions<IParamsArgs> = ObjectKeys(chainConfigTypes).reduce(
   (options: Record<string, CliOptionDefinition>, key): Record<string, CliOptionDefinition> => {
     options[getArgKey(key)] = {
       hidden: true,
@@ -35,38 +30,3 @@ const paramsOptionsByName = ObjectKeys(chainConfigTypes).reduce(
   },
   {}
 );
-
-const terminalArgsToParamsMap: {[K in keyof ITerminalPowArgs]: keyof ChainConfig} = {
-  "terminal-total-difficulty-override": "TERMINAL_TOTAL_DIFFICULTY",
-  "terminal-block-hash-override": "TERMINAL_BLOCK_HASH",
-  "terminal-block-hash-epoch-override": "TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH",
-};
-
-export function parseTerminalPowArgs(args: ITerminalPowArgs): IBeaconParamsUnparsed {
-  const parsedArgs = ObjectKeys(terminalArgsToParamsMap).reduce((beaconParams: Partial<IBeaconParamsUnparsed>, key) => {
-    const paramOption = terminalArgsToParamsMap[key];
-    const value = args[key];
-    if (paramOption != null && value != null) beaconParams[paramOption] = value;
-    return beaconParams;
-  }, {});
-  return parsedArgs;
-}
-
-export const paramsOptions: CliCommandOptions<IParamsArgs> = {
-  ...paramsOptionsByName,
-
-  "terminal-total-difficulty-override": {
-    description: "Terminal PoW block TTD override",
-    type: "string",
-  },
-
-  "terminal-block-hash-override": {
-    description: "Terminal PoW block hash override",
-    type: "string",
-  },
-
-  "terminal-block-hash-epoch-override": {
-    description: "Terminal PoW block hash override activation epoch",
-    type: "string",
-  },
-};