ERergoplatform
blocks

Get headers in a specified range of heights

Changed on
get/blocks/chainSlice

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /blocks/chainSlice
  • Auth
    none declared

Query parameters

fromHeightinteger

Min header height (start of the range)

toHeightinteger

Max header height of the range (last header height then omitted)

Response

Array of headers

idstring base16 required

Base16-encoded 32 byte modifier id

timestampinteger required

Basic timestamp definition

versioninteger required

Ergo blockchain protocol version

adProofsRootstring base16 required

Base16-encoded 32 byte digest

stateRootstring base16 required

Base16-encoded 33 byte digest - digest with extra byte with tree height

transactionsRootstring base16 required

Base16-encoded 32 byte digest

nBitsinteger required

Proof-of-work target (difficulty encoded)

extensionHashstring base16 required

Base16-encoded 32 byte digest

heightinteger required

Height of the block (genesis block height == 1)

difficultystring required
parentIdstring base16 required

Base16-encoded 32 byte modifier id

votesstring base16 required

Base16-encoded votes for a soft-fork and parameters

sizeinteger

Size of the header in bytes

extensionIdstring base16

Base16-encoded 32 byte modifier id

transactionsIdstring base16

Base16-encoded 32 byte modifier id

adProofsIdstring base16

Base16-encoded 32 byte modifier id

Example response

[
  {
    "id": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "timestamp": 1524143059077,
    "version": 2,
    "adProofsRoot": "4ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "stateRoot": "333ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "transactionsRoot": "4ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "nBits": 19857408,
    "extensionHash": "4ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "powSolutions": {
      "pk": "0350e25cee8562697d55275c96bb01b34228f9bd68fd9933f2a25ff195526864f5",
      "w": "0366ea253123dfdb8d6d9ca2cb9ea98629e8f34015b1e4ba942b1d88badfcc6a12",
      "n": "0000000000000000",
      "d": 987654321
    },
    "height": 667,
    "difficulty": "9575989248",
    "parentId": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "votes": "000000",
    "extensionId": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "transactionsId": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "adProofsId": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117"
  }
]

Changes

  • 6c5e30b6bac1Revision changes
    • breaking

      the / response's property type changed from no type to string, and format from no format to base16 for status

    • warning

      removed the optional property / from the response with the status

  • 616d0b0728d4Revision changes
    • breaking

      the / response's property type changed from string to no type, and format from base16 to no format for status

    • info

      added the optional property / to the response with the status