Skip to main content

post-eth-v1-validator-prepare_beacon_proposer

POST /eth/v1/validator/prepare_beacon_proposer

Provide beacon node with proposals for the given validators.​

Provides the information needed to propose blocks for the specified validators, setting up the beacon node for possible proposers. The data provided for every validator index will be valid for the duration of the epoch during which the call is made, as well as for an additional two epochs following that, or until the beacon node restarts. It is anticipated that in order to guarantee that beacon nodes have accurate and up-to-date fee recipient information, validator clients would communicate this data on a regular basis, such as every epoch.

The validator should ensure that the fee recipient in the proposed block is acceptable before signing it, as there is no guarantee that the beacon node will use the provided fee recipient when constructing a block proposal.

It should be noted that requests with validator indices that are either unknown or inactive at this time will still be approved because they might become active at a later epoch.

Example Request and Result for /v1/validator/prepare_beacon_proposer​

In this section, we provide an illustrative example of a request made to retrieve details contents using the /v1/validator/prepare_beacon_proposer endpoint. Additionally, we present the resulting response containing information about providing beacon node with proposals for the given validators.

Parameters​

  • none
info

The example in this section uses a non-existing project id.

Make sure you replace it with your Ethereum Holesky Beacon endpoint when issuing the API calls.

Don't have a project id? Here's a straightforward guide on how to obtain one!

Provide beacon node with proposals for the given validators.​

POST https://eth-holesky-beacon.blastapi.io/<project-id>/eth/v1/validator/prepare_beacon_proposer

Preparation information has been received.

Curl Request example​

curl -X 'POST' \
  'https://eth-holesky-beacon.blastapi.io/ed4f817a-c186-4c70-9b97-45e0c138107d/eth/v1/validator/prepare_beacon_proposer' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '[
  {
    "validator_index": "1",
    "fee_recipient": "0xAbcF8e0d4e9587369b2301D0790347320302cc09"
  }
]'