NetworkStatusResponse
NetworkStatusResponse contains basic information about the node's view of a blockchain network. It is assumed that any BlockIdentifier.Index less than or equal to CurrentBlockIdentifier.Index can be queried. If a Rosetta implementation prunes historical state, it should populate the optional oldest_block_identifier
field with the oldest block available to query. If this is not populated, it is assumed that the genesis_block_identifier
is the oldest queryable block. If a Rosetta implementation performs some pre-sync before it is possible to query blocks, sync_status should be populated so that clients can still monitor healthiness. Without this field, it may appear that the implementation is stuck syncing and needs to be terminated.
Properties
Name | Type | Description | Required |
---|---|---|---|
current_block_identifier | BlockIdentifier | The block_identifier uniquely identifies a block in a particular network. | True |
current_block_timestamp | Int64 (>=0) | The timestamp of the block in milliseconds since the Unix Epoch. The timestamp is stored in milliseconds because some blockchains produce blocks more often than once a second. | True |
genesis_block_identifier | BlockIdentifier | The block_identifier uniquely identifies a block in a particular network. | True |
oldest_block_identifier | BlockIdentifier | The block_identifier uniquely identifies a block in a particular network. | False |
sync_status | SyncStatus | SyncStatus is used to provide additional context about an implementation's sync status. It is often used to indicate that an implementation is healthy when it cannot be queried until some sync phase occurs. If an implementation is immediately queryable, this model is often not populated. | False |
peers | []Peer | True |
Example
{
"current_block_identifier": {
"index": 1123941,
"hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
},
"current_block_timestamp": 1582833600000,
"genesis_block_identifier": {
"index": 1123941,
"hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
},
"oldest_block_identifier": {
"index": 1123941,
"hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
},
"sync_status": {
"current_index": 100,
"target_index": 150,
"stage": "header sync"
},
"peers": [
{
"peer_id": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5",
"metadata": {}
}
]
}