High-performance TypeScript bot that monitors wallets and DEX activity on Solana and automatically copies/snipes trades. Supports PumpFun, PumpSwap (notify-only by default), Raydium launchpad, configurable selling engine with dynamic trailing stops, and Jupiter for token liquidation.

• Real-time monitoring: Yellowstone gRPC stream, parallel target-wallet + DEX monitors
• Redis queue: ioredis decouples stream detection from trade execution
• Protocols: PumpFun (trade), PumpSwap (notify-only by default)
• Copy trading: Follow one or many target wallets with exclusions
• Risk & selling: Take profit, stop loss, dynamic trailing stop, copy-selling
• Tx landing: ZeroSlot or normal mode, configurable priority fees
• Utilities: Wrap/unwrap SOL, close empty token accounts, sell all tokens via Jupiter

src/
  common/           # config, constants, logger, caches, time-series
  redis/            # ioredis client, keys, in-memory fallback
  queue/            # trade event LPUSH / BRPOP consumer
  types/            # TradeStreamEvent types
  library/          # blockhash, jupiter, zeroslot, rpc, yellowstone stream
  processor/        # monitoring, selling, risk, parsing, trade handler
  dex/              # pump-fun, pump-swap, raydium-launchpad
  block-engine/     # token accounts & transaction helpers
  error/            # error types
  index.ts          # entrypoint & CLI (--wrap, --unwrap, --sell, --close)
  validate.ts       # full pipeline validation (dry-run)

Prerequisites: Node.js 18+, npm

cp .env.example .env
# Edit .env with your keys and endpoints
npm install
npm run build

# Start bot (set DRY_RUN=false and configure PRIVATE_KEY for live trading)
npm start

# Development with hot reload
npm run dev

# Validate full pipeline without live RPC keys
npm run validate

npm start -- --wrap      # Wrap WRAP_AMOUNT SOL to WSOL
npm start -- --unwrap    # Unwrap WSOL back to SOL
npm start -- --sell      # Sell all tokens via Jupiter
npm start -- --close     # Close all token accounts (excl. WSOL with balance)

Copy from .env.example. Key settings:

For personal/educational use. Review and comply with your jurisdiction and exchange/DEX terms.