@lodestar/validator 1.50.0-dev.fef46df5ba → 1.50.0

package/src/services/proposalPreferences.ts

@@ -0,0 +1,308 @@
+import {ApiClient, ApiError, routes} from "@lodestar/api";
+import {ChainForkConfig} from "@lodestar/config";
+import {SLOTS_PER_EPOCH, isForkPostGloas} from "@lodestar/params";
+import {IClock, computeEpochAtSlot} from "@lodestar/state-transition";
+import {Epoch, RootHex, Slot, gloas} from "@lodestar/types";
+import {fromHex, toPubkeyHex} from "@lodestar/utils";
+import {Metrics} from "../metrics.js";
+import {LoggerVc} from "../util/index.js";
+import {BlockDutiesService} from "./blockDuties.js";
+import {SyncingStatusTracker} from "./syncingStatusTracker.js";
+import {ValidatorStore} from "./validatorStore.js";
+
+/**
+ * Submit the preferences of a proposal this many slots before the proposal slot.
+ *
+ * Earlier submission means more reorg-triggered resubmits (and gossip flood); later
+ * submission risks missing the bid-auction window for this proposal slot. The bid for
+ * slot S typically arrives at slot S-1, so we want preferences propagated to the network
+ * and consumed by builders before then. SLOTS_PER_EPOCH / 4 (8 slots @ 32 SPE, ~96s @ 12s
+ * slots) gives ample margin while bounding redundant resubmits.
+ */
+const SUBMIT_BEFORE_PROPOSAL_SLOTS = Math.floor(SLOTS_PER_EPOCH / 4);
+
+/** Per-epoch tracking of preferences already submitted under the current dependent_root. */
+type SubmittedAtEpoch = {dependentRoot: RootHex; proposerSlots: Set<Slot>; builderSlots: Set<Slot>};
+type PendingSubmission = {submission: SubmittedAtEpoch; slot: Slot};
+/** A local proposal within the submission window along with the tracking of its epoch */
+type UpcomingProposal = {duty: routes.validator.ProposerDuty; submission: SubmittedAtEpoch};
+
+/**
+ * Signs and submits the preferences of local proposals within the next `SUBMIT_BEFORE_PROPOSAL_SLOTS`:
+ * the `SignedProposerPreferences` the beacon node broadcasts on gossip and the builder preferences
+ * it forwards to the builders configured for the validator. Signing the builder request auths here
+ * also pre-fills the auth cache used at proposal time.
+ *
+ * Re-submits automatically when the proposer dependent root for an epoch shifts (e.g. after a reorg)
+ * since the proposer for a slot may have changed. Detected by comparing the cached `dependentRoot`
+ * reported by `BlockDutiesService` against the one we last submitted under.
+ *
+ * Proposers should broadcast their preferences before the fork so the proposer preference caches
+ * of beacon nodes and builders are warm for the first Gloas slots. We start submitting
+ * as soon as a duty's proposal slot is in Gloas, which is up to `SUBMIT_BEFORE_PROPOSAL_SLOTS`
+ * before the fork, so only the first few Gloas slots are affected by this pre-fork submission.
+ */
+export class ProposalPreferencesService {
+  private readonly submitted = new Map<Epoch, SubmittedAtEpoch>();
+  private activeScheduledGasLimit: number | undefined;
+
+  constructor(
+    private readonly config: ChainForkConfig,
+    private readonly logger: LoggerVc,
+    private readonly api: ApiClient,
+    clock: IClock,
+    private readonly validatorStore: ValidatorStore,
+    private readonly blockDutiesService: BlockDutiesService,
+    syncingStatusTracker: SyncingStatusTracker,
+    _metrics: Metrics | null
+  ) {
+    clock.runEverySlot(this.runPreferencesTask);
+    clock.runEveryEpoch(this.runEveryEpochTask);
+    syncingStatusTracker.runOnResynced(this.onResynced);
+  }
+
+  /**
+   * A beacon node that was unreachable or syncing may have restarted and lost the preferences it
+   * accepted, it keeps them in memory only. Submit everything within the window again, the beacon
+   * node ignores preferences it still has.
+   */
+  private onResynced = async (slot: Slot): Promise<void> => {
+    if (this.submitted.size === 0) {
+      return;
+    }
+
+    this.logger.verbose("Beacon node resynced; resubmitting preferences", {slot});
+    this.submitted.clear();
+    await this.runPreferencesTask(slot);
+  };
+
+  private runPreferencesTask = async (slot: Slot): Promise<void> => {
+    // Start running once the submission window (`slot + SUBMIT_BEFORE_PROPOSAL_SLOTS`) reaches
+    // Gloas, i.e. already in the epoch before the fork. This allows builders to prepare and
+    // submit bids for the first Gloas slots.
+    if (!isForkPostGloas(this.config.getForkName(slot + SUBMIT_BEFORE_PROPOSAL_SLOTS))) {
+      return;
+    }
+
+    const proposals = this.getUpcomingProposals(slot);
+    if (proposals.length === 0) {
+      return;
+    }
+
+    // Signed and submitted independently, a slow signer for one must not delay the other
+    await Promise.all([
+      this.submitProposerPreferences(proposals, slot),
+      this.submitBuilderPreferences(proposals, slot),
+    ]);
+  };
+
+  private runEveryEpochTask = async (epoch: Epoch): Promise<void> => {
+    const scheduledGasLimit = this.config.getScheduledGasLimit(epoch);
+    if (scheduledGasLimit !== undefined && scheduledGasLimit !== this.activeScheduledGasLimit) {
+      const configuredDefaultGasLimit = this.validatorStore.getConfiguredDefaultGasLimit();
+      this.logger.info("Gas limit schedule active", {
+        epoch,
+        recommendedGasLimit: scheduledGasLimit,
+        effectiveDefaultGasLimit: configuredDefaultGasLimit ?? scheduledGasLimit,
+        defaultGasLimitSource: configuredDefaultGasLimit === undefined ? "schedule" : "operator",
+      });
+      this.activeScheduledGasLimit = scheduledGasLimit;
+    }
+
+    // Drop tracking for past epochs; only currentEpoch and currentEpoch + 1 are ever processed.
+    for (const trackedEpoch of this.submitted.keys()) {
+      if (trackedEpoch < epoch) {
+        this.submitted.delete(trackedEpoch);
+      }
+    }
+  };
+
+  /** Resets the tracking of `epoch` if the dependent root shifted, previously submitted preferences are stale. */
+  private getSubmissionAtEpoch(epoch: Epoch, dependentRoot: RootHex): SubmittedAtEpoch {
+    let submission = this.submitted.get(epoch);
+    if (submission === undefined || submission.dependentRoot !== dependentRoot) {
+      if (submission !== undefined) {
+        this.logger.info("Proposer-shuffling dependent root shifted; resubmitting preferences", {
+          epoch,
+          priorDependentRoot: submission.dependentRoot,
+          dependentRoot,
+        });
+      }
+      submission = {dependentRoot, proposerSlots: new Set(), builderSlots: new Set()};
+      this.submitted.set(epoch, submission);
+    }
+    return submission;
+  }
+
+  private getUpcomingProposals(slot: Slot): UpcomingProposal[] {
+    const currentEpoch = computeEpochAtSlot(slot);
+    const proposals: UpcomingProposal[] = [];
+
+    for (const epoch of [currentEpoch, currentEpoch + 1]) {
+      const dutiesAtEpoch = this.blockDutiesService.getProposersAtEpoch(epoch);
+      if (!dutiesAtEpoch) continue;
+
+      const submission = this.getSubmissionAtEpoch(epoch, dutiesAtEpoch.dependentRoot);
+
+      for (const duty of dutiesAtEpoch.data) {
+        if (duty.slot <= slot) continue;
+        if (duty.slot > slot + SUBMIT_BEFORE_PROPOSAL_SLOTS) continue;
+        if (!isForkPostGloas(this.config.getForkName(duty.slot))) continue;
+
+        proposals.push({duty, submission});
+      }
+    }
+
+    return proposals;
+  }
+
+  private async submitProposerPreferences(proposals: UpcomingProposal[], slot: Slot): Promise<void> {
+    const signedProposerPreferences: gloas.SignedProposerPreferences[] = [];
+    // Track which `(submission, slot)` pairs are pending an API submission so we can mark
+    // them only after the network call succeeds. Marking before would silently drop a
+    // preference on transient API failure (no retry until dependent_root shifts).
+    const pending: PendingSubmission[] = [];
+
+    for (const {duty, submission} of proposals) {
+      if (submission.proposerSlots.has(duty.slot)) continue;
+
+      try {
+        const pubkeyHex = toPubkeyHex(duty.pubkey);
+        const signed = await this.validatorStore.signProposerPreferences(
+          duty,
+          fromHex(submission.dependentRoot),
+          this.validatorStore.getFeeRecipient(pubkeyHex),
+          this.validatorStore.getGasLimit(pubkeyHex, duty.slot, this.logger),
+          slot
+        );
+        signedProposerPreferences.push(signed);
+        pending.push({submission, slot: duty.slot});
+      } catch (e) {
+        this.logger.error(
+          "Error signing proposer preferences",
+          {slot: duty.slot, validatorIndex: duty.validatorIndex},
+          e as Error
+        );
+      }
+    }
+
+    if (signedProposerPreferences.length === 0) {
+      return;
+    }
+
+    try {
+      (await this.api.validator.submitProposerPreferences({signedProposerPreferences})).assertOk();
+      // Only mark as submitted after the API call succeeds; a thrown error leaves the
+      // slot eligible for retry on the next tick.
+      for (const {submission, slot: submittedSlot} of pending) {
+        submission.proposerSlots.add(submittedSlot);
+      }
+      this.logger.debug("Submitted signed proposer preferences", {count: signedProposerPreferences.length});
+    } catch (e) {
+      const failures = e instanceof ApiError ? e.failures : undefined;
+      if (failures === undefined) {
+        this.logger.error(
+          "Error submitting signed proposer preferences",
+          {count: signedProposerPreferences.length},
+          e as Error
+        );
+        return;
+      }
+
+      // The beacon node rejected some of the preferences, reported by index into the batch.
+      // Mark the accepted ones, the rejected ones are retried on the next tick.
+      const failedIndices = new Set(failures.map(({index}) => index));
+      pending.forEach(({submission, slot: submittedSlot}, index) => {
+        if (!failedIndices.has(index)) {
+          submission.proposerSlots.add(submittedSlot);
+        }
+      });
+      for (const {index, message} of failures) {
+        this.logger.error("Error submitting signed proposer preferences", {
+          slot: pending[index]?.slot,
+          validatorIndex: signedProposerPreferences[index]?.message.validatorIndex,
+          message,
+        });
+      }
+    }
+  }
+
+  private async submitBuilderPreferences(proposals: UpcomingProposal[], slot: Slot): Promise<void> {
+    const builderPreferences: routes.validator.BuilderPreferencesEntry[] = [];
+    const pending: PendingSubmission[] = [];
+    // Index into `pending` of each entry in `builderPreferences`, a proposal has one entry per builder
+    const pendingIndexByEntry: number[] = [];
+
+    for (const {duty, submission} of proposals) {
+      if (submission.builderSlots.has(duty.slot)) continue;
+
+      const pubkeyHex = toPubkeyHex(duty.pubkey);
+      const {selection} = this.validatorStore.getBuilderSelectionParams(pubkeyHex, duty.slot);
+      if (selection === routes.validator.BuilderSelection.ExecutionOnly) continue;
+
+      const builderEntries = this.validatorStore.getResolvedBuilderEntries(pubkeyHex);
+      if (builderEntries.length === 0) continue;
+
+      try {
+        // Collect entries per duty and only add them to the batch if signing
+        // succeeded for all builders, else the duty is retried on the next tick
+        const dutyEntries: routes.validator.BuilderPreferencesEntry[] = [];
+        for (const entry of builderEntries) {
+          const auth = await this.validatorStore.getBuilderRequestAuth(duty.pubkey, entry.authData, duty.slot, slot);
+          dutyEntries.push({
+            proposerPubkey: duty.pubkey,
+            url: new TextEncoder().encode(entry.url),
+            auth,
+            maxExecutionPayment: entry.maxExecutionPayment,
+          });
+        }
+        builderPreferences.push(...dutyEntries);
+        pendingIndexByEntry.push(...dutyEntries.map(() => pending.length));
+        pending.push({submission, slot: duty.slot});
+      } catch (e) {
+        this.logger.error(
+          "Error signing builder preferences",
+          {slot: duty.slot, validatorIndex: duty.validatorIndex},
+          e as Error
+        );
+      }
+    }
+
+    if (builderPreferences.length === 0) {
+      return;
+    }
+
+    try {
+      (await this.api.validator.submitBuilderPreferences({builderPreferences})).assertOk();
+      // Only mark as submitted after the API call succeeds; a thrown error, including per-entry
+      // failures reported by index, leaves all slots eligible for retry on the next tick.
+      // Re-submitting preferences a builder already accepted is harmless.
+      for (const {submission, slot: submittedSlot} of pending) {
+        submission.builderSlots.add(submittedSlot);
+      }
+      this.logger.debug("Submitted builder preferences", {count: builderPreferences.length});
+    } catch (e) {
+      const failures = e instanceof ApiError ? e.failures : undefined;
+      if (failures === undefined) {
+        this.logger.warn("Error submitting builder preferences", {count: builderPreferences.length}, e as Error);
+        return;
+      }
+
+      // Some entries were not accepted by their builder, reported by index into the batch. Mark the
+      // proposals whose entries were all accepted, the others are retried with all their builders.
+      const failedPendingIndices = new Set(failures.map(({index}) => pendingIndexByEntry[index]));
+      pending.forEach(({submission, slot: submittedSlot}, index) => {
+        if (!failedPendingIndices.has(index)) {
+          submission.builderSlots.add(submittedSlot);
+        }
+      });
+      for (const {index, message} of failures) {
+        this.logger.warn("Error submitting builder preferences", {
+          slot: pending[pendingIndexByEntry[index]]?.slot,
+          builder: builderPreferences[index] ? new TextDecoder().decode(builderPreferences[index].url) : undefined,
+          message,
+        });
+      }
+    }
+  }
+}

package/src/services/ptc.ts

@@ -1,7 +1,7 @@
 import {ApiClient, routes} from "@lodestar/api";
 import {ChainForkConfig} from "@lodestar/config";
 import {isForkPostGloas} from "@lodestar/params";
-import {IClock} from "@lodestar/state-transition";
+import {IClock, computeStartSlotAtEpoch} from "@lodestar/state-transition";
 import {Slot, gloas} from "@lodestar/types";
 import {prettyBytes, sleep, toRootHex} from "@lodestar/utils";
 import {Metrics} from "../metrics.js";
@@ -54,8 +54,10 @@ export class PtcService {
       return;
     }
 
-    const duties = this.dutiesService.getDutiesAtSlot(slot);
-    if (duties.length === 0) {
+    let duties = this.dutiesService.getDutiesAtSlot(slot);
+    // Duties of the first Gloas epoch can't be polled ahead of the fork, at its first slot they are still being polled
+    const isFirstGloasSlot = slot === computeStartSlotAtEpoch(this.config.GLOAS_FORK_EPOCH);
+    if (duties.length === 0 && !isFirstGloasSlot) {
       return;
     }
 
@@ -71,6 +73,13 @@ export class PtcService {
       payloadAvailable.abort();
     }
 
+    if (isFirstGloasSlot) {
+      duties = this.dutiesService.getDutiesAtSlot(slot);
+      if (duties.length === 0) {
+        return;
+      }
+    }
+
     this.metrics?.ptcStepCallProducePayloadAttestation.observe(
       this.clock.secFromSlot(slot) - payloadAttestationDueMs / 1000
     );

package/src/services/ptcDuties.ts

@@ -95,8 +95,8 @@ export class PtcDutiesService {
   }
 
   private runDutiesTasks = async (epoch: Epoch): Promise<void> => {
-    const nextEpoch = epoch + 1;
-    if (!isForkPostGloas(this.config.getForkName(nextEpoch * SLOTS_PER_EPOCH))) {
+    // PTC duties of the first Gloas epoch only exist after the fork upgrade, they can't be polled one epoch ahead
+    if (!isForkPostGloas(this.config.getForkName(epoch * SLOTS_PER_EPOCH))) {
       return;
     }
 

package/src/services/validatorStore.ts

@@ -359,14 +359,10 @@ export class ValidatorStore {
     }
 
     // Post-Gloas block production uses standard builder boost factor. Need to normalize the
-    // gloas-deprecated "builderonly" and "executiononly" to the gloas fallback "builderalways"
-    // and "executionalways" equivalent before deriving the boost factor.
-    if (isPostGloas) {
-      if (selection === routes.validator.BuilderSelection.BuilderOnly) {
-        selection = routes.validator.BuilderSelection.BuilderAlways;
-      } else if (selection === routes.validator.BuilderSelection.ExecutionOnly) {
-        selection = routes.validator.BuilderSelection.ExecutionAlways;
-      }
+    // gloas-deprecated "builderonly" to the gloas fallback "builderalways" equivalent before
+    // deriving the boost factor.
+    if (isPostGloas && selection === routes.validator.BuilderSelection.BuilderOnly) {
+      selection = routes.validator.BuilderSelection.BuilderAlways;
     }
 
     const boostFactor = getBuilderBoostFactor(

package/src/validator.ts

@@ -16,14 +16,13 @@ import {MetaDataRepository} from "./repositories/metaDataRepository.js";
 import {AttestationService} from "./services/attestation.js";
 import {BlockProposingService} from "./services/block.js";
 import {BlockDutiesService} from "./services/blockDuties.js";
-import {BuilderPreferencesService} from "./services/builderPreferences.js";
 import {ChainHeaderTracker} from "./services/chainHeaderTracker.js";
 import {DoppelgangerService} from "./services/doppelgangerService.js";
 import {ValidatorEventEmitter} from "./services/emitter.js";
 import {ExternalSignerOptions, pollExternalSignerPubkeys} from "./services/externalSignerSync.js";
 import {IndicesService} from "./services/indices.js";
 import {pollBuilderValidatorRegistration, pollPrepareBeaconProposer} from "./services/prepareBeaconProposer.js";
-import {ProposerPreferencesService} from "./services/proposerPreferences.js";
+import {ProposalPreferencesService} from "./services/proposalPreferences.js";
 import {PtcService} from "./services/ptc.js";
 import {SyncCommitteeService} from "./services/syncCommittee.js";
 import {SyncingStatusTracker} from "./services/syncingStatusTracker.js";
@@ -320,8 +319,16 @@ export class Validator {
       }
     );
 
-    new ProposerPreferencesService(config, loggerVc, api, clock, validatorStore, blockDutiesService, metrics);
-    new BuilderPreferencesService(config, loggerVc, api, clock, validatorStore, blockDutiesService, metrics);
+    new ProposalPreferencesService(
+      config,
+      loggerVc,
+      api,
+      clock,
+      validatorStore,
+      blockDutiesService,
+      syncingStatusTracker,
+      metrics
+    );
 
     return new Validator({
       opts,

package/lib/services/builderPreferences.d.ts

@@ -1,27 +0,0 @@
-import { ApiClient } from "@lodestar/api";
-import { ChainForkConfig } from "@lodestar/config";
-import { IClock } from "@lodestar/state-transition";
-import { Metrics } from "../metrics.js";
-import { LoggerVc } from "../util/index.js";
-import { BlockDutiesService } from "./blockDuties.js";
-import { ValidatorStore } from "./validatorStore.js";
-/**
- * Signs and submits builder preferences for any local validator that will propose within the
- * next `SUBMIT_BEFORE_PROPOSAL_SLOTS` and has external builders configured. Signing the request
- * auths here also pre-fills the auth cache used at proposal time.
- *
- * The beacon node submits each entry to the builder at the entry's url. Re-submits automatically
- * when the proposer dependent root for an epoch shifts (e.g. after a reorg) since the proposer
- * for a slot may have changed.
- */
-export declare class BuilderPreferencesService {
-    private readonly config;
-    private readonly logger;
-    private readonly api;
-    private readonly validatorStore;
-    private readonly blockDutiesService;
-    private readonly submitted;
-    constructor(config: ChainForkConfig, logger: LoggerVc, api: ApiClient, clock: IClock, validatorStore: ValidatorStore, blockDutiesService: BlockDutiesService, _metrics: Metrics | null);
-    private runBuilderPreferencesTask;
-}
-//# sourceMappingURL=builderPreferences.d.ts.map

package/lib/services/builderPreferences.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"builderPreferences.d.ts","sourceRoot":"","sources":["../../src/services/builderPreferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAS,MAAM,eAAe,CAAC;AAChD,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAC,MAAM,EAAqB,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAC;AACtC,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAYnD;;;;;;;;GAQG;AACH,qBAAa,yBAAyB;IAIlC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAEpB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IARrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAEhE,YACmB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,QAAQ,EAChB,GAAG,EAAE,SAAS,EAC/B,KAAK,EAAE,MAAM,EACI,cAAc,EAAE,cAAc,EAC9B,kBAAkB,EAAE,kBAAkB,EACvD,QAAQ,EAAE,OAAO,GAAG,IAAI,EAGzB;IAED,OAAO,CAAC,yBAAyB,CA+F/B;CACH"}

package/lib/services/builderPreferences.js

@@ -1,127 +0,0 @@
-import { routes } from "@lodestar/api";
-import { SLOTS_PER_EPOCH, isForkPostGloas } from "@lodestar/params";
-import { computeEpochAtSlot } from "@lodestar/state-transition";
-import { toPubkeyHex } from "@lodestar/utils";
-/**
- * Submit a proposer's builder preferences this many slots before the proposal slot.
- * Same pacing as `ProposerPreferencesService`, builders must have the preferences
- * before the bid request arrives at proposal time.
- */
-const SUBMIT_BEFORE_PROPOSAL_SLOTS = Math.floor(SLOTS_PER_EPOCH / 4);
-/**
- * Signs and submits builder preferences for any local validator that will propose within the
- * next `SUBMIT_BEFORE_PROPOSAL_SLOTS` and has external builders configured. Signing the request
- * auths here also pre-fills the auth cache used at proposal time.
- *
- * The beacon node submits each entry to the builder at the entry's url. Re-submits automatically
- * when the proposer dependent root for an epoch shifts (e.g. after a reorg) since the proposer
- * for a slot may have changed.
- */
-export class BuilderPreferencesService {
-    config;
-    logger;
-    api;
-    validatorStore;
-    blockDutiesService;
-    submitted = new Map();
-    constructor(config, logger, api, clock, validatorStore, blockDutiesService, _metrics) {
-        this.config = config;
-        this.logger = logger;
-        this.api = api;
-        this.validatorStore = validatorStore;
-        this.blockDutiesService = blockDutiesService;
-        clock.runEverySlot(this.runBuilderPreferencesTask);
-    }
-    runBuilderPreferencesTask = async (slot) => {
-        // Start running once the submission window (`slot + SUBMIT_BEFORE_PROPOSAL_SLOTS`) reaches
-        // Gloas, i.e. already in the epoch before the fork. This allows builders to prepare and
-        // submit bids for the first Gloas slots.
-        if (!isForkPostGloas(this.config.getForkName(slot + SUBMIT_BEFORE_PROPOSAL_SLOTS))) {
-            return;
-        }
-        const currentEpoch = computeEpochAtSlot(slot);
-        const entries = [];
-        // Track which `(submission, slot)` pairs are pending an API submission so we can mark
-        // them only after the network call succeeds. Marking before would silently drop a
-        // preference on transient API failure (no retry until dependent_root shifts).
-        const pending = [];
-        for (const epoch of [currentEpoch, currentEpoch + 1]) {
-            const dutiesAtEpoch = this.blockDutiesService.getProposersAtEpoch(epoch);
-            if (!dutiesAtEpoch)
-                continue;
-            // Reset submission tracking if the dependent root for this epoch has shifted
-            // (e.g. due to a reorg). The proposer for a slot may have changed.
-            let submission = this.submitted.get(epoch);
-            if (submission === undefined || submission.dependentRoot !== dutiesAtEpoch.dependentRoot) {
-                if (submission !== undefined) {
-                    this.logger.info("Proposer-shuffling dependent root shifted; resubmitting builder preferences", {
-                        epoch,
-                        priorDependentRoot: submission.dependentRoot,
-                        dependentRoot: dutiesAtEpoch.dependentRoot,
-                    });
-                }
-                submission = { dependentRoot: dutiesAtEpoch.dependentRoot, slots: new Set() };
-                this.submitted.set(epoch, submission);
-            }
-            for (const duty of dutiesAtEpoch.data) {
-                if (duty.slot <= slot)
-                    continue;
-                if (duty.slot > slot + SUBMIT_BEFORE_PROPOSAL_SLOTS)
-                    continue;
-                if (!isForkPostGloas(this.config.getForkName(duty.slot)))
-                    continue;
-                if (submission.slots.has(duty.slot))
-                    continue;
-                const pubkeyHex = toPubkeyHex(duty.pubkey);
-                const { selection } = this.validatorStore.getBuilderSelectionParams(pubkeyHex, duty.slot);
-                if (selection === routes.validator.BuilderSelection.ExecutionOnly)
-                    continue;
-                const builderEntries = this.validatorStore.getResolvedBuilderEntries(pubkeyHex);
-                if (builderEntries.length === 0)
-                    continue;
-                try {
-                    // Collect entries per duty and only add them to the batch if signing
-                    // succeeded for all builders, else the duty is retried on the next tick
-                    const dutyEntries = [];
-                    for (const entry of builderEntries) {
-                        const auth = await this.validatorStore.getBuilderRequestAuth(duty.pubkey, entry.authData, duty.slot, slot);
-                        dutyEntries.push({
-                            proposerPubkey: duty.pubkey,
-                            url: new TextEncoder().encode(entry.url),
-                            auth,
-                            maxExecutionPayment: entry.maxExecutionPayment,
-                        });
-                    }
-                    entries.push(...dutyEntries);
-                    pending.push({ submission, slot: duty.slot });
-                }
-                catch (e) {
-                    this.logger.error("Error signing builder preferences", { slot: duty.slot, validatorIndex: duty.validatorIndex }, e);
-                }
-            }
-        }
-        // Prune tracking for past epochs
-        for (const epoch of this.submitted.keys()) {
-            if (epoch < currentEpoch) {
-                this.submitted.delete(epoch);
-            }
-        }
-        if (entries.length === 0) {
-            return;
-        }
-        try {
-            (await this.api.validator.submitBuilderPreferences({ builderPreferences: entries })).assertOk();
-            // Only mark as submitted after the API call succeeds; a thrown error, including per-entry
-            // failures reported by index, leaves all slots eligible for retry on the next tick.
-            // Re-submitting preferences a builder already accepted is harmless.
-            for (const { submission, slot: submittedSlot } of pending) {
-                submission.slots.add(submittedSlot);
-            }
-            this.logger.debug("Submitted builder preferences", { count: entries.length });
-        }
-        catch (e) {
-            this.logger.warn("Error submitting builder preferences", { count: entries.length }, e);
-        }
-    };
-}
-//# sourceMappingURL=builderPreferences.js.map

package/lib/services/builderPreferences.js.map

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

package/lib/services/proposerPreferences.d.ts

@@ -1,31 +0,0 @@
-import { ApiClient } from "@lodestar/api";
-import { ChainForkConfig } from "@lodestar/config";
-import { IClock } from "@lodestar/state-transition";
-import { Metrics } from "../metrics.js";
-import { LoggerVc } from "../util/index.js";
-import { BlockDutiesService } from "./blockDuties.js";
-import { ValidatorStore } from "./validatorStore.js";
-/**
- * Signs and submits `SignedProposerPreferences` for any local validator that will propose
- * within the next `SUBMIT_BEFORE_PROPOSAL_SLOTS`. Re-submits automatically when the proposer
- * dependent root for an epoch shifts (e.g. after a reorg) — detected by comparing the cached
- * `dependentRoot` reported by `BlockDutiesService` against the one we last submitted under.
- *
- * Proposers should broadcast their preferences before the fork so the proposer preference caches
- * of beacon nodes and builders are warm for the first Gloas slots. We start submitting
- * as soon as a duty's proposal slot is in Gloas, which is up to `SUBMIT_BEFORE_PROPOSAL_SLOTS`
- * before the fork, so only the first few Gloas slots are affected by this pre-fork submission.
- */
-export declare class ProposerPreferencesService {
-    private readonly config;
-    private readonly logger;
-    private readonly api;
-    private readonly validatorStore;
-    private readonly blockDutiesService;
-    private readonly submitted;
-    private activeScheduledGasLimit;
-    constructor(config: ChainForkConfig, logger: LoggerVc, api: ApiClient, clock: IClock, validatorStore: ValidatorStore, blockDutiesService: BlockDutiesService, _metrics: Metrics | null);
-    private runProposerPreferencesTask;
-    private runEveryEpochTask;
-}
-//# sourceMappingURL=proposerPreferences.d.ts.map

package/lib/services/proposerPreferences.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"proposerPreferences.d.ts","sourceRoot":"","sources":["../../src/services/proposerPreferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AACxC,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAC,MAAM,EAAqB,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAC;AACtC,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAgBnD;;;;;;;;;;GAUG;AACH,qBAAa,0BAA0B;IAKnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAEpB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IATrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,uBAAuB,CAAqB;IAEpD,YACmB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,QAAQ,EAChB,GAAG,EAAE,SAAS,EAC/B,KAAK,EAAE,MAAM,EACI,cAAc,EAAE,cAAc,EAC9B,kBAAkB,EAAE,kBAAkB,EACvD,QAAQ,EAAE,OAAO,GAAG,IAAI,EAIzB;IAED,OAAO,CAAC,0BAA0B,CA8EhC;IAEF,OAAO,CAAC,iBAAiB,CAmBvB;CACH"}