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

Развертывание платформы в ознакомительном режиме (Sandbox)

Для ознакомления с блокчейн-платформой Конфидент вам доступна бесплатная версия, запускающаяся в Docker-контейнере. Для ее установки и использования не требуется лицензия, высота блокчейна ограничена 30000 блоков. При времени раунда блока, равном 30 секундам, время полноценной работы платформы в ознакомительном режиме составляет 10 дней.

При развертывании в ознакомительном режиме вы получите локальную версию блокчейн-платформы, которая позволяет протестировать основные функции:

  • отправка транзакций;

  • прием данных из блокчейна;

  • установка и вызов смарт-контрактов;

  • передача конфиденциальных данных между нодами.

Взаимодействие с платформой осуществляется через интерфейсы gRPC и REST API.

Установка платформы

Перед началом установки убедитесь, что на вашей машине установлены Docker Engine и Docker Compose. Также ознакомьтесь с системными требованиями к блокчейн-платформе.

Обратите внимание, что для выполнения команд на ОС Linux могут потребоваться права администратора (префикс sudo с последующим вводом пароля администратора).

  1. Создайте рабочую директорию и поместите в нее файл docker-compose.yml. Листинг файла представлен в разделе

  1. Откройте терминал и перейдите в директорию, содержащую файл docker-compose.yml.

    Запустите Docker-контейнер для развертывания блокчейн-платформы:

docker run --rm -ti -v $(pwd):/config-manager/output web3techru/config-manager:v1.9.0

Дождитесь сообщения об окончании развертывания:

INFO [launcher] WE network environment is ready!

В результате будут созданы 3 ноды с автоматически сгенерированными учетными данными.

Информация о нодах доступна в файле ./credentials.txt. Ниже приведён пример файла ./credentials.txt:

node-0
blockchain address: 3Nzi7jJYn1ek6mMvtKbPhehxMQarAz9YQvF
public key:         7cLSA5AnvZgiL8CnoffwxXPkpQhvviJC9eywBKSUsi58
keystore password:  OEtrVSL9gzjO87jYx-gIoQ
keypair password:   JInWk1kauuZDHGXFJ-rNXQ
API key:            we

node-1
blockchain address: 3Nxz6BYyk6CYrqH4Zudu5UYoHU6w7NXbZMs
public key:         VBkFFQmaHzv3YMiWLhh4qsCn4prUvteWsjgiiHEpWEp
keystore password:  FsUp3xiX_NF-bQ9gw6t0sA
keypair password:   Qf2rBgBT9pnozLPOkO1yYw
API key:            we

node-2
blockchain address: 3NtT9onn8VH1DsbioPVBuhU4pnuCtBtbsTr
public key:         8YkDPLsek5VF5bNY9g2dxAthd9AMmmRyvMPTv1H9iEpZ
keystore password:  T77fAroHavbWCS6Uir2oFg
keypair password:   bELB4EU1GDd5rS-RId_6pA
API key:            we

  1. Запустите готовую конфигурацию:

docker-compose up -d

При успешном запуске нод и сервисов отобразится сообщение:

Creating network "platf_we-network" with driver "bridge"
Creating node-2       ... done
Creating postgres     ... done
Creating node-0       ... done
Creating node-1       ... done
Creating auth-service ... done
Creating crawler      ... done
Creating data-service ... done
Creating frontend     ... done
Creating nginx-proxy  ... done

После этого интерфейс REST API нод будет доступен по следующим адресам в браузере:

  • Node-0 – 127.0.0.1:6862 или localhost:6862

  • Node-1 – 127.0.0.1:6872 или localhost:6872

  • Node-2 – 127.0.0.1:6882 или localhost:6882

Вы можете изменить порты в файле docker-compose.yml. Также можно добавить в docker-compose.yml секцию nginx-proxy, как описано ниже, и переопределить в ней порты.

Внимание

По умолчанию для локального nginx-сервера блокчейн-платформы предоставляется порт 80:80. Если на вашей ОС этот порт занят другим приложением, измените параметр ports секции nginx-proxy в файле docker-compose.yml, выбрав доступный порт, например:

nginx-proxy:
  image: nginx:latest
  hostname: nginx-proxy
  container_name: nginx-proxy
  ports:
    - "81:80"

После этого REST API ноды будет доступен по адресу 127.0.0.1:81 или localhost:81.

  1. Для остановки запущенных нод выполните команду:

docker-compose down

Последующие действия

Смотрите также

Транзакции блокчейн-платформы

Смарт-контракты

Обмен конфиденциальными данными

Инструментарий gRPC

Методы REST API