TensorCash Core.

Compila des del codi font

L'artefacte canònic és l'arbre de codi font a services/core-node/bcore/. La cartera Qt es compila des del mateix objectiu CMake que el dimoni headless — afegeix -DBUILD_GUI=ON en configurar-lo. Dues opcions: un Dockerfile que compila tota la pila d'una sola passada (el més senzill, en sandbox), o dependències natives al teu host (iteració més ràpida i imatges més lleugeres).

Camí 1 · Docker (recomanat)

El repositori inclou un Dockerfile multietapa que compila el binari Rust de cosign-bridge, el wheel Python de ChiaVDF i el dimoni bcore complet amb la cartera Qt en una sola passada. Només cal tenir Docker instal·lat. El contenidor també porta Tor per a serveis ocults i un servidor VNC, per si vols executar la GUI des de dins.

Dockerfile: services/core-node/tor.Dockerfile

git clone --recurse-submodules https://github.com/tensorcash/tensorcash.git
cd tensorcash

docker build \
  -f services/core-node/tor.Dockerfile \
  -t tensorcash-core:dev \
  .

Un cop compilat, executa el contenidor exposant el port RPC de la cartera i (opcionalment) VNC per a accés a la GUI:

# Headless daemon, RPC reachable on host:18332.
docker run --rm -p 18332:18332 \
  -v $HOME/.tensorcash-data:/data \
  tensorcash-core:dev

# With the Qt GUI exposed via VNC on host:5900 (default password in the
# container's vnc.sh — change before any non-localhost binding).
docker run --rm -p 5900:5900 -p 18332:18332 \
  -v $HOME/.tensorcash-data:/data \
  tensorcash-core:dev

Camí 2 · Compilació nativa

Aquesta via és per a binaris natius al teu host, sense contenidor. Provada a macOS 13+ (arm64 / x86_64) i Ubuntu / Debian; per a Fedora i Arch consulta el doc/build-unix.md del submòdul bcore.

Clona

git clone --recurse-submodules https://github.com/tensorcash/tensorcash.git
cd tensorcash/services/core-node/bcore

Instal·la dependències — macOS

Primer les Xcode Command Line Tools, després els paquets Homebrew.

xcode-select --install   # if not already installed

brew install \
  cmake boost pkgconf libevent \
  qt@6 qrencode \
  zeromq \
  capnp                  # optional, only if you want -DENABLE_IPC=ON

Instal·la dependències — Linux (Ubuntu / Debian)

Mateixa idea, gestor de paquets diferent. Per a Fedora i Arch, mira el doc/build-unix.md de l'upstream del repositori.

sudo apt-get install -y \
  build-essential cmake pkgconf python3 \
  libevent-dev libboost-dev libsqlite3-dev libzmq3-dev \
  qt6-base-dev qt6-tools-dev qt6-l10n-tools qt6-tools-dev-tools libgl-dev \
  libqrencode-dev

Instal·la dependències — Windows (compilació creuada)

Les compilacions natives de Windows passen per MSVC (vegeu doc/build-windows-msvc.md). La via més ràpida — i la que fa servir la majoria de contribuïdors — és la compilació creuada des d'un host Linux (o WSL) amb la cadena d'eines Mingw-w64 i el sistema de dependències inclòs. NSIS només cal per a l'objectiu d'instal·lador .exe.

# On a Linux host (or WSL inside Windows):
sudo apt-get install -y g++-mingw-w64-x86-64-posix nsis

# Build the depends tree once.
gmake -C depends HOST=x86_64-w64-mingw32 -j$(nproc)

Configura + compila

A macOS / Linux, el pas de configuració és una sola invocació de CMake. A Windows, passa el fitxer de cadena d'eines generat per l'arbre de dependències.

# macOS / Linux
cmake -B build -DBUILD_GUI=ON
cmake --build build -j$(getconf _NPROCESSORS_ONLN 2>/dev/null || nproc)

