Быстрый старт

Быстрый старт¶

Важно знать!

Никогда не используйте dev-конфигурацию для запуска подсетей кооперативов ввиду того, что ключи доступа к ней являются публичными.

Программный код находится в моно-репозитории https://github.com/coopenomics/mono. Репозиторий включает в себя полный комплект программного обеспечения для подключения к платформе "Кооперативная Экономика" и управления взаимоотношениями с пайщиками в кооперативе и самим кооперативом на основе смарт-контрактов и простой электронной подписи.

Ветки¶

Для разработки используется ветка dev.
Для стейджа используется ветка testnet.
Для продакшена используется ветка main.

Установка¶

pnpm install

Также для работы потребуется установленная фабрика документов weasyprint для вашей операционной системы: https://doc.courtbouillon.org/weasyprint/stable/first_steps.html#installation

Конфигурация¶

Для конфигурации потребуетcя установленный docker и docker-compose. Выполните команду и следуйте инструкциям:

pnpm run setup

Запуск¶

Инфраструктура¶

Для работы системы необходимы базы mongo, postgres и redis.

Команда запуска баз данных в контейнерах для работы в фоновом режиме:

docker compose up -d

Блокчейн и контракты¶

pnpm boot

Команда запустит блокчейн и установит все смарт-контракты, подготовив систему к локальной разработке или применению.

Бэкенд¶

pnpm run dev:backend

Команда запустит набор сервисов бэкенда и точку доступа GraphQL-API на 2998 порту.

Фронтенд¶

Команда запустит рабочий стол кооператива на 3005 порту:

pnpm run dev:desktop

Очистка базы¶

Команда очистит базу mongodb и начнет производство блоков с начала:

pnpm run clear

Правильная последовательность команд при переустановке проекта "с нуля":

git pull
pnpm install
pnpm run setup
pnpm run clear
pnpm run boot
pnpm run dev:backend
pnpm run dev:desktop

Кошелёк¶

Для работы с кошельком блокчейна используется утилита cleos, которая позволяет извлекать таблицы смарт-контрактов и отправлять транзакции в блокчейн если это требуется.

Для работы с командным кошельком cleos локально необходимо чтобы инфраструктура была поднята:

docker compose up -d

Запускаем контейнер с кошельком и входим в него командой:

pnpm run cleos

В кошельке уже находится дефолтный ключ для работы с локальной средой. Этот ключ зашифрован паролем. Пароль хранится в файле password и используется автоматически при разблокировке. Для разблокировки кошелька, находясь в контейнере выполняем:

./unlock.sh

Для использования кошелька выполняем:

./cleos.sh <command>

Для получения полного списка команд вызываем кошелек без команд:

./cleos.sh

Например, для получения информации о текущем состоянии блокчейна:

./cleos.sh get info

Возможные проблемы¶

В случае, если при выполнении ./unlock.sh возникает проблема: Unable to connect to keosd, if keosd is running please kill the process and try again, то выполните команду:

./reset.sh

Данная команда удалит созданный ранее сокет кошелька, после чего, выполните ./unlock.sh повторно.