regtest ལམ་སྟོན།

ས་གནས་གོང་འཕེལ་གྱི་ལམ་གསུམ། དཀའ་ཚད་ཉུང་རིམ་ལྟར་སྒྲིག་ཡོད། རེ་རེས་ bitcoin-cli ཡང་ན་ JSON-RPC client གང་རུང་གིས་འབོད་ཐུབ་པའི་ TensorCash JSON-RPC ཞིག་ཁྱེད་ཀྱི་མདུན་དུ་འཇོག bcore functional test ཚོགས་སྡེབ། ནི་འོག་གི་ཚང་མའི་ཁུངས་ཐུབ་དང་ལག་བསྟར་ཐུབ་པའི་ཚད་གཞི་ཡིན་ལ། ལམ་སྟོན་རེ་རེས་ཁོ་རང་བསྡུས་ཁུངས་ཀྱི་ test ལ་འབྲེལ་མཐུད་བྱེད།

Core ཁོ་ན། · docker compose · functional test

ར་སྤྲོད་ཀྱི་རྣམ་པ།

TensorCash གྱིས་ block ངོས་ལེན་ལ་ཕྱི་རོལ་གྱི་ར་སྤྲོད་གོམ་པ་ཞིག་ཁ་སྣོན་བྱེད། -validationapi ཡིས་དེ་སྒྲུབ་པའི་ backend འདེམས་ལ། ས་གནས་འཁོར་སྐྱོད་ལ་གདམ་ཀ་གལ་ཆེ་ཤོས་དེ་ཡིན། ཁྱེད་ལ་ GPU དགོས་མིན། ར་སྤྲོད་པའི་ process དགོས་མིན། ཡང་ན་གཉིས་ཀ་མི་དགོས་པ་དེས་ཐག་གཅོད།

འདེམས་ཚན།དེ་ཅི་ཡིན།ནམ་སྤྱོད་དགོས།
-validationapi=realསྔོན་སྒྲིག node ནས་ར་སྤྲོད་པའི་བར་གྱི་ ZMQ PUSH/PULL ལམ་ཕྲན་ཐོག་ FlatBuffers སྤྱད་དེ་ཕྱི་རོལ་གྱི་ར་སྤྲོད་པ་དང་འབྲེལ་བ་བྱེད། ཐོན་སྐྱེད་ཀྱི་སྒྲིག་འགོད།ར་སྤྲོད་པའི་ process དངོས་མ་དགོས། mainnet, testnet དང་དཔེ་གཟུགས་བསྐྱར་སྟོན་དངོས་མ་ལག་ལེན་བྱེད་པའི་ regtest ཚང་མར་སྤྱོད།
-validationapi=mockProcess ནང་དང་གཏན་འཁེལ་ཅན། mock backend ཡིས་ RPC གསུམ་ (validationmockdefault, validationmockclear, validationmockrequests) བརྒྱུད་ Quick, Full, Model གི་ལན་སྔོན་སྒྲིག་སྤྲོད། -mockval-default-* འགོ་འཛུགས་ flag དང་བཅས་ན་ར་སྤྲོད་ཀྱི་མཇུག་འབྲས་ཚང་མ་ script ཐོག་བཟོ་ཐུབ།Functional test ཚོགས་སྡེབ་ཀྱི་སྔོན་སྒྲིག ར་སྤྲོད་པ་དང་ inference དངོས་མ་མེད་པར་རྒྱུན་ཕྲེང་གི་རིག་ལམ་སྐྱོད་པར་འོས་ཤོས།
-validationapi=desktopསྲེ་མ། Quick ཞིབ་བཤེར་ process ནང་འཁོར། Full དང་ Model ནི་ས་གནས་ HTTPS ར་སྤྲོད་པ་ལ་གཏོང་། (desktop binary སྔོན་སྒྲིག) ZMQ broker མི་དགོས།ར་སྤྲོད་ཞབས་ཞུ་ལོགས་སུ་འཁོར་སྐྱོད་མི་བྱེད་པར་ Quick དང་ Smell ཞིབ་བཤེར་དངོས་མ་དགོས་པའི་འཕྲུལ་ཆས་གཅིག་གི་དཔེ་སྟོན།

