ثلاثة مسارات للتطوير المحلي، مرتّبة من الأبسط إلى الأعقد. كلّ منها يضع أمامك واجهة JSON-RPC لـ TensorCash تستدعيها بـ bitcoin-cli أو بأيّ عميل JSON-RPC. مجموعة الاختبارات الوظيفية في bcore هي المواصفة المرجعية القابلة للتنفيذ لكلّ ما يلي، وكلّ شرح عملي يربط بالاختبار الذي استُخلص منه.
Core وحده · docker compose · اختبارات وظيفية
أنماط التحقّق
يضيف TensorCash خطوة تحقّق خارجية إلى قبول الكتل. يختار -validationapi الواجهة الخلفية التي تتولّاها، وهو أهمّ قرار في التشغيل المحلي: فهو يحدّد ما إذا كنت تحتاج إلى GPU، أو إلى عملية مُحقِّق، أو إلى لا شيء منهما.
الخيار
ما هو
متى تستخدمه
-validationapi=real
الخيار الافتراضي. يتواصل مع مُحقِّق خارجي عبر قناة ZMQ PUSH/PULL بين العقدة والمُحقِّق باستخدام FlatBuffers. إعداد بيئة الإنتاج.
يتطلّب عملية مُحقِّق حقيقية. يُستخدَم على الشبكة الرئيسية والشبكة التجريبية وفي أيّ تشغيل regtest يختبر إعادة تشغيل النموذج فعليًا.
-validationapi=mock
داخل العملية وحتمي. توفّر الواجهة الخلفية الوهمية ثلاث دوال RPC (validationmockdefault وvalidationmockclear وvalidationmockrequests) لاستجابات Quick وFull وModel مُعدّة مسبقًا؛ ومع خيارات الإقلاع -mockval-default-* يصبح كلّ ناتج تحقّق قابلًا للبرمجة.
الخيار الافتراضي لمجموعة الاختبارات الوظيفية. الخيار الصحيح لتشغيل منطق السلسلة دون مُحقِّق أو استدلال حقيقي.
-validationapi=desktop
هجين. تعمل فحوص Quick داخل العملية؛ أمّا Full وModel فتُرسَل إلى مُحقِّق HTTPS محلي (الملف التنفيذي الافتراضي لسطح المكتب). لا حاجة إلى وسيط ZMQ.
عروض على جهاز واحد تحتاج إلى تمريرة Quick وSmell حقيقية دون تشغيل خدمة مُحقِّق منفصلة.
لإلقاء نظرة أولى على منطق السلسلة، mock هو الخيار الصحيح. وتفترضه بقية هذه الصفحة ما لم يُذكر خلاف ذلك.
المسار A · Core وحده، مع تحقّق وهمي
أقلّ المسارات تعقيدًا. خادم C++ واحد: بلا docker، وبلا GPU، وبلا ملفات نماذج على القرص. يكفي لكلّ الشروح العملية في هذه الصفحة.
1. ابنِ الخادم
اتّبع تعليمات البناء الخاصة بـ Bitcoin Core على services/core-node/bcore/. تُبنى شيفرة TensorCash ضمن هدف CMake نفسه المعتمد في المصدر الأصلي؛ ولا يوجد خيار منفصل.
2. شغّل عقدة regtest
تطابق هذه الخيارات ما يمرّره test_framework/test_tensorcash.py إلى كلّ اختبار وظيفي، فكلّ ما يعمل هناك يعمل هنا أيضًا. الاستجابات الوهمية الافتراضية مثبّتة على الأخضر، لذا يكون قبول الكتل حتميًا.
تعتمد المصادقة على ملف الكوكي في $HOME/.tensorcash-regtest/regtest/.cookie، الذي يقرؤه bitcoin-cli تلقائيًا عند تمرير -datadir. منفذ RPC هو المنفذ الافتراضي لـ regtest في المصدر الأصلي، 18443.
المسار B · الحزمة المحلية الكاملة (docker compose)
حين لا يكفي التحقّق الوهمي: عملية مُحقِّق حقيقية، ونموذج حقيقي يقدّم الاستدلال، وواجهة API للمُعدِّن موصولة. يحتوي جذر المستودع على سكربتات تشغيل لأجهزة Mac ولـ Linux مع CUDA.
على Apple silicon، يجلب المُشغِّل نسخة من llama.cpp ويُطلق حزمة compose الكاملة core-node + miner-api + verification-api:
بعد بناء الخادم (المسار A، الخطوة 1)، يُطلق مُشغِّل الاختبارات عقدًا مؤقتة نيابةً عنك. مفيد حين تريد تسلسلًا مُجرَّبًا تنسخ منه، لا خادمًا تعبث به.
cd services/core-node/bcore
# Single test
build/test/functional/test_runner.py feature_model_registration.py
# All TensorCash-specific tests
build/test/functional/test_runner.py 'feature_model_*' 'feature_asset*' 'feature_fairsign_*'
# All tests, parallelised
build/test/functional/test_runner.py --jobs=$(nproc)
تتجمّع اختبارات TensorCash بحسب الواجهة: دورة حياة النماذج، والأصول الأصلية، ومحوّلات fair-sign، ومحفظة اتفاقيات إعادة الشراء القائمة على covenant. كلّ منها سيناريو مكتفٍ بذاته تقرؤه من أوّله إلى آخره؛ والشروح العملية أدناه تشير إلى أكثرها تمثيلًا.
شروح عملية
ثلاثة تسلسلات قصيرة على العقدة الوهمية من المسار A. كلّ منها مخطّط مبسّط؛ والاختبار الوظيفي المرتبط هو السيناريو الكامل القابل للتنفيذ.
خاص بـ TensorCash. يُسجَّل النموذج بحجز إيداع في حساب ضمان (escrow)، ثمّ جمع عمليات تحقّق Quick وModel ناجحة عبر N من الالتزامات، ثمّ الانتقال إلى registered عند إغلاق نافذة التحقّق. مع -validationapi=mock يمكنك تنفيذ كلّ خطوة عبر RPC، دون مُحقِّق حقيقي أو GPU. هذه خطوط عريضة؛ والاختبار المرتبط هو السيناريو الكامل.
خاص بـ TensorCash. registerasset هي دالّة RPC عالية المستوى في المحفظة، تبني مخرجات الضمان وICU، وترفق TLV تسجيل المُصدِر، ثمّ تذيع المعاملة. بعد تأكيد واحد يمكن الاستعلام عن الأصل بمعرّفه أو برمزه. دورة الحياة الكاملة (السكّ، والتحويل، والحرق) موجودة في الاختبار المرتبط.