Regtest قوللانمىسى

ئاۋارىچىلىق دەرىجىسى بويىچە تىزىلغان ئۈچ يەرلىك ئېچىش يولى. ھەر بىرى سىزنىڭ ئالدىڭىزغا bitcoin-cli ياكى ھەر قانداق JSON-RPC خېرىدارى بىلەن چاقىرغىلى بولىدىغان TensorCash JSON-RPC سىنى قويۇپ بېرىدۇ. bcore ئىقتىدار سىناق توپلىمى تۆۋەندىكى ھەممە نەرسىنىڭ ئۆلچەملىك، ئىجرا قىلغىلى بولىدىغان چۈشەندۈرۈشى، ھەر بىر كۆرسەتمە ئۆزى ئېلىنغان سىناققا ئۇلانغان.

پەقەت Core · docker compose · ئىقتىدار سىناقلىرى

دەلىللەش ھالەتلىرى

TensorCash بلوك قوبۇل قىلىشقا سىرتقى دەلىللەش باسقۇچى قوشىدۇ. -validationapi بۇ باسقۇچنى ئىجرا قىلىدىغان ئارقا سۇپىنى تاللايدۇ، بۇ يەرلىك ئىجرادىكى ئەڭ مۇھىم تاللاش: ئۇ سىزگە GPU، دەلىللىگۈچى جەريانى ياكى ھېچقايسىسى كېرەك ئەمەسلىكىنى بەلگىلەيدۇ.

بەلگەئۇ نېمەقاچان ئىشلىتىش كېرەك
-validationapi=realكۆڭۈلدىكى تاللاش. تۈگۈندىن دەلىللىگۈچىگە بارىدىغان ZMQ PUSH/PULL قانىلى ئارقىلىق FlatBuffers بىلەن سىرتقى دەلىللىگۈچى بىلەن ئالاقە قىلىدۇ. ئىشلەپچىقىرىش مۇھىتىدىكى تەڭشەك.ھەقىقىي دەلىللىگۈچى جەريانى كېرەك. ئاساسىي تور، سىناق تورى ۋە ھەقىقىي مودېل قايتا ئىجراسىنى سىنايدىغان ھەر قانداق regtest ئىجراسىدا ئىشلىتىلىدۇ.
-validationapi=mockجەريان ئىچىدە ۋە بەلگىلىك نەتىجىلىك. ساختا ئارقا سۇپا Quick، Full ۋە Model ئۈچۈن تەييار جاۋابلارنى بېرىدىغان ئۈچ RPC نى (validationmockdefault، validationmockclear، validationmockrequests) ئاشكارىلايدۇ؛ -mockval-default-* قوزغىتىش بەلگىلىرى بىلەن ھەر بىر دەلىللەش نەتىجىسىنى قوليازمىدا بەلگىلىگىلى بولىدۇ.ئىقتىدار سىناق توپلىمىنىڭ كۆڭۈلدىكى تاللىشى. دەلىللىگۈچى ياكى ھەقىقىي يەكۈن چىقىرىش بولمىسىمۇ، زەنجىر لوگىكىسىنى ئىشلىتىش ئۈچۈن توغرا تاللاش.
-validationapi=desktopئارىلاش. Quick تەكشۈرۈشلىرى جەريان ئىچىدە ئىجرا بولىدۇ؛ Full ۋە Model يەرلىك HTTPS دەلىللىگۈچىگە ئەۋەتىلىدۇ (ئۈستەل يۈزى ئۈچۈن كۆڭۈلدىكى ئىجرا ھۆججىتى). ZMQ broker كېرەك ئەمەس.ئايرىم دەلىللىگۈچى مۇلازىمىتىنى باشقۇرماي تۇرۇپ، ھەقىقىي Quick ۋە Smell تەكشۈرۈشى كېرەك بولغان، بىرلا كومپيۇتېردىكى كۆرسىتىشلەر.

زەنجىر لوگىكىسىغا تۇنجى قېتىم قاراش ئۈچۈن mock توغرا جاۋاب. ئايرىم ئەسكەرتىلمىگەن بولسا، بۇ بەتنىڭ قالغان قىسمى شۇنى كۆزدە تۇتىدۇ.

A يولى · پەقەت core، ساختا دەلىللەش بىلەن

ئەڭ ئاز ئاۋارىچىلىك. بىرلا C++ daemon: docker يوق، GPU يوق، دىسكىدا مودېل ھۆججىتى يوق. بۇ بەتتىكى بارلىق قەدەممۇقەدەم كۆرسەتمىلەرگە يېتەرلىك.

1. daemon نى قۇرۇش

services/core-node/bcore/ ئۈچۈن Bitcoin Core نىڭ قۇرۇش كۆرسەتمىسى غا ئەمەل قىلىڭ. TensorCash كودى ئەسلى تۈردىكىگە ئوخشاش CMake نىشانى ئاستىدا قۇرۇلىدۇ؛ ئايرىم بەلگە يوق.

