Regtest kılavuzu

Zahmet sırasına göre üç yerel geliştirme yolu. Her biri, bitcoin-cli ya da herhangi bir JSON-RPC istemcisiyle çağırabileceğin bir TensorCash JSON-RPC'sini önüne koyar. Aşağıdaki her şeyin esas, çalıştırılabilir belirtimi bcore fonksiyonel test paketi olup her adım adım rehber, damıtıldığı teste bağlantı verir.

Yalnızca Core · docker compose · fonksiyonel testler

Doğrulama modları

TensorCash, blok kabulüne harici bir doğrulama adımı ekler. -validationapi bu adımı sunan backend'i seçer ve yerel bir çalıştırmadaki en önemli tercihtir: GPU'ya mı, doğrulayıcı sürecine mi, yoksa hiçbirine mi ihtiyacın olduğunu belirler.

BayrakNedirNe zaman kullanılır
-validationapi=realVarsayılan. FlatBuffers kullanarak düğüm-doğrulayıcı ZMQ PUSH/PULL kanalı üzerinden harici bir doğrulayıcıyla konuşur. Üretim ayarı budur.Gerçek bir doğrulayıcı süreci gerektirir. Mainnet'te, testnet'te ve gerçek model yeniden oynatmasını deneyen her regtest çalıştırmasında kullanılır.
-validationapi=mockSüreç içi ve deterministik. Sahte backend, hazır Quick, Full ve Model yanıtları için üç RPC sunar (validationmockdefault, validationmockclear, validationmockrequests); -mockval-default-* başlatma bayraklarıyla her doğrulama sonucu betiklenebilir.Fonksiyonel test paketinin varsayılanı. Zincir mantığını doğrulayıcı ya da gerçek çıkarım olmadan yürütmek için doğru seçim.
-validationapi=desktopHibrit. Quick kontrolleri süreç içinde çalışır; Full ve Model yerel bir HTTPS doğrulayıcısına gönderilir (varsayılan masaüstü binary'si). ZMQ broker'ı gerekmez.Ayrı bir doğrulayıcı servisi işletmeden gerçek bir Quick ve Smell geçişi isteyen tek makinelik demolar.

Zincir mantığına ilk bakış için doğru cevap mock. Aksi belirtilmedikçe bu sayfanın geri kalanı bunu varsayar.

Yol A · yalnızca Core, sahte doğrulamayla

En zahmetsiz yol. Tek bir C++ daemon: docker yok, GPU yok, diskte model dosyası yok. Bu sayfadaki tüm adım adım rehberler için yeterli.

1. Daemon'ı derle

services/core-node/bcore/ dizininde Bitcoin Core derleme talimatları doğrultusunda derle. TensorCash kodu upstream ile aynı CMake hedefi altında derlenir; ayrı bir bayrak yoktur.

2. Bir regtest düğümü başlat

Bu bayraklar, test_framework/test_tensorcash.py dosyasının her fonksiyonel teste verdiği bayrakların aynısıdır; orada çalışan her şey burada da çalışır. Varsayılan sahte yanıtlar yeşile sabitlenmiştir, bu yüzden blok kabulü deterministiktir.

./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. Düğümle konuş

Kimlik doğrulama $HOME/.tensorcash-regtest/regtest/.cookie konumundaki cookie dosyasını kullanır; -datadir verdiğinde bitcoin-cli bu dosyayı otomatik olarak okur. RPC portu upstream regtest varsayılanıdır: 18443.

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

Yol B · tam yerel yığın (docker compose)

Sahte doğrulamanın yetmediği durumlar için: gerçek bir doğrulayıcı süreci, çıkarım sunan gerçek bir model ve bağlanmış madenci API'si. Depo kök dizininde Mac'ler ve CUDA'lı Linux için başlatma betikleri bulunur.

Apple silicon'da başlatıcı bir llama.cpp derlemesini çeker ve core-node + miner-api + verification-api compose yığınının tamamını ayağa kaldırır:

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'lu Linux'ta launch_linux.sh aynı işi llama.cpp yerine vLLM tabanlı doğrulayıcıyla yapar:

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 dosyası 8333 (P2P), 8050 (core-node REST API) ve 7067 (ZMQ) host portlarını bağlar. Doğrulayıcı, kendi API'sini (Verifier REST API) kendi container portunda sunar.

Yol C · fonksiyonel test paketini çalıştır

Daemon derlendikten sonra (Yol A, 1. adım) test çalıştırıcısı senin için geçici düğümler başlatır. Kurcalanacak bir daemon yerine kopyalanacak, çalıştığı bilinen bir adım dizisi istediğinde işe yarar.

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 testleri arayüze göre gruplanır: model yaşam döngüsü, yerel varlıklar, fair-sign adaptörleri ve covenant repo cüzdanı. Her biri baştan sona okunabilen, kendi içinde tamamlanmış bir senaryodur; aşağıdaki adım adım rehberler en temsili olanlara işaret eder.

Adım adım rehberler

Yol A'daki sahte düğüme karşı üç kısa adım dizisi. Her biri bir taslaktır; bağlantısı verilen fonksiyonel test, tam ve çalıştırılabilir senaryodur.

İlk bloğunu kaz

Esas test: wallet_basic.py

Bitcoin Core'dakiyle aynı. TensorCash'e özgü herhangi bir arayüzden önce bir duman testi: daemon'ın çalıştığını ve cüzdanın fonlandığını doğrular.

Kapsadığı alanlar: 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)

Bir modeli baştan sona kaydet

Esas test: feature_model_registration.py

TensorCash'e özgü. Bir model; bir depozito emanete alınarak, N commit boyunca başarılı Quick ve Model doğrulamaları toplanarak ve doğrulama penceresi kapandığında registered durumuna geçilerek kaydedilir. -validationapi=mock ile her adımı gerçek bir doğrulayıcı ya da GPU olmadan RPC'lerle yürütebilirsin. Bu bir ana hattır; tam senaryo bağlantısı verilen testtedir.

Kapsadığı alanlar: 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, ...}

Yerel bir varlık ihraç et

Esas test: feature_assets_basic_highlevel.py

TensorCash'e özgü. registerasset, teminat ve ICU çıktılarını oluşturan, ihraççı kayıt TLV'sini ekleyen ve işlemi yayımlayan üst düzey cüzdan RPC'sidir. Bir onaydan sonra varlık, kimliği ya da ticker'ı ile sorgulanabilir. Tam yaşam döngüsü (basım, transfer, yakım) bağlantısı verilen testte yer alır.

Kapsadığı alanlar: 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

Bayrak referansı

Yol A'daki bayraklardan sade bir bitcoind -regtest oturumundan farklı olanlar. Esas kaynak: test_framework/test_tensorcash.py ve init.cpp.

BayrakRegtest'te neden önemli
-regtestRegtest zincirini seçer (blok sübvansiyonu, anında olgunlaşma kuralları ve yalnızca yerel 18443/18444 portları).
-vdfspvcommitmentheight=0VDF/SPV'yi kademeli mainnet yüksekliği yerine genesis'ten itibaren etkinleştirir.
-vdfspvvdfverifyheight=0VDF doğrulamasını genesis'ten itibaren etkinleştirir.
-maxtipage=999999Eski zaman damgalarını kabul eder; böylece eski bir zincirde yeniden başlatma, senkronize olmamış bir düğüm gibi görünmez.
-spv-asn-min=1ASN teyit alt sınırını düşürür; bu bayrak olmadan regtest, VDF SPV geçiş mantığını engeller.
-spv-hysteresis-base-bps=0Temel marj histerezisini kaldırır; böylece testlerdeki reorg'lar anında ve deterministik olur.
-spv-reorg-sampling-threshold=999Derin reorg gövde örneklemesini fiilen devre dışı bırakır; bu örneklemeyi küçük yüksekliklerde yürütmek pratik değildir.
-useextapi=0Harici madenci API'sini devre dışı bırakır: yalnızca zincirle ilgili rehberlerde gerekmez ve başlatmayı kısaltır.
-debug=net,validationBir regtest oturumu için en yararlı satırları loglar: ağ ve doğrulama hattı.
-par=1Tek iş parçacıklı doğrulama. Doğruluğu etkilemeden yalnızca testlerde görülen bir tür kararsızlığı ortadan kaldırır.

Sırada ne var

  • JSON-RPC referansıGruplara ayrılmış, kararlılık etiketleri ve curl örnekleriyle tam metot dizini.
  • Verifier REST API-validationapi=mock modundan gerçek bir doğrulayıcı sürecine geçtiğinde.
  • FlatBuffer şemalarıDüğüm-doğrulayıcı ZMQ yükleri için FlatBuffer IDL ve JSON Schema.
  • bcore/test/functional/Testleri belirtim olarak oku.
  • Testnet faucet'iÇevrimiçi karşılığı: yerel bir sandbox yerine canlı bir zincir istediğinde ortak testnet'te bir cüzdanı fonla.