Skip to main content

header.GetRangeByHeight RPC

Returns the given range (from:to) of ExtendedHeaders from the node's header store and verifies that the returned headers are adjacent to each other.

Updated on
Nov 7, 2024

header.GetRangeByHeight RPC

Parameters

object
object
REQUIRED
An object which contains the follwing fields:
header
object
The header object which contains the information about the block header
version
object
The version of the block and the application
block
string
The block version
app
string
The application version
chain_id
string
The ID of the blockchain
height
string
The height of the block
time
string
The time at which the block was created
last_block_id
object
The last_block_id object which contains the information about the last block's ID
hash
string
The hash of the last block
parts
string
The parts object which contains the information about the parts of the last block
last_commit_hash
string
The hash of the last commit
data_hash
string
The hash of the block's data
validators_hash
string
The hash of the validators
next_validators_hash
string
The hash of the next validators
consensus_hash
string
The hash of the consensus
app_hash
string
The hash of the application
last_results_hash
string
The hash of the last results
evidence_hash
string
The hash of the evidence
proposer_address
string
The address of the proposer
validator_set
object
Information about validators
validators
array
An array of validators, which contains the following fields:
address
string
The address of the validator
pub_key
object
The public key of the validator
type
string
The type of public key
value
string
The value of public key
voting_power
string
The voting power of the validator
proposer_priority
string
The proposer priority of the validator
proposer
object
Information about the proposer for the round
address
string
The address of the proposer
pub_key
object
The public key of the proposer
type
string
The type of public key
value
string
The value of public key
voting_power
string
The voting power of the proposer
proposer_priority
string
The proposer priority of the proposer
commit
object
The information about the commit associated with the block
height
integer
The height of the commit
round
integer
The round of the commit
block_id
object
The block_id object which provide the information about the ID of the last commit's block
hash
string
The hash of the last commit's block
parts
object
The parts object which provide the information about the parts of the last commit's block
total
integer
The total number of parts of the last commit's block
hash
string
The hash of the parts of the last commit's block
signatures
array
An array of signatures which contains the following fields:
block_id_flag
integer
The flag for the block ID
validator_address
string
The address of the validator who created this signature
timestamp
string
The timestamp of the signature
signature
string
The signature
dah
string
The dah object which contains the following fields:
to
integer
REQUIRED
The end range of the block

Returns

result
object
The result object which contains the following fields:
header
object
The header object which contains the information about the block header
version
object
The version of the block and the application
block
string
The block version
app
string
The application version
chain_id
string
The ID of the blockchain
height
string
The height of the block
time
string
The time at which the block was created
last_block_id
object
The last_block_id object which contains the information about the last block's ID
hash
string
The hash of the last block
parts
string
The parts object which contains the information about the parts of the last block
total
integer
The total number of parts of the last block
hash
string
The hash of the parts of the last block
last_commit_hash
string
The hash of the last commit
data_hash
string
The hash of the block's data
validators_hash
string
The hash of the validators
next_validators_hash
string
The hash of the next validators
consensus_hash
string
The hash of the consensus
app_hash
string
The hash of the application
last_results_hash
string
The hash of the last results
evidence_hash
string
The hash of the evidence
proposer_address
string
The address of the proposer
validator_set
object
Information about validators
validators
array
An array of validators, which contains the following fields:
address
string
The address of the validator
pub_key
object
The public key of the validator
type
string
The type of public key
value
string
The value of public key
voting_power
string
The voting power of the validator
proposer_priority
string
The proposer priority of the validator
proposer
object
Information about the proposer for the round
address
string
The address of the proposer
pub_key
object
The public key of the proposer
type
string
The type of public key
value
string
The value of public key
voting_power
string
The voting power of the proposer
proposer_priority
string
The proposer priority of the proposer
commit
object
The information about the commit associated with the block
height
integer
The height of the commit
round
integer
The round of the commit
block_id
object
The block_id object which provide the information about the ID of the last commit's block
hash
string
The hash of the last commit's block
parts
object
The parts object which provide the information about the parts of the last commit's block
total
integer
The total number of parts of the last commit's block
hash
string
The hash of the parts of the last commit's block
signatures
array
An array of signatures which contains the following fields:
block_id_flag
integer
The flag for the block ID
validator_address
string
The address of the validator who created this signature
timestamp
string
The timestamp of the signature
signature
string
The signature
dah
string
The dah object which contains the following fields:
row_roots
string
An array of root hashes for each row in the data availability header, representing row-based Merkle roots to verify data integrity and availability
column_roots
string
An array of root hashes for each column in the data availability header, representing column-based Merkle roots
Request
1
curl --location 'https://docs-demo.celestia-mainnet.quiknode.pro/' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
  "id": 1,
