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