Tři cesty k lokálnímu vývoji, seřazené podle náročnosti. Každá ti zpřístupní JSON-RPC TensorCash, které můžeš volat přes bitcoin-cli nebo jakýkoli JSON-RPC klient. Kanonickou, spustitelnou specifikací všeho níže je sada funkčních testů bcore a každý návod odkazuje na test, ze kterého vychází.
Jen Core · docker compose · funkční testy
Režimy validace
TensorCash přidává k přijetí bloku externí validační krok. -validationapi vybírá backend, který ho obsluhuje, a pro lokální běh je to nejdůležitější volba: rozhoduje, zda potřebuješ GPU, proces ověřovatele, nebo ani jedno.
Přepínač
Co to je
Kdy ho použít
-validationapi=real
Výchozí režim. Komunikuje s externím ověřovatelem přes ZMQ PUSH/PULL kanál mezi uzlem a ověřovatelem pomocí FlatBuffers. Produkční nastavení.
Vyžaduje skutečný proces ověřovatele. Používá se na mainnetu, testnetu a v každém regtest běhu, který zkouší skutečný replay modelu.
-validationapi=mock
V procesu a deterministický. Mock backend nabízí tři RPC (validationmockdefault, validationmockclear, validationmockrequests) pro předpřipravené odpovědi Quick, Full a Model; se startovacími přepínači -mockval-default-* lze naskriptovat každý výsledek ověření.
Výchozí režim sady funkčních testů. Správná volba, když chceš řídit logiku řetězce bez ověřovatele a bez skutečné inference.
-validationapi=desktop
Hybridní. Kontroly Quick běží v procesu; Full a Model se posílají lokálnímu HTTPS ověřovateli (výchozí desktopová binárka). ZMQ broker není potřeba.
Ukázky na jednom stroji, které chtějí skutečný průchod Quick a Smell bez provozování samostatné ověřovací služby.
Pro první seznámení s logikou řetězce je správnou odpovědí mock. Zbytek stránky s ním počítá, pokud není uvedeno jinak.
Cesta A · jen Core, s mock validací
Nejméně překážek. Jediný démon v C++: žádný docker, žádná GPU, žádné soubory modelů na disku. Stačí na všechny návody na této stránce.
1. Sestav démona
Postupuj podle návodu k sestavení Bitcoin Core nad services/core-node/bcore/. Kód TensorCash se sestavuje pod stejným CMake targetem jako upstream; žádný zvláštní přepínač není potřeba.
2. Spusť regtest uzel
Tyto přepínače odpovídají tomu, co test_framework/test_tensorcash.py předává každému funkčnímu testu, takže co běží tam, poběží i tady. Výchozí mock odpovědi jsou napevno nastavené na green, takže přijetí bloku je deterministické.
Autentizace používá cookie soubor $HOME/.tensorcash-regtest/regtest/.cookie, který bitcoin-cli načte automaticky, když předáš -datadir. RPC port je výchozí upstream port pro regtest, 18443.
Cesta B · kompletní lokální stack (docker compose)
Pro chvíle, kdy mock nestačí: skutečný proces ověřovatele, skutečný model obsluhující inferenci a zapojené miner API. V kořeni repozitáře jsou spouštěcí skripty pro Macy a pro Linux s CUDA.
Na Apple Silicon spouštěč stáhne build llama.cpp a spustí celý compose stack core-node + miner-api + verification-api:
Compose soubor váže hostitelské porty 8333 (P2P), 8050 (core-node REST API) a 7067 (ZMQ). Ověřovatel poskytuje své Verifier REST API na vlastním portu kontejneru.
Cesta C · spusť sadu funkčních testů
Jakmile máš démona sestaveného (Cesta A, krok 1), spouštěč testů za tebe nastartuje jednorázové uzly. Hodí se, když chceš ověřenou sekvenci, ze které můžeš opisovat, místo démona, do kterého bys šťouchal.
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 jsou seskupené podle rozhraní: životní cyklus modelů, nativní aktiva, fair-sign adaptory a covenantová repo peněženka. Každý je samostatný scénář, který se dá číst odshora dolů; návody níže odkazují na ty nejreprezentativnější.
Návody krok za krokem
Tři krátké sekvence proti mock uzlu z Cesty A. Každá je jen náčrt; úplný spustitelný scénář je v odkazovaném funkčním testu.
Specifické pro TensorCash. Model se registruje tak, že se do úschovy složí záloha, během N commitů se nasbírají úspěšná ověření Quick a Model a po uzavření ověřovacího okna model přejde do stavu registered. S -validationapi=mock můžeš každý krok řídit přes RPC, bez skutečného ověřovatele i GPU. Tohle je jen nástin; celý scénář je v odkazovaném testu.
Specifické pro TensorCash. registerasset je vysokoúrovňové RPC peněženky, které sestaví výstupy kauce a ICU, připojí TLV s registrací emitenta a transakci odvysílá. Po jednom potvrzení lze aktivum dohledat podle id nebo tickeru. Celý životní cyklus (mint, převod, burn) je v odkazovaném testu.