Catchup API
Serves recent consensus state to allow peers to catch up with the network
The primary customer of this API is peer consensus nodes who may have recently joined the network or were temporarily disconnected. These nodes need the very latest state, one which hasn't even been finalized yet, in order to start voting and proposing in consensus.
In HotShot, all state required to participate is represented in the form of Merkle trees or Merkle tries, so this API is able to provide select segments of the state with a proof that will convince the client that the returned segment is accurate, as long as they know the corresponding state commitment.
Types
Account
Account
Endpoints
GET /catchup/account/:address
/catchup/account/:address
Get the balance of the requested fee account in the latest finalized state.
Parameters
Returns Account
Account
GET /catchup/:view/account/:address
/catchup/:view/account/:address
Get the balance of the requested fee account in the state from the requested consensus view. This is used to fetch the state for unfinalized views, to facilitate rapid catchup. If :view
has already been finalized, this endpoint may fail with error 404.
Parameters
Returns Account
Account
GET /catchup/blocks
/catchup/blocks
Get the Merkle frontier (path to most recently inserted element) of the accumulator of blocks, from the most recently finalized state. This frontier is sufficient to append new blocks, so it is all that is needed for state catchup.
Returns MerkleProof
MerkleProof
GET /catchup/:view/blocks
/catchup/:view/blocks
Get the Merkle frontier (path to most recently inserted element) of the accumulator of blocks, from the requested consensus view. This is used to fetch the state for unfinalized views, to facilitate rapid catchup. If :view
has already been finalized, this endpoint may fail with error 404.
Parameters
Returns MerkleProof
MerkleProof
Last updated