שלושה מסלולי פיתוח מקומיים, מסודרים לפי רמת החיכוך. כל אחד מעמיד לרשותכם JSON-RPC של TensorCash שאפשר לקרוא לו עם bitcoin-cli או כל לקוח JSON-RPC. חבילת הבדיקות הפונקציונליות של bcore היא המפרט הקנוני, שאפשר גם להריץ, של כל מה שלמטה, וכל מדריך מקשר לבדיקה שממנה הוא נגזר.
Core בלבד · docker compose · בדיקות פונקציונליות
מצבי אימות
TensorCash מוסיף שלב אימות חיצוני לקבלת בלוקים. -validationapi בוחר את ה-backend שמשרת אותו, וזו הבחירה החשובה ביותר בהרצה מקומית: היא קובעת אם צריך GPU, תהליך מאמת, או אף אחד מהם.
דגל
מה זה
מתי להשתמש
-validationapi=real
ברירת המחדל. מתקשר עם מאמת חיצוני בערוץ ZMQ PUSH/PULL שבין הצומת למאמת, באמצעות FlatBuffers. ההגדרה של סביבת הייצור.
דורש תהליך מאמת אמיתי. בשימוש ב-mainnet, ב-testnet ובכל הרצת regtest שמפעילה שחזור (replay) אמיתי של מודל.
-validationapi=mock
בתוך התהליך ודטרמיניסטי. ה-backend המדומה חושף שלושה RPC (validationmockdefault, validationmockclear, validationmockrequests) לתגובות Quick, Full ו-Model מוכנות מראש; עם דגלי ההפעלה -mockval-default-* אפשר לתסרט כל תוצאת אימות.
ברירת המחדל של חבילת הבדיקות הפונקציונליות. הבחירה הנכונה להפעלת לוגיקת השרשרת בלי מאמת ובלי הסקה אמיתית.
-validationapi=desktop
היברידי. בדיקות Quick רצות בתוך התהליך; Full ו-Model נשלחות למאמת HTTPS מקומי (הבינארי השולחני המוגדר כברירת מחדל). אין צורך ב-broker של ZMQ.
הדגמות על מכונה אחת, כשרוצים מעבר Quick ו-Smell אמיתי בלי להפעיל שירות מאמת נפרד.
למבט ראשון על לוגיקת השרשרת, mock היא התשובה הנכונה. שאר הדף מניח אותה, אלא אם צוין אחרת.
מסלול A · Core בלבד, עם אימות מדומה
הדרך עם הכי מעט חיכוך. דמון C++ אחד: בלי docker, בלי GPU, בלי קובצי מודל על הדיסק. מספיק לכל המדריכים בדף הזה.
1. בניית הדמון
עקבו אחר הוראות הבנייה של Bitcoin Core בתיקייה services/core-node/bcore/. הקוד של TensorCash נבנה תחת אותו יעד CMake כמו ה-upstream; אין דגל נפרד.
2. הפעלת צומת regtest
הדגלים האלה משקפים את מה ש-test_framework/test_tensorcash.py מעביר לכל בדיקה פונקציונלית, כך שכל מה שרץ שם רץ גם כאן. תגובות ה-mock המוגדרות כברירת מחדל קבועות על ירוק, ולכן קבלת בלוקים דטרמיניסטית.
האימות מתבצע עם קובץ ה-cookie שב-$HOME/.tensorcash-regtest/regtest/.cookie, ש-bitcoin-cli קורא אוטומטית כשמעבירים -datadir. פורט ה-RPC הוא ברירת המחדל של regtest ב-upstream, 18443.
אחרי שהדמון נבנה (מסלול 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 וארנק ה-repo מבוסס covenant. כל אחת היא תרחיש עצמאי שאפשר לקרוא מההתחלה עד הסוף; המדריכים למטה מפנים לבדיקות המייצגות ביותר.
מדריכים מעשיים
שלושה רצפים קצרים מול צומת ה-mock ממסלול A. כל אחד הוא סקיצה; הבדיקה הפונקציונלית המקושרת היא התרחיש המלא שאפשר להריץ.
ייחודי ל-TensorCash. מודל נרשם כך: מפקידים פיקדון בנאמנות, אוספים אימותי Quick ו-Model מוצלחים לאורך N התחייבויות, ואז עוברים ל-registered כשחלון האימות נסגר. עם -validationapi=mock אפשר להפעיל כל שלב דרך RPC, בלי מאמת אמיתי ובלי GPU. זהו מתאר בלבד; הבדיקה המקושרת היא התרחיש המלא.
ייחודי ל-TensorCash. registerasset הוא ה-RPC ברמה גבוהה של הארנק, שבונה את פלטי הערבון וה-ICU, מצרף את ה-TLV של רישום המנפיק ומשדר. אחרי אישור אחד אפשר לשאול על הנכס לפי מזהה או טיקר. מחזור החיים המלא (הטבעה, העברה, שריפה) נמצא בבדיקה המקושרת.