сервис для частных обменных шлюзов viz-exchange: установка и настройка

Здравствуйте. В предыдущем посте я писал о том, что такое viz-exchange, какой у него функционал, а также некоторую другую информацию. Здесь вы увидите, как установить, настроить продукт и добавить новый блокчейн.

Напоминаю ссылку на Github: https://github.com/denis-skripnik/viz-exchange

Установка:

1. В папке, где вы хотите видеть VIZ-exchange, выполняете:
   git clone https://github.com/denis-skripnik/VIZ-exchange.
2. Переходите в папку шлюза:
   cd VIZ-exchange.
3. Правите config файл (см. информацию ниже).
4. Запускаете: node exchange или pm2 start exchange.js.

Для работы в фоновом режиме (чтобы вы могли закрыть окно консоли) необходимо использовать pm2. Он устанавливается командой:
sudo npm install pm2 -g

Настройка, или работа с config.json:

Сейчас здесь можно увидеть 4 раздела в соответствии с названиями блокчейнов: VIZ, Golos, Steem, Whaleshares. В каждом из этих разделов в первой строке прописан параметр active. При установке значения true (без кавычек) блокчейн будет активен, при установке значения false – неактивен.
Далее прописано название токена (у VIZ это "token": "VIZ").
В следующей строке прописано название библиотеки (у VIZ это VIZ-js-lib).
Далее прописан адрес паблик-Ноды: параметр node.
В трёх следующих строках прописаны логин "login", постинг ключ "posting_key" (для обновления информации об аккаунте) и активный ключ "active_key" (для переводов). Все три параметра обязательно нужно указывать, заменив в значениях user на логин, 5j на постинг ключ, 5k на активный ключ.
Параметр how_to_VIZ указывает, сколько VIZ сможет получить пользователь при переводе 1 токена. Например, у VIZ это 1, а у Golos – 0,5. Данные значения указаны по умолчанию для примера, вы можете их изменить.
Параметр fee – это процент комиссии (по умолчанию 0). Указывается без знака процента.
Данные параметры прописываются таким же образом во всех секциях config.json (VIZ, Golos, Steem, Whaleshares).

Как добавить новый блокчейн:

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

1. Зайдите в файл js_modules/methods.js и ознакомьтесь со списком используемых методов. Изучите документацию к библиотеке нужного вам блокчейна и определите, есть ли там нужные методы. Убедитесь, что запрашиваемые данные и их формат совпадают с указанными в файле.
2. Зайдите в config.json и создайте новую секцию настроек. Можно просто скопировать секцию из блокчейнов, например, Golos, начиная с самого параметра и заканчивая "},". Проверьте, чтоб ваша ide не выдавала ошибки.
3. Переименуйте Golos в ваш блокчейн, если вы использовали копирование. Далее измените значение параметра lib на другое.
4. Аналогичным образом пропишите другую паблик-Ноду в параметре node.
5. Запишите данные: логин, ключи.
6. Задайте курс токена к VIZ и комиссию (если нужна).
7. Добавьте блокчейн в файле blocksdb.js так, как добавлены уже существующие.
8. Проверьте, запустив node exchange 2> errors.log.
9. Буду рад пулл-реквестам.

Напоследок расскажу об используемых технологиях:

1. node.js.
2. Файловая база данных nedb.
3. VIZ-js-lib, Golos-js, Steem, wlsjs – библиотеки блокчейнов.
4. Код состоит из модулей.

Всё.

В следующем посте будет описана структура папок и файлов. Перейти