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