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

REST API: работа с узлами блокчейна

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

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

POST /peers/connect

Метод предназначен для подключения новой ноды участника к вашей ноде.

Пример запроса:

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

GET /peers/connected

Метод возвращает список подключенных нод.

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

GET /peers/all

Метод возвращает список всех известных нод.

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

GET /peers/suspended

Метод возвращает список приостановленных нод.

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

POST /peers/identity

Метод возвращает публичный ключ ноды, к которому подключается ваша нода для передачи конфиденциальных данных.

В запросе передаются следующие параметры:

  • address - блокчейн-адрес, который соответствует параметру privacy.owner-address в конфигурационном файле ноды;

  • signature - электронная подпись от значения поля address.

Пример запроса:

Ответ метода содержит параметр publicKey- публичный ключ ноды, связанный с параметром privacy.owner-address в его конфигурационном файле. Если выключен режим проверки handshakes, то параметр publicKey не отображается.

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

GET /peers/hostname/{address}

Метод получает блокчейн адрес (owner-address) и, если среди пиров такой адрес есть, то возвращает соответствующее ему имя хоста (hostname) и IP-адрес ноды.

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

GET /peers/allowedNodes

Получение актуального списка разрешенных участников сети на момент запроса.