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