Default Tide Disco API
/default-tide-disco-api//:height/:view/accounts
height | Integer |
view | Integer |
Bulk version of /:height/:view/account
. The request body should be a JSON array consisting of TaggedBase64-encoded fee accounts.
The response is a FeeMerkleTree
containing sub-trees for each of the requested accounts, which is a more condensed way to represent the union of account proofs for each requested account. Individual Merkle proofs for each account can be extracted from this tree.
/default-tide-disco-api//:height/:view/account/:address
view | Integer |
address | Literal |
height | Integer |
Get the fee account balance for address
.
This endpoint can be used to catch up to the current state from a recent state by fetching the balance (with proof) at the given block :height
and :view
number. :height
and :view
must correspond! :height
is provided to simplify lookups for backends where data is not indexed by view.
This endpoint is intended to be used for catchup, so :view
should be no older than the last decided view.
Returns the account balance and a Merkle proof relative to the fee state root at the requested height and view. If there is no entry for this account in the requested fee state (note: this is distinct from the server not knowing the entry for this account), the returned balance is 0 and the proof is a Merkle non-membership proof.
{
"balance": "integer",
"proof": { ... },
}
/default-tide-disco-api//:height/:view/blocks
height | Integer |
view | Integer |
Get the blocks Merkle tree frontier.
This endpoint can be used to catch up to the current state from a recent state by fetching the frontier at the given block :height
and :view
number. :height
and :view
must correspond! :height
is provided to simplify lookups for backends where data is not indexed by view.
This endpoint is intended to be used for catchup, so :view
should be no older than the last decided view.
Returns the blocks Merkle tree frontier -- the path to the most recently appended leaf, relative to root node at the requested block height and view.
/default-tide-disco-api//chain-config/:commitment
commitment | TaggedBase64 |
This endpoint retrieves the chain config from a peer that matches the specified :commitment
. This is only called when the state does not have full chain config which is different from the genesis one. This can happen if the node missed a protocol upgrade.
Returns the chain config -- this includes parameters such as max_block_size
, chain_id
, base_fee
, and fee_recipient
.
Copyright © 2022 Espresso Systems. All rights reserved.