矿工、钱包统计与图表 API

本章接口主要用于端口详情页和仪表盘。GET 接口适合只读监控，比例修改接口会影响实际抽水行为。

图表与系统统计

这些接口都返回 ChartPoint[] 或统计数组，完整字段见图表响应。端口图表的 {id} 使用 server.port；矿工图表的 {id} 使用矿工的 sid（没有时回退到 id）。

获取矿工列表

GET /api/port/{id}/g/workers?device=0&size=50&page=1&col=s_thh&desc=1&wallet=...

前端读取的响应字段包括：

{
  "workers": [],
  "stat": {
    "id": "...",
    "online": 0,
    "offline": 0,
    "conn": 0,
    "thh": 0,
    "s_thh": 0,
    "delay": 0,
    "ct": 0
  },
  "pages": 0,
  "total": 0,
  "page": 1,
  "size": 50
}

workers[] 中当前前端实际读取的字段：

响应允许包含其他后端字段。调用方应保留未知字段，并使用 sid || id 作为图表和比例操作的矿工标识。wd 不为空时，通过 GET /api/ht/{server_id} 找到相同 id 的组合规则，再把 target 按 wallet.device 拆分：钱包侧结合当前 wallet 展示，矿工名侧结合当前 name 展示，并分别解析 #{WALLET} 与 #{DEVICE}。如果规则还包含 address 和 c，可同时展示命中后的重定向矿池及其 TCP 或 TLS/SSL 协议。旧字段 hw 和 hd 已废弃，调用方不应再依赖。

钱包汇总和收藏

收藏请求：

{
  "wallet": "<钱包或子账号>",
  "f": 1
}

f=1 表示收藏，f=0 表示取消收藏。

返回结构：

• /g/wallet/list 返回 string[]，每个元素可直接放入矿工查询的 wallet 参数。
• /g/wallets/{collect} 返回钱包统计数组。每项包含 id（钱包/子账号）、online、offline、s_thh 和 ct；ct=1 表示已收藏。
• 收藏接口成功时返回成功标量或 HTTP 200；写入后重新 GET 钱包统计。

这里的钱包统计 id 是矿工提交的钱包文本，不是端口抽水钱包的 wallets[].id。抽水钱包 ID 来自端口详情的 wallets[]。

钱包独立比例

设置请求：

{
  "wallet": "<矿工使用的钱包>",
  "wid": 10,
  "r": 0.01
}

wid 是抽水钱包 ID，r 使用 0–1 小数。

GET /api/port/{id}/wallet/ratio 返回数组元组：

[
  ["<矿工钱包>", "<抽水钱包 ID>", 0.01]
]

元组索引 0 是 /g/wallets/{collect} 的钱包 id，索引 1 是端口 wallets[].id，索引 2 是独立比例。POST 成功返回成功标量或 HTTP 200；DELETE 成功后该钱包恢复端口默认抽水比例。

矿工独立比例

获取当前比例：

GET /api/wallet/{wallet_id}/worker/{sid}/ratio

设置或恢复：

POST /api/port/{id}/worker/ratio
X-ACCESS-TOKEN: <Access Token>

{
  "sid": "<矿工会话 ID>",
  "wid": 10,
  "r": 0.01,
  "f": 1
}

f=1 表示保存独立比例，f=0 表示恢复默认值。

GET /api/wallet/{wallet_id}/worker/{sid}/ratio 返回 null 或：

{
  "r": 0.01
}

wallet_id 来自端口抽水钱包 wallets[].id，sid 来自本页 workers[].sid。GET 返回 null 时使用该抽水钱包的默认 ratio。POST 保存/恢复成功时返回成功标量或 HTTP 200。

日志和连接查询

TCP 响应通常包含 data、size、page、pages 和 total。

日志与连接返回字段

端口日志的 f 当前按 保留值|矿工名|钱包|IP|类别|状态 解析。类别可能为 GROUP、IP_FORBIDDEN 或 WALLET_FORBIDDEN；状态 0 表示连接/成功方向，其他值表示断开或拦截方向。

ips.data[] 的前端读取字段为：

分页查询的 page 从 1 开始，size 应与响应中的实际值同步。

字段依赖速查