2. regtest تۈگۈنىنى قوزغىتىش

بۇ بەلگىلەر test_framework/test_tensorcash.py ھەر بىر ئىقتىدار سىنىقىغا يەتكۈزىدىغان بەلگىلەرنىڭ ئوخشىشى، شۇڭا ئۇ يەردە ئىشلىگەن ھەممە نەرسە بۇ يەردىمۇ ئىشلەيدۇ. كۆڭۈلدىكى ساختا جاۋابلار green غا مۇقىملانغان، شۇڭا بلوكنىڭ قوبۇل قىلىنىشى بەلگىلىك نەتىجىلىك بولىدۇ.

./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 ئېغىزى ئەسلى regtest نىڭ كۆڭۈلدىكى ئېغىزى 18443.

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

B يولى · تولۇق يەرلىك توپلام (docker compose)

ساختا دەلىللەش يېتەرلىك بولمىغاندا: ھەقىقىي دەلىللىگۈچى جەريانى، يەكۈن چىقىرىش مۇلازىمىتى بېرىۋاتقان ھەقىقىي مودېل ۋە ئۇلانغان كان قېزىش API سى. ئامبار يىلتىزىدا Mac ۋە CUDA لىق Linux ئۈچۈن قوزغىتىش قوليازمىلىرى بار.

Apple silicon دا قوزغاتقۇچ llama.cpp نەشرىنى چۈشۈرۈپ، تولۇق core-node + miner-api + verification-api compose توپلىمىنى قوزغىتىدۇ:

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 ھۆججىتى ساھىبخانىنىڭ 8333 (P2P)، 8050 (core-node REST API) ۋە 7067 (ZMQ) ئېغىزلىرىنى باغلايدۇ. دەلىللىگۈچى ئۆزىنىڭ دەلىللىگۈچى REST API سىنى ئۆز كونتېينېر ئېغىزىدا تەمىنلەيدۇ.

C يولى · ئىقتىدار سىناق توپلىمىنى ئىجرا قىلىش

daemon قۇرۇلغاندىن كېيىن (A يولى، 1-قەدەم)، سىناق ئىجرا قىلغۇچ سىز ئۈچۈن ۋاقىتلىق تۈگۈنلەرنى قوزغىتىدۇ. سىناپ كۆرىدىغان 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 سىناقلىرى ئارايۈز بويىچە گۇرۇپپىلانغان: مودېلنىڭ ھايات دەۋرى، ئەسلىي مۈلۈكلەر، fair-sign ماسلاشتۇرغۇچلىرى ۋە covenant repo ھەميانى. ھەر بىرى ئۆز ئالدىغا تولۇق ئىجرا قىلىنىدىغان سىنارىيە بولۇپ، باشتىن ئاخىرغىچە ئوقۇغىلى بولىدۇ؛ تۆۋەندىكى كۆرسەتمىلەر ئەڭ ۋەكىللىك سىناقلارنى كۆرسىتىدۇ.

قەدەممۇقەدەم كۆرسەتمىلەر

A يولىدىكى ساختا تۈگۈنگە قارىتىلغان ئۈچ قىسقا قەدەملەر تەرتىپى. ھەر بىرى پەقەت سىزىلما؛ تولۇق، ئىجرا قىلغىلى بولىدىغان سىنارىيە ئۇلانغان ئىقتىدار سىنىقىدا.

تۇنجى بلوكىڭىزنى قېزىڭ

ئۆلچەملىك سىناق: wallet_basic.py

Bitcoin Core بىلەن ئوخشاش. TensorCash غا خاس ھەر قانداق ئارايۈزدىن ئىلگىرىكى دەسلەپكى سىناق: 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)

مودېلنى باشتىن ئاخىرىغىچە تىزىملاش

ئۆلچەملىك سىناق: feature_model_registration.py

TensorCash غا خاس. مودېل مۇنداق تىزىملىنىدۇ: كاپالەت پۇلى ئامانەتكە قويۇلىدۇ، N قېتىملىق commit جەريانىدا مۇۋەپپەقىيەتلىك Quick ۋە Model دەلىللەشلىرى يىغىلىدۇ، دەلىللەش كۆزنىكى يېپىلغاندىن كېيىن registered ھالىتىگە ئۆتىدۇ. -validationapi=mock بىلەن ھەقىقىي دەلىللىگۈچى ياكى GPU بولمىسىمۇ ھەر بىر قەدەمنى RPC ئارقىلىق ئىجرا قىلالايسىز. بۇ پەقەت قىسقىچە بايان؛ تولۇق سىنارىيە ئۇلانغان سىناقتا.

چېتىلىدىغىنى: 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, ...}

ئەسلىي مۈلۈك چىقىرىش

