Guia de regtest

Tres camins de desenvolupament local, ordenats de més senzill a més complex. Cadascun et posa davant un JSON-RPC de TensorCash per cridar-lo amb bitcoin-cli o qualsevol client JSON-RPC. El conjunt de proves funcionals de bcore és l'especificació canònica i executable de tot el que segueix, i cada recorregut enllaça la prova de la qual s'ha extret.

Només Core · docker compose · proves funcionals

Modes de validació

TensorCash afegeix un pas de validació externa a l'acceptació de blocs. -validationapi selecciona el backend que la fa, i és la decisió més important per a una execució local: determina si necessites una GPU, un procés verificador o cap de les dues coses.

OpcióQuè ésQuan fer-lo servir
-validationapi=realEl mode per defecte. Es comunica amb un verificador extern pel canal ZMQ PUSH/PULL entre node i verificador fent servir FlatBuffers. És la configuració de producció.Necessita un procés verificador real. S'utilitza a la mainnet, a la testnet i en qualsevol execució regtest que posi a prova la repetició real del model.
-validationapi=mockDins del procés i determinista. El backend simulat exposa tres RPC (validationmockdefault, validationmockclear, validationmockrequests) per a respostes Quick, Full i Model predefinides; amb les opcions d'arrencada -mockval-default-*, tots els resultats de verificació es poden programar.El mode per defecte del conjunt de proves funcionals. L'opció adequada per fer funcionar la lògica de la cadena sense verificador ni inferència real.
-validationapi=desktopHíbrid. Les comprovacions Quick s'executen dins del procés; les Full i Model s'envien a un verificador HTTPS local (el binari d'escriptori per defecte). No cal cap broker ZMQ.Demostracions en una sola màquina que volen una passada Quick i Smell real sense haver de gestionar un servei verificador separat.

Per a una primera ullada a la lògica de la cadena, mock és la resposta encertada. La resta d'aquesta pàgina ho dona per fet si no s'indica el contrari.

Camí A · només Core, amb validació simulada

La via més senzilla. Un sol dimoni en C++: sense Docker, sense GPU, sense fitxers de model al disc. N'hi ha prou per a tots els recorreguts d'aquesta pàgina.

1. Compila el dimoni

Segueix les instruccions de compilació de Bitcoin Core sobre services/core-node/bcore/. El codi de TensorCash es compila amb el mateix objectiu CMake que l'original; no hi ha cap opció separada.

2. Inicia un node regtest

Aquestes opcions reprodueixen el que test_framework/test_tensorcash.py passa a cada prova funcional, així que tot el que funciona allà també funciona aquí. Les respostes simulades per defecte estan fixades en verd, de manera que l'acceptació de blocs és determinista.

./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. Comunica-t'hi

L'autenticació fa servir el fitxer de cookie a $HOME/.tensorcash-regtest/regtest/.cookie, que bitcoin-cli llegeix automàticament quan passes -datadir. El port RPC és el predeterminat de regtest a l'original, 18443.

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

Camí B · l'stack local complet (docker compose)

Per quan la simulació no n'hi ha prou: un procés verificador real, un model real servint inferència i l'API del miner connectada. L'arrel del repositori té scripts d'arrencada per a Mac i per a Linux amb CUDA.

A Apple silicon, el llançador baixa una compilació de llama.cpp i aixeca l'stack compose complet 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

A Linux amb GPU NVIDIA, launch_linux.sh fa el mateix amb el verificador basat en vLLM en lloc de 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

El fitxer compose vincula els ports de l'amfitrió 8333 (P2P), 8050 (l'API REST de core-node) i 7067 (ZMQ). El verificador serveix la seva API REST del verificador al seu propi port de contenidor.

Camí C · executa el conjunt de proves funcionals

Un cop compilat el dimoni (camí A, pas 1), l'executor de proves t'arrenca nodes d'un sol ús. És útil quan vols una seqüència que se sap que funciona per copiar-la, més que no pas un dimoni per remenar.

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)

Les proves de TensorCash s'agrupen per àmbit: cicle de vida dels models, actius natius, adaptadors fair-sign i el moneder de repo amb covenants. Cadascuna és un escenari autònom que pots llegir de dalt a baix; els recorreguts de més avall remeten als més representatius.

Recorreguts

Tres seqüències breus contra el node simulat del camí A. Cadascuna és un esbós; la prova funcional enllaçada és l'escenari complet i executable.

Mina el teu primer bloc

Prova canònica: wallet_basic.py

Igual que a Bitcoin Core. Una prova de fum abans de tocar cap interfície pròpia de TensorCash: confirma que el dimoni funciona i que el moneder té fons.

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

Registra un model de cap a cap

Prova canònica: feature_model_registration.py

Específic de TensorCash. Un model es registra bloquejant un dipòsit en garantia, acumulant verificacions Quick i Model reeixides al llarg de N commits i passant a registered quan es tanca la finestra de verificació. Amb -validationapi=mock pots fer cada pas des d'RPC, sense verificador real ni GPU. Això és un esquema; la prova enllaçada conté l'escenari complet.

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

Emet un actiu natiu

Prova canònica: feature_assets_basic_highlevel.py

Específic de TensorCash. registerasset és l'RPC de moneder d'alt nivell que construeix les sortides de fiança i d'ICU, hi adjunta el TLV de registre de l'emissor i fa la difusió. Després d'una confirmació, l'actiu es pot consultar per id o per ticker. El cicle de vida complet (encunyació, transferència, crema) és a la prova enllaçada.

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

Referència d'opcions

Les opcions del camí A que difereixen d'una sessió simple de bitcoind -regtest. Font de referència: test_framework/test_tensorcash.py i init.cpp.

OpcióPer què és important a regtest
-regtestSelecciona la cadena regtest (subsidi de bloc, regles de maduresa immediata i els ports només locals 18443/18444).
-vdfspvcommitmentheight=0Activa VDF/SPV des del bloc gènesi en lloc de l'altura escalonada de la mainnet.
-vdfspvvdfverifyheight=0Activa la verificació VDF des del bloc gènesi.
-maxtipage=999999Accepta segells de temps antics, de manera que reiniciar sobre una cadena endarrerida no sembla un node sense sincronitzar.
-spv-asn-min=1Rebaixa el mínim de corroboració per ASN; sense aquesta opció, regtest bloqueja la lògica de commutació VDF SPV.
-spv-hysteresis-base-bps=0Elimina la histèresi del marge base, de manera que les reorganitzacions a les proves són immediates i deterministes.
-spv-reorg-sampling-threshold=999Desactiva a la pràctica el mostreig de cossos en reorganitzacions profundes, que és poc pràctic de provocar amb altures petites.
-useextapi=0Desactiva l'API externa del miner: no cal per als recorreguts només de cadena i escurça l'arrencada.
-debug=net,validationRegistra les línies més útils per a una sessió de regtest: xarxa i canal de validació.
-par=1Validació en un sol fil. Elimina un tipus d'inestabilitat pròpia de les proves sense afectar la correcció.

Següents passos