PoolNode 项目与网站管理 API

本章记录 RustMinerSystem 后台调用的 /api/poolnode/* 管理接口。它们与 PoolNode 用户端开放 API /api/user/* 不同，主要供节点所有者配置项目和网站。

PoolNode 接口常返回 { status, error, data } 包装结构。前端会从 data 读取真实结果，并把 status: 4 视为项目尚未激活。

项目申请和激活

注销会清空前端的项目、费率和端口状态。执行前应确认结算和网站数据已经备份。

节点端口和接入点

部分币种的延迟测试会追加 ?k=KAS。创建端口主体与通用端口结构接近，节点前端额外使用：

{
  "port": 3333,
  "name": "Pool Port",
  "currency": "PI-BTC",
  "pool_address": "<接入点 ID 的 JSON 字符串>",
  "mode": 1,
  "protocol": 0,
  "category": "poolnode",
  "proxy_addr": ""
}

修改附加配置：

{
  "mode": 1,
  "proxy_addr": "<公开模式钱包或子账号>"
}

网站访问设置

端口、路径和 TLS 修改可能触发服务重启，调用端必须准备切换到新地址。

网站证书

上传主体为 { pem, key }，两个字段均是 UTF-8 文本的 Base64 编码。

个性化网站和模板

网站配置保存为 Base64 编码 JSON：

{
  "k": "<Base64(JSON.stringify(config))>"
}

选择模板：

{
  "asset_id": 1,
  "item_id": 2
}

APP 通信配置

{
  "api_url": "https://pool.example.com/safe-route",
  "refresh": 0
}