Skip to main content

share.GetRange 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

share.GetRange RPC

Parameters

height
integer
REQUIRED
The block height from which the shares are being requested
start
integer
REQUIRED
The start index of the share range, representing the first share in the range
end
integer
REQUIRED
The end index of the share range, representing the last share in the range

Returns

result
object
The result object which contains the following fields:
Shares
array
An array of base64-encoded strings representing the shares data
Proof
array
An array of proof objects which contains the following fields:
data
string
The base64-encoded data strings, each representing part of the proof
share_proofs
string
An array of objects, each representing a proof for a specific shared resource
start
integer
(Optional) The starting index of the subtree root within the data structure
end
integer
The ending index of the subtree root within the data structure
nodes
string
An array of base64-encoded strings representing intermediary nodes within the Merkle proof path for this subtree
is_max_namespace_ignored
string
(Optional) A boolean indicating whether the maximum namespace is ignored in this proof
namespace_id
string
A base64-encoded string that uniquely identifies the namespace for this blob or data group, linking it to its specific domain or category
row_proof
object
The row_proof object which contains the following fields:
row_roots
array
An array of base64-encoded strings representing root hashes for each row in the data structure
proofs
array
An array containing individual proof objects for the row
total
integer
An integer representing the total number of leaves in the row being proven
index
integer
The index of the specific leaf being proven within the row
leaf_hash
string
A base64-encoded hash of the specific leaf node being proven
aunts
string
An array of base64-encoded hashes representing sibling nodes in the Merkle path, used to reconstruct and verify the row's root hash
start_row
integer
The starting row index for this proof within the data structure
end_row
integer
The ending row index for this proof within the data structure
namespace_version
string
An integer indicating the version of the namespace used, allowing backward compatibility with older namespace versions
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": "share.GetRange",
7
"params": [
8
2683873,
9
0,
10
74
11
]
12
}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free