Drie routes voor lokale ontwikkeling, van eenvoudig naar uitgebreid. Elke route geeft je een TensorCash-JSON-RPC die je kunt aanroepen met bitcoin-cli of een andere JSON-RPC-client. De functionele testsuite van bcore is de canonieke, uitvoerbare specificatie voor alles hieronder, en bij elk voorbeeld staat een link naar de test waaruit het is afgeleid.
Alleen Core · docker compose · functionele tests
Validatiemodi
TensorCash voegt een externe validatiestap toe aan de acceptatie van blokken. -validationapi kiest de backend die deze stap uitvoert, en dat is de belangrijkste keuze voor een lokale run: die bepaalt of je een GPU nodig hebt, een verifierproces, of geen van beide.
Flag
Wat het is
Wanneer gebruiken
-validationapi=real
De standaard. Communiceert met een externe verifier via het ZMQ PUSH/PULL-kanaal tussen node en verifier, met FlatBuffers. De instelling voor productie.
Vereist een echt verifierproces. Wordt gebruikt op mainnet, testnet en bij elke regtest-run die echte replay van modellen test.
-validationapi=mock
In het proces zelf en deterministisch. De mock-backend biedt drie RPC's (validationmockdefault, validationmockclear, validationmockrequests) voor vooraf ingestelde Quick-, Full- en Model-responses; met de startflags -mockval-default-* is elke verificatie-uitkomst te scripten.
De standaard voor de functionele testsuite. De juiste keuze om de blockchainlogica aan te sturen zonder verifier of echte inferentie.
-validationapi=desktop
Hybride. Quick-controles draaien in het proces zelf; Full en Model gaan naar een lokale HTTPS-verifier (de standaard desktopbinary). Geen ZMQ-broker nodig.
Demo's op één machine waarbij je een echte Quick- en Smell-controle wilt, zonder een aparte verifierdienst te beheren.
Voor een eerste blik op de blockchainlogica is mock de juiste keuze. De rest van deze pagina gaat daarvan uit, tenzij anders vermeld.
Route A · alleen Core, met gesimuleerde validatie
De eenvoudigste route. Eén C++-daemon: geen Docker, geen GPU, geen modelbestanden op schijf. Genoeg voor elk voorbeeld op deze pagina.
1. Bouw de daemon
Volg de build-instructies van Bitcoin Core en pas ze toe op services/core-node/bcore/. De TensorCash-code wordt gebouwd met hetzelfde CMake-target als upstream; er is geen aparte flag.
2. Start een regtest-node
Deze flags komen overeen met wat test_framework/test_tensorcash.py aan elke functionele test meegeeft, dus alles wat daar draait, draait hier ook. De standaard mock-responses staan vast op GREEN, dus blokacceptatie is deterministisch.
Authenticatie gaat via het cookiebestand in $HOME/.tensorcash-regtest/regtest/.cookie, dat bitcoin-cli automatisch leest als je -datadir meegeeft. De RPC-poort is de standaardpoort van upstream voor regtest, 18443.
Route B · de volledige lokale stack (docker compose)
Voor als gesimuleerde validatie niet genoeg is: een echt verifierproces, een echt model dat inferentie levert, en de miner-API aangesloten. In de root van de repository staan startscripts voor Macs en voor Linux met CUDA.
Op Apple silicon haalt het startscript een build van llama.cpp binnen en start het de volledige compose-stack core-node + miner-api + verification-api:
Zodra de daemon gebouwd is (route A, stap 1), start de testrunner wegwerpnodes voor je. Handig als je een bewezen werkende reeks wilt om van over te nemen, in plaats van een daemon om mee te experimenteren.
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)
De TensorCash-tests zijn ingedeeld per onderdeel: levenscyclus van modellen, native assets, fair-sign-adaptors en de covenant-repowallet. Elke test is een op zichzelf staand scenario dat je van boven naar beneden kunt lezen; de voorbeelden hieronder verwijzen naar de meest representatieve.
Uitgewerkte voorbeelden
Drie korte reeksen op de mock-node uit route A. Elke reeks is een schets; de gelinkte functionele test is het volledige, uitvoerbare scenario.
Ongewijzigd ten opzichte van Bitcoin Core. Een smoketest voordat je iets aanraakt wat specifiek is voor TensorCash: hij bevestigt dat de daemon draait en dat de wallet gevuld is.
Specifiek voor TensorCash. Een model wordt geregistreerd door een deposito in escrow te zetten, over N commits geslaagde Quick- en Model-verificaties te verzamelen en daarna naar registered over te gaan zodra het verificatievenster sluit. Met -validationapi=mock kun je elke stap via RPC's aansturen, zonder echte verifier of GPU. Dit is een schets; de gelinkte test bevat het volledige scenario.
Specifiek voor TensorCash. registerasset is de wallet-RPC op hoog niveau die de borg- en ICU-outputs opbouwt, de TLV met de registratie van de uitgever toevoegt en de transactie naar het netwerk verzendt. Na één bevestiging kun je de asset opvragen op id of ticker. De volledige levenscyclus (aanmaken, overdragen, verbranden) staat in de gelinkte test.