@lodestar/beacon-node 1.29.0-dev.87d367d9f7 → 1.29.0-dev.8aa1ad8d30

package/lib/chain/opPools/aggregatedAttestationPool.d.ts

@@ -1,8 +1,9 @@
 import { ChainForkConfig } from "@lodestar/config";
 import { IForkChoice } from "@lodestar/fork-choice";
 import { ForkName } from "@lodestar/params";
-import { CachedBeaconStateAllForks } from "@lodestar/state-transition";
+import { CachedBeaconStateAllForks, EffectiveBalanceIncrements } from "@lodestar/state-transition";
 import { Attestation, Epoch, RootHex, Slot, ValidatorIndex, electra, phase0 } from "@lodestar/types";
+import { Metrics } from "../../metrics/metrics.js";
 import { InsertOutcome } from "./types.js";
 type CommitteeIndex = number;
 /**
@@ -12,22 +13,32 @@ type CommitteeIndex = number;
 export type AttestationsConsolidation = {
     byCommittee: Map<CommitteeIndex, AttestationNonParticipant>;
     attData: phase0.AttestationData;
-    totalNotSeenCount: number;
+    totalNewSeenEffectiveBalance: number;
+    newSeenAttesters: number;
+    notSeenAttesters: number;
+    /** total number of attesters across all committees in this consolidation */
+    totalAttesters: number;
 };
 /**
- * This function returns not seen participation for a given epoch and slot and committe index.
+ * This function returns not seen participation for a given epoch and slot and committee index.
  * Return null if all validators are seen or no info to check.
  */
 type GetNotSeenValidatorsFn = (epoch: Epoch, slot: Slot, committeeIndex: number) => Set<number> | null;
 type ValidateAttestationDataFn = (attData: phase0.AttestationData) => boolean;
+export declare enum ScannedSlotsTerminationReason {
+    MaxConsolidationReached = "max_consolidation_reached",
+    ScannedAllSlots = "scanned_all_slots",
+    SlotBeforePreviousEpoch = "slot_before_previous_epoch"
+}
 /**
  * Maintain a pool of aggregated attestations. Attestations can be retrieved for inclusion in a block
- * or api. The returned attestations are aggregated to maximise the number of validators that can be
+ * or api. The returned attestations are aggregated to maximize the number of validators that can be
  * included.
  * Note that we want to remove attestations with attesters that were included in the chain.
  */
 export declare class AggregatedAttestationPool {
     private readonly config;
+    private readonly metrics;
     /**
      * post electra, different committees could have the same AttData and we have to consolidate attestations of the same
      * data to be included in block, so we should group by data before index
@@ -35,12 +46,7 @@ export declare class AggregatedAttestationPool {
      */
     private readonly attestationGroupByIndexByDataHexBySlot;
     private lowestPermissibleSlot;
-    constructor(config: ChainForkConfig);
-    /** For metrics to track size of the pool */
-    getAttestationCount(): {
-        attestationCount: number;
-        attestationDataCount: number;
-    };
+    constructor(config: ChainForkConfig, metrics?: Metrics | null);
     add(attestation: Attestation, dataRootHex: RootHex, attestingIndicesCount: number, committee: Uint32Array): InsertOutcome;
     /** Remove attestations which are too old to be included in a block. */
     prune(clockSlot: Slot): void;
@@ -62,6 +68,7 @@ export declare class AggregatedAttestationPool {
      * @param bySlot slot to filter, `bySlot === attestation.data.slot`
      */
     getAll(bySlot?: Slot): Attestation[];
+    private onScrapeMetrics;
 }
 interface AttestationWithIndex {
     attestation: Attestation;
@@ -69,7 +76,13 @@ interface AttestationWithIndex {
 }
 type AttestationNonParticipant = {
     attestation: Attestation;
-    notSeenAttesterCount: number;
+    newSeenEffectiveBalance: number;
+    newSeenAttesters: number;
+    notSeenCommitteeMembers: Set<number>;
+};
+type GetAttestationsGroupResult = {
+    result: AttestationNonParticipant[];
+    totalAttestations: number;
 };
 /**
  * Maintain a pool of AggregatedAttestation which all share the same AttestationData.
@@ -78,10 +91,11 @@ type AttestationNonParticipant = {
  * Use committee instead of aggregationBits to improve performance.
  */
 export declare class MatchingDataAttestationGroup {
+    private readonly config;
     readonly committee: Uint32Array;
     readonly data: phase0.AttestationData;
     private readonly attestations;
-    constructor(committee: Uint32Array, data: phase0.AttestationData);
+    constructor(config: ChainForkConfig, committee: Uint32Array, data: phase0.AttestationData);
     getAttestationCount(): number;
     /**
      * Add an attestation.
@@ -92,10 +106,14 @@ export declare class MatchingDataAttestationGroup {
     add(attestation: AttestationWithIndex): InsertOutcome;
     /**
      * Get AttestationNonParticipant for this groups of same attestation data.
-     * @param notSeenAttestingIndices not seen attestting indices, i.e. indices in the same committee
+     * @param notSeenCommitteeMembers not seen committee members, i.e. indices in the same committee (starting from 0 till (committee.size - 1))
      * @returns an array of AttestationNonParticipant
      */
-    getAttestationsForBlock(fork: ForkName, notSeenAttestingIndices: Set<number>): AttestationNonParticipant[];
+    getAttestationsForBlock(fork: ForkName, effectiveBalanceIncrements: EffectiveBalanceIncrements, notSeenCommitteeMembers: Set<number>, maxAttestation: number): GetAttestationsGroupResult;
+    /**
+     * Select the attestation with the highest total effective balance of not seen validators.
+     */
+    private getMostValuableAttestation;
     /** Get attestations for API. */
     getAttestations(): Attestation[];
 }