@lodestar/api 1.44.0-dev.e47e0bb5bd → 1.44.0-dev.ec438788c3

package/src/beacon/routes/beacon/pool.ts

@@ -71,18 +71,6 @@ type PayloadAttestationMessageList = ValueOf<typeof PayloadAttestationMessageLis
 type SignedProposerPreferencesList = ValueOf<typeof SignedProposerPreferencesListType>;
 
 export type Endpoints = {
-  /**
-   * Get Attestations from operations pool
-   * Retrieves attestations known by the node but not necessarily incorporated into any block
-   */
-  getPoolAttestations: Endpoint<
-    "GET",
-    {slot?: Slot; committeeIndex?: CommitteeIndex},
-    {query: {slot?: number; committee_index?: number}},
-    AttestationListPhase0,
-    EmptyMeta
-  >;
-
   /**
    * Get Attestations from operations pool
    * Retrieves attestations known by the node but not necessarily incorporated into any block
@@ -119,19 +107,6 @@ export type Endpoints = {
     VersionMeta
   >;
 
-  /**
-   * Get AttesterSlashings from operations pool
-   * Retrieves attester slashings known by the node but not necessarily incorporated into any block
-   */
-  getPoolAttesterSlashings: Endpoint<
-    // ⏎
-    "GET",
-    EmptyArgs,
-    EmptyRequest,
-    AttesterSlashingListPhase0,
-    EmptyMeta
-  >;
-
   /**
    * Get AttesterSlashings from operations pool
    * Retrieves attester slashings known by the node but not necessarily incorporated into any block
@@ -184,22 +159,6 @@ export type Endpoints = {
     EmptyMeta
   >;
 
-  /**
-   * Submit Attestation objects to node
-   * Submits Attestation objects to the node.  Each attestation in the request body is processed individually.
-   *
-   * If an attestation is validated successfully the node MUST publish that attestation on the appropriate subnet.
-   *
-   * If one or more attestations fail validation the node MUST return a 400 error with details of which attestations have failed, and why.
-   */
-  submitPoolAttestations: Endpoint<
-    "POST",
-    {signedAttestations: SingleAttestation<ForkPreElectra>[]},
-    {body: unknown},
-    EmptyResponseData,
-    EmptyMeta
-  >;
-
   /**
    * Submit Attestation objects to node
    * Submits Attestation objects to the node.  Each attestation in the request body is processed individually.
@@ -216,18 +175,6 @@ export type Endpoints = {
     EmptyMeta
   >;
 
-  /**
-   * Submit AttesterSlashing object to node's pool
-   * Submits AttesterSlashing object to node's pool and if passes validation node MUST broadcast it to network.
-   */
-  submitPoolAttesterSlashings: Endpoint<
-    "POST",
-    {attesterSlashing: phase0.AttesterSlashing},
-    {body: unknown},
-    EmptyResponseData,
-    EmptyMeta
-  >;
-
   /**
    * Submit AttesterSlashing object to node's pool
    * Submits AttesterSlashing object to node's pool and if passes validation node MUST broadcast it to network.
@@ -315,19 +262,6 @@ export type Endpoints = {
 
 export function getDefinitions(config: ChainForkConfig): RouteDefinitions<Endpoints> {
   return {
-    getPoolAttestations: {
-      url: "/eth/v1/beacon/pool/attestations",
-      method: "GET",
-      req: {
-        writeReq: ({slot, committeeIndex}) => ({query: {slot, committee_index: committeeIndex}}),
-        parseReq: ({query}) => ({slot: query.slot, committeeIndex: query.committee_index}),
-        schema: {query: {slot: Schema.Uint, committee_index: Schema.Uint}},
-      },
-      resp: {
-        data: AttestationListTypePhase0,
-        meta: EmptyMetaCodec,
-      },
-    },
     getPoolAttestationsV2: {
       url: "/eth/v2/beacon/pool/attestations",
       method: "GET",
@@ -367,15 +301,6 @@ export function getDefinitions(config: ChainForkConfig): RouteDefinitions<Endpoi
         meta: VersionCodec,
       },
     },
-    getPoolAttesterSlashings: {
-      url: "/eth/v1/beacon/pool/attester_slashings",
-      method: "GET",
-      req: EmptyRequestCodec,
-      resp: {
-        data: AttesterSlashingListTypePhase0,
-        meta: EmptyMetaCodec,
-      },
-    },
     getPoolAttesterSlashingsV2: {
       url: "/eth/v2/beacon/pool/attester_slashings",
       method: "GET",
@@ -414,20 +339,6 @@ export function getDefinitions(config: ChainForkConfig): RouteDefinitions<Endpoi
         meta: EmptyMetaCodec,
       },
     },
-    submitPoolAttestations: {
-      url: "/eth/v1/beacon/pool/attestations",
-      method: "POST",
-      req: {
-        writeReqJson: ({signedAttestations}) => ({body: SingleAttestationListTypePhase0.toJson(signedAttestations)}),
-        parseReqJson: ({body}) => ({signedAttestations: SingleAttestationListTypePhase0.fromJson(body)}),
-        writeReqSsz: ({signedAttestations}) => ({body: SingleAttestationListTypePhase0.serialize(signedAttestations)}),
-        parseReqSsz: ({body}) => ({signedAttestations: SingleAttestationListTypePhase0.deserialize(body)}),
-        schema: {
-          body: Schema.ObjectArray,
-        },
-      },
-      resp: EmptyResponseCodec,
-    },
     submitPoolAttestationsV2: {
       url: "/eth/v2/beacon/pool/attestations",
       method: "POST",
@@ -473,20 +384,6 @@ export function getDefinitions(config: ChainForkConfig): RouteDefinitions<Endpoi
       },
       resp: EmptyResponseCodec,
     },
-    submitPoolAttesterSlashings: {
-      url: "/eth/v1/beacon/pool/attester_slashings",
-      method: "POST",
-      req: {
-        writeReqJson: ({attesterSlashing}) => ({body: ssz.phase0.AttesterSlashing.toJson(attesterSlashing)}),
-        parseReqJson: ({body}) => ({attesterSlashing: ssz.phase0.AttesterSlashing.fromJson(body)}),
-        writeReqSsz: ({attesterSlashing}) => ({body: ssz.phase0.AttesterSlashing.serialize(attesterSlashing)}),
-        parseReqSsz: ({body}) => ({attesterSlashing: ssz.phase0.AttesterSlashing.deserialize(body)}),
-        schema: {
-          body: Schema.Object,
-        },
-      },
-      resp: EmptyResponseCodec,
-    },
     submitPoolAttesterSlashingsV2: {
       url: "/eth/v2/beacon/pool/attester_slashings",
       method: "POST",

package/src/beacon/routes/debug.ts

@@ -1,4 +1,4 @@
-import {ContainerType, Type, ValueOf} from "@chainsafe/ssz";
+import {ContainerType, OptionalType, Type, ValueOf} from "@chainsafe/ssz";
 import {ChainForkConfig} from "@lodestar/config";
 import {isForkPostFulu} from "@lodestar/params";
 import {ArrayOf, BeaconState, DataColumnSidecars, StringType, ssz, sszTypesFor} from "@lodestar/types";
@@ -78,12 +78,62 @@ const ForkChoiceResponseType = new ContainerType(
   {jsonCase: "eth2"}
 );
 
+const ForkChoiceNodeV2ExtraDataType = new ContainerType(
+  {
+    executionOptimistic: ssz.Boolean,
+    timestamp: ssz.UintNum64,
+    target: stringType,
+    justifiedEpoch: ssz.Epoch,
+    finalizedEpoch: ssz.Epoch,
+    unrealizedJustifiedEpoch: ssz.Epoch,
+    unrealizedFinalizedEpoch: ssz.Epoch,
+    payloadAttesterCount: new OptionalType(ssz.UintNum64),
+    payloadAvailabilityYesCount: new OptionalType(ssz.UintNum64),
+    payloadDataAvailabilityYesCount: new OptionalType(ssz.UintNum64),
+    gasLimit: new OptionalType(ssz.UintNum64),
+  },
+  {jsonCase: "eth2"}
+);
+const ForkChoiceNodeV2Type = new ContainerType(
+  {
+    payloadStatus: new StringType<"pending" | "empty" | "full">(),
+    slot: ssz.Slot,
+    blockRoot: stringType,
+    parentRoot: stringType,
+    weight: ssz.UintNum64,
+    validity: new StringType<"valid" | "invalid" | "optimistic">(),
+    executionBlockHash: stringType,
+    extraData: ForkChoiceNodeV2ExtraDataType,
+  },
+  {jsonCase: "eth2"}
+);
+const ForkChoiceExtraDataType = new ContainerType(
+  {
+    unrealizedJustifiedCheckpoint: ssz.phase0.Checkpoint,
+    unrealizedFinalizedCheckpoint: ssz.phase0.Checkpoint,
+    proposerBoostRoot: stringType,
+    previousProposerBoostRoot: stringType,
+    headRoot: stringType,
+  },
+  {jsonCase: "eth2"}
+);
+const ForkChoiceResponseV2Type = new ContainerType(
+  {
+    justifiedCheckpoint: ssz.phase0.Checkpoint,
+    finalizedCheckpoint: ssz.phase0.Checkpoint,
+    forkChoiceNodes: ArrayOf(ForkChoiceNodeV2Type),
+    extraData: ForkChoiceExtraDataType,
+  },
+  {jsonCase: "eth2"}
+);
+
 const ProtoNodeListType = ArrayOf(ProtoNodeType);
 const DebugChainHeadListType = ArrayOf(DebugChainHeadType);
 
 type ProtoNodeList = ValueOf<typeof ProtoNodeListType>;
 type DebugChainHeadList = ValueOf<typeof DebugChainHeadListType>;
 type ForkChoiceResponse = ValueOf<typeof ForkChoiceResponseType>;
+type ForkChoiceResponseV2 = ValueOf<typeof ForkChoiceResponseV2Type>;
 
 export type Endpoints = {
   /**
@@ -110,6 +160,18 @@ export type Endpoints = {
     EmptyMeta
   >;
 
+  /**
+   * Retrieves all current fork choice context (v2: per (root, payload_status) with PTC vote tallies)
+   */
+  getDebugForkChoiceV2: Endpoint<
+    // ⏎
+    "GET",
+    EmptyArgs,
+    EmptyRequest,
+    ForkChoiceResponseV2,
+    EmptyMeta
+  >;
+
   /**
    * Dump all ProtoArray's nodes to debug
    */
@@ -185,6 +247,24 @@ export function getDefinitions(_config: ChainForkConfig): RouteDefinitions<Endpo
         },
       },
     },
