@lodestar/api 1.44.0-dev.de5436c9ff → 1.44.0-dev.df8a25e36b

package/src/beacon/routes/beacon/block.ts

@@ -1,12 +1,10 @@
 import {ContainerType, ListCompositeType, ValueOf} from "@chainsafe/ssz";
 import {ChainForkConfig} from "@lodestar/config";
 import {
-  ForkName,
   ForkPostDeneb,
   ForkPostGloas,
   ForkPreBellatrix,
   ForkPreDeneb,
-  ForkPreElectra,
   isForkPostBellatrix,
   isForkPostDeneb,
   isForkPostGloas,
@@ -99,18 +97,6 @@ export type Endpoints = {
     ExecutionOptimisticFinalizedAndVersionMeta
   >;
 
-  /**
-   * Get block attestations
-   * Retrieves attestation included in requested block.
-   */
-  getBlockAttestations: Endpoint<
-    "GET",
-    BlockArgs,
-    {params: {block_id: string}},
-    BeaconBlockBody<ForkPreElectra>["attestations"],
-    ExecutionOptimisticAndFinalizedMeta
-  >;
-
   /**
    * Get block attestations
    * Retrieves attestation included in requested block.
@@ -170,14 +156,6 @@ export type Endpoints = {
    *
    * Returns if the block was validated successfully and has been broadcast. It has also been integrated into the beacon node's database.
    */
-  publishBlock: Endpoint<
-    "POST",
-    {signedBlockContents: SignedBlockContents},
-    {body: unknown; headers: {[MetaHeader.Version]: string}},
-    EmptyResponseData,
-    EmptyMeta
-  >;
-
   publishBlockV2: Endpoint<
     "POST",
     {
@@ -193,14 +171,6 @@ export type Endpoints = {
    * Publish a signed blinded block by submitting it to the mev relay and patching in the block
    * transactions beacon node gets in response.
    */
-  publishBlindedBlock: Endpoint<
-    "POST",
-    {signedBlindedBlock: SignedBlindedBeaconBlock},
-    {body: unknown; headers: {[MetaHeader.Version]: string}},
-    EmptyResponseData,
-    EmptyMeta
-  >;
-
   publishBlindedBlockV2: Endpoint<
     "POST",
     {
@@ -318,15 +288,6 @@ export function getDefinitions(config: ChainForkConfig): RouteDefinitions<Endpoi
         meta: ExecutionOptimisticFinalizedAndVersionCodec,
       },
     },
-    getBlockAttestations: {
-      url: "/eth/v1/beacon/blocks/{block_id}/attestations",
-      method: "GET",
-      req: blockIdOnlyReq,
-      resp: {
-        data: ssz.phase0.BeaconBlockBody.fields.attestations,
-        meta: ExecutionOptimisticAndFinalizedCodec,
-      },
-    },
     getBlockAttestationsV2: {
       url: "/eth/v2/beacon/blocks/{block_id}/attestations",
       method: "GET",
@@ -367,80 +328,6 @@ export function getDefinitions(config: ChainForkConfig): RouteDefinitions<Endpoi
         meta: ExecutionOptimisticAndFinalizedCodec,
       },
     },
-    publishBlock: {
-      url: "/eth/v1/beacon/blocks",
-      method: "POST",
-      req: {
-        writeReqJson: ({signedBlockContents}) => {
-          const slot = signedBlockContents.signedBlock.message.slot;
-          const fork = config.getForkName(slot);
-
-          return {
-            body: isForkPostDeneb(fork)
-              ? sszTypesFor(fork).SignedBlockContents.toJson(signedBlockContents as SignedBlockContents<ForkPostDeneb>)
-              : sszTypesFor(fork).SignedBeaconBlock.toJson(
-                  signedBlockContents.signedBlock as SignedBeaconBlock<ForkPreDeneb>
-                ),
-            headers: {
-              [MetaHeader.Version]: config.getForkName(slot),
-            },
-          };
-        },
-        parseReqJson: ({body, headers}) => {
-          let forkName: ForkName;
-          // As per spec, version header is optional for JSON requests
-          const versionHeader = fromHeaders(headers, MetaHeader.Version, false);
-          if (versionHeader !== undefined) {
-            forkName = toForkName(versionHeader);
-          } else {
-            // Determine fork from slot in JSON payload
-            forkName = config.getForkName(
-              (body as {signed_block: unknown}).signed_block !== undefined
-                ? (body as {signed_block: SignedBeaconBlock}).signed_block.message.slot
-                : (body as SignedBeaconBlock).message.slot
-            );
-          }
-          return {
-            signedBlockContents: isForkPostDeneb(forkName)
-              ? sszTypesFor(forkName).SignedBlockContents.fromJson(body)
-              : {signedBlock: ssz[forkName].SignedBeaconBlock.fromJson(body)},
-          };
-        },
-        writeReqSsz: ({signedBlockContents}) => {
-          const slot = signedBlockContents.signedBlock.message.slot;
-          const fork = config.getForkName(slot);
-
-          return {
-            body: isForkPostDeneb(fork)
-              ? sszTypesFor(fork).SignedBlockContents.serialize(
-                  signedBlockContents as SignedBlockContents<ForkPostDeneb>
-                )
-              : sszTypesFor(fork).SignedBeaconBlock.serialize(
-                  signedBlockContents.signedBlock as SignedBeaconBlock<ForkPreDeneb>
-                ),
-            headers: {
-              [MetaHeader.Version]: config.getForkName(slot),
-            },
-          };
-        },
-        parseReqSsz: ({body, headers}) => {
-          const forkName = toForkName(fromHeaders(headers, MetaHeader.Version));
-          return {
-            signedBlockContents: isForkPostDeneb(forkName)
-              ? sszTypesFor(forkName).SignedBlockContents.deserialize(body)
-              : {signedBlock: ssz[forkName].SignedBeaconBlock.deserialize(body)},
-          };
-        },
-        schema: {
-          body: Schema.Object,
-          headers: {[MetaHeader.Version]: Schema.String},
-        },
-      },
-      resp: EmptyResponseCodec,
-      init: {
-        requestWireFormat: WireFormat.ssz,
-      },
-    },
     publishBlockV2: {
       url: "/eth/v2/beacon/blocks",
       method: "POST",
@@ -513,59 +400,6 @@ export function getDefinitions(config: ChainForkConfig): RouteDefinitions<Endpoi
         requestWireFormat: WireFormat.ssz,
       },
     },
-    publishBlindedBlock: {
-      url: "/eth/v1/beacon/blinded_blocks",
-      method: "POST",
-      req: {
-        writeReqJson: ({signedBlindedBlock}) => {
-          const fork = config.getForkName(signedBlindedBlock.message.slot);
-          return {
-            body: getPostBellatrixForkTypes(fork).SignedBlindedBeaconBlock.toJson(signedBlindedBlock),
-            headers: {
-              [MetaHeader.Version]: fork,
-            },
-          };
-        },
-        parseReqJson: ({body, headers}) => {
-          let fork: ForkName;
-          // As per spec, version header is optional for JSON requests
-          const versionHeader = fromHeaders(headers, MetaHeader.Version, false);
-          if (versionHeader !== undefined) {
-            fork = toForkName(versionHeader);
-          } else {
-            // Determine fork from slot in JSON payload
-            fork = config.getForkName((body as SignedBlindedBeaconBlock).message.slot);
-          }
-
-          return {
-            signedBlindedBlock: getPostBellatrixForkTypes(fork).SignedBlindedBeaconBlock.fromJson(body),
-          };
-        },
-        writeReqSsz: ({signedBlindedBlock}) => {
-          const fork = config.getForkName(signedBlindedBlock.message.slot);
-          return {
-            body: getPostBellatrixForkTypes(fork).SignedBlindedBeaconBlock.serialize(signedBlindedBlock),
-            headers: {
-              [MetaHeader.Version]: fork,
-            },
-          };
-        },
-        parseReqSsz: ({body, headers}) => {
-          const fork = toForkName(fromHeaders(headers, MetaHeader.Version));
-          return {
-            signedBlindedBlock: getPostBellatrixForkTypes(fork).SignedBlindedBeaconBlock.deserialize(body),
-          };
-        },
-        schema: {
-          body: Schema.Object,
-          headers: {[MetaHeader.Version]: Schema.String},
-        },
-      },
-      resp: EmptyResponseCodec,
-      init: {
-        requestWireFormat: WireFormat.ssz,
-      },
-    },
     publishBlindedBlockV2: {
       url: "/eth/v2/beacon/blinded_blocks",
       method: "POST",

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/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

@@ -600,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",

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.
@@ -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",