Начни майнить с FearMiner

Одна строка устанавливает FearMiner, проверяет его ключом релиза и держит запущенным как службу. Он майнит то, что задаёт кокпит, или на твой кошелёк на выбранном тобой пуле. Ручной способ, скачать, проверить, запустить, сразу ниже.

Одна строка #

$ curl -fsSL https://get.fearminer.com | sh

PS> irm https://get.fearminer.com/win | iex

$ curl -fsSL https://get.fearminer.com | sh

Extra config arguments: --enroll fm1_...

Хочешь скачать сам? #

Одни и те же файлы на обоих хостах:

Затем проверь, распакуй и запусти вручную:

Предупреждение при первом запуске

$ curl -LO https://github.com/fearminer/fearminer/releases/latest/download/fearminer-linux-x86_64.tar.gz
$ curl -LO https://github.com/fearminer/fearminer/releases/latest/download/SHA256SUMS
$ grep ' fearminer-linux-x86_64.tar.gz$' SHA256SUMS | sha256sum -c -
$ tar xzf fearminer-linux-x86_64.tar.gz && cd fearminer-*-linux-x86_64
$ ./fearminer -o stratum+ssl://POOL:PORT -u YOUR_WALLET -w rig1

PS> Invoke-WebRequest https://github.com/fearminer/fearminer/releases/latest/download/fearminer-windows-x86_64.zip -OutFile fearminer-windows-x86_64.zip
PS> Invoke-WebRequest https://github.com/fearminer/fearminer/releases/latest/download/SHA256SUMS -OutFile SHA256SUMS
PS> (Get-FileHash .\fearminer-windows-x86_64.zip -Algorithm SHA256).Hash.ToLower()
PS> Select-String windows-x86_64 SHA256SUMS
PS> Expand-Archive fearminer-windows-x86_64.zip -DestinationPath . ; cd fearminer-*-windows-x86_64
PS> .\fearminer.exe -o stratum+ssl://POOL:PORT -u YOUR_WALLET -w rig1

$ curl -LO https://github.com/fearminer/fearminer/releases/latest/download/fearminer-macos-arm64.tar.gz
$ curl -LO https://github.com/fearminer/fearminer/releases/latest/download/SHA256SUMS
$ grep ' fearminer-macos-arm64.tar.gz$' SHA256SUMS | shasum -a 256 -c -
$ tar xzf fearminer-macos-arm64.tar.gz && cd fearminer-*-macos-arm64
$ xattr -dr com.apple.quarantine .
$ ./fearminer -o stratum+ssl://POOL:PORT -u YOUR_WALLET -w rig1

Flight sheet: майнер custom
URL установки: ассет fearminer_custom-<version>.tar.gz последнего релиза, https://github.com/fearminer/fearminer/releases/download/v1.15.2/fearminer_custom-1.15.2.tar.gz
Алгоритм: qpow · Шаблон кошелька: %WAL%.%WORKER_NAME%
URL пула: stratum+ssl://POOL:PORT · Пароль: x
Extra config arguments: любая опция, например -d 0,2 --tls-fingerprint SHA256

Работает, когда видишь это #

job 9dd830e6 diff 18.25G
✔ 1/1 · GPU0 · 18.25G · 24 ms
hashrate 618.4 MH/s (10m 611.9, session 609.8, eff 598.2 / 97.8 %)

job 4b1c77a2 diff 40.0K
✔ 1/1 · CPU · 40.0K · 31 ms
hashrate 7.1 kH/s (10m -, session -, eff -)

Задача, принятая шара, хэшрейт: майнинг идёт. Первый блок это риг с GPU, второй с CPU.

eff и средние показывают -, пока в окне не принято десять шар. Читай терминальную панель и журналы разбирает весь стартовый блок построчно.

Остановка: q в терминальной панели или Ctrl+C. Любой из двух останавливает чисто, код выхода 0.

Куда идут деньги #

Принятая шара это не выплата. Пул засчитывает её и платит позже.

Порог выплаты, расписание и комиссия пула принадлежат пулу, а не FearMiner. Собственная комиссия FearMiner отдельная и показана в заголовке терминальной панели (Алгоритмы, комиссии и требования).

Кокпит на app.fearminer.com бесплатный, без аккаунта и со сквозным шифрованием: ретранслятор между ним и ригами передаёт запечатанные сообщения, которые не может прочитать. Он показывает хэшрейт фермы и его историю, задаёт, что майнит каждый риг, ставит риг на паузу, продолжает или перезапускает его.

Добавить риг #

FearMiner уже установлен: fearminer enroll fm1_... на риге, без перезапуска. Команда печатает имя рига (XXXX-XXXX-XXXX-XXXX) и имя фермы; кокпит показывает те же имена: сравни их.

$ fearminer enroll fm1_...
$ fearminer remote status

Листы майнинга #

С ожиданием тот, кто пробрался в твой кокпит, не перенаправит твой хэш незаметно: у тебя есть это время, чтобы увидеть это и остановить.

Подключение и удалённый канал #

У всего остального есть рабочее значение по умолчанию.

Ассет fearminer_custom-<version>.tar.gz релиза это custom miner для HiveOS: бинарник и четыре скрипта h-*.sh в папке fearminer_custom. HiveOS показывает его как fearminer_custom. Статистика идёт с собственного /hive-stats майнера, как есть.

Пакет собирает командную строку из этих полей:

h-run.sh передаёт --allow-root, поскольку HiveOS запускает каждый майнер от root, а бинарник иначе отказывается стартовать от root.

В flight sheet ничего добавлять не нужно.

Сбой или зависшая карта перезапускают процесс майнинга после задержки.

/hive-stats возвращается на том же порту, сбои по картам и перезапуски на нём есть.

Watchdog HiveOS покрывает случай, когда супервизор сдаётся (код выхода 12).

--no-supervisor в дополнительных аргументах запускает один процесс и оставляет все перезапуски HiveOS.

Контракт статистики:

Разгон остаётся за flight sheet: без опции разгона майнер не трогает ни одного регистра частоты, лимита мощности или вентилятора.

--no-oc в дополнительных аргументах делает это явным.

HiveOS запускает майнер от root, так что опции разгона работают там без помощника.

Бета, начиная с 1.5.3: сделано по опубликованному руководству mmpOS для custom miner и сверено с ним, на настоящем риге с mmpOS ещё не запускалось. Сообщай, что не работает, в Telegram-канале или в issue. Ассет fearminer_mmpos-<version>.tar.gz релиза это custom miner для mmpOS; в панели mmpOS:

Тот же список печатает fearminer --list-algorithms, по строке на алгоритм с однострочным описанием; с --json один массив из {name, coin, class, fee_bps, aliases, unit, hive, requirements, refused}.

Список это подписанный индекс движков: новый алгоритм становится новой строкой здесь при следующей сборке страницы и новым движком на ригах без нового релиза майнера (Движки, ниже).

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

Это потолок из подписанного индекса движков, никогда выше 5 %: подписанные условия с cfg.fearminer.com могут её снизить, но не поднять. Алгоритм, для которого условия не называют пул комиссии, майнится бесплатно, сказано один раз при старте.

fee window даёт, когда наступит первый раунд; каждый раунд пишет fee round started (1 min) и fee round ended с числом шар.

Загрузка, обновление и откат движков #

Майнер сам ничего не хэширует: каждый алгоритм это отдельный движок, fearminer-engine-<algo>, подписанная программа, которую майнер скачивает, запускает и обновляет. Сессия пула, комиссия, супервизор, датчики, API и терминальная панель остаются в майнере.

Новый алгоритм знакомого майнеру семейства входа майнится без нового релиза майнера.

Кошелёк каждой сети #

Сеть читается по кошельку, поэтому одного адреса хватает, чтобы выбрать алгоритм. Контрольная сумма каждого проверяется при старте; --ignore-wallet-check отправляет то, что ты набрал.

Движок CPU: потоки и их размещение #

Одни и те же правила под каждым алгоритмом.

RandomX: huge pages #

RandomX на 20 до 30 % быстрее, когда датасет, кэш и scratchpad лежат в страницах по 2 МиБ, на некоторых машинах до 50 %.

Перед выделением датасета майнер считает, сколько нужно:

То есть 1184 страницы для 16 потоков.

Он читает свободный пул ядра и, если его мало, просит помощника ниже увеличить его, на каждом узле NUMA, если их несколько.

При старте: huge pages 100 % (1184/1184 x 2 MiB) либо E609 с числом, которое надо зарезервировать, и командой.

Без помощника резервируй вручную сразу после загрузки, пока память не фрагментирована, и сохрани настройку между перезагрузками.

transparent_hugepage в режиме always подкладывает то, что не поместилось.

$ sudo sysctl -w vm.nr_hugepages=1184
$ echo 'vm.nr_hugepages = 1184' | sudo tee /etc/sysctl.d/90-fearminer.conf

Страницы по 1 ГиБ: --1gb-pages (huge_pages_1g в файле, по умолчанию выключено, как в XMRig).

Резервирует три страницы по 1 ГиБ на узел NUMA для датасета, когда CPU их поддерживает (pdpe1gb), на 1 до 3 % быстрее страниц по 2 МиБ.

