@lodestar/beacon-node 1.47.0-dev.1c8babbe6e → 1.47.0-dev.1e9a530f98

package/lib/chain/validation/executionPayloadBid.js

@@ -32,28 +32,164 @@ function getMinBidValue(currentHighestBid) {
 /**
  * Check whether a bid builds on one of the paths compatible with the local head branch.
  *
- * Building directly on the parent is allowed for proposer-boost reorgs outside epoch boundaries.
+ * Building directly on the parent is allowed for proposer-boost reorgs, including at epoch
+ * boundaries when the head is weak enough that a reorg onto the strong parent is predicted.
  * Otherwise the bid must build on the local head's full or empty payload variant, as selected for its slot.
  */
-function isBidCompatibleWithHead(forkChoice, head, bidSlot, bidParentBlockRoot, bidParentBlockHash) {
+function isBidCompatibleWithHead(chain, head, bidSlot, bidParentBlockRoot, bidParentBlockHash) {
     const buildsOnParentBlock = bidParentBlockRoot === head.parentRoot;
     const buildsOnParentPayload = bidParentBlockHash === head.parentBlockHash;
     if (buildsOnParentBlock && buildsOnParentPayload) {
-        // The spec allows this at epoch boundaries, but Lodestar does not propagate these bids because validating
-        // them requires an epoch transition for a parent state that cannot be used for proposer-boost reorgs.
-        return !isStartSlotOfEpoch(bidSlot);
+        if (!isStartSlotOfEpoch(bidSlot)) {
+            return true;
+        }
+        // Epoch-boundary reorgs are allowed, but only propagate the bid if its parent matches the block
+        // we predict a proposer would reorg onto — predictProposerHead returns the strong parent only
+        // when the head is weak.
+        return chain.predictProposerHead().blockRoot === bidParentBlockRoot;
     }
     if (bidParentBlockRoot !== head.blockRoot) {
         return false;
     }
     const buildsOnHeadPayload = bidParentBlockHash === head.executionPayloadBlockHash;
-    if (forkChoice.shouldBuildOnFull(head, bidSlot)) {
+    if (chain.forkChoice.shouldBuildOnFull(head, bidSlot)) {
         return buildsOnHeadPayload;
     }
     return buildsOnParentPayload;
 }
+/**
+ * Validation for bids submitted via the API by the operator's own builder.
+ *
+ * Only non-transient checks are applied: slot later than parent, zero execution payment, blob
+ * commitment count, builder eligibility, version and balance coverage, prev_randao, and signature.
+ * Transient gossip rules (head compatibility, first bid per tuple, value increment, proposer
+ * preferences) are not applied, since those only limit forwarding of peers' messages and the
+ * builder may legitimately bid on a branch this node does not consider head.
+ *
+ * Throws on any failed check. Also throws if the bid's parent block is unknown or its state is
+ * unavailable, since the checks cannot be evaluated against the parent branch.
+ */
 export async function validateApiExecutionPayloadBid(chain, signedExecutionPayloadBid) {
-    return validateExecutionPayloadBid(chain, signedExecutionPayloadBid);
+    const bid = signedExecutionPayloadBid.message;
+    const bidParentBlockRoot = toRootHex(bid.parentBlockRoot);
+    // [IGNORE] `bid.slot` is the current slot, or the next slot (`bid.slot - 1` is current), allowing for `MAXIMUM_GOSSIP_CLOCK_DISPARITY`.
+    if (!chain.clock.isCurrentSlotGivenGossipDisparity(bid.slot) &&
+        !chain.clock.isCurrentSlotGivenGossipDisparity(bid.slot - 1)) {
+        throw new ExecutionPayloadBidError(GossipAction.IGNORE, {
+            code: ExecutionPayloadBidErrorCode.INVALID_SLOT,
+            builderIndex: bid.builderIndex,
+            slot: bid.slot,
+        });
+    }
+    // [IGNORE] `bid.parent_block_root` is the hash tree root of a known beacon block in fork choice.
+    // Moved earlier than the spec ordering so we can derive the proposer dependent root for the
+    // proposer-preferences lookup below from a known fork-choice block.
+    const parentBlock = chain.forkChoice.getBlockHexDefaultStatus(bidParentBlockRoot);
+    if (parentBlock === null) {
+        throw new ExecutionPayloadBidError(GossipAction.IGNORE, {
+            code: ExecutionPayloadBidErrorCode.UNKNOWN_BLOCK_ROOT,
+            parentBlockRoot: bidParentBlockRoot,
+        });
+    }
+    // [REJECT] The bid is for a higher slot than its parent block -- i.e.
+    // validate that `bid.slot` is greater than the slot of the block with root
+    // `bid.parent_block_root`.
+    if (bid.slot <= parentBlock.slot) {
+        throw new ExecutionPayloadBidError(GossipAction.REJECT, {
+            code: ExecutionPayloadBidErrorCode.NOT_LATER_THAN_PARENT,
+            parentSlot: parentBlock.slot,
+            slot: bid.slot,
+        });
+    }
+    // [REJECT] `bid.execution_payment` is zero.
+    if (bid.executionPayment !== 0n) {
+        throw new ExecutionPayloadBidError(GossipAction.REJECT, {
+            code: ExecutionPayloadBidErrorCode.NON_ZERO_EXECUTION_PAYMENT,
+            builderIndex: bid.builderIndex,
+            executionPayment: bid.executionPayment,
+        });
+    }
+    // [REJECT] The length of KZG commitments is less than or equal to the limitation defined in the
+    // consensus layer -- i.e. validate that
+    // `len(bid.blob_kzg_commitments) <= get_blob_parameters(compute_epoch_at_slot(bid.slot)).max_blobs_per_block`.
+    const blobKzgCommitmentsLen = bid.blobKzgCommitments.length;
+    const maxBlobsPerBlock = chain.config.getMaxBlobsPerBlock(computeEpochAtSlot(bid.slot));
+    if (blobKzgCommitmentsLen > maxBlobsPerBlock) {
+        throw new ExecutionPayloadBidError(GossipAction.REJECT, {
+            code: ExecutionPayloadBidErrorCode.TOO_MANY_KZG_COMMITMENTS,
+            blobKzgCommitmentsLen,
+            commitmentLimit: maxBlobsPerBlock,
+        });
+    }
+    const state = await chain.regen
+        .getBlockSlotState(parentBlock, bid.slot, { dontTransferCache: true }, RegenCaller.validateApiExecutionPayloadBid)
+        .catch(() => {
+        throw new ExecutionPayloadBidError(GossipAction.IGNORE, {
+            code: ExecutionPayloadBidErrorCode.UNKNOWN_BLOCK_ROOT,
+            parentBlockRoot: bidParentBlockRoot,
+        });
+    });
+    if (!isStatePostGloas(state)) {
+        throw new Error(`Expected gloas+ state for execution payload bid validation, got fork=${state.forkName}`);
+    }
+    // [REJECT] `bid.builder_index` is within bounds -- i.e. `bid.builder_index < len(state.builders)`.
+    // `state.getBuilder` returns a lazy SSZ `getReadonly` view that is not bounds-checked eagerly; an
+    // out-of-range index only throws (`LeafNode has no right node`) on deferred field access (e.g. inside
+    // `isActiveBuilder`), escaping a try/catch around `getBuilder`. Check the length explicitly instead.
+    if (bid.builderIndex >= state.getBuildersLength()) {
+        throw new ExecutionPayloadBidError(GossipAction.REJECT, {
+            code: ExecutionPayloadBidErrorCode.BUILDER_NOT_ELIGIBLE,
+            builderIndex: bid.builderIndex,
+        });
+    }
+    // [REJECT] `bid.builder_index` is a valid/active builder index -- i.e.
+    // `is_active_builder(state, bid.builder_index)` returns `True`.
+    const builder = state.getBuilder(bid.builderIndex);
+    if (!isActiveBuilder(builder, state.finalizedCheckpoint.epoch)) {
+        throw new ExecutionPayloadBidError(GossipAction.REJECT, {
+            code: ExecutionPayloadBidErrorCode.BUILDER_NOT_ELIGIBLE,
+            builderIndex: bid.builderIndex,
+        });
+    }
+    // [REJECT] The builder version is `PAYLOAD_BUILDER_VERSION` -- i.e.
+    // `state.builders[bid.builder_index].version == PAYLOAD_BUILDER_VERSION`.
+    if (builder.version !== PAYLOAD_BUILDER_VERSION) {
+        throw new ExecutionPayloadBidError(GossipAction.REJECT, {
+            code: ExecutionPayloadBidErrorCode.INVALID_BUILDER_VERSION,
+            builderIndex: bid.builderIndex,
+            version: builder.version,
+            expectedVersion: PAYLOAD_BUILDER_VERSION,
+        });
+    }
+    // [IGNORE] `bid.value` is less or equal than the builder's excess balance --
+    // i.e. `can_builder_cover_bid(state, builder_index, amount)` returns `True`.
+    if (!state.canBuilderCoverBid(bid.builderIndex, bid.value)) {
+        throw new ExecutionPayloadBidError(GossipAction.IGNORE, {
+            code: ExecutionPayloadBidErrorCode.BID_TOO_HIGH,
+            bidValue: bid.value,
+            builderBalance: builder.balance,
+        });
+    }
+    // [REJECT] `bid.prev_randao` is the correct RANDAO mix -- i.e. validate that
+    // `bid.prev_randao == get_randao_mix(parent_state, get_current_epoch(parent_state))`.
+    const randaoMix = state.getRandaoMix(computeEpochAtSlot(state.slot));
+    if (!byteArrayEquals(bid.prevRandao, randaoMix)) {
+        throw new ExecutionPayloadBidError(GossipAction.REJECT, {
+            code: ExecutionPayloadBidErrorCode.INVALID_PREV_RANDAO,
+            builderIndex: bid.builderIndex,
+            bidPrevRandao: toHex(bid.prevRandao),
+            expectedPrevRandao: toHex(randaoMix),
+        });
+    }
+    // [REJECT] `signed_execution_payload_bid.signature` is valid with respect to the `bid.builder_index`.
+    const signatureSet = createSingleSignatureSetFromComponents(builder.pubkey, getExecutionPayloadBidSigningRoot(chain.config, bid), signedExecutionPayloadBid.signature);
+    if (!(await chain.bls.verifySignatureSets([signatureSet]))) {
+        throw new ExecutionPayloadBidError(GossipAction.REJECT, {
+            code: ExecutionPayloadBidErrorCode.INVALID_SIGNATURE,
+            builderIndex: bid.builderIndex,
+            slot: bid.slot,
+        });
+    }
 }
 export async function validateGossipExecutionPayloadBid(chain, signedExecutionPayloadBid) {
     return validateExecutionPayloadBid(chain, signedExecutionPayloadBid);
@@ -73,7 +209,7 @@ async function validateExecutionPayloadBid(chain, signedExecutionPayloadBid) {
     }
     // [IGNORE] The bid is compatible with the current head branch.
     const head = chain.forkChoice.getHead();
-    if (!isBidCompatibleWithHead(chain.forkChoice, head, bid.slot, bidParentBlockRoot, bidParentBlockHash)) {
+    if (!isBidCompatibleWithHead(chain, head, bid.slot, bidParentBlockRoot, bidParentBlockHash)) {
         throw new ExecutionPayloadBidError(GossipAction.IGNORE, {
             code: ExecutionPayloadBidErrorCode.INCOMPATIBLE_WITH_HEAD,
             slot: bid.slot,
@@ -256,11 +392,11 @@ async function validateExecutionPayloadBid(chain, signedExecutionPayloadBid) {
     // increment, see https://github.com/ethereum/consensus-specs/pull/4831. This prevents spam
     // from builders submitting numerous bids with minimal value increments.
     const bestBid = chain.executionPayloadBidPool.getBestBid(bid.slot, bidParentBlockHash, bidParentBlockRoot);
-    if (bestBid !== null && bid.value < getMinBidValue(bestBid.message.value)) {
+    if (bestBid !== null && bid.value < getMinBidValue(bestBid.signedBid.message.value)) {
         throw new ExecutionPayloadBidError(GossipAction.IGNORE, {
             code: ExecutionPayloadBidErrorCode.BID_TOO_LOW,
             bidValue: bid.value,
-            currentHighestBid: bestBid.message.value,
+            currentHighestBid: bestBid.signedBid.message.value,
         });
     }
     // [IGNORE] `bid.value` is less or equal than the builder's excess balance --

package/lib/chain/validation/executionPayloadBid.js.map

@@ -1 +1 @@
-{"version":3,"file":"executionPayloadBid.js","sourceRoot":"","sources":["../../../src/chain/validation/executionPayloadBid.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,uBAAuB,EAAC,MAAM,kBAAkB,CAAC;AACzD,OAAO,EACL,kBAAkB,EAClB,sCAAsC,EACtC,iCAAiC,EACjC,eAAe,EACf,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAC,eAAe,EAAE,KAAK,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAC,yBAAyB,EAAC,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAC,wBAAwB,EAAE,4BAA4B,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAExG,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B;;;GAGG;AACH,MAAM,wBAAwB,GAAG,OAAO,CAAC;AACzC;;;GAGG;AACH,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAE1C;;;GAGG;AACH,SAAS,cAAc,CAAC,iBAAyB;IAC/C,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,MAAM,CAAC,GAAG,iBAAiB,CAAC;IACrF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE,iBAAiB,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAC1G,OAAO,iBAAiB,GAAG,SAAS,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,SAAS,uBAAuB,CAC9B,UAAuB,EACvB,IAAgB,EAChB,OAAa,EACb,kBAA2B,EAC3B,kBAA2B;IAE3B,MAAM,mBAAmB,GAAG,kBAAkB,KAAK,IAAI,CAAC,UAAU,CAAC;IACnE,MAAM,qBAAqB,GAAG,kBAAkB,KAAK,IAAI,CAAC,eAAe,CAAC;IAE1E,IAAI,mBAAmB,IAAI,qBAAqB,EAAE,CAAC;QACjD,0GAA0G;QAC1G,sGAAsG;QACtG,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,kBAAkB,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,mBAAmB,GAAG,kBAAkB,KAAK,IAAI,CAAC,yBAAyB,CAAC;IAElF,IAAI,UAAU,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;QAChD,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,KAAmB,EACnB,yBAA0D;IAE1D,OAAO,2BAA2B,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,KAAmB,EACnB,yBAA0D;IAE1D,OAAO,2BAA2B,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;AACvE,CAAC;AAED,KAAK,UAAU,2BAA2B,CACxC,KAAmB,EACnB,yBAA0D;IAE1D,MAAM,GAAG,GAAG,yBAAyB,CAAC,OAAO,CAAC;IAC9C,MAAM,kBAAkB,GAAG,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC1D,MAAM,kBAAkB,GAAG,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAE1D,wIAAwI;IACxI,IACE,CAAC,KAAK,CAAC,KAAK,CAAC,iCAAiC,CAAC,GAAG,CAAC,IAAI,CAAC;QACxD,CAAC,KAAK,CAAC,KAAK,CAAC,iCAAiC,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,EAC5D,CAAC;QACD,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,YAAY;YAC/C,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC,CAAC;IACL,CAAC;IAED,+DAA+D;IAC/D,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IACxC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,EAAE,CAAC;QACvG,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,sBAAsB;YACzD,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,eAAe,EAAE,kBAAkB;YACnC,eAAe,EAAE,kBAAkB;YACnC,aAAa,EAAE,IAAI,CAAC,SAAS;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,+FAA+F;IAC/F,wEAAwE;IACxE,6FAA6F;IAC7F,+DAA+D;IAC/D,IAAI,KAAK,CAAC,wBAAwB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,EAAE,CAAC;QAC/G,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,iBAAiB;YACpD,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,eAAe,EAAE,kBAAkB;YACnC,eAAe,EAAE,kBAAkB;SACpC,CAAC,CAAC;IACL,CAAC;IAED,iGAAiG;IACjG,4FAA4F;IAC5F,oEAAoE;IACpE,MAAM,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;IAClF,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,kBAAkB;YACrD,eAAe,EAAE,kBAAkB;SACpC,CAAC,CAAC;IACL,CAAC;IAED,sEAAsE;IACtE,2EAA2E;IAC3E,2BAA2B;IAC3B,IAAI,GAAG,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,qBAAqB;YACxD,UAAU,EAAE,WAAW,CAAC,IAAI;YAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC,CAAC;IACL,CAAC;IAED,2FAA2F;IAC3F,iEAAiE;IACjE,+EAA+E;IAC/E,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9C,8FAA8F;IAC9F,4FAA4F;IAC5F,8FAA8F;IAC9F,iFAAiF;IACjF,yFAAyF;IACzF,2EAA2E;IAC3E,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE;QAC7B,IAAI,CAAC;YACH,OAAO,yBAAyB,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,kBAAkB,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;QAClH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,0FAA0F;QAC1F,gFAAgF;QAChF,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,gCAAgC;YACnE,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,eAAe,EAAE,kBAAkB;YACnC,aAAa,EAAE,SAAS;SACzB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,mBAAmB,GAAG,KAAK,CAAC,uBAAuB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC1F,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,gCAAgC;YACnE,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,eAAe,EAAE,kBAAkB;YACnC,aAAa,EAAE,gBAAgB;SAChC,CAAC,CAAC;IACL,CAAC;IAED,uDAAuD;IACvD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK;SAC5B,iBAAiB,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,EAAE,EAAC,iBAAiB,EAAE,IAAI,EAAC,EAAE,WAAW,CAAC,iCAAiC,CAAC;SAClH,KAAK,CAAC,GAAG,EAAE;QACV,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,kBAAkB;YACrD,eAAe,EAAE,kBAAkB;SACpC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,wEAAwE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,mGAAmG;IACnG,kGAAkG;IAClG,sGAAsG;IACtG,qGAAqG;IACrG,IAAI,GAAG,CAAC,YAAY,IAAI,KAAK,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,oBAAoB;YACvD,YAAY,EAAE,GAAG,CAAC,YAAY;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,uEAAuE;IACvE,gEAAgE;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACnD,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,oBAAoB;YACvD,YAAY,EAAE,GAAG,CAAC,YAAY;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,oEAAoE;IACpE,0EAA0E;IAC1E,IAAI,OAAO,CAAC,OAAO,KAAK,uBAAuB,EAAE,CAAC;QAChD,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,uBAAuB;YAC1D,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,eAAe,EAAE,uBAAuB;SACzC,CAAC,CAAC;IACL,CAAC;IAED,4CAA4C;IAC5C,IAAI,GAAG,CAAC,gBAAgB,KAAK,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,0BAA0B;YAC7D,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;SACvC,CAAC,CAAC;IACL,CAAC;IAED,sEAAsE;IACtE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,YAAY,EAAE,mBAAmB,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,2CAA2C;YAC9E,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC;YACxC,oBAAoB,EAAE,KAAK,CAAC,mBAAmB,CAAC,OAAO,CAAC,YAAY,CAAC;SACtE,CAAC,CAAC;IACL,CAAC;IAED,0FAA0F;IAC1F,qFAAqF;IACrF,4FAA4F;IAC5F,uFAAuF;IACvF,yFAAyF;IACzF,0EAA0E;IAC1E,MAAM,oBAAoB,GAAG,KAAK,CAAC,UAAU,CAAC,uBAAuB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IAC9G,IAAI,oBAAoB,KAAK,IAAI,IAAI,oBAAoB,CAAC,yBAAyB,KAAK,IAAI,EAAE,CAAC;QAC7F,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,yBAAyB;YAC5D,eAAe,EAAE,kBAAkB;SACpC,CAAC,CAAC;IACL,CAAC;IAED,gGAAgG;IAChG,kFAAkF;IAClF,iEAAiE;IACjE,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC;IACjC,MAAM,cAAc,GAAG,MAAM,CAAC,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;IAC7E,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAO,CAAC,cAAc,CAAC;IAClE,IAAI,CAAC,0BAA0B,CAAC,cAAc,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,uCAAuC;YAC1E,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,WAAW;YACX,cAAc;YACd,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,gGAAgG;IAChG,wCAAwC;IACxC,+GAA+G;IAC/G,MAAM,qBAAqB,GAAG,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC;IAC5D,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACxF,IAAI,qBAAqB,GAAG,gBAAgB,EAAE,CAAC;QAC7C,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,wBAAwB;YAC3D,qBAAqB;YACrB,eAAe,EAAE,gBAAgB;SAClC,CAAC,CAAC;IACL,CAAC;IAED,gEAAgE;IAChE,8DAA8D;IAC9D,6FAA6F;IAC7F,2FAA2F;IAC3F,wEAAwE;IACxE,MAAM,OAAO,GAAG,KAAK,CAAC,uBAAuB,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IAC3G,IAAI,OAAO,KAAK,IAAI,IAAI,GAAG,CAAC,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,WAAW;YAC9C,QAAQ,EAAE,GAAG,CAAC,KAAK;YACnB,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK;SACzC,CAAC,CAAC;IACL,CAAC;IACD,6EAA6E;IAC7E,6EAA6E;IAC7E,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,YAAY;YAC/C,QAAQ,EAAE,GAAG,CAAC,KAAK;YACnB,cAAc,EAAE,OAAO,CAAC,OAAO;SAChC,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,sFAAsF;IACtF,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,mBAAmB;YACtD,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,aAAa,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;YACpC,kBAAkB,EAAE,KAAK,CAAC,SAAS,CAAC;SACrC,CAAC,CAAC;IACL,CAAC;IAED,sGAAsG;IACtG,MAAM,YAAY,GAAG,sCAAsC,CACzD,OAAO,CAAC,MAAM,EACd,iCAAiC,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,EACpD,yBAAyB,CAAC,SAAS,CACpC,CAAC;IAEF,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,iBAAiB;YACpD,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC,CAAC;IACL,CAAC;IAED,4FAA4F;IAC5F,+DAA+D;IAC/D,IAAI,KAAK,CAAC,wBAAwB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,EAAE,CAAC;QAC/G,MAAM,IAAI,wBAAwB,CAAC,YAAY,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,4BAA4B,CAAC,iBAAiB;YACpD,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,eAAe,EAAE,kBAAkB;YACnC,eAAe,EAAE,kBAAkB;SACpC,CAAC,CAAC;IACL,CAAC;IAED,QAAQ;IACR,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IAEvG,OAAO,EAAC,aAAa,EAAE,mBAAmB,CAAC,OAAO,CAAC,cAAc,EAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"executionPayloadBid.js","sourceRoot":"","sources":["../../../src/chain/validation/executionPayloadBid.ts"],"names":[],"mappings":"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"}

package/lib/chain/validation/voluntaryExit.d.ts

@@ -1,5 +1,13 @@
+import { VoluntaryExitValidity } from "@lodestar/state-transition";
 import { phase0 } from "@lodestar/types";
 import { IBeaconChain } from "../index.js";
-export declare function validateApiVoluntaryExit(chain: IBeaconChain, voluntaryExit: phase0.SignedVoluntaryExit): Promise<void>;
+export type ApiVoluntaryExitResult = {
+    status: "published";
+} | {
+    status: "deferred";
+    validity: VoluntaryExitValidity;
+};
+export declare function isTransientExitValidity(v: VoluntaryExitValidity): boolean;
+export declare function validateApiVoluntaryExit(chain: IBeaconChain, voluntaryExit: phase0.SignedVoluntaryExit): Promise<ApiVoluntaryExitResult>;
 export declare function validateGossipVoluntaryExit(chain: IBeaconChain, voluntaryExit: phase0.SignedVoluntaryExit): Promise<void>;
 //# sourceMappingURL=voluntaryExit.d.ts.map

package/lib/chain/validation/voluntaryExit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voluntaryExit.d.ts","sourceRoot":"","sources":["../../../src/chain/validation/voluntaryExit.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,MAAM,EAAC,MAAM,iBAAiB,CAAC;AAOvC,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAGzC,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,MAAM,CAAC,mBAAmB,GACxC,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,MAAM,CAAC,mBAAmB,GACxC,OAAO,CAAC,IAAI,CAAC,CAEf"}
+{"version":3,"file":"voluntaryExit.d.ts","sourceRoot":"","sources":["../../../src/chain/validation/voluntaryExit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,qBAAqB,EAA+B,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAAC,MAAM,EAAC,MAAM,iBAAiB,CAAC;AAOvC,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAGzC,MAAM,MAAM,sBAAsB,GAAG;IAAC,MAAM,EAAE,WAAW,CAAA;CAAC,GAAG;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,qBAAqB,CAAA;CAAC,CAAC;AAWnH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAYzE;AAGD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,MAAM,CAAC,mBAAmB,GACxC,OAAO,CAAC,sBAAsB,CAAC,CAkCjC;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,MAAM,CAAC,mBAAmB,GACxC,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/lib/chain/validation/voluntaryExit.js

@@ -1,9 +1,54 @@
 import { VoluntaryExitValidity, getVoluntaryExitSignatureSet } from "@lodestar/state-transition";
 import { GossipAction, VoluntaryExitError, VoluntaryExitErrorCode, voluntaryExitValidityToErrorCode, } from "../errors/index.js";
 import { RegenCaller } from "../regen/index.js";
+// Variants that can become valid in a future epoch without user action.
+// - earlyEpoch: exit.message.epoch is in the future; valid once current epoch catches up
+// - shortTimeActive: validator active < SHARD_COMMITTEE_PERIOD; valid once enough time passes
+// - pendingWithdrawals: Electra; valid once pending partial withdrawals drain
+// Note: VoluntaryExitValidity.inactive is intentionally excluded. It conflates
+// "validator does not exist" (permanent) with "validator not yet activated"
+// (transient), and cleanly classifying it requires splitting the enum variant
+// upstream. Left for a future follow-up.
+export function isTransientExitValidity(v) {
+    switch (v) {
+        case VoluntaryExitValidity.earlyEpoch:
+        case VoluntaryExitValidity.shortTimeActive:
+        case VoluntaryExitValidity.pendingWithdrawals:
+            return true;
+        case VoluntaryExitValidity.valid:
+        case VoluntaryExitValidity.inactive:
+        case VoluntaryExitValidity.alreadyExited:
+        case VoluntaryExitValidity.invalidSignature:
+            return false;
+    }
+}
+// Comments for each call are present inside `validateVoluntaryExit`.
 export async function validateApiVoluntaryExit(chain, voluntaryExit) {
     const prioritizeBls = true;
-    return validateVoluntaryExit(chain, voluntaryExit, prioritizeBls);
+    if (chain.opPool.hasSeenVoluntaryExit(voluntaryExit.message.validatorIndex) ||
+        chain.deferredVoluntaryExitPool.has(voluntaryExit.message.validatorIndex)) {
+        throw new VoluntaryExitError(GossipAction.IGNORE, {
+            code: VoluntaryExitErrorCode.ALREADY_EXISTS,
+        });
+    }
+    const state = await chain.getHeadStateAtCurrentEpoch(RegenCaller.validateApiVoluntaryExit);
+    const validity = state.getVoluntaryExitValidity(voluntaryExit, false);
+    if (validity !== VoluntaryExitValidity.valid && !isTransientExitValidity(validity)) {
+        throw new VoluntaryExitError(GossipAction.REJECT, {
+            code: voluntaryExitValidityToErrorCode(validity),
+        });
+    }
+    const signatureSet = getVoluntaryExitSignatureSet(chain.config, state, voluntaryExit);
+    if (!(await chain.bls.verifySignatureSets([signatureSet], { batchable: true, priority: prioritizeBls }))) {
+        throw new VoluntaryExitError(GossipAction.REJECT, {
+            code: VoluntaryExitErrorCode.INVALID_SIGNATURE,
+        });
+    }
+    if (validity !== VoluntaryExitValidity.valid) {
+        // Transient failure — signature is good, defer
+        return { status: "deferred", validity };
+    }
+    return { status: "published" };
 }
 export async function validateGossipVoluntaryExit(chain, voluntaryExit) {
     return validateVoluntaryExit(chain, voluntaryExit);

package/lib/chain/validation/voluntaryExit.js.map

@@ -1 +1 @@
-{"version":3,"file":"voluntaryExit.js","sourceRoot":"","sources":["../../../src/chain/validation/voluntaryExit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,qBAAqB,EAAE,4BAA4B,EAAC,MAAM,4BAA4B,CAAC;AAE/F,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,gCAAgC,GACjC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAmB,EACnB,aAAyC;IAEzC,MAAM,aAAa,GAAG,IAAI,CAAC;IAC3B,OAAO,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,KAAmB,EACnB,aAAyC;IAEzC,OAAO,qBAAqB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,KAAmB,EACnB,aAAyC,EACzC,aAAa,GAAG,KAAK;IAErB,sGAAsG;IACtG,iDAAiD;IACjD,IAAI,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,MAAM,EAAE;YAChD,IAAI,EAAE,sBAAsB,CAAC,cAAc;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,wDAAwD;IACxD,EAAE;IACF,gFAAgF;IAChF,6DAA6D;IAC7D,sGAAsG;IACtG,kGAAkG;IAClG,6CAA6C;IAC7C,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,0BAA0B,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAE9F,gFAAgF;IAChF,mDAAmD;IACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,wBAAwB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACtE,IAAI,QAAQ,KAAK,qBAAqB,CAAC,KAAK,EAAE,CAAC;QAC7C,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,MAAM,EAAE;YAChD,IAAI,EAAE,gCAAgC,CAAC,QAAQ,CAAC;SACjD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAG,4BAA4B,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;IACtF,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,YAAY,CAAC,EAAE,EAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAC,CAAC,CAAC,EAAE,CAAC;QACvG,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,MAAM,EAAE;YAChD,IAAI,EAAE,sBAAsB,CAAC,iBAAiB;SAC/C,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
+{"version":3,"file":"voluntaryExit.js","sourceRoot":"","sources":["../../../src/chain/validation/voluntaryExit.ts"],"names":[],"mappings":"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"}

package/lib/execution/builder/apiClient.d.ts

@@ -0,0 +1,64 @@
+import { routes } from "@lodestar/api";
+import { ChainForkConfig } from "@lodestar/config";
+import { Logger } from "@lodestar/logger";
+import { ForkPostGloas } from "@lodestar/params";
+import { BLSPubkey, Root, SignedBeaconBlock, Slot, WithOptionalBytes, gloas } from "@lodestar/types";
+import type { IBlsVerifier } from "../../chain/bls/index.js";
+import { Metrics } from "../../metrics/metrics.js";
+import { IClock } from "../../util/clock.js";
+/**
+ * Duration given to a builder to provide a `SignedExecutionPayloadBid` before the deadline
+ * is reached, advertised on each bid request via the `X-Timeout-Ms` header. The p2p bid is
+ * selected after the same duration, only considering bids received up to that point.
+ */
+export declare const BUILDER_BID_DEADLINE_MS = 500;
+/** Local timeout for bid requests, event loop lag must not discard bids that arrived in time */
+export declare const BUILDER_BID_REQUEST_TIMEOUT_MS: number;
+export type BuilderApiClientOpts = {
+    /** Timeout for builder api requests, bid requests always use `BUILDER_BID_REQUEST_TIMEOUT_MS` */
+    timeout?: number;
+    userAgent?: string;
+};
+type BuilderUrl = string;
+/** Decode the SSZ URL bytes without allowing replacement characters or unsafe header values. */
+export declare function decodeBuilderUrl(value: Uint8Array): BuilderUrl;
+export type BuilderApiBid = {
+    url: BuilderUrl;
+    entry: routes.validator.BuilderEntry;
+    signedBid: gloas.SignedExecutionPayloadBid;
+    /** Time in milliseconds from the slot start when the bid was received */
+    receivedMs: number;
+};
+/**
+ * External builder integration post-gloas
+ *
+ * The builder set is driven by the resolved `BuilderConfig` the validator client supplies on
+ * each block production request, clients are dialed on demand based on the entry `url`.
+ */
+export declare class BuilderApiClient {
+    private readonly opts;
+    private readonly config;
+    private readonly clock;
+    private readonly bls;
+    private readonly metrics;
+    private readonly logger?;
+    private readonly clients;
+    constructor(opts: BuilderApiClientOpts, config: ChainForkConfig, clock: IClock, bls: IBlsVerifier, metrics?: Metrics | null, logger?: Logger | undefined);
+    /**
+     * Fan out bid requests to the builders named by the entries, one request per unique
+     * `(url, auth.message.data)` pair. Errors and empty responses (204) are logged and filtered
+     * out so a single unresponsive builder never fails block production.
+     */
+    getExecutionPayloadBids(entries: routes.validator.BuilderEntry[], slot: Slot, parentHash: Root, parentRoot: Root, proposerPubkey: BLSPubkey): Promise<BuilderApiBid[]>;
+    /** Forward a proposer's builder preferences to the builder at the given url */
+    submitBuilderPreferences(url: BuilderUrl, proposerPubkey: BLSPubkey, request: gloas.BuilderPreferencesRequest): Promise<void>;
+    /**
+     * Submit the signed beacon block to the builder whose bid was included. The builder is
+     * then responsible for constructing and broadcasting the corresponding
+     * `SignedExecutionPayloadEnvelope`, no further action is required by the proposer.
+     */
+    submitSignedBeaconBlock(url: BuilderUrl, signedBlock: WithOptionalBytes<SignedBeaconBlock<ForkPostGloas>>): Promise<void>;
+    private getOrCreateClient;
+}
+export {};
+//# sourceMappingURL=apiClient.d.ts.map

package/lib/execution/builder/apiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../../../src/execution/builder/apiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AAErC,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAC,MAAM,EAAC,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAA8B,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAO5E,OAAO,EAAC,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAM,MAAM,iBAAiB,CAAC;AAExG,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAC,OAAO,EAAC,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAAC,MAAM,EAAC,MAAM,qBAAqB,CAAC;AAQ3C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,gGAAgG;AAChG,eAAO,MAAM,8BAA8B,QAAkD,CAAC;AAE9F,MAAM,MAAM,oBAAoB,GAAG;IACjC,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,UAAU,GAAG,MAAM,CAAC;AAEzB,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAW9D;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC;IACrC,SAAS,EAAE,KAAK,CAAC,yBAAyB,CAAC;IAC3C,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAR1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAE7D,YACmB,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,OAAO,GAAG,IAAW,EAC9B,MAAM,CAAC,EAAE,MAAM,YAAA,EAC9B;IAEJ;;;;OAIG;IACG,uBAAuB,CAC3B,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,EACxC,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,IAAI,EAChB,UAAU,EAAE,IAAI,EAChB,cAAc,EAAE,SAAS,GACxB,OAAO,CAAC,aAAa,EAAE,CAAC,CAmE1B;IAED,+EAA+E;IACzE,wBAAwB,CAC5B,GAAG,EAAE,UAAU,EACf,cAAc,EAAE,SAAS,EACzB,OAAO,EAAE,KAAK,CAAC,yBAAyB,GACvC,OAAO,CAAC,IAAI,CAAC,CASf;IAED;;;;OAIG;IACG,uBAAuB,CAC3B,GAAG,EAAE,UAAU,EACf,WAAW,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,GAC/D,OAAO,CAAC,IAAI,CAAC,CAef;YAEa,iBAAiB;CAwChC"}

package/lib/execution/builder/apiClient.js

@@ -0,0 +1,184 @@
+import { getClient } from "@lodestar/api/builder";
+import { DOMAIN_BUILDER_REQUEST_AUTH } from "@lodestar/params";
+import { ZERO_HASH, computeDomain, computeSigningRoot, createSingleSignatureSetFromComponents, } from "@lodestar/state-transition";
+import { ssz } from "@lodestar/types";
+import { isValidAsciiHttpUrl, toHex, toPrintableUrl } from "@lodestar/utils";
+/**
+ * Additional duration to account for potential event loop lag which causes
+ * builder bids to be rejected even though the response was sent in time.
+ */
+const EVENT_LOOP_LAG_BUFFER = 250;
+/**
+ * Duration given to a builder to provide a `SignedExecutionPayloadBid` before the deadline
+ * is reached, advertised on each bid request via the `X-Timeout-Ms` header. The p2p bid is
+ * selected after the same duration, only considering bids received up to that point.
+ */
+export const BUILDER_BID_DEADLINE_MS = 500;
+/** Local timeout for bid requests, event loop lag must not discard bids that arrived in time */
+export const BUILDER_BID_REQUEST_TIMEOUT_MS = BUILDER_BID_DEADLINE_MS + EVENT_LOOP_LAG_BUFFER;
+/** Decode the SSZ URL bytes without allowing replacement characters or unsafe header values. */
+export function decodeBuilderUrl(value) {
+    let url;
+    try {
+        url = new TextDecoder("utf8", { fatal: true }).decode(value);
+    }
+    catch {
+        throw Error("Builder url must be valid UTF-8");
+    }
+    if (!isValidAsciiHttpUrl(url)) {
+        throw Error("Invalid builder url");
+    }
+    return url;
+}
+/**
+ * External builder integration post-gloas
+ *
+ * The builder set is driven by the resolved `BuilderConfig` the validator client supplies on
+ * each block production request, clients are dialed on demand based on the entry `url`.
+ */
+export class BuilderApiClient {
+    opts;
+    config;
+    clock;
+    bls;
+    metrics;
+    logger;
+    clients = new Map();
+    constructor(opts, config, clock, bls, metrics = null, logger) {
+        this.opts = opts;
+        this.config = config;
+        this.clock = clock;
+        this.bls = bls;
+        this.metrics = metrics;
+        this.logger = logger;
+    }
+    /**
+     * Fan out bid requests to the builders named by the entries, one request per unique
+     * `(url, auth.message.data)` pair. Errors and empty responses (204) are logged and filtered
+     * out so a single unresponsive builder never fails block production.
+     */
+    async getExecutionPayloadBids(entries, slot, parentHash, parentRoot, proposerPubkey) {
+        const seenRequests = new Set();
+        const requests = [];
+        for (const entry of entries) {
+            const urlForLog = Buffer.from(entry.url).toString("utf8");
+            let url;
+            try {
+                url = decodeBuilderUrl(entry.url);
+            }
+            catch {
+                this.logger?.warn("Ignoring builder entry with invalid url", { slot, url: urlForLog });
+                continue;
+            }
+            const requestKey = `${url}-${toHex(entry.auth.message.data)}`;
+            if (seenRequests.has(requestKey)) {
+                continue;
+            }
+            seenRequests.add(requestKey);
+            // The builder rejects a mismatch, an entry naming a different slot is not used for a bid request
+            if (entry.auth.message.slot !== slot) {
+                this.logger?.warn("Ignoring builder entry with auth for different slot", {
+                    slot,
+                    authSlot: entry.auth.message.slot,
+                    builder: toPrintableUrl(url),
+                });
+                continue;
+            }
+            requests.push({ url, entry });
+        }
+        // Collected in arrival order so an earlier received bid wins ties during candidate ranking
+        const bids = [];
+        await Promise.all(requests.map(async ({ url, entry }) => {
+            this.metrics?.builderApi.bidRequests.inc();
+            try {
+                const client = await this.getOrCreateClient(url, proposerPubkey, entry.auth);
+                const res = await client.getExecutionPayloadBid({
+                    slot,
+                    parentHash,
+                    parentRoot,
+                    proposerPubkey,
+                    requestAuth: entry.auth,
+                    dateMilliseconds: Date.now(),
+                    timeoutMs: BUILDER_BID_DEADLINE_MS,
+                }, { timeoutMs: BUILDER_BID_REQUEST_TIMEOUT_MS });
+                const signedBid = res.value();
+                if (signedBid === undefined) {
+                    this.logger?.debug("No bid received from builder", { slot, builder: toPrintableUrl(url) });
+                    return;
+                }
+                this.metrics?.builderApi.bidsReceived.inc();
+                bids.push({ url, entry, signedBid, receivedMs: this.clock.msFromSlot(slot) });
+            }
+            catch (e) {
+                this.metrics?.builderApi.bidRequestErrors.inc();
+                this.logger?.warn("Failed to get bid from builder", { slot, builder: toPrintableUrl(url) }, e);
+            }
+        }));
+        return bids;
+    }
+    /** Forward a proposer's builder preferences to the builder at the given url */
+    async submitBuilderPreferences(url, proposerPubkey, request) {
+        try {
+            const client = await this.getOrCreateClient(url, proposerPubkey, request.auth);
+            (await client.submitBuilderPreferences({ proposerPubkey, request })).assertOk();
+            this.metrics?.builderApi.preferencesForwarded.inc({ status: "success" });
+        }
+        catch (e) {
+            this.metrics?.builderApi.preferencesForwarded.inc({ status: "error" });
+            throw e;
+        }
+    }
+    /**
+     * Submit the signed beacon block to the builder whose bid was included. The builder is
+     * then responsible for constructing and broadcasting the corresponding
+     * `SignedExecutionPayloadEnvelope`, no further action is required by the proposer.
+     */
+    async submitSignedBeaconBlock(url, signedBlock) {
+        const client = this.clients.get(url);
+        if (client === undefined) {
+            this.metrics?.builderApi.blockSubmissions.inc({ status: "error" });
+            this.logger?.warn("Ignoring signed block submission to unauthenticated builder", { url });
+            return;
+        }
+        try {
+            (await client.submitSignedBeaconBlock({ signedBlock }, { redirect: "manual" })).assertOk();
+            this.metrics?.builderApi.blockSubmissions.inc({ status: "success" });
+        }
+        catch (e) {
+            this.metrics?.builderApi.blockSubmissions.inc({ status: "error" });
+            throw e;
+        }
+    }
+    async getOrCreateClient(url, proposerPubkey, auth) {
+        if (auth.message.data.length === 0) {
+            throw Error("Builder request auth data must not be empty");
+        }
+        let client = this.clients.get(url);
+        if (client === undefined) {
+            const domain = computeDomain(DOMAIN_BUILDER_REQUEST_AUTH, this.config.GENESIS_FORK_VERSION, ZERO_HASH);
+            const signingRoot = computeSigningRoot(ssz.gloas.BuilderRequestAuth, auth.message, domain);
+            const signatureSet = createSingleSignatureSetFromComponents(proposerPubkey, signingRoot, auth.signature);
+            let isValid = false;
+            try {
+                isValid = await this.bls.verifySignatureSets([signatureSet]);
+            }
+            catch {
+                // Malformed signatures are invalid request authentication.
+            }
+            if (!isValid) {
+                throw Error("Invalid builder request auth");
+            }
+            client = getClient({
+                baseUrl: url,
+                globalInit: {
+                    timeoutMs: this.opts.timeout,
+                    headers: this.opts.userAgent ? { "User-Agent": this.opts.userAgent } : undefined,
+                },
+            }, { config: this.config, metrics: this.metrics?.builderHttpClient, logger: this.logger });
+            this.clients.set(url, client);
+            this.logger?.debug("External builder registered", { url: toPrintableUrl(url) });
+        }
+        return client;
+    }
+}
+//# sourceMappingURL=apiClient.js.map

package/lib/execution/builder/apiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.js","sourceRoot":"","sources":["../../../src/execution/builder/apiClient.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAGzE,OAAO,EAAC,2BAA2B,EAAgB,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EACL,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,sCAAsC,GACvC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAqE,GAAG,EAAC,MAAM,iBAAiB,CAAC;AACxG,OAAO,EAAC,mBAAmB,EAAE,KAAK,EAAE,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAK3E;;;GAGG;AACH,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,gGAAgG;AAChG,MAAM,CAAC,MAAM,8BAA8B,GAAG,uBAAuB,GAAG,qBAAqB,CAAC;AAW9F,gGAAgG;AAChG,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAUD;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAIR,IAAI;IACJ,MAAM;IACN,KAAK;IACL,GAAG;IACH,OAAO;IACP,MAAM;IARR,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE7D,YACmB,IAA0B,EAC1B,MAAuB,EACvB,KAAa,EACb,GAAiB,EACjB,OAAO,GAAmB,IAAI,EAC9B,MAAe;oBALf,IAAI;sBACJ,MAAM;qBACN,KAAK;mBACL,GAAG;uBACH,OAAO;sBACP,MAAM;IACtB,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,uBAAuB,CAC3B,OAAwC,EACxC,IAAU,EACV,UAAgB,EAChB,UAAgB,EAChB,cAAyB;QAEzB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QACvC,MAAM,QAAQ,GAA8D,EAAE,CAAC;QAE/E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC1D,IAAI,GAAe,CAAC;YACpB,IAAI,CAAC;gBACH,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,yCAAyC,EAAE,EAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAC,CAAC,CAAC;gBACrF,SAAS;YACX,CAAC;YAED,MAAM,UAAU,GAAG,GAAG,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9D,IAAI,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;YACD,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAE7B,iGAAiG;YACjG,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACrC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,qDAAqD,EAAE;oBACvE,IAAI;oBACJ,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI;oBACjC,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC;iBAC7B,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC,EAAC,GAAG,EAAE,KAAK,EAAC,CAAC,CAAC;QAC9B,CAAC;QAED,2FAA2F;QAC3F,MAAM,IAAI,GAAoB,EAAE,CAAC;QACjC,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAC,GAAG,EAAE,KAAK,EAAC,EAAE,EAAE;YAClC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7E,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAC7C;oBACE,IAAI;oBACJ,UAAU;oBACV,UAAU;oBACV,cAAc;oBACd,WAAW,EAAE,KAAK,CAAC,IAAI;oBACvB,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE;oBAC5B,SAAS,EAAE,uBAAuB;iBACnC,EACD,EAAC,SAAS,EAAE,8BAA8B,EAAC,CAC5C,CAAC;gBACF,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC9B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;oBAC5B,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,8BAA8B,EAAE,EAAC,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,EAAC,CAAC,CAAC;oBACzF,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;gBAC5C,IAAI,CAAC,IAAI,CAAC,EAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC;YAC9E,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC;gBAChD,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,gCAAgC,EAAE,EAAC,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,EAAC,EAAE,CAAU,CAAC,CAAC;YACxG,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,wBAAwB,CAC5B,GAAe,EACf,cAAyB,EACzB,OAAwC;QAExC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/E,CAAC,MAAM,MAAM,CAAC,wBAAwB,CAAC,EAAC,cAAc,EAAE,OAAO,EAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC9E,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAC,MAAM,EAAE,SAAS,EAAC,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAC,MAAM,EAAE,OAAO,EAAC,CAAC,CAAC;YACrE,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,uBAAuB,CAC3B,GAAe,EACf,WAAgE;QAEhE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAC,MAAM,EAAE,OAAO,EAAC,CAAC,CAAC;YACjE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,6DAA6D,EAAE,EAAC,GAAG,EAAC,CAAC,CAAC;YACxF,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,CAAC,MAAM,MAAM,CAAC,uBAAuB,CAAC,EAAC,WAAW,EAAC,EAAE,EAAC,QAAQ,EAAE,QAAQ,EAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YACvF,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAC,MAAM,EAAE,SAAS,EAAC,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAC,MAAM,EAAE,OAAO,EAAC,CAAC,CAAC;YACjE,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,GAAe,EACf,cAAyB,EACzB,IAAoC;QAEpC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,aAAa,CAAC,2BAA2B,EAAE,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;YACvG,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3F,MAAM,YAAY,GAAG,sCAAsC,CAAC,cAAc,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAEzG,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAC/D,CAAC;YAAC,MAAM,CAAC;gBACP,2DAA2D;YAC7D,CAAC;YACD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAC9C,CAAC;YAED,MAAM,GAAG,SAAS,CAChB;gBACE,OAAO,EAAE,GAAG;gBACZ,UAAU,EAAE;oBACV,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;oBAC5B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAC,CAAC,CAAC,CAAC,SAAS;iBAC/E;aACF,EACD,EAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAC,CACrF,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC9B,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,6BAA6B,EAAE,EAAC,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC,EAAC,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/lib/execution/builder/validateBid.d.ts

@@ -0,0 +1,22 @@
+import { routes } from "@lodestar/api";
+import { ProtoBlock } from "@lodestar/fork-choice";
+import { RootHex, Slot, gloas } from "@lodestar/types";
+import { IBeaconChain } from "../../chain/index.js";
+/** Return the counted bid payment in Gwei, saturated at uint64 max. */
+export declare function getBuilderBidTotalGwei(bid: gloas.ExecutionPayloadBid, maxExecutionPayment: bigint): bigint;
+/**
+ * Validate a bid received from a builder over the builder API in response to a bid request
+ * made during block production. Unlike gossip validation, the bid must match the requested
+ * slot and parent exactly, may carry a non-zero `executionPayment` which is counted at most at
+ * the entry's `maxExecutionPayment`, and is not subject to gossip anti-spam rules.
+ *
+ * Throws with a description of the failure, the caller drops the bid.
+ */
+export declare function validateBuilderApiExecutionPayloadBid(chain: IBeaconChain, signedExecutionPayloadBid: gloas.SignedExecutionPayloadBid, request: {
+    slot: Slot;
+    parentBlock: ProtoBlock;
+    parentBlockHash: RootHex;
+    parentBlockRoot: RootHex;
+    entry: routes.validator.BuilderEntry;
+}): Promise<void>;
+//# sourceMappingURL=validateBid.d.ts.map

package/lib/execution/builder/validateBid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateBid.d.ts","sourceRoot":"","sources":["../../../src/execution/builder/validateBid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AACrC,OAAO,EAAC,UAAU,EAAC,MAAM,uBAAuB,CAAC;AAUjD,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAC,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAAC,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAIlD,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,KAAK,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAE1G;AAED;;;;;;;GAOG;AACH,wBAAsB,qCAAqC,CACzD,KAAK,EAAE,YAAY,EACnB,yBAAyB,EAAE,KAAK,CAAC,yBAAyB,EAC1D,OAAO,EAAE;IACP,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,UAAU,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC;CACtC,GACA,OAAO,CAAC,IAAI,CAAC,CA6Hf"}