Regtest-útmutató

Három helyi fejlesztési út, a legkisebb macerától haladva. Mindegyik egy TensorCash JSON-RPC-t ad a kezedbe, amelyet bitcoin-cli-vel vagy bármely JSON-RPC-klienssel hívhatsz. A bcore tesztcsomagja (funkcionális tesztcsomag) az alábbiak kanonikus, futtatható specifikációja, és minden végigvezető hivatkozik arra a tesztre, amelyből készült.

Csak Core · docker compose · funkcionális tesztek

Validációs módok

A TensorCash egy külső validációs lépést ad a blokkelfogadáshoz. A -validationapi választja ki az ezt kiszolgáló háttérrendszert, és ez a legfontosabb döntés egy helyi futtatásnál: ettől függ, hogy GPU-ra, verifier-folyamatra vagy egyikre sem lesz-e szükséged.

KapcsolóMi ezMikor használd
-validationapi=realAz alapértelmezés. Egy külső verifierrel kommunikál a node–verifier ZMQ PUSH/PULL csatornán, FlatBuffers használatával. Az éles beállítás.Valódi verifier-folyamat kell hozzá. Mainneten, testneten és minden olyan regtest-futásnál használatos, amely valódi modell-újrajátszást végez.
-validationapi=mockFolyamaton belüli és determinisztikus. A mock háttérrendszer három RPC-t ad (validationmockdefault, validationmockclear, validationmockrequests) előre megadott Quick, Full és Model válaszokhoz; a -mockval-default-* indítási kapcsolókkal minden ellenőrzési eredmény szkriptelhető.A funkcionális tesztcsomag alapértelmezése. A jó választás, ha a láncologikát verifier és valódi inferencia nélkül akarod kipróbálni.
-validationapi=desktopHibrid. A Quick ellenőrzések folyamaton belül futnak; a Full és a Model egy helyi HTTPS-verifierhez kerül (az alapértelmezett asztali bináris). ZMQ-brokerre nincs szükség.Egygépes demókhoz, amelyekhez valódi Quick és Smell lépés kell, de külön verifier-szolgáltatás üzemeltetése nélkül.

A láncologika első megismeréséhez a mock a jó választás. Az oldal további része ezt feltételezi, hacsak másként nem jelezzük.

A út · csak Core, mock-validációval

A legkisebb macera. Egyetlen C++ démon: nincs docker, nincs GPU, nincsenek modellfájlok a lemezen. Az oldal összes végigvezetőjéhez elég.

1. A démon lefordítása

Kövesd a Bitcoin Core útmutatóját (fordítási útmutató) a services/core-node/bcore/ könyvtárban. A TensorCash-kód ugyanazzal a CMake-targettel fordul, mint az upstream; külön kapcsoló nincs.

2. Regtest node indítása

Ezek a kapcsolók ugyanazok, amelyeket a test_framework/test_tensorcash.py minden funkcionális tesztnek átad, így ami ott fut, itt is futni fog. Az alapértelmezett mock-válaszok zöldre vannak rögzítve, ezért a blokkok elfogadása determinisztikus.

./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. Kommunikáció a node-dal

A hitelesítés a $HOME/.tensorcash-regtest/regtest/.cookie cookie-fájllal történik, amelyet a bitcoin-cli automatikusan beolvas, ha megadod a -datadir kapcsolót. Az RPC-port az upstream regtest alapértéke: 18443.

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

B út · a teljes helyi stack (docker compose)

Ha a mock már nem elég: valódi verifier-folyamat, inferenciát kiszolgáló valódi modell és bekötött miner API. A repó gyökerében indítószkriptek vannak Machez és CUDA-s Linuxhoz.

Apple Siliconon az indító letölt egy llama.cpp buildet, és elindítja a teljes core-node + miner-api + verification-api compose stacket:

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

NVIDIA GPU-s Linuxon a launch_linux.sh ugyanezt teszi, csak llama.cpp helyett a vLLM-alapú verifierrel:

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

A compose fájl a 8333 (P2P), a 8050 (core-node REST API) és a 7067 (ZMQ) hostportokat köti le. A verifier a saját konténerportján szolgálja ki ezt: Verifier REST API.

C út · a funkcionális tesztcsomag futtatása

Ha a démon már lefordult (A út, 1. lépés), a tesztfuttató eldobható node-okat indít helyetted. Akkor hasznos, ha egy bevált lépéssort szeretnél lemásolni, nem pedig egy démont piszkálni.

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)

