/eth/v1/builder/states/{state_id}/expected_withdrawals

Obtain the withdrawals that must be included in the block that is constructed in the designated condition.

Obtain the calculated withdrawals from the designated state, which will be incorporated into the block constructed on the designated state.

Example Request and Result for /v1/builder/states/{state_id}/expected_withdrawals

In this section, we provide an illustrative example of a request made to retrieve details contents using the /v1/builder/states/{state_id}/expected_withdrawals endpoint. Additionally, we present the resulting response containing information about the withdrawals computed from specified state.

Parameters

Field	Type	Description
state_id*	string	State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.
proposal_slot	string	The slot that a block is being built for, with the specified state as the parent. Defaults to the slot after the parent state if not specified.

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!

Obtain the withdrawals that must be included in the block

GET https://eth-holesky-beacon.blastapi.io/<project-id>/eth/v1/builder/states/<state_id>/expected_withdrawals

Path Parameters

Name	Type	Description
state_id*	string	head

Query Parameters

Name	Type	Description
proposal_slot	string	2

200: OK Expand for a detailed response example

{
  "execution_optimistic": false,
  "finalized": false,
  "data": [
    {
      "index": "1",
      "validator_index": "1",
      "address": "0xabcf8e0d4e9587369b2301d0790347320302cc09",
      "amount": "1"
    }
  ]
}

Curl Request example

curl -X 'GET' \
  'https://eth-holesky-beacon.blastapi.io/<project_id>/eth/v1/builder/states/head/expected_withdrawals?proposal_slot=2' \
  -H 'accept: application/json'