Regtesti juhend

Kolm kohaliku arenduse teed, järjestatud vaeva järgi. Igaüks annab sulle TensorCashi JSON-RPC, mida saad kutsuda bitcoin-cli või mis tahes JSON-RPC kliendiga. Bcore'i funktsionaaltestide komplekt on kanooniline, käivitatav spetsifikatsioon kõigele, mida allpool kirjeldatakse ja iga juhis viitab testile, millest see on tuletatud.

Ainult Core · docker compose · funktsionaaltestid

Valideerimisrežiimid

TensorCash lisab plokkide aktsepteerimisele välise valideerimissammu. -validationapi valib taustasüsteemi, mis seda teenindab, ja see on kohaliku käivituse kõige olulisem valik: see otsustab, kas vajad GPU-d, valideerijaprotsessi või kumbagi mitte.

LippMis see onMillal kasutada
-validationapi=realVaikevalik. Suhtleb välise valideerijaga sõlme ja valideerija vahelise ZMQ PUSH/PULL kanali kaudu, kasutades FlatBuffersit. Tootmisseadistus.Vajab päris valideerijaprotsessi. Kasutusel mainnetis, testnetis ja igas regtesti käivituses, mis kasutab päris mudeli taasesitust.
-validationapi=mockProtsessisisene ja deterministlik. Mock-taustasüsteem pakub kolme RPC-d (validationmockdefault, validationmockclear, validationmockrequests) valmis Quick-, Full- ja Model-vastuste jaoks; käivituslippudega -mockval-default-* on iga kontrolli tulemus skriptitav.Funktsionaaltestide komplekti vaikevalik. Õige valik ahela loogika käitamiseks ilma valideerija või päris järelduseta.
-validationapi=desktopHübriid. Quick-kontrollid jooksevad protsessi sees; Full ja Model saadetakse kohalikule HTTPS-valideerijale (vaikimisi töölauarakendus). ZMQ maaklerit pole vaja.Ühe masina demod, mis tahavad päris Quick- ja Smell-kontrolli ilma eraldi valideerimisteenust haldamata.

Ahela loogikaga esmatutvuseks on õige vastus mock. Ülejäänud leht eeldab seda, kui pole öeldud teisiti.

Tee A · ainult Core, mock-valideerimisega

Kõige väiksema vaevaga. Üks C++ daemon: ei dockerit, GPU-d ega mudelifaile kettal. Sellest piisab kõigi selle lehe juhiste jaoks.

1. Ehita daemon

Ehitamiseks vt Bitcoin Core'i ehitusjuhised ja rakenda need kataloogile services/core-node/bcore/. TensorCashi kood ehitatakse sama CMake'i sihtmärgi all nagu upstream; eraldi lippu ei ole.

2. Käivita regtest-sõlm

Need lipud peegeldavad seda, mida test_framework/test_tensorcash.py igale funktsionaaltestile edastab, nii et kõik, mis seal töötab, töötab ka siin. Vaikimisi mock-vastused on fikseeritud roheliseks, seega on plokkide aktsepteerimine deterministlik.

./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. Suhtle sõlmega

Autentimiseks kasutatakse küpsisefaili $HOME/.tensorcash-regtest/regtest/.cookie, mille bitcoin-cli loeb automaatselt, kui annad ette -datadir. RPC-port on upstreami regtesti vaikeport 18443.

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

Tee B · kogu kohalik virn (docker compose)

Kui mock-ist ei piisa: päris valideerijaprotsess, päris mudel, mis teenindab järeldusi, ja ühendatud kaevuri API. Repositooriumi juurkataloogis on käivitusskriptid Macile ja CUDA-ga Linuxile.

Apple silicon'il tõmbab käivitaja llama.cpp ehituse ja paneb püsti kogu core-node + miner-api + verification-api compose-virna:

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-dega Linuxil teeb launch_linux.sh sama, kuid llama.cpp asemel vLLM-põhise valideerijaga:

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-fail seob hosti pordid 8333 (P2P), 8050 (core-node REST API) ja 7067 (ZMQ). Valideerija pakub oma liidest (Verifier REST API) oma konteineri pordil.

Tee C · käivita funktsionaaltestide komplekt

Kui daemon on ehitatud (tee A, samm 1), käivitab testijooksutaja sinu eest ühekordsed sõlmed. Kasulik, kui tahad kopeerida teadaolevalt töötavat järjestust, mitte daemonit ise torkida.

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)

