Tri poti za lokalni razvoj, razvrščene po zahtevnosti. Vsaka ti ponudi JSON-RPC TensorCash, ki ga kličeš z bitcoin-cli ali katerim koli odjemalcem JSON-RPC. Funkcionalni testni nabor bcore je kanonična, izvedljiva specifikacija za vse spodaj, vsak vodnik pa se sklicuje na test, iz katerega je povzet.
Samo Core · docker compose · funkcionalni testi
Načini validacije
TensorCash sprejemanju blokov doda zunanji korak validacije. -validationapi izbere zaledni sistem, ki ga izvaja, in je najpomembnejša izbira pri lokalnem zagonu: odloča, ali potrebuješ GPU, proces preverjevalca ali nič od tega.
Zastavica
Kaj je
Kdaj ga uporabiti
-validationapi=real
Privzeto. Komunicira z zunanjim preverjevalcem prek kanala ZMQ PUSH/PULL med vozliščem in preverjevalcem z uporabo FlatBuffers. Nastavitev za produkcijo.
Potrebuje pravi proces preverjevalca. Uporablja se na mainnetu, testnetu in pri vsakem zagonu regtest, ki preizkuša pravo ponovno izvajanje modela.
-validationapi=mock
V procesu in deterministično. Lažni zaledni sistem ponuja tri RPC-je (validationmockdefault, validationmockclear, validationmockrequests) za vnaprej pripravljene odgovore Quick, Full in Model; z zagonskimi zastavicami -mockval-default-* je vsak izid preverjanja mogoče skriptirati.
Privzeto za funkcionalni testni nabor. Prava izbira za poganjanje logike verige brez preverjevalca ali pravega sklepanja.
-validationapi=desktop
Hibridno. Preverjanja Quick tečejo v procesu; Full in Model se pošljejo lokalnemu preverjevalcu HTTPS (privzeta namizna binarna datoteka). Posrednik ZMQ ni potreben.
Predstavitve na enem računalniku, ki potrebujejo pravi prehod Quick in Smell, ne da bi upravljale ločeno storitev preverjevalca.
Za prvi pogled v logiko verige je mock pravi odgovor. Preostanek strani ga predpostavlja, razen kjer je navedeno drugače.
Pot A · samo Core, z lažno validacijo
Najmanj zapletov. En demon v C++: brez dockerja, brez GPU, brez datotek modelov na disku. Dovolj za vse vodnike na tej strani.
1. Zgradi demona
Za services/core-node/bcore/ sledi navodilom za gradnjo za Bitcoin Core. Koda TensorCash se gradi pod istim ciljem CMake kot upstream; ločene zastavice ni.
2. Zaženi vozlišče regtest
Te zastavice so enake tistim, ki jih test_framework/test_tensorcash.py poda vsakemu funkcionalnemu testu, zato vse, kar teče tam, teče tudi tukaj. Privzeti lažni odgovori so fiksirani na zeleno, zato je sprejemanje blokov deterministično.
Avtentikacija uporablja datoteko piškotka $HOME/.tensorcash-regtest/regtest/.cookie, ki jo bitcoin-cli samodejno prebere, ko podaš -datadir. Vrata RPC so privzeta vrata regtest iz upstreama, 18443.
Za primere, ko lažna validacija ni dovolj: pravi proces preverjevalca, pravi model, ki izvaja sklepanje, in priključen API rudarja. V korenu repozitorija so zagonski skripti za Mac in za Linux s CUDA.
Na Apple silicon zaganjalnik prenese gradnjo llama.cpp in zažene celoten sklad compose core-node + miner-api + verification-api:
Datoteka compose veže vrata gostitelja 8333 (P2P), 8050 (core-node REST API) in 7067 (ZMQ). Preverjevalec svoj Verifier REST API streže na lastnih vratih vsebnika.
Pot C · poženi funkcionalni testni nabor
Ko je demon zgrajen (pot A, 1. korak), testni zaganjalnik sam zažene začasna vozlišča. Uporabno, ko želiš preverjeno zaporedje, ki ga lahko prepišeš, ne pa demona, s katerim bi eksperimentiral.
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)
Testi TensorCash so razvrščeni po vmesnikih: življenjski cikel modela, izvorna sredstva, adaptorji fair-sign in denarnica za repo posle s covenanti. Vsak je samostojen scenarij, ki ga lahko prebereš od začetka do konca; spodnji vodniki kažejo na najbolj reprezentativne.
Vodniki po korakih
Tri kratka zaporedja na lažnem vozlišču iz poti A. Vsako je le skica; povezani funkcionalni test je celoten, izvedljiv scenarij.
Nespremenjeno glede na Bitcoin Core. Hiter preizkus pred katerim koli vmesnikom, specifičnim za TensorCash: potrdi, da demon teče in da ima denarnica sredstva.
Posebnost TensorCash. Model se registrira tako, da se položi depozit v escrow, zberejo uspešna preverjanja Quick in Model v N zavezah, nato pa preide v registered, ko se okno preverjanja zapre. Z -validationapi=mock lahko vsak korak izvedeš prek RPC-jev, brez pravega preverjevalca ali GPU. To je oris; povezani test je celoten scenarij.
Posebnost TensorCash. registerasset je visokonivojski RPC denarnice, ki zgradi izhoda za varščino in ICU, pripne TLV registracije izdajatelja in transakcijo odda. Po eni potrditvi lahko sredstvo poiščeš po ID-ju ali oznaki. Celoten življenjski cikel (kovanje, prenos, sežig) je v povezanem testu.