Установка
Здесь описано, как поставить референсный клиент майнера aetron-miner на машину и провести его через первый запуск. Это механическая сторона майнинга: требования, установка, настройка и первая проверка здоровья. О том, что такое майнинг и как работают награды, читайте в статье Майнинг в AETRON, а о выборе Нейронета и входе в него - в статье С чего начать.
Из чего состоит клиент
aetron-miner поставляется как два взаимодействующих процесса:
- Демон. Фоновый процесс на Rust, который держит вашу личность и хранилище ключей, общается с цепью, слушает задания и дирижирует всем остальным. И CLI, и десктопный GUI - тонкие оболочки над одним и тем же демоном, общающиеся с ним через локальный сокет.
- Раннер. Вычислительная часть, которая грузит модель, выполняет шаги инференса и обучения и производит артефакты проверки, которые сравнивает Proof of Intelligence. В релизной сборке это скомпилированный нативный бинарь, а не дерево исходников на Python, и демон проверяет его подпись перед запуском.
Раннер поставляется slim: в нём лежит собственный код AETRON, но не ML-стек. PyTorch и остальное живут в отдельном окружении, которое клиент разворачивает сам:
aetron-miner env install
Эта команда подбирает профиль по вашему железу (версия CUDA, Apple Silicon или CPU), скачивает зафиксированный набор колёс, собирает окружение рядом с существующим, прогоняет самотест и только потом переключается на него. aetron-miner env rollback возвращает предыдущее. Ни pip, ни python вы не вызываете, и версии выбирать не вам: пины вкомпилированы в раннер, и он отказывается стартовать против окружения, которое им не соответствует, потому что другая сборка PyTorch даёт другие числа, а другие числа не проходят проверку.
Такое разделение держит загрузку небольшой и позволяет одному раннеру покрывать железо, которое единый замороженный бандл покрыть не мог; случай Blackwell как раз и заставил это сделать.
Референсный клиент не единственный путь
aetron-miner - референсная реализация, а не обязательная. Протокол открыт, и клиент, написанный независимо по публичной документации протокола, является полноценным участником. Проверке безразлично, какой софт произвёл результат. Она проверяет сам результат против канонической спецификации исполнения задачи, поэтому свой клиент, выдающий корректные воспроизводимые артефакты, зарабатывает ровно столько же, сколько референсный.
Референсный клиент даёт удобство: работа с личностью, оркестрация заданий, реализация Pulse, управление кэшем моделей и подключённые обязанности проверяющего. Свой клиент означает переписывание всего этого поверх поверхности протокола, и это разумный размен, если у вас своя специфичная инфраструктура.
Железо
Майнинг не привязан к одному производителю GPU. Конструкция проверки поддерживает смешанное железо, а сравнение идёт либо побитово внутри одного класса, либо в откалиброванном допуске между классами. Как это работает, описано в статье Гетерогенный майнинг. На практике референсный раннер гоняли на GPU NVIDIA с CUDA, на Apple Silicon через MPS и на обычном CPU.
Уровень Pulse определяется памятью. Раннер определяет доступную память на старте и на каждом цикле и назначает уровень автоматически. Выбирать его вы не можете:
| Уровень | Обнаруженная память | Таблица памяти Pulse |
|---|---|---|
| Phone | от 2 ГБ | 256 МБ |
| Low | от 4 ГБ | 1 ГБ |
| Standard | от 8 ГБ | 4 ГБ |
| High | от 16 ГБ | 8 ГБ |
| Datacenter | от 32 ГБ | 16 ГБ |
Ниже 2 ГБ раннер стартовать отказывается. Более высокий уровень строит бо́льшую таблицу памяти и заявляет больше сэмплов за окно Pulse, и именно это делает доказательство memory-hard, а не тем, что маленькое специализированное устройство может подделать.
Уровень задаёт пол, а не гарантию заработка. Связывающее требование по-прежнему у Нейронета, в который вы входите: ваша машина обязана тянуть каноническую модель задачи на объявленной точности, а для большой модели это гораздо больше VRAM, чем минимум уровня.
Диск планируйте под веса моделей и датасеты, а не под сам клиент. Мастер установки предлагает мягкий потолок кэша в половину свободного места на том томе, куда вы его укажете, и кэш можно держать на отдельном диске.
Платформы
Релизная упаковка есть для Linux x86_64 (tarball плюс скрипт установки) и для macOS, включая Apple Silicon (.pkg с графическим шагом настройки). Windows нынешней упаковкой не покрыт, и часть возможностей клиента (например, определение свободного места для потолка кэша) там не реализована.
Сборки для скачивания пока не опубликованы. Пакету macOS всё ещё нужны подпись Developer ID и нотаризация, прежде чем его можно раздавать, а публичной страницы релизов нет. До тех пор запуск майнера означает сборку из исходников.
На Linux для сборки демона из исходников нужен обычный набор инструментов: build-essential и cmake. Пакеты разработки OpenSSL и protobuf не нужны. Опциональному десктопному GUI дополнительно требуются libwebkit2gtk-4.1-dev, libsoup-3.0-dev, libayatana-appindicator3-dev и librsvg2-dev. На macOS webview нативный, поэтому GUI ничего дополнительного не просит.
Первый запуск
Положите оба бинаря куда-нибудь в PATH и запустите мастер настройки:
aetron-miner init
init интерактивен. Он задаёт короткий список вопросов и пишет ответы в ~/.aetron-miner/config.toml. Если конфиг уже есть, он спросит перед перезаписью, а при отказе оставит файл нетронутым. Вопросы по порядку:
- Путь к кошельку. Место для ключевого материала. Мастер предложит создать файл, если его нет.
- Идентификатор Нейронета. Идентификатор в цепи того Нейронета, в котором вы собираетесь майнить.
- Путь к модели. Где лежат веса. Путь принимается, если файл существует или существует его родительский каталог, поэтому можно указать место, которое вы ещё не наполнили.
- Лимит GPU. Процент от 0 до 100. Пустое значение означает отсутствие лимита.
- Каталог кэша. Где хранятся модели и датасеты. По умолчанию
~/.aetron-miner/cache/, может лежать на другом томе, например на внешнем SSD. - Потолок кэша. Мягкий лимит в гигабайтах, предзаполненный половиной свободного места на том томе. Ноль означает отсутствие лимита. Превышение даёт предупреждение при загрузке, а не жёсткую блокировку.
- Сеть. Одно из
mainnet,testnetилиlocal. По умолчаниюtestnet, который резолвится в публичную точку входаwss://entrypoint-test.aetron.ai.
Выбор local добавляет два вопроса: WebSocket-адрес ноды Substrate, по умолчанию ws://127.0.0.1:9944, и идентификатор задачи, по умолчанию 0 для первой задачи Нейронета.
Мастер намеренно молчаливый. Он не создаёт каталог кэша и ничего не скачивает, а только пишет файл конфигурации. Ещё он покрывает лишь распространённые поля. Всё остальное, включая продвинутые настройки, о которых он не спрашивает, описано в Конфигурации.
Когда конфиг готов, поднимайте клиент:
aetron-miner start
Это запускает фоновый демон, а затем цикл событий движка. aetron-miner stop разворачивает оба. Запуск aetron-miner без аргументов в терминале открывает интерактивный TUI, а в пайпе или CI печатает справку и выходит. Полный набор команд лежит в Справочнике CLI.
Где что лежит
Всё, чем владеет клиент, живёт под ~/.aetron-miner/:
| Путь | Содержимое |
|---|---|
config.toml | Конфигурация, записанная мастером |
keystore/ | Зашифрованный hotkey.json плюс meta.json с публичным адресом SS58 для показа до разблокировки |
cache/ | Скачанные модели и датасеты, если вы не перенесли кэш |
state.db | Локальное состояние, включая список челленджей свидетеля, по которым вы уже голосовали, чтобы перезапуск не делал работу заново |
enc_secret | Секрет X25519 для вскрытия запечатанных входов заданий, режим 0600, переживает перезапуски |
daemon.log | Лог демона, который стримит aetron-miner logs |
daemon.sock, daemon.pid | Локальный RPC-сокет и pid-файл |
Вашего холодного ключа там нет. Он остаётся в вашем кошельке, а конфигурация хранит только его адрес SS58 для запросов в цепь и отображения. См. Кошельки и ключи.
Проверка, что всё поднялось
aetron-miner status
status сначала сообщает, найден ли файл конфигурации, а затем опрашивает работающий демон через локальный сокет. Когда демон поднят, вы получите его PID и аптайм, настроенную сеть, реально используемый бэкенд цепи, состояние майнинга, число выполненных заданий, обнаруженные GPU и память, автоматически определённый уровень Pulse, бэкенд инференса и содержимое кэша. Если демон не запущен, status так и скажет, а не упадёт.
Строку сети и строку бэкенда цепи читайте как два разных факта. Сеть - это то, что попросил ваш конфиг. Бэкенд цепи - то, что демон реально собрал, и он подписан честно, включая случаи симуляции или отката с указанием причины. Уровень ниже возможностей железа или бэкенд инференса CPU на машине с GPU обычно означают, что раннер не добрался до ускорителя.
Если вы собираетесь получать задания через одноранговую сеть, а не только из состояния цепи, учтите: слушатель mesh по умолчанию выключен и включается в конфигурации. См. Одноранговая сеть.