Trois voies de développement local, classées par niveau de friction. Chacune vous met face à un JSON-RPC TensorCash à appeler avec bitcoin-cli ou n’importe quel client JSON-RPC. La suite de tests fonctionnels de bcore est la spécification canonique et exécutable de tout ce qui suit, et chaque tutoriel renvoie au test dont il est tiré.
Core seul · docker compose · tests fonctionnels
Modes de validation
TensorCash ajoute une étape de validation externe à l’acceptation des blocs. -validationapi choisit le backend qui la fournit ; c’est le choix le plus important pour une exécution locale, car il détermine si vous avez besoin d’un GPU, d’un processus vérificateur, ou de rien du tout.
Option
Ce que c’est
Quand l’utiliser
-validationapi=real
Le mode par défaut. Communique avec un vérificateur externe par le canal ZMQ PUSH/PULL entre nœud et vérificateur, en FlatBuffers. Le réglage de production.
Nécessite un vrai processus vérificateur. Utilisé sur le mainnet, le testnet et toute session regtest qui met en œuvre un vrai rejeu de modèle.
-validationapi=mock
Dans le processus et déterministe. Le backend simulé expose trois RPC (validationmockdefault, validationmockclear, validationmockrequests) pour des réponses Quick, Full et Model préenregistrées ; avec les options de démarrage -mockval-default-*, chaque résultat de vérification est scriptable.
Le mode par défaut de la suite de tests fonctionnels. Le bon choix pour piloter la logique de la chaîne sans vérificateur ni inférence réelle.
-validationapi=desktop
Hybride. Les vérifications Quick s’exécutent dans le processus ; Full et Model sont envoyées à un vérificateur HTTPS local (le binaire desktop par défaut). Aucun broker ZMQ nécessaire.
Démos sur une seule machine qui nécessitent une vraie passe Quick et Smell, sans exploiter de service vérificateur séparé.
Pour une première exploration de la logique de la chaîne, mock est le bon choix. Sauf mention contraire, la suite de cette page part de ce mode.
Voie A · Core seul, avec validation simulée
Le moins de friction possible. Un seul daemon C++ : pas de docker, pas de GPU, aucun fichier de modèle sur le disque. Suffisant pour tous les tutoriels de cette page.
1. Compiler le daemon
Suivez les instructions de compilation de Bitcoin Core dans services/core-node/bcore/. Le code TensorCash se compile avec la même cible CMake qu’en amont ; il n’y a pas d’option séparée.
2. Démarrer un nœud regtest
Ces options reprennent celles que test_framework/test_tensorcash.py passe à chaque test fonctionnel : tout ce qui tourne là-bas tourne aussi ici. Les réponses simulées par défaut sont fixées au vert, donc l’acceptation des blocs est déterministe.
L’authentification utilise le fichier cookie $HOME/.tensorcash-regtest/regtest/.cookie, que bitcoin-cli lit automatiquement quand vous passez -datadir. Le port RPC est le port regtest par défaut de Bitcoin Core, 18443.
Voie B · la stack locale complète (docker compose)
Quand la simulation ne suffit plus : un vrai processus vérificateur, un vrai modèle qui sert l’inférence, et l’API du mineur branchée. La racine du dépôt contient des scripts de lancement pour Mac et pour Linux avec CUDA.
Sur Apple silicon, le lanceur récupère une build de llama.cpp et démarre la stack compose complète core-node + miner-api + verification-api :
Le fichier compose expose les ports hôte 8333 (P2P), 8050 (l’API REST core-node) et 7067 (ZMQ). Le vérificateur sert son API REST du vérificateur sur son propre port de conteneur.
Voie C · lancer la suite de tests fonctionnels
Une fois le daemon compilé (voie A, étape 1), le lanceur de tests démarre pour vous des nœuds jetables. Pratique quand vous voulez une séquence éprouvée à copier plutôt qu’un daemon à explorer.
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 tests TensorCash sont regroupés par domaine : cycle de vie des modèles, actifs natifs, adaptateurs fair-sign et wallet repo à covenant. Chacun est un scénario autonome qui se lit de haut en bas ; les tutoriels ci-dessous renvoient aux plus représentatifs.
Tutoriels
Trois courtes séquences à exécuter sur le nœud simulé de la voie A. Chacune n’est qu’une esquisse ; le test fonctionnel associé est le scénario complet et exécutable.
Identique à Bitcoin Core. Un test de fumée avant toute fonctionnalité spécifique à TensorCash : il confirme que le daemon tourne et que le wallet est approvisionné.
Spécifique à TensorCash. Un modèle s’enregistre en bloquant un dépôt sous séquestre, en accumulant des vérifications Quick et Model réussies sur N commits, puis passe à l’état registered une fois la fenêtre de vérification close. Avec -validationapi=mock, chaque étape se pilote par RPC, sans vrai vérificateur ni GPU. Ceci n’est qu’un aperçu ; le test associé contient le scénario complet.
Spécifique à TensorCash. registerasset est la RPC de haut niveau du wallet qui construit les sorties de caution et ICU, joint le TLV d’enregistrement de l’émetteur et diffuse la transaction. Après une confirmation, l’actif peut être interrogé par identifiant ou par ticker. Le cycle de vie complet (création, transfert, destruction) se trouve dans le test associé.