Vodnik za regtest

Tri poti za lokalni razvoj, razvrščene po zahtevnosti. Vsaka ti ponudi JSON-RPC TensorCash, ki ga kličeš z bitcoin-cli ali katerim koli odjemalcem JSON-RPC. Funkcionalni testni nabor bcore je kanonična, izvedljiva specifikacija za vse spodaj, vsak vodnik pa se sklicuje na test, iz katerega je povzet.

Samo Core · docker compose · funkcionalni testi

Načini validacije

TensorCash sprejemanju blokov doda zunanji korak validacije. -validationapi izbere zaledni sistem, ki ga izvaja, in je najpomembnejša izbira pri lokalnem zagonu: odloča, ali potrebuješ GPU, proces preverjevalca ali nič od tega.

ZastavicaKaj jeKdaj ga uporabiti
-validationapi=realPrivzeto. Komunicira z zunanjim preverjevalcem prek kanala ZMQ PUSH/PULL med vozliščem in preverjevalcem z uporabo FlatBuffers. Nastavitev za produkcijo.Potrebuje pravi proces preverjevalca. Uporablja se na mainnetu, testnetu in pri vsakem zagonu regtest, ki preizkuša pravo ponovno izvajanje modela.
-validationapi=mockV procesu in deterministično. Lažni zaledni sistem ponuja tri RPC-je (validationmockdefault, validationmockclear, validationmockrequests) za vnaprej pripravljene odgovore Quick, Full in Model; z zagonskimi zastavicami -mockval-default-* je vsak izid preverjanja mogoče skriptirati.Privzeto za funkcionalni testni nabor. Prava izbira za poganjanje logike verige brez preverjevalca ali pravega sklepanja.
-validationapi=desktopHibridno. Preverjanja Quick tečejo v procesu; Full in Model se pošljejo lokalnemu preverjevalcu HTTPS (privzeta namizna binarna datoteka). Posrednik ZMQ ni potreben.Predstavitve na enem računalniku, ki potrebujejo pravi prehod Quick in Smell, ne da bi upravljale ločeno storitev preverjevalca.

Za prvi pogled v logiko verige je mock pravi odgovor. Preostanek strani ga predpostavlja, razen kjer je navedeno drugače.

Pot A · samo Core, z lažno validacijo

Najmanj zapletov. En demon v C++: brez dockerja, brez GPU, brez datotek modelov na disku. Dovolj za vse vodnike na tej strani.

1. Zgradi demona

Za services/core-node/bcore/ sledi navodilom za gradnjo za Bitcoin Core. Koda TensorCash se gradi pod istim ciljem CMake kot upstream; ločene zastavice ni.

2. Zaženi vozlišče regtest

Te zastavice so enake tistim, ki jih test_framework/test_tensorcash.py poda vsakemu funkcionalnemu testu, zato vse, kar teče tam, teče tudi tukaj. Privzeti lažni odgovori so fiksirani na zeleno, zato je sprejemanje blokov deterministično.

./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. Poveži se z njim

Avtentikacija uporablja datoteko piškotka $HOME/.tensorcash-regtest/regtest/.cookie, ki jo bitcoin-cli samodejno prebere, ko podaš -datadir. Vrata RPC so privzeta vrata regtest iz upstreama, 18443.

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

Pot B · celoten lokalni sklad (docker compose)

Za primere, ko lažna validacija ni dovolj: pravi proces preverjevalca, pravi model, ki izvaja sklepanje, in priključen API rudarja. V korenu repozitorija so zagonski skripti za Mac in za Linux s CUDA.

Na Apple silicon zaganjalnik prenese gradnjo llama.cpp in zažene celoten sklad compose 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

Na Linuxu z grafičnimi karticami NVIDIA launch_linux.sh naredi isto, le s preverjevalcem na osnovi vLLM namesto 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

Datoteka compose veže vrata gostitelja 8333 (P2P), 8050 (core-node REST API) in 7067 (ZMQ). Preverjevalec svoj Verifier REST API streže na lastnih vratih vsebnika.

Pot C · poženi funkcionalni testni nabor

Ko je demon zgrajen (pot A, 1. korak), testni zaganjalnik sam zažene začasna vozlišča. Uporabno, ko želiš preverjeno zaporedje, ki ga lahko prepišeš, ne pa demona, s katerim bi eksperimentiral.

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)

Testi TensorCash so razvrščeni po vmesnikih: življenjski cikel modela, izvorna sredstva, adaptorji fair-sign in denarnica za repo posle s covenanti. Vsak je samostojen scenarij, ki ga lahko prebereš od začetka do konca; spodnji vodniki kažejo na najbolj reprezentativne.

Vodniki po korakih

Tri kratka zaporedja na lažnem vozlišču iz poti A. Vsako je le skica; povezani funkcionalni test je celoten, izvedljiv scenarij.

Narudari svoj prvi blok

Kanonični test: wallet_basic.py

Nespremenjeno glede na Bitcoin Core. Hiter preizkus pred katerim koli vmesnikom, specifičnim za TensorCash: potrdi, da demon teče in da ima denarnica sredstva.

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

Registriraj model od začetka do konca

Kanonični test: feature_model_registration.py

Posebnost TensorCash. Model se registrira tako, da se položi depozit v escrow, zberejo uspešna preverjanja Quick in Model v N zavezah, nato pa preide v registered, ko se okno preverjanja zapre. Z -validationapi=mock lahko vsak korak izvedeš prek RPC-jev, brez pravega preverjevalca ali GPU. To je oris; povezani test je celoten scenarij.

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

Izdaj izvorno sredstvo

Kanonični test: feature_assets_basic_highlevel.py

Posebnost TensorCash. registerasset je visokonivojski RPC denarnice, ki zgradi izhoda za varščino in ICU, pripne TLV registracije izdajatelja in transakcijo odda. Po eni potrditvi lahko sredstvo poiščeš po ID-ju ali oznaki. Celoten življenjski cikel (kovanje, prenos, sežig) je v povezanem testu.

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

Referenca zastavic

Zastavice iz poti A, ki se razlikujejo od navadne seje bitcoind -regtest. Vir resnice: test_framework/test_tensorcash.py in init.cpp.

ZastavicaZakaj je pomembna v regtestu
-regtestIzbere verigo regtest (subvencija bloka, pravila takojšnje zrelosti in samo lokalna vrata 18443/18444).
-vdfspvcommitmentheight=0Aktivira VDF/SPV od geneze namesto od postopne višine na mainnetu.
-vdfspvvdfverifyheight=0Aktivira preverjanje VDF od geneze.
-maxtipage=999999Sprejema stare časovne žige, zato ponovni zagon na zastareli verigi ni videti kot nesinhronizirano vozlišče.
-spv-asn-min=1Zniža spodnjo mejo potrjevanja ASN; brez tega regtest blokira logiko preklapljanja VDF SPV.
-spv-hysteresis-base-bps=0Odstrani histerezo osnovne meje, zato so reorgi v testih takojšnji in deterministični.
-spv-reorg-sampling-threshold=999Dejansko onemogoči vzorčenje teles pri globokih reorgih, ki ga pri majhnih višinah ni praktično sprožiti.
-useextapi=0Onemogoči zunanji API rudarja: za vodnike, ki uporabljajo samo verigo, ni potreben, zagon pa je hitrejši.
-debug=net,validationBeleži najbolj uporabne vrstice za sejo regtest: omrežje in cevovod validacije.
-par=1Enonitna validacija. Odpravi vrsto nestabilnosti, ki se pojavljajo samo v testih, brez vpliva na pravilnost.

Kam naprej

  • JSON-RPC referencaCeloten seznam metod, razvrščen po skupinah, z oznakami stabilnosti in primeri curl.
  • Verifier REST APIKo preideš z -validationapi=mock na pravi proces preverjevalca.
  • FlatBuffer shemeFlatBuffer IDL in JSON Schema za podatke ZMQ med vozliščem in preverjevalcem.
  • bcore/test/functional/Beri teste kot specifikacijo.
  • Faucet za testnetSpletni dvojnik: napolni denarnico na skupnem testnetu, ko namesto lokalnega peskovnika želiš živo verigo.