TensorCashi testid on rühmitatud liidese järgi: mudeli elutsükkel, natiivsed varad, fair-sign adapterid ja covenant-põhine repo-rahakott. Iga test on iseseisev stsenaarium, mida saab lugeda algusest lõpuni; allpool olevad juhised osutavad kõige iseloomulikumatele.

Juhised samm-sammult

Kolm lühikest järjestust tee A mock-sõlme vastu. Iga juhis on visand; lingitud funktsionaaltest on täielik, käivitatav stsenaarium.

Kaevanda oma esimene plokk

Kanooniline test: wallet_basic.py

Bitcoin Core'iga võrreldes muutmata. Suitsutest enne ühtegi TensorCashi-spetsiifilist liidest: see kinnitab, et daemon töötab ja rahakotis on raha.

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

Registreeri mudel algusest lõpuni

Kanooniline test: feature_model_registration.py

TensorCashi-spetsiifiline. Mudel registreeritakse nii: deponeeritakse tagatisraha, kogutakse N commiti jooksul edukaid Quick- ja Model-kontrolle ning kui kontrolliaken sulgub, liigub mudel olekusse registered. Seadega -validationapi=mock saad iga sammu läbi teha RPC-de kaudu, ilma päris valideerija või GPU-ta. See on ülevaade; täielik stsenaarium on lingitud testis.

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

Emiteeri natiivne vara

Kanooniline test: feature_assets_basic_highlevel.py

TensorCashi-spetsiifiline. registerasset on kõrgtaseme rahakoti-RPC, mis ehitab tagatise ja ICU väljundid, lisab emitendi registreerimise TLV ja edastab tehingu. Pärast ühte kinnitust saab vara pärida ID või tickeri järgi. Kogu elutsükkel (mint, ülekanne, põletamine) on lingitud testis.

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

Lippude viide

Tee A lipud, mis erinevad tavalisest bitcoind -regtest seansist. Tõeallikas: test_framework/test_tensorcash.py ja init.cpp.

LippMiks see regtestis oluline on
-regtestValib regtesti ahela (plokisubsiidium, kohese küpsemise reeglid ja ainult kohalikud pordid 18443/18444).
-vdfspvcommitmentheight=0Aktiveerib VDF/SPV alates geneesist, mitte mainneti etapiviisilisel kõrgusel.
-vdfspvvdfverifyheight=0Aktiveerib VDF-kontrolli alates geneesist.
-maxtipage=999999Aktsepteerib vanu ajatempleid, nii et vananenud ahelal taaskäivitamine ei paista sünkroonimata sõlmena.
-spv-asn-min=1Langetab ASN-i kinnituse alampiiri; ilma selleta blokeerib regtest VDF SPV ümberlülitusloogika.
-spv-hysteresis-base-bps=0Eemaldab baasmarginaali hüstereesi, nii et reorgid testides on kohesed ja deterministlikud.
-spv-reorg-sampling-threshold=999Lülitab sisuliselt välja sügavate reorgide kehavalimi, mida väikestel kõrgustel on ebapraktiline käivitada.
-useextapi=0Lülitab välja välise kaevuri API: ainult ahelaga tehtavate juhiste jaoks pole seda vaja ja käivitus läheb kiiremaks.
-debug=net,validationLogib regtesti seansi jaoks kõige kasulikumad read: võrgusuhtluse ja valideerimiskonveieri.
-par=1Ühelõimeline valideerimine. Kõrvaldab ühe klassi ainult testides esinevat ebastabiilsust, mõjutamata korrektsust.

Kuhu edasi

  • JSON-RPC viideTäielik meetodite register, rühmitatud kategooriate kaupa, stabiilsusmärgiste ja curl-näidetega.
  • Verifier REST APIKui liigud -validationapi=mock pealt päris valideerijaprotsessile.
  • FlatBufferi skeemidFlatBufferi IDL ja JSON Schema sõlme ja valideerija vaheliste ZMQ-sõnumite jaoks.
  • bcore/test/functional/Loe teste kui spetsifikatsiooni.
  • Testneti faucetVeebipõhine vaste: täida rahakott jagatud testnetis, kui tahad kohaliku liivakasti asemel päris ahelat.