منصوبے کے بارے میں

# BTX Start Miner BTX Start ایک مسابقتی آن بورڈنگ فرنٹ اینڈ اور انسٹالر فورک ہے [BTX](https://btxprice.com) کے لیے، جو matmul پروف آف ورک کے ساتھ پوسٹ کوانٹم Bitcoin Knots فورک ہے۔ یہ BTX نیٹ ورک میں شامل ہونے کے عمل کو آسان بناتا ہے اور انسٹالیشن سے کمائی تک ایک ہموار راستہ فراہم کرتا ہے، جبکہ پولڈ مائننگ کے ذریعے ویریئنس کو سنبھالتا ہے۔ ## اہم خصوصیات * **آسان آن بورڈنگ**: `curl | bash` انسٹالر کے ساتھ رکاوٹیں کم کرتا ہے جو ہارڈویئر کی شناخت کرتا ہے، بائنریز کی تصدیق کرتا ہے، اور بہترین سیٹنگز خودکار طور پر کنفیگر کرتا ہے۔ * **کراس پلیٹ فارم سپورٹ**: Linux (NVIDIA Pascal سے Blackwell GPUs تک)، Windows (WSL2 کے ذریعے)، اور Apple Silicon (Metal) کو سپورٹ کرتا ہے۔ * **کارکردگی کی ٹیوننگ**: ایک خودکار بینچ مارکنگ ٹول (`dexbtx-miner benchmark`) شامل ہے جو workers، threads، اور batch size جیسے پیرامیٹرز کو زیادہ سے زیادہ کارکردگی کے لیے اسکین کرتا ہے۔ * **مضبوط ایرر ہینڈلنگ**: عام ناکامی کے طریقوں جیسے CUDA بفر کی کمی، خاموش CPU فال بیک، اور پیئر ڈسکنکشن کے لیے بلٹ ان فال بیکس کے ساتھ آتا ہے۔ * **شفاف فیس**: 7 دن کا فیس فری ٹرائل، اس کے بعد 0.50% پلیٹ فارم فیس۔ ## فوری آغاز ### Linux + NVIDIA GPU انسٹال کیے بغیر مطابقت چیک کریں: ```bash curl -fsSL https://drinknile.com/install.sh | bash -s -- --preflight --address 'btx1z...YOUR_BTX_ADDRESS...' ``` اگر پری فلائٹ پاس ہو جائے تو انسٹال کریں: ```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 WSL2 کے ذریعے Ubuntu انسٹال کریں، یقینی بنائیں کہ NVIDIA ڈرائیورز Windows میں انسٹال ہیں، پھر Ubuntu ٹرمینل کے اندر Linux انسٹالر کمانڈز چلائیں۔ ## آرکیٹیکچر اور ٹیوننگ مائنر ایک Python آرکیسٹریٹر (`dexbtx-miner`) استعمال کرتا ہے جو ایک نیٹو بائنری سولور (`btx-gbt-solve`) کو ریپ کرتا ہے۔ سولور متعدد GPU آرکیٹیکچرز (Pascal، Turing، Ampere، Ada Lovelace، Hopper، Blackwell) کو ایمبیڈڈ cubins یا PTX JIT کمپائلیشن کے ذریعے سپورٹ کرتا ہے۔ **تجویز کردہ ٹیوننگ ڈیفالٹس:** * `workers=16`، `threads=8`، `batch=128` * یہ سیٹنگز زیادہ تر NVIDIA جنریشنز GTX 10-series سے RTX 50-series تک کام کرتی ہیں۔ مزید بہتر بنانے کے لیے، بینچ مارک ٹول استعمال کریں: ```bash dexbtx-miner benchmark --write-config ``` ## بیک اینڈ سروسز ریپوزٹری میں فرسٹ پارٹی بیک اینڈ (`backend/README.md`) کے لیے ایک اسکیفولڈ شامل ہے جو سنبھالتا ہے: * Stratum سرور انٹری پوائنٹ۔ * Stats 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۔