StateResponse

Properties

rows
required
Array<DBRow> .  An array of rows in the table, sorted by their uint64 key.
up_to_block_id
Optional
String .  Block ID at which the snapshot was taken when querying the reversible chain segment. This will not be present if querying blocks older than the last irreversible block.
up_to_block_num
Optional
Number (uint32) .  Block number extracted from up_to_block_id if present, provided as a convenience so you don’t need to extract it yourself.
last_irreversible_block_id
Optional
String .  Last irreversible block considered for this request. The returned snapshot is still for the requested block_num, even though the irreversible block shown here is more recent.
last_irreversible_block_num
Optional
Number (uint32) .  Block number extracted from last_irreversible_block_num, provided as a convenience so you don’t need to extract it yourself.
abi
Optional
Object .  A JSON representation of the ABI that is stored within the account. It is the ABI in effect at the requested block_num.

The main difference between a StateResponse and a MultiStateResponse is the rows field above.

Sample Response

Here is a sample response, for a request at block_num: 8:

{
  "up_to_block_id": "0000001000000000000000000000000000000000000000000000000000000000",
  "up_to_block_num": 8,
  "last_irreversible_block_id": "0000000400000000000000000000000000000000000000000000000000000000",
  "last_irreversible_block_num": 4,
  "abi": {
    ...
  },
  "rows": [
    {
      "key": "account123",
      "payer": "account123",
      "json": {
        "owner": "account123"
      },
      "block": 1
    },
    ... or ...
    {
      "key": "account123",
      "payer": "account123",
      "hex": "0011223344556677",
      "block": 2
    },
    ...
  ]
}