Três caminhos de desenvolvimento local, do mais simples ao mais trabalhoso. Cada um coloca à sua disposição um JSON-RPC da TensorCash para chamar com o bitcoin-cli ou qualquer cliente JSON-RPC. A suíte de testes funcionais do bcore é a especificação canônica e executável de tudo o que vem abaixo, e cada passo a passo indica o teste do qual foi extraído.
Só o Core · docker compose · testes funcionais
Modos de validação
A TensorCash adiciona uma etapa de validação externa à aceitação de blocos. -validationapi seleciona o backend que a executa, e é a escolha mais importante para uma execução local: define se você precisa de uma GPU, de um processo verificador ou de nenhum dos dois.
Flag
O que é
Quando usar
-validationapi=real
O padrão. Comunica-se com um verificador externo pelo canal ZMQ PUSH/PULL entre nó e verificador, usando FlatBuffers. A configuração de produção.
Exige um processo verificador real. Usado na mainnet, na testnet e em qualquer execução regtest que exercite o replay real de modelos.
-validationapi=mock
No próprio processo e determinístico. O backend simulado expõe três RPCs (validationmockdefault, validationmockclear, validationmockrequests) para respostas Quick, Full e Model predefinidas; com as flags de inicialização -mockval-default-*, todo resultado de verificação pode ser programado.
O padrão da suíte de testes funcionais. A escolha certa para exercitar a lógica da cadeia sem verificador nem inferência real.
-validationapi=desktop
Híbrido. As verificações Quick rodam no próprio processo; Full e Model são enviadas a um verificador HTTPS local (o binário desktop padrão). Não precisa de broker ZMQ.
Demonstrações em uma única máquina que querem uma passada real de Quick e Smell sem operar um serviço verificador separado.
Para um primeiro contato com a lógica da cadeia, mock é a resposta certa. O restante desta página parte desse modo, salvo indicação em contrário.
Caminho A · só o core, com validação simulada
O caminho mais simples. Um único daemon em C++: sem docker, sem GPU, sem arquivos de modelo no disco. Suficiente para todos os passo a passo desta página.
1. Compile o daemon
Siga as instruções de compilação do Bitcoin Core em services/core-node/bcore/. O código da TensorCash compila no mesmo alvo CMake do upstream; não há flag separada.
2. Inicie um nó regtest
Essas flags reproduzem o que test_framework/test_tensorcash.py passa para cada teste funcional, então tudo o que roda lá roda aqui também. As respostas simuladas padrão estão fixadas em verde, então a aceitação de blocos é determinística.
A autenticação usa o arquivo de cookie em $HOME/.tensorcash-regtest/regtest/.cookie, que o bitcoin-cli lê automaticamente quando você passa -datadir. A porta RPC é a padrão do regtest upstream, 18443.
Caminho B · o stack local completo (docker compose)
Para quando a simulação não basta: um processo verificador real, um modelo real servindo inferência e a API do minerador integrada. A raiz do repositório tem scripts de inicialização para Mac e para Linux com CUDA.
No Apple Silicon, o inicializador baixa uma build do llama.cpp e sobe o stack compose completo core-node + miner-api + verification-api:
O arquivo compose vincula as portas do host 8333 (P2P), 8050 (a API REST do core-node) e 7067 (ZMQ). O verificador serve a sua API REST do Verificador em uma porta própria do contêiner.
Caminho C · rode a suíte de testes funcionais
Depois que o daemon estiver compilado (Caminho A, passo 1), o executor de testes sobe nós descartáveis para você. Útil quando você quer uma sequência que sabidamente funciona para copiar, e não um daemon para explorar.
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)
Os testes da TensorCash são agrupados por interface: ciclo de vida de modelos, ativos nativos, adaptadores fair-sign e a carteira de repo com covenant. Cada um é um cenário autocontido que pode ser lido do início ao fim; os passo a passo abaixo apontam para os mais representativos.
Passo a passo
Três sequências curtas contra o nó simulado do Caminho A. Cada uma é um esboço; o teste funcional indicado é o cenário completo e executável.
Igual ao Bitcoin Core. Um smoke test antes de qualquer interface específica da TensorCash: confirma que o daemon está no ar e que a carteira tem saldo.
Específico da TensorCash. Um modelo é registrado depositando uma caução em escrow, acumulando verificações Quick e Model bem-sucedidas ao longo de N commits e passando para registered quando a janela de verificação se fecha. Com -validationapi=mock, você conduz cada etapa por RPCs, sem verificador real nem GPU. Este é um resumo; o teste indicado traz o cenário completo.
Específico da TensorCash. registerasset é a RPC de carteira de alto nível que monta as saídas de caução e ICU, anexa o TLV de registro do emissor e transmite a transação. Após uma confirmação, o ativo pode ser consultado por id ou ticker. O ciclo de vida completo (mint, transferência, burn) está no teste indicado.