Установка и использование платформы
Тонкая настройка платформы: настройка инструментов gRPC и REST API ноды¶
Параметры работы gRPC и REST API для каждой ноды находятся в секции api
конфигурационного файла:
api {
rest {
# Enable/disable REST API
enable = yes
# Network address to bind to
bind-address = "0.0.0.0"
# Port to listen to REST API requests
port = 6862
# Enable/disable TLS for REST
tls = yes
# Enable/disable CORS support
cors = yes
# Max number of transactions
# returned by /transactions/address/{address}/limit/{limit}
transactions-by-address-limit = 10000
distribution-address-limit = 1000
}
grpc {
# Enable/disable gRPC API
enable = yes
# Network address to bind to
bind-address = "0.0.0.0"
# Port to listen to gRPC API requests
port = 6865
# Enable/disable TLS for GRPC
tls = yes
# Parameters for internal gRPC services. Recommended to be left as is.
services {
blockchain-events {
max-connections = 5
history-events-buffer {
enable: false
size-in-bytes: 50MB
}
}
privacy-events {
max-connections = 5
history-events-buffer {
enable: false
size-in-bytes: 50MB
}
}
contract-status-events {
max-connections = 5
}
}
}
Блок rest { }
¶
Блок rest { }
предназначен для настройки интерфейса REST API ноды. Он включает следующие параметры:
enable
– активация опции REST API на ноде. Включение опции –yes
, отключение –no
.bind-address
– сетевой адрес ноды, на котором будет доступен REST API интерфейс.port
– порт прослушивания REST API запросов.tls
– флаг включениея или отключения TLS для REST API запросов. Для включения TLS задайте значениеyes
, для отключения –no
. Для включения требуется настройка TLS ноды.
Важно
Параметр по умолчанию имеет значение yes
, то есть REST API запросы осуществляются по каналу связи по протоколу TLS. Использование значения no
допускается только в тестовых целях.
cors
– поддержка кросс-доменных запросов к REST API. Для включения опции задайте значениеyes
, для отключения –no
.transactions-by-address-limit
– максимальное количество транзакций, возвращаемых методом GET /transactions/address/{address}/limit/{limit}.distribution-address-limit
– максимальное количество адресов, указываемых в полеlimit
и возвращаемых методом GET /assets/{assetId}/distribution/{height}/limit/{limit}.
Блок grpc { }
¶
Блок grpc { }
предназначен для настройки gRPC-инструментария ноды. Он включает следующие параметры:
enable
– активация gRPC-интерфейса на ноде.bind-address
– сетевой адрес ноды, на котором будет доступен gRPC-интерфейс.port
– порт прослушивания gRPC запросов.tls
– флаг включениея или отключения TLS для gRPC запросов. Для включения TLS задайте значениеyes
, для отключения –no
. Для включения требуется настройка TLS ноды.Важно
Параметр по умолчанию имеет значение
yes
, то есть gRPC API запросы осуществляются по каналу связи по протоколу TLS. Использование значенияno
допускается только в тестовых целях.
Секция services{ }
содержит настройки публичных gRPC-сервисов, собирающих данные из компонентов платформы:
blockchain-events
– сервис сбора данных о событиях блокчейн-сети;privacy-events
– сервис сбора данных о событиях, связанных с группами доступа к конфиденциальным данным;contract-status-events
– сервис сбора данных о состоянии смарт-контрактов.
В этой секции рекомендуется использовать предустановленные параметры.