Três caminhos de desenvolvimento local, ordenados por atrito. Cada um põe à tua frente um JSON-RPC da TensorCash para chamares com bitcoin-cli ou com qualquer cliente JSON-RPC. A suite de testes funcionais do bcore é a especificação canónica e executável de tudo o que se segue, e cada percurso indica o teste de onde foi extraído.
Só o Core · docker compose · testes funcionais
Modos de validação
A TensorCash acrescenta um passo de validação externa à aceitação de blocos. -validationapi seleciona o backend que o serve, e é a escolha mais importante numa execução local: decide se precisas de uma GPU, de um processo verificador ou de nenhum dos dois.
Flag
O que é
Quando usar
-validationapi=real
A predefinição. Comunica com um verificador externo através do canal ZMQ PUSH/PULL entre o nó e o verificador, usando FlatBuffers. A configuração de produção.
Requer um processo verificador real. Usado na mainnet, na testnet e em qualquer execução regtest que exercite a repetição real de modelos.
-validationapi=mock
No próprio processo e determinístico. O backend simulado expõe três RPC (validationmockdefault, validationmockclear, validationmockrequests) para respostas Quick, Full e Model pré-definidas; com as flags de arranque -mockval-default-*, todos os resultados de verificação são programáveis.
A predefinição da suite de testes funcionais. A escolha certa para exercitar a lógica da chain sem verificador nem inferência real.
-validationapi=desktop
Híbrido. As verificações Quick correm no próprio processo; Full e Model são enviadas para um verificador HTTPS local (o binário de secretária predefinido). Não é preciso broker ZMQ.
Demonstrações numa só máquina que querem uma passagem Quick e Smell real sem operar um serviço verificador separado.
Para uma primeira abordagem à lógica da chain, mock é a resposta certa. O resto desta página assume-o, salvo indicação em contrário.
Caminho A · só o Core, com validação simulada
O caminho com menos atrito. Um único daemon em C++: sem docker, sem GPU, sem ficheiros de modelo em disco. Chega para todos os percursos desta página.
1. Compilar o daemon
Segue as instruções de compilação do Bitcoin Core em services/core-node/bcore/. O código da TensorCash compila com o mesmo alvo CMake do upstream; não há nenhuma flag separada.
2. Arrancar um nó regtest
Estas flags reproduzem o que test_framework/test_tensorcash.py passa a cada teste funcional, por isso tudo o que corre lá também corre aqui. As respostas simuladas por omissão estão fixadas em verde, por isso a aceitação de blocos é determinística.
A autenticação usa o ficheiro cookie em $HOME/.tensorcash-regtest/regtest/.cookie, que o bitcoin-cli lê automaticamente quando passas -datadir. A porta RPC é a predefinida do regtest upstream, 18443.
Caminho B · a stack local completa (docker compose)
Para quando a simulação não chega: um processo verificador real, um modelo real a servir inferência e a API do mineiro ligada. A raiz do repositório tem scripts de arranque para Mac e para Linux com CUDA.
Em Apple silicon, o script de arranque descarrega uma build do llama.cpp e levanta a stack compose completa core-node + miner-api + verification-api:
O ficheiro compose associa as portas do anfitrião 8333 (P2P), 8050 (a API REST do core-node) e 7067 (ZMQ). O verificador serve a sua API REST do Verificador na porta do seu próprio contentor.
Caminho C · correr a suite de testes funcionais
Depois de compilado o daemon (Caminho A, passo 1), o executor de testes arranca nós descartáveis por ti. Útil quando queres uma sequência comprovada 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 agrupam-se por interface: ciclo de vida dos modelos, ativos nativos, adaptadores fair-sign e a carteira de repo com covenant. Cada um é um cenário autónomo que podes ler do início ao fim; os percursos abaixo apontam para os mais representativos.
Percursos guiados
Três sequências curtas sobre 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 teste rápido antes de qualquer interface específica da TensorCash: confirma que o daemon está ativo e que a carteira tem fundos.
Específico da TensorCash. Um modelo é registado depositando uma caução em garantia, recolhendo verificações Quick e Model bem-sucedidas ao longo de N commits e passando depois a registered quando a janela de verificação fecha. Com -validationapi=mock podes conduzir cada passo por RPC, sem verificador real nem GPU. Isto é um resumo; o teste indicado contém o cenário completo.
Específico da TensorCash. registerasset é o RPC de alto nível da carteira que constrói as saídas da caução e do ICU, anexa o TLV de registo do emitente e difunde a transação. Após uma confirmação, o ativo pode ser consultado por id ou por ticker. O ciclo de vida completo (emissão, transferência, queima) está no teste indicado.