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

REST API: Отладка блокчейна

Для отладки блокчейн-сети предусмотрены методы группы debug:

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

Важно

Все методы группы 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}.

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