Regtest ceļvedis

Trīs lokālās izstrādes ceļi, sakārtoti pēc sarežģītības. Katrs no tiem sniedz TensorCash JSON-RPC, ko izsaukt ar bitcoin-cli vai jebkuru JSON-RPC klientu. bcore funkcionālo testu komplekts ir kanoniskā, izpildāmā specifikācija visam turpmāk aprakstītajam, un katra pamācība norāda uz testu, no kura tā izveidota.

Tikai Core · docker compose · funkcionālie testi

Validācijas režīmi

TensorCash bloku pieņemšanai pievieno ārēju validācijas soli. -validationapi izvēlas aizmugursistēmu, kas to apkalpo, un lokālam palaidienam tā ir svarīgākā izvēle: tā nosaka, vai vajag GPU, verificētāja procesu vai nevienu no tiem.

KarogsKas tas irKad to izmantot
-validationapi=realNoklusējums. Sazinās ar ārēju verificētāju pa ZMQ PUSH/PULL kanālu starp mezglu un verificētāju, izmantojot FlatBuffers. Produkcijas iestatījums.Nepieciešams reāls verificētāja process. Izmanto galvenajā tīklā, testa tīklā un jebkurā regtest palaidienā, kas pārbauda reālu modeļa atkārtošanu.
-validationapi=mockProcesa iekšienē un deterministisks. Imitācijas aizmugursistēma piedāvā trīs RPC (validationmockdefault, validationmockclear, validationmockrequests) sagatavotām Quick, Full un Model atbildēm; ar palaišanas karogiem -mockval-default-* katru verifikācijas iznākumu var noteikt skriptā.Noklusējums funkcionālo testu komplektam. Pareizā izvēle, lai darbinātu ķēdes loģiku bez verificētāja un bez reālas secināšanas.
-validationapi=desktopHibrīds. Quick pārbaudes notiek procesa iekšienē; Full un Model tiek nosūtītas lokālam HTTPS verificētājam (noklusējuma darbvirsmas binārais fails). ZMQ brokeris nav vajadzīgs.Demonstrācijas uz viena datora, kurām vajag reālu Quick un Smell pārbaudi, nedarbinot atsevišķu verificētāja pakalpojumu.

Pirmajai iepazīšanai ar ķēdes loģiku pareizā atbilde ir mock. Pārējā lapa to pieņem, ja nav norādīts citādi.

A ceļš · tikai Core ar imitētu validāciju

Vismazāk sarežģījumu. Viens C++ dēmons: bez docker, bez GPU, bez modeļu failiem diskā. Ar to pietiek visām šīs lapas pamācībām.

1. Uzbūvējiet dēmonu

Izpildiet Bitcoin Core būvēšanas instrukcijas, izmantojot services/core-node/bcore/. TensorCash kods tiek būvēts ar to pašu CMake mērķi kā upstream; atsevišķa karoga nav.

2. Palaidiet regtest mezglu

Šie karogi atkārto to, ko test_framework/test_tensorcash.py padod katram funkcionālajam testam, tāpēc viss, kas darbojas tur, darbojas arī šeit. Noklusējuma imitētās atbildes ir fiksētas uz green, tāpēc bloku pieņemšana ir deterministiska.

./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. Sazinieties ar mezglu

Autentifikācijai izmanto sīkdatnes failu $HOME/.tensorcash-regtest/regtest/.cookie, ko bitcoin-cli nolasa automātiski, ja padodat -datadir. RPC ports ir upstream regtest noklusējums — 18443.

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

B ceļš · pilns lokālais steks (docker compose)

Kad ar imitāciju nepietiek: reāls verificētāja process, reāls modelis, kas veic secināšanu, un pievienota racēja API. Repozitorija saknē ir palaišanas skripti Mac datoriem un Linux ar CUDA.

Uz Apple silicon palaidējs lejupielādē llama.cpp būvējumu un palaiž pilnu core-node + miner-api + verification-api compose steku:

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 ar NVIDIA GPU launch_linux.sh dara to pašu, bet llama.cpp vietā izmanto uz vLLM balstītu verificētāju:

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 fails piesaista resursdatora portus 8333 (P2P), 8050 (core-node REST API) un 7067 (ZMQ). Verificētājs nodrošina savu Verifier REST API pats sava konteinera portā.

C ceļš · funkcionālo testu komplekta palaišana

Kad dēmons ir uzbūvēts (A ceļš, 1. solis), testu izpildītājs pats palaiž vienreizējus mezglus. Noder, ja vēlaties pārbaudītu secību, ko kopēt, nevis dēmonu, ar ko eksperimentēt.

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 testi ir grupēti pēc saskarnes: modeļu dzīves cikls, protokola aktīvi, fair-sign adapteri un covenant repo maciņš. Katrs ir patstāvīgs scenārijs, ko var izlasīt no sākuma līdz beigām; zemāk esošās pamācības norāda uz raksturīgākajiem.

Pamācības

Trīs īsas secības, izmantojot A ceļa imitācijas mezglu. Katra ir skice; saistītais funkcionālais tests ir pilns, izpildāms scenārijs.

Iegūstiet savu pirmo bloku

Kanoniskais tests: wallet_basic.py

Bez izmaiņām salīdzinājumā ar Bitcoin Core. Ātra darbspējas pārbaude pirms jebkādām TensorCash specifiskām saskarnēm: tā apstiprina, ka dēmons darbojas un maciņā ir līdzekļi.

Skar: 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)

Reģistrējiet modeli no sākuma līdz beigām

Kanoniskais tests: feature_model_registration.py

Specifisks TensorCash. Modeli reģistrē, nododot depozītu glabāšanā (escrow), savācot sekmīgas Quick un Model verifikācijas N commit darījumos un pēc verifikācijas loga aizvēršanās pārejot uz statusu registered. Ar -validationapi=mock katru soli var vadīt ar RPC, bez reāla verificētāja vai GPU. Šis ir izklāsts; pilns scenārijs ir saistītajā testā.

Skar: 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, ...}

Emitējiet protokola aktīvu

Kanoniskais tests: feature_assets_basic_highlevel.py

Specifisks TensorCash. registerasset ir augsta līmeņa maciņa RPC, kas izveido depozīta un ICU izejas, pievieno emitenta reģistrācijas TLV un pārraida darījumu. Pēc viena apstiprinājuma aktīvu var vaicāt pēc ID vai tikera. Pilns dzīves cikls (kalšana, pārsūtīšana, sadedzināšana) ir saistītajā testā.

Skar: 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

Karogu atsauce

A ceļa karogi, kas atšķiras no parastas bitcoind -regtest sesijas. Patiesības avots: test_framework/test_tensorcash.py un init.cpp.

KarogsKāpēc tas svarīgi regtest vidē
-regtestIzvēlas regtest ķēdi (bloka subsīdija, tūlītējas brieduma noteikumi un tikai lokālie porti 18443/18444).
-vdfspvcommitmentheight=0Aktivizē VDF/SPV no ģenēzes bloka, nevis no galvenā tīkla pakāpeniskās aktivizācijas augstuma.
-vdfspvvdfverifyheight=0Aktivizē VDF pārbaudi no ģenēzes bloka.
-maxtipage=999999Pieņem vecus laika zīmogus, tāpēc restarts uz novecojušas ķēdes neizskatās pēc nesinhronizēta mezgla.
-spv-asn-min=1Pazemina ASN apstiprinājuma slieksni; bez tā regtest bloķē VDF SPV pārslēgšanās loģiku.
-spv-hysteresis-base-bps=0Noņem bāzes rezerves histerēzi, tāpēc reorganizācijas testos ir tūlītējas un deterministiskas.
-spv-reorg-sampling-threshold=999Faktiski atslēdz dziļo reorganizāciju bloku satura izlases pārbaudi, ko nelielos augstumos praktiski nav iespējams darbināt.
-useextapi=0Atslēdz ārējo racēja API: tikai ķēdes pamācībām tā nav vajadzīga, un palaišana kļūst ātrāka.
-debug=net,validationReģistrē regtest sesijai noderīgākās rindas: tīklošanu un validācijas konveijeru.
-par=1Vienpavediena validācija. Novērš vienu tikai testiem raksturīgu nestabilitātes veidu, neietekmējot pareizību.

Kur tālāk

  • JSON-RPC atsaucePilns metožu rādītājs, sakārtots pa grupām, ar stabilitātes atzīmēm un curl piemēriem.
  • Verifier REST APIKad pārejat no -validationapi=mock uz reālu verificētāja procesu.
  • FlatBuffer shēmasFlatBuffer IDL un JSON Schema ZMQ datiem starp mezglu un verificētāju.
  • bcore/test/functional/Lasiet testus kā specifikāciju.
  • Testa tīkla krānsTiešsaistes alternatīva: papildiniet maciņu koplietotajā testa tīklā, ja lokālas smilšu kastes vietā vajag reālu ķēdi.