+    getDebugForkChoiceV2: {
+      url: "/eth/v2/debug/fork_choice",
+      method: "GET",
+      req: EmptyRequestCodec,
+      resp: {
+        data: ForkChoiceResponseV2Type,
+        meta: EmptyMetaCodec,
+        onlySupport: WireFormat.json,
+        transform: {
+          toResponse: (data) => ({
+            ...(data as ForkChoiceResponseV2),
+          }),
+          fromResponse: (resp) => ({
+            data: resp as ForkChoiceResponseV2,
+          }),
+        },
+      },
+    },
     getProtoArrayNodes: {
       url: "/eth/v0/debug/forkchoice",
       method: "GET",

package/src/beacon/routes/events.ts

@@ -110,6 +110,8 @@ export enum EventType {
   executionPayloadBid = "execution_payload_bid",
   /** The node has received a `SignedProposerPreferences` (from P2P or API) that passes gossip validation on the `proposer_preferences` topic */
   proposerPreferences = "proposer_preferences",
+  /** The node has executed the Fast Confirmation Rule and produced a confirmed beacon block */
+  fastConfirmation = "fast_confirmation",
 }
 
 export const eventTypes: {[K in EventType]: K} = {
@@ -135,6 +137,7 @@ export const eventTypes: {[K in EventType]: K} = {
   [EventType.executionPayloadAvailable]: EventType.executionPayloadAvailable,
   [EventType.executionPayloadBid]: EventType.executionPayloadBid,
   [EventType.proposerPreferences]: EventType.proposerPreferences,
+  [EventType.fastConfirmation]: EventType.fastConfirmation,
 };
 
 export type EventData = {
@@ -203,6 +206,11 @@ export type EventData = {
   };
   [EventType.executionPayloadBid]: {version: ForkName; data: gloas.SignedExecutionPayloadBid};
   [EventType.proposerPreferences]: {version: ForkName; data: gloas.SignedProposerPreferences};
+  [EventType.fastConfirmation]: {
+    block: RootHex;
+    slot: Slot;
+    currentSlot: Slot;
+  };
 };
 
 export type BeaconEvent = {[K in EventType]: {type: K; message: EventData[K]}}[EventType];
@@ -400,6 +408,14 @@ export function getTypeByEvent(config: ChainForkConfig): {[K in EventType]: Type
     ),
     [EventType.executionPayloadBid]: WithVersion((fork) => getPostGloasForkTypes(fork).SignedExecutionPayloadBid),
     [EventType.proposerPreferences]: WithVersion((fork) => getPostGloasForkTypes(fork).SignedProposerPreferences),
+    [EventType.fastConfirmation]: new ContainerType(
+      {
+        block: stringType,
+        slot: ssz.Slot,
+        currentSlot: ssz.Slot,
+      },
+      {jsonCase: "eth2"}
+    ),
 
     [EventType.lightClientOptimisticUpdate]: WithVersion(
       (fork) => getPostAltairForkTypes(fork).LightClientOptimisticUpdate

package/src/beacon/routes/lodestar.ts

@@ -136,6 +136,25 @@ export type CustodyInfo = {
   custodyColumns: number[];
 };
 
+export type FastConfirmationInfo = {
+  confirmed: {
+    rootHex: RootHex | null;
+    slot: Slot | null;
+  };
+  head: {
+    rootHex: RootHex;
+    slot: Slot;
+  };
+  justifiedCheckpoint: {
+    rootHex: RootHex;
+    epoch: Epoch;
+  };
+  finalizedCheckpoint: {
+    rootHex: RootHex;
+    epoch: Epoch;
+  };
+};
+
 export type Endpoints = {
   /** Trigger to write a heapdump to disk at `dirpath`. May take > 1min */
   writeHeapdump: Endpoint<
@@ -397,6 +416,8 @@ export type Endpoints = {
     EmptyMeta
   >;
 
+  getFastConfirmationInfo: Endpoint<"GET", EmptyArgs, EmptyRequest, FastConfirmationInfo, EmptyMeta>;
+
   /** Craft attester slashings from the attestations in the provided blocks */
   getAttesterSlashingsFromBlocks: Endpoint<
     "POST",
@@ -579,8 +600,6 @@ export function getDefinitions(config: ChainForkConfig): RouteDefinitions<Endpoi
         meta: ExecutionOptimisticFinalizedAndVersionCodec,
       },
     },
-    // TODO GLOAS: this endpoint needs to be updated because post-gloas there could be two variants of the persisted checkpoint state (empty or full).
-    // Either add a an additional parameter `payloadPresent`, or return one or both variants of state.
     getPersistedCheckpointState: {
       url: "/eth/v1/lodestar/persisted_checkpoint_state",
       method: "GET",
@@ -634,6 +653,12 @@ export function getDefinitions(config: ChainForkConfig): RouteDefinitions<Endpoi
       req: EmptyRequestCodec,
       resp: JsonOnlyResponseCodec,
     },
+    getFastConfirmationInfo: {
+      url: "/eth/v1/lodestar/fast_confirmation",
+      method: "GET",
+      req: EmptyRequestCodec,
+      resp: JsonOnlyResponseCodec,
+    },
     getAttesterSlashingsFromBlocks: {
       url: "/eth/v1/lodestar/blocks/attester_slashings",
       method: "POST",

package/src/beacon/routes/validator.ts

@@ -499,23 +499,6 @@ export type Endpoints = {
     EmptyMeta
   >;
 
-  /**
-   * Get aggregated attestation
-   * Aggregates all attestations matching given attestation data root and slot
-   * Returns an aggregated `Attestation` object with same `AttestationData` root.
-   */
-  getAggregatedAttestation: Endpoint<
-    "GET",
-    {
-      /** HashTreeRoot of AttestationData that validator want's aggregated */
-      attestationDataRoot: Root;
-      slot: Slot;
-    },
-    {query: {attestation_data_root: string; slot: number}},
-    phase0.Attestation,
-    EmptyMeta
-  >;
-
   /**
    * Get aggregated attestation
    * Aggregates all attestations matching given attestation data root, slot and committee index
@@ -534,18 +517,6 @@ export type Endpoints = {
     VersionMeta
   >;
 
-  /**
-   * Publish multiple aggregate and proofs
-   * Verifies given aggregate and proofs and publishes them on appropriate gossipsub topic.
-   */
-  publishAggregateAndProofs: Endpoint<
-    "POST",
-    {signedAggregateAndProofs: SignedAggregateAndProofListPhase0},
-    {body: unknown},
-    EmptyResponseData,
-    EmptyMeta
-  >;
-
   /**
    * Publish multiple aggregate and proofs
    * Verifies given aggregate and proofs and publishes them on appropriate gossipsub topic.
@@ -960,7 +931,7 @@ export function getDefinitions(config: ChainForkConfig): RouteDefinitions<Endpoi
       },
     },
     getExecutionPayloadEnvelope: {
-      url: "/eth/v1/validator/execution_payload_envelope/{slot}/{beacon_block_root}",
+      url: "/eth/v1/validator/execution_payload_envelopes/{slot}/{beacon_block_root}",
       method: "GET",
       req: {
         writeReq: ({slot, beaconBlockRoot}) => ({
@@ -1040,29 +1011,6 @@ export function getDefinitions(config: ChainForkConfig): RouteDefinitions<Endpoi
         meta: EmptyMetaCodec,
       },
     },
-    getAggregatedAttestation: {
-      url: "/eth/v1/validator/aggregate_attestation",
-      method: "GET",
-      req: {
-        writeReq: ({attestationDataRoot, slot}) => ({
-          query: {attestation_data_root: toRootHex(attestationDataRoot), slot},
-        }),
-        parseReq: ({query}) => ({
-          attestationDataRoot: fromHex(query.attestation_data_root),
-          slot: query.slot,
-        }),
-        schema: {
-          query: {
-            attestation_data_root: Schema.StringRequired,
-            slot: Schema.UintRequired,
-          },
-        },
-      },
-      resp: {
-        data: ssz.phase0.Attestation,
-        meta: EmptyMetaCodec,
-      },
-    },
     getAggregatedAttestationV2: {
       url: "/eth/v2/validator/aggregate_attestation",
       method: "GET",
@@ -1088,28 +1036,6 @@ export function getDefinitions(config: ChainForkConfig): RouteDefinitions<Endpoi
         meta: VersionCodec,
       },
     },
-    publishAggregateAndProofs: {
-      url: "/eth/v1/validator/aggregate_and_proofs",
-      method: "POST",
-      req: {
-        writeReqJson: ({signedAggregateAndProofs}) => ({
-          body: SignedAggregateAndProofListPhase0Type.toJson(signedAggregateAndProofs),
-        }),
-        parseReqJson: ({body}) => ({
-          signedAggregateAndProofs: SignedAggregateAndProofListPhase0Type.fromJson(body),
-        }),
-        writeReqSsz: ({signedAggregateAndProofs}) => ({
-          body: SignedAggregateAndProofListPhase0Type.serialize(signedAggregateAndProofs),
-        }),
-        parseReqSsz: ({body}) => ({
-          signedAggregateAndProofs: SignedAggregateAndProofListPhase0Type.deserialize(body),
-        }),
-        schema: {
-          body: Schema.ObjectArray,
-        },
-      },
-      resp: EmptyResponseCodec,
-    },
     publishAggregateAndProofsV2: {
       url: "/eth/v2/validator/aggregate_and_proofs",
       method: "POST",