Установка и использование платформы
Развертывание платформы в ознакомительном режиме (Sandbox)¶
Для ознакомления с блокчейн-платформой Waves Enterprise вам доступна бесплатная версия, запускающаяся в Docker-контейнере. Для ее установки и использования не требуется лицензия, высота блокчейна ограничена 30000 блоков. При времени раунда блока, равном 30 секундам, время полноценной работы платформы в ознакомительном режиме составляет 10 дней.
При развертывании в ознакомительном режиме вы получите локальную версию блокчейн-платформы, которая позволяет протестировать основные функции:
отправка транзакций;
прием данных из блокчейна;
установка и вызов смарт-контрактов;
передача конфиденциальных данных между нодами;
тестирование мониторинга ноды при помощи InfluxDB и Grafana.
Взаимодействие с платформой может осуществляться как через клиентское приложение, так и через интерфейсы gRPC и REST API.
Установка платформы¶
Перед началом установки убедитесь, что на вашей машине установлены Docker Engine и Docker Compose. Также ознакомьтесь с системными требованиями к блокчейн-платформе.
Обратите внимание, что для выполнения команд на ОС Linux могут потребоваться права администратора (префикс sudo
с последующим вводом пароля администратора).
Создайте рабочую директорию и поместите в нее файл docker-compose.yml. Этот файл вы можете скачать из официального репозитория Waves Enterprise в GitHub, выбрав самый свежий релиз платформы, либо в терминале при помощи утилиты wget:
wget https://raw.githubusercontent.com/waves-enterprise/we-node/release-1.12/node/src/docker/docker-compose.yml
Откройте терминал и перейдите в директорию, содержащую скачанный файл docker-compose.yml. Запустите Docker-контейнер для развертывания платформы:
docker run --rm -ti -v $(pwd):/config-manager/output wavesenterprise/config-manager:v1.12.1
Дождитесь сообщения об окончании развертывания:
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
Запустите готовую конфигурацию:
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.
Для остановки запущенных нод выполните команду:
docker-compose down