Regtest-გზამკვლევი

ლოკალური დეველოპმენტის სამი გზა, სირთულის ზრდის მიხედვით. თითოეული TensorCash-ის JSON-RPC-ს გაძლევს, რომელსაც bitcoin-cli-ით ან ნებისმიერი JSON-RPC-კლიენტით გამოიძახებ. bcore-ის ფუნქციური ტესტების ნაკრები ქვემოთ აღწერილი ყველაფრის კანონიკური, შესრულებადი სპეციფიკაციაა, და ყოველი მაგალითი იმ ტესტზე მიუთითებს, რომლიდანაც არის გამოყვანილი.

მხოლოდ Core · docker compose · ფუნქციური ტესტები

ვალიდაციის რეჟიმები

TensorCash ბლოკის მიღებას გარე ვალიდაციის ნაბიჯს ამატებს. -validationapi ირჩევს ბექენდს, რომელიც მას ემსახურება, და ეს ყველაზე მნიშვნელოვანი არჩევანია ლოკალური გაშვებისთვის: ის წყვეტს, დაგჭირდება GPU, ვერიფიკატორის პროცესი თუ არცერთი.

ფლაგირა არისროდის გამოვიყენოთ
-validationapi=realნაგულისხმევი. გარე ვერიფიკატორს უკავშირდება კვანძიდან-ვერიფიკატორამდე ZMQ PUSH/PULL არხით, FlatBuffers-ის გამოყენებით. პროდაქშენის პარამეტრი.სჭირდება რეალური ვერიფიკატორის პროცესი. გამოიყენება mainnet-ზე, testnet-ზე და ნებისმიერ regtest-გაშვებაში, სადაც მოდელის რეალური ხელახალი გაშვება მოწმდება.
-validationapi=mockპროცესის შიგნით და დეტერმინისტული. mock-ბექენდი სამ RPC-ს მოიცავს (validationmockdefault, validationmockclear, validationmockrequests) წინასწარ განსაზღვრული Quick, Full და Model პასუხებისთვის; -mockval-default-* გაშვების ფლაგებით ვერიფიკაციის ყოველი შედეგი სკრიპტით იმართება.ფუნქციური ტესტების ნაკრების ნაგულისხმევი რეჟიმი. სწორი არჩევანი ჯაჭვის ლოგიკის სამართავად ვერიფიკატორისა და რეალური ინფერენციის გარეშე.
-validationapi=desktopჰიბრიდული. Quick-შემოწმებები პროცესის შიგნით სრულდება; Full და Model ლოკალურ HTTPS-ვერიფიკატორზე იგზავნება (ნაგულისხმევი დესკტოპის ბინარი). ZMQ-ბროკერი საჭირო არ არის.ერთმანქანიანი დემოები, რომლებსაც რეალური Quick- და Smell-შემოწმება სჭირდებათ ცალკე ვერიფიკატორის სერვისის გაშვების გარეშე.

ჯაჭვის ლოგიკის პირველი გაცნობისთვის სწორი პასუხი mock-ია. ამ გვერდის დანარჩენი ნაწილი მას გულისხმობს, თუ სხვა რამ არ არის მითითებული.

გზა A · მხოლოდ Core, mock-ვალიდაციით

ყველაზე მარტივი გზა. ერთი C++ daemon: არც docker, არც GPU, არც მოდელის ფაილები დისკზე. საკმარისია ამ გვერდის ყველა მაგალითისთვის.

1. daemon-ის აწყობა

მიჰყევი Bitcoin Core-ის build-ის ინსტრუქციებს services/core-node/bcore/-ისთვის. TensorCash-ის კოდი იმავე CMake target-ით აიწყობა, რაც upstream; ცალკე ფლაგი არ არსებობს.

2. regtest-კვანძის გაშვება

ეს ფლაგები იმეორებს იმას, რასაც test_framework/test_tensorcash.py ყოველ ფუნქციურ ტესტს გადასცემს, ასე რომ, რაც იქ მუშაობს, აქაც იმუშავებს. ნაგულისხმევი mock-პასუხები მწვანეზეა დაფიქსირებული, ამიტომ ბლოკების მიღება დეტერმინისტულია.

./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. დაუკავშირდი კვანძს

ავთენტიფიკაციისთვის გამოიყენება cookie-ფაილი $HOME/.tensorcash-regtest/regtest/.cookie, რომელსაც bitcoin-cli ავტომატურად კითხულობს, როცა -datadir-ს გადასცემ. RPC-პორტი upstream regtest-ის ნაგულისხმევია, 18443.

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

გზა B · სრული ლოკალური სტეკი (docker compose)

როცა mock საკმარისი არ არის: რეალური ვერიფიკატორის პროცესი, რეალური მოდელი, რომელიც ინფერენციას ემსახურება, და მიერთებული miner API. რეპოზიტორიის ძირში გაშვების სკრიპტებია Mac-ისთვის და CUDA-იანი Linux-ისთვის.

Apple silicon-ზე გამშვები llama.cpp-ის build-ს ჩამოტვირთავს და სრულ core-node + miner-api + verification-api compose-სტეკს უშვებს:

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

Linux-ზე NVIDIA GPU-ებით launch_linux.sh იმავეს აკეთებს, ოღონდ llama.cpp-ის ნაცვლად vLLM-ზე დაფუძნებული ვერიფიკატორით:

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

compose-ფაილი ჰოსტის პორტებს აბამს: 8333 (P2P), 8050 (core-node REST API) და 7067 (ZMQ). ვერიფიკატორი თავის Verifier REST API-ს საკუთარი კონტეინერის პორტზე ემსახურება.

