Regtest-opas

Kolme paikallisen kehityksen polkua vaivattomimmasta alkaen. Jokainen tarjoaa sinulle TensorCashin JSON-RPC:n, jota voit kutsua bitcoin-cli:llä tai millä tahansa JSON-RPC-asiakkaalla. bcoren funktionaalitestisarja on kaiken alla olevan kanoninen, suoritettava määrittely, ja jokainen läpikäynti linkittää testiin, josta se on tiivistetty.

Pelkkä Core · docker compose · funktionaalitestit

Validointitilat

TensorCash lisää lohkojen hyväksyntään ulkoisen validointivaiheen. -validationapi valitsee sen palvelevan taustajärjestelmän, ja se on paikallisen ajon tärkein valinta: se ratkaisee, tarvitsetko GPU:n, todentajaprosessin vai et kumpaakaan.

LippuMitä se onMilloin sitä käytetään
-validationapi=realOletus. Keskustelee ulkoisen todentajan kanssa solmun ja todentajan välisen ZMQ PUSH/PULL -kanavan kautta FlatBuffersilla. Tuotantoasetus.Vaatii oikean todentajaprosessin. Käytössä mainnetissä, testnetissä ja kaikissa regtest-ajoissa, joissa toistetaan oikean mallin ajo.
-validationapi=mockProsessin sisäinen ja deterministinen. Mock-taustajärjestelmä tarjoaa kolme RPC:tä (validationmockdefault, validationmockclear, validationmockrequests) valmiille Quick-, Full- ja Model-vastauksille; -mockval-default-*-käynnistyslipuilla jokaisen todennuksen lopputulos on skriptattavissa.Funktionaalitestisarjan oletus. Oikea valinta, kun haluat ajaa ketjulogiikkaa ilman todentajaa tai oikeaa päättelyä.
-validationapi=desktopHybridi. Quick-tarkistukset ajetaan prosessin sisällä; Full ja Model lähetetään paikalliselle HTTPS-todentajalle (työpöytäbinäärin oletus). ZMQ-välittäjää ei tarvita.Yhden koneen demot, joissa halutaan oikea Quick- ja Smell-läpikäynti ilman erillistä todentajapalvelua.

Ensimmäiseen tutustumiseen ketjulogiikkaan mock on oikea vastaus. Sivun loppuosa olettaa sen, ellei toisin mainita.

Polku A · pelkkä Core mock-validoinnilla

Vähiten vaivaa. Yksi C++-daemon: ei dockeria, ei GPU:ta, ei mallitiedostoja levyllä. Riittää kaikkiin tämän sivun läpikäynteihin.

1. Käännä daemon

Käännä services/core-node/bcore/ Bitcoin Coren ohjeiden mukaan: käännösohjeet. TensorCashin koodi kääntyy samassa CMake-kohteessa kuin upstream; erillistä lippua ei ole.

2. Käynnistä regtest-solmu

Nämä liput vastaavat sitä, mitä test_framework/test_tensorcash.py antaa jokaiselle funktionaalitestille, joten kaikki siellä toimiva toimii myös täällä. Mockin oletusvastaukset on lukittu vihreiksi, joten lohkojen hyväksyntä on deterministinen.

./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. Ota yhteys solmuun

Tunnistautuminen käyttää cookie-tiedostoa $HOME/.tensorcash-regtest/regtest/.cookie, jonka bitcoin-cli lukee automaattisesti, kun annat -datadir-lipun. RPC-portti on upstreamin regtest-oletus 18443.

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

Polku B · koko paikallinen pino (docker compose)

Kun mock ei riitä: oikea todentajaprosessi, oikea malli ajamassa päättelyä ja louhinta-API kytkettynä. Repositorion juuressa on käynnistysskriptit Macille ja CUDA-Linuxille.

Apple siliconilla käynnistin hakee llama.cpp-käännöksen ja nostaa ylös koko core-node + miner-api + verification-api -compose-pinon:

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

Linuxissa NVIDIA-GPU:illa launch_linux.sh tekee saman, mutta llama.cpp:n sijaan käytetään vLLM-pohjaista todentajaa:

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-tiedosto sitoo isäntäkoneen portit 8333 (P2P), 8050 (core-node REST API) ja 7067 (ZMQ). Todentaja tarjoaa rajapintansa (Verifier REST API) omassa konttiportissaan.

Polku C · aja funktionaalitestisarja

Kun daemon on käännetty (polku A, vaihe 1), testiajuri käynnistää kertakäyttöiset solmut puolestasi. Hyödyllinen, kun haluat kopioida toimivaksi tiedetyn sekvenssin etkä tutkia daemonia käsin.

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)

