/wallet

TensorCash Core.

Qt desktop novčanik za TensorCash lanac — potomak Bitcoin Core-a, s podrškom za nativnu imovinu i ugrađenom JSON-RPC konzolom. Izgradi ga sam iz javnog stabla izvornog koda (s Dockerom ili nativno), ili preuzmi gotovu binarnu datoteku od benefaktora iz zajednice.

Obilazak

Isti oblik kao Bitcoin Core, uz TensorCash-specifične kartice za nativnu imovinu i izdavanje. Klikni pločicu za prikaz u punoj rezoluciji.

Pregled · saldo, nedavne transakcije, status mreže

1 / 12

Izgradnja iz izvornog koda

Kanonski artefakt je stablo izvornog koda na services/core-node/bcore/. Qt novčanik gradi se iz istog CMake targeta kao i headless daemon — proslijedi -DBUILD_GUI=ON pri konfiguraciji. Dvije opcije: Dockerfile koji gradi cijeli stack (najlakše, izolovano), ili nativne zavisnosti na tvom hostu (brža iteracija, manji image footprint).

Put 1 · Docker (preporučeno)

Repozitorij dolazi s višestepenim Dockerfileom koji u jednom koraku gradi cosign-bridge Rust binarnu datoteku, ChiaVDF Python wheel i kompletan bcore daemon s Qt novčanikom. Na hostu ti je potreban samo Docker. Kontejner uključuje i Tor za umrežavanje putem skrivenih servisa, te VNC server za pokretanje GUI-ja unutar kontejnera ako to želiš.

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

Nakon izgradnje, pokreni kontejner s izloženim RPC portom novčanika i (opcionalno) VNC-om za GUI pristup:

# 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

Put 2 · Nativna izgradnja

Koristi ovo ako želiš nativne binarne datoteke na hostu bez kontejnera. Testirano na macOS 13+ (arm64 / x86_64) i Ubuntu / Debianu; Fedora i Arch su dokumentovani unutar doc/build-unix.md u bcore submodulu.

Clone

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

Instaliranje zavisnosti — macOS

Prvo Xcode Command Line Tools, zatim Homebrew paketi.

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

Instaliranje zavisnosti — Linux (Ubuntu / Debian)

Ista ideja, drugi menadžer paketa. Fedora i Arch nalaze se u upstream doc/build-unix.md unutar repozitorija.

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

Instaliranje zavisnosti — Windows (cross-compile)

Nativne Windows izgradnje prolaze kroz MSVC (vidi doc/build-windows-msvc.md). Brži put koji koristi većina saradnika je cross-kompajliranje s Linux hosta (ili WSL-a) pomoću Mingw-w64 lanca alata i ugrađenog sistema zavisnosti. NSIS je potreban samo za .exe installer target.

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

Konfiguracija + kompajliranje

Na macOS / Linuxu, korak konfiguracije je jedna CMake naredba. Na Windowsu proslijedi toolchain datoteku generisanu iz stabla zavisnosti.

# 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

Uobičajeni konfiguracijski flagovi: -DBUILD_GUI=ON (Qt novčanik), -DENABLE_WALLET=OFF (samo čvor lanca), -DWITH_ZMQ=ON (ZMQ pub/sub teme). Pokreni cmake -B build -LH za kompletan spisak.

Izgradnja cosign bridgea

Cosign funkcije u novčaniku (potpisivanje na uparenim uređajima, federirani multisig) komuniciraju s pratećom Rust binarnom datotekom zvanom cosign-bridge putem lokalnog socketa. Docker put je gradi automatski; za nativne izgradnje, koristiš 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.

Pokretanje

Qt binarna datoteka novčanika završava u build/bin/. Prva sinhronizacija s mainnetom traje satima i upisuje chainstate veličine nekoliko GB; za brzi smoke test, usmjeri ga 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

Pogledaj regtest vodič za kompletno lokalno razvojno okruženje, uključujući mock validaciju i TensorCash-specifične RPC-ove.

Prateći servisi

