Ranger Finance

Ranger Finance — это DeFi-протокол, построенный на Solana, который агрегирует ликвидность с нескольких DEX-площадок с помощью Smart Order Router, минимизируя проскальзывание и обеспечивая наилучшее исполнение сделок. Платформа выступает как единый торговый хаб, поддерживающий спотовую и перпетуальную торговлю, с системой вознаграждений Ranger Points и предстоящим запуском токена $RNGR.

Требования (Подробнее здесь)

• Установите Python версия 3.12

• Установите git , чтобы не скачивать все время архив при обновлениях

• Установите SQlite для просмотра статистики

Что делает скрипт

• Вывод SOL из okx

• Свап SOL на стейблы

• Свап USDC/USDT

• Вывод дополнительной SOL на кошельки

• Свап всей SOL на UDST/USDC

• Обновление статистики кошельков с лидерборда app.ranger.finance

Установка

• Клонируем репозиторий

git clone https://github.com/Phoenix0x-web3/ranger_finance.git

• Переходим в папку проекта

cd ranger_finance

• Устанавливаем зависимости

python install.py

• Актвируем виртуальное окружение

Для Windows

venv\Scripts\activate

Для Linux/Mac

source venv/bin/activate

• Запускаем скрипт

python main.py

Настройка

После запуска команды python install.py у вас появится папка files. В данной папке будут файлы, которые вы должны заполнить построчно:

• private_keys.txt: Private keys Solana

• proxy.txt: One proxy per line (format: http://user:pass@ip:port)

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

# Шифровать private keys
private_key_encryption: true

# Количество потоков
threads: 1

# Количество попыток 
retry: 5

#По умолчанию: [0,0] - все кошельки
#Пример: [2, 6] будут выполнять таски только 2,3,4,5,6 кошельки
#[4,4] выполняет таски только 4 кошелек
range_wallets_to_run: [0, 0]

# Перемешивать кошельки перед запуском
shuffle_wallets: true

# ПО УМОЛЧАНИЮ: [] — все кошельки
# Пример: [1, 3, 8] — будут запускаться только кошельки с номерами 1, 3 и 8
exact_wallets_to_run: []

# Показывать адрес кошелька в логах
show_wallet_address_logs: false

# Проверять github обновления
check_git_updates: true

# Логирование для приложения. Возможные варианты: DEBUG, INFO, WARNING, ERROR
log_level : INFO

# Задержка перед запуском нового цикла кошельков после завершения всех действий 
# (по умолчанию ~12-24 часа).
random_pause_wallet_after_completion:
 min: 43200
 max: 86400

# Случайная пауза между действиями в секундах
random_pause_between_actions:
  min: 30
  max: 120

# Случайная пауза между запуском кошельков в секундах
random_pause_between_wallets:
  min: 60
  max: 180

# Случайная пауза перед запуском кошельков в секундах
random_pause_start_wallet:
  min: 0
  max: 60

# OKX api keys
okx_api_key: ''
okx_api_secret: ''
okx_passphrase: ''

# Количество SOL на вывод с биржи okx
withdrawal_amount:
  min: 0.8
  max: 1

# Какое количество SOL оставлять на комиссии после вывода с биржи okx
sol_balance_for_commissions:
  min: 0.05
  max: 0.08

# Минимальное количество SOL на кошельке, перед тем как пополнить со стейблов,
# чтоб хватало на комиссии. Смотри refill_usd_amount
minimal_sol_balance: 0.005

# Пополнить SOL для комиссий в сети (в usd)
refill_usd_amount:
  min: 8
  max: 10

# Количество свапов за круг на SPOT
swaps_count:
  min: 5
  max: 10

# Referral codes. Пример [e78f718561cf35o1a34f942c955b337c, ea8f767170ff45f1a1f942c955b397b]
invite_codes: []

Запуск

Для вашей безопасности вы можете включить шифрование приватных ключей, установив private_key_encryption: true в настройках. Если указано false, шифрование будет пропущено. При первом использовании необходимо один раз заполнить файл private_keys.txt. После запуска программы перейдите в DB Actions → Import wallets to Database

Если шифрование включено, вам будет предложено ввести и подтвердить пароль. После этого ваши приватные ключи будут удалены из файла private_keys.txt и безопасно перемещены в локальную базу данных wallets.db (отрываем с помощью SQlite), которая создается в папке files.

Если вы обновили или добавили новые прокси/твитеры/дискорды/почты, то нужно сделать синхронизацию с БД, чтоб кошельки соответствовали новым данным.

Для этого нужно выбрать опцию Sync wallets with tokens and proxies

После создания базы данных вы можете запустить проект, выбрав Ranger Finance → Start SPOT Activity (swaps).

1. Start SPOT Activity (swaps) — Если при первом запуске на кошельке нет активов, скрипт выведет SOL с OKX и обменяет SOL на стейблкоины, оставив небольшое количество SOL (sol_balance_for_commissions) для оплаты комиссий. Затем выполнит свапы между USDT и USDC. Если на кошельке уже есть стейблкоины и SOL, скрипт выполнит свапы, используя только имеющиеся стейблкоины.

2. Withdraw additional SOL to wallets — Скрипт выводит SOL с OKX на ваш кошелёк.

3. Swap all SOL to USDT/USDC — Скрипт обменивает весь доступный SOL в кошельке на стейблкоины, оставляя лишь сумму, необходимую для комиссий (sol_balance_for_commissions).

4. Update wallet statistics from app.ranger.finance — Скрипт получает и обновляет статистику кошелька с лидерборда Ranger Finance в вашей базе данных.