Установка и использование платформы
REST API: отладка блокчейна¶
Для отладки блокчейн-сети предусмотрены методы группы debug
:
Важно
Все методы группы debug
недоступны при использовании PKI, то есть когда в конфигурационном файле ноды параметру node.crypto.pki.mode присвоено значение ON
. В тестовом режиме PKI (node.crypto.pki.mode = TEST
) или при отключенном PKI (node.crypto.pki.mode = OFF
) методы можно использовать.
GET /debug/blocks/{howMany}¶
Метод отображает размер и полный хэш последних блоков. Количество блоков указывается при запросе.
Пример ответа:
GET /debug/info¶
Метод отображает общую информацию о блокчейне, необходимую для отладки и тестирования.
Пример ответа:
POST /debug/rollback¶
Метод откатывает блокчейн до заданной высоты, удаляя все блоки после нее. В запросе передаются следующие параметры:
rollbackTo
– высота, до которой необходимо откатить блокчейн;returnTransactionsToUtx
– возвращение транзакций, которые содержатся в откатываемых блоках, в UTX-пул:true
– вернуть,false
– удалить.
Примеры запроса и ответа:
POST /debug/validate¶
Метод валидирует транзакции по их идентификатору и измеряет затраченное время в миллисекундах.
В запросе передается id
транзакции.
Пример ответа:
GET /debug/minerInfo¶
Метод отображает информацию о майнере.
Пример ответа:
GET /debug/historyInfo¶
Метод отображает историю последнего блока.
Пример ответа:
GET /debug/configInfo¶
Метод полностью выводит используемый конфигурационный файл ноды.
Пример ответа:
DELETE /debug/rollback-to/{signature}¶
Метод откатывает блокчейн до блока с указанной подписью {signature}
.
Пример ответа:
GET /debug/portfolios/{address}¶
Метод отображает текущий баланс по транзакциям, находящимся в UTX-пуле ноды {address}
.
Пример ответа:
POST /debug/print¶
Метод выводит текущие сообщения логгера, имеющего уровень логирования DEBUG.
Ответ выводится в формате "message" : "string"
GET /debug/state¶
Метод отображает текущий стейт ноды.
Пример ответа:
GET /debug/stateWE/{height}¶
Метод отображает стейт ноды на указанной высоте {height}
.
Пример ответа: