Regtest-guide

Tre lokale udviklingsveje, sorteret efter hvor nemme de er. Hver af dem giver dig en TensorCash JSON-RPC, som du kan kalde med bitcoin-cli eller en hvilken som helst JSON-RPC-klient. Bcores funktionelle testsuite er den kanoniske, eksekverbare specifikation for alt nedenfor, og hver gennemgang linker til den test, den er udledt af.

Kun Core · docker compose · funktionelle test

Valideringstilstande

TensorCash tilføjer et eksternt valideringstrin til blokaccept. -validationapi vælger den backend, der udfører det, og det er det vigtigste valg ved en lokal kørsel: det afgør, om du skal bruge en GPU, en verifier-proces eller ingen af delene.

FlagHvad det erHvornår du bruger det
-validationapi=realStandarden. Taler med en ekstern verifier over ZMQ PUSH/PULL-kanalen mellem node og verifier med FlatBuffers. Indstillingen i produktion.Kræver en rigtig verifier-proces. Bruges på mainnet, testnet og i alle regtest-kørsler, der afprøver rigtig genafspilning af modeller.
-validationapi=mockI processen og deterministisk. Mock-backenden har tre RPC'er (validationmockdefault, validationmockclear, validationmockrequests) til forudindstillede Quick-, Full- og Model-svar; med opstartsflagene -mockval-default-* kan hvert verifikationsudfald styres med script.Standarden for den funktionelle testsuite. Det rigtige valg, når du vil drive kædelogikken uden en verifier eller rigtig inferens.
-validationapi=desktopHybrid. Quick-tjek kører i processen; Full og Model sendes til en lokal HTTPS-verifier (standard-desktopprogrammet). Ingen ZMQ-broker nødvendig.Demoer på én maskine, der skal have en rigtig Quick- og Smell-kontrol uden at drive en separat verifier-tjeneste.

Til et første kig på kædelogikken er mock det rigtige svar. Resten af siden går ud fra det, medmindre andet er angivet.

Vej A · kun Core, med mock-validering

Den nemmeste vej. Én C++-daemon: ingen docker, ingen GPU, ingen modelfiler på disken. Nok til alle gennemgange på denne side.

1. Byg daemon'en

Følg Bitcoin Cores byggevejledning for services/core-node/bcore/. TensorCash-koden bygges under samme CMake-target som upstream; der er ikke noget separat flag.

2. Start en regtest-node

Disse flag svarer til det, test_framework/test_tensorcash.py giver hver funktionel test, så alt, hvad der kører der, kører også her. Standardsvarene fra mock er låst til grøn, så blokaccept er deterministisk.

./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. Tal med den

Godkendelse bruger cookie-filen i $HOME/.tensorcash-regtest/regtest/.cookie, som bitcoin-cli læser automatisk, når du angiver -datadir. RPC-porten er upstreams regtest-standard, 18443.

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

Vej B · hele den lokale stak (docker compose)

Når mock ikke er nok: en rigtig verifier-proces, en rigtig model, der leverer inferens, og miner-API'et koblet på. Repositoriets rod har startscripts til Mac og til Linux med CUDA.

På Apple silicon henter startscriptet et llama.cpp-build og starter hele compose-stakken 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

På Linux med NVIDIA-GPU'er gør launch_linux.sh det samme, men med den vLLM-baserede verifier i stedet for 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-filen binder værtsportene 8333 (P2P), 8050 (core-node REST-API) og 7067 (ZMQ). Verifieren leverer sit Verifier REST-API på sin egen containerport.

Vej C · kør den funktionelle testsuite

Når daemon'en er bygget (vej A, trin 1), starter testrunneren engangsnoder for dig. Nyttigt, når du hellere vil kopiere en kendt, fungerende sekvens end eksperimentere med en 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-testene er grupperet efter grænseflade: modellernes livscyklus, native aktiver, fair-sign-adaptorer og covenant-repo-wallet'en. Hver test er et selvstændigt scenarie, du kan læse fra start til slut; gennemgangene nedenfor peger på de mest repræsentative.

Gennemgange

Tre korte sekvenser mod mock-noden fra vej A. Hver er en skitse; den linkede funktionelle test er det fulde, eksekverbare scenarie.

Generér din første blok

Kanonisk test: wallet_basic.py

Uændret fra Bitcoin Core. En røgtest før de TensorCash-specifikke grænseflader: den bekræfter, at daemon'en kører, og at wallet'en har midler.

Berører: 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)

Registrér en model fra start til slut

Kanonisk test: feature_model_registration.py

TensorCash-specifikt. En model registreres ved at deponere et depositum, samle vellykkede Quick- og Model-verifikationer over N commits og derefter gå over til registered, når verifikationsvinduet lukker. Med -validationapi=mock kan du drive hvert trin via RPC'er uden en rigtig verifier eller GPU. Dette er en skitse; den linkede test er det fulde scenarie.

Berører: 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, ...}

Udsted et native aktiv

Kanonisk test: feature_assets_basic_highlevel.py

TensorCash-specifikt. registerasset er wallet-RPC'en på højt niveau, der bygger bond- og ICU-outputs, vedhæfter udstederens registrerings-TLV og udsender transaktionen. Efter én bekræftelse kan aktivet slås op via id eller ticker. Hele livscyklussen (mint, overførsel, brænding) står i den linkede test.

Berører: 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

Flagreference

De flag fra vej A, der adskiller sig fra en almindelig bitcoind -regtest-session. Autoritativ kilde: test_framework/test_tensorcash.py og init.cpp.

FlagDerfor betyder det noget i regtest
-regtestVælger regtest-kæden (blokstøtte, regler for øjeblikkelig modenhed og de lokale porte 18443/18444).
-vdfspvcommitmentheight=0Aktiverer VDF/SPV fra genesis i stedet for fra den trinvise mainnet-højde.
-vdfspvvdfverifyheight=0Aktiverer VDF-verifikation fra genesis.
-maxtipage=999999Accepterer gamle tidsstempler, så en genstart på en forældet kæde ikke ligner en usynkroniseret node.
-spv-asn-min=1Sænker minimumskravet til ASN-bekræftelse; uden det blokerer regtest VDF-SPV-skiftelogikken.
-spv-hysteresis-base-bps=0Fjerner basismarginens hysterese, så reorgs i test sker øjeblikkeligt og deterministisk.
-spv-reorg-sampling-threshold=999Slår reelt stikprøvekontrollen af blokindhold ved dybe reorgs fra; den er upraktisk at drive ved små højder.
-useextapi=0Slår det eksterne miner-API fra: det er ikke nødvendigt til gennemgange, der kun handler om kæden, og opstarten bliver kortere.
-debug=net,validationLogger de mest nyttige linjer for en regtest-session: netværk og valideringspipelinen.
-par=1Enkelttrådet validering. Fjerner en klasse af ustabilitet, der kun opstår i test, uden at påvirke korrektheden.

Videre herfra

  • JSON-RPC-referenceDet fulde metodeindeks, ordnet efter kategori, med stabilitetsmærker og curl-eksempler.
  • Verifier REST-APINår du går fra -validationapi=mock til en rigtig verifier-proces.
  • FlatBuffer-skemaerFlatBuffer-IDL og JSON Schema for ZMQ-payloads mellem node og verifier.
  • bcore/test/functional/Læs testene som specifikationen.
  • Testnet-faucetOnline-modstykket: fyld en wallet op på det delte testnet, når du vil have en levende kæde i stedet for en lokal sandkasse.