Skip to main content

rounds

This page describes the structure of the rounds index (Elasticsearch), and also depicts a few examples of how to query it.

_id​

The _id field of this index is composed in this way: {shardID}_{round} (example: 2_10905514)

Fields​

FieldDescription
roundThe round field represents the number of the round.
signersIndexesThe signersIndexes field is an array that contains the indices of the validators that should sign the block from this round.
blockWasProposedThe blockWasProposed field is true if a block was proposed and executed in this round.
shardIdThe shardId field represents the shard the round belongs to.
epochThe epoch field represents the epoch the round belongs to.
timestampThe timestamp field represents the timestamp of the round.

Query examples​

Fetch the latest rounds for a shard when block was produced​

curl --request GET \
  --url ${ES_URL}/rounds/_search \
  --header 'Content-Type: application/json' \
  --data '{
    "query": {
        "match": {
            "shardId": 1
        }
    },
    "sort": [
        {
            "timestamp": {
                "order": "desc"
            }
        }
    ],
    "size":10
}'