Trzy ścieżki lokalnego developmentu, od najprostszej. Każda daje ci JSON-RPC TensorCash, który wywołasz przez bitcoin-cli lub dowolnego klienta JSON-RPC. Zestaw testów funkcjonalnych bcore to kanoniczna, wykonywalna specyfikacja wszystkiego, co opisano poniżej, a każdy przykład odsyła do testu, na podstawie którego powstał.
Sam Core · docker compose · testy funkcjonalne
Tryby walidacji
TensorCash dodaje do akceptacji bloków zewnętrzny krok walidacji. -validationapi wybiera backend, który go obsługuje, i to najważniejsza decyzja przy lokalnym uruchomieniu: od niej zależy, czy potrzebujesz GPU, procesu weryfikatora, czy żadnego z nich.
Flaga
Na czym polega
Kiedy go używać
-validationapi=real
Tryb domyślny. Komunikuje się z zewnętrznym weryfikatorem przez kanał ZMQ PUSH/PULL między węzłem a weryfikatorem, z użyciem FlatBuffers. Ustawienie produkcyjne.
Wymaga prawdziwego procesu weryfikatora. Używany w mainnecie, testnecie i każdym uruchomieniu regtest, które sprawdza prawdziwe odtwarzanie modelu.
-validationapi=mock
W procesie i deterministycznie. Backend mock udostępnia trzy RPC (validationmockdefault, validationmockclear, validationmockrequests) z gotowymi odpowiedziami Quick, Full i Model; dzięki flagom startowym -mockval-default-* każdy wynik weryfikacji można zaskryptować.
Domyślny tryb zestawu testów funkcjonalnych. Właściwy wybór, gdy chcesz sterować logiką łańcucha bez weryfikatora i prawdziwej inferencji.
-validationapi=desktop
Tryb hybrydowy. Kontrole Quick działają w procesie; Full i Model trafiają do lokalnego weryfikatora HTTPS (domyślnej binarki desktopowej). Broker ZMQ nie jest potrzebny.
Dema na jednej maszynie, które mają przejść prawdziwą kontrolę Quick i Smell bez obsługi osobnej usługi weryfikatora.
Do pierwszego zapoznania się z logiką łańcucha najlepiej nadaje się mock. Dalsza część strony zakłada ten tryb, o ile nie zaznaczono inaczej.
Ścieżka A · sam Core z mockowaną walidacją
Najmniej zachodu. Jeden demon C++: bez dockera, bez GPU, bez plików modeli na dysku. Wystarczy do każdego przykładu na tej stronie.
1. Skompiluj demona
Postępuj zgodnie z instrukcjami kompilacji Bitcoin Core dla services/core-node/bcore/. Kod TensorCash kompiluje się w tym samym celu CMake co upstream; nie ma osobnej flagi.
2. Uruchom węzeł regtest
Te flagi odpowiadają temu, co test_framework/test_tensorcash.py przekazuje każdemu testowi funkcjonalnemu, więc wszystko, co działa tam, zadziała też tutaj. Domyślne odpowiedzi mocka są ustawione na zielony wynik, więc akceptacja bloków jest deterministyczna.
Uwierzytelnianie korzysta z pliku cookie $HOME/.tensorcash-regtest/regtest/.cookie, który bitcoin-cli odczytuje automatycznie, gdy podasz -datadir. Port RPC to domyślny port regtest z upstreamu, 18443.
Gdy mock nie wystarcza: prawdziwy proces weryfikatora, prawdziwy model obsługujący inferencję i podłączone API górnika. W katalogu głównym repozytorium są skrypty uruchomieniowe dla Maców oraz dla Linuksa z CUDA.
Na Apple silicon skrypt pobiera build llama.cpp i uruchamia pełny stos compose core-node + miner-api + verification-api:
Plik compose wiąże porty hosta 8333 (P2P), 8050 (core-node REST API) i 7067 (ZMQ). Weryfikator udostępnia swoje Verifier REST API na własnym porcie kontenera.
Ścieżka C · uruchom zestaw testów funkcjonalnych
Gdy demon jest już skompilowany (Ścieżka A, krok 1), runner testów sam uruchamia jednorazowe węzły. Przydatne, gdy chcesz skopiować sprawdzoną sekwencję, a nie eksperymentować z demonem.
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)
Testy TensorCash są pogrupowane według obszaru: cykl życia modeli, aktywa natywne, adaptory fair-sign i portfel repo z kowenantami. Każdy to samodzielny scenariusz, który można przeczytać od początku do końca; przykłady poniżej wskazują te najbardziej reprezentatywne.
Przykłady krok po kroku
Trzy krótkie sekwencje na węźle z mockiem ze Ścieżki A. Każda to tylko szkic; pełnym, wykonywalnym scenariuszem jest podlinkowany test funkcjonalny.
Bez zmian względem Bitcoin Core. Test dymny przed jakimkolwiek interfejsem specyficznym dla TensorCash: potwierdza, że demon działa, a portfel ma środki.
Specyficzne dla TensorCash. Model rejestruje się, deponując kaucję, zbierając udane weryfikacje Quick i Model w N commitach, a następnie przechodząc do stanu registered po zamknięciu okna weryfikacji. Z -validationapi=mock każdy krok wykonasz przez RPC, bez prawdziwego weryfikatora i GPU. To tylko zarys; pełny scenariusz zawiera podlinkowany test.
Specyficzne dla TensorCash. registerasset to wysokopoziomowe RPC portfela, które buduje wyjścia kaucji i ICU, dołącza TLV rejestracji emitenta i rozgłasza transakcję. Po jednym potwierdzeniu aktywo można odpytać po identyfikatorze lub tickerze. Pełny cykl życia (mint, transfer, burn) znajdziesz w podlinkowanym teście.