Add endpoints for block and attestation rewards

apis/beacon/attestations/rewards.yaml

@@ -0,0 +1,49 @@
+get:
+  operationId: getAttestationsRewards
+  summary: Get attestations rewards
+  description: Retrieves rewards info for attestations 
+  tags:
+    - Beacon
+    - Rewards
+  parameters:
+    - name: epoch
+      in: path
+      required: true
+      description: "The epoch to get rewards info from"
+      schema:
+        $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Uint64"
+  responses:
+    "200":
+      description: "Success"
+      content:
+        application/json:
+          schema:
+            title: GetAttestationsRewardsResponse
+            type: object
+            properties:
+              data:
+                $ref: '../../../beacon-node-oapi.yaml#/components/schemas/AttestationsRewards'
+    "400":
+      description: "Invalid get attestations rewards request"
+      content:
+        application/json:
+          schema:
+            $ref: "../../../beacon-node-oapi.yaml#/components/schemas/ErrorMessage"
+          examples:
+            InvalidRequest:
+              value:
+                code: 400
+                message: "Invalid request to retrieve attestations rewards info"
+    "404":
+      description: "Invalid epoch"
+      content:
+        application/json:
+          schema:
+            $ref: "../../../beacon-node-oapi.yaml#/components/schemas/ErrorMessage"
+          examples:
+            InvalidRequest:
+              value:
+                code: 404
+                message: "Invalid epoch or epoch is not available"
+    "500":
+      $ref: "../../../beacon-node-oapi.yaml#/components/responses/InternalError"

apis/beacon/blocks/rewards.yaml

@@ -0,0 +1,49 @@
+get:
+  operationId: getBlockRewards
+  summary: Get block rewards
+  description: Retrieves block rewards info in a slot 
+  tags:
+    - Beacon
+    - Rewards
+  parameters:
+    - name: block_id
+      in: path
+      required: true
+      description: "The id of the block to get rewards info from"
+      schema:
+        $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Uint64"
+  responses:
+    "200":
+      description: "Success"
+      content:
+        application/json:
+          schema:
+            title: GetBlockRewardsResponse
+            type: object
+            properties:
+              data:
+                $ref: '../../../beacon-node-oapi.yaml#/components/schemas/BlockRewards'
+    "400":
+      description: "Invalid get block rewards request"
+      content:
+        application/json:
+          schema:
+            $ref: "../../../beacon-node-oapi.yaml#/components/schemas/ErrorMessage"
+          examples:
+            InvalidRequest:
+              value:
+                code: 400
+                message: "Invalid request to retrieve block rewards info"
+    "404":
+      description: "Block not found"
+      content:
+        application/json:
+          schema:
+            $ref: "../../../beacon-node-oapi.yaml#/components/schemas/ErrorMessage"
+          examples:
+            InvalidRequest:
+              value:
+                code: 404
+                message: "Block not found"
+    "500":
+      $ref: "../../../beacon-node-oapi.yaml#/components/responses/InternalError"

beacon-node-oapi.yaml

@@ -90,6 +90,8 @@ paths:
     $ref: "./apis/beacon/blocks/root.yaml"
   /eth/v1/beacon/blocks/{block_id}/attestations:
     $ref: "./apis/beacon/blocks/attestations.yaml"
+  /eth/v1/beacon/blocks/{block_id}/rewards:
+    $ref: "./apis/beacon/blocks/rewards.yaml"
   /eth/v1/beacon/blinded_blocks/{block_id}:
     $ref: "./apis/beacon/blocks/blinded_block.yaml"
   /eth/v1/beacon/light_client/bootstrap/{block_root}:
@@ -112,6 +114,8 @@ paths:
     $ref: "./apis/beacon/pool/voluntary_exists.yaml"
   /eth/v1/beacon/pool/bls_to_execution_changes:
     $ref: "./apis/beacon/pool/bls_to_execution_changes.yaml"
+  /eth/v1/beacon/attestations/{epoch}/rewards:
+    $ref: "./apis/beacon/attestations/rewards.yaml"
 
   /eth/v2/debug/beacon/states/{state_id}:
     $ref: './apis/debug/state.v2.yaml'
@@ -314,6 +318,10 @@ components:
       $ref: './types/fork_choice.yaml#/Node'
     ExtraData:
       $ref: './types/fork_choice.yaml#/ExtraData'
+    BlockRewards:
+      $ref: './types/rewards.yaml#/BlockRewards'
+    AttestationsRewards:
+      $ref: './types/rewards.yaml#/AttestationsRewards'
 
   parameters:
     StateId:

types/primitive.yaml

@@ -34,6 +34,10 @@ Uint256:
   type: string
   example: "1"
 
+Int64:
+  type: string
+  example: "1"
+
 DependentRoot:
   allOf:
     - $ref: "./primitive.yaml#/Root"

types/rewards.yaml

@@ -0,0 +1,70 @@
+AttestationsRewards:
+  description: "Rewards info for attestations"
+  type: array
+  items:
+    $ref: "./rewards.yaml#/AttestationRewards"
+
+AttestationRewards:
+  type: object
+  description: "Rewards info for a single attestation"
+  properties:
+    validator_index:
+      allOf:
+        - $ref: "./primitive.yaml#/Uint64"
+        - example: 0
+        - description: "one entry for every validator based on their attestations in the epoch"
+    head:
+      allOf:
+        - $ref: "./primitive.yaml#/Int64"
+        - example: 2000
+        - description: "attester's reward for head vote in gwei"
+    target:
+      allOf:
+        - $ref: "./primitive.yaml#/Int64"
+        - example: 2000
+        - description: "attester's reward for target vote in gwei"
+    source:
+      allOf:
+        - $ref: "./primitive.yaml#/Int64"
+        - example: 4000
+        - description: "attester's reward for source vote in gwei"
+    inclusion_delay:
+      allOf:
+        - $ref: "./primitive.yaml#/Uint64"
+        - example: 2000
+        - description: "attester's inclusion_delay reward in gwei (Optional)"
+
+BlockRewards:
+  type: object
+  description: "Rewards info for a single block"
+  properties:
+    proposer_index:
+      allOf:
+        - $ref: "./primitive.yaml#/Uint64"
+        - example: 123
+        - description: "proposer of the block, the proposer index who receives these rewards"
+    total:
+      allOf:
+        - $ref: "./primitive.yaml#/Uint64"
+        - example: 123
+        - description: "total block reward in gwei, equal to attestations + sync_aggregate + proposer_slashings + attester_slashings"
+    attestations:
+      allOf:
+        - $ref: "./primitive.yaml#/Uint64"
+        - example: 123
+        - description: "block reward component due to included attestations in gwei"
+    sync_aggregate:
+      allOf:
+        - $ref: "./primitive.yaml#/Uint64"
+        - example: 123
+        - description: "block reward component due to included sync_aggregate in gwei"
+    proposer_slashings:
+      allOf:
+        - $ref: "./primitive.yaml#/Uint64"
+        - example: 123
+        - description: "block reward component due to included proposer_slashings in gwei"
+    attester_slashings:
+      allOf:
+        - $ref: "./primitive.yaml#/Uint64"
+        - example: 123
+        - description: "block reward component due to included attester_slashings in gwei"