listen 最初作为 Solana 的算法交易瑞士军刀工具包起步，如今其使命已演变为成为 AI 跨链投资组合管理代理的首选框架。

它为 Listen 应用 提供支持，快来体验一下 listen 框架的强大功能吧。

Listen 架构

graph TB
    subgraph "Rig Agent Kit by Listen"
        RAK[RIG 代理工具包]
        RAK_MT[多租户流管理器]
        RAK_WALLET[委托钱包管理器]
        RAK --> RAK_MT
        RAK --> RAK_WALLET
    end

    subgraph "Listen 交易引擎"
        LTE[交易引擎]
        ORDER_COL[订单收集器]
        PIPE[管道执行器]
        EXEC[订单执行器]

        ORDER_COL --> PIPE
        PIPE --> EXEC
        LTE --> ORDER_COL
    end

    subgraph "Listen 数据服务"
        LDS[数据服务]
        SUB[Substreams 索引器]
        DB[(Clickhouse OLAP)]
        PRICE[价格流]

        SUB -->|索引 Solana 区块| DB
        LDS --> PRICE
        LDS --> DB
    end

    %% 外部系统
    MOBILE[移动应用]
    CHAIN((区块链))
    PRIVY((Privy))
    WALLET[(Solana/EVM 钱包)]

    %% 连接
    RAK -->|工具调用| CHAIN
    RAK -->|执行交易| LTE
    LDS -->|定价更新| LTE
    LDS -->|丰富数据| MOBILE
    MOBILE -->|用户意图| RAK
    LTE -->|签名并发送交易| CHAIN
    DB -->|查询数据| RAK
    RAK_WALLET -->|集成| PRIVY
    PRIVY --> WALLET

功能特性

• 🔍 实时交易监控
• 💱 支持多 DEX 交换（Pump.fun、Jupiter V6 API 或 Raydium）
• 🚀 借助 Jito MEV 批次实现极速交易
• 📊 价格跟踪与指标分析
• 🧰 代币管理实用工具
• 📈 支持 Prometheus 集成的性能监控

以及更多！

它可与 $arc rig framework 框架即插即用，使 AI 代理能够与 Solana 区块链交互。示例请参见： src/agent.rs 及其输出 image。

关于代理相关的内容，更多信息请参考：rig-onchain-kit

如需了解完整功能列表，请查看 cargo run 的 CLI 输出或访问文档。

快速入门

要体验 listen-rs，您可以使用 UI：

填写 .env.example 和 ./dashboard/.env.example 文件，并将其复制到 .env 和 ./dashboard/.env 中，然后运行：

docker compose up

之后您可以通过 http://localhost:4173 访问仪表板。

[!WARNING] listen-rs 正在快速迭代中，部分功能可能尚未完善，且可能存在破坏性变更。

系统要求

1. 系统依赖

   • Rust（包含 nightly 工具链）
   • protoc
   • build-essential
   • pkg-config
   • libssl-dev

2. 配置

   • 将 .env.example 复制到 .env
   • 设置用于 JITO 认证的 auth.json 文件（可选，gRPC HTTP/2.0 搜索客户端）
   • 填充 fund.json

两个密钥对均采用 solana-keygen 格式，即 64 字节数组，前 32 字节为私钥，后 32 字节为公钥。

快速开始

# 安装依赖
sudo apt install protoc build-essential pkg-config libssl-dev

# 构建
cargo build --release

# 启动服务
./run-systemd-services.sh

使用示例

交易监控

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

代币兑换

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

[!WARNING] 默认配置适用于主网的小额交易。请确保在测试网上使用时进行正确配置，并在执行前仔细检查代码。

指标与监控

Listen 内置了指标服务，可通过 localhost:3030/metrics 查看。可视化步骤如下：

1. 启动 Prometheus：

prometheus --config=prometheus.yml

2. 访问指标：localhost:3030/metrics

Grafana 应显示类似以下内容：

高级用法

交换性能剖析

可以安装 stackcollapse.pl 工具，方法如下：

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

使用 DTrace 对交换性能进行剖析，生成火焰图：

./hack/profile-swap.sh

Listen 快速上手指南

Listen 是一个基于 Rust 构建的 AI 跨链投资组合管理代理框架，最初作为 Solana 算法交易工具包开发。它支持实时交易监控、多 DEX _swap_执行（如 Pump.fun, Jupiter, Raydium）以及通过 Jito MEV bundles 实现极速交易。

环境准备

在开始之前，请确保您的系统满足以下要求：

系统依赖

您需要安装 Rust（nightly 版本）及相关编译工具。

Ubuntu/Debian 用户：

sudo apt update
sudo apt install -y protoc build-essential pkg-config libssl-dev curl

安装 Rust (推荐使用国内镜像加速)：

export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
curl --proto '=https' --tlsv1.2 -sSf https://mirrors.ustc.edu.cn/rust-static/rustup/install.sh | sh
source $HOME/.cargo/env
rustup default nightly

配置文件

在项目根目录下进行配置：

1. 复制环境变量模板：

   cp .env.example .env
   cp ./dashboard/.env.example ./dashboard/.env
   

2. 密钥配置：
   • 编辑 .env 文件填入必要的 API Key。
   • 如需使用 Jito MEV，需配置 auth.json。
   • 配置资金钱包 fund.json。

   注意：密钥对格式为 solana-keygen 格式（64 字节数组：32 字节私钥 + 32 字节公钥）。

安装步骤

您可以选择通过 Docker 快速体验 UI 界面，或直接编译源码使用 CLI。

方式一：Docker 快速启动（推荐体验 UI）

适合快速查看 Dashboard 和整体架构运行效果。

docker compose up

启动后访问 http://localhost:4173 查看仪表盘。

方式二：源码编译（用于开发或 CLI 使用）

# 构建 Release 版本
cargo build --release

# 启动系统服务脚本（如需后台运行）
./run-systemd-services.sh

基本使用

Listen 提供了强大的命令行工具，以下是两个最常用的核心功能示例。

⚠️ 警告：默认配置针对 Mainnet 且设定了小额交易。在生产环境或测试网使用前，请务必检查代码并正确配置网络参数。

1. 实时交易监控

监听链上交易流，可自定义工作线程数和缓冲区大小。

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

将 [COUNT] 和 [SIZE] 替换为具体的数字，例如 --worker-count 4 --buffer-size 1024。

2. 代币交换 (Swap)

执行跨 DEX 的代币交换操作。以下示例展示将 SOL 兑换为 USDC。

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

注：amount 单位通常为最小精度单位（Lamports），此处 10000000 代表 0.01 SOL。

3. 性能监控 (可选)

Listen 内置了 Prometheus 指标暴露。启动 Prometheus 后可在 localhost:3030/metrics 查看数据，并配合 Grafana 进行可视化监控。

prometheus --config=prometheus.yml