A node’s view of a HotShot chain
The node API provides a subjective view of the HotShot blockchain, from the perspective of one particular node. It provides access to information that the availability API does not, because this information depends on the perspective of the node observing it, and may be subject to eventual consistency. For example, /node/block-height may return smaller counts than expected, if the node being queried is not fully synced with the entire history of the chain. However, the node will eventually sync and return the expected counts. See /node/sync-status for information on how in or out of sync the node currently is.
/hotshot-node/transactions/count
/hotshot-node/transactions/count/:to
/hotshot-node/transactions/count/:from/:to
/hotshot-node/transactions/count/namespace/:namespace
/hotshot-node/transactions/count/namespace/:namespace/:to
/hotshot-node/transactions/count/namespace/:namespace/:from/:to
| to | Integer |
| from | Integer |
| namespace | Integer |
Get the number of transactions in the chain.
If :from or :to is specified, they restrict the range of blocks considered. transactions/count/:to will return the number of transactions in all blocks up to and including block number :to, while transactions/count/:from/:to will count the transactions in all blocks between :from (inclusive) and :to (inclusive).
If the :namespace is provided, the count is restricted for the specified namespace
Returns an integer.
/hotshot-node/total-minted-supply
Get the total supply of the espresso token, counting only tokens that have been minted on Ethereum. Does not include unminted tokens from unclaimed rewards or other sources. The value is returned as a decimal in token units (raw totalSupply / 10^18). Calls are cached for an hour after retrieval.
/hotshot-node/sync-status
Get the node’s progress in syncing with the latest state of the blockchain.
Returns
{
"missing_blocks": integer,
"missing_leaves": integer,
"missing_vid_common": integer,
"missing_vid_shares": integer,
"pruned_height": null | integer,
}/hotshot-node/block-height
The current height of the chain, as observed by this node.
Returns an integer.
/hotshot-node/payloads/size
/hotshot-node/payloads/size/:to
/hotshot-node/payloads/size/:from/:to
/hotshot-node/payloads/total-size
/hotshot-node/payloads/size/namespace/:namespace
/hotshot-node/payloads/size/namespace/:namespace/:to
/hotshot-node/payloads/size/namespace/:namespace/:from/:to
| to | Integer |
| from | Integer |
| namespace | Integer |
Get the size (in bytes) of all payload data in the chain.
If :from or :to is specified, they restrict the range of blocks considered. payloads/size/:to will return the cumulative size of all payloads in blocks up to and including block number :to, while payloads/size/:from/:to will return the cumulative size in all blocks between :from (inclusive) and :to (inclusive). If the :namespace is provided, the count is restricted for the specified namespace
payloads/total-size is a deprecated alias for payloads/size.
Returns an integer.
/hotshot-node/limits
Get implementation-defined limits restricting certain requests.
window_limit: the maximum number of headers which can be loaded in a single header/window query.Returns
{
"window_limit": integer
}/hotshot-node/vid/share/:height
/hotshot-node/vid/share/hash/:hash
/hotshot-node/vid/share/payload-hash/:payload-hash
| hash | TaggedBase64 |
| payload-hash | TaggedBase64 |
| height | Integer |
Get information needed to run the VID reconstruction protocol for a block.
Returns this node’s VID share, if available.
/hotshot-node/header/window/:start/:end
/hotshot-node/header/window/from/:height/:end
/hotshot-node/header/window/from/hash/:hash/:end
| hash | TaggedBase64 |
| start | Integer |
| end | Integer |
| height | Integer |
Get block headers in a time window.
Returns all available headers, in order, whose timestamps fall between :start (inclusive) and :end (exclusive), or between the block indicated by :height or :hash (inclusive) and :end (exclusive). The response also includes one block before the desired window (unless the window includes the genesis block) and one block after the window. This proves to the client that the server has not omitted any blocks whose timestamps fall within the desired window.
It is possible that not all blocks in the desired window are available when this endpoint is called. In that case, whichever blocks are available are included in the response, and next is null to indicate that the response is not complete. The client can then use one of the /from/ forms of this endpoint to fetch the remaining blocks from where the first response left off, once they become available. If no blocks are available, not even prev, this endpoint will return an error.
It is also possible that the number of blocks returned may be restricted by an implementation- defined limit (see /limits), even if subsequent blocks within the window are currently available. In this case, next will be null and the client should call again using one of the /from/ forms to get the next page of results, exactly as in the case where some blocks in the window have yet to be produced.
Returns
{
"window": ["Header"],
"prev": "Header", // nullable
"next": "Header" // nullable
}All timestamps are denominated in an integer number of seconds.
/hotshot-node/circulating-supply-ethereum
Circulating supply of espresso tokens on Ethereum L1: totalsupplyl1 - locked. On mainnet, locked tokens follow the unlock schedule. On other networks, locked is zero. Note: totalsupplyl1 grows as rewards are claimed (claiming mints on L1). Returns a decimal string in token units.
/hotshot-node/circulating-supply
Circulating supply of the espresso token: initialsupply + rewarddistributed - locked. On mainnet, locked tokens follow the unlock schedule. On other networks, locked is zero. Returns a decimal string in token units.
Copyright © 2022 Espresso Systems. All rights reserved.