ئۆلچەملىك سىناق: feature_assets_basic_highlevel.py

TensorCash غا خاس. registerasset يۇقىرى دەرىجىلىك ھەميان RPC سى بولۇپ، كاپالەت پۇلى ۋە ICU چىقىشلىرىنى (output) قۇرىدۇ، چىقارغۇچى تىزىملاش TLV سىنى قوشىدۇ ۋە تارقىتىدۇ. بىر قېتىم جەزملەنگەندىن كېيىن، مۈلۈكنى id ياكى ticker ئارقىلىق سۈرۈشتۈرگىلى بولىدۇ. تولۇق ھايات دەۋرى (mint، يۆتكەش، burn) ئۇلانغان سىناقتا بار.

چېتىلىدىغىنى: 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

بەلگىلەر پايدىلانمىسى

A يولىدىكى، ئاددىي bitcoind -regtest ئىجراسىدىن پەرقلىنىدىغان بەلگىلەر. ھەقىقىي مەنبە: test_framework/test_tensorcash.py ۋە init.cpp.

بەلگەregtest تا نېمە ئۈچۈن مۇھىم
-regtestregtest زەنجىرىنى تاللايدۇ (بلوك مۇكاپاتى، دەرھال پىشىپ يېتىلىش قائىدىسى ۋە پەقەت يەرلىكتە ئىشلىتىلىدىغان 18443/18444 ئېغىزلىرى).
-vdfspvcommitmentheight=0VDF/SPV نى ئاساسىي تورنىڭ باسقۇچلۇق ئېگىزلىكىنىڭ ئورنىغا genesis تىن باشلاپ قوزغىتىدۇ.
-vdfspvvdfverifyheight=0VDF دەلىللەشنى genesis تىن باشلاپ قوزغىتىدۇ.
-maxtipage=999999كونا ۋاقىت تامغىلىرىنى قوبۇل قىلىدۇ، شۇڭا كونىراپ قالغان زەنجىردە قايتا قوزغاتقاندا تۈگۈن ماسقەدەملەنمىگەندەك كۆرۈنمەيدۇ.
-spv-asn-min=1ASN دەلىللەش تۆۋەن چېكىنى تۆۋەنلىتىدۇ؛ بۇ بولمىسا، regtest VDF SPV ئالماشتۇرۇش لوگىكىسىنى توسۇپ قويىدۇ.
-spv-hysteresis-base-bps=0ئاساسىي پەرق hysteresis نى ئېلىۋېتىدۇ، شۇڭا سىناقلاردىكى reorg لار دەرھال ۋە بەلگىلىك نەتىجىلىك بولىدۇ.
-spv-reorg-sampling-threshold=999چوڭقۇر reorg مەزمۇن ئەۋرىشكىسىنى ئەمەلىيەتتە چەكلەيدۇ، چۈنكى ئۇنى كىچىك ئېگىزلىكلەردە ئىشلىتىش ئەمەلىي ئەمەس.
-useextapi=0سىرتقى كان قېزىش API سىنى چەكلەيدۇ: پەقەت زەنجىرگە ئائىت كۆرسەتمىلەر ئۈچۈن كېرەك ئەمەس، قوزغىلىشنىمۇ تېزلىتىدۇ.
-debug=net,validationregtest ئىجراسى ئۈچۈن ئەڭ پايدىلىق قۇرلارنى خاتىرىلەيدۇ: تور ئالاقىسى ۋە دەلىللەش جەريانى.
-par=1بىر يىپلىق دەلىللەش. توغرىلىققا تەسىر يەتكۈزمەي، پەقەت سىناقتىلا كۆرۈلىدىغان تۇراقسىزلىقنىڭ بىر تۈرىنى يوقىتىدۇ.

كېيىنكى قەدەم

  • JSON-RPC پايدىلانمىسىتولۇق مېتود مۇندەرىجىسى، گۇرۇپپىلار بويىچە رەتلەنگەن، مۇقىملىق بەلگىلىرى ۋە curl مىساللىرى بىلەن.
  • دەلىللىگۈچى REST API-validationapi=mock دىن ھەقىقىي دەلىللىگۈچى جەريانىغا ئۆتكەندە.
  • FlatBuffer لايىھىلىرىتۈگۈندىن دەلىللىگۈچىگە بارىدىغان ZMQ يۈكلىرى ئۈچۈن FlatBuffer IDL ۋە JSON Schema.
  • bcore/test/functional/سىناقلارنى ئۆلچەم سۈپىتىدە ئوقۇڭ.
  • سىناق تور تەڭگە تارقاتقۇچىتوردىكى ماس قىسمى: يەرلىك سىناق مۇھىتىنىڭ ئورنىغا جانلىق زەنجىر كېرەك بولغاندا، ئورتاق سىناق توردا ھەميانغا پۇل سېلىڭ.