Skip to main content

/eth/v2/debug/beacon/states/{state_id} RPC Method

Retrieves the full BeaconState object.

Updated on
Dec 17, 2024

/eth/v2/debug/beacon/states/{state_id} RPC Method

Parameters

state_id
string
REQUIRED
Specifies the state ID to retrieve. Can be one of: head (canonical head in node's view), genesis, finalized, justified, <slot>, <hex encoded stateRoot with 0x prefix>

Returns

version
string
Version values such as phase0, altair, bellatrix, capella, and deneb
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
Indicates whether the state is finalized or not
data
object
The BeaconState object containing detailed state information at a specific point in the blockchain
genesis_time
string
The genesis time of the beacon chain
genesis_validators_root
string
The root hash of the genesis validators
slot
string
The current slot of the beacon chain
fork
object
Information about the current and previous fork versions and the epoch at which the current version was introduced
previous_version
string
The fork version before the current version
current_version
string
The current fork version
epoch
string
The epoch at which the current fork version was introduced
latest_block_header
object
The latest block header information
slot
string
The slot of the latest block
proposer_index
string
The index of the proposer of the latest block
parent_root
string
The root of the parent block
state_root
string
The root of the state at the time of this block
body_root
string
The root of the block body
block_roots
array
An array of block root hashes
state_roots
array
An array of state root hashes
historical_roots
array
An array of historical root hashes
eth1_data
object
An object of eth1 data
deposit_root
string
An deposit root
deposit_count
string
An deposit count value
block_hash
string
An block hash string
eth1_data_votes
array
An array of eth1 data votes
deposit_root
string
An deposit root
deposit_count
string
An deposit count value
block_hash
string
An block hash string
eth1_deposit_index
string
An string of the deposit index
validators
array
An array of objects containing validator info
pubkey
string
The validator's BLS public key, uniquely identifying them. 48-bytes, hex encoded with 0x prefix, case insensitive
withdraw_credentials
string
Root of withdrawal credentials
effective_balance
string
Balance at stake in Gwei
slashed
boolean
Was validator slashed (not longer active)
activation_elgibility_epoch
string
When criteria for activation were met
activation_epoch
string
Epoch when validator activated. 'FAR_FUTURE_EPOCH' if not activated
exit_epoch
string
Epoch when validator exited. 'FAR_FUTURE_EPOCH' if not exited
withdrawable_epoch
string
When validator can withdraw or transfer funds. 'FAR_FUTURE_EPOCH' if not defined
balances
array
Validator balances in gwei. Variable length list, maximum 1099511627776 items
randao_mixes
array
Fixed length of 65536 items
slashings
array
Per-epoch sums of slashed effective balances. Fixed length of 8192 items
previous_epoch_attestations
array
(Optional) List of attestations from the previous epoch
aggregation_bits
string
Attester aggregation bits
data
object
Data object containing values from slot, index, beacon root, source and target
slot
string
Slot value
index
string
The index value
beacon_block_root
string
The beacon block root hash
source
string
The checkpoint source
epoch
string
The epoch of the justified checkpoint
root
string
The root of the justified checkpoint
target
string
The checkpoint target
epoch
string
The epoch of the justified checkpoint
root
string
The root of the justified checkpoint
inclusion_delay
string
Inclusion delay string value
proposer_index
string
Proposer index string value
current_epoch_attestations
array
List of attestations from the current epoch
justification_bits
string
Bitfield representing recent block justification
previous_justified_checkpoint
object
Information on the previously justified checkpoint
epoch
string
The epoch of the justified checkpoint
root
string
The root of the justified checkpoint
current_justified_checkpoint
object
Information on the currently justified checkpoint
epoch
string
The epoch of the justified checkpoint
root
string
The root of the justified checkpoint
finalized_checkpoint
object
Information on the finalized checkpoint
epoch
string
The epoch of the finalized checkpoint
root
string
The root of the finalized checkpoint
inactivity_scores
array
A list of string values representing validator inactivity scores
current_sync_committee
object
The current_sync_committee object which contains the following fields:
pubkeys
string
A list of public keys for the current sync committee members
aggregate_pubkey
string
An aggregate public key representing the current sync committee
next_sync_committee
object
The next_sync_committee object which contains the following fields:
pubkeys
string
A list of public keys for the next sync committee members
aggregate_pubkey
string
An aggregate public key representing the next sync committee
latest_execution_payload_header
object
The latest_execution_payload_header object which contains the following fields:
parent_hash
string
Hash of the parent block in the execution chain
fee_recipient
string
Address of the fee recipient in the execution payload
state_root
string
Root of the state at this execution block
receipts_root
string
Root of receipts in the execution payload
logs_bloom
string
Bloom filter for logs in the execution payload
prev_randao
string
Previous RANDAO value for randomness
block_number
string
Block number in the execution chain
gas_limit
string
Maximum gas allowed in this execution block
gas_used
string
Gas used in the execution block
timestamp
string
Timestamp of the execution block
extra_data
string
Extra data in the execution block
base_fee_per_gas
string
Base fee per gas unit in the block
block_hash
string
Hash of the execution block
transactions_root
string
Root of the transactions included in the block
Request
1
curl --location 'https://docs-demo.vana-mainnet.quiknode.pro/eth/v2/debug/beacon/states/head' \
2
--header 'Accept: application/json'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free