Tres rutas de desarrollo local, ordenadas de menor a mayor complejidad. Cada una te deja un JSON-RPC de TensorCash al que llamar con bitcoin-cli o cualquier cliente JSON-RPC. La suite de tests funcionales de bcore es la especificación canónica y ejecutable de todo lo que sigue, y cada recorrido enlaza el test del que se extrajo.
Solo Core · docker compose · tests funcionales
Modos de validación
TensorCash añade un paso de validación externa a la aceptación de bloques. -validationapi selecciona el backend que lo sirve, y es la decisión más importante en una ejecución local: determina si necesitas una GPU, un proceso verificador o ninguna de las dos cosas.
Opción
Qué es
Cuándo usarlo
-validationapi=real
El predeterminado. Se comunica con un verificador externo por el canal ZMQ PUSH/PULL entre nodo y verificador, usando FlatBuffers. La configuración de producción.
Necesita un proceso verificador real. Se usa en mainnet, en testnet y en cualquier ejecución de regtest que reproduzca modelos reales.
-validationapi=mock
Dentro del proceso y determinista. El backend simulado expone tres RPCs (validationmockdefault, validationmockclear, validationmockrequests) para respuestas Quick, Full y Model predefinidas; con los flags de arranque -mockval-default-*, cada resultado de verificación se puede programar.
El predeterminado de la suite de tests funcionales. La opción adecuada para ejercitar la lógica de la cadena sin verificador ni inferencia real.
-validationapi=desktop
Híbrido. Las comprobaciones Quick se ejecutan dentro del proceso; Full y Model se envían a un verificador HTTPS local (el binario de escritorio predeterminado). No necesita broker ZMQ.
Demos en una sola máquina que quieren una pasada real de Quick y Smell sin operar un servicio verificador aparte.
Para un primer vistazo a la lógica de la cadena, mock es la respuesta correcta. El resto de esta página lo da por supuesto salvo que se indique lo contrario.
Ruta A · solo Core, con validación simulada
La opción más sencilla. Un único daemon en C++: sin docker, sin GPU y sin archivos de modelo en disco. Suficiente para todos los recorridos de esta página.
1. Compila el daemon
Sigue las instrucciones de compilación de Bitcoin Core sobre services/core-node/bcore/. El código de TensorCash se compila con el mismo target de CMake que upstream; no hay ningún flag aparte.
2. Arranca un nodo regtest
Estos flags replican lo que test_framework/test_tensorcash.py pasa a cada test funcional, así que todo lo que funciona allí funciona también aquí. Las respuestas simuladas por defecto están fijadas en verde, de modo que la aceptación de bloques es determinista.
La autenticación usa el archivo de cookie en $HOME/.tensorcash-regtest/regtest/.cookie, que bitcoin-cli lee automáticamente cuando pasas -datadir. El puerto RPC es el predeterminado de regtest en upstream, 18443.
Para cuando la simulación no basta: un proceso verificador real, un modelo real sirviendo inferencia y la API del minero conectada. La raíz del repositorio incluye scripts de arranque para Mac y para Linux con CUDA.
En Apple silicon, el lanzador descarga una compilación de llama.cpp y levanta el stack de compose completo core-node + miner-api + verification-api:
El archivo de compose expone en el host los puertos 8333 (P2P), 8050 (la API REST del core-node) y 7067 (ZMQ). El verificador sirve su API REST del verificador en su propio puerto de contenedor.
Ruta C · ejecuta la suite de tests funcionales
Una vez compilado el daemon (Ruta A, paso 1), el ejecutor de tests arranca nodos desechables por ti. Útil cuando quieres una secuencia que funciona para copiarla, más que un daemon con el que trastear.
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)
Los tests de TensorCash se agrupan por área: ciclo de vida de modelos, activos nativos, adaptadores fair-sign y la wallet de repos con covenants. Cada uno es un escenario autónomo que puedes leer de principio a fin; los recorridos de abajo apuntan a los más representativos.
Recorridos guiados
Tres secuencias cortas contra el nodo simulado de la Ruta A. Cada una es un esbozo; el test funcional enlazado es el escenario completo y ejecutable.
Igual que en Bitcoin Core. Una prueba básica antes de cualquier interfaz específica de TensorCash: confirma que el daemon está en marcha y que la wallet tiene fondos.
Específico de TensorCash. Un modelo se registra depositando una garantía en custodia, reuniendo verificaciones Quick y Model correctas a lo largo de N commits y pasando a registered cuando se cierra la ventana de verificación. Con -validationapi=mock puedes ejecutar cada paso desde RPCs, sin verificador real ni GPU. Esto es un esquema; el test enlazado contiene el escenario completo.
Específico de TensorCash. registerasset es el RPC de alto nivel de la wallet que construye las salidas de fianza e ICU, adjunta el TLV de registro del emisor y difunde la transacción. Tras una confirmación, el activo se puede consultar por id o por ticker. El ciclo de vida completo (emisión, transferencia, quema) está en el test enlazado.