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

gRPC: получение информации о ноде

Для получения параметров конфигурации ноды и данных о её владельце предусмотрен gRPC сервис NodeInfoService.

У сервиса NodeInfoService есть следующие методы, описанные в protobuf-файле util_node_info_service.proto:

  • NodeConfig;

  • NodeOwner.

Важно

Типы данных полей для запросов и ответов указаны в protobuf-файле.

Примечание

Те же данные, что и с помощью gRPC методов NodeConfig и NodeOwner, можно получить с помощью REST методов группы node.

gRPC: получение параметров конфигурации ноды

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

  • version – используемая версия блокчейн-платформы;

  • crypto_type – используемый криптографический алгоритм;

  • chain_id – идентифицирующий байт сети;

  • consensus – используемый алгоритм консенсуса;

  • minimum_fee – минимальная комиссия за транзакции;

  • additional_fee – дополнительная комиссия за транзакции;

  • max_transactions_in_micro_block – максимальное установленное количество транзакций в микроблоке;

  • min_micro_block_age – минимальное время существования микроблока (в секундах);

  • micro_block_interval – интервал формирования микроблоков (в секундах);

  • pki_mode – при использовании ГОСТ криптографии с PKI выводится используемый режим PKI:

    • ON – PKI используется,

    • OFF – PKI не используется,

    • TEST – тестовый режим.

  • required_oids – при использовании алгоритмов ГОСТ криптографии с PKI выводится список OID-строк пользователей, которым УЦ выдал OID специально для работы с блокчейн платформой. Подробнее об этом параметре см. раздел Общая настройка платформы: настройка криптографии.

  • pos_round info– при использовании алгоритма консенсуса PoS, выводится значение параметра average_block_delay (время средней задержки создания блоков, в секундах), которое задано в конфигурационном файле ноды;

  • poa_round_info– при использовании алгоритма консенсуса PoA, выводятся параметры:

    • round_duration – длина раунда майнинга блока, в секундах и

    • sync_duration – период синхронизации майнинга блока, в секундах.

  • crlChecksEnabled – режим проверки списка отозванных сертификатов (CRL) при валидации сертификатов.

Примечание

Те же данные, что и с помощью gRPC метода NodeConfig, можно получить с помощью REST методов группы node.

gRPC: получение данных о владельце ноды

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

  • address – адрес ноды;

  • public_key – публичный ключ.

Примечание

Те же данные, что и с помощью gRPC метода NodeOwner, можно получить с помощью REST метода GET /node/owner.