Regtest vodič

Tri puta za lokalni razvoj, poredana od najjednostavnijeg. Svaki ti daje TensorCash JSON-RPC koji možeš pozivati preko bitcoin-cli ili bilo kojeg JSON-RPC klijenta. Skup funkcionalnih testova u bcore-u je kanonska, izvršiva specifikacija za sve ispod, a svaki vodič upućuje na test iz kojeg je izveden.

Samo Core · docker compose · funkcionalni testovi

Načini validacije

TensorCash dodaje eksterni korak validacije prihvatanju bloka. -validationapi bira backend koji ga izvršava i to je najvažniji izbor za lokalno pokretanje: odlučuje da li ti treba GPU, proces verifikatora ili ništa od toga.

FlagŠta je toKada ga koristiti
-validationapi=realZadano. Komunicira s eksternim verifikatorom preko ZMQ PUSH/PULL kanala od čvora do verifikatora, koristeći FlatBuffers. Produkcijska postavka.Zahtijeva stvarni proces verifikatora. Koristi se na mainnetu, testnetu i u svakom regtest pokretanju koje uključuje stvarni replay modela.
-validationapi=mockUnutar procesa i determinističko. Mock backend izlaže tri RPC-a (validationmockdefault, validationmockclear, validationmockrequests) za unaprijed pripremljene Quick, Full i Model odgovore; uz startne flagove -mockval-default-* svaki ishod verifikacije se može skriptovati.Zadano za skup funkcionalnih testova. Pravi izbor za pokretanje logike lanca bez verifikatora ili stvarne inferencije.
-validationapi=desktopHibridno. Quick provjere se izvršavaju unutar procesa; Full i Model se šalju lokalnom HTTPS verifikatoru (zadani desktop binarni program). ZMQ broker nije potreban.Demonstracije na jednoj mašini kojima treba stvarni Quick i Smell prolaz bez upravljanja zasebnim servisom verifikatora.

Za prvi pogled na logiku lanca, mock je pravi odgovor. Ostatak ove stranice to podrazumijeva, osim ako nije drugačije navedeno.

Put A · samo Core, s mock validacijom

Najjednostavniji put. Jedan C++ daemon: bez dockera, bez GPU-a, bez datoteka modela na disku. Dovoljno za svaki vodič na ovoj stranici.

1. Izgradi daemon

Slijedi uputstva za izgradnju za Bitcoin Core u direktoriju services/core-node/bcore/. TensorCash kod se gradi pod istim CMake targetom kao upstream; nema posebnog flaga.

2. Pokreni regtest čvor

Ovi flagovi odgovaraju onome što test_framework/test_tensorcash.py prosljeđuje svakom funkcionalnom testu, pa sve što radi tamo radi i ovdje. Zadani mock odgovori su fiksirani na green, pa je prihvatanje blokova determinističko.

./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. Komuniciraj s njim

Autentifikacija koristi cookie datoteku na $HOME/.tensorcash-regtest/regtest/.cookie, koju bitcoin-cli čita automatski kad proslijediš -datadir. RPC port je upstream regtest zadana vrijednost, 18443.

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

Put B · kompletan lokalni stack (docker compose)

Za kad mock nije dovoljan: stvarni proces verifikatora, stvarni model koji izvršava inferenciju i povezan miner API. U korijenu repozitorija nalaze se skripte za pokretanje za Mac i za Linux s CUDA-om.

Na Apple siliconu skripta za pokretanje preuzima llama.cpp build i podiže kompletan compose stack 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 s NVIDIA GPU-ovima, launch_linux.sh radi isto, ali s verifikatorom zasnovanim na vLLM-u umjesto 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

Compose datoteka vezuje portove hosta 8333 (P2P), 8050 (core-node REST API) i 7067 (ZMQ). Verifikator služi svoj Verifier REST API na vlastitom portu kontejnera.

Put C · pokreni skup funkcionalnih testova

