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

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

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

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

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

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

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

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

  • тестирование мониторинга ноды при помощи InfluxDB и Grafana.

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

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

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

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

  1. Создайте рабочую директорию и поместите в нее файл docker-compose.yml. Этот файл вы можете скачать из официального репозитория Waves Enterprise в GitHub, выбрав самый свежий релиз платформы, либо в терминале при помощи утилиты wget:

wget https://github.com/waves-enterprise/WE-releases/releases/download/v1.6.0/docker-compose.yml
  1. Откройте терминал и перейдите в директорию, содержащую скачанный файл docker-compose.yml. Запустите Docker-контейнер для развертывания платформы:

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

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

INFO [launcher] WE network environment is ready!

В результате будут созданы 3 ноды с автоматически сгенерированными учетными данными. Информация о нодах доступна в файле ./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

После успешного запуска контейнеров клиент платформы будет доступен в браузере локально по адресу 127.0.0.1 или localhost. Интерфейс REST API ноды располагается по адресу 127.0.0.1/node-0 или localhost/node-0.

Обратите внимание, что по умолчанию для локального 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