Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Retrieve details of the chain's genesis.
Get block root
Get block headers
Get all committees for a state
Get block headers
Get state finality checkpoints
Get sync committees for a state
Subscribe to beacon node events
Get validators from state
Get validator from state by id
state_id - string - (Required) State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", {slot}, {hex encoded stateRoot with 0x prefix}.
validator_id - string - (Required) Either hex encoded public key (any bytes48 with 0x prefix) or validator index.
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.
data - object - with the following values:
index - string - Index of validator in validator registry.
balance - string - Current validator balance in gwei.
status - string - Possible statuses:
pending_initialized - When the first deposit is processed, but not enough funds are available (or not yet the end of the first epoch) to get validator into the activation queue
pending_queued - When validator is waiting to get activated, and have enough funds etc. while in the queue, validator activation epoch keeps changing until it gets to the front and make it through (finalization is a requirement here too).
active_ongoing - When validator must be attesting, and have not initiated any exit.
active_exiting - When validator is still active, but filed a voluntary request to exit.
active_slashed - When validator is still active, but have a slashed status and is scheduled to exit.
exited_unslashed - When validator has reached reguler exit epoch, not being slashed, and doesn't have to attest any more, but cannot withdraw yet.
exited_slashed - When validator has reached reguler exit epoch, but was slashed, have to wait for a longer withdrawal period.
withdrawal_possible - After validator has exited, a while later is permitted to move funds, and is truly out of the system.
withdrawal_done - (not possible in phase0, except slashing full balance) - actually having moved funds away.
Get aggregated attestation
Produce a new blinded block, without signature
Produce a sync committee contribution
Get Fork object for requested state
Get block attestations
Get validator balances from state
Get state SSZ HashTreeRoot
Get block proposers duties
Retrieve details of the chain's genesis which can be used to identify chain.
Request successful
The genesis_time configured for the beacon node, which is the unix time in seconds at which the Eth2.0 chain began.
a fork version number
Returns filterable list of validators balances.
Balances will be returned for all indices or public key that match known validators. If an index or public key does not match any known validator, no balance will be returned but this will not cause an error. There are no guarantees for the returned data in terms of ordering; the index and is returned for each balance, and can be used to confirm for which inputs a response has been returned.
State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.
Either hex encoded public key (any bytes48 with 0x prefix) or validator index
Either hex encoded public key (any bytes48 with 0x prefix) or validator index
Success
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.
Index of validator in validator registry.
Current validator balance in gwei.
Provides endpoint to subscribe to beacon node Server-Sent-Events stream. Consumers should use eventsource implementation to listen on those events.
Servers may send SSE comments beginning with :
for any purpose, including to keep the
event stream connection alive in the presence of proxy servers.
Event types to subscribe to
Opened SSE stream.
Retrieves hashTreeRoot of BeaconBlock/BeaconBlockHeader
Block identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", <slot>, <hex encoded blockRoot with 0x prefix>.
Success
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.
HashTreeRoot of BeaconBlock/BeaconBlockHeader object
Calculates HashTreeRoot for state with given 'stateId'. If stateId is root, same value will be returned.
State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.
Success
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.
HashTreeRoot of BeaconState object
Returns Fork object for state with given 'stateId'.
State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.
Success
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.
The Fork
object from the CL spec.
a fork version number
a fork version number
Retrieves block headers matching given query. By default it will fetch current head slot blocks.
Success
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.
The SignedBeaconBlockHeader
object envelope from the CL spec.
The BeaconBlockHeader
object from the CL spec.
The slot to which this block corresponds.
Index of validator in validator registry.
The signing merkle root of the parent BeaconBlock
.
The tree hash merkle root of the BeaconState
for the BeaconBlock
.
The tree hash merkle root of the BeaconBlockBody
for the BeaconBlock
Request beacon node to provide all validators that are scheduled to propose a block in the given epoch. Duties should only need to be checked once per epoch, however a chain reorganization could occur that results in a change of duties. For full safety, you should monitor head events and confirm the dependent root in this response matches:
compute_epoch_at_slot(event.slot) == epoch
The dependent_root value is get_block_root_at_slot(state, compute_start_slot_at_epoch(epoch) - 1)
or the genesis block root in the case of underflow.
Success response
The block root that this response is dependent on.
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.
The validator's BLS public key, uniquely identifying them. 48-bytes, hex encoded with 0x prefix, case insensitive.
Index of validator in validator registry.
The slot at which the validator must propose block.
Retrieves the committees for the given state.
State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.
Fetch committees for the given epoch. If not present then the committees for the epoch of the state will be obtained.
Restrict returned values to those matching the supplied committee index.
Restrict returned values to those matching the supplied slot.
Success
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.
Committee index at a slot
List of validator indices assigned to this committee
Retrieves the sync committees for the given state.
State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.
Fetch sync committees for the given epoch. If not present then the sync committees for the epoch of the state will be obtained.
Success
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.
all of the validator indices in the current sync committee
Subcommittee slices of the current sync committee
Returns finality checkpoints for state with given 'stateId'. In case finality is not yet achieved, checkpoint should return epoch 0 and ZERO_HASH as root.
State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.
Success
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.
Aggregates all attestations matching given attestation data root and slot
HashTreeRoot of AttestationData that validator wants aggregated
Returns aggregated Attestation
object with same AttestationData
root.
The Attestation
object from the CL spec.
Attester aggregation bits.
BLS aggregate signature.
The AttestationData
object from the CL spec.
LMD GHOST vote.
Retrieves block header for given block id.
Block identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", <slot>, <hex encoded blockRoot with 0x prefix>.
Success
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.
The SignedBeaconBlockHeader
object envelope from the CL spec.
The BeaconBlockHeader
object from the CL spec.
The slot to which this block corresponds.
Index of validator in validator registry.
The signing merkle root of the parent BeaconBlock
.
The tree hash merkle root of the BeaconState
for the BeaconBlock
.
The tree hash merkle root of the BeaconBlockBody
for the BeaconBlock
Requests that the beacon node produce a sync committee contribution.
The slot for which a sync committee contribution should be created.
the subcommittee index for which to produce the contribution.
the block root for which to produce the contribution.
Success response
The slot at which the validator is providing a sync committee contribution.
Block root for this contribution.
The index of the subcommittee that the contribution pertains to.
A bit is set if a signature from the validator at the corresponding index in the subcommittee is present in the aggregate signature
.
Signature by the validator(s) over the block root of slot
Retrieves attestation included in requested block.
Block identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", <slot>, <hex encoded blockRoot with 0x prefix>.
Success
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.
Attester aggregation bits.
BLS aggregate signature.
The AttestationData
object from the CL spec.
LMD GHOST vote.
Returns filterable list of validators with their balance, status and index.
Information will be returned for all indices or public key that match known validators. If an index or public key does not match any known validator, no information will be returned but this will not cause an error. There are no guarantees for the returned data in terms of ordering; both the index and public key are returned for each validator, and can be used to confirm for which inputs a response has been returned.
State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.
Either hex encoded public key (any bytes48 with 0x prefix) or validator index
Either hex encoded public key (any bytes48 with 0x prefix) or validator index
Possible statuses:
Success
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.
Index of validator in validator registry.
Current validator balance in gwei.
Possible statuses:
The validator's BLS public key, uniquely identifying them. 48-bytes, hex encoded with 0x prefix, case insensitive.
Root of withdrawal credentials
Balance at stake in Gwei.
Was validator slashed (not longer active).
When criteria for activation were met.
Epoch when validator activated. 'FAR_FUTURE_EPOCH' if not activated
Epoch when validator exited. 'FAR_FUTURE_EPOCH' if not exited.
When validator can withdraw or transfer funds. 'FAR_FUTURE_EPOCH' if not defined
Returns the complete SignedBeaconBlock
for a given block ID.
Depending on the Accept
header it can be returned either as JSON or SSZ-serialized bytes.
Block identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", <slot>, <hex encoded blockRoot with 0x prefix>.
Success
The SignedBeaconBlock
object envelope from the CL spec.
The BeaconBlock
object from the CL spec.
The slot to which this block corresponds.
Index of validator in validator registry.
The signing merkle root of the parent BeaconBlock
.
The tree hash merkle root of the BeaconState
for the BeaconBlock
.
The BeaconBlockBody
object from the CL spec.
The RanDAO reveal value provided by the validator.
The Eth1Data
object from the CL spec.
Root of the deposit tree.
Total number of deposits.
Ethereum 1.x block hash.
The SignedBeaconBlockHeader
object envelope from the CL spec.
The BeaconBlockHeader
object from the CL spec.
The slot to which this block corresponds.
Index of validator in validator registry.
The signing merkle root of the parent BeaconBlock
.
The tree hash merkle root of the BeaconState
for the BeaconBlock
.
The tree hash merkle root of the BeaconBlockBody
for the BeaconBlock
The SignedBeaconBlockHeader
object envelope from the CL spec.
The BeaconBlockHeader
object from the CL spec.
The slot to which this block corresponds.
Index of validator in validator registry.
The signing merkle root of the parent BeaconBlock
.
The tree hash merkle root of the BeaconState
for the BeaconBlock
.
The tree hash merkle root of the BeaconBlockBody
for the BeaconBlock
The IndexedAttestation
object from the CL spec.
Attesting validator indices
The BLS signature of the IndexedAttestation
, created by the validator of the attestation.
The AttestationData
object from the CL spec.
LMD GHOST vote.
The IndexedAttestation
object from the CL spec.
Attesting validator indices
The BLS signature of the IndexedAttestation
, created by the validator of the attestation.
The AttestationData
object from the CL spec.
LMD GHOST vote.
Attester aggregation bits.
BLS aggregate signature.
The AttestationData
object from the CL spec.
LMD GHOST vote.
Branch in the deposit tree.
The DepositData
object from the CL spec.
The validator's BLS public key, uniquely identifying them. 48-bytes, hex encoded with 0x prefix, case insensitive.
The withdrawal credentials.
Amount in Gwei.
Container self-signature.
The VoluntaryExit
object from the CL spec.
Minimum epoch for processing exit.
Index of the exiting validator.
Requests a beacon node to produce a valid blinded block, which can then be signed by a validator. A blinded block is a block with only a transactions root, rather than a full transactions list.
Metadata in the response indicates the type of block produced, and the supported types of block will be added to as forks progress.
Pre-Bellatrix, this endpoint will return a BeaconBlock
.
The slot for which the block should be proposed.
The validator's randao reveal value.
Arbitrary data validator wants to include in block.
Success response
The slot to which this block corresponds.
Index of validator in validator registry.
The signing merkle root of the parent BeaconBlock
.
The tree hash merkle root of the BeaconState
for the BeaconBlock
.
The BeaconBlockBody
object from the CL spec.
The RanDAO reveal value provided by the validator.
The Eth1Data
object from the CL spec.
Root of the deposit tree.
Total number of deposits.
Ethereum 1.x block hash.
The SignedBeaconBlockHeader
object envelope from the CL spec.
The BeaconBlockHeader
object from the CL spec.
The slot to which this block corresponds.
Index of validator in validator registry.
The signing merkle root of the parent BeaconBlock
.
The tree hash merkle root of the BeaconState
for the BeaconBlock
.
The tree hash merkle root of the BeaconBlockBody
for the BeaconBlock
The SignedBeaconBlockHeader
object envelope from the CL spec.
The BeaconBlockHeader
object from the CL spec.
The slot to which this block corresponds.
Index of validator in validator registry.
The signing merkle root of the parent BeaconBlock
.
The tree hash merkle root of the BeaconState
for the BeaconBlock
.
The tree hash merkle root of the BeaconBlockBody
for the BeaconBlock
The IndexedAttestation
object from the CL spec.
Attesting validator indices
The BLS signature of the IndexedAttestation
, created by the validator of the attestation.
The AttestationData
object from the CL spec.
LMD GHOST vote.
The IndexedAttestation
object from the CL spec.
Attesting validator indices
The BLS signature of the IndexedAttestation
, created by the validator of the attestation.
The AttestationData
object from the CL spec.
LMD GHOST vote.
Attester aggregation bits.
BLS aggregate signature.
The AttestationData
object from the CL spec.
LMD GHOST vote.
Branch in the deposit tree.
The DepositData
object from the CL spec.
The validator's BLS public key, uniquely identifying them. 48-bytes, hex encoded with 0x prefix, case insensitive.
The withdrawal credentials.
Amount in Gwei.
Container self-signature.
The VoluntaryExit
object from the CL spec.
Minimum epoch for processing exit.
Index of the exiting validator.