Tre percorsi di sviluppo locale, dal più semplice al più impegnativo. Ognuno ti mette a disposizione un JSON-RPC TensorCash da chiamare con bitcoin-cli o con qualsiasi client JSON-RPC. La suite di test funzionali di bcore è la specifica canonica ed eseguibile di tutto ciò che segue, e ogni procedura guidata rimanda al test da cui è stata ricavata.
Solo Core · docker compose · test funzionali
Modalità di validazione
TensorCash aggiunge un passaggio di validazione esterna all'accettazione dei blocchi. -validationapi seleziona il backend che lo esegue, ed è la scelta più importante per un'esecuzione locale: stabilisce se ti serve una GPU, un verificatore in esecuzione o nessuno dei due.
Flag
Che cos'è
Quando usarla
-validationapi=real
La modalità predefinita. Comunica con un verificatore esterno sul canale ZMQ PUSH/PULL tra nodo e verificatore, usando FlatBuffers. È l'impostazione di produzione.
Richiede un verificatore reale in esecuzione. Si usa su mainnet, su testnet e in ogni esecuzione regtest che prevede il replay reale del modello.
-validationapi=mock
Nel processo stesso e deterministica. Il backend simulato espone tre RPC (validationmockdefault, validationmockclear, validationmockrequests) per risposte Quick, Full e Model preimpostate; con i flag di avvio -mockval-default-*, ogni esito della verifica è programmabile.
La modalità predefinita della suite di test funzionali. La scelta giusta per provare la logica della blockchain senza un verificatore né un'inferenza reale.
-validationapi=desktop
Ibrida. I controlli Quick girano nel processo stesso; Full e Model vengono inviati a un verificatore HTTPS locale (il binario desktop predefinito). Non serve un broker ZMQ.
Demo su una sola macchina, quando vuoi un vero passaggio Quick e Smell senza gestire un servizio di verifica separato.
Per un primo approccio alla logica della blockchain, mock è la scelta giusta. Salvo indicazione contraria, il resto della pagina presuppone questa modalità.
Percorso A · solo Core, con validazione simulata
La strada più semplice. Un solo daemon C++: niente docker, niente GPU, nessun file di modello su disco. Basta per tutte le procedure guidate di questa pagina.
1. Compila il daemon
Segui le istruzioni di compilazione di Bitcoin Core applicandole a services/core-node/bcore/. Il codice TensorCash si compila con lo stesso target CMake dell'upstream; non c'è un flag separato.
2. Avvia un nodo regtest
Questi flag riproducono quelli che test_framework/test_tensorcash.py passa a ogni test funzionale, quindi tutto ciò che gira lì gira anche qui. Le risposte simulate predefinite sono fissate su green, così l'accettazione dei blocchi è deterministica.
L'autenticazione usa il file cookie in $HOME/.tensorcash-regtest/regtest/.cookie, che bitcoin-cli legge automaticamente quando passi -datadir. La porta RPC è quella predefinita della regtest upstream, 18443.
Percorso B · lo stack locale completo (docker compose)
Per quando la simulazione non basta: un verificatore reale in esecuzione, un vero modello che esegue l'inferenza e l'API del miner collegata. Nella root del repository trovi gli script di avvio per Mac e per Linux con CUDA.
Su Apple silicon lo script di avvio scarica una build di llama.cpp e avvia lo stack compose completo core-node + miner-api + verification-api:
Il file compose espone sull'host le porte 8333 (P2P), 8050 (l'API REST core-node) e 7067 (ZMQ). Il verificatore espone la sua API REST del verificatore su una porta del proprio container.
Percorso C · esegui la suite di test funzionali
Una volta compilato il daemon (Percorso A, passo 1), è il test runner ad avviare per te nodi usa e getta. Utile quando vuoi una sequenza collaudata da cui copiare, più che un daemon da esplorare a mano.
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)
I test TensorCash sono raggruppati per area: ciclo di vita dei modelli, asset nativi, adaptor fair-sign e wallet per i pronti contro termine basati su covenant. Ognuno è uno scenario autonomo che puoi leggere dall'inizio alla fine; le procedure guidate qui sotto rimandano ai più rappresentativi.
Procedure guidate
Tre brevi sequenze sul nodo simulato del Percorso A. Ognuna è solo una traccia; il test funzionale collegato è lo scenario completo ed eseguibile.
Identico a Bitcoin Core. Un test di base prima di toccare qualsiasi funzione specifica di TensorCash: conferma che il daemon è attivo e che il wallet ha fondi.
Specifico di TensorCash. Un modello si registra vincolando un deposito, raccogliendo verifiche Quick e Model andate a buon fine su N commit e passando poi allo stato registered alla chiusura della finestra di verifica. Con -validationapi=mock puoi pilotare ogni passaggio tramite RPC, senza un verificatore reale né una GPU. Questa è una traccia; lo scenario completo è nel test collegato.
Specifico di TensorCash. registerasset è la RPC di alto livello del wallet che costruisce gli output del bond e dell'ICU, allega il TLV di registrazione dell'emittente e trasmette la transazione. Dopo una conferma, l'asset si può interrogare per id o per ticker. Il ciclo di vita completo (creazione, trasferimento e distruzione di unità) è nel test collegato.
Faucet testnetLa controparte online: carica un wallet sulla testnet condivisa quando ti serve una blockchain attiva invece di un ambiente di prova locale.