རྒྱུན་ཕྲེང་གི་རིག་ལམ་ལ་ཐེངས་དང་པོ་ལྟ་བ་ཡིན་ན་ mock འོས་ཤོས་ཡིན། གསལ་བཤད་མ་བྱས་ན་ཤོག་ངོས་འདིའི་ལྷག་མ་རྣམས་ཀྱིས་དེ་ལ་དམིགས།

ལམ་ A · Core ཁོ་ན། mock ར་སྤྲོད་དང་བཅས།

དཀའ་ངལ་ཉུང་ཤོས། C++ daemon གཅིག docker མི་དགོས། GPU མི་དགོས། སྡེར་སྟེང་དཔེ་གཟུགས་ཀྱི་ཡིག་ཆ་མི་དགོས། ཤོག་ངོས་འདིའི་སྟེང་གི་ལམ་སྟོན་ཚང་མར་འདང་།

1. Daemon build བྱེད།

services/core-node/bcore/ ཐོག་ Bitcoin Core གྱི་ build བྱེད་ཐབས། ལྟར་བྱེད། TensorCash གྱི་ code ནི་ upstream དང་ CMake target གཅིག་པའི་འོག་ build བྱེད། flag ལོགས་སུ་མེད།

2. Regtest node འགོ་འཛུགས།

Flag འདི་དག་ནི་ test_framework/test_tensorcash.py ཡིས་ functional test རེ་རེར་སྤྲོད་པ་དང་གཅིག་མཚུངས་ཡིན་པས། དེར་འཁོར་ཐུབ་ན་འདིར་ཡང་འཁོར་ཐུབ། mock ལན་སྔོན་སྒྲིག་རྣམས་ green ལ་བཀག་ཡོད་པས། block ངོས་ལེན་ནི་གཏན་འཁེལ་ཅན་ཡིན།

./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. དེ་དང་འབྲེལ་བ་བྱེད།

ངོས་འཛིན་ར་སྤྲོད་ལ་ $HOME/.tensorcash-regtest/regtest/.cookie གི་ cookie ཡིག་ཆ་སྤྱོད། -datadir སྤྲད་ན་ bitcoin-cli ཡིས་དེ་རང་འགུལ་གྱིས་ཀློག RPC སྒོ་ནི་ upstream regtest གི་སྔོན་སྒྲིག་ 18443 ཡིན།

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

ལམ་ B · ས་གནས་ stack ཆ་ཚང་ (docker compose)

Mock མི་འདང་བའི་སྐབས་ཀྱི་ཆེད། ར་སྤྲོད་པའི་ process དངོས་མ། inference སྒྲུབ་པའི་དཔེ་གཟུགས་དངོས་མ། miner API སྦྲེལ་ཡོད་པ། repository གི་རྩ་བའི་ནང་ Mac དང་ CUDA ཡོད་པའི་ Linux ཆེད་ཀྱི་འགོ་འཛུགས་ script ཡོད།

Apple silicon ཐོག་འགོ་འཛུགས་ script ཡིས་ llama.cpp build ཞིག་ཕབ་ལེན་བྱས་ཏེ་ core-node + miner-api + verification-api compose stack ཆ་ཚང་འགོ་འཛུགས།

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 ཡོད་པའི་ Linux ཐོག་ launch_linux.sh ཡིས་དེ་དང་འདྲ་བ་བྱེད་ཀྱང་། llama.cpp ཡི་ཚབ་ཏུ་ vLLM ལ་གཞི་བཅོལ་བའི་ར་སྤྲོད་པ་སྤྱོད།

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 ཡིག་ཆས་ host སྒོ་ 8333 (P2P), 8050 (core-node REST API) དང་ 7067 (ZMQ) སྦྲེལ། ར་སྤྲོད་པས་ཁོ་རང་གི་ container སྒོ་ཐོག་ ར་སྤྲོད་པའི་ REST API མཁོ་སྤྲོད་བྱེད།

ལམ་ C · functional test ཚོགས་སྡེབ་འཁོར་སྐྱོད།