Используются, только когда размер huge page по умолчанию у ядра равен 1 ГиБ: default_hugepagesz=1G hugepagesz=1G hugepages=3 в командной строке ядра, что заодно резервирует их до фрагментации памяти.

Иначе E610 говорит об этом и используются страницы по 2 МиБ.

RandomX: твики MSR #

Настройки префетчеров XMRig на Ryzen и Intel дают до 30 % на Intel и до 6 % на Zen. Его публичные значения:

• Zen 1 и Zen 2
• Zen 3
• Zen 4 и Zen 5
• Intel Core

Им нужен root: майнер просит помощника до своего первого сетевого подключения и сам никогда не работает от root.

--msr auto, значение по умолчанию, выбирает пресет по семейству и модели CPU.

При наличии помощника он применяется. Иначе майнер называет потерю и всё равно стартует:

Каждая строка несёт оценку потери и исправление в одну строку.

Исходные значения сначала читаются и хранятся в файле, принадлежащем root.

Они записываются обратно при каждом завершении процесса майнинга, чистой остановке или сбое (E614, либо E608, когда не удаётся).

Один блок при старте даёт настройку движка:

• JIT или интерпретатор
• аппаратный или программный AES
• строка MSR
• строка huge pages
• потоки и их размещение

В конце доля идеальной конфигурации (performance: about 52 % of the ideal configuration, когда нет ни того, ни другого).

--list-devices --json -a randomx даёт то же под cpu.performance, ничего не применяя (null под другим алгоритмом).

$ fearminer -a randomx -o stratum+ssl://pool.example.com:3335 -u YOUR_WALLET.rig1 -t 50% --cpu-affinity 0-7 --msr zen4
randomx  MSR zen4 preset applied on 16 CPU(s) via /usr/local/bin/fearminer-helper (sudo)
randomx  huge pages 100 % (1184/1184 x 2 MiB)
randomx  8 thread(s) on CPU 0-7 (--cpu-affinity)
randomx  performance: the ideal configuration (JIT, hardware AES, huge pages, MSR)

Помощник: fearminer-helper #

fearminer-helper поставляется рядом с fearminer в архиве для Linux и является единственной привилегированной частью.

• Отдельный бинарник: без сети, без файла конфигурации, без зависимости от майнера.
• Он пишет регистры MSR и увеличивает пулы huge pages по запросу.
• Он логирует каждый шаг в stderr и отвечает одной строкой JSON.
• Майнер запускает его как sudo -n fearminer-helper ... (никогда через shell) до своего первого сетевого подключения и после этого не держит привилегий.
• Сам майнер никогда не работает от root.
• Майнер, запущенный от root (--allow-root, HiveOS), делает то же внутри процесса и никогда его не вызывает.

Установка:

• Скопируй его в /usr/local/bin.
• Затем fearminer-helper install печатает строку sudoers для твоего пользователя и этого пути и drop-in для systemd, подключающий его к fearminer.service; сам он ничего не пишет.
• Положи строку в /etc/sudoers.d и загрузи модуль msr.

Проверь через status: одна строка JSON, привилегий не нужно, даёт то, что позволяет машина.

• модуль msr и его allow_writes
• kernel lockdown, Secure Boot, гипервизор
• свободные и всего huge pages по размеру и узлу
• пресет, который выбрал бы auto

Порядок поиска:

• /usr/local/bin/fearminer-helper
• путь из строки sudoers
• копия из архива рядом с бинарником, которую не покрывает никакое правило sudoers

Если sudo отказывает одному, пробуется следующий.

--helper PATH заменяет оба и становится единственным пробуемым путём.

Когда sudo отказывает ему или там ничего нет, E601 говорит об этом и называет оба пути.

$ sudo install -m 0755 fearminer-helper /usr/local/bin/fearminer-helper
$ fearminer-helper install
$ echo 'USER ALL=(root) NOPASSWD: /usr/local/bin/fearminer-helper' | sudo tee /etc/sudoers.d/fearminer-helper
$ sudo chmod 0440 /etc/sudoers.d/fearminer-helper
$ sudo modprobe msr && echo msr | sudo tee /etc/modules-load.d/msr.conf
$ sudo -n /usr/local/bin/fearminer-helper status

Исходные значения MSR: /run/fearminer-helper/msr.json, файл принадлежит root, до msr restore или следующей загрузки.

Страницы, зарезервированные запуском, возвращаются, когда он останавливается, и никогда ниже того, что занято другим процессом (E615, если не вышло).

Супервизор восстанавливает после каждого завершения процесса майнинга, чистой остановки или сбоя.

Под systemd drop-in добавляет ExecStopPost=fearminer-helper msr restore и ExecStopPost=fearminer-helper hugepages release, страховку на случай гибели супервизора.

Команды майнера:

Выходы:

Ещё не сделано: RandomX v2 (rx/2, следующий форк Monero) и копия датасета на каждый узел NUMA (сегодня одна копия на все; строка старта говорит, по скольким узлам распределены потоки).

Pearl #

• Зашумлённое произведение матриц int8, плитки 8 x 8 которого хэшируются и сравниваются с целью шары; доказательство Меркла выигрышной плитки и есть шара.
• sm_86, sm_89 и sm_120 (серии RTX 30, 40 и 50) с 4,7 GB свободной памяти; другая карта исключается с причиной (E310 по памяти). Нужен только драйвер NVIDIA. Не на macOS.
• Движка CPU нет: -t отклоняется (E202).
• Скорость в T (10^12 умножений с накоплением в секунду), в единицах, которые засчитывают пулы; API даёт MAC/s, HiveOS TH/s, эффективность GMAC/W.
• Каждое доказательство проверяется верификатором сети внутри движка, затем ещё раз майнером перед отправкой (раздел 10).
• Пул должен говорить на stratum Pearl "type": "v2", и выбираешь его ты: fearminer -o stratum+ssl://POOL:PORT -u prl1... -w rig1.
• Комиссия 1 %, потолок: ничего не взимается, пока подписанные условия не назовут точку Pearl, и старт об этом говорит.

Quantus #

• NVIDIA нужен драйвер серии 550 или новее, 570 для RTX 50; предстартовая проверка даёт установленный.
• Карта без нативного движка работает на Vulkan, примерно на трети скорости.
• На риге с GPU движок CPU выключен, и -t N его включает; на риге без GPU он включён, на всех потоках кроме двух.
• Первый запуск настраивает ядро на твоей карте и кэширует результат; --retune измеряет заново.

RandomX #

• Библиотека RandomX от tevador, v1.2.3, встроена в свой движок.
• Выделяется один раз: датасет 2080 MiB, кэш 256 MiB, scratchpad 2 MiB на поток. Машина, которой не хватает места под датасет, майнит на одном кэше, во много раз медленнее, и говорит об этом при старте.
• Датасет пересобирается при каждом новом seed hash, каждые 2048 блоков, примерно раз в три дня: несколько секунд на всех ядрах.
• Потоки ограничены кэшем L3 по 2 МиБ на каждый, а соседний гиперпоток ничего не добавляет.
• Huge pages дают 20 до 30 %, на некоторых машинах до 50 %, а твики MSR до 30 % на Intel и 6 % на Zen. Оба ниже.
• Пулы говорят на CryptoNote stratum: любой пул, к которому подключается XMRig.

TensorCash #

• Доказательство инференса: окна зарегистрированной модели Qwen3-8B считаются на карте, а шара это доказательство размером от 166 до 200 KB. Скорость в PoI/s, доказательствах инференса в секунду, и с хэшрейтом она не сравнивается.
• Только NVIDIA, с 11.1 GB свободной памяти GPU; карта, где её меньше (например, на ней загружена другая модель), исключается с E310. Движка CPU нет.
• Пулы это брокеры WebSocket: -o wss://host/v1/ws -u tc1q....rig1 -p token-file=<путь>. Сессию с пулом держит движок и читает токен пула из этого файла (права 600); майнер его никогда не читает и не показывает. Пока используется только первый пул.
• Из кокпита лист TensorCash требует на риге FearMiner 1.7.1 или новее; токен остаётся на риге, как выше.
• Собственные настройки движка (бэкенд, веса модели, закреплённые их SHA-256, хост, куда уходит токен) лежат в файле, который задаёт TSC_POOL_CONFIG.
• Офлайн-бенчмарка нет: --benchmark так и пишет и завершается с кодом 3, а -a all пропускает его с причиной. Его скорость измеряется на пуле.
• Отклонённая шара или пул, отказавший в логине, завершают сессию (E114): майнер остаётся запущенным, но не майнит, пока ты его не перезапустишь.
• Комиссия: 2 %, её майнит сам движок на том же пуле, на собственный аккаунт FearMiner tc1q..., без минутных раундов.

• -o можно повторять или задать один раз с URL через запятую; FEARMINER_URL=A,B делает то же.
• Порядок это приоритет: первый пул основной, остальные его резерв.
• Кошелёк, пароль и TLS-пины (--tls-fingerprint, --tls-spki) задаются один раз на все пулы или по одному на пул в том же порядке.
• Любое другое количество это E203.
• Каждое соединение, включая пробы и раунды комиссии, идёт через один dialer: прокси, резолвер и политику семейств адресов ниже.

