Skip to content

sea-sol/BSC-bundler-four.meme

Repository files navigation

🔷 Prism Trade Engine

Automated Trading Suite for BNB Smart Chain

License: MIT Node Version TypeScript

Professional-grade automation toolkit featuring token hunting, copy trading, path execution, and volume generation

FeaturesInstallationUsageConfigurationSupport


📋 Table of Contents


🌟 Overview

Prism Trade Engine is a comprehensive trading automation suite built specifically for BNB Smart Chain. It provides powerful tools for traders looking to automate their strategies with precision and security.

🔗 Developer Contact: Telegram

Why Prism?

Zero Dependencies on External APIs - Pure on-chain integration
CLI-First Design - Complete control via command line
Enterprise Security - Built-in safety controls and dry-run mode
Telegram Integration - Real-time notifications for critical events


🎯 Features

🎯 Token Hunter

Lightning-fast token acquisition

  • Auto-detect new token launches
  • Configurable slippage tolerance
  • Deadline management
  • Transaction logging

🔄 Copy Trader

Mirror successful traders

  • Real-time mempool monitoring
  • Proportional position sizing
  • Multi-wallet tracking
  • Exposure caps

🛤️ Path Executor

Batch operation management

  • Sequential path execution
  • Multicall support
  • Precise timing controls
  • Custom slippage per step

📊 Volume Generator

Automated market making

  • Periodic buy/sell cycles
  • Rate limiting controls
  • Auto-approval handling
  • Configurable intervals

🏗️ Architecture

System Flow Diagrams

🎯 Token Hunter Workflow

Load Config → Calculate Output → Apply Slippage → Execute Swap → Log & Notify

🔄 Copy Trader Workflow

Monitor Mempool → Filter Wallets → Detect Router → Copy Trade → Alert

🛤️ Path Executor Workflow

Parse Sequence → Execute Steps → Apply Rules → Complete & Report

📊 Volume Generator Workflow

Interval Tick → Buy Token → Approve → Sell Full Balance → Repeat

🚀 Quick Start

Prerequisites

Requirement Version
Node.js ≥ 18.17
npm Latest
BNB Chain RPC Active endpoint
Wallet Funded with BNB

Installation Steps

# 1. Clone or download the project
cd prism-trade-engine

# 2. Install dependencies
npm install

# 3. Configure environment
cp env.template .env
# Edit .env with your settings

# 4. Build the project
npm run build

⚙️ Configuration

Environment Setup

Create a .env file from the template:

# Required Settings
RPC_ENDPOINT=https://bsc-dataseed1.binance.org/
PRIVATE_KEY=your_private_key_here

# Chain Configuration (Pre-configured for BSC)
CHAIN_ID=56
WBNB_ADDRESS=0xBB4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c
ROUTER_ADDRESS=0x10ED43C718714eb63d5aA57B78B54704E256024E

# Optional Settings
LOG_LEVEL=info
TELEGRAM_TOKEN=123456:ABC-DEF...
TELEGRAM_CHAT=123456789

Configuration Files

File Purpose Example
hunter.config.json Token hunter targets Token addresses, amounts, slippage
copier.config.json Copy trade settings Tracked wallets, copy percentage
paths.config.json Trading path sequences Buy/sell steps, timing
volume.config.json Volume generation Token, interval, amounts

📝 Example: hunter.config.json

{
  "targets": [
    { 
      "address": "0x...", 
      "bnbAmount": "0.05", 
      "slippage": 800 
    }
  ]
}

📖 Usage Guide

Development Mode (Hot Reload)

npm run dev

Production Commands

🎯 Hunt New Tokens

# Dry run (recommended first)
node build/main.js hunt-tokens -c hunter.config.json --dry-run

# Live execution
node build/main.js hunt-tokens -c hunter.config.json

🔄 Copy Trading

node build/main.js copy-trades -c copier.config.json

🛤️ Execute Paths

node build/main.js execute-paths -c paths.config.json

📊 Generate Volume

node build/main.js generate-volume -c volume.config.json --dry-run

Command Options

Option Short Description
--config -c Path to configuration file
--dry-run - Simulation mode (no real transactions)
--help -h Show command help

💡 Best Practices

🛡️ Safety First

  1. Always Test First

    • Use --dry-run flag before live trading
    • Verify all contract addresses
    • Start with minimal position sizes
  2. Risk Management

    • Set appropriate slippage (300-800 bps for new tokens)
    • Configure per-trade limits
    • Monitor total exposure
  3. Security Measures

    • Use dedicated hot wallet
    • Never commit .env to version control
    • Enable MEV protection when possible

📊 Recommended Settings

Strategy Slippage Amount Notes
Token Hunter 500-800 bps 0.01-0.1 BNB High volatility expected
Copy Trader 300-500 bps 10-20% of leader Conservative sizing
Volume Gen 800 bps 0.01 BNB Frequent small trades

🆘 Support

📞 Contact Channels

  • Telegram: @sea_S0L
  • Purpose: Technical support, custom solutions, enterprise deployments

🐛 Troubleshooting

Transaction fails with "Insufficient liquidity"
  • Check token has adequate liquidity pool
  • Increase slippage tolerance
  • Verify router address is correct
Copy trader not detecting trades
  • Ensure RPC supports pending transaction filters
  • Verify tracked wallet addresses are correct
  • Check router address matches target DEX
Telegram notifications not working
  • Verify TELEGRAM_TOKEN and TELEGRAM_CHAT in .env
  • Test bot token with Telegram API
  • Ensure bot is added to chat

🔐 Security

⚠️ Critical Security Guidelines

Never share your private key or commit it to version control

  • ✅ Use environment variables for sensitive data
  • ✅ Enable .env in .gitignore
  • ✅ Use dedicated wallet with limited funds
  • ✅ Regularly audit transaction history
  • ✅ Keep software dependencies updated

🔒 Advanced Security Features

  • Configurable gas price strategies
  • Anti-MEV transaction settings
  • Multi-signature wallet support (coming soon)
  • Transaction simulation before execution
  • Comprehensive audit logging

🚀 Advanced Features

Planned Enhancements

  • Multi-wallet distributed execution
  • Custom slippage curves based on liquidity depth
  • Multi-DEX protocol support (Biswap, ApeSwap, etc.)
  • Advanced analytics dashboard
  • ML-based optimal entry/exit prediction
  • Cross-chain bridge integration

Current Advanced Capabilities

  • ⚡ Configurable gas optimization
  • 📈 Real-time transaction analytics
  • 🔄 Automatic retry logic with backoff
  • 📊 Comprehensive event logging
  • 🎯 Precision timing controls

📜 License

MIT License

Copyright (c) 2024 Prism Trade Engine

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...

Full license: MIT License


⚖️ Legal Disclaimer

⚠️ IMPORTANT: This software is provided for educational and research purposes only.

By using this software, you acknowledge that:

  • Cryptocurrency trading carries substantial financial risk
  • You are solely responsible for compliance with applicable laws and regulations
  • The developers assume no liability for financial losses
  • This is not financial advice
  • Use at your own risk

🌟 Star this project if you find it useful!

Built with ❤️ for the DeFi community

⬆ Back to Top


Last Updated: 2024 | Version 2.0.0

About

Bundler on bsc, four.meme

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •