TensorCash Core.

Postav ze zdrojového kódu

Hlavním zdrojem pravdy je strom kódu na services/core-node/bcore/. Qt peněženka se kompiluje ze stejného CMake cíle jako bezobslužný daemon — při konfiguraci stačí předat -DBUILD_GUI=ON. Dvě možnosti: Dockerfile, který sestaví celý stack (nejjednodušší, v sandboxu), nebo nativní závislosti na tvém hostiteli (rychlejší iterace, menší velikost image).

Cesta 1 · Docker (doporučeno)

Repozitář obsahuje vícestupňový Dockerfile, který v jednom kroku zkompiluje Rust binárku cosign-bridge, Python wheel ChiaVDF a celý daemon bcore + Qt peněženku. Na hostiteli potřebuješ jen Docker. Kontejner obsahuje také Tor pro hidden-service síť a VNC server, pokud chceš spustit GUI uvnitř kontejneru.

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 \
  .

Po sestavení spusť kontejner s vystaveným RPC portem peněženky a (volitelně) s VNC pro přístup ke 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

Cesta 2 · Nativní sestavení

Tudy se vydej, když chceš nativní binárky přímo na hostiteli a bez kontejneru. Otestováno na macOS 13+ (arm64 / x86_64) a Ubuntu / Debian; Fedora a Arch jsou popsané v doc/build-unix.md v submodulu bcore.

Klonovat

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

Instalace závislostí — macOS

Nejprve Xcode Command Line Tools, pak balíčky 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

Instalace závislostí — Linux (Ubuntu / Debian)

Stejný princip, jiný správce balíčků. Fedora a Arch najdeš v doc/build-unix.md přímo v repozitáři.

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

Instalace závislostí — Windows (cross-kompilace)

Nativní sestavení pro Windows jde přes MSVC (viz doc/build-windows-msvc.md). Většina přispěvatelů ale volí rychlejší cestu — cross-kompilaci z linuxového hostitele (nebo z WSL) pomocí toolchainu Mingw-w64 a přibaleného systému depends. NSIS je potřeba jen pro cíl instalátoru .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)

Konfigurace + kompilace

Na macOS / Linux je konfigurace jediným voláním CMake. Na Windows předej toolchain soubor vygenerovaný stromem depends.

# 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

Běžné přepínače konfigurace: -DBUILD_GUI=ON (Qt peněženka), -DENABLE_WALLET=OFF (uzel jen pro řetězec), -DWITH_ZMQ=ON (ZMQ pub/sub témata). Pro úplný seznam spusť cmake -B build -LH.

Sestavení cosign bridge

Cosign funkce v peněžence (podepisování spárovaným zařízením, federovaný multisig) komunikují s vedlejší Rust binárkou cosign-bridge přes lokální socket. Docker cesta ji sestaví automaticky; při nativním sestavení ji sestavíš pomocí 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.

Spustit

Binárka Qt peněženky skončí v build/bin/. První synchronizace s mainnetem trvá hodiny a vyrobí chainstate o velikosti několika GB; pro rychlý smoke test ji raději nasměruj na regtest datadir.

# 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

Kompletní nastavení lokálního vývoje včetně mock validace a TensorCash-specifických RPC najdeš v regtest průvodci.

Doprovodné služby

TensorCash Core je peněženka plus sada vedlejších služeb, se kterými komunikuje. Docker sestavení výše je všechny zabalí dohromady; při nativním sestavení si je připravíš vedle Qt binárky podle toho, které funkce chceš.

Binárky od benefaktorů

Kompilace ze zdrojového kódu je kanonická cesta. Pro pohodlí publikují komunitní benefaktoři vlastní sestavení ze stejného zdrojového stromu. Projekt binárky neprodukuje, nepodepisuje ani nešíří — jde o nezávislé publikace třetích stran, uvedené zde jen pro přehled. Každé sestavení od benefaktora ověř oproti vlastnímu sestavení ze zdrojů nebo porovnej mezi benefaktory.

Chceš být uveden jako benefaktor? Zkompiluj z označeného vydání zdrojů, zveřejni SHA-256 manifest svých artefaktů a oddělený PGP podpis a otevři pull request s přidáním řádku do této tabulky.

Ověření sestavení od benefaktora

Dvě kontroly. První váže tvrzení benefaktora k binárce, kterou sis stáhl; druhá váže binárku ke zdrojovému kódu.

Hash + podpis

Každý benefaktor publikuje soubor SHA256SUMS a oddělený podpis SHA256SUMS.asc. Potvrď, že stažený soubor odpovídá manifestu, a že je manifest podepsán benefaktorovým zveřejněným PGP klíčem.

# 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

Křížová reference

Podpis jednoho benefaktora jen prokazuje, že za binárku ručí — ne že odpovídá zdrojovému kódu. Dvě cesty, jak tuto mezeru uzavřít: zkompilovat ze zdrojů sám a porovnat hashe, nebo porovnat s manifestem druhého benefaktora pro stejný tag vydání. Pokud dva nebo více nezávislých sestavovatelů zveřejní identické SHA-256 pro stejný artefakt, máš důkaz, že sestavení je reprodukovatelné z veřejných zdrojů.

Co dál

• regtest průvodce — sandbox pro lokální vývoj s mock validací, průchody registrací modelů a emisí aktiv.
• Reference JSON-RPC — vestavěná konzola v peněžence hovoří každou metodou z této reference.
• Zapoj se — všechny ostatní způsoby účasti: instituce, poskytovatelé, vývojáři, ověřovatelé, výzkumníci.