Инструкция по использования бота для Localbitcoins

!Проверьте, что файл LocalbitcoinBot/app/config/__hidden__.py создан.

!Если файл не создан, то создайте его и добавьте туда содержимое

!Шаблона 1

1. Настройка ключей на localbitcoins.com

1.1. Сгенерировать 4 API ключа:

а) Зайти по ссылке https://localbitcoins.com/accounts/api/

б) Нажать на "+ New HMAC authentication"

в) Дать ключу название (Рекомендуемые названия: qiwi, qiwi_notifications, yandex, yandex_notifications).

Далее необходимо выбрать все пункты в разделе "Permissions". Все пункты можно выбрать, нажав на первый пункт, после чего с зажатой клавишой Shift нажать на последний пункт в списке.

После этого нужно ввести код для двухфакторной аутентификации.

г) Сохранить ключ

Пункты б-г необходимо совершить 4 раза.

1.2. Добавить ключи в конфигурации проекта

а) Зайти по ссылке https://localbitcoins.com/accounts/api/

б) Нажать на имя ключа

в) На появившейся странице скопировать "Key"

г) Зайти в файл LocalbitoinBot/app/config/__hidden__.py

д) Вставить скопированный ключ внутри двойных ковычек в

HMAC_KEY_<метод оплаты>_<тип>_HIDDEN, где <метод> - QIWI или YANDEX,

<тип> - может или отсутствовать или принимать значение NOTIFICATIONS.

е) Вернуться на сайт и скопировать "Secret"

ж) Вставить скопированный секрет внутри двойных ковычек в

HMAC_SECRET_KEY_<метод оплаты>_<тип>_HIDDEN, где <метод> - QIWI или YANDEX,

<тип> - может или отсутствовать или принимать значение NOTIFICATIONS.

Пункты б-ж повторить для всех ключей. Порядок выбора ключей не важен,

но все пары ключей в файле должны быть различны.

2. Настройка прокси

2.1. Купить прокси

а) Зайти на сайт proxy-seller.com

б) Заполнить поля для покупания прокси

  IPv4 or IPv6 - IPv4

  Choose the country - Proxy of US

  Rental period - Период работы прокси выбираете сами

  Enter quantity - Чем больше количество прокси, тем лучше работает бот. Рекомендуется брать не меньше 25 прокси

  Have a promo code? - можно найти промокод в интернете и получить скидку

в) Нажать "Buy a proxy"

г) В появившейся форме заполнить поля:

  Select a goal - Parsing

  Select a service - Another program/site

  Name your site or program - Localbitcoins

  Authorization method - By login and password

  E-mail - Вводите свой email

  Payment method - Выбираете метод оплаты

д) Нажать "Pay"

е) Производите оплату

2.2. Добавить прокси в конфигурации проекта

а) После оплаты зайдите на почту. Найдите ссылку на proxy-seller в пришедшем письме.

Перейдите по ссылке.

б) В правом верхнем углу экрана нажмите на свой email. В появившемся меню выбирите "Мои заказы".

В появившейся странице задите в "Панель управления".

в) В панели управления вы должны наблюдать логин, пароль, а так же список прокси.

г) Данные прокси вам нужно будет сохранить в файл LocalbitoinBot/app/config/__hidden__.py в поле PROXIES_HIDDEN в следующем формате:

PROXIES_HIDDEN = [

  'http://<Логин>:<Пароль>@<ip 1>:<port>',

  'http://<Логин>:<Пароль>@<ip 2>:<port>',

...

  'http://<Логин>:<Пароль>@<ip n>:<port>'

]

где <Логин> и <Пароль> можно взять из раздела "Способ авторизации" (картинка выше), <ip n> - айпи из таблицы, <port> берется из раздела "Способ авторизации" Port HTTP/HTTPS (из картинки 45785)

3. Настройка безопастного шифрования

3.1. Обновления секретного ключаhttps://telegra.ph/Baza-dannyh-dlya-bota-Localbitoins-09-05 шифрования для проекта

а) Зайти в файл LocalbitoinBot/app/config/__hidden__.py

б) Придумать ключ для безопасного шифрования.

в) Записать ключ в ковычки пункта "JWT_SECRET_KEY_HIDDEN".

4. Настройка QIWI.

4.1. Сгенерировать ключи для QIWI.

а) Зайти на p2p.qiwi.com.

б) Зайти в раздел API.

в) Нажмите на "Создать пару ключей"

г) Назовите как нибудь пару

