Panduan regtest

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.

FlagApa ituKapan dipakai
-validationapi=realBawaan. 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=mockDi 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=desktopHibrida. 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.

./bitcoind \
  -datadir=$HOME/.tensorcash-regtest \
  -regtest \
  -vdfspvcommitmentheight=0 \
  -vdfspvvdfverifyheight=0 \
  -maxtipage=999999 \
  -spv-asn-min=1 \
  -spv-hysteresis-base-bps=0 \
  -spv-reorg-sampling-threshold=999 \
  -useextapi=0 \
  -par=1 \
  -debug=net -debug=validation \
  -validationapi=mock \
  -mockval-force-external=1 \
  -mockval-default-quick=quick_ok_smell_ok \
  -mockval-default-full=full_green \
  -mockval-default-model=model_ok \
  -daemon

3. Berinteraksi dengan node

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.

alias bcli='bitcoin-cli -regtest -datadir=$HOME/.tensorcash-regtest'
bcli getblockchaininfo | jq '{chain, blocks, verificationprogress}'

Jalur B · stack lokal lengkap (docker compose)

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:

export GITHUB_TOKEN="ghp_..."
export MODEL_FILE="$HOME/models/Qwen_Qwen3_8B.gguf"
./launch_macbook.sh
# brings up: core-node (RPC 18443, REST 8050) + miner-api + verification-api

Di Linux dengan GPU NVIDIA, launch_linux.sh melakukan hal yang sama dengan verifier berbasis vLLM, bukan llama.cpp:

export API_KEY=super-secret-token
export MODEL_API_KEY=super-secret-token
sudo ./launch_linux.sh
# uses deployments/docker-compose/core-miner-validation-api/docker-compose.yaml

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.

Menambang blok pertama Anda

Tes kanonis: wallet_basic.py

Sama seperti di Bitcoin Core. Smoke test sebelum menyentuh antarmuka khusus TensorCash: memastikan daemon sudah berjalan dan dompet sudah terisi.

Menyentuh: createwallet, getnewaddress, generatetoaddress, getbalance

# bitcoin-cli speaks to the regtest daemon over the cookie file.
ALIAS="bitcoin-cli -regtest -datadir=$HOME/.tensorcash-regtest"

$ALIAS createwallet sandbox
ADDR=$($ALIAS -rpcwallet=sandbox getnewaddress)
$ALIAS -rpcwallet=sandbox generatetoaddress 101 "$ADDR"
$ALIAS -rpcwallet=sandbox getbalance
# 50.00000000  (block 1's coinbase, mature after 100 confirmations)

Daftarkan model dari awal hingga akhir

Tes kanonis: feature_model_registration.py

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.

Menyentuh: validationmockdefault, createmodeldeposit, createmodelcommit, getmodelstatus, generatetoaddress

# Pin every mock rung to the green response.
$ALIAS validationmockdefault quick quick_ok_smell_ok
$ALIAS validationmockdefault model model_ok
$ALIAS validationmockdefault full  full_green

# Lay down 101 spendable coinbase outputs.
$ALIAS -rpcwallet=sandbox generatetoaddress 101 "$ADDR"

# 1. Escrow the deposit (1_000_000 sats == 0.01 BTC).
DEPOSIT=$($ALIAS -rpcwallet=sandbox createmodeldeposit \
  tensor/registration-success success-commit 1000000)
TXID=$(echo "$DEPOSIT" | jq -r .txid)
VOUT=$(echo "$DEPOSIT" | jq -r .deposit_vout)
HASH=$(echo "$DEPOSIT" | jq -r .model_hash)
$ALIAS -rpcwallet=sandbox generatetoaddress 1 "$ADDR"

# 2. Accumulate 50 commits — feature_model_registration.py shows the funding
#    plumbing in detail. Then mine to the verification window's close height.
# 3. Poll status.
$ALIAS getmodelstatus "$HASH"
# {"status": "registered", "verification_code": 0, ...}

Terbitkan aset native

Tes kanonis: feature_assets_basic_highlevel.py

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.

Menyentuh: registerasset, getassetpolicy, getassetbyticker, getassetbalance

ADDR=$($ALIAS -rpcwallet=sandbox getnewaddress)
ASSET_ID=$(printf 'my-first-asset' | shasum -a 256 | cut -d' ' -f1)

$ALIAS -rpcwallet=sandbox registerasset \
  "$ADDR"          `# ICU address` \
  5.1              `# bond (BTC)` \
  "$ASSET_ID"      `# 32-byte asset id` \
  3                `# policy bits: MINT | BURN` \
  28               `# allowed families: P2WPKH | P2WSH | P2TR` \
  510000000        `# unlock fees (sats)` \
  TST              `# ticker` \
  8                `# decimals` \
  '{"autofund":true,"broadcast":true,"fee_rate":10}'

$ALIAS -rpcwallet=sandbox generatetoaddress 1 "$ADDR"
$ALIAS getassetpolicy "$ASSET_ID"
$ALIAS getassetbyticker TST

Referensi flag

Flag dari Jalur A yang berbeda dari sesi bitcoind -regtest biasa. Sumber kebenaran: test_framework/test_tensorcash.py dan init.cpp.

FlagMengapa penting di regtest
-regtestMemilih rantai regtest (subsidi blok, aturan maturitas instan, dan port lokal 18443/18444).
-vdfspvcommitmentheight=0Mengaktifkan VDF/SPV sejak genesis, bukan pada ketinggian bertahap seperti di mainnet.
-vdfspvvdfverifyheight=0Mengaktifkan verifikasi VDF sejak genesis.
-maxtipage=999999Menerima timestamp lama, sehingga memulai ulang pada rantai yang usang tidak terlihat seperti node yang belum tersinkron.
-spv-asn-min=1Menurunkan ambang minimum koroborasi ASN; tanpanya, regtest memblokir logika peralihan VDF SPV.
-spv-hysteresis-base-bps=0Menghapus histeresis base-margin, sehingga reorg dalam tes terjadi seketika dan deterministik.
-spv-reorg-sampling-threshold=999Praktis menonaktifkan sampling body untuk reorg dalam, yang tidak praktis dijalankan pada ketinggian kecil.
-useextapi=0Menonaktifkan API penambang eksternal: tidak diperlukan untuk panduan yang hanya menyentuh rantai, dan mempercepat startup.
-debug=net,validationMencatat baris log yang paling berguna untuk sesi regtest: jaringan dan pipeline validasi.
-par=1Validasi satu thread. Menghilangkan satu kelas ketidakstabilan yang hanya muncul di tes, tanpa memengaruhi kebenaran.

Selanjutnya

  • Referensi JSON-RPCIndeks metode lengkap, dikelompokkan per bucket, dengan tag stabilitas dan contoh curl.
  • Verifier REST APISaat Anda beralih dari -validationapi=mock ke proses verifier sungguhan.
  • Skema FlatBufferIDL FlatBuffer dan JSON Schema untuk payload ZMQ node-ke-verifier.
  • bcore/test/functional/Baca tes sebagai spesifikasinya.
  • Faucet testnetPadanan online-nya: isi dompet di testnet bersama saat Anda menginginkan rantai yang aktif, bukan sandbox lokal.