RustMinerSystem

Документация

API proxy ports и fee wallets

Создание, изменение, запуск, остановка и импорт proxy ports RustMinerSystem, проверка pool и endpoints fee wallets.

API proxy ports и fee wallets

Эти вызовы напрямую меняют поведение proxy. Защитите create/update/delete через TOTP и создайте backup перед массовыми операциями.

Жизненный цикл порта

Метод Путь Назначение
GET /api/ports Все proxy ports и текущая сводка.
GET /api/port/{id} Полная конфигурация порта, settings и fee wallets.
POST /api/port/new Создать proxy port.
POST /api/port/{id} Изменить proxy port.
POST /api/port/{id}/start Запустить порт.
POST /api/port/{id}/stop Остановить порт.
DELETE /api/port/{id} Удалить порт.
POST /api/ports/import Импортировать несколько портов.
POST /api/ping Проверить upstream pool.

{id} — ID записи, он не всегда равен номеру listen port. Некоторые chart endpoints используют именно номер порта.

Создание и изменение

Обе операции используют одинаковую структуру. Упрощенный пример:

{
  "port": 3333,
  "name": "BTC Proxy",
  "currency": "BTC",
  "category": "sha256",
  "protocol": 0,
  "limit_connections": 60000,
  "pool_address": "stratum.example.com:3333",
  "pool_address2": "backup.example.com:3333",
  "connect_mode": 0,
  "connect_mode2": 0,
  "mode": 0,
  "nc": 0,
  "pattern_addr": "",
  "replace_addr": "",
  "wallets": [],
  "setting": {}
}
Поле Значение
port Локальный порт 1–65534.
currency / category Код валюты и категория алгоритма.
protocol Enum протокола локального listener.
pool_address / pool_address2 Основной и резервный upstream.
connect_mode / connect_mode2 Режим upstream TCP/TLS.
mode Transparent, relay, unified-wallet или другой режим.
wallets Fee wallets, отправляемые вместе с портом.
setting Compression, forced-success, worker replacement и другие advanced settings.

Внешний client не выполняет UI TOTP flow. Он отправляет только custom API authentication header; writable scopes будут описаны после завершения permission model.

Массовый импорт

POST /api/ports/import

{
  "ports": [
    {}
  ]
}

Ответ обычно содержит список ошибок по отдельным портам. Учитывайте частичный сбой даже при HTTP 200.

Проверка pool

POST /api/ping

{
  "address": "stratum.example.com:3333",
  "conn_type": 0
}

Frontend использует conn_type=0 для обычного подключения и 1 для TLS/SSL-подобных протоколов.

Hot update fee wallets

Метод Путь Назначение
POST /api/wallet/new Добавить fee wallet.
POST /api/wallet/{id} Обновить fee wallet.
DELETE /api/wallet/{id} Удалить fee wallet. 
{
  "server_id": 1,
  "addr": "fee-wallet",
  "device": "fee-worker",
  "pool_address": "pool.example.com:3333",
  "pool_protocol": 0,
  "ratio": 0.01
}

При update передается также id. ratio — дробь 0–1: 0.01 означает 1%. Frontend использует pool_protocol=0 для TCP и 1 для TLS/SSL.