RustMinerSystem

文档

矿工、钱包统计与图表 API

RustMinerSystem 端口图表、矿工列表、钱包统计、独立抽水比例、日志和 TCP 连接查询接口。

矿工、钱包统计与图表 API

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

图表与系统统计

方法 路径 返回用途
GET /api/stat/currency/{currency} 指定币种总算力历史。
GET /api/stat/port/{id} 指定监听端口算力历史。
GET /api/stat/worker/{id} 指定矿工算力历史。
GET /api/device/stats 全部设备数量历史。
GET /api/currency/online/stat/{coin} 指定币种在线设备历史。
GET /api/sys/stat CPU、内存、接收和发送流量历史。
GET /api/sys/base/info 当前系统资源快照。

历史数据通常返回数组。时间戳和数值单位可能随版本变化，图表调用端应从实际响应确认。

获取矿工列表

GET /api/port/{id}/g/workers?device=0&size=50&page=1&col=s_thh&desc=1&wallet=...
查询参数 说明
device 状态筛选。新版前端默认 0。
size 每页数量。
page 页码。
col 排序字段，例如 s_thh。
desc 1 降序，0 升序。
wallet 可选，逗号分隔的钱包筛选。

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

{
  "workers": [],
  "total": 0,
  "stat": {
    "online": 0,
    "offline": 0,
    "s_thh": 0
  }
}

钱包汇总和收藏

方法 路径 用途
GET /api/port/{id}/g/wallet/list 获取端口下的钱包筛选列表。
GET /api/port/{id}/g/wallets/{collect} 获取钱包统计；collect 控制收藏筛选。
POST /api/port/{id}/wallet/collect 收藏或取消收藏钱包。

收藏请求：

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

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

钱包独立比例

方法 路径 用途
GET /api/port/{id}/wallet/ratio 获取钱包独立比例列表。
POST /api/port/{id}/wallet/ratio 为指定钱包和抽水钱包设置比例。
DELETE /api/port/{id}/wallet/{wallet_name}/ratio 恢复指定钱包的默认比例。

设置请求：

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

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

矿工独立比例

获取当前比例：

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

设置或恢复：

POST /api/port/{id}/worker/ratio
<自定义请求头名称>: <API 凭据>

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

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

日志和连接查询

方法 路径 用途
GET /api/port/{id}/log 获取端口日志。
GET /api/group/{gid}/log 获取矿工组连接/断开日志。
GET /api/worker/{id}/error/log 获取指定矿工失败数据流。
GET /api/port/{id}/ips?page=1&size=20 获取端口 TCP 连接列表。

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