Paper-only Solana market-activity simulator for educational research, strategy rehearsal, and analytics pipeline testing.

This repository now contains a complete and runnable simulation framework that models randomized buy/sell activity patterns without sending on-chain transactions and without using private keys.

It is designed for:

• backtesting internal analytics tools
• stress-testing dashboards and event processors
• validating session-shape assumptions in a controlled environment

Implemented in this repository:

• Config-driven simulation engine (config.yaml based)
• Wallet pool model with rotation strategy and per-cycle reuse limits
• Randomized event generation for side, amount, and delay jitter
• Session estimation for expected notional activity
• CSV report export for downstream analysis
• Validation and safety checks (paper-only mode enforced)
• Automated tests using pytest
• Professional defaults via .gitignore, .env.example, and sample config

.
├── main.py
├── requirements.txt
├── config.example.yaml
├── .env.example
├── src/
│   └── solana_volume_sim/
│       ├── __init__.py
│       ├── config.py
│       ├── engine.py
│       ├── models.py
│       └── wallet_pool.py
└── tests/
    ├── conftest.py
    └── test_engine.py

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

cp config.example.yaml config.yaml
cp .env.example .env

python main.py --config config.yaml --output reports/latest_session.csv

pytest -q

token:
  mint_address: "So11111111111111111111111111111111111111112"
  pool_type: "raydium"

execution:
  mode: "paper"                 # enforced in this public build
  cycles: 2
  transactions_per_cycle: 8
  buy_size_min_sol: 0.01
  buy_size_max_sol: 0.09
  sell_ratio: 0.35
  interval_min_seconds: 1
  interval_max_seconds: 3
  random_seed: 42

wallets:
  pool_size: 8
  rotation_strategy: "random"   # random | sequential
  max_wallet_reuse_per_cycle: 2

network:
  rpc_endpoint: "https://api.mainnet-beta.solana.com"
  commitment: "confirmed"
  max_retries: 3

logging:
  level: "INFO"
  output: "stdout"
  log_file: "./logs/session.log"

============================================================
SOLANA ACTIVITY SIMULATOR LITE (PAPER ONLY)
Token: So11111111111111111111111111111111111111112 | Pool: raydium
Estimated notional activity: 1.080000 SOL
============================================================
Events: 16 (buys=11, sells=5) | Notional volume: 0.831243 SOL
Report saved: reports/latest_session.csv

• This repository intentionally supports simulation only.
• No private key handling is included.
• No live trade execution is implemented.
• No tooling for market manipulation is provided.

Planned safe improvements:

• richer session profiles (flat/ramp/spike) for simulation studies
• terminal summary dashboard for longer simulation runs
• JSON output mode in addition to CSV
• optional Monte Carlo batch runs for parameter sensitivity analysis

• GitHub: Rezzecup

MIT (add a LICENSE file if you want it included explicitly in this repository).