Skip to main content

eth-v1-validator-aggregate_attestation

/eth/v1/validator/aggregate_attestation

Get aggregated attestation​

Combines all attestations that correspond to a specific attestation data root and slot.

If the block specified by the beacon_block_root answer is optimistic (i.e., the aggregated attestation attests to a block that has not been fully verified by an execution engine), a 503 error has to be returned.

If there isn't an attestation for the specified attestation_data_root, a 404 error needs to be returned.

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

In this section, we provide an illustrative example of a request made to retrieve details contents using the /v1/validator/aggregate_attestation endpoint. Additionally, we present the resulting response containing information about getting an aggregated attestation.

Parameters​

FieldsTypeDescription

attestation_data_root*

stringHashTreeRoot of AttestationData that validator wants aggregated

slot*

stringThe slot for which the block should be proposed.
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!

Get aggregated attestation​

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

Query Parameters​

NameTypeDescription
slot*string1
attestation_data_root*string0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
{
  "data": {
    "aggregation_bits": "0x01",
    "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505",
    "data": {
      "slot": "1",
      "index": "1",
      "beacon_block_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2",
      "source": {
        "epoch": "1",
        "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
      },
      "target": {
        "epoch": "1",
        "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
      }
    }
  }
}

Curl Request example​

curl -X 'GET' \
  'https://eth-holesky-beacon.blastapi.io/<project-id>/eth/v1/validator/aggregate_attestation?attestation_data_root=0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2&slot=1' \
  -H 'accept: application/json'