快速开始

平台采用静态前端 + FastAPI + SQLite 架构，前端展示实时概率、订单簿、交易记录和托管状态，后端负责密钥加密、身份验证、Polymarket API 编排与审计。

接入说明

Hive Stream 的托管凭据分为两类：Polymarket CLOB L2 API 凭据用于查询、下单和撤单；Ethereum encrypted keystore 用于签名账户动作。前端只展示脱敏字段，后端把托管包加密保存到 SQLite，bot 后续从服务端导出策略兼容配置。

托管凭据导入流程

新增凭据时，先用“生成加密配置”把私钥转换为 encrypted keystore JSON，Signer 地址会从 keystore 自动解析。EOA 模式下 Funder 自动等于 signer；POLY_1271 / Deposit Wallet 模式必须填写实际 Polymarket deposit wallet。默认由服务器通过 L1 signer 自动创建或派生 CLOB L2 三件套；取消自动生成时才需要手动填写 API key、secret 和 passphrase。导入成功后表单会清空，右侧托管密钥库会显示脱敏 API key、keystore 地址、策略标签、初次导入时间和校验状态。

私钥加密如何工作

前端的“生成加密配置”使用浏览器内的 ethers 钱包加密流程，把私钥转换为 Ethereum V3 keystore JSON；私钥明文不会写入表单结果，也不会保存到服务器。服务器只接收 encrypted keystore JSON，并使用服务端 master key 再加密整个托管包后写入 SQLite。

需要实盘托管下单时，平台还必须能解密 keystore，因此 keystore 口令会作为服务器端密文保存。这个模式是托管交易模型，不是纯本地签名模型；安全边界依赖 RBAC、文件权限、master key、审计日志和不记录明文 secret 的运行约束。

Binance-Event 安卓接入操作说明

接入前必须先阅读并同意本页底部“用户条款与风险确认”。Binance-Event 执行器通过 Android 无障碍在用户自己的 Binance App 内执行操作，不提供交易建议，不接触用户资金，也不保证成交、收益或结算结果。

1. 下载与安装

安装包放在静态下载目录，不占用后端 API 线程。本地静态服务会用流式文件读取返回 APK，避免大文件下载阻塞系统。

adb install -r assets/downloads/HiveStreamExecutor-debug.apk
adb install -r assets/downloads/ADBKeyboard-com.github.uiautomator.apk

2. 设置 ADB Keyboard

ADB Keyboard 用于稳定输入金额，减少系统软键盘遮挡按钮的概率。若设备不允许切换输入法，执行器会尝试使用无障碍输入和元素识别兜底，但实盘前仍建议启用。

adb shell ime enable com.github.uiautomator/.AdbKeyboard
adb shell ime set com.github.uiautomator/.AdbKeyboard

3. 注册平台账户与提交 Binance 接入申请

1. 在 Web 登录页提交注册申请，等待管理员审核通过。
2. 登录 Web 控制台，进入“接入”，平台选择 BINANCE。
3. 提交 Binance 账户、联系电话和必要备注。二次验证需要人工协助时，管理员会按联系方式联系你。
4. 管理员完成接入后，右侧“Binance-Event 已接入”会出现对应设备或接入状态。

4. Android 首次登录和权限配置

1. 打开 Hive Stream Android 执行器，输入已审核通过的平台邮箱和密码。
2. 勾选并阅读《用户条款》后登录。登录成功后，设备会把登录用户邮箱作为 Web 上报归属。
3. 打开系统设置 -> 无障碍 -> 启用 Hive Stream 执行器。
4. 允许通知、后台运行、自启动或电池无限制；在最近任务中锁定 Hive Stream 和 Binance。
5. 保持 Binance App 已登录，进入 BTCUSDT 的“事件合约”页面，并确认能看到周期、数量、上涨/下跌按钮。

5. 初始化检查、5U 测试和首次小额实盘

1. 在 Android 执行器点击“初始化检查”，确认 Web 上报、信号通信、无障碍绑定和执行界面识别均通过。
2. 点击“5U 测试”，确认应用能触达 Binance 确认弹窗并取消，不产生真实订单。
3. 用户自行确认风险后，使用可承受损失的金额完成一笔真实小额下单，验证成交、Web 上报、已开仓识别、结算识别和余额曲线。
4. 测试通过后再锁定设置、启动服务，并按需开启自动执行。若 Web 通信异常、账户过期、实时余额不足或设备状态异常，执行器会拒绝实盘下单。

6. 调试与常见问题

身份验证

交易请求分为平台登录鉴权和 Polymarket CLOB 鉴权。平台侧用 RBAC 控制接入、托管下单、审核和风控查看；CLOB 侧使用 L1 签名派生 L2 凭据，后续下单和查询走 L2 请求头。

签名类型

接入表单需要记录钱包类型、签名类型和 funder 地址。私钥明文只用于本地生成 Ethereum keystore JSON；平台不保存私钥明文。服务器托管模式会加密保存 CLOB L2 凭据和 keystore 口令，供 bot 拉取配置。

{
  "signature_type": 2,
  "wallet_address": "0x signer...",
  "funder_address": "0x deposit wallet...",
  "keystore_json": {"version": 3, "crypto": "..."},
  "scope": "read-trade"
}

市场数据

总览页通过 FastAPI 聚合 Polymarket 5m、15m、1h orderbook depth/history、Chainlink BTC/USD 和策略 phat 序列。接口不可用时，页面明确显示 LOCAL SNAPSHOT。

GET /api/overview
GET /api/signals
GET /api/polymarket/markets
GET /api/polymarket/orders
GET /api/polymarket/trades
GET /api/bot-integrations

订单生命周期

策略只上传意图和审计字段，后端负责价格、数量、tick size、最小订单、权限、签名模式和风控闸门校验。所有托管下单请求必须写入审计日志。

风控与审计

钱包 activity 记录 conditionId、outcome、shares、price、交易哈希、策略名和凭据；已结算仓位来自 Data API closed-positions，按结算时间入库并统计 realized PnL。管理员可按角色查看或导出。

接口

POST /api/auth/login
POST /api/auth/register
GET  /api/me
PATCH /api/me
POST /api/polymarket/credentials
POST /api/bot-integrations/credentials
POST /api/bot-integrations/export
POST /api/bot-integrations/runtime
GET  /api/overview
POST /api/strategy/trades/upload
POST /api/strategy/orders/upload

SQLite 表

users, roles, permissions, user_roles,
signup_reviews, polymarket_credentials,
polymarket_orders, strategy_trade_records,
strategy_order_records, account_snapshots,
position_records, bot_runtime_state,
bot_credential_packages, audit_logs, user_sessions