--job-timeout #

После --job-timeout секунд без новой задачи рабочие потоки останавливаются. Майнер переподключается по тем же правилам, что и при потере соединения (E105).

Если не задано, значение берётся у сети:

Строка говорит, какое; 0 отключает защиту.

TLS: публичные корни, пин или доверие при первом контакте #

stratum+ssl:// это TLS 1.2 или 1.3 (1.3 предпочтительно), имя хоста в SNI. --tls добавляет его к голому host:port.

Согласованные протокол и шифр печатаются один раз на соединение.

Сертификат, не подписанный корнями (нода, P2Pool, приватный пул), надо закрепить.

Неудачное рукопожатие никогда не откатывается к обычному TCP.

Любой пин: одно значение на все пулы или по одному на пул в порядке пулов, - для пула без пина.

Несовпадение (E103) печатает пин и то, что предъявил пул, в той же нотации.

$ fearminer -o stratum+ssl://pool.example.com:3335 -u YOUR_WALLET.rig1 --tls-fingerprint 3a3524b6...c8307
$ openssl s_client -connect pool.example.com:3335 </dev/null 2>/dev/null | openssl x509 -fingerprint -sha256 -noout
$ fearminer -o stratum+ssl://node.lan:3335 -u YOUR_WALLET.rig1 --tls-spki sha256/BASE64
$ openssl s_client -connect node.lan:3335 </dev/null 2>/dev/null | openssl x509 -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64
$ fearminer -o stratum+ssl://node.lan:3335 -u YOUR_WALLET.rig1 --tls-tofu
TLS: first contact with node.lan:3335: certificate 3a3524b6...c8307 remembered
$ fearminer -o stratum+ssl://node.lan:3335 -u YOUR_WALLET.rig1 --tls-tofu --tls-tofu-reset node.lan:3335
$ fearminer -o stratum+ssl://10.0.0.2:3335 -u YOUR_WALLET.rig1 --tls-insecure
TLS: 10.0.0.2:3335 TLS 1.3 TLS13_AES_256_GCM_SHA384, certificate not verified (--tls-insecure), SHA-256 3a3524b6...c8307

--tls-tofu доверяет сертификату при первом контакте.

• Первое рукопожатие печатает отпечаток сертификата пула и сохраняет его в tls-pins.json в каталоге состояния, с ключом host:port.
• Последующее рукопожатие с другим сертификатом отклоняется с E118, который печатает оба отпечатка, и пул оставляется ради следующего.
• Чтобы принять новый сертификат: запусти один раз с --tls-tofu-reset host:port (можно повторять) или удали запись из файла.
• Пул со своим --tls-fingerprint или --tls-spki проверяется по своему пину, а не по файлу.
• Существующий tls-pins.json, который не удаётся прочитать, это E119: майнер не стартует.

--tls-insecure ничего не проверяет: принимается любой сертификат, который предъявляет пул, без проверки цепочки, имени и срока.

• Это для TLS-проброса порта или прокси, когда имя, к которому подключаются, не имя пула и корни отклоняют рабочий путь. Строка E102 такого отказа называет его рядом с пином.
• Сессия остаётся зашифрованной, но любой на пути может выдать себя за пул и забрать работу рига: об этом говорит каждый старт (E120), а строка TLS печатает SHA-256 предъявленного сертификата, который принимает --tls-fingerprint. Когда сертификат известен, пин надёжнее.
• Пул со своим пином сохраняет его. Отклоняется вместе с --tls-tofu и когда не остаётся пула stratum+ssl:// без пина.
• Раунды комиссии идут тем же путём, что и пулы. Условия, движки, телеметрия и ретранслятор кокпита всегда проверяются по публичным корням.
• Нужен перезапуск. Лист кокпита может задать его для своих пулов, и лист, который его меняет, перезапускает майнер.

Строка TLS соединения даёт, что сработало.

Прокси и DNS #

--proxy socks5://[user:pass@]host:port ведёт каждое соединение с пулом через прокси SOCKS5:

• сессию майнинга
• пробы основного
• раунды комиссии

Пул никогда не пробуется напрямую, пока задан прокси.

Пароль в URL маскируется в журнале и в --dry-run, но виден в списке процессов: задай его в файле конфигурации или в окружении.

Через прокси идут соединения с пулами, загрузки движков, связь кокпита с ретранслятором и телеметрия. Напрямую, по HTTPS, показывая конечным точкам собственный адрес рига, идут:

• загрузка подписанных условий комиссии (cfg.fearminer.com)
• оповещения
• heartbeat из --heartbeat-url

Риг, который должен выходить в сеть только через прокси, оставляет прокси для пулов: загрузка условий тогда безобидно не удаётся (E111: майнер работает с последними проверенными условиями или со встроенными).

