TensorCash Core.

Fordítás forrásból

A kanonikus forrás a services/core-node/bcore/ fa. A Qt tárca ugyanabból a CMake-célból épül, mint a headless daemon — a konfigurációnál add meg a -DBUILD_GUI=ON kapcsolót. Két út áll rendelkezésre: egy Dockerfile, ami egy menetben lefordítja az egész stacket (legegyszerűbb, izoláltan fut), vagy natív függőségek a hoston (gyorsabb iteráció, kisebb image).

1. út · Docker (ajánlott)

A repository egy többlépéses Dockerfile-t tartalmaz, ami egyszerre fordítja le a cosign-bridge Rust binárist, a ChiaVDF Python wheelt, és a teljes bcore daemonhoz tartozó Qt tárcát. Csak Docker kell a hoston. A konténer Tort is tartalmaz a hidden-service hálózathoz, és VNC-szervert, ha a GUI-t is a konténerből akarod futtatni.

Dockerfile: services/core-node/tor.Dockerfile

git clone --recurse-submodules https://git.tensorcash.org/tensorcash/tensorcash.git
cd tensorcash

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

Build után indítsd el a konténert, megnyitva a tárca RPC-portját és opcionálisan a VNC-t a GUI-hozzáféréshez:

# 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

2. út · Natív fordítás

Ezt válaszd, ha konténer nélkül szeretnél natív binárisokat a hostodra. Tesztelve macOS 13+ (arm64 / x86_64) és Ubuntu / Debian alatt; Fedorához és Archhoz a bcore szubmodul doc/build-unix.md fájlja ad útmutatót.

Clone

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

Függőségek telepítése — macOS

Először Xcode Command Line Tools, utána Homebrew-csomagok.

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

Függőségek telepítése — Linux (Ubuntu / Debian)

Ugyanaz az elv, más csomagkezelővel. Fedorához és Archhoz az upstream doc/build-unix.md ad útmutatást a repóban.

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

Függőségek telepítése — Windows (keresztfordítás)

A natív Windows-fordítás MSVC-n keresztül zajlik (lásd doc/build-windows-msvc.md). A legtöbb közreműködő gyorsabb úton jár: Linux-hostról (vagy WSL-ből) keresztfordít a Mingw-w64 toolchainnel és a mellékelt depends-rendszerrel. Az NSIS csak az .exe telepítőcélhoz kell.

# 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)

Konfigurálás + fordítás

macOS-en / Linuxon a konfigurálás egyetlen CMake-hívás. Windowson add meg a depends-fa által generált toolchain-fájlt.

# 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

Gyakori konfigurációs kapcsolók: -DBUILD_GUI=ON (Qt tárca), -DENABLE_WALLET=OFF (csak lánc-node), -DWITH_ZMQ=ON (ZMQ pub/sub topikok). A teljes listáért futtasd: cmake -B build -LH.

Cosign bridge fordítása

A tárca cosign-funkciói (párosított eszközök aláírása, federált multisig) egy cosign-bridge nevű Rust kísérőbinárissal kommunikálnak helyi socketen keresztül. A Docker-út automatikusan lefordítja; natív fordításnál te állítod elő cargo segítségével:

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

Futtatás

A Qt tárca binárisa a build/bin/ mappában landol. Az első mainnet-szinkronizálás órákat is elvihet, és többgigabájtos chainstatet ír; gyors próbához inkább egy regtest datadir-t adj meg.

# 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

A teljes helyi fejlesztői környezethez — mock-validációval és TensorCash-specifikus RPC-kkel — nézd meg a regtest-útmutatót.

Kísérőszolgáltatások

A TensorCash Core: a tárca plusz néhány kísérőszolgáltatás, amellyel kommunikál. A fenti Docker-build mindegyiket tartalmazza; natív fordításnál ezeket kell a Qt bináris mellé összerakni, aszerint, milyen funkciókat szeretnél használni.

Benefactor binárisok

A kanonikus út: fordítsd magad a forrásból. Kényelmi okból közösségi benefactorok is közzéteszik a saját buildjüket ugyanarról a forrásról. A projekt nem állít elő, nem ír alá és nem terjeszt binárisokat — ezek független, harmadik féltől származó kiadások, és itt csupán tájékoztató jelleggel szerepelnek. Vesd össze a benefactor-binárist a saját fordításoddal, vagy hasonlítsd össze több benefactor kiadásait egymással.

Convenience binaries are published by community benefactors and listed in the network directory. Those listings are unverified and not endorsed by the project — always verify a build's PGP signature against the public source (below) before you run it.

Ha benefactorként szeretnél szerepelni: fordíts le egy megjelölt forráskiadást, tedd közzé az artefaktaid SHA-256 manifestjét és egy leválasztott PGP-aláírást, majd nyiss egy pull requestet egy új sorral a táblázathoz.

Benefactor-bináris ellenőrzése

Két ellenőrzés. Az első a benefactor állítását köti a letöltött binárishoz; a második a binárist a forráshoz.

Hash + aláírás

Minden benefactor közzétesz egy SHA256SUMS fájlt és egy leválasztott SHA256SUMS.asc aláírást. Ellenőrizd, hogy a letöltött fájl egyezik-e a manifesttel, és hogy a manifestet a benefactor közzétett PGP-kulcsával írták alá.

# 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

Kereszthivatkozás

Egyetlen benefactor aláírása csak azt bizonyítja, hogy ő szavatolja a binárist — azt nem, hogy a bináris egyezik a forrással. Ezt a rést kétféleképp zárhatod: fordíts magad forrásból és vesd össze a hasheket, vagy vesd össze egy másik benefactor manifestjével ugyanannál a release tagnél. Ha két vagy több független fordító azonos SHA-256-ot tesz közzé ugyanarra az artefaktra, bizonyítékod van rá, hogy a build reprodukálható a nyilvános forrásból.

Mi jön ezután

• regtest-útmutató — helyi fejlesztői sandbox mock-validációval, modellregisztrációs és eszközkibocsátási végigvezetőkkel.
• JSON-RPC referencia — a tárca beépített konzolján minden metódus elérhető ebből a referenciából.
• Csatlakozz — minden más részvételi lehetőség: intézmények, szolgáltatók, fejlesztők, verifierek, kutatók.