Ranger Finance

Ranger Finance is a DeFi protocol built on Solana that aggregates liquidity across multiple DEXs using a Smart Order Router, minimizing slippage and ensuring the best trade execution. It serves as a unified trading hub supporting both spot and perpetual trading, with a Ranger Points reward system and an upcoming $RNGR token launch.

Requirements

• Install Python version 3.12

• Use git for updates — no need to manually download the archive each time.

• Install SQlite (to view statistics)

• Proxy (optional)

Functionality

• Withdraw SOL from okx

• Swap SOL with stables

• Swap USDC/USDT

• Withdraw additional SOL to wallets

• Swap all SOL to UDST/USDC

• Update wallet statistics from app.ranger.finance

Installation

1. Clone the repository:

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

1. Install dependencies:

python install.py

1. Activate virtual environment

For Windows

venv\Scripts\activate

For Linux/Mac

source venv/bin/activate

1. Run script

python main.py

Configuration

After running the script, a folder named files will be created. Inside this folder, you will find text files that must be filled line by line (one value per line).

• private_keys.txt: Private keys Solana

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

Main configurations

# Whether to encrypt private keys
private_key_encryption: true

# Number of threads to use for processing wallets
threads: 1

# BY DEFAULT: [0,0] - all wallets
# Example: [2, 6] will run wallets 2,3,4,5,6
# [4,4] will run only wallet 4
range_wallets_to_run: [0,0]

# Whether to shuffle the list of wallets before processing
shuffle_wallets: true

# Working only if range_wallet_to_run = [0,0] 
# BY DEFAULT: [] - all wallets 
# Example: [1, 3, 8] - will run only 1, 3 and 8 wallets
exact_wallets_to_run: []

# Show wallet address in logs
show_wallet_address_logs: false

#Check for github updates
check_git_updates: true

# The log level for the application. Options: DEBUG, INFO, WARNING, ERROR
log_level : INFO

# Delay before running the new cicle of wallets after it has completed all actions (12 - 24 hrs default)
random_pause_wallet_after_completion:
  min: 43200
  max: 86400

# Random pause between wallets in seconds
random_pause_between_wallets:
  min: 60
  max: 180

# Random pause between actions in seconds
random_pause_between_actions:
  min: 60
  max: 180

# Random pause to start wallet in seconds
random_pause_start_wallet:
  min: 0
  max: 60

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

# Withdrawal amount in SOL from okx
withdrawal_amount:
  min: 0.8
  max: 1

# Keeping SOL amount in the wallet for transaction fees after witdrawal from okx
sol_balance_for_commissions:
  min: 0.05
  max: 0.08

# Minimum SOL to keep in the wallet and when to refill it by swapping from stables for network fees. See refill_usd_amount
minimal_sol_balance: 0.005

# Refill SOL for transaction fees in usd
refill_usd_amount:
  min: 8
  max: 10

# Swaps count per cycle on SPOT
swaps_count:
  min: 5
  max: 10

# Referral codes. Example [e78f718561cf35o1a34f942c955b337c, ea8f767170ff45f1a1f942c955b397b]
invite_codes: []

Usage

For your security, you can enable private key encryption by setting private_key_encryption: true in the settings.yaml. If set to false, encryption will be skipped.

On first use, you need to fill in the private_keys.txt file once. After launching the program, go to DB Actions → Import wallets to Database.

If encryption is enabled, you will be prompted to enter and confirm a password. Once completed, your private keys will be deleted from the private_keys.txt file and securely moved to a local database, which is created in the files folder.

If you want to update proxy/twitter/discord/email you need to make synchronize with DB. After you made changes in these files, please choose this option.

Once the database is created, you can start the project by selecting Ranger Finance → Start SPOT Activity (swaps).

1. Start SPOT Activity (swaps)- If your wallet has no assets on first run, the script will withdraw SOL from OKX and swap SOL to stablecoins, leaving a small amount of SOL (sol_balance_for_commissions) reserved for transaction fees. Then it will perform swaps between USDT and USDC. If your wallet already has stablecoins and SOL, the script will only perform swaps using the existing stablecoins.

2. Withdraw additional SOL to wallets - The script withdraws SOL from OKX to your wallet.

3. Swap all SOL to UDST/USDC - The script swaps all available SOL in your wallet to stablecoins, leaving only the amount needed for fees (sol_balance_for_commissions).

4. Update wallet statistics from app.ranger.finance - The script retrieves and updates your wallet statistics from the Ranger Finance leaderboard in your database.