TensorCash Core je novčanik zajedno s malim skupom pratećih servisa s kojima komunicira. Docker izgradnja gore ih sve uključuje; ako gradiš nativno, ovo je ono što bi sklopio uz Qt binarnu datoteku, zavisno od funkcija koje želiš.

Servis	Izvorni put	Uloga	Potrebno za
cosign-bridge	services/core-node/cosign-bridge/	Lokalni Rust sidecar koji upravlja cosign / federated-signing uparivanjem (SPAKE2 + Noise putem WebSocketa). Vodi tokove uparenih uređaja iz Qt novčanika.	Cosign funkcije (potpisivanje na više uređaja, federirani multisig)
ChiaVDF	shared-utils/chiavdf/	Verifiable Delay Function koji koristi validacija lanca. Gradi se kao Python wheel tokom izgradnje daemona.	Validiranje bilo kojeg bloka (mainnet, testnet ili regtest)
core-node REST	services/core-node/src/	Mali REST API uz JSON-RPC server. Izlaže metapodatke modela i metrike čvora.	Integracije provajdera; sam novčanik ga ne treba
verification-api	services/verification-api/	OSS servis verifikacije. Novčanik ga ne poziva direktno — to radi bcore, kad je -validationapi=real.	Stvarna (non-mock) validacija blokova u produkciji
miner-api	services/miner-api/	Most između lanca i motora za inferenciju (llama.cpp / vLLM). Proizvođač inferencijskog dokaza koji postaje dio bloka.	Rudarenje (posluživanje inferencije + produkcija blokova)

Binarne datoteke benefaktora

Izgradnja iz izvornog koda je kanonski put. Radi praktičnosti, benefaktori iz zajednice objavljuju vlastite izgradnje istog stabla izvornog koda. Projekat ne producira, ne potpisuje ni ne distribuira binarne datoteke — ovo su nezavisne publikacije trećih strana, navedene ovdje samo informativno. Provjeri svaku benefaktorovu izgradnju prema vlastitoj izgradnji iz izvornog koda, ili je uporedi s drugim benefaktorima.

Benefaktor	Platforme	PGP ključ	Napomene
TensorCash	macOS (arm64, x86_64) · Linux (x86_64) · Windows (x86_64)	pending	Gradi iz javnog stabla izvornog koda. Svako izdanje dolazi sa SHA-256 manifestom i odvojenim PGP potpisom uz binarne datoteke.

Za listing kao benefaktor: izgradi iz tagiranog izdanja izvornog koda, objavi SHA-256 manifest svojih artefakata i odvojeni PGP potpis, te otvori pull request koji dodaje red u ovu tabelu.

Provjera benefaktorove izgradnje

Dvije provjere. Prva vezuje benefaktorovu tvrdnju uz binarnu datoteku koju si preuzeo; druga vezuje binarnu datoteku uz izvorni kod.

Hash + potpis

Svaki benefaktor objavljuje SHA256SUMS datoteku i odvojeni SHA256SUMS.asc potpis. Potvrdi da se datoteka koju si preuzeo podudara s manifestom, i da je manifest potpisan benefaktorovim objavljenim PGP ključ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

Unakrsna provjera

Potpis jednog benefaktora samo dokazuje da on garantuje za binarnu datoteku — ne i da se binarna datoteka podudara s izvornim kodom. Dva načina da se taj jaz premosti: izgradi sam iz izvornog koda i uporedi hasheve, ili ih uporedi s manifestom drugog benefaktora za isti release tag. Kada dva ili više nezavisnih graditelja objave iste SHA-256 za isti artefakt, imaš dokaz da je izgradnja reproducibilna iz javnog izvornog koda.

Šta dalje

regtest vodič — sandbox za lokalni razvoj s mock validacijom, vodičima za registraciju modela i izdavanje imovine.
JSON-RPC referenca — ugrađena konzola u novčaniku podržava svaku metodu iz ove reference.
Uključi se — svaki drugi način učestvovanja: institucije, provajderi, programeri, verifikatori, istraživači.