$ fearminer -o stratum+ssl://pool.example.com:3335 -u YOUR_WALLET.rig1 --proxy socks5://127.0.0.1:9050
network  proxy socks5://127.0.0.1:9050 (the proxy resolves) · ip any
dns      pool.example.com: resolved by the proxy socks5://127.0.0.1:9050, no local lookup
$ fearminer -o stratum+ssl://pool.example.com:3335 -u YOUR_WALLET.rig1 --dns doh --doh-url https://1.1.1.1/dns-query
network  dns doh (https://1.1.1.1/dns-query) · ip any
dns      pool.example.com → 203.0.113.10 (doh https://1.1.1.1/dns-query)
$ fearminer -o stratum+ssl://pool.example.com:3335 -u YOUR_WALLET.rig1 --ipv4-only

DoH скрывает имена от локального резолвера, но не пул от сети.

TLS SNI и адрес пула остаются видимыми в канале; их скрывает прокси.

С --proxy разрешает прокси.

--ip 4|6|any выбирает семейство адресов.

URL принимает литерал IPv6 в скобках (stratum+tcp://[2001:db8::1]:3333).

Перед первым подключением строки network и dns предстартовой проверки дают, как будут достигаться пулы и во что разрешается каждое имя.

Они же дают, кто ответил: системный резолвер, резолвер DoH или прокси без локального запроса.

Каждый сокет к пулу несёт TCP keepalive (60 с простоя, проба каждые 10 с, три пробы), так что узел, ушедший без FIN, замечается примерно за минуту.

Когда пул ведёт себя плохо #

Пул может также зависать, запинаться или лгать; у каждого случая есть правило, строка с кодом и счётчик в записи пула (/api/v1/pools).

• Шара без ответа: отправка ждёт вердикта --submit-timeout секунд (10); после этого она без ответа, не засчитывается, сообщается один раз (E125), считается в shares.unanswered. Любой ответ на шару, вовремя или с опозданием, обнуляет серию (ответ на keepalive нет). --max-no-submit-responses (10) подряд завершают сессию (E113): переподключение сразу, а если следующая сессия идёт так же, пул оставляется ради следующего.
• Отказ: каждая отклонённая шара это одна строка со словами пула и их классом. Классы: low difficulty, stale, duplicate, unknown job, unauthorized, other, по коду Stratum v1, когда пул его присылает, и по формулировке иначе. Это счётчики rejected_by_reason в записи пула; класс последнего отказа идёт с событиями shares_rejected_high и gpu_unstable.
• Нет задачи: отсутствие новой задачи --job-timeout секунд при живом сокете завершает сессию (E105), рабочие потоки останавливаются первыми; значение берётся у сети, если не задано, и строка pool при старте даёт, какое действует.
• Та же задача снова: задача, чьи id и работа уже были видны на соединении, игнорируется со строкой debug (jobs_duplicate). Задача, несущая работу более старой задачи под любым id, это повтор: игнорируется, сообщается один раз за сессию (E128), считается (jobs_replayed); рабочие потоки остаются на текущей задаче. Судится по содержимому, никогда только по id.
• Задача исчерпана: риг сделал на задаче столько хэшей, сколько у неё нонсов. Это 2^32 на RandomX, где нонс четыре байта; задача Quantus предлагает больше, чем перебирает любой риг. Поиск останавливается (E127, один раз на задачу, nonce_space_exhausted), и рабочие потоки ждут следующую задачу, а не хэшируют те же нонсы снова.
• Сообщение: client.show_message показывается один раз, как текст, с пометкой пула; escape-последовательности и управляющие символы убираются, текст обрезается на 200 символах, и ничто в нём никогда не интерпретируется. Тот же текст повторно не показывается.
• Перенаправление: client.reconnect (host, port, wait) выполняется только когда хост есть в списке пулов, на любом порту, после запрошенного ожидания, не более 60 с. Перенаправление куда-либо ещё отклоняется одной строкой E126 с именем хоста; сессия продолжается там, где была. Перенаправление на другой пул списка это переход на тот пул: сессия логинится с кошельком, паролем и пином того пула, и это считается переключением пула.
• Медленные ответы: --max-latency, выше (E129).

$ fearminer -o A -o B -u YOUR_WALLET.rig1 --submit-timeout 15 --max-latency 300
E125 share unanswered: share 42 on job j7 from GPU0 not answered within 15 s (3 unanswered in a row)
E129 pool latency over the limit: pool: moving to stratum+ssl://B (backup 2/2): answers in 48 ms, stratum+ssl://A in 310 ms
[ REJECTED ] 3/10 · GPU0 · 4.00M · stale · "Stale share" · 40 ms

Кошелёк и его пул #

Кошелёк всегда задаётся вместе с пулом: -o (или FEARMINER_URL, url или [[pools]] в файле) рядом с -u, WALLET, FEARMINER_USER или user. Пул выбираешь ты; майнер никогда не выбирает его сам.

Без -a сеть берётся с адреса: каждый алгоритм сборки спрашивается, декодируется ли адрес для его сети, ничего не угадывается.

Каждый случай отклоняется до любого подключения, с кодом выхода 2, при старте так же, как под --check-config.

Без кошелька и без пула майнер не майнит никому.

Проходит предстартовая проверка, терминальная панель показывает карты с их телеметрией, /stats говорит mode monitoring, до Ctrl+C.

-d выбирает GPU:

• по индексу, как их печатает --list-devices (порядок PCI, как у nvidia-smi)
• по PCI id
• по UUID
• по вендору
• исключением

Элементы объединяются как множество.

На NVIDIA берутся именно эти карты; Vulkan и Metal берут первые N, только -d 0..N-1.

-d отклоняется на алгоритме только для CPU (RandomX).

cpu не карта, потоки CPU задаёт -t.

--list-devices печатает список и ничего больше.

Одно значение на карту #

Одна грамматика для каждой покарточной опции (--temp-limit, --temp-resume).

• Одно значение покрывает все карты.
• Значения через запятую идут по одному на карту, в порядке карт, на которых майнят: порядок -d со списком использования, иначе порядок списка; исключённая карта сохраняет своё место.
• _ оставляет значение этой карты по умолчанию.
• Список короче числа карт оставляет остальные по умолчанию.
• Более длинный это E206 с числом.

--dry-run печатает, как ложится список (gpu: --temp-limit #0 85, #2 80).

Первая позиция --temp-limit это общий предел по ядру.

Отличающаяся позиция принадлежит этой карте и возобновляется на том же расстоянии ниже, что и общая пара: --temp-limit 90,80 --temp-resume 75 останавливает карту 1 на 80, возобновляет на 65.

--device-missing #

Элемент -d, не называющий здесь ни одной карты (-d 5 на риге с одной картой, UUID карты из другого рига): E206, выход 2, до старта любого движка; --check-config говорит то же.

--device-missing first или last (FEARMINER_DEVICE_MISSING) сохраняет конфигурацию и майнит на тех выбранных картах, которые есть; журнал называет ожидаемые и не найденные.

Покарточные списки ложатся на найденные карты с первой позиции (first) или с последней назад (last).

Выбор, ни одной карты которого нет, ничего не выбирает: журнал говорит no card of the selection is present, потоки CPU майнят.

С -t 0 запуск это E301 (выход 3), предсказанный --check-config и --dry-run той же строкой и кодом.

Исключение отсутствующей карты ничего не исключает при любом из них.

--list-devices --json #

--list-devices --json печатает один документ JSON:

• карты в порядке драйвера (индексы, которые принимает -d), каждая со своим движком (null для исключённой карты или на алгоритме без движка GPU)
• CPU
• RAM

Факты идут из nvidia-smi, файлов драйвера и sysfs, источников проверок перед подключением.

Факт, который ничто не даёт, это null, никогда не догадка.

{"gpus": [{"index": 0, "name": "NVIDIA GeForce RTX 4070 Ti", "pci_bus_id": "0000:01:00.0",
           "uuid": "GPU-3f2a1b4c-5d6e-7f80-9a1b-2c3d4e5f6a7b", "vram_mb": {"total": 12282, "free": 11870},
           "compute_capability": "8.9", "driver": "570.86", "vendor": "nvidia", "engine": "cuda"}],
 "cpu": {"model": "AMD Ryzen 9 7950X 16-Core Processor", "physical_cores": 16, "threads": 32, "l3_mib": 64, "aes": true, "numa_nodes": 1},
 "ram_mb": 64036}

Состояния устройств #

Каждая смена состояния пишется в журнал с её кодом и, под супервизором, добавляется в watchdog.log. /stats несёт state по карте, выровненный с hs; /api/v1/devices, state в каждой записи.

Датчики #

NVML читает карты NVIDIA дважды в секунду:

• температура ядра
• вентилятор
• мощность платы и её предел
• частоты
• причины троттлинга от драйвера

И там, где карта их даёт:

• температура памяти (большинство карт от класса 3090 и выше; ноутбук или малая карта ничего не говорят)
• счётчик энергии
• волатильные счётчики ECC (при включённом ECC)
• счётчик повторов PCIe
• линия PCIe сейчас и в максимуме (gen 1 x1 под нагрузкой: плохой райзер)

Строка терминальной панели показывает температуры, которые есть у карты (64°C · mem 78 · hot 81).

/api/v1/devices и /stats несут каждое показание (temp_mem_c, temp_hotspot_c, energy_mj, throttle_reasons, ecc_corrected, ecc_uncorrected, pcie_replays, pcie_gen, pcie_width, pcie_max_gen, pcie_max_width), null там, где его нет.

Причины троттлинга это стабильные метки: idle, app_clocks, power_cap, hw_slowdown, sync_boost, sw_thermal, hw_thermal, hw_power_brake, display_clock; [] когда их нет.

Датчика hotspot (junction) нет в NVML, поэтому на NVIDIA он отсутствует.

Последняя ошибка XID не сообщается: у NVML нет API, а журнал ядра требует root.

--no-nvml не открывает NVML, для драйвера, чей NVML ведёт себя неправильно: все показания отсутствуют (null на /api/v1/devices и /stats).

Стартовая строка gpu тогда говорит sensors off (--no-nvml): no thermal cut-off вместо порогов, и майнинг продолжается.

Vulkan и Metal датчиков не сообщают.

Термическая отсечка #

У каждого датчика свой предел:

0 отключает отсечку этого датчика.

Датчик должен держаться на пределе или выше --temp-hold секунд (15), прежде чем карта встанет на паузу; падение ниже начинает отсчёт заново.

Карта заканчивает свой поиск, затем простаивает, датчик и показание в строке (Paused (mem 106 °C)).

Она возобновляет работу, когда каждый державший её датчик остынет ниже своей точки возобновления: ядро до --temp-resume (75), память и hotspot до предела минус --temp-hysteresis (10).

Датчик, переставший отвечать, пока держит карту, продолжает её держать.

Пишется один раз при паузе (E306: датчик, показание, предел, точка возобновления) и один раз при возобновлении.

temp_high срабатывает после десяти секунд паузы, temp_critical после десяти минут или при 10 °C выше предела.

--temp-limit и --temp-resume принимают одно значение на карту.

--temp-shutdown это последнее средство, по умолчанию выключено.

Карта на паузе, чьё ядро держится на нём или выше --temp-hold секунд, отсчитанных от этой паузы, останавливает майнер: код выхода 11, E319 в журнале, событие temp_critical.

Под супервизором майнер перезапускается после своей задержки и сдаётся после --max-restarts, если карта всё ещё так горяча; эта карта считается уронившей майнер.

Значение должно быть выше --temp-limit: отсечка останавливает первой, отключение ловит карту, которая греется дальше на паузе (умерший вентилятор, карта, нагретая соседями).

$ fearminer -o stratum+ssl://POOL:PORT -u YOUR_WALLET --temp-limit 85 --temp-limit-mem 100 --temp-hold 20 --temp-shutdown 95
$ fearminer -o stratum+ssl://POOL:PORT -u YOUR_WALLET -d 0,1,2 --temp-limit 85,80,_ --temp-resume 70,65,_

Перед подключением #

Выполняется после аргументов, до условий комиссии, порта статистики и пула. По строке на каждое.

Индекс -d за пределами карт, которые перечисляет драйвер: E206, выход 2, до запуска любого движка.

Майнить не на чем: E301, выход 3, до любого подключения. Это все карты, исключённые через -d или проверками, или их нет вовсе, и ни одного потока CPU (-d '!0' -t 0 на риге с одной картой). Тот же список с -t 2 майнит на CPU, карта показана как Excluded.

--check-config выполняет и эти проверки устройств. --skip-preflight печатает тот же отчёт и ничего не применяет.

Факты идут из файлов драйвера и nvidia-smi (600 мс), никогда из движка. Проверка занимает заметно меньше секунды.

Счётчики сбоев #

Процесс майнинга, завершившийся из-за карты (зависание, вердикт watchdog, термическое отключение), называет её; супервизор складывает это в crashes.json в каталоге состояния.

Ключ по карте: UUID, когда драйвер его даёт, иначе PCI id, никогда индекс; карта сохраняет запись в другом слоте, новая карта в том же слоте начинает с нуля.

Запись:

• число
• последнее время
• последняя причина
• времена последних сбоев

Карту, потерянную пока майнер продолжает, считает дочерний процесс.

Строка терминальной панели показывает crashes N, как только есть хоть один.

/api/v1/devices несёт crashes по карте, /api/v1/summary restarts, счёт супервизора за этот запуск.

Обвинённая в --device-quarantine перезапусках (3) в пределах --restart-window, карта при следующем старте попадает в Quarantined.

--reset-crashes очищает файл.

Сбой после долгой стабильной работы означает слишком сильный разгон; сбой на первом поиске указывает на драйвер, райзер или слот.

Настройка #

При первом запуске майнер измеряет несколько геометрий запуска на твоей карте и кэширует лучшую в tuning.json (~/.config/fearminer на Linux и Windows, ~/Library/Caches/fearminer на macOS).

--retune измеряет заново, например после смены драйвера.

--gpu-batch это нижняя граница nonce на запуск, округляемая вверх до целых проходов настроенной геометрии карты; действующий пакет в стартовой строке CUDA device.

--throttle делает паузу между пакетами, для карты, которая должна оставаться тихой.

По умолчанию действуют измеренные значения.

Разгон #

Выключен, пока не попросят: без опции разгона майнер не трогает регистры частоты, лимита мощности и вентилятора.

Разгон, заданный снаружи (flight sheet HiveOS, Afterburner, nvidia-smi), остаётся в силе.

--no-oc делает это явным: все опции разгона и любая секция [oc] игнорируются, сказано в журнале старта.

С заданной опцией карта настраивается через NVML (NVIDIA; X-сервер не нужен, вызовы nvidia-smi -lgc, -lmc и -pl) и читается обратно после каждой установки.

Журнал, fearminer oc show и /api/v1/oc дают обратное чтение, а не то, что просили.

Установка частоты, лимита мощности или вентилятора требует root на Linux, администратора на Windows; майнер работает от обычного пользователя.

Запусти его от root с --allow-root (HiveOS так делает) или оставь разгон снаружи.

Без привилегий каждая установка это E703 с тем, что делать, и майнинг продолжается на текущих частотах карты.

AMD и Intel в этой версии не управляются.

Шесть опций со значениями: --cclock, --lock-cclock, --mclock, --lock-mclock, --pl, --fan.

Каждая принимает одно значение для всех карт или по одному на карту в порядке -d с грамматикой списка --temp-limit (_ не трогает эту карту).

Настройки доходят до карты в безопасном порядке:

• лимит мощности и вентилятор
• затем память
• затем ядро, придержанное под --oc-delay для ригов, падающих, когда смещение ложится на холодную карту

По строке на установку; по строке на отказ, с кодом и собственными границами или ступенями карты (E701 до E705).

Отклонённая настройка не трогает остальные.

Каждое изменение открывает шаг; через десять минут сводка даёт среднюю скорость за окно и принятые, отклонённые и невалидные шары с момента изменения.

$ fearminer -o stratum+ssl://POOL:PORT -u YOUR_WALLET --lock-cclock 1500 --mclock 800 --pl 220
$ fearminer -o stratum+ssl://POOL:PORT -u YOUR_WALLET -d 0,1,2 --cclock 100,_,-50 --pl 80% --fan 70% --oc-delay 20
oc       GPU0: applied pl 176 W, mem +800; reads core 1900 MHz (+0), mem 10251 MHz (+800), pl 176 W, fan 40 %
OC step: GPU0 core +100, mem +800, pl 220 W -> hashrate over the next 10 min and rejects/invalids
$ fearminer oc show
$ fearminer oc reset
$ fearminer oc reset --defaults -d 0

Перед первой установкой обратное чтение каждой карты (смещения, лимит мощности, режим и скорость вентилятора, частоты) идёт в oc-restore.json в каталоге состояния, с ключом UUID: значения на момент запуска, а не заводские.

E706, если записать не удаётся, и ничего не применяется.

Возвращаются:

• при чистой остановке
• супервизором после падения или убийства процесса майнинга (до перезапуска)
• командой fearminer oc reset после запуска, убитого без очистки

Каждая строка восстановления несёт причину (E708).

У драйвера нет обратного чтения фиксации, поэтому фиксация майнера сбрасывается к значению драйвера по умолчанию, снимая заодно фиксацию, установленную снаружи до старта.

Смещения, лимит мощности и вентилятор возвращаются к своему обратному чтению.

Обе принимают -d.

В файле каждая опция это ключ [oc] и переменная FEARMINER_<OPTION>.

Наборы по алгоритмам идут в [oc.quantus], [oc.randomx]..., применяются при старте для майнимого алгоритма, поверх [oc] и ниже окружения и командной строки.

--dry-run печатает наборы и итоговую политику как oc:.

[oc]
pl = "80%"
oc_delay = 20

[oc.quantus]
lock_cclock = 1500
mclock = 800

POST /api/v1/oc, единственная запись API: набор на одной карте сразу, без задержки, с обратным чтением и записью для восстановления, как у опций.

Ей нужен токен откуда угодно, включая эту машину.

--oc-script PATH запускает твою программу один раз на карту перед началом майнинга, с картой в её окружении.

Каждый движок, которым майнит запуск, отвечает на свои векторы с известными ответами до первой шары.

Каждое решение, которое отдаёт карта, пересчитывается на CPU до отправки.

Карта, считающая неверно, находится на старте, а не после дня отклонённых шар.

Та, что начала считать неверно, находится на первом неверном решении, которого пул никогда не видит.

Запись, и когда тест пропускается #

selftest.json в каталоге состояния держит по записи на движок:

Старт пропускает тест движка и говорит об этом (selftest cuda: passed on <date> ...; skipped), когда запись показывает прохождение на:

• том же бинарнике и той же версии движка
• том же драйвере
• тех же картах в том же порядке
• той же конфигурации движка
• при не меньшем числе nonce

Тест выполняется снова при новом бинарнике, обновлении драйвера, карте добавленной, убранной или переставленной, изменённом параметре, большем числе nonce или записанном провале.

--self-test при майнинге принудительно выполняет его на старте.

Отдельно, без пула и кошелька, --self-test выполняется офлайн для алгоритма из -a (--self-test=randomx для другого, --self-test=all для всех алгоритмов сборки).

Он печатает по строке на устройство и движок, записывает вердикт и выходит с 0, или с 3, когда устройство провалилось.

Проверенные шары #

Решение GPU пересчитывается на CPU эталоном алгоритма до отправки: каждое, пока проверка укладывается в свой бюджет, и одно из десяти после него (ниже).

Для Quantus: хэш Poseidon2 заголовка и 64-байтного nonce против цели, около 6 мкс на настольном ядре.

Отвергнутое решение никогда не отправляется: отброшено и записано под E507 с картой и подсказкой о разгоне (первый поиск: майнер или драйвер; после долгой стабильной работы: скорее всего разгон).

Где это видно:

Счёт собственный майнера, не пула.

CUDA и Metal уже перепроверяют кандидатов внутри крейта ядер.

Vulkan отдаёт хэш своего ядра, и проверка хоста для него единственная.

Решения CPU не перепроверяются: нашедший их движок и есть эталон.

Каждое решение проверяется, пока проверка стоит меньше 1 % ядра в текущей секунде, и одно из десяти сверх того.

Этот бюджет это 10 мс, то есть 1 600 решений в секунду при 6 мкс, а пул даёт ригу самое большее одно в несколько секунд.

--verify-shares off (FEARMINER_VERIFY_SHARES=off) её выключает: неверное решение тогда отправляется и считается пулом как отклонённое.

Запущенный для майнинга, fearminer это супервизор плюс дочерний процесс майнинга, перезапускаемый с теми же аргументами.

Супервизор не держит контекст GPU и переживает всё, что драйвер делает с дочерним процессом.

Терминальная панель и простой журнал принадлежат дочернему процессу, без изменений.

Супервизор печатает только свои события с префиксом supervisor: и дописывает их в watchdog.log.

Watchdog #

• Одна запись на воркер GPU, оценка дважды в секунду, плюс собственные вердикты сессии.
• Каждый вердикт пишется в журнал с кодом и причиной и добавляется в watchdog.log.
• Каждое правило само по себе выключается при 0.
• Карта на паузе или в карантине не судится.
• Часы карты (льготный период, окна шар, десятиминутное среднее) начинаются заново при термическом возобновлении и при переподключении сессии.
• Правила уровня сессии (--max-rejects, --max-no-submit-responses, --no-share-timeout) действуют и на риге только с CPU.

$ fearminer -o stratum+ssl://POOL:PORT -u YOUR_WALLET --hashrate-min 60% --hashrate-grace 600 --share-famine 8 --max-rejects-device 3
$ fearminer -o stratum+ssl://POOL:PORT -u YOUR_WALLET --hashrate-reference 600M,350M --hashrate-max 1.2G --device-quarantine 2

--on-failure #

exit (по умолчанию) или script:<path>: скрипт выполняется первым, с кодом выхода, причиной и числом перезапусков в его окружении, затем супервизор выходит с 12. Там можно перезапустить райзер по питанию или позвать кого-то.

$ fearminer -o stratum+ssl://POOL:PORT -u YOUR_WALLET --max-restarts 5 --restart-window 30 --on-failure script:/opt/fearminer/on-failure.sh
# on-failure.sh: FEARMINER_EXIT_CODE, FEARMINER_CAUSE, FEARMINER_RESTARTS в его окружении

--no-supervisor · --no-watchdog #

Бенчмарк, --list-devices, --self-test и остальные одноразовые запуски всегда один процесс.

Супервизор (или одиночный процесс) берёт консультативную блокировку на fearminer.lock в каталоге состояния. Второй экземпляр выходит с 4 (E210).

ОС снимает блокировку всегда, когда держатель умирает, так что устаревшая блокировка не мешает следующему старту.

watchdog.log #

Собственный журнал супервизора в каталоге состояния (~/.cache/fearminer), не больше 256 KB: каждый перезапуск с меткой времени и причиной, каждый отказ. Журнал дочернего процесса идёт в консоль и, с --log-file, в названный тобой файл.

TOML-файл, по ключу на опцию: третий способ настроить майнер, помимо командной строки и окружения.

config example печатает полный файл.

--dry-run показывает, что из него выходит и запустился бы майнер; --check-config даёт один вердикт.

Где он ищется #

Читается первый существующий; --config "" не читает ничего. Майнер никогда его не пишет, и он лежит далеко от каталога состояния.

Ошибка никогда не оставляет опцию молча на значении по умолчанию.

В чат Telegram, канал Discord, твой собственный webhook или во все три.

Токен бота, токены webhook и секрет никогда не попадают в журнал.

События #

Что сдерживает шум #

• --notify-min-severity (по умолчанию warning) это планка, ниже которой ничего не отправляется.
• Ожидает, когда появляется, срабатывает, продержавшись свою задержку подтверждения: hashrate_low 120 с, gpu_down 30 с, temp_high 10 с, pool_disconnected 60 с; остальные немедленно. Пул, вернувшийся за тридцать секунд, не упоминается вовсе.
• Сработавшее условие повторяется не чаще раза в четыре часа и закрывается сообщением, когда проходит: hashrate_low через hashrate_recovered, pool_disconnected и pool_failover через pool_recovered, temp_high возобновлением, gpu_down тем, что карта снова майнит.
• rig_down покрывает gpu_down, который покрывает hashrate_low, как и pool_disconnected: покрытое оповещение не отправляется, и его закрытие тоже.
• То, что набралось за тридцать секунд, уходит одной группой, по сообщению на чат; критическое событие не ждёт. Журнал показывает alert firing: ... и alert resolved: ... для отправленного. /stats считает alerts_firing и notifications_sent.

Webhook #

Один POST на уведомление: Content-Type application/json, User-Agent fearminer/<version>, X-FearMiner-Event с именем события и, с --notify-secret, X-FearMiner-Signature, HMAC-SHA256 тела этим секретом. Тело, формат версии 1:

POST твой URL
Content-Type: application/json
User-Agent: fearminer/1.15.2
X-FearMiner-Event: gpu_down
X-FearMiner-Signature: sha256=<hex>

{
  "version": 1,
  "event": "gpu_down",
  "severity": "error",
  "status": "firing",
  "rig": "rig1",
  "ts": "2026-09-22T10:00:00.000Z",
  "fingerprint": "gpu_down/rig1/0",
  "labels": {"rig": "rig1", "device": "0", "pci": "0000:41:00.0", "device_name": "NVIDIA GeForce RTX 3090", "pool": "stratum+ssl://pool.example.com:3335"},
  "annotations": {"cause": "..."},
  "summary": "GPU0 lost (reported by the driver)",
  "details": ""
}

Telegram получает sendMessage простым текстом (без Markdown), Discord content с тем же текстом, по сообщению на группу.

Heartbeat #

Сервис без них (push URL Uptime Kuma со своей строкой запроса) работает с простым URL; его /start и /fail получают 404.

Сбои пишутся на уровне debug, не чаще одного предупреждения в десять минут.

Пинг: таймаут 10 с, майнинг никогда не блокируется.

Под супервизором события и heartbeat шлёт процесс майнинга; супервизор шлёт watchdog_restart и, сдаваясь, rig_down, с теми же настройками.

GET  https://hc-ping.com/UUID          каждые 60 с
GET  https://hc-ping.com/UUID/start    при старте
GET  https://hc-ping.com/UUID/fail     при критическом событии
POST {"rig","hashrate_hs","hashrate_effective_hs","shares_accepted","shares_rejected","uptime_secs","restarts","alerts_firing"}   --heartbeat-post

Версионированный API рядом с /stats, на 127.0.0.1:4300 по умолчанию: чтение и три записи.

Каждый объект под /api/v1 несёт api_version (1), версию пути.

Сервер работает до загрузки условий и до первого подключения (нули и null до тех пор, mode уже задан) и остаётся доступным через переподключения и раунды комиссии.

$ curl -s http://127.0.0.1:4300/api/v1/summary | jq .hashrate
$ curl -s -H "Authorization: Bearer $(fearminer token show)" http://rig:4300/api/v1/devices
$ curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:4300/readyz
$ fearminer token rotate
$ curl -s -X POST -H "Authorization: Bearer $(fearminer token show)" -H 'Content-Type: application/json' -d '{"device": 0, "power_limit": "80%"}' http://127.0.0.1:4300/api/v1/oc
$ curl -s -X POST -H "Authorization: Bearer $(fearminer token show)" -H 'Content-Type: application/json' -d '{"command": "pause"}' http://127.0.0.1:4300/api/v1/commands
$ curl -s -X PUT -H "Authorization: Bearer $(fearminer token show)" http://127.0.0.1:4300/api/v1/config

Под HiveOS порт статистики закреплён на 127.0.0.1:4300, где h-stats.sh читает /hive-stats. На хосте, доступном из недоверенных сетей, закрой порт файрволом, прежде чем открывать его через --api-bind.

mode это mining или monitoring. effective_hs и effective_pct это null при менее чем десяти принятых шарах в окне. efficiency_kh_per_w это null без показаний мощности. time_to_first_share_s это null до первой принятой шары. Полная схема каждого объекта: /openapi.json.

Датчик, которого карта или драйвер не дают, это null; с --no-nvml все датчики null.

Команды и перечитывание конфигурации работают на запущенном майнере, без перезапуска. Четыре входа: локальный API, терминальная панель, сигнал, файл в каталоге состояния. Ничто отсюда не выходит за пределы машины.

Четыре способа послать команду #

• POST /api/v1/commands, с токеном откуда угодно, включая эту машину (Используй локальный API).
• Терминальная панель: p придерживает весь риг и отпускает его снова, 1..9 по одной карте каждая (1 это GPU0).
• SIGUSR1 переключает паузу рига, по одному на сигнал. Посылается на pid, который знает менеджер служб, то есть супервизору, а тот передаёт его процессу майнинга.
• Файлы-сигналы, токен и право сигналить не нужны: <state dir>/stop, /pause и /resume. Майнер потребляет каждый, то есть удаляет его, в течение секунды. Тот же файл, записанный снова, это та же команда снова. Файл, который не удаётся удалить, это E137, и он не исполняется.

$ curl -s -X POST -H "Authorization: Bearer $(fearminer token show)" -H 'Content-Type: application/json' -d '{"command": "pause", "devices": [0]}' http://127.0.0.1:4300/api/v1/commands
$ kill -USR1 $(pgrep -o fearminer)
$ touch ~/.cache/fearminer/pause
command  pause from file: the rig paused
command  stop from api refused: E217 command not allowed: stop needs --unrestricted-api operate

Каждая команда попадает в журнал с источником (api, tui, signal, file) и результатом, отклонена или нет.

Горячее перечитывание #

SIGHUP, файл под наблюдением --watch-config и PUT /api/v1/config делают одно и то же.

• Конфигурация перечитывается из файла, затем из окружения, затем из командной строки, за которой остаётся последнее слово, как при старте.
• Проверяется целиком, прежде чем что-либо применено.
• Применяются перечитываемые ключи.
• Печатается, что изменилось, кошелёк первым.

$ fearminer -o stratum+ssl://POOL:PORT -u YOUR_WALLET --watch-config --log-file fearminer.log
$ kill -HUP $(pgrep -o fearminer)
$ curl -s -X PUT -H "Authorization: Bearer $(fearminer token show)" -H 'Content-Type: application/json' -d '{"set": {"temp_limit": "85"}}' http://127.0.0.1:4300/api/v1/config
reload   SIGHUP: 2 key(s) changed: temp_limit 90 -> 85 · url stratum+ssl://A -> stratum+ssl://B
reload   1 key(s) held from the API, over the file: temp_limit (write one as null to hand it back)
E219 the change needs a restart: algo (quantus -> randomx) is kept, the rest is applied

GET /api/v1/config отдаёт reloadable[] и restart_required[]; fearminer --help их печатает.

Вместе исчерпывающи: каждый ключ, который принимает файл конфигурации, ровно в одном из них.

• Перечитывание, меняющее список пулов, завершает сессию в эфире чисто, на следующем полусекундном круге.
• Ничего в полёте, ничего не числится за пулом.
• Следующая открывается на новом основном пуле, в том же процессе.
• Ключ, записанный через set, продолжает побеждать файл при каждом следующем перечитывании.
• Каждое перечитывание называет удерживаемые ключи, в журнале и в held[].
• Запись такого ключа как null возвращает его файлу, и уровень для этого не нужен.

Хуки #

--hook <EVENT>:<PATH>, повторяемая или через запятую, запускает локальную программу по событию.

• Программа запускается напрямую, никогда через shell.
• Ей даётся 30 с, затем она убивается.
• Её код выхода идёт в журнал, E139, если он не ноль.
• Что бы хук ни ответил, майнинг продолжается.

Контекст приходит в окружении, никогда в командной строке: FEARMINER_EVENT всегда, затем поля, которые есть у события.

• FEARMINER_DEVICE
• FEARMINER_PCI_BUS
• FEARMINER_UUID
• FEARMINER_ALGO
• FEARMINER_POOL
• FEARMINER_CODE
• FEARMINER_SUMMARY

Поля, которого у события нет, нет вовсе, а не пустое, так что скрипт отличает нет карты от карты 0.

Четыре переменные устройства пишутся так же, как их пишет --oc-script.

$ fearminer -o stratum+ssl://POOL:PORT -u YOUR_WALLET --hook temp-high:/opt/rig/hot.sh --hook device-lost:/opt/rig/lost.sh
# hot.sh: FEARMINER_EVENT, FEARMINER_DEVICE, FEARMINER_PCI_BUS, FEARMINER_UUID, FEARMINER_ALGO, FEARMINER_POOL, FEARMINER_CODE, FEARMINER_SUMMARY
E139 hook script failed: temp-high /opt/rig/hot.sh exited 1 after 0.4 s

• --check-config проверяет форму значения и больше ничего.
• Путь проверяется, когда событие происходит, так что --hook temp-high:/nonexistent проходит и становится E139 при первом же перегреве рига.
• E221 (плохой хук) это само значение, <EVENT>:<PATH>, где event существует.

--background · --priority #

Вызвавший shell свободен; закрытие терминала не уносит ни один из процессов.

Задай вместе с этим --log-file, иначе журнал уходит в никуда и прочитать риг можно только через API.

Выше 2 требует привилегии на Linux; при отказе ОС: E613, и майнер остаётся с обычным приоритетом.

Каждый риг хранит собственную историю, в своём каталоге состояния: ни сервера, ни базы данных, настраивать нечего.

Она отвечает офлайн; дашборд читает те же данные по API.

Последние 24 часа держатся в памяти и раз в минуту пишутся в <state dir>/history.bin: перезапуск или kill -9 их не теряет.

На диске те же выборки сворачиваются по мере закрытия каждого окна.

GET /api/v1/history #

Те же данные на порту API, запрос в URL: токен с другой машины, как и везде под /api/v1.

$ curl -s 'http://127.0.0.1:4300/api/v1/history?from=-24h&step=5m&metric=hashrate_hs'
{"api_version": 1, "from_ms": 1789689600000, "to_ms": 1789776000000, "step_s": 300, "layer": "minute", "device": null,
 "clock": {"drift_ms": 12, "gaps": 0, "samples": 288},
 "t_ms": [1789689600000, 1789689900000, ...],
 "series": [{"metric": "hashrate_hs", "unit": "H/s", "aggregate": "avg", "values": [611900000, 612400000, null, ...]}]}

Интервал без выборок это null, а не ноль.

Каждая выборка несёт монотонные часы рига и его настенные часы; интервал между двумя это большая из двух разниц.

Перевод часов назад по NTP никогда не делает интервал отрицательным; машина, проспавшая два часа, показывает этот разрыв.

Уход настенных часов: clock.drift_ms и отдельная метрика clock_drift_ms.

history.bin #

Заголовок в 64 байта, затем по одному кольцу фиксированного размера на слой. В заголовке:

• FEARHIST, магия
• версия формата
• версия схемы выборки
• размер записи
• число полей
• число слотов устройств
• ёмкость и шаг каждого слоя
• CRC-32

Запись: двое часов, интервал, значения f32, CRC-32.

Записи минуты уходят одной записью на слой, на собственное место слоя в файле; больше ничто не двигается.

Файл никогда не растёт и никогда не переписывается: самая старая выборка перезаписывается, по одному слоту за раз.

Ничто из этого не мешает майнеру стартовать.

Читатель другой сборки или другого языка остаётся совместимым, если:

• проверяет магию
• берёт число полей и размер записи из заголовка, а не зашитые в код
• берёт меньшее из того, что знает сам, и того, что говорит файл
• перешагивает остальное по размеру записи

Поля только добавляются, их никогда не переставляют, не переименовывают и не удаляют.

Терминальная панель это полноэкранная панель: хэшрейт, спарклайн, лента шар, строка на каждую карту, журнал.

--no-tui печатает те же записи простым прокручиваемым журналом, для службы или майнинг-ОС.

--log-file хранит их в файле, в любом режиме.

Первая минута #

До подключения майнер печатает, куда идёт хэш и на чём он работает: простой журнал (--no-tui) показывает строки ниже, терминальная панель то же в шапке и в строках устройств.

fearminer 1.15.2 (a1b2c3d4e, 2026-09-22)
wallet   qzjd5MS1GSCpXLYp8DjZASifnkgtUpx5WwhmEzW3ppHdDe3uq (checksum ok)
worker   rig1
pool     stratum+ssl://pool.example.com:3335 (primary)
pool     stratum+tcp://backup.example.com:3333 (backup 2/2)
custody  pool (the pool pays the wallet)
algo     quantus
fee      2.00% of the mining time to the fee pool
build    1.15.2 (a1b2c3d4e, 2026-09-22)  sha256 3a3524b62caa8307
egress   stratum+ssl://pool.example.com:3335 · fee pool (one-minute rounds) · cfg.fearminer.com (terms, every 20 min) · telemetry.fearminer.com (telemetry every 15 min: event, install id, format, version, system, mining, hardware, hashrate bucket, features, uptime bucket, errors, pool host; fearminer telemetry show, fearminer.com/telemetry) · download.fearminer.com (engines, hourly)
driver   NVIDIA 570.86, libcuda.so.1 and libnvidia-ml.so.1 present
gpu #0   NVIDIA GeForce RTX 4070 Ti [0000:01:00.0]: compute 8.9, 11470 MB free of 12282
ram      64.0 GB
host     bare metal, kernel lockdown none, Secure Boot off
network  dns system · ip any
dns      pool.example.com → 203.0.113.10 (system resolver)
cpu      off on 32 threads, 1 GPU (-t N turns it on)
connected to stratum+ssl://pool.example.com:3335 (203.0.113.10:3335)
fee      window: 2.00 % of the time, first round in about 49 min
job 9dd830e6 diff 18.25G
first share accepted after 12.3 s
fee round started (1 min)
fee round ended: 2 share(s)

wallet

Адрес, проверенный по сети (checksum ok), или UNCHECKED с --ignore-wallet-check. Воркер дописан к нему: ты видишь то, что видит пул.

pool

Пулы как заданы в -o: первый главный, остальные резерв по порядку. Кошелёк без пула отклоняется ещё до этой строки (E224).

custody · fee

custody: кто платит кошельку (пул). fee: ставка для этого алгоритма, добываемая минутными раундами на отдельном соединении, 2 % на Quantus, 0,85 % на RandomX, 1 % на Pearl, 2 % на TensorCash (её майнит его движок на том же пуле), ничего, когда подписанные условия не называют для него пул комиссии.

build · egress

build: версия и первые шестнадцать hex-цифр SHA-256 запущенного бинарника. egress: каждый хост, с которым майнер будет говорить, других нет; telemetry.fearminer.com указан с периодичностью, группами отправляемых полей и тем, где их посмотреть (с --no-telemetry на его месте стоит no telemetry (--no-telemetry)).

driver · gpu · ram · host · network · dns · cpu

Предстартовая проверка охватывает: драйвер NVIDIA и его библиотеки; compute capability и свободную память каждой карты против нужд алгоритма; системную память; хост (голое железо или VM, kernel lockdown, Secure Boot). Затем как достигаются пулы (прокси или режим DNS, семейства адресов, доверие при первом контакте), во что разрешается имя каждого пула и кто ответил. Карта, не прошедшая проверку, помечается Excluded с её кодом; остальные майнят. cpu: потоки CPU, майнящие рядом с ними, выключены на риге с GPU, если нет -t N, по одному на физическое ядро на RandomX. Число сверх того, что машина может отдать (все потоки кроме двух и по одному на карту), урезается до него, и строка говорит об этом.

fee window · fee round

Когда движки подняты, fee window даёт ставку как долю времени и когда наступит первый раунд. Каждый раунд пишет fee round started (1 min) и fee round ended: N share(s). Ни одна строка не называет пул комиссии. Алгоритм, для которого условия не называют пул комиссии, говорит об этом один раз и майнится бесплатно.

first share

Перед первой шарой каждый движок отвечает на свой тест с известными ответами (Проверь корректность и измерь скорость); запуск на том же бинарнике, драйвере и картах пропускает его и говорит об этом. Первый запуск также измеряет несколько геометрий запуска на твоей карте и кэширует лучшую (--retune измеряет заново). Затем первая задача, затем первая принятая шара, названная один раз с её задержкой, /stats несёт её как time_to_first_share_s. При шаре в минуту эффективный хэшрейт что-то значит через десять минут.

Терминальная панель: плывущий хэшрейт, спарклайн с минимумом, средним и максимумом, лента шар, строка на каждую карту (состояние, температура, вентилятор, мощность, acc/rej, время с последней шары) и журнал. Клавиши:

Простой журнал #

--no-tui печатает по строке на запись: принятые (✔) и отклонённые (✘) шары с картой, сложностью и временем ответа, новые задачи, подключения, вердикты с их кодом.

Раз в минуту строка несёт три хэшрейта, каждый с именем своего окна, затем эффективный:

• мгновенную скорость
• десятиминутное среднее
• среднее за сессию: все хэши с начала на аптайм
• то, что засчитывает пул, с его долей от локального

Строка приходит при любой скорости, по часам процесса: при нуле она называет карту на паузе, как ниже.

--no-color убирает цвет, -v добавляет записи debug.

19:12:14 ✔ 5/6 · GPU0 · 18.25G · 24 ms
19:12:21 hashrate 588.5 MH/s (10m 587.9, session 586.2, eff 580.2 / 98 %)
19:13:21 hashrate 0.0 H/s (10m -, session -, eff -) - GPU0 Paused (mem 106 °C) - shares 3/3 - diff 1.60M

Файл журнала и его ротация #

--log-file PATH пишет каждую запись майнера, в режиме панели или простом, по строке на запись: 2026-09-20T19:33:49.788Z INFO message (UTC, миллисекунды, без цвета), пароль пула заменён на ***.

Дописывается, никогда не обрезается. Ротируется по размеру в PATH.1 ... PATH.N.

Неудавшаяся ротация сообщается в консоль, и майнер продолжает писать.

$ fearminer -o stratum+ssl://POOL:PORT -u YOUR_WALLET --log-file fearminer.log --log-level-file debug --log-max-size 10 --log-keep 5
2026-09-20T19:33:49.788Z INFO  connected to stratum+ssl://pool.example.com:3335 (203.0.113.10:3335)

Каждая строка сбоя несёт код и сообщение, больше ничего.

fearminer explain <CODE> печатает причину, последствия и что делать, офлайн.

Выпущенный номер никогда не используется повторно.

FearMiner проверяет кошелёк до первого пакета, при каждом старте говорит, куда идёт хэш, предупреждает, когда он изменился, отказывается от привилегий, которые ему не нужны, и перечисляет каждый хост, с которым говорит.

Проверка кошелька и предупреждение о его смене #

Проверяется до того, как майнер куда-либо подключится.

• Кошелёк это часть -u до .worker.
• Суффикс +diff и префикс solo: проверку не проходят и уходят как набраны.
• Адрес, который не декодируется, или адрес другой сети: отклоняется с причиной, код выхода 2, подключения нет, между сетями ничего не угадывается.
• --ignore-wallet-check отправляет его как набран, предупреждает при старте (E402), помечает баннер UNCHECKED.

Кошелёк также запоминается по хосту пула: хэш хоста и кошелька в wallets.json в каталоге состояния, никогда в открытом виде, после первой принятой шары сессии.

Если файл знает другой кошелёк для этого хоста, следующий старт:

• печатает WARN wallet changed since the last session on <host> (was <date>)
• показывает wallet changed в шапке
• ставит wallet_changed в /stats и API
• отправляет критическое оповещение wallet_changed
• продолжает майнить

Предупреждение возвращается при каждом старте, пока новый кошелёк не заработает шару.

Root и пароли #

• На Linux и macOS майнер, запущенный от root, выходит с 3.
• --allow-root запускает его всё равно; пакет HiveOS передаёт эту опцию.
• Юнит systemd запускает майнер под отдельным пользователем.
• Супервизор проверяет один раз, до порождения процесса майнинга; на Windows проверки нет.

• Настоящий пароль пула в -p или FEARMINER_PASS (всё, кроме принятого x) виден в списке процессов, и майнер говорит об этом один раз при старте.
• --pass-file читает его из файла, по строке на пул; процесс майнинга видит путь, а не пароль.
• О файле, доступном на чтение другим пользователям, предупреждается.
• В файле журнала и в /api/v1/config пароль это ***.

Твики MSR и резервирование huge pages, для которых RandomX нужен root, идут через fearminer-helper (Алгоритмы, комиссии и требования).

• отдельный проверенный бинарник, без сети и без конфигурации
• достигаемый через sudo -n до первого подключения и никогда после
• майнер, запущенный от root, делает это внутри процесса, без помощника

Установка частоты, лимита мощности или вентилятора требует, чтобы сам майнер был root (--allow-root), либо разгон остаётся снаружи.

Проверить загрузку #

Каждый релиз несёт SHA256SUMS по своим файлам и SHA256SUMS.minisig, его подпись minisign ключом релиза.

У fearminer verify ключ зашит, и он проверяет, по строке на файл:

• подпись офлайн (Ed25519)
• SHA-256 каждого файла из списка, лежащего в том же каталоге

Выход 0 только когда подпись верна и каждый имеющийся файл совпал.

Всё остальное печатает verification FAILED; do not run this download.

Если дать архив, он ищет SHA256SUMS рядом.

minisign и sha256sum делают то же вручную.

Ключ меняется только с релизом, который об этом объявляет.

$ fearminer verify SHA256SUMS
$ fearminer verify fearminer-linux-x86_64.tar.gz
$ minisign -Vm SHA256SUMS -P RWQR3owV+nRhfgNJeUBqcRK868S52NFG2BOrIzKpkQ5ey6lCEfM9+3Eg
$ sha256sum -c SHA256SUMS --ignore-missing
PS> .\fearminer.exe verify SHA256SUMS
PS> Get-FileHash .\fearminer-windows-x86_64.zip -Algorithm SHA256

Суммы покрывают и sbom.cdx.json, спецификацию CycloneDX бинарника: каждый компонент внутри с его версией, для сверки с базами уязвимостей.

Бинарники Linux и Windows несут список зависимостей в секции, которую читает cargo audit bin.

Каждый архив несёт THIRD-PARTY-NOTICES.txt, лицензии открытых компонентов внутри.

Почему бинарники не подписаны #

Бинарники пока не подписаны, поэтому Windows и macOS останавливают их при первом запуске; антивирусы относят любой майнер к HackTool или CoinMiner. Первое говорит, что издатель неизвестен, второе, что программа майнит.

Сначала проверьте загрузку. Каждый релиз несёт SHA256SUMS по своим файлам и SHA256SUMS.minisig, его подпись minisign ключом релиза. У fearminer verify этот ключ зашит: подпись офлайн, затем SHA-256 каждого названного в суммах файла в том же каталоге; выход 0 только когда всё совпало. minisign проверяет ту же подпись опубликованным ключом. sha256sum, или Get-FileHash в PowerShell, сравнивает хеш вручную с суммами со страницы релиза.

При удачной проверке ok печатается по каждому скачанному файлу, а по тем файлам релиза, которых ты не брал, MISSING: выход всё равно 0. Ошибкой считается только неверная подпись или MISMATCH, и тогда verification FAILED; do not run this download: удали, скачай заново. После этого дальше говорит операционная система про отсутствующую подпись, а не про сам файл.

Подпись в планах, без даты: сертификат Authenticode и учётная запись разработчика Apple это ежегодный счёт. А пока значение имеет подпись на SHA256SUMS, которую ты можешь проверить сами и офлайн.

Что он пишет на диск #

Каждый архив распаковывается в папку с именем архива.

Что видит ретранслятор #

Опция или команда, которая отвечает. Когда строка журнала несёт код, первым отвечает fearminer explain <CODE>.

# /etc/systemd/system/fearminer.service
[Unit]
Description=FearMiner
After=network-online.target

[Service]
User=fearminer
StateDirectory=fearminer
WorkingDirectory=/var/lib/fearminer
Environment=HOME=/var/lib/fearminer FEARMINER_NO_TUI=1
EnvironmentFile=/etc/default/fearminer
ExecStart=/usr/local/bin/fearminer
Restart=always
RestartSec=2s
RestartPreventExitStatus=2 3 4 12
TimeoutStopSec=30s
KillSignal=SIGINT

[Install]
WantedBy=multi-user.target

Юнит оставляет перезапуски супервизору майнера и позволяет systemd перезапустить всё целиком, только когда тот сдался; окончательные коды не трогаются. FEARMINER_NO_SUPERVISOR=1 в файле окружения отдаёт все перезапуски systemd.

Опция, значение, значение по умолчанию, переменная окружения, что делает.

Каждую опцию можно задать и из окружения как FEARMINER_<OPTION>, и в файле конфигурации под её длинным именем с подчёркиваниями (--temp-limit это temp_limit; --1gb-pages это huge_pages_1g).

Командная строка имеет приоритет над обоими.