A TensorCash-tesztek felületek szerint csoportosulnak: modell-életciklus, natív eszközök, fair-sign adaptorok és a covenantos repótárca. Mindegyik önálló forgatókönyv, amely elejétől a végéig olvasható; az alábbi végigvezetők a legjellemzőbbekre mutatnak.

Végigvezetők

Három rövid lépéssor az A út mock node-ján. Mindegyik csak vázlat; a teljes, futtatható forgatókönyv a hivatkozott funkcionális teszt.

Bányászd ki az első blokkodat

Kanonikus teszt: wallet_basic.py

Változatlanul a Bitcoin Core-ból. Füstteszt minden TensorCash-specifikus felület előtt: megerősíti, hogy a démon fut, és a tárcában van egyenleg.

Érintett elemek: 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)

Modell regisztrálása az elejétől a végéig

Kanonikus teszt: feature_model_registration.py

TensorCash-specifikus. Egy modell regisztrációja letét zárolásával kezdődik, majd N commiton át sikeres Quick és Model ellenőrzéseket gyűjt, végül az ellenőrzési ablak lezárultával registered állapotba kerül. -validationapi=mock mellett minden lépés RPC-kkel vezérelhető, valódi verifier vagy GPU nélkül. Ez csak vázlat; a teljes forgatókönyv a hivatkozott tesztben van.

Érintett elemek: 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, ...}

Natív eszköz kibocsátása

Kanonikus teszt: feature_assets_basic_highlevel.py

TensorCash-specifikus. A registerasset a magas szintű tárca-RPC, amely felépíti az óvadék- és ICU-kimeneteket, csatolja a kibocsátó regisztrációs TLV-jét, és szétküldi a tranzakciót. Egy megerősítés után az eszköz azonosító vagy ticker alapján lekérdezhető. A teljes életciklus (kibocsátás, átutalás, égetés) a hivatkozott tesztben található.

Érintett elemek: 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

Kapcsolók referenciája

Az A út azon kapcsolói, amelyek eltérnek egy sima bitcoind -regtest munkamenettől. Mérvadó forrás: test_framework/test_tensorcash.py és init.cpp.

KapcsolóMiért számít regtestben
-regtestA regtest láncot választja (blokkszubvenció, azonnali érési szabályok és a csak helyi 18443/18444-es portok).
-vdfspvcommitmentheight=0A VDF/SPV-t a genezistől aktiválja a lépcsőzetes mainnet-magasság helyett.
-vdfspvvdfverifyheight=0A VDF-ellenőrzést a genezistől aktiválja.
-maxtipage=999999Elfogadja a régi időbélyegeket, így egy elavult láncon való újraindítás nem tűnik szinkronizálatlan node-nak.
-spv-asn-min=1Csökkenti az ASN-megerősítési küszöböt; nélküle a regtest blokkolja a VDF SPV-váltási logikát.
-spv-hysteresis-base-bps=0Megszünteti az alapmargó-hiszterézist, így a tesztekben a reorgok azonnaliak és determinisztikusak.
-spv-reorg-sampling-threshold=999Gyakorlatilag kikapcsolja a mély reorgok blokktörzs-mintavételezését, amelyet kis magasságokon szinte lehetetlen előidézni.
-useextapi=0Kikapcsolja a külső miner API-t: csak láncot érintő végigvezetőkhöz nem kell, és gyorsabb tőle az indulás.
-debug=net,validationA regtest-munkamenet leghasznosabb sorait naplózza: a hálózatkezelést és a validációs folyamatot.
-par=1Egyszálú validáció. Megszüntet egy csak tesztekben jelentkező instabilitási osztályt, a helyességet nem érinti.

Merre tovább

  • JSON-RPC referenciaA teljes metódusjegyzék kategóriák szerint, stabilitási címkékkel és curl-példákkal.
  • Verifier REST APIAmikor a -validationapi=mock helyett valódi verifier-folyamatra váltasz.
  • FlatBuffer-sémákFlatBuffer IDL és JSON Schema a node–verifier ZMQ-üzenetekhez.
  • bcore/test/functional/Olvasd a teszteket specifikációként.
  • Testnet-faucetAz online megfelelő: tárca feltöltése a közös testneten, ha helyi sandbox helyett élő láncra van szükséged.