Tiga jalur pengembangan lokal, diurutkan dari yang paling mudah. Masing-masing memberi Anda JSON-RPC TensorCash yang bisa dipanggil dengan bitcoin-cli atau klien JSON-RPC apa pun. Rangkaian tes fungsional bcore adalah spesifikasi kanonis yang dapat dieksekusi untuk semua hal di bawah ini, dan setiap panduan menautkan tes yang menjadi sumbernya.
Core saja · docker compose · tes fungsional
Mode validasi
TensorCash menambahkan langkah validasi eksternal pada penerimaan blok. -validationapi memilih backend yang melayaninya, dan inilah pilihan terpenting untuk run lokal: pilihan ini menentukan apakah Anda butuh GPU, proses verifier, atau tidak satu pun.
Flag
Apa itu
Kapan dipakai
-validationapi=real
Bawaan. Berkomunikasi dengan verifier eksternal melalui kanal ZMQ PUSH/PULL node-ke-verifier menggunakan FlatBuffers. Pengaturan untuk produksi.
Membutuhkan proses verifier sungguhan. Dipakai di mainnet, testnet, dan setiap run regtest yang menjalankan replay model sungguhan.
-validationapi=mock
Di dalam proses dan deterministik. Backend mock menyediakan tiga RPC (validationmockdefault, validationmockclear, validationmockrequests) untuk respons Quick, Full, dan Model yang sudah disiapkan; dengan flag startup -mockval-default-*, setiap hasil verifikasi dapat diatur lewat skrip.
Bawaan untuk rangkaian tes fungsional. Pilihan yang tepat untuk menguji logika rantai tanpa verifier atau inferensi sungguhan.
-validationapi=desktop
Hibrida. Pemeriksaan Quick berjalan di dalam proses; Full dan Model dikirim ke verifier HTTPS lokal (biner desktop bawaan). Tidak perlu broker ZMQ.
Demo di satu mesin yang membutuhkan pemeriksaan Quick dan Smell sungguhan tanpa mengoperasikan layanan verifier terpisah.
Untuk melihat logika rantai pertama kali, mock adalah jawaban yang tepat. Bagian lain halaman ini mengasumsikan mode itu kecuali disebutkan lain.
Jalur A · core saja, dengan validasi mock
Hambatan paling rendah. Satu daemon C++: tanpa docker, tanpa GPU, tanpa file model di disk. Cukup untuk semua panduan langkah demi langkah di halaman ini.
1. Build daemon
Ikuti petunjuk build Bitcoin Core pada services/core-node/bcore/. Kode TensorCash dibangun dengan target CMake yang sama seperti upstream; tidak ada flag terpisah.
2. Jalankan node regtest
Flag-flag ini sama dengan yang diberikan test_framework/test_tensorcash.py ke setiap tes fungsional, jadi apa pun yang berjalan di sana juga berjalan di sini. Respons mock bawaan dipatok ke hijau, sehingga penerimaan blok bersifat deterministik.
Autentikasi memakai file cookie di $HOME/.tensorcash-regtest/regtest/.cookie, yang dibaca bitcoin-cli secara otomatis saat Anda memberikan -datadir. Port RPC-nya adalah bawaan regtest upstream, 18443.
Untuk saat mock tidak cukup: proses verifier sungguhan, model sungguhan yang melayani inferensi, dan API penambang yang sudah tersambung. Root repositori berisi skrip peluncur untuk Mac dan untuk Linux dengan CUDA.
Di Apple silicon, peluncur mengambil build llama.cpp dan menjalankan stack compose lengkap core-node + miner-api + verification-api:
File compose mengikat port host 8333 (P2P), 8050 (core-node REST API) dan 7067 (ZMQ). Verifier menyajikan Verifier REST API miliknya di port container-nya sendiri.
Jalur C · jalankan rangkaian tes fungsional
Setelah daemon dibangun (Jalur A, langkah 1), test runner akan menjalankan node sekali pakai untuk Anda. Berguna jika Anda ingin urutan yang sudah terbukti benar untuk ditiru, bukan daemon untuk diutak-atik.
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)
Tes TensorCash dikelompokkan menurut antarmuka: siklus hidup model, aset native, adaptor fair-sign, dan dompet repo covenant. Masing-masing adalah skenario mandiri yang bisa Anda baca dari atas ke bawah; panduan di bawah menunjuk ke tes yang paling representatif.
Panduan langkah demi langkah
Tiga urutan singkat terhadap node mock dari Jalur A. Masing-masing hanya sketsa; tes fungsional yang ditautkan adalah skenario lengkap yang dapat dieksekusi.
Khusus TensorCash. Sebuah model didaftarkan dengan menitipkan deposit, mengumpulkan verifikasi Quick dan Model yang berhasil di N commit, lalu berpindah ke registered setelah jendela verifikasi ditutup. Dengan -validationapi=mock, Anda bisa menjalankan setiap langkah dari RPC, tanpa verifier atau GPU sungguhan. Ini hanya garis besar; skenario lengkapnya ada di tes yang ditautkan.
Khusus TensorCash. registerasset adalah RPC dompet tingkat tinggi yang membangun output bond dan ICU, melampirkan TLV registrasi penerbit, lalu menyiarkannya. Setelah satu konfirmasi, aset dapat dikueri berdasarkan id atau ticker. Siklus hidup lengkapnya (mint, transfer, burn) ada di tes yang ditautkan.