Skip to content

Latest commit

 

History

History
128 lines (91 loc) · 3.46 KB

README.md

File metadata and controls

128 lines (91 loc) · 3.46 KB


 

listen is a Solana Swiss-Knife toolkit for algorithmic trading

Features

  • 🔍 Real-time transaction monitoring
  • 💱 Multi-DEX swap execution (Pump.fun, Jupiter V6 API or Raydium)
  • 🚀 Blazingly fast transactions thanks to Jito MEV bundles
  • 📊 Price tracking and metrics
  • 🧰 Token management utilities
  • 📈 Performance monitoring with Prometheus integration

And more!

It works plug'n'play with $arc rig framework framework allowing AI Agents interact with the Solana blockchain, see example: src/agent.rs and the output image.

For complete rundown of features, check out the CLI output of cargo run or the documentation.

This repository contains some miscellanous tools for grabbing data from bullx/gmgn.ai/pump.fun unofficial APIs, in bullx, watcher, pump-ts and an analysis module, all which might be useful, though the core of the library is located in the src directory.

Requirements

  1. System Dependencies

    • Rust (with nightly toolchain)
    • protoc
    • build-essential
    • pkg-config
    • libssl-dev

  2. Configuration

    • Copy .env.example to .env
    • Set up auth.json for JITO authentication (optional, gRPC HTTP/2.0 searcher client)
    • Populate fund.json

Both keypairs are in solana-keygen format, array of 64 bytes, 32 bytes private key and 32 bytes public key.

Quick Start

# Install dependencies
sudo apt install protoc build-essential pkg-config libssl-dev

# Build
cargo build --release

# Run services
./run-systemd-services.sh

Usage Examples

Transaction Monitoring

cargo run -- listen \
  --worker-count [COUNT] \
  --buffer-size [SIZE]

Token Swapping

cargo run -- swap \
  --input-mint sol \
  --output-mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --amount 10000000

Warning

Default configuration is set for mainnet with small transactions. Ensure proper configuration for testnet usage and carefully review code before execution.

Metrics and Monitoring

Listen includes built-in metrics exposed at localhost:3030/metrics. To visualize:

  1. Start Prometheus:
prometheus --config=prometheus.yml
  1. Access metrics at localhost:3030/metrics

Grafana should show something like this

image

Advanced Usage

Swap Profiling

The stackcollapse.pl can be installed through

gh repo clone brendangregg/FlameGraph && \
  sudo cp FlameGraph/stackcollapse.pl /usr/local/bin && \
  sudo cp FlameGraph/flamegraph.pl /usr/local/bin

Profile swap performance using DTrace to produce a flamegraph:

./hack/profile-swap.sh
image