5
  "jsonrpc": "2.0",
6
  "method": "header.GetRangeByHeight",
7
  "params": [
8
    {
9
        "header": {
10
            "version": {
11
                "block": "11",
12
                "app": "2"
13
            },
14
            "chain_id": "celestia",
15
            "height": "2683973",
16
            "time": "2024-10-31T04:35:36.787488335Z",
17
            "last_block_id": {
18
                "hash": "467DA96B5E2E2562F356AA904D0CCAFB684D16D5EB2EEB59E25270DBAEAF4971",
19
                "parts": {
20
                    "total": 1,
21
                    "hash": "64618AC65D7D9B9BDDA9171B5D6CFF5FE20B31ED658AE1A0E1E0EDFA0CF5F2B1"
22
                }
23
            },
24
            "last_commit_hash": "0BB10A64DC33F133E786AF837E1AF4EC15477369E1C90F5F1A514A7C868CA417",
25
            "data_hash": "EE8E4CDB2648ABF3D6209657B20FA34E2B199FF53351D18D9E20171D3D9A796D",
26
            "validators_hash": "03099425596D5711C13C2106C16A74914D52DCB829742C6AE95159609CF22359",
27
            "next_validators_hash": "03099425596D5711C13C2106C16A74914D52DCB829742C6AE95159609CF22359",
28
            "consensus_hash": "C0B6A634B72AE9687EA53B6D277A73ABA1386BA3CFC6D0F26963602F7F6FFCD6",
29
            "app_hash": "68A329FB2B2E31F7F03CA490E1A8B18BAF6AAEBA0C8C1F37A3BCD386940B0A08",
30
            "last_results_hash": "57C6953BDF0C5FE4EC4B1C2D93B4BE605C0B708055858E8081A433B92B5FF479",
31
            "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
32
            "proposer_address": "AF157EF644055C9847F90FF896C95A848674EC38"
33
        },
34
        "validator_set": {
35
            "validators": [
36
                {
37
                    "address": "95764047BDFFB5CCADFA635DC63365EEB65F00C2",
38
                    "pub_key": {
39
                        "type": "tendermint/PubKeyEd25519",
40
                        "value": "ZkOfeh3Y+qokXhYFPuNf9d1B7+Vn0jAC78Yy+X6eduM="
41
                    },
42
                    "voting_power": "47667032",
43
                    "proposer_priority": "337796841"
44
                }
45
            ],
46
            "proposer": {
47
                "address": "AF157EF644055C9847F90FF896C95A848674EC38",
48
                "pub_key": {
49
                    "type": "tendermint/PubKeyEd25519",
50
                    "value": "xwbuyz6bUNd+Ef79w0ysCU4qgDru1OZTn/yHnPaw5JE="
51
                },
52
                "voting_power": "2265846",
53
                "proposer_priority": "-352043464"
54
            }
55
        },
56
        "commit": {
57
            "height": 2683973,
58
            "round": 0,
59
            "block_id": {
60
                "hash": "E175F5BF91FEEDB11F382742982511A85FBE7D58F02132A5BA55D4E075CFAB13",
61
                "parts": {
62
                    "total": 5,
63
                    "hash": "4C27C95E0F6FAA078F62813155A94720FB202343043BCF8A92B45E4B72178A83"
64
                }
65
            },
66
            "signatures": [
67
                {
68
                    "block_id_flag": 2,
69
                    "validator_address": "95764047BDFFB5CCADFA635DC63365EEB65F00C2",
70
                    "timestamp": "2024-10-31T04:35:42.775297752Z",
71
                    "signature": "y55G6rn+9z/FU3wb3PsDT/a/YpBrpCC/waxbRg7B82yCH/FoQuUwsxgL50RdUN24VGilwGZQYTVbSsisFxGTAA=="
72
                }
73
            ]
74
        },
75
        "dah": {
76
            "row_roots": [
77
                "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFplbml0aBC9HyxAe20ZdXf/PoSaHQXZQlZAXAHEj5g5xj4egMK8"
78
            ],
79
            "column_roots": [
80
                "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAH//////////////////////////////////////tfL+UyW2AVPybgVuO7xwpCfCMftfY851hOZDiwkqXqy"
81
            ]
82
        }
83
    },
84
    2683976
85
  ]
86
}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free