Merge branch 'release/0.2.0'

Author: mkdir700

.gitignore

@@ -163,6 +163,3 @@ cython_debug/
 config.toml
 config.test.toml
 .DS_Store
-
-# VS Code
-.vscode/

.pre-commit-config.yaml

@@ -0,0 +1,18 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.3.4
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+      - id: debug-statements
+      - id: check-merge-conflict

.vscode/settings.json

@@ -0,0 +1,15 @@
+{
+  "makefile.configureOnOpen": false,
+  "python.testing.pytestArgs": [
+    "tests"
+  ],
+  "python.testing.unittestEnabled": false,
+  "python.testing.pytestEnabled": true,
+  "[python]": {
+    "editor.codeActionsOnSave": {
+      "source.fixAll": "explicit",
+      "source.organizeImports": "explicit"
+    },
+    "editor.defaultFormatter": "charliermarsh.ruff"
+  }
+}

.vscode/tasks.json

@@ -0,0 +1,69 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "运行 Cache Preloader 服务",
+      "type": "shell",
+      "command": "uv run python app/cache-preloader/cache_preloader/main.py",
+      "problemMatcher": [],
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "new",
+        "focus": true
+      },
+      "detail": "启动 Cache Preloader 服务"
+    },
+    {
+      "label": "运行 Wallet Tracker 服务",
+      "type": "shell",
+      "command": "uv run python app/wallet-tracker/wallet_tracker/main.py",
+      "problemMatcher": [],
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "new",
+        "focus": true
+      },
+      "detail": "启动 Wallet Tracker 服务"
+    },
+    {
+      "label": "运行 Trading 服务",
+      "type": "shell",
+      "command": "uv run python app/trading/trading/main.py",
+      "problemMatcher": [],
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "new",
+        "focus": true
+      },
+      "detail": "启动 Trading 服务"
+    },
+    {
+      "label": "运行 Tg Bot 服务",
+      "type": "shell",
+      "command": "uv run python app/tg-bot/tg_bot/main.py",
+      "problemMatcher": [],
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "new",
+        "focus": true
+      },
+      "detail": "启动 Tg Bot 服务"
+    }
+  ]
+}

CODE_OF_CONDUCT.md

@@ -82,4 +82,4 @@ This Code of Conduct is adapted from the [Contributor Covenant][homepage], versi
 available at [https://contributor-covenant.org/version/1/4][version]
 
 [homepage]: https://contributor-covenant.org
-[version]: https://contributor-covenant.org/version/1/4/
+[version]: https://contributor-covenant.org/version/1/4/

Makefile

@@ -4,7 +4,7 @@ DOCKER_EXEC := podman  # podman or docker
 
 # 安装开发依赖
 dev-deps:
-	pdm install -G dev -G local
+	uv sync
 
 # 基础设施服务
 infra-up:
@@ -47,4 +47,7 @@ clean:
 	find . -type d -name ".eggs" -exec rm -r {} +
 
 update-version:
-	python scripts/update-version.py
+	uv run python scripts/update-version.py
+
+pre-commit-check:
+	uv run pre-commit run --all-files | cat

README.md

@@ -92,6 +92,13 @@ cp example.config.toml config.toml
   shyft_api_base_url = "https://api.shyft.to"
   shyft_api_key = ""
   ```
+- `db`: 数据库连接配置，默认配置适用于本地开发环境。在 Docker 环境中会自动使用容器别名。
+  ```
+  [db]
+  # 本地开发环境（从源码运行）
+  mysql_url = "mysql+pymysql://root:[email protected]:3307/solana_trade_bot"
+  redis_url = "redis://127.0.0.1:6380/0"
+  ```
 
 > 💡 为了获得更快的跟单速度，默认使用 `geyser` 模式，同时也支持 WebSocket 订阅方式
 

app/cache-preloader/Dockerfile

@@ -0,0 +1,37 @@
+# Build base image first
+FROM python:3.10-slim as builder
+
+# Set environment variables
+ENV PYTHONUNBUFFERED=1 \
+    PDM_USE_VENV=false \
+    PDM_INSTALL_PATH=/app \
+    PROJECT_ROOT=/app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    build-essential \
+    curl \
+    git \
+    libssl-dev \
+    pkg-config \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install PDM
+RUN curl -sSL https://pdm.fming.dev/install-pdm.py | python3 - && \
+    ln -s /root/.local/bin/pdm /usr/bin/pdm
+
+WORKDIR /app
+
+# Create necessary directories
+RUN mkdir -p /app/libs /app/logs
+
+# Build final image
+FROM builder as final
+
+# Install dependencies
+COPY ./libs /app/libs
+COPY ./app/cache-preloader/pyproject.toml /app/
+RUN pdm config python.use_venv false && \
+    pdm install -G local
+
+ENTRYPOINT [ "pdm", "run", "python", "-m" ]

app/cache-preloader/README.md

@@ -0,0 +1,40 @@
+# 缓存预加载微服务
+
+此微服务负责预加载和维护各种缓存数据，以提高主应用程序的性能。
+
+## 项目结构
+
+```
+cache_preloader/
+├── __init__.py           # 包初始化文件
+├── main.py               # 主入口点
+├── core/                 # 核心组件
+│   ├── __init__.py       # 核心包初始化文件
+│   ├── protocols.py      # 协议定义
+│   └── base.py           # 基础类实现
+├── caches/               # 具体缓存实现
+│   ├── __init__.py       # 缓存包初始化文件
+│   ├── blockhash.py      # 区块哈希缓存
+│   ├── min_balance_rent.py # 最小租金余额缓存
+│   └── raydium_pool.py   # Raydium 池缓存
+└── services/             # 服务实现
+    ├── __init__.py       # 服务包初始化文件
+    └── auto_update_service.py # 自动更新服务
+```
+
+## 组件说明
+
+### 核心组件 (core/)
+
+- **protocols.py**: 定义缓存系统的协议接口
+- **base.py**: 实现基础缓存类，提供通用功能
+
+### 缓存实现 (caches/)
+
+- **blockhash.py**: 区块哈希缓存实现
+- **min_balance_rent.py**: 最小租金余额缓存实现
+- **raydium_pool.py**: Raydium 池缓存实现
+
+### 服务实现 (services/)
+
+- **auto_update_service.py**: 自动更新缓存服务，协调和管理各种缓存的更新

app/cache-preloader/cache_preloader/__init__.py

@@ -0,0 +1,7 @@
+"""
+缓存预加载微服务
+
+此微服务负责预加载和维护各种缓存数据，以提高主应用程序的性能。
+"""
+
+__version__ = "0.1.0"