Skip to content

Welcome to the SnipeGenius wiki!

Jump to bottom
Fahd El Haraka edited this page Oct 25, 2023 · 2 revisions

SnipeGenius

A sniping bot designed to monitor newly created trading pair events and execute secure transactions.

Overview

SnipeGenius is a sniping bot designed to monitor newly created trading pair events. Upon detection, it conducts a series of safety inspections to identify potential risks like honeypots, rug pulls, or transaction taxes. Following these checks, SnipeGenius runs buy/sell simulations to assess risks further before executing a purchase.

Note: Currently, the only supported DEX is PancakeSwap, with plans to include more in the future. Safety checks within the system are continually being enhanced to ensure secure transactions.

Core Components

config.py: Sets up logging, displays startup banner, and initializes connections to Binance Smart Chain.

coinOps.py: Retrieves specified token and WBNB balances for a given address.

wallet.py: Handles encryption, storage, and retrieval of wallet and Google credentials.

snipegenius.py: Conducts safety checks on tokens by verifying ownership, checking against a blacklist, analyzing token parameters, performing simulated transactions, and searching for associated risks online.

transactions: Manages and executes buy transactions on new token pairs.

snipe.py: Initiates SnipeGenius.

ABIs (wbnb, router, factory, pair): These ABIs enable SnipeGenius to interact with PancakeSwap's Factory, Router, WBNB, and Pair contracts.

blacklist.txt: Tokens owned by blacklisted addresses are skipped during transactions.

trade_history.log: SnipeGenius' trade log, recording trade-related data, events and errors for debugging.

Setup & Usage

  1. Requirements: Make sure Python 3.x is installed on your machine.
  2. Installation: 
    git clone https://github.com/ELHARAKA/SnipeGenius.git
cd SnipeGenius
pip3 install requirements.txt
  3. Parameters:
    • --p: Essential to designate the percentage of the amount for trade; for instance, 1 denotes 1%.
    • --v: Optional. Use 2 to show all logs. Verbosity level 2 is recommended only for debugging purposes.

Note: If you encounter any errors related to the pwinput package, execute the following command to resolve the issue: sudo python3 -m pip install pwinput

Run and Setup

  1. Run sudo python3 snipe.py.
  2. Input wallet address, private key, and encryption password. Details saved encrypted in wallet.txt locally.
  3. Input Google API key.

Note: To obtain your Google API Key, follow these instructions.

Contribution

  • Bug Reporting: If you encounter any bugs or issues, please create an issue on GitHub detailing the problem, and if possible, steps to reproduce it.
  • Feature Suggestions: Have a feature in mind? Open an issue to suggest new features or enhancements.
  • Code: Feel free to fork SnipeGenius and submit your pull requests. We appreciate your effort to help improve the codebase.
  • Documentation: Help us improve the documentation to make SnipeGenius more accessible to the community. Whether it's typo corrections or whole tutorials, your contributions are crucial.
  • Testing: Assist us in improving the stability and reliability of SnipeGenius by testing it in different environments and reporting any problems.

License

SnipeGenius is proprietary software. The use, distribution, and modification of this software is governed by the license agreement provided in the LICENSE file in this repository.

Clone this wiki locally