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

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

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

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

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}.