Sobre o projeto

# BTX Start Miner O BTX Start é um frontend de integração competitivo e fork do instalador para [BTX](https://btxprice.com), o fork pós-quântico do Bitcoin Knots com prova de trabalho matmul. Simplifica o processo de adesão à rede BTX, proporcionando um caminho simplificado desde a instalação até ao ganho, gerindo a variância através da mineração em pool. ## Funcionalidades Principais * **Integração Simplificada**: Reduz a fricção com um instalador `curl | bash` que deteta o hardware, verifica os binários e configura automaticamente as definições ideais. * **Suporte Multiplataforma**: Suporta Linux (GPUs NVIDIA Pascal até Blackwell), Windows (via WSL2) e Apple Silicon (Metal). * **Ajuste de Desempenho**: Inclui uma ferramenta de benchmarking automatizada (`dexbtx-miner benchmark`) para explorar parâmetros como workers, threads e tamanho do lote para máxima eficiência. * **Tratamento Robusto de Erros**: Vem com mecanismos de recuperação integrados para modos de falha comuns, como esgotamento do buffer CUDA, fallbacks silenciosos para CPU e desconexões de pares. * **Taxas Transparentes**: Oferece um período de teste sem taxas de 7 dias, seguido de uma taxa de plataforma de 0,50%. ## Início Rápido ### Linux + GPU NVIDIA Verifique a compatibilidade sem instalar: ```bash curl -fsSL https://drinknile.com/install.sh | bash -s -- --preflight --address 'btx1z...YOUR_BTX_ADDRESS...' ``` Instale se a verificação prévia passar: ```bash curl -fsSL https://drinknile.com/install.sh | bash -s -- --address 'btx1z...YOUR_BTX_ADDRESS...' ``` Inicie a mineração: ```bash dexbtx-miner --config ~/.dexbtx-miner/config.yaml ``` ### Mac com Apple Silicon Use o backend 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' ``` ### PC Windows Instale o Ubuntu via WSL2, certifique-se de que os drivers NVIDIA estão instalados no Windows e, em seguida, execute os comandos do instalador Linux dentro do terminal Ubuntu. ## Arquitetura e Ajuste O minerador usa um orquestrador Python (`dexbtx-miner`) que envolve um solver binário nativo (`btx-gbt-solve`). O solver suporta múltiplas arquiteturas de GPU (Pascal, Turing, Ampere, Ada Lovelace, Hopper, Blackwell) através de cubins incorporados ou compilação JIT PTX. **Padrões de Ajuste Recomendados:** * `workers=16`, `threads=8`, `batch=128` * Estas definições funcionam na maioria das gerações NVIDIA, desde a série GTX 10 até à série RTX 50. Para otimizar ainda mais, use a ferramenta de benchmark: ```bash dexbtx-miner benchmark --write-config ``` ## Serviços de Backend O repositório inclui um esqueleto para um backend próprio (`backend/README.md`) que trata de: * Ponto de entrada do servidor Stratum. * API de estatísticas e verificações de saúde. * Processamento de pagamentos e integração de faturação. Nota: O servidor stratum rejeita shares até que a validação real de matmul esteja totalmente integrada; não o coloque em produção prematuramente. ## Contribuir Clone o repositório e instale em modo editável: ```bash git clone https://github.com/pythonoptic-sketch/minebtx-start cd minebtx-start pip install --user -e . dexbtx-miner --config config.example.yaml ``` Licença: MIT.