Tre lokale utviklingsveier, sortert etter friksjon. Hver av dem gir deg en TensorCash-JSON-RPC du kan kalle med bitcoin-cli eller en hvilken som helst JSON-RPC-klient. Den funksjonelle testpakken i bcore er den kanoniske, kjørbare spesifikasjonen for alt nedenfor, og hver gjennomgang lenker til testen den er hentet fra.
Bare Core · docker compose · funksjonelle tester
Valideringsmoduser
TensorCash legger til et eksternt valideringssteg i blokkaksepten. -validationapi velger backenden som utfører det, og det er det viktigste valget for en lokal kjøring: det avgjør om du trenger en GPU, en verifikatorprosess eller ingen av delene.
Flagg
Hva det er
Når du bør bruke den
-validationapi=real
Standardvalget. Snakker med en ekstern verifikator over ZMQ PUSH/PULL-kanalen mellom node og verifikator med FlatBuffers. Produksjonsinnstillingen.
Krever en ekte verifikatorprosess. Brukes på hovednettet, testnettet og alle regtest-kjøringer som tester ekte modellavspilling.
-validationapi=mock
I prosessen og deterministisk. Mock-backenden eksponerer tre RPC-er (validationmockdefault, validationmockclear, validationmockrequests) for forhåndsdefinerte Quick-, Full- og Model-svar; med oppstartsflaggene -mockval-default-* kan hvert verifiseringsutfall styres med skript.
Standard for den funksjonelle testpakken. Riktig valg når du vil teste kjedelogikken uten verifikator eller ekte inferens.
-validationapi=desktop
Hybrid. Quick-kontroller kjører i prosessen; Full og Model sendes til en lokal HTTPS-verifikator (standard skrivebordsbinærfil). Ingen ZMQ-megler nødvendig.
Demoer på én maskin som vil ha en ekte Quick- og Smell-kontroll uten å drifte en separat verifikatortjeneste.
For en første titt på kjedelogikken er mock riktig svar. Resten av siden forutsetter det, med mindre annet er oppgitt.
Vei A · bare Core, med mock-validering
Minst friksjon. Én C++-daemon: ingen docker, ingen GPU, ingen modellfiler på disk. Nok for alle gjennomgangene på denne siden.
1. Bygg daemonen
Følg byggeinstruksjonene for Bitcoin Core mot services/core-node/bcore/. TensorCash-koden bygges under det samme CMake-målet som oppstrøms; det finnes ikke noe eget flagg.
2. Start en regtest-node
Disse flaggene speiler det test_framework/test_tensorcash.py sender til hver funksjonelle test, så alt som kjører der, kjører også her. Standard mock-svar er låst til grønt, så blokkaksept er deterministisk.
Autentisering bruker cookie-filen i $HOME/.tensorcash-regtest/regtest/.cookie, som bitcoin-cli leser automatisk når du sender med -datadir. RPC-porten er oppstrøms standard for regtest, 18443.
For når mock ikke er nok: en ekte verifikatorprosess, en ekte modell som leverer inferens, og miner-API-et koblet inn. Rotkatalogen i repositoriet har oppstartsskript for Mac og for Linux med CUDA.
På Apple silicon henter oppstartsskriptet et llama.cpp-bygg og starter hele compose-stakken core-node + miner-api + verification-api:
Compose-filen binder vertsportene 8333 (P2P), 8050 (core-node REST-API) og 7067 (ZMQ). Verifikatoren leverer sitt Verifier-REST-API på sin egen containerport.
Vei C · kjør den funksjonelle testpakken
Når daemonen er bygget (vei A, steg 1), starter testkjøreren engangsnoder for deg. Nyttig når du vil ha en kjent, fungerende sekvens å kopiere fra, heller enn en daemon å eksperimentere med.
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-testene er gruppert etter grensesnitt: modellens livssyklus, native aktiva, fair-sign-adaptorer og covenant-repo-lommeboken. Hver er et selvstendig scenario du kan lese fra topp til bunn; gjennomgangene nedenfor peker på de mest representative.
Gjennomganger
Tre korte sekvenser mot mock-noden fra vei A. Hver av dem er en skisse; den lenkede funksjonelle testen er hele det kjørbare scenarioet.
TensorCash-spesifikt. En modell registreres ved å sette et depositum i escrow, samle vellykkede Quick- og Model-verifiseringer over N commits og deretter gå over til registered når verifiseringsvinduet lukkes. Med -validationapi=mock kan du styre hvert steg fra RPC-er, uten ekte verifikator eller GPU. Dette er en skisse; den lenkede testen er hele scenarioet.
TensorCash-spesifikt. registerasset er lommebokens høynivå-RPC som bygger depositums- og ICU-utgangene, legger ved utstederregistreringens TLV og kringkaster. Etter én bekreftelse kan aktivumet slås opp etter ID eller ticker. Hele livssyklusen (preging, overføring, brenning) finnes i den lenkede testen.