Daemon build བྱས་རྗེས་ (ལམ་ A གོམ་པ་ 1)། test runner གྱིས་ཁྱེད་ཆེད་གནས་སྐབས་ node འགོ་འཛུགས། 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 test རྣམས་ངོས་ལྟར་སྡེ་ཚན་དུ་ཕྱེ་ཡོད། དཔེ་གཟུགས་ཀྱི་ཚེ་རབས། རྒྱུན་ཕྲེང་གི་རང་བྱུང་རྒྱུ་ནོར། fair-sign adaptor། covenant repo དངུལ་ཁུག་བཅས། རེ་རེ་ནི་མགོ་ནས་མཇུག་བར་ཀློག་ཐུབ་པའི་རང་རྐྱ་ཚང་བའི་གནས་སྟངས་ཤིག་ཡིན། འོག་གི་ལམ་སྟོན་རྣམས་ཀྱིས་མཚོན་བྱེད་ཆེ་ཤོས་ཚོར་མདུན་སྟོན་བྱེད།

གོམ་པ་རེ་རེའི་ལམ་སྟོན།

ལམ་ A ཡི་ mock node ཐོག་གོ་རིམ་ཐུང་ངུ་གསུམ། རེ་རེ་ནི་རགས་བཀོད་ཙམ་ཡིན། འབྲེལ་མཐུད་ཡོད་པའི་ functional test ནི་ལག་བསྟར་ཐུབ་པའི་གནས་སྟངས་ཆ་ཚང་ཡིན།

ཁྱེད་ཀྱི་ block དང་པོ་གཏེར་སྔོག་བྱེད།

ཁུངས་ཐུབ་ test: wallet_basic.py

Bitcoin Core དང་འགྱུར་བ་མེད། TensorCash ལ་ཁྱད་པར་ཅན་གྱི་ངོས་གང་རུང་གི་སྔོན་དུ་ smoke test ཞིག daemon འཁོར་བཞིན་ཡོད་པ་དང་དངུལ་ཁུག་ནང་དངུལ་ཡོད་པ་གཏན་འཁེལ་བྱེད།

འབྲེལ་ཡོད: 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)

དཔེ་གཟུགས་ཤིག་མགོ་མཇུག་བར་ཐོ་འགོད།

ཁུངས་ཐུབ་ test: feature_model_registration.py

TensorCash ལ་ཁྱད་པར་ཅན། དཔེ་གཟུགས་ཤིག་ཐོ་འགོད་བྱེད་ཚུལ། འཇོག་དངུལ་ escrow ནང་འཇོག་པ། commit N ཡི་རིང་ Quick དང་ Model ར་སྤྲོད་ལེགས་འགྲུབ་བསྡུ་བ། ར་སྤྲོད་ཀྱི་དུས་ཚོད་རྫོགས་རྗེས་ registered ལ་སྤོ་བ། -validationapi=mock དང་བཅས་ན་གོམ་པ་ཚང་མ་ RPC ནས་བྱེད་ཐུབ་ལ། ར་སྤྲོད་པ་དངོས་མ་དང་ GPU མི་དགོས། འདི་ནི་སྙིང་བསྡུས་ཙམ་ཡིན། འབྲེལ་མཐུད་ཡོད་པའི་ test ནི་གནས་སྟངས་ཆ་ཚང་ཡིན།

འབྲེལ་ཡོད: 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, ...}

རྒྱུན་ཕྲེང་གི་རང་བྱུང་རྒྱུ་ནོར་ཞིག་འཐོན་སྤེལ།

ཁུངས་ཐུབ་ test: feature_assets_basic_highlevel.py

TensorCash ལ་ཁྱད་པར་ཅན། registerasset ནི་མཐོ་རིམ་གྱི་དངུལ་ཁུག RPC ཞིག་ཡིན་ཞིང་། bond དང་ ICU output བཟོ་བ། འཐོན་སྤེལ་མཁན་གྱི་ཐོ་འགོད་ TLV སྦྱར་བ། ཁྱབ་བསྒྲགས་བྱེད་པ་བཅས་བྱེད། ངོས་སྦྱོར་ཐེངས་གཅིག་གི་རྗེས་རྒྱུ་ནོར་དེ་ id འམ་ ticker ཐོག་འཚོལ་ཐུབ། ཚེ་རབས་ཆ་ཚང་ (mint, transfer, burn) ནི་འབྲེལ་མཐུད་ཡོད་པའི་ test ནང་ཡོད།

འབྲེལ་ཡོད: 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

Flag ཟུར་གསལ།

ལམ་ A ནང་གི་ flag རྣམས་ལས་ bitcoind -regtest རྐྱང་པ་དང་མི་འདྲ་བ་རྣམས། ཁུངས་ཡིག་ནི་ test_framework/test_tensorcash.py དང་ init.cpp ཡིན།

