PolyHermes/RELEASE.md

v1.1.0

🚀 主要功能

🔗 链上 WebSocket 实时监听

• 实现通过 Polygon RPC eth_subscribe 实时监听链上交易
• 支持监听 USDC Transfer 和 ERC1155 Transfer 事件
• 实现并行监控策略：链上 WebSocket 和轮询同时运行，哪个数据先返回用哪个
• 支持通过 eth_unsubscribe 取消单个 Leader 的订阅，无需重新连接
• 优化 WebSocket 连接管理：只创建一个连接，没有跟单配置时自动取消
• 跟单配置生效/失效时及时更新 WebSocket 订阅
• 使用 Gson 替换所有 JSON 解析，提高解析稳定性
• 添加 Mutex 保证线程安全，防止并发处理导致的数据重复

📊 RPC 节点管理

• 实现 RPC 节点管理功能，支持添加、编辑、删除自定义 RPC 节点
• 支持 RPC 节点启用/禁用功能，禁用的节点会被自动忽略
• 前端添加启用/禁用开关，支持实时切换节点状态
• 健康检查只检查启用的节点，提高检查效率
• 节点选择时自动过滤禁用的节点

💰 卖出订单价格轮询更新

• 添加 price_updated 字段到 sell_match_record 表，用于标记价格是否已更新
• 创建 OrderStatusUpdateService 定时任务服务，每 5 秒轮询一次：
  • 更新卖出订单的实际成交价（通过 orderId 查询订单详情）
  • 清理已删除账户的订单记录
• 支持加权平均价格计算，处理部分成交的订单
• 添加 orderId 格式验证：非 0x 开头的直接标记为已更新，0x 开头的等待定时任务更新
• 下单完成后不再立即查询价格，直接保存，等待定时任务更新

🐛 Bug 修复

修复跟单卖出订单的 API 凭证解密问题

• 修复 processSellTrade 中 API 凭证未解密的问题，与 processBuyTrade 保持一致
• 确保卖出订单能够正常使用 API 凭证进行认证

修复 SELL 订单精度问题

• 修复 SELL 订单的 makerAmount 和 takerAmount 精度问题：
  • makerAmount (shares) 最多 2 位小数（符合 API 要求）
  • takerAmount (USDC) 最多 4 位小数（符合 API 要求）
• 确保订单能够正常提交到 Polymarket API

📚 文档更新

• 添加 Docker 版本更新说明（中英文）
• 添加链上 WebSocket 监听策略文档
• 添加跟单逻辑总结文档
• 更新部署文档，包含详细的版本更新步骤

🔧 技术改进

• 使用 Gson 替换 ObjectMapper，提高 JSON 解析稳定性
• JsonRpcResponse.result 使用 JsonElement 类型，支持灵活的 JSON 结构
• 优化 WebSocket 连接管理，减少不必要的连接
• 添加线程安全机制，使用 Kotlin Coroutines Mutex
• 启用 Spring 定时任务功能（@EnableScheduling）

📦 数据库变更

• 新增 price_updated 字段到 sell_match_record 表（Migration: V13）

🔗 相关链接

• GitHub Release: https://github.com/WrBug/PolyHermes/releases/tag/v1.1.0
• 完整更新日志: https://github.com/WrBug/PolyHermes/compare/v1.0.3...v1.1.0
• Docker Hub: https://hub.docker.com/r/wrbug/polyhermes

⚠️ 重要提醒

请务必使用官方 Docker 镜像源，避免财产损失！

✅ 官方 Docker Hub 镜像

官方镜像地址：wrbug/polyhermes

# ✅ 正确：使用官方镜像
docker pull wrbug/polyhermes:v1.1.0

# ❌ 错误：不要使用其他来源的镜像
# 任何非官方来源的镜像都可能包含恶意代码，导致您的私钥和资产被盗

🔗 官方渠道

请通过以下唯一官方渠道获取 PolyHermes：

• GitHub 仓库：https://github.com/WrBug/PolyHermes
• Twitter：@polyhermes
• Telegram 群组：加入群组

---

⭐ 如果这个项目对您有帮助，请给个 Star 支持一下！