github

piotrostr / listen

  • пятница, 24 января 2025β€―Π³. Π² 00:00:01
https://github.com/piotrostr/listen

Solana Swiss Army Knife




Β 

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.

Quickstart

To play around with listen-rs, you can use the UI

Fill in the .env.example and ./dashboard/.env.example, copy over to .env and ./dashboard/.env.example, then

docker compose up

You can then access the dashboard over http://localhost:4173

Warning

listen-rs is undergoing rapid iterations, some things might not work and there could be breaking changes

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