Tre vägar för lokal utveckling, ordnade efter friktion. Var och en ger dig en TensorCash-JSON-RPC att anropa med bitcoin-cli eller valfri JSON-RPC-klient. bcores funktionella testsvit är den kanoniska, körbara specifikationen för allt nedan, och varje genomgång länkar till testet den bygger på.
Bara Core · docker compose · funktionella tester
Valideringslägen
TensorCash lägger till ett externt valideringssteg i blockacceptansen. -validationapi väljer backenden som utför det, och det är det viktigaste valet för en lokal körning: det avgör om du behöver en GPU, en verifierarprocess eller ingetdera.
Flagga
Vad det är
När du ska använda det
-validationapi=real
Standardläget. Kommunicerar med en extern verifierare över ZMQ-kanalen PUSH/PULL mellan nod och verifierare, med FlatBuffers. Inställningen för produktion.
Kräver en riktig verifierarprocess. Används på mainnet, testnet och i varje regtest-körning som testar verklig omkörning av modeller.
-validationapi=mock
I processen och deterministiskt. Mock-backenden exponerar tre RPC:er (validationmockdefault, validationmockclear, validationmockrequests) för förberedda svar på Quick, Full och Model; med startflaggorna -mockval-default-* går varje verifieringsutfall att skripta.
Standard för den funktionella testsviten. Rätt val för att driva kedjelogiken utan verifierare eller riktig inferens.
-validationapi=desktop
Hybrid. Quick-kontroller körs i processen; Full och Model skickas till en lokal HTTPS-verifierare (standardbinären för skrivbordet). Ingen ZMQ-broker behövs.
Demonstrationer på en enda maskin som vill ha en riktig Quick- och Smell-kontroll utan att driva en separat verifieringstjänst.
För en första titt på kedjelogiken är mock rätt svar. Resten av sidan utgår från det om inget annat anges.
Väg A · bara Core, med mockvalidering
Minst friktion. En C++-daemon: ingen docker, ingen GPU, inga modellfiler på disken. Räcker för varje genomgång på den här sidan.
1. Bygg daemonen
Följ Bitcoin Cores bygginstruktioner mot services/core-node/bcore/. TensorCash-koden byggs under samma CMake-mål som upstream; det finns ingen separat flagga.
2. Starta en regtest-nod
De här flaggorna motsvarar det som test_framework/test_tensorcash.py skickar till varje funktionellt test, så allt som körs där körs här också. Standardsvaren från mocken är låsta till grönt, så blockacceptansen är deterministisk.
Autentiseringen använder cookiefilen $HOME/.tensorcash-regtest/regtest/.cookie, som bitcoin-cli läser automatiskt när du anger -datadir. RPC-porten är upstreams standardport för regtest, 18443.
För när mocken inte räcker: en riktig verifierarprocess, en riktig modell som levererar inferens och miner-API:t inkopplat. I repots rot finns startskript för Mac och för Linux med CUDA.
På Apple silicon hämtar startskriptet ett llama.cpp-bygge och startar hela compose-stacken core-node + miner-api + verification-api:
Compose-filen binder värdportarna 8333 (P2P), 8050 (core-node REST-API) och 7067 (ZMQ). Verifieraren exponerar sitt Verifier REST-API på sin egen containerport.
Väg C · kör den funktionella testsviten
När daemonen är byggd (väg A, steg 1) startar testköraren tillfälliga noder åt dig. Användbart när du vill ha en beprövad sekvens att kopiera från snarare än en daemon att peta i.
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-testerna är grupperade efter gränssnitt: modellernas livscykel, nativa tillgångar, fair-sign-adaptrar och covenant-repaplånboken. Varje test är ett fristående scenario som du kan läsa uppifrån och ned; genomgångarna nedan pekar på de mest representativa.
Genomgångar
Tre korta sekvenser mot mocknoden från väg A. Var och en är en skiss; det länkade funktionella testet är det fullständiga, körbara scenariot.
TensorCash-specifikt. En modell registreras genom att en deposition låses, lyckade Quick- och Model-verifieringar samlas in över N commits och modellen sedan går över till registered när verifieringsfönstret stängs. Med -validationapi=mock kan du driva varje steg via RPC:er, utan riktig verifierare eller GPU. Det här är en översikt; det länkade testet innehåller hela scenariot.
TensorCash-specifikt. registerasset är plånbokens högnivå-RPC som bygger bond- och ICU-utgångarna, bifogar emittentens registrerings-TLV och sänder transaktionen. Efter en bekräftelse kan tillgången hämtas via id eller ticker. Hela livscykeln (mint, överföring, bränning) finns i det länkade testet.