عن المشروع

# BTX Start Miner BTX Start هو واجهة أمامية تنافسية للتأهيل ومثبّت متفرع لـ [BTX](https://btxprice.com)، وهو تفرع Bitcoin Knots بعد-كمومي مع إثبات عمل matmul. يبسّط عملية الانضمام إلى شبكة BTX من خلال توفير مسار مبسّط من التثبيت إلى الربح، مع معالجة التباين عبر التعدين المجمّع. ## الميزات الرئيسية * **تأهيل مبسّط**: يقلل العوائق عبر مثبّت `curl | bash` يكتشف العتاد، ويتحقق من الملفات الثنائية، ويضبط الإعدادات المثلى تلقائياً. * **دعم متعدد المنصات**: يدعم لينكس (وحدات NVIDIA من Pascal حتى Blackwell)، وويندوز (عبر WSL2)، وApple Silicon (Metal). * **ضبط الأداء**: يتضمن أداة قياس أداء آلية (`dexbtx-miner benchmark`) لمسح معاملات مثل workers وthreads وحجم الدفعة لتحقيق أقصى كفاءة. * **معالجة قوية للأخطاء**: يأتي مع بدائل مدمجة لأنماط الفشل الشائعة مثل استنفاد مخزن CUDA المؤقت، والتراجع الصامت إلى CPU، وانقطاع الاتصال بالأقران. * **رسوم شفافة**: يوفر تجربة مجانية من الرسوم لمدة 7 أيام، تليها رسوم منصة بنسبة 0.50%. ## البدء السريع ### لينكس + وحدة NVIDIA تحقق من التوافق دون تثبيت: ```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' ``` ### جهاز ويندوز ثبّت Ubuntu عبر WSL2، وتأكد من تثبيت تعريفات NVIDIA في ويندوز، ثم شغّل أوامر مثبّت لينكس داخل طرفية Ubuntu. ## البنية والضبط يستخدم المُعدّن منسّقاً بلغة 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 إلى سلسلة RTX 50. للتحسين أكثر، استخدم أداة القياس: ```bash dexbtx-miner benchmark --write-config ``` ## خدمات الواجهة الخلفية يتضمن المستودع هيكلاً لواجهة خلفية من الطرف الأول (`backend/README.md`) تتعامل مع: * نقطة دخول خادم Stratum. * واجهة برمجة تطبيقات الإحصاءات وفحوصات السلامة. * معالجة المدفوعات وتكامل الفوترة. ملاحظة: يرفض خادم 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.