RustMinerSystem

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

API web security, firewall и логов

Safe route, web port, HTTPS, сертификаты, IP/wallet firewall и endpoints логов RustMinerSystem.

API web security, firewall и логов

Эти операции могут изменить адрес панели, перезапустить service или заблокировать доступ. Сначала проверьте новый endpoint и никогда не блокируйте текущий адрес управления.

Web access

Метод Путь Запрос/назначение
GET /api/route Получить safe route.
POST /api/route Сохранить через { "k": "new-route" }.
POST /api/web/port/restart Изменить web port через { "port": 8080 }.
GET /api/web/tls Получить состояние HTTPS.
POST /api/web/tls/{flag} Настроить HTTPS; flag равен 0 или 1.

Изменение route, порта или HTTPS может оборвать текущий запрос во время restart. Сначала попробуйте подключиться к новому адресу.

Сертификат mining ports

Метод Путь Назначение
GET /api/cert Состояние глобального сертификата mining ports.
POST /api/cert/upload Загрузить PEM и private key.
GET /api/cert/reset Восстановить встроенный сертификат. 
{
  "pem": "<URI encode текста сертификата, затем Base64>",
  "key": "<URI encode текста private key, затем Base64>"
}

Не записывайте этот body в лог. Reset изменяет состояние, хотя текущий frontend вызывает его методом GET.

IP blacklist

Метод Путь Назначение
GET /api/ip/blacklist Получить IP blacklist.
POST /api/ip/blacklist/add Добавить IP.
POST /api/ip/blacklist/delete Удалить IP.
GET /api/ip/coming IP access records всех портов.
GET /api/ipblacklist/all/log События блокировки IP. 
{
  "ips": ["192.0.2.10"]
}

Wallet blocklist и allowlist

Метод Путь Назначение
GET /api/wallet/blacklist Получить wallet blocklist.
POST /api/wallet/blacklist/add Добавить заблокированный wallet.
POST /api/wallet/blacklist/delete Удалить заблокированный wallet.
GET /api/wallet/whitelist Получить wallet allowlist.
POST /api/wallet/whitelist/add Добавить разрешенный wallet.
POST /api/wallet/whitelist/delete Удалить разрешенный wallet.
GET /api/bwlist/log Логи совпадений wallet firewall.

Историческое имя поля также ips:

{
  "ips": ["<wallet или subaccount>"]
}

Логи программы и операций

Метод Путь Назначение
GET /api/request/log Логи операций панели.
GET /api/running/log Runtime logs.
GET /api/error/log Error logs программы.
GET /api/d/tl Проблемные подключения miners.

Логи могут содержать wallets, IP, pool endpoints и внутренние ошибки. Выполняйте redaction и строго ограничивайте доступ.

Справочник ответов

Web и сертификаты

  • GET /api/route возвращает safe-route прямой строкой.
  • GET /api/web/tls возвращает число: 0 выключено, ненулевое значение включено.
  • GET /api/cert возвращает числовое состояние; frontend считает 0 отсутствием custom certificate.
  • Изменение web port, route, TLS, upload и reset возвращает success scalar или HTTP 200. Соединение может закрыться уже после применения изменения.

IP firewall

  • /api/ip/blacklist возвращает string[].
  • /api/ip/coming возвращает tuples, сейчас [ip, port, time]; старые данные могут быть [ip, time] или объектом.
  • /api/ipblacklist/all/log возвращает { t, f, d }[]: t — timestamp, f — строка с |, d — status/direction. UI читает port и IP из третьего и четвертого сегментов f.
  • Add/delete возвращают success scalar или HTTP 200; затем повторите GET.

Wallet firewall

Blacklist и allowlist возвращают string[]. /api/bwlist/log возвращает { t, f, d }[], где f — wallet/subaccount, а d=0 текущий UI считает попаданием blacklist. Mutations возвращают success scalar или HTTP 200.

Логи программы

Endpoint Успешный ответ
/api/request/log string[], обычно [time] operation.
/api/running/log string[] или текст с разделением строками.
/api/error/log string[] или текст с разделением строками.
/api/d/tl { port, coin, wi, ct }[].

В trouble-connection записи port — listen port, coin — валюта, wi — identifier wallet/worker, ct — счетчик. Endpoint может быть временно недоступен вместо возврата пустого массива.