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

Тонкая настройка платформы: настройка анкоринга

Важно

Анкоринг поддерживается только в тестовом режиме функционирования блокчейн-платформы Конфидент, то есть, когда в конфигурационном файле ноды параметру node.crypto.pki.mode присвоено значение TEST. Подробнее об этом параметре см. раздел Общая настройка платформы: настройка режима работы.

Если вы планируете использовать анкоринг данных из вашей сети в более крупную сеть, настройте параметры передачи данных в блоке anchoring конфигурационного файла ноды. В терминологии конфигурационного файла, targetnet – это блокчейн, в который ваша нода будет выполнять транзакции анкоринга из текущей сети.

 anchoring {
   enable = yes
   height-range = 30
   height-above = 8
   threshold = 20
   tx-mining-check-delay = 5 seconds
   tx-mining-check-count = 20

   targetnet-authorization {
     type = "oauth2" # "api-key" or "oauth2"
     authorization-token = ""
     authorization-service-url = "https://client.wavesenterprise.com/authServiceAddress/v1/auth/token"
     token-update-interval = "60s"
     # api-key-hash = ""
     # privacy-api-key-hash = ""
   }

   targetnet-scheme-byte = "V"
   targetnet-node-address = "https://client.wavesenterprise.com:6862/NodeAddress"
   targetnet-node-recipient-address = ""
   targetnet-private-key-password = ""

   wallet {
     file = "node-1_targetnet-wallet.dat"
     password = "small"
   }

   targetnet-fee = 10000000
   sidechain-fee = 5000000
}

Параметры анкоринга

  • enable – включение или отключение анкоринга (yes / no);

  • height-range – интервал блоков, по прошествии которого нода приватного блокчейна отправляет в Targetnet транзакции для анкоринга;

  • height-above – число блоков в Targetnet, по прошествии которого нода приватного блокчейна создаёт подтверждающую анкоринг транзакцию с данными первой транзакции. Рекомендуется устанавливать значение, не превышающее максимальную величину отката блоков в Targetnet (max-rollback);

  • threshold – число блоков, которое отнимается от текущей высоты приватного блокчейна. В транзакцию для анкоринга, отправляемую в Targetnet, попадёт информация из блока на высоте current-heightthreshold. Если устанавливается значение 0, в транзакцию анкоринга записывается значение блока на текущей высоте блокчейна. Рекомендуется устанавливать значение, близкое к максимальной величине отката в приватном блокчейне (max-rollback);

  • tx-mining-check-delay – время ожидания между проверками доступности транзакции для анкоринга в Targetnet;

  • tx-mining-check-count – максимальное количество проверок доступности транзакции для анкоринга в Targetnet, по выполнении которых транзакция считается не поступившей в сеть.

В зависимости от настроек майнинга в сети Targetnet, расстояние между транзакциями анкоринга может меняться. Установленное значение height-range задаёт приблизительный интервал между транзакциями анкоринга. Реальное время попадания транзакций анкоринга в смайненный блок сети Targetnet может превышать время, потраченное на майнинг количества блоков height-range в сети Targetnet.

Параметры авторизации при использовании анкоринга

  • type – тип авторизации при использовании анкоринга; доступно одно значение:

    • api-key – авторизация по api-key-hash.

В случае выбора авторизации по api-key-hash, достаточно указать значение ключа в параметре api-key.

Параметры для доступа Targetnet

Для ноды, которая будет отправлять транзакции анкоринга в Targetnet, генерируется отдельный файл keystore.dat с ключевой парой для доступа в Targetnet.

  • targetnet-scheme-byte – байт сети Targetnet;

  • targetnet-node-address – полный сетевой адрес ноды вместе с номером порта в сети Targetnet, на который будут отправляться транзакции для анкоринга. Адрес необходимо указывать вместе с типом соединения (http/https), номером порта и параметром NodeAddress, например: http://node.web3techservices.com:6862/NodeAddress;

  • targetnet-node-recipient-address – адрес ноды в сети Targetnet, на который будут записываться транзакции для анкоринга, подписанные ключевой парой данного адреса;

  • targetnet-private-key-password – пароль от приватного (закрытого) ключа ноды для подписи транзакций анкоринга.

Сетевой адрес и порт для анкоринга в сеть Targetnet вы можете получить у сотрудников технической поддержки блокчейн-платформы Конфидент. Если вы используете несколько приватных блокчейнов с взаимным анкорингом, используйте соответствующие сетевые настройки частных сетей.

Параметры файла с ключевой парой для подписания транзакций анкоринга в Targetnet (секция wallet)

  • file – имя файла и путь до каталога хранения файла с ключевой парой для подписания транзакций анкоринга в сети Targetnet. Файл находится на ноде приватной сети;

  • password – пароль от файла с ключевой парой.

Параметры комиссий

  • targetnet-fee – комиссия за выпуск транзакции для анкоринга в сети Targetnet;

  • sidechain-fee – комиссия за выпуск транзакции в текущем приватном блокчейне.