TensorCashin testit on ryhmitelty rajapinnoittain: mallien elinkaari, natiivit omaisuuserät, fair-sign-adaptorit ja kovenanttipohjainen repo-lompakko. Jokainen on itsenäinen skenaario, jonka voi lukea alusta loppuun; alla olevat läpikäynnit osoittavat edustavimpiin.

Läpikäynnit

Kolme lyhyttä sekvenssiä polun A mock-solmua vasten. Jokainen on luonnos; linkitetty funktionaalitesti on koko suoritettava skenaario.

Louhi ensimmäinen lohkosi

Kanoninen testi: wallet_basic.py

Ennallaan Bitcoin Coresta. Savutesti ennen TensorCash-kohtaisia rajapintoja: se varmistaa, että daemon on käynnissä ja lompakossa on varoja.

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

Rekisteröi malli alusta loppuun

Kanoninen testi: feature_model_registration.py

TensorCash-kohtainen. Malli rekisteröidään asettamalla talletus sulkutilille ja keräämällä onnistuneita Quick- ja Model-todennuksia N commitin ajan, minkä jälkeen se siirtyy tilaan registered, kun todennusikkuna sulkeutuu. Asetuksella -validationapi=mock voit ajaa jokaisen vaiheen RPC-kutsuilla ilman oikeaa todentajaa tai GPU:ta. Tämä on yleiskuvaus; linkitetty testi sisältää koko skenaarion.

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

Laske liikkeeseen natiivi omaisuuserä

Kanoninen testi: feature_assets_basic_highlevel.py

TensorCash-kohtainen. registerasset on korkean tason lompakko-RPC, joka rakentaa vakuus- ja ICU-outputit, liittää liikkeeseenlaskijan rekisteröinti-TLV:n ja lähettää transaktion. Yhden vahvistuksen jälkeen omaisuuserää voi hakea tunnisteella tai tickerillä. Koko elinkaari (lyönti, siirto, poltto) on linkitetyssä testissä.

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

Lippujen referenssi

Polun A liput, jotka eroavat tavallisesta bitcoind -regtest -istunnosta. Ensisijainen lähde: test_framework/test_tensorcash.py ja init.cpp.

LippuMiksi sillä on väliä regtestissä
-regtestValitsee regtest-ketjun (lohkotuki, välittömät kypsymissäännöt ja vain paikalliset portit 18443/18444).
-vdfspvcommitmentheight=0Aktivoi VDF/SPV:n genesiksestä alkaen mainnetin porrastetun korkeuden sijaan.
-vdfspvvdfverifyheight=0Aktivoi VDF-todennuksen genesiksestä alkaen.
-maxtipage=999999Hyväksyy vanhat aikaleimat, joten uudelleenkäynnistys vanhentuneella ketjulla ei näytä synkronoimattomalta solmulta.
-spv-asn-min=1Laskee ASN-vahvistuksen alarajaa; ilman sitä regtest estää VDF SPV -vaihtologiikan.
-spv-hysteresis-base-bps=0Poistaa perusmarginaalin hystereesin, joten testien reorgit ovat välittömiä ja deterministisiä.
-spv-reorg-sampling-threshold=999Käytännössä poistaa syvien reorgien lohkosisällön otannan, jota on epäkäytännöllistä ajaa pienillä korkeuksilla.
-useextapi=0Poistaa ulkoisen louhinta-API:n käytöstä: sitä ei tarvita pelkkää ketjua koskevissa läpikäynneissä, ja se lyhentää käynnistystä.
-debug=net,validationKirjaa regtest-istunnon hyödyllisimmät rivit: verkkoliikenteen ja validointiputken.
-par=1Yksisäikeinen validointi. Poistaa yhden testeille ominaisen epävakauden luokan vaikuttamatta oikeellisuuteen.

Mihin seuraavaksi

  • JSON-RPC-referenssiKoko metodiluettelo ryhmittäin, vakausmerkintöineen ja curl-esimerkkeineen.
  • Verifier REST APIKun siirryt asetuksesta -validationapi=mock oikeaan todentajaprosessiin.
  • FlatBuffer-skeematFlatBuffer-IDL ja JSON Schema solmun ja todentajan välisille ZMQ-sisällöille.
  • bcore/test/functional/Lue testit määrittelynä.
  • Testnet-faucetVerkossa toimiva vastine: rahoita lompakko jaetussa testnetissä, kun haluat toiminnassa olevan ketjun paikallisen hiekkalaatikon sijaan.