Установка и использование платформы

REST API: информация о блоках сети

https://img.shields.io/badge/auth-required-orange.svg

Для получения информации о различных блоках сети предусмотрена группа методов blocks.

Примечание

Те же данные, что и с помощью REST методов группы blocks можно получить с помощью gRPC метода SubscribeOn.

GET /blocks/height

Метод возвращает номер текущего блока в блокчейне (высоту блокчейна).

Пример ответа:

GET /blocks/height/{signature}

Метод возвращает высоту блока по его подписи {signature}.

Ответ метода содержит поле height, как и метод GET /blocks/height.

GET /blocks/first

Метод возвращает информацию о генезис-блоке сети.

В ответе содержатся следующие параметры:

  • reference – хэш-сумма генезис-блока;

  • blocksize – размер генезис-блока;

  • signature – подпись генезис-блока;

  • fee – комиссия за транзакции, включенные в генезис-блок;

  • generator – адрес создателя генезис-блока;

  • transactionCount – количество транзакций 1 и 101, включенных в генезис-блок;

  • transactions – массив с телами транзакций 1 и 101, включенных в генезис-блок;

  • version – версия генезис-блока;

  • timestamp – временная метка создания генезис-блока в формате Unix Timestamp (в миллисекундах);

  • height – высота создания генезис-блока (1).

Пример ответа:

GET /blocks/last

Метод возвращает содержимое текущего блока блокчейна.

Текущий блок находится в процессе создания, пока он не будет принят нодами-майнерами, количество транзакций в нем может меняться.

В ответе метода возвращаются следующие параметры:

  • reference – хэш-сумма блока;

  • blocksize – размер блока;

  • featuresфункциональные возможности, запущенные на момент создания блока;

  • signature – подпись блока;

  • fee – комиссия за транзакции, включенные в блок;

  • generator – адрес создателя блока;

  • transactionCount – количество транзакций 1 и 101, включенных в блок;

  • transactions – массив с телами транзакций, включенных в блок;

  • version – версия блока;

  • poa-consensus.overall-skipped-rounds – количество пропущенных раундов майнинга, при использовании алгоритма консенсуса PoA;

  • timestamp – временная метка создания блока в формате Unix Timestamp (в миллисекундах);

  • height – высота создания блока.

Пример ответа для пустого текущего блока:

GET /blocks/at/{height}

Метод возвращает содержимое блока на высоте height.

В ответе метода возвращаются следующие параметры:

  • reference – хэш-сумма блока;

  • blocksize – размер блока;

  • featuresфункциональные возможности, запущенные на момент создания блока;

  • signature – подпись блока;

  • fee – комиссия за транзакции, включенные в блок;

  • generator – адрес создателя блока;

  • transactionCount – количество транзакций, включенных в блок;

  • transactions – массив с телами транзакций, включенных в блок;

  • version – версия блока;

  • poa-consensus.overall-skipped-rounds – количество пропущенных раундов майнинга, при использовании алгоритма консенсуса PoA;

  • timestamp – временная метка создания блока в формате Unix Timestamp (в миллисекундах);

  • height – высота создания блока.

Пример ответа:

GET /blocks/seq/{from}/{to}

Метод возвращает содержимое блоков от высоты {from} до высоты {to}.

Для каждого блока возвращаются параметры, идентичные методу GET /blocks/at/{height}.

GET /blocks/seqext/{from}/{to}

Метод возвращает содержимое блоков с расширенной информацией о транзакциях от высоты {from} до высоты {to}.

В остальном, для каждого блока возвращаются параметры, идентичные методу GET /blocks/at/{height}.

GET /blocks/signature/{signature}

Метод возвращает содержимое блока по его подписи {signature}.

В ответе метода возвращаются параметры, идентичные методу GET /blocks/at/{height}.

GET /blocks/address/{address}/{from}/{to}

Метод возвращает содержимое всех блоков, сформированных адресатом {address} от высоты {from} до высоты {to}.

В ответе метода для каждого блока возвращаются параметры, идентичные методу GET /blocks/at/{height}.

GET /blocks/child/{signature}

Метод возвращает унаследованный блок от блока с подписью {signature}.

В ответе метода возвращаются параметры, идентичные методу GET /blocks/at/{height}.

GET /blocks/headers/at/{height}

Метод возвращает заголовок блока на высоте {height}.

В ответе метода возвращаются следующие параметры:

  • reference – хэш-сумма блока;

  • blocksize – размер блока;

  • featuresфункциональные возможности, запущенные на момент создания блока;

  • signature – подпись блока;

  • fee – комиссия за транзакции, включенные в блок;

  • generator – адрес создателя блока;

  • pos-consensus.base-target – коэффициент, регулирующий время выпуска блока, при использовании алгоритма консенсуса PoS;

  • pos-consensus.generation-signature – подпись, необходимая для валидации майнера блока;

  • poa-consensus.overall-skipped-rounds – количество пропущенных раундов майнинга, при использовании алгоритма консенсуса PoA;

  • version – версия блока;

  • timestamp – временная метка создания блока в формате Unix Timestamp (в миллисекундах);

  • height – высота создания блока.

Пример ответа:

GET /blocks/headers/seq/{from}/{to}

Метод возвращает заголовки блоков с высоты {from} до высоты {to}.

В ответе метода для каждого блока возвращаются параметры, идентичные методу GET /blocks/headers/at/{height}.

GET /blocks/headers/last

Метод возвращает заголовок текущего блока.

В ответе метода для каждого блока возвращаются параметры, идентичные методу GET /blocks/headers/at/{height}.