سه مسیر توسعهٔ محلی، به ترتیب میزان دردسر. هر کدام یک JSON-RPC TensorCash در اختیارتان میگذارد تا با bitcoin-cli یا هر کلاینت JSON-RPC فراخوانیاش کنید. مجموعهٔ تستهای عملکردی در bcore مشخصات مرجع و اجرایی همهٔ موارد زیر است، و هر راهنما به تستی که از آن برگرفته شده پیوند میدهد.
فقط Core · docker compose · تستهای عملکردی
حالتهای اعتبارسنجی
TensorCash یک گام اعتبارسنجی خارجی به پذیرش بلاک اضافه میکند. -validationapi بکاندی را که این گام را انجام میدهد انتخاب میکند، و مهمترین انتخاب برای یک اجرای محلی است: تعیین میکند به GPU نیاز دارید، به یک فرایند تأییدکننده، یا به هیچکدام.
پرچم
چیست
چه زمانی استفاده شود
-validationapi=real
پیشفرض. از طریق کانال ZMQ PUSH/PULL نود به تأییدکننده و با FlatBuffers با یک تأییدکنندهٔ خارجی ارتباط میگیرد. تنظیم محیط production.
به یک فرایند تأییدکنندهٔ واقعی نیاز دارد. در میننت، تستنت و هر اجرای regtest که بازپخش واقعی مدل را آزمایش میکند استفاده میشود.
-validationapi=mock
درون فرایند و قطعی. بکاند mock سه RPC در اختیار میگذارد (validationmockdefault، validationmockclear، validationmockrequests) برای پاسخهای از پیش تعیینشدهٔ Quick، Full و Model؛ با پرچمهای راهاندازی -mockval-default-*، نتیجهٔ هر تأیید قابل اسکریپتنویسی است.
پیشفرض مجموعهٔ تستهای عملکردی. گزینهٔ درست برای بهکار انداختن منطق زنجیره بدون تأییدکننده یا استنتاج واقعی.
-validationapi=desktop
ترکیبی. بررسیهای Quick درون فرایند اجرا میشوند؛ Full و Model به یک تأییدکنندهٔ محلی HTTPS (باینری پیشفرض دسکتاپ) فرستاده میشوند. نیازی به broker ZMQ نیست.
نمایشهای تکدستگاهی که یک گذر واقعی Quick و Smell میخواهند، بدون اداره کردن یک سرویس تأییدکنندهٔ جداگانه.
برای نگاه اول به منطق زنجیره، mock پاسخ درست است. بقیهٔ این صفحه همین را فرض میکند، مگر خلافش گفته شود.
مسیر A · فقط core، با اعتبارسنجی mock
کمدردسرترین مسیر. یک daemon C++: بدون docker، بدون GPU، بدون فایل مدل روی دیسک. برای همهٔ راهنماهای گامبهگام این صفحه کافی است.
1. ساختن daemon
دستورالعملهای ساخت در Bitcoin Core را روی services/core-node/bcore/ دنبال کنید. کد TensorCash زیر همان هدف CMake نسخهٔ بالادستی ساخته میشود؛ هیچ پرچم جداگانهای وجود ندارد.
2. راهاندازی یک نود regtest
این پرچمها دقیقاً همان چیزی است که test_framework/test_tensorcash.py به هر تست عملکردی میدهد، پس هر چه آنجا اجرا شود اینجا هم اجرا میشود. پاسخهای پیشفرض mock روی green ثابت شدهاند، بنابراین پذیرش بلاک قطعی است.
احراز هویت از فایل cookie در $HOME/.tensorcash-regtest/regtest/.cookie استفاده میکند که bitcoin-cli وقتی -datadir را بدهید خودکار آن را میخواند. پورت RPC همان پیشفرض regtest بالادستی، یعنی 18443، است.
برای وقتی که mock کافی نیست: یک فرایند تأییدکنندهٔ واقعی، یک مدل واقعی که استنتاج ارائه میدهد، و API ماینر که به آنها وصل است. ریشهٔ مخزن اسکریپتهای راهاندازی برای Mac و برای Linux با CUDA دارد.
روی Apple silicon، اسکریپت راهانداز یک build از llama.cpp دریافت میکند و استک کامل compose شامل core-node + miner-api + verification-api را بالا میآورد:
فایل compose پورتهای میزبان 8333 (P2P)، 8050 (API REST core-node) و 7067 (ZMQ) را bind میکند. تأییدکننده API REST تأییدکننده خود را روی پورت کانتینر خودش ارائه میدهد.
مسیر C · اجرای مجموعهٔ تستهای عملکردی
وقتی daemon ساخته شد (مسیر A، گام 1)، اجراکنندهٔ تست نودهای موقت را برایتان راه میاندازد. وقتی بهجای یک daemon برای ور رفتن، یک توالی مطمئن برای کپی کردن میخواهید، این مسیر مفید است.
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 بر اساس سطح دسترسی دستهبندی شدهاند: چرخهٔ عمر مدل، داراییهای بومی، adaptorهای fair-sign و کیف پول repo مبتنی بر covenant. هر کدام سناریویی مستقل است که میتوانید از اول تا آخر بخوانید؛ راهنماهای زیر به نمایندهترین آنها اشاره میکنند.
راهنماهای گامبهگام
سه توالی کوتاه روی نود mock از مسیر A. هر کدام یک طرح اولیه است؛ تست عملکردی پیوندشده سناریوی کامل و قابل اجرا است.
ویژهٔ TensorCash. یک مدل اینطور ثبت میشود: سپردهای در escrow قفل میشود، تأییدهای موفق Quick و Model در N کامیت جمعآوری میشوند، و پس از بسته شدن پنجرهٔ تأیید، مدل به وضعیت registered میرود. با -validationapi=mock میتوانید هر گام را با RPC پیش ببرید، بدون تأییدکنندهٔ واقعی یا GPU. این یک طرح کلی است؛ سناریوی کامل در تست پیوندشده آمده است.
ویژهٔ TensorCash. registerasset همان RPC سطحبالای کیف پول است که خروجیهای bond و ICU را میسازد، TLV ثبت ناشر را پیوست میکند و تراکنش را پخش میکند. پس از یک تأیید، دارایی را میتوان با شناسه یا ticker جستوجو کرد. چرخهٔ عمر کامل (mint، انتقال، burn) در تست پیوندشده آمده است.