Три пути локальной разработки — от самого простого к самому сложному. Каждый даёт вам JSON-RPC TensorCash, к которому можно обращаться через bitcoin-cli или любой JSON-RPC-клиент. Набор функциональных тестов bcore — каноническая исполняемая спецификация всего, что описано ниже, и каждый сценарий ссылается на тест, из которого он взят.
Только Core · docker compose · функциональные тесты
Режимы валидации
TensorCash добавляет к приёму блока шаг внешней валидации. -validationapi выбирает бэкенд, который его выполняет, и это самый важный выбор для локального запуска: от него зависит, нужен ли вам GPU, процесс верификатора или ни то ни другое.
Флаг
Что это
Когда использовать
-validationapi=real
Режим по умолчанию. Общается с внешним верификатором по каналу ZMQ PUSH/PULL между узлом и верификатором с использованием FlatBuffers. Продакшен-настройка.
Нужен настоящий процесс верификатора. Используется в mainnet, testnet и в любом regtest-запуске с реальным воспроизведением модели.
-validationapi=mock
Внутри процесса и детерминированно. Mock-бэкенд предоставляет три RPC (validationmockdefault, validationmockclear, validationmockrequests) для заготовленных ответов Quick, Full и Model; с флагами запуска -mockval-default-* любой результат верификации задаётся сценарием.
Режим по умолчанию для набора функциональных тестов. Правильный выбор, чтобы гонять логику цепочки без верификатора и реального инференса.
-validationapi=desktop
Гибридный режим. Проверки Quick выполняются внутри процесса; Full и Model отправляются локальному HTTPS-верификатору (десктопный бинарник по умолчанию). Брокер ZMQ не нужен.
Демо на одной машине, где нужен настоящий проход Quick и Smell без отдельного сервиса верификатора.
Для первого знакомства с логикой цепочки правильный ответ — mock. Если не сказано иное, остальная часть страницы исходит из него.
Путь A · только Core, с mock-валидацией
Самый простой путь. Один демон на C++: без docker, без GPU, без файлов моделей на диске. Этого хватает для всех сценариев на этой странице.
1. Соберите демон
Следуйте инструкциям по сборке Bitcoin Core для services/core-node/bcore/. Код TensorCash собирается в той же цели CMake, что и upstream; отдельного флага нет.
2. Запустите regtest-узел
Эти флаги повторяют то, что test_framework/test_tensorcash.py передаёт каждому функциональному тесту, поэтому всё, что работает там, работает и здесь. Ответы mock по умолчанию закреплены на green, так что приём блоков детерминирован.
Аутентификация идёт через cookie-файл $HOME/.tensorcash-regtest/regtest/.cookie, который bitcoin-cli читает автоматически, если передать -datadir. Порт RPC — стандартный для regtest в upstream: 18443.
Когда mock недостаточно: настоящий процесс верификатора, настоящая модель, обслуживающая инференс, и подключённый API майнера. В корне репозитория есть скрипты запуска для Mac и для Linux с CUDA.
На Apple silicon лаунчер скачивает сборку llama.cpp и поднимает полный compose-стек core-node + miner-api + verification-api:
Compose-файл занимает порты хоста 8333 (P2P), 8050 (REST API core-node) и 7067 (ZMQ). Верификатор отдаёт REST API верификатора на собственном порту контейнера.
Путь C · набор функциональных тестов
Когда демон собран (путь A, шаг 1), тест-раннер сам запускает одноразовые узлы. Удобно, если вам нужна заведомо рабочая последовательность команд, а не демон для экспериментов.
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)
Тесты TensorCash сгруппированы по интерфейсам: жизненный цикл моделей, нативные активы, адаптеры fair-sign и covenant-кошелёк для репо. Каждый — самостоятельный сценарий, который читается сверху вниз; сценарии ниже ссылаются на самые показательные из них.
Пошаговые сценарии
Три короткие последовательности для mock-узла из пути A. Каждая — лишь набросок; полный исполняемый сценарий — в функциональном тесте по ссылке.
Специфично для TensorCash. Модель регистрируется так: депозит блокируется в эскроу, в N коммитах собираются успешные верификации Quick и Model, а после закрытия окна верификации модель переходит в статус registered. С -validationapi=mock каждый шаг можно выполнить через RPC, без настоящего верификатора и GPU. Здесь только схема; полный сценарий — в тесте по ссылке.
Специфично для TensorCash. registerasset — высокоуровневый RPC кошелька: он формирует выходы бонда и ICU, добавляет TLV регистрации эмитента и отправляет транзакцию в сеть. После одного подтверждения актив можно запросить по id или тикеру. Полный жизненный цикл (выпуск, перевод, сжигание) — в тесте по ссылке.