Skip to main content

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

Retrieves the full BeaconState object.

Updated on
Apr 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
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
Request
1
curl --location 'https://docs-demo.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