# Windows (cross-compile from Linux/WSL)
cmake -B build --toolchain depends/x86_64-w64-mingw32/toolchain.cmake -DBUILD_GUI=ON
cmake --build build -j$(nproc)
cmake --build build --target deploy   # produces the .exe installer via NSIS

Flags de configuració habituals: -DBUILD_GUI=ON (cartera Qt), -DENABLE_WALLET=OFF (node només cadena), -DWITH_ZMQ=ON (temes ZMQ pub/sub). Executa cmake -B build -LH per a la llista completa.

Compila el cosign bridge

Les funcions de Cosign a la cartera (signatura amb dispositius emparellats, multisig federat) es comuniquen amb un binari Rust auxiliar, cosign-bridge, a través d'un socket local. El camí Docker el compila automàticament; en una compilació nativa, el generes amb cargo:

# Rust 1.85+ required.
cd services/core-node/cosign-bridge
cargo build --release --bin cosign-bridge --bin cosign-local-relay
# Binaries land in target/release/. Run cosign-bridge alongside the wallet.

Executa

El binari de la cartera Qt es genera a build/bin/. La primera sincronització contra mainnet triga hores i escriu diversos GB de chainstate; per a una prova ràpida, fes-lo apuntar a un datadir de regtest.

# Smoke test on a private chain — no real coins, no peers, no IBD.
build/bin/bitcoin-qt -regtest -datadir=$HOME/.tensorcash-regtest

# Production: starts initial block download against the live network.
build/bin/bitcoin-qt

Consulta la guia de regtest per a la configuració completa de desenvolupament local, incloent-hi la validació simulada i els RPC específics de TensorCash.

Serveis complementaris

TensorCash Core és la cartera més un petit conjunt de serveis auxiliars amb què es comunica. La compilació Docker anterior els inclou tots; si compiles natiu, aquí tens què posar al costat del binari Qt segons les funcions que vulguis.

Binaris de benefactors

Compilar des del codi font és el camí canònic. Per comoditat, alguns benefactors de la comunitat publiquen les seves pròpies compilacions del mateix codi font. El projecte no produeix, signa ni distribueix binaris — són publicacions independents de tercers, llistades aquí només per facilitar-ne la descoberta. Verifica qualsevol compilació de benefactor contra la teva, feta des del codi font, o creua-la amb la d'un altre benefactor.

Per aparèixer com a benefactor: compila a partir d'una release etiquetada del codi font, publica un manifest SHA-256 dels teus artefactes i una signatura PGP separada, i obre una pull request afegint una fila en aquesta taula.

Verificar una compilació de benefactor

Dues comprovacions. La primera lliga el que afirma el benefactor al binari que has baixat; la segona lliga el binari al codi font.

Hash + signatura

Cada benefactor publica un fitxer SHA256SUMS i una signatura SHA256SUMS.asc separada. Confirma que el fitxer que has descarregat coincideix amb el manifest, i que el manifest està signat per la clau PGP publicada del benefactor.

# 1. Manifest matches the binary you have on disk.
shasum -a 256 -c SHA256SUMS --ignore-missing

# 2. Manifest is signed by the benefactor's key.
gpg --verify SHA256SUMS.asc SHA256SUMS

Referència creuada

La signatura d'un sol benefactor només demostra que ell avala el binari — no que el binari coincideixi amb el codi font. Dues maneres de tancar aquesta bretxa: compilar tu mateix des del codi font i comparar els hashes, o comparar-los amb el manifest d'un segon benefactor per a la mateixa etiqueta de llançament. Quan dos o més compiladors independents publiquen SHA-256 idèntics per al mateix artefacte, tens evidència que la compilació és reproduïble des del codi font públic.

Què ve ara

• guia de regtest — sandbox de desenvolupament local amb validació simulada, més recorreguts de registre de models i emissió d'actius.
• Referència JSON-RPC — la consola integrada a la cartera admet tots els mètodes d'aquesta referència.
• Participa — totes les altres maneres de participar: institucions, proveïdors, desenvolupadors, verificadors, investigadors.