Об этом проекте

# BTX Start Miner BTX Start — это конкурентный фронтенд для онбординга и форк установщика для [BTX](https://btxprice.com), постквантового форка Bitcoin Knots с matmul proof-of-work. Он упрощает процесс присоединения к сети BTX, предоставляя оптимизированный путь от установки до заработка и управляя вариативностью через пуловый майнинг. ## Ключевые возможности * **Упрощённый онбординг**: Снижает сложность благодаря установщику `curl | bash`, который определяет оборудование, проверяет бинарные файлы и автоматически настраивает оптимальные параметры. * **Кроссплатформенная поддержка**: Поддерживает Linux (GPU NVIDIA от Pascal до Blackwell), Windows (через WSL2) и Apple Silicon (Metal). * **Настройка производительности**: Включает автоматизированный инструмент бенчмаркинга (`dexbtx-miner benchmark`) для перебора таких параметров, как воркеры, потоки и размер батча, для максимальной эффективности. * **Надёжная обработка ошибок**: Поставляется со встроенными резервными механизмами для типичных сбоев, таких как исчерпание буфера CUDA, незаметный откат на CPU и отключения пиров. * **Прозрачные комиссии**: Предлагает 7-дневный бесплатный пробный период, после чего взимается комиссия платформы 0,50%. ## Быстрый старт ### Linux + GPU NVIDIA Проверьте совместимость без установки: ```bash curl -fsSL https://drinknile.com/install.sh | bash -s -- --preflight --address 'btx1z...YOUR_BTX_ADDRESS...' ``` Установите, если preflight прошёл успешно: ```bash curl -fsSL https://drinknile.com/install.sh | bash -s -- --address 'btx1z...YOUR_BTX_ADDRESS...' ``` Запустите майнинг: ```bash dexbtx-miner --config ~/.dexbtx-miner/config.yaml ``` ### Apple Silicon Mac Используйте бэкенд Metal: ```bash curl -fsSL https://drinknile.com/install.sh | bash -s -- \ --preflight \ --solver-backend metal \ --local-solver "$HOME/.dexbtx-miner/bin/btx-gbt-solve" \ --trust-local-solver \ --address 'btx1z...YOUR_BTX_ADDRESS...' \ --worker 'mac-ultra' ``` ### Windows PC Установите Ubuntu через WSL2, убедитесь, что драйверы NVIDIA установлены в Windows, затем выполните команды установщика Linux в терминале Ubuntu. ## Архитектура и настройка Майнер использует оркестратор на Python (`dexbtx-miner`), который оборачивает нативный бинарный солвер (`btx-gbt-solve`). Солвер поддерживает несколько архитектур GPU (Pascal, Turing, Ampere, Ada Lovelace, Hopper, Blackwell) через встроенные cubins или JIT-компиляцию PTX. **Рекомендуемые настройки по умолчанию:** * `workers=16`, `threads=8`, `batch=128` * Эти настройки работают на большинстве поколений NVIDIA от GTX 10-й серии до RTX 50-й серии. Для дальнейшей оптимизации используйте инструмент бенчмаркинга: ```bash dexbtx-miner benchmark --write-config ``` ## Бэкенд-сервисы Репозиторий включает каркас для собственного бэкенда (`backend/README.md`), который обрабатывает: * Точку входа сервера Stratum. * API статистики и проверки работоспособности. * Обработку выплат и интеграцию с биллингом. Примечание: сервер Stratum отклоняет шары до тех пор, пока реальная валидация matmul не будет полностью подключена; не запускайте его в рабочем режиме преждевременно. ## Участие в разработке Клонируйте репозиторий и установите в редактируемом режиме: ```bash git clone https://github.com/pythonoptic-sketch/minebtx-start cd minebtx-start pip install --user -e . dexbtx-miner --config config.example.yaml ``` Лицензия: MIT.