Proofs

Stream Proofs

Returns a stream of proofs committed to the node's ledger.

NOTE: This endpoint may return different results on different nodes:

• Each node may persist different subset of signatures on a given proofs, as long as enough of the validator set has signed.
• Inside an epoch, different nodes may receive and persist / keep different proofs, subject to constraints on gaps between proofs.

Proofs during an epoch can also be garbage collected by the node after the fact. Therefore proofs may disappear from this stream.

Some proofs (such as during genesis and protocol update enactment) are created on a node and don't include signatures.

This stream accepts four different options in the request:

• All proofs forward (from state version)
• All end-of-epoch proofs (from epoch number)
• All end-of-epoch proofs triggering a protocol update
• All node-injected proofs enacting genesis or a protocol update (for protocol update name, from state version)

The end-of-epoch proofs can be used to "trustlessly" verify the validator set for a given epoch. By tracking the fact that validators for epoch N sign the next validator set for epoch N + 1, this chain of proofs can be used to provide proof of the current validator set from a hardcoded start.

When a validator set is known for a given epoch, this can be used to verify the various transaction hash trees in the epoch, and to prove other data.

NOTE: This endpoint was built after agreeing the new Radix convention for paged APIs. Its models therefore follow the new convention, rather than attempting to align with existing loose Core API conventions.

POSThttps://xrd.nownodes.io/core/stream/proofs

Body

application/json

network*NetworkIdentifier (string)

The logical name of the network

Example: "{{network}}"

filterStreamProofsFilter (object)

If not provided, defaults to "Any".

max_page_sizeinteger

If specified, the maximum number of proofs that will be returned.

continuation_tokenContinuationToken (string)

A continuation token is returned if and only if there are further non-empty pages of items currently available. The token can be provided in a following request to fetch the next page of results. The filter and sort should not be changed when re-using the continuation token.

Response

200400500

Stream proofs response

Body

application/json

page*array of LedgerProof (object)

A page of ledger proofs stored by this node.

continuation_tokenContinuationToken (string)

A continuation token is returned if and only if there are further non-empty pages of items currently available. The token can be provided in a following request to fetch the next page of results. The filter and sort should not be changed when re-using the continuation token.

Request

JavaScriptCurlPython

const response = await fetch('https://xrd.nownodes.io/core/stream/proofs', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "network": "{{network}}"
    }),
});
const data = await response.json();

Response

200400500

{
  "page": [
    {
      "ledger_header": {
        "epoch": 0,
        "round": 0,
        "state_version": 0,
        "hashes": {
          "state_tree_hash": "text",
          "transaction_tree_hash": "text",
          "receipt_tree_hash": "text"
        },
        "consensus_parent_round_timestamp_ms": 0,
        "proposer_timestamp_ms": 0,
        "next_epoch": {
          "epoch": 0,
          "validators": [
            {
              "address": "text",
              "key": {
                "key_type": "EcdsaSecp256k1",
                "key_hex": "text"
              },
              "stake": "text"
            }
          ],
          "significant_protocol_update_readiness": [
            {
              "readiness_signal_name": "text",
              "signalled_stake": "text"
            }
          ]
        },
        "next_protocol_version": "text"
      },
      "origin": {
        "type": "Genesis"
      }
    }
  ],
  "continuation_token": "text"
}