diff --git a/apis/beacon/rewards/blocks.yaml b/apis/beacon/rewards/blocks.yaml index 54f91d18..a5241b17 100644 --- a/apis/beacon/rewards/blocks.yaml +++ b/apis/beacon/rewards/blocks.yaml @@ -1,7 +1,10 @@ get: operationId: getBlockRewards summary: Get block rewards - description: Retrieve block reward info for a single block + description: | + Retrieve block reward info for a single block. This reward consists of the reward + accruing specifically to the block proposer in its proposer role, rather than any + other roles it might additionally have in that block. tags: - Beacon - Rewards diff --git a/beacon-node-oapi.yaml b/beacon-node-oapi.yaml index 31a60561..dabdd335 100644 --- a/beacon-node-oapi.yaml +++ b/beacon-node-oapi.yaml @@ -484,8 +484,8 @@ components: $ref: './types/primitive.yaml#/Wei' Eth-Consensus-Block-Value: description: | - Consensus rewards paid to the proposer for this block, in Wei. Required in response so - client can determine relative value of consensus blocks. + Consensus rewards for this block in Wei paid to the proposer, attributable specifically to its role as + proposer. Required in response so client can determine relative value of consensus blocks. required: true schema: $ref: './types/primitive.yaml#/Wei'