/wallet

TensorCash Core.

En Qt-basert skrivebordslommebok for TensorCash-kjeden — bygget videre på Bitcoin Core, med støtte for native aktiva og en innebygd JSON-RPC-konsoll. Bygg den selv fra det offentlige kildetreet (med Docker eller nativt), eller last ned en ferdigkompilert binærfil fra en bidragsyter nedenfor.

Omvisning

Samme form som Bitcoin Core, med TensorCash-spesifikke faner for native aktiva og utstedelse. Klikk på et felt for å se bildet i full oppløsning.

Oversikt · saldo, nylige transaksjoner, nettverksstatus

1 / 12

Bygg fra kildekode

Den kanoniske artefakten er kildetreet på services/core-node/bcore/. Qt-lommeboken bygges fra samme CMake-mål som den hodefrie noden — bare legg til -DBUILD_GUI=ON ved konfigurering. To veier å gå: en Dockerfile som bygger hele stacken (enklest, sandkasse), eller native avhengigheter på vertsmaskinen din (raskere iterasjon, mindre image).

Vei 1 · Docker (anbefalt)

Repositoryet inneholder en flersteg-Dockerfile som bygger cosign-bridge Rust-binærfilen, ChiaVDF Python-wheel og den komplette bcore-noden + Qt-lommeboken i én operasjon. Du trenger bare Docker installert på vertsmaskinen. Containeren inkluderer også Tor for skjult-tjeneste-nettverk og en VNC-server, slik at du kan kjøre GUI-et inne i containeren om du vil.

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

Etter bygging: kjør containeren og eksponer lommebokens RPC-port, og eventuelt VNC for GUI-tilgang:

# 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

Vei 2 · Nativ bygging

Bruk dette om du vil ha native binærfiler på vertsmaskinen uten en container. Testet på macOS 13+ (arm64 / x86_64) og Ubuntu / Debian; Fedora og Arch er dokumentert inne i bcore-submodulens doc/build-unix.md.

Klon

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

Installer avhengigheter — macOS

Xcode Command Line Tools først, deretter Homebrew-pakker.

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

Installer avhengigheter — Linux (Ubuntu / Debian)

Samme idé, annen pakkebehandler. Fedora og Arch ligger i upstream doc/build-unix.md inne i repositoryet.

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

Installer avhengigheter — Windows (krysskompilering)

Native Windows-bygging går via MSVC (se doc/build-windows-msvc.md). Den raskere veien de fleste bidragsytere bruker, er krysskompilering fra en Linux-vert (eller WSL) med Mingw-w64-verktøykjeden pluss det medfølgende depends-systemet. NSIS trengs bare for .exe-installer-målet.

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

Konfigurer + kompiler

På macOS / Linux er konfigurasjonen én enkelt CMake-kommando. På Windows peker du på verktøykjedefilen som depends-treet har generert.

# 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

Vanlige konfigurasjonsvalg: -DBUILD_GUI=ON (Qt-lommebok), -DENABLE_WALLET=OFF (kun kjedenode), -DWITH_ZMQ=ON (ZMQ pub/sub-emner). Kjør cmake -B build -LH for den fullstendige listen.

Bygg cosign-broen

Cosign-funksjoner i lommeboken (paring av enheter, federert multisig) kommuniserer med en sidecar Rust-binærfil kalt cosign-bridge over en lokal socket. Docker-veien bygger den automatisk; for native bygging produserer du den med 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.

Kjør

Qt-lommebokens binærfil havner i build/bin/. Første gangs synkronisering mot mainnet tar timer og skriver en kjedetilstand på flere GB; for en rask røyktest peker du den mot en regtest-datadir i stedet.

# 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

Se regtest-guiden for det fullstendige lokale utviklingsoppsettet, inkludert mock-validering og TensorCash-spesifikke RPC-er.

Medfølgende tjenester

TensorCash Core er lommeboken pluss et lite sett sidecar-tjenester den kommuniserer med. Docker-bygget ovenfor samler alle disse; hvis du bygger nativt, er dette det du setter sammen ved siden av Qt-binærfilen, avhengig av hvilke funksjoner du vil ha.

Tjeneste	Kildesti	Hva den gjør	Nødvendig for
cosign-bridge	services/core-node/cosign-bridge/	Lokal Rust-sidecar som håndterer cosign / federert-signeringsparing (SPAKE2 + Noise over WebSocket). Håndterer paret-enhet-flyt fra Qt-lommeboken.	Cosign-funksjoner (flereenhets-signering, federert multisig)
ChiaVDF	shared-utils/chiavdf/	Verifiable Delay Function brukt av kjedevalidering. Bygges som en Python-wheel under node-byggingen.	Validering av alle blokker (mainnet, testnet eller regtest)
core-node REST	services/core-node/src/	Liten REST-flate ved siden av JSON-RPC-serveren. Eksponerer modellmetadata og nodemetrikker.	Leverandørintegrasjoner — selve lommeboken klarer seg uten
verification-api	services/verification-api/	OSS-verifikasjonstjeneste. Lommeboken kaller den ikke direkte — bcore gjør det, når -validationapi=real.	Ekte (ikke-mock) blokkvalidering i produksjon
miner-api	services/miner-api/	Brobygger mellom kjeden og inferensmotoren (llama.cpp / vLLM). Produserer inferensbeviset som blir del av en blokk.	Mining (levere inferens og produsere blokker)

Binærfiler fra bidragsytere

Bygging fra kildekode er den kanoniske veien. For enkelhets skyld publiserer fellesskapets bidragsytere sine egne bygg av det samme kildetreet. Prosjektet produserer, signerer eller distribuerer ikke binærfiler — dette er uavhengige tredjeparts-publiseringer, listet her kun til orientering. Verifiser ethvert bidragsyter-bygg mot ditt eget kildekodebygg, eller kryssreferer mellom bidragsytere.

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.

For å bli oppført som bidragsyter: bygg fra en tagget kildeutgivelse, publiser et SHA-256-manifest over artefaktene dine og en løsrevet PGP-signatur, og åpne en pull request med en ny rad i denne tabellen.

Verifisere et bidragsyter-bygg

To kontroller. Den første knytter bidragsyterens påstand til binærfilen du lastet ned; den andre knytter binærfilen til kildekoden.

Hash + signatur

Alle bidragsytere publiserer en SHA256SUMS-fil og en løsrevet SHA256SUMS.asc-signatur. Bekreft at filen du lastet ned stemmer overens med manifestet, og at manifestet er signert av bidragsyterens publiserte PGP-nøkkel.

# 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

Kryssreferanse

En enkelt bidragsyters signatur beviser bare at vedkommende går god for binærfilen — ikke at binærfilen faktisk samsvarer med kildekoden. Det finnes to måter å lukke det gapet på: bygg fra kilde selv og sammenlign hasher, eller hold opp mot en annen bidragsyters manifest for den samme utgivelseskoden. Når to eller flere uavhengige byggere publiserer identiske SHA-256-verdier for den samme artefakten, har du belegg for at bygget er reproduserbart fra offentlig kilde.

Hva nå

regtest-guide — lokal utviklingssandkasse med mock-validering, gjennomganger for modellregistrering og aktivumutstedelse.
JSON-RPC-referanse — den innebygde konsollen i lommeboken støtter alle metodene i denne referansen.
Bli med — alle andre måter å delta på: institusjoner, leverandører, utviklere, verifikatorer, forskere.