一个基于 Sui 网络的 DEX 套利机器人框架，支持多种套利策略和数据源。

❗️ 当前开发阶段

本项目为开发框架，仅包含以下模块：

• 项目结构搭建
• 基础类定义
• 接口设计
• 部分模块实现
• 运行主逻辑

❌ 尚未实现

• 完整业务逻辑

• 数据持久化

• 完整测试用例

• 多数据源支持

  • Sui 链上交易监控
  • Shio Feed 实时数据
  • 支持自定义数据源扩展
  • 支持自定义数据筛选扩展

• 灵活的套利策略

  • 两池子套利（基于解析解）（适用于FlowX Swap AMM与 Kriya 1等Dex）
  • 多池子套利（基于梯度搜索）
  • 支持添加自定义策略

• 智能路径搜索

  • 支持自定义路径
  • 基于受影响池子的动态路径搜索
  • 流动性和代币黑名单过滤
  • 可配置最大路径长度

• 风险控制

  • 最小利润阈值
  • Gas 成本估算
  • 代币价格实时监控

src/
├── analysis/      # 分析交易模块
├── common/        # 通用工具
├── db/            # 数据库
├── execution/     # 交易执行
├── monitor/       # 数据监控
├── path/          # 路径搜索
├── strategy/      # 套利策略
└── token_price/   # 代币价格

1. 添加新的数据源
   • 继承 Monitor 类
   • 实现 monitor_transactions 方法
2. 添加新的过滤策略
   • 继承 TransactionFilter 类
   • 实现 filter 方法
3. 添加新的套利策略
   • 继承 Strategy 类
   • 实现 find_arbitrage_opportunity 方法

• Python 3.8+
• pip 20.0+

1. 创建并激活虚拟环境

# 使用 venv
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
.venv\Scripts\activate     # Windows

2. 安装依赖

# 使用 requirements.txt
pip install -r requirements.txt

# 或者使用 poetry（推荐）
poetry install

项目使用 Poetry 进行依赖管理，主要依赖包括：

[tool.poetry.dependencies]
python = "^3.8"
websockets = ">=10.0,<13.0"  # 与pysui兼容的版本
python-dotenv = "^1.0.0"
pysui = "0.79.0" 
scipy = "^1.9.0"
numpy = "^1.21.0"
aiohttp = "^3.8.0"
pytest = "^7.0.0"
pytest-asyncio = "^0.18.0"

1. 安装 Poetry

curl -sSL https://install.python-poetry.org | python3 -

2. 安装项目依赖

poetry install

3. 添加新依赖

poetry add package-name

4. 更新依赖

poetry update

5. 导出 requirements.txt

poetry export -f requirements.txt --output requirements.txt --without-hashes