getBlockAttestations

Overview

The getBlockAttestations endpoint allows you to retrieve attestations associated with a specific Ethereum 2.0 Beacon Chain block.

Example use cases:

1. Attestation Analysis: Researchers and validators can use this endpoint to analyze attestations made for a specific block.
2. Validator Operations: Validators may need to retrieve attestations to check if their attestations have been included in a block.

Parameters

Returns

• execution_optimistic (boolean): true if the response references an unverified execution payload. Optimistic information may be invalidated at a later time. If the field is not present, assume the false value.
• finalized (boolean): If the response mentions the chain's final history picked by forks, it's true. Without the field, more calls are needed to compare the requested epoch with the final checkpoint.
• data (object array): The data array contains information about attestations.
  • aggregation_bits (string): The attester aggregation bits
  • data (object array): The AttestationData object from the CL spec
    • slot: The corresponding slot
    • index: The index
    • beacon_block_root: The LMD GHOST vote
    • source (object array): The Checkpoint
      • epoch (string): The corresponding epoch
      • root (string): The corresponding root
    • target (object array): The Checkpoint
      • epoch (string): The corresponding epoch
      • root (string): The corresponding root
  • signature (string): The signature

Request Example

// Import necessary libraries and modules
import { TatumSDK, Ethereum, Network } from '@tatumio/tatum';

// Initialize the Tatum SDK with Ethereum-specific parameters
const tatum = await TatumSDK.init<Ethereum>({ network: Network.ETHEREUM });

// Specify the block ID in camel case
const blockId = '0xabcdef1234567890';

// Retrieve attestations for the specified block using the tatum.rpc.beacon.v1.getBlockAttestations method
const attestations = await tatum.rpc.beacon.v1.getBlockAttestations(blockId);

// Destroy Tatum SDK - needed for stopping background jobs
await tatum.destroy();