Установка и использование платформы
Обмен конфиденциальными данными¶
Блокчейн-платформа Waves Enterprise позволяет ограничить доступ к определенным данным, размещаемым в блокчейне. Для этого пользователи объединяются в группы, получающие доступ к конфиденциальным данным.
Важно
Если вы передаёте конфиденциальные данные в своей приватной блокчейн сети, то для перехода с версий более старых, чем 1.7.2, необходимо сначала перейти на версию 1.7.2, а затем – на версию 1.8 и выше. Это связано с изменением протокола передачи конфиденциальных данных.
Создание группы доступа¶
Создать группу доступа к конфиденциальным данным может любой участник сети. Прежде, чем создавать группу доступа, определитесь со списком участников, которые будут в нее входить. Затем подпишите и отправьте транзакцию 112 CreatePolicy:
В поле
recipients
впишите через запятую адреса участников, которые получат доступ к конфиденциальным данным.В поле
owners
добавьте через запятую адреса участников группы, которым будут предоставлены права администраторов. Администраторы группы доступа, помимо доступа к конфиденциальным данным, смогут изменять состав группы доступа.
При отправке транзакции вы получите идентификатор созданной группы доступа (policyId
). Он потребуется при изменении состава ее участников.
После отправки транзакции в блокчейн доступ к отправляемым в сеть конфиденциальным данным получат все участники, зарегистрированные в созданной группе доступа.
Как создатель транзакции, вы сможете изменять ее состав, как и участники, добавленные в поле owners
.
Изменение группы доступа¶
Изменять состав группы доступа могут только ее участники, добавленные в поле owners
при создании группы, а также сам ее создатель – владельцы группы доступа к конфиденциальным данным.
Для этого подпишите и отправьте транзакцию 113 UpdatePolicy:
В поле
policyId
введите идентификатор изменяемой группы доступа.В поле
opType
введите действие, которое необходимо произвести с группой:add
– добавить участников;remove
– удалить участников.Если вы хотите добавить или удалить участников группы доступа, впишите их публичные ключи в поле
recipients
.Для добавления или удаления владельцев группы доступа впишите их публичные ключи в поле
owners
.
Информация о группе доступа обновляется после отправки транзакции в блокчейн.
Отправка конфиденциальных данных в сеть¶
Для отправки конфиденциальных данных в сеть предусмотрены
gRPC методы
REST API методы
С помощью методов POST /privacy/sendData и POST /privacy/sendDataV2 вы можете отправить данные размером до 20 мегабайт, с помощью метода POST /privacy/sendLargeData – данные размером не менее 20 мегабайт.
Важно
Методы для отправки конфиденциальных данных в сеть недоступны при использовании PKI, то есть когда в конфигурационном файле ноды параметру node.crypto.pki.mode присвоено значение ON
. В тестовом режиме PKI (node.crypto.pki.mode = TEST
) или при отключенном PKI (node.crypto.pki.mode = OFF
) методы можно использовать.
Эти методы требуют авторизации.