Bagsapp Solana Trading Toolkit (Compliant)

This repository provides a safe, operator-controlled Solana toolkit for:

• token launch workflow scaffolding
• wallet orchestration
• execution throttling controls
• simulation-only "volume profile" research mode
• gather utility to consolidate SPL tokens from controlled wallets

It does not implement wash trading, fake volume, or market manipulation logic.

Features

• launch command: launch workflow skeleton for Bagsapp/BagsFM integrations
• simulate-volume command: dry-run market activity simulator with buy/sell speed and size controls
• gather command: collect SPL tokens from worker wallets into treasury
• strict env config validation with zod
• support for multiple wallet key formats (base58 and JSON array)

Quick Start

1. Install dependencies:

npm install

2. Copy env template and fill keys:

cp .env.example .env

3. Build:

npm run build

4. Run help:

npm start -- help

Commands

Launch Workflow Skeleton

npm start -- launch --name "My Coin" --symbol MYC --decimals 6 --supply 1000000000

This logs a launch plan and validates config. BagsFM launch transaction details should be wired in src/services/launch.ts.

Simulate Volume Profile (No On-Chain Orders)

npm start -- simulate-volume --minutes 15 --buy-min 5 --buy-max 25 --sell-min 5 --sell-max 25 --events-per-minute 8

When buy and sell ranges are equal, simulation stays near neutral net flow.

Gather SPL Tokens From Bot Wallets

npm start -- gather --mint <TOKEN_MINT_ADDRESS>

This transfers token balances from bot wallets to treasury wallet.

Environment Variables

See .env.example for full list.

• RPC_URL: Solana RPC endpoint
• TREASURY_SECRET_KEY: treasury signer private key
• BOT_SECRET_KEYS: comma-separated wallet private keys
• ENABLE_LIVE_TRADING: enable real transactions (default false)
• ALLOW_MULTI_WALLET_LIVE: keeps live mode single-wallet by default
• TOKEN_MINT: optional default mint for gather/simulation commands

📞 Support

• telegram: https://t.me/trade_SEB
• twitter: https://x.com/TradeSEB_