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

Hot replacement кошелька и worker name в TCMinerProxy

Используйте комбинированные rules wallet.device в TCMinerProxy для hot replacement кошелька и worker name, multi-value match, placeholders и optional pool redirection.

Hot replacement кошелька и worker name

Hot replacement динамически изменяет identity, которую miner отправляет через работающий proxy port. Текущая модель объединяет кошелек и worker name как wallet.device; отдельные типы rules для этих частей больше не используются.

При совпадении rule сервер принудительно отключает miner и применяет новый кошелек и worker name при следующем подключении.

Отличие от fee hot update

Функция	Что изменяется	Активное отключение miners
Fee config hot update	Fee wallets, fee worker names, fee ratios и fee pools	Нет
Wallet / worker-name hot replacement	Кошелек и worker name подключенного miner, а также optional target pool	Да после совпадения; результат действует при reconnect

Для обслуживания fee wallets используйте fee hot update. Эту функцию используйте, когда текущие кошелек и worker name miner определяют необходимость изменения его identity.

Где открыть

Rules требуют ID уже созданного порта, поэтому их нельзя настроить до сохранения нового порта. Диалог доступен в двух местах:

Actions строки proxy port -> Wallet / worker name hot replacement.
Верхняя панель деталей порта -> Wallet / worker name hot replacement.

На странице деталей action показывает текущее число rules, если оно больше нуля.

Комбинированный match pattern

pattern строится как match-wallet.match-worker. Каждая сторона принимает одно значение, список через запятую или * для всей стороны.

pattern	Совпадение
`a.*`	Все workers кошелька `a`.
`*.b`	Worker name `b` любого кошелька.
`.`	Все miners текущего порта.
`a,b,c.*`	Все workers кошельков `a`, `b` или `c`.
`*.d,e,f,g`	Workers с именами `d`, `e`, `f` или `g`.

Обычные значения допускают латинские буквы, цифры, _, @ и -. Match выполняется по полному значению; регулярные выражения, частичные wildcard и точки внутри частей identity не поддерживаются.

Комбинированный replacement target

target строится как target-wallet.target-worker. Каждая сторона содержит одно фиксированное значение или соответствующий placeholder сохранения текущего значения.

target	Результат
`a.#{DEVICE}`	Кошелек становится `a`, текущий worker name сохраняется.
`#{WALLET}.b`	Текущий кошелек сохраняется, worker name становится `b`.
`c.d`	Кошелек становится `c`, worker name становится `d`.

#{WALLET} используется только на стороне кошелька.
#{DEVICE} используется только на стороне worker name.
Target не принимает * или списки через запятую; placeholders нельзя менять местами.

Optional pool redirection

Включите одновременное перенаправление mining address, чтобы также настроить:

Pool address в формате host:port.
Pool protocol TCP или TLS/SSL, соответствующий target endpoint.

Если опция выключена, rule меняет только кошелек и worker name, а miner продолжает использовать pool текущего proxy port.

Создание rule

Откройте диалог и нажмите Add rule.
Введите match кошелька и worker name или используйте shortcuts для всех кошельков и workers.
Введите target кошелька и worker name или используйте shortcuts сохранения текущих значений.
При необходимости включите pool redirection и укажите endpoint и protocol.
Проверьте сформированные комбинации pattern и target.
Нажмите Create rule и подтвердите область воздействия.
Во время запроса кнопка подтверждения показывает loading и блокирует повторные клики. После успеха диалог закрывается; после ошибки остается открытым, а кнопка снова становится доступной.

Текущий endpoint поддерживает только комбинированный тип t=2. Legacy types t=0 и t=1 устарели, а Web UI всегда создает rules t=2.

Просмотр, удаление и изменение

Сохраненные rules отображаются в списке. Выберите rule для просмотра полного pattern, target и optional pool redirection.

Сохраненная rule доступна только для чтения и не редактируется на месте.
Для изменения удалите старую rule и создайте новую.
Delete требует подтверждения; во время запроса кнопка подтверждения также показывает loading и блокирует повторные клики.
После успешного create или delete UI обновляет список rules и workers порта.

Проверка совпадения

После повторного подключения совпавшего miner проверьте поля кошелька и worker name в списке устройств на странице порта. UI отдельно показывает исходное и вычисленное target-значение.

При использовании #{WALLET} или #{DEVICE} соответствующая сторона вычисляется как текущее значение miner. Если miner переподключился, но конкретный target не показан, проверьте:

Содержит ли worker response непустой wd.
Есть ли тот же ID в списке rules текущего порта.
Имеет ли rule тип t=2 и корректный target в формате wallet.device.

wd соответствует индексу tuple 0 — ID rule из /api/ht/{server_id}. Legacy fields hw и hd устарели. Полный контракт см. в API proxy ports и fee wallets.