v1

latestOpenAPI 3.0.02026-07-17151326.9 KB

Anchor

Fetches Sidetree transactions in chronological order.

Note: The call may not return all Sidetree transactions in one batch, in which case the caller can use the transaction number of the last transaction in the returned batch to fetch subsequent transactions.

get/anchor/transactions

Query parameters

sincestring

A transaction number. When not given, all Sidetree transactions since inception will be returned. When given, only Sidetree transactions after the specified transaction will be returned.

transaction-time-hashstring

MUST BE given if since parameter is specified. This is the hash associated with the time the transaction specified by the since parameter is anchored on anchor. Multiple transactions can have the same transaction time and thus the same transaction time hash. The transaction time hash helps the anchor layer detect block reorganizations (temporary forks); HTTP 400 Bad Request with invalid_transaction_number_or_time_hash as the code parameter value in a JSON body is returned on such events.

Response

Success

more_transactionsboolean

True if there are more transactions beyond the returned batch. False otherwise.

Example response

{
  "more_transactions": false,
  "transactions": [
    {
      "transaction_number": 89,
      "transaction_time": 545236,
      "transaction_time_hash": "0000000000000000002352597f8ec45c56ad19994808e982f5868c5ff6cfef2e",
      "anchor_string": "QmWd5PH6vyRH5kMdzZRPBnf952dbR4av3Bd7B2wBqMaAcf",
      "transaction_fee_paid": 40000,
      "normalized_transaction_fee": 100,
      "writer": "0af7eccefa3aaa37421914923b4a2034ed5a0ad0"
    },
    {
      "transaction_number": 100,
      "transaction_time": 545236,
      "transaction_time_hash": "00000000000000000000100158f474719e5a319933856f7f464fcc65a3cb2253",
      "anchor_string": "QmbJGU4wNti6vNMGMosXaHbeMHGu9PkAUZtVBb2s2Vyq5d",
      "transaction_fee_paid": 600000,
      "normalized_transaction_fee": 400,
      "writer": "0af7eccefa3aaa37421782523b4a2034ed5a0ad0"
    }
  ]
}