འདེམས་ཚན།Regtest ནང་གལ་ཆེ་བའི་རྒྱུ་མཚན།
-regtestRegtest རྒྱུན་ཕྲེང་འདེམས། (block སྦྱིན་ཚབ། དེ་མ་ཐག་སྨིན་པའི་སྒྲིག་གཞི། ས་གནས་ཁོ་ནའི་སྒོ་ 18443/18444)
-vdfspvcommitmentheight=0VDF/SPV དེ་ mainnet གི་རིམ་པ་ཅན་གྱི་མཐོ་ཚད་ཀྱི་ཚབ་ཏུ་ genesis ནས་འགོ་འཛུགས།
-vdfspvvdfverifyheight=0VDF ར་སྤྲོད་ genesis ནས་འགོ་འཛུགས།
-maxtipage=999999དུས་ཚོད་རྟགས་རྙིང་པ་ངོས་ལེན་བྱེད་པས། གསར་བཅོས་མ་བྱས་པའི་རྒྱུན་ཕྲེང་ཐོག་བསྐྱར་འགོ་བཙུགས་ན་མཉམ་སྒྲིག་མ་བྱས་པའི་ node ལྟར་མི་མཐོང་།
-spv-asn-min=1ASN ར་སྤྲོད་ཀྱི་ཉུང་མཐའ་དམའ་རུ་གཏོང་། དེ་མེད་ན་ regtest ཡིས་ VDF SPV བརྗེ་སྒྱུར་གྱི་རིག་ལམ་འགོག
-spv-hysteresis-base-bps=0Base-margin hysteresis མེད་པར་བཟོ་བས། test ནང་གི་ reorg དེ་མ་ཐག་དང་གཏན་འཁེལ་ཅན་དུ་འགྱུར།
-spv-reorg-sampling-threshold=999Reorg གཏིང་ཟབ་ཀྱི་ body sampling དོན་དངོས་སུ་བཀག་འགོག་བྱེད། མཐོ་ཚད་ཆུང་ངུར་དེ་ལག་ལེན་བྱེད་དཀའ།
-useextapi=0ཕྱི་རོལ་གྱི་ miner API བཀག་འགོག་བྱེད། རྒྱུན་ཕྲེང་ཁོ་ནའི་ལམ་སྟོན་ལ་མི་དགོས་ལ། འགོ་འཛུགས་མྱུར་དུ་འགྲོ།
-debug=net,validationRegtest སྐབས་ལ་ཕན་ཤོས་ཀྱི་ log ཐོ་འགོད་བྱེད། དྲ་སྦྲེལ་དང་ར་སྤྲོད་ཀྱི་རྒྱུ་ལམ།
-par=1Thread གཅིག་གི་ར་སྤྲོད། ཏག་ཏག་ཡིན་པར་གནོད་པ་མེད་པར་ test ཁོ་ནར་བྱུང་བའི་བརྟན་མེད་ཀྱི་རིགས་ཤིག་མེད་པར་བཟོ།

རྗེས་མར་གང་དུ།

  • JSON-RPC ཟུར་གསལ།Method ཡོངས་རྫོགས་ཀྱི་དཀར་ཆག སྡེ་ཚན་ལྟར་སྒྲིག་ཡོད་ལ། བརྟན་ཚད་ཀྱི་མཚོན་རྟགས་དང་ curl དཔེ་མཚོན་ཡོད།
  • ར་སྤྲོད་པའི་ REST API-validationapi=mock ནས་ར་སྤྲོད་པའི་ process དངོས་མར་སྤོ་དུས།
  • FlatBuffer གཞི་སྒྲོམ།Node ནས་ར་སྤྲོད་པའི་བར་གྱི་ ZMQ payload ཆེད་ FlatBuffer IDL དང་ JSON Schema།
  • bcore/test/functional/Test རྣམས་ཚད་གཞི་ལྟར་ཀློག
  • Testnet གི་ faucetདྲ་ཐོག་གི་ཟླ་གྲོགས། ས་གནས་ཚོད་ལྟའི་ཁོར་ཡུག་གི་ཚབ་ཏུ་གསོན་པོའི་རྒྱུན་ཕྲེང་ཞིག་དགོས་ན། མཉམ་སྤྱོད་ testnet ཐོག་དངུལ་ཁུག་ལ་དངུལ་འཇོག