გზა 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-ის ტესტები ინტერფეისების მიხედვით ჯგუფდება: მოდელის სასიცოცხლო ციკლი, ნატიური აქტივები, fair-sign ადაპტორები და covenant repo-საფულე. თითოეული დამოუკიდებელი სცენარია, რომელიც თავიდან ბოლომდე იკითხება; ქვემოთ მოცემული მაგალითები ყველაზე წარმომადგენლობითებზე მიუთითებს.

ნაბიჯ-ნაბიჯ მაგალითები

სამი მოკლე თანმიმდევრობა გზა A-ს mock-კვანძზე. თითოეული მონახაზია; მითითებული ფუნქციური ტესტი სრული, შესრულებადი სცენარია.

მოიმაინე პირველი ბლოკი

კანონიკური ტესტი: wallet_basic.py

Bitcoin Core-ის მსგავსად, ცვლილებების გარეშე. სწრაფი შემოწმება ნებისმიერ TensorCash-სპეციფიკურ ინტერფეისამდე: ადასტურებს, რომ daemon მუშაობს და საფულე შევსებულია.

მოიცავს: 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)

მოდელის რეგისტრაცია თავიდან ბოლომდე

კანონიკური ტესტი: feature_model_registration.py

TensorCash-სპეციფიკური. მოდელი რეგისტრირდება დეპოზიტის ესქროუში მოთავსებით, N commit-ის განმავლობაში წარმატებული Quick- და Model-ვერიფიკაციების დაგროვებით, შემდეგ კი — გადამოწმების ფანჯრის დახურვისას — registered სტატუსზე გადასვლით. -validationapi=mock-ით ყოველი ნაბიჯის მართვა RPC-ებით შეგიძლია, რეალური ვერიფიკატორისა და GPU-ის გარეშე. ეს მონახაზია; სრული სცენარი მითითებულ ტესტშია.

მოიცავს: 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, ...}

ნატიური აქტივის გამოშვება

კანონიკური ტესტი: feature_assets_basic_highlevel.py

TensorCash-სპეციფიკური. registerasset მაღალი დონის საფულის RPC-ია, რომელიც bond- და ICU-გამოსავლებს აგებს, ემიტენტის რეგისტრაციის TLV-ს ურთავს და ტრანზაქციას ქსელში აგზავნის. ერთი დადასტურების შემდეგ აქტივის მოძიება id-ით ან ტიკერით შეიძლება. სრული სასიცოცხლო ციკლი (mint, transfer, burn) მითითებულ ტესტშია.

მოიცავს: 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

ფლაგების ცნობარი

გზა A-ს ფლაგები, რომლებიც ჩვეულებრივი bitcoind -regtest სესიისგან განსხვავდება. ჭეშმარიტების წყარო: test_framework/test_tensorcash.py და init.cpp.

ფლაგირატომ არის მნიშვნელოვანი regtest-ში
-regtestირჩევს regtest-ჯაჭვს (ბლოკის სუბსიდია, მომწიფების მყისიერი წესები და მხოლოდ ლოკალური პორტები 18443/18444).
-vdfspvcommitmentheight=0VDF/SPV-ს გენეზისიდან ააქტიურებს, mainnet-ის ეტაპობრივი სიმაღლის ნაცვლად.
-vdfspvvdfverifyheight=0VDF-გადამოწმებას გენეზისიდან ააქტიურებს.
-maxtipage=999999იღებს ძველ დროის ნიშნულებს, ასე რომ მოძველებულ ჯაჭვზე გადატვირთვა არასინქრონიზებულ კვანძად არ აღიქმება.
-spv-asn-min=1ამცირებს ASN-დადასტურების მინიმალურ ზღვარს; მის გარეშე regtest-ში VDF SPV-გადართვის ლოგიკა იბლოკება.
-spv-hysteresis-base-bps=0ხსნის საბაზო მარჟის ჰისტერეზისს, ასე რომ ტესტებში reorg-ები მყისიერი და დეტერმინისტულია.
-spv-reorg-sampling-threshold=999პრაქტიკულად გამორთავს ღრმა reorg-ების ბლოკის სხეულის სემპლირებას, რომლის ამოქმედებაც მცირე სიმაღლეებზე არაპრაქტიკულია.
-useextapi=0გამორთავს გარე miner API-ს: მხოლოდ ჯაჭვზე ორიენტირებული მაგალითებისთვის საჭირო არ არის და გაშვებას აჩქარებს.
-debug=net,validationლოგავს regtest-სესიისთვის ყველაზე სასარგებლო ხაზებს: ქსელს და ვალიდაციის კონვეიერს.
-par=1ერთნაკადიანი ვალიდაცია. აქრობს მხოლოდ ტესტებისთვის დამახასიათებელ არასტაბილურობის ერთ კლასს, სისწორეზე გავლენის გარეშე.

შემდეგი ნაბიჯი

  • JSON-RPC ცნობარიმეთოდების სრული ინდექსი, ჯგუფებად დალაგებული, სტაბილურობის ნიშნულებითა და curl-მაგალითებით.
  • Verifier REST APIროცა -validationapi=mock-იდან რეალური ვერიფიკატორის პროცესზე გადადიხარ.
  • FlatBuffer-სქემებიFlatBuffer IDL და JSON Schema კვანძიდან ვერიფიკატორამდე ZMQ-payload-ებისთვის.
  • bcore/test/functional/წაიკითხე ტესტები როგორც სპეციფიკაცია.
  • testnet-ის faucetონლაინ ალტერნატივა: შეავსე საფულე საერთო testnet-ზე, როცა ლოკალური სავარჯიშო გარემოს ნაცვლად ცოცხალი ჯაჭვი გჭირდება.