Установка и использование платформы
REST API: информация о блоках сети¶
Для получения информации о различных блоках сети предусмотрена группа методов 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}.