Tres camins de desenvolupament local, ordenats de més senzill a més complex. Cadascun et posa davant un JSON-RPC de TensorCash per cridar-lo amb bitcoin-cli o qualsevol client JSON-RPC. El conjunt de proves funcionals de bcore és l'especificació canònica i executable de tot el que segueix, i cada recorregut enllaça la prova de la qual s'ha extret.
Només Core · docker compose · proves funcionals
Modes de validació
TensorCash afegeix un pas de validació externa a l'acceptació de blocs. -validationapi selecciona el backend que la fa, i és la decisió més important per a una execució local: determina si necessites una GPU, un procés verificador o cap de les dues coses.
Opció
Què és
Quan fer-lo servir
-validationapi=real
El mode per defecte. Es comunica amb un verificador extern pel canal ZMQ PUSH/PULL entre node i verificador fent servir FlatBuffers. És la configuració de producció.
Necessita un procés verificador real. S'utilitza a la mainnet, a la testnet i en qualsevol execució regtest que posi a prova la repetició real del model.
-validationapi=mock
Dins del procés i determinista. El backend simulat exposa tres RPC (validationmockdefault, validationmockclear, validationmockrequests) per a respostes Quick, Full i Model predefinides; amb les opcions d'arrencada -mockval-default-*, tots els resultats de verificació es poden programar.
El mode per defecte del conjunt de proves funcionals. L'opció adequada per fer funcionar la lògica de la cadena sense verificador ni inferència real.
-validationapi=desktop
Híbrid. Les comprovacions Quick s'executen dins del procés; les Full i Model s'envien a un verificador HTTPS local (el binari d'escriptori per defecte). No cal cap broker ZMQ.
Demostracions en una sola màquina que volen una passada Quick i Smell real sense haver de gestionar un servei verificador separat.
Per a una primera ullada a la lògica de la cadena, mock és la resposta encertada. La resta d'aquesta pàgina ho dona per fet si no s'indica el contrari.
Camí A · només Core, amb validació simulada
La via més senzilla. Un sol dimoni en C++: sense Docker, sense GPU, sense fitxers de model al disc. N'hi ha prou per a tots els recorreguts d'aquesta pàgina.
1. Compila el dimoni
Segueix les instruccions de compilació de Bitcoin Core sobre services/core-node/bcore/. El codi de TensorCash es compila amb el mateix objectiu CMake que l'original; no hi ha cap opció separada.
2. Inicia un node regtest
Aquestes opcions reprodueixen el que test_framework/test_tensorcash.py passa a cada prova funcional, així que tot el que funciona allà també funciona aquí. Les respostes simulades per defecte estan fixades en verd, de manera que l'acceptació de blocs és determinista.
L'autenticació fa servir el fitxer de cookie a $HOME/.tensorcash-regtest/regtest/.cookie, que bitcoin-cli llegeix automàticament quan passes -datadir. El port RPC és el predeterminat de regtest a l'original, 18443.
Per quan la simulació no n'hi ha prou: un procés verificador real, un model real servint inferència i l'API del miner connectada. L'arrel del repositori té scripts d'arrencada per a Mac i per a Linux amb CUDA.
A Apple silicon, el llançador baixa una compilació de llama.cpp i aixeca l'stack compose complet core-node + miner-api + verification-api:
El fitxer compose vincula els ports de l'amfitrió 8333 (P2P), 8050 (l'API REST de core-node) i 7067 (ZMQ). El verificador serveix la seva API REST del verificador al seu propi port de contenidor.
Camí C · executa el conjunt de proves funcionals
Un cop compilat el dimoni (camí A, pas 1), l'executor de proves t'arrenca nodes d'un sol ús. És útil quan vols una seqüència que se sap que funciona per copiar-la, més que no pas un dimoni per remenar.
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)
Les proves de TensorCash s'agrupen per àmbit: cicle de vida dels models, actius natius, adaptadors fair-sign i el moneder de repo amb covenants. Cadascuna és un escenari autònom que pots llegir de dalt a baix; els recorreguts de més avall remeten als més representatius.
Recorreguts
Tres seqüències breus contra el node simulat del camí A. Cadascuna és un esbós; la prova funcional enllaçada és l'escenari complet i executable.
Igual que a Bitcoin Core. Una prova de fum abans de tocar cap interfície pròpia de TensorCash: confirma que el dimoni funciona i que el moneder té fons.
Específic de TensorCash. Un model es registra bloquejant un dipòsit en garantia, acumulant verificacions Quick i Model reeixides al llarg de N commits i passant a registered quan es tanca la finestra de verificació. Amb -validationapi=mock pots fer cada pas des d'RPC, sense verificador real ni GPU. Això és un esquema; la prova enllaçada conté l'escenari complet.
Específic de TensorCash. registerasset és l'RPC de moneder d'alt nivell que construeix les sortides de fiança i d'ICU, hi adjunta el TLV de registre de l'emissor i fa la difusió. Després d'una confirmació, l'actiu es pot consultar per id o per ticker. El cicle de vida complet (encunyació, transferència, crema) és a la prova enllaçada.
Faucet de la testnetL'equivalent en línia: finança un moneder a la testnet compartida quan vulguis una cadena real en lloc d'un entorn de proves local.