д) Была сгерерирована пара ключей

Не выключайте вкладку, до обновление конфигурации!!!

4.2. Обновление конфигурации проекта

а) Зайдите в файл LocalbitoinBot/app/config/__hidden__.py

б) Откройте вкладку, где создавались ключи и скопируйте ключ из верхнего поля (публичный ключ)

в) Вставьте скопированный ключ в двойные ковычки поля

QIWI_PUBLIC_KEY_HIDDEN = ""

в файле конфигурации

г) Откройте вкладку, где создавались ключи и скопируйте ключ из нижнего поля (приватный ключ)

в) Вставьте скопированный ключ в двойные ковычки поля

QIWI_TOKEN_HIDDEN = ""

в файле конфигурации

5. Настройка Яндекс Денег

5.1. Регистрация приложения

а) Зайдите на https://money.yandex.ru/myservices/new

б) Придумайте имя и введите в поле Name for users.

в) Узнайте URL вашего сайта и вставьте его в поле Web address

г) Укажите ваш email.

д) Укажите адрес перенаправления:

<URL сайта>/api/login/yandex/token

где <URL сайта> - url вашего сайта.

е) Нажмите "Everything is correct".

г) Подвердите с помощью телефона.

5.2. Обновление конфигурации приложения

а) Зайдите в файл LocalbitoinBot/app/config/__hidden__.py

б) Вставьте "App ID" в двойные ковычки поля "YANDEX_CLIENT_ID_HIDDEN".

в) Вставьте адрес перенаправления, который вы указывали при регистрации в двойные ковычки поля "YANDEX_REDIRECT_URI_HIDDEN".

5.3. Авторизация приложения

а) Зайдите по адресу

<URL сайта>/api/login/yandex

где <URL сайта> - url вашего сайта.

б) Подтвердите авторизацию

6. Настройка сервера

6.1. Регистрация на DigitalOcean

а) Перейдите по ссылке https://cloud.digitalocean.com/registrations/new

б) Разегистрируйте аккаунт

6.2. Создайте Droplet

а) Нажмите на кнопку "Create" и выберите "Droplets"

б) Заполните всё следующим образом

Придумайте пароль и введите в поле "Create root password"

в) Нажмите на "Create Droplet"

6.3. Подготовка проекта к запуску

Данный этап выполняется одинажды. Примечание: данные этап следует выполнить повторно при перезагрузке сервера DigitalOcean.

а) Перенесите проект на сервер (рекомендуется программа FileZilla)

б) Зайдите в директорию проекта через консоль

cd LocalbitcoinBot

в) Установите необходимые зависимости

pip install -r requirements.txt

г) Создайте новый виртуальный экран

screen -S bot

д) Выйдите из виртуального окна

Ctrl+A+D

6.4. Запуск проекта

а) Зайдите в виртуальный экран

screen -r bot

б) Запустите бота

python3 app.py

в) Выйдите из виртуального окна

Ctrl+A+D

6.5. Перезапуск проекта

а) Зайдите в виртуальный экран

screen -r bot

б) Выключите бота

Ctrl + C

в) Включите бота заново

python app.py

в) Выйдите из виртуального окна

Ctrl+A+D

Шаблоны

Шаблон 1. Файл LocalbitoinBot/app/config/__hidden__.py:

HMAC_KEY_YANDEX_HIDDEN = ""

HMAC_SECRET_KEY_YANDEX_HIDDEN = ""

HMAC_KEY_QIWI_HIDDEN = ""

HMAC_SECRET_KEY_QIWI_HIDDEN = ""

HMAC_KEY_YANDEX_NOTIFICATIONS_HIDDEN = ""

HMAC_SECRET_KEY_YANDEX_NOTIFICATIONS_HIDDEN = ""

HMAC_KEY_QIWI_NOTIFICATIONS_HIDDEN = ""

HMAC_SECRET_KEY_QIWI_NOTIFICATIONS_HIDDEN = ""

PROXIES_HIDDEN = []

JWT_SECRET_KEY_HIDDEN = ""

MONGO_HOST_HIDDEN = ""

MONGO_USER_HIDDEN = ""

MONGO_PASSWORD_HIDDEN = ""

MONGO_DB_NAME_HIDDEN = ""

QIWI_TOKEN_HIDDEN = ""

QIWI_PUBLIC_KEY_HIDDEN = ""

YANDEX_CLIENT_ID_HIDDEN = ''

YANDEX_REDIRECT_URI_HIDDEN = ''