Kad je daemon izgrađen (Put A, korak 1), test runner umjesto tebe pokreće privremene čvorove. Korisno kad želiš provjereno ispravan redoslijed koraka za kopiranje, a ne daemon s kojim ćeš eksperimentisati.

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 testovi su grupisani po interfejsu: životni ciklus modela, nativna imovina, fair-sign adaptori i covenant repo novčanik. Svaki je samostalan scenarij koji možeš čitati od početka do kraja; vodiči ispod upućuju na one najreprezentativnije.

Vodiči korak po korak

Tri kratka niza koraka na mock čvoru iz Puta A. Svaki je skica; povezani funkcionalni test je kompletan, izvršiv scenarij.

Izrudari svoj prvi blok

Kanonski test: wallet_basic.py

Nepromijenjeno u odnosu na Bitcoin Core. Smoke test prije bilo kojeg interfejsa specifičnog za TensorCash: potvrđuje da daemon radi i da novčanik ima sredstva.

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

Registruj model od početka do kraja

Kanonski test: feature_model_registration.py

Specifično za TensorCash. Model se registruje tako što se depozit zaključa u escrow i prikupe uspješne Quick i Model verifikacije kroz N commitova; kad se prozor verifikacije zatvori, model prelazi u registered. Uz -validationapi=mock svaki korak možeš pokretati preko RPC-ova, bez stvarnog verifikatora ili GPU-a. Ovo je pregled; povezani test sadrži kompletan scenarij.

Obuhvata: 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 nativnu imovinu

Kanonski test: feature_assets_basic_highlevel.py

Specifično za TensorCash. registerasset je RPC novčanika visokog nivoa koji gradi bond i ICU izlaze, prilaže TLV registracije emitenta i emituje transakciju. Nakon jedne potvrde imovina se može pretraživati po id-u ili tickeru. Kompletan životni ciklus (kovanje, prijenos, spaljivanje) nalazi se u povezanom testu.

Obuhvata: 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 flagova

Flagovi iz Puta A koji se razlikuju od obične bitcoind -regtest sesije. Izvor istine: test_framework/test_tensorcash.py i init.cpp.

FlagZašto je važno u regtestu
-regtestBira regtest lanac (subvencija bloka, pravila trenutnog sazrijevanja i isključivo lokalni portovi 18443/18444).
-vdfspvcommitmentheight=0Aktivira VDF/SPV od genesis bloka umjesto od visine na kojoj se postepeno uvodi na mainnetu.
-vdfspvvdfverifyheight=0Aktivira VDF verifikaciju od genesis bloka.
-maxtipage=999999Prihvata stare vremenske oznake, pa ponovno pokretanje na zastarjelom lancu ne izgleda kao nesinhronizovan čvor.
-spv-asn-min=1Snižava donju granicu ASN potvrde; bez toga regtest blokira logiku prebacivanja VDF SPV.
-spv-hysteresis-base-bps=0Uklanja histerezu osnovne margine, pa su reorgi u testovima trenutni i deterministički.
-spv-reorg-sampling-threshold=999Praktično isključuje uzorkovanje tijela kod dubokih reorga, koje je nepraktično pokretati na malim visinama.
-useextapi=0Isključuje eksterni miner API: nije potreban za vodiče koji koriste samo lanac, a skraćuje pokretanje.
-debug=net,validationBilježi najkorisnije linije za regtest sesiju: mrežu i validacijski pipeline.
-par=1Jednonitna validacija. Uklanja jednu klasu nestabilnosti koja se javlja samo u testovima, bez uticaja na ispravnost.

Kuda dalje

  • JSON-RPC referencaKompletan indeks metoda, organizovan po grupama, s oznakama stabilnosti i curl primjerima.
  • Verifier REST APIKad s -validationapi=mock prelaziš na stvarni proces verifikatora.
  • FlatBuffer šemeFlatBuffer IDL i JSON Schema za ZMQ payloade od čvora do verifikatora.
  • bcore/test/functional/Čitaj testove kao specifikaciju.
  • Faucet za testnetOnline pandan: napuni novčanik na zajedničkom testnetu kad želiš živi lanac umjesto lokalnog sandboxa.