/wallet
TensorCash Core.
Ví desktop Qt cho chuỗi TensorCash — kế thừa từ Bitcoin Core, hỗ trợ tài sản nguyên bản và tích hợp sẵn console JSON-RPC. Tự build từ mã nguồn công khai (qua Docker hoặc natively), hoặc tải bản binary tiện lợi do cộng đồng phát hành bên dưới.
Xem thử
Cùng hình dạng với Bitcoin Core, với các tab riêng của TensorCash cho tài sản nguyên bản và phát hành. Nhấp vào ô để xem ảnh độ phân giải đầy đủ.
Build từ mã nguồn
Sản phẩm chuẩn là cây mã nguồn tại services/core-node/bcore/. Ví Qt build từ cùng một CMake target với daemon headless — truyền -DBUILD_GUI=ON lúc cấu hình. Hai lựa chọn: một Dockerfile build toàn bộ stack (dễ nhất, môi trường sandbox), hoặc cài phụ thuộc natively trên máy bạn (lặp lại nhanh hơn, footprint nhỏ hơn).
Hướng 1 · Docker (khuyến nghị)
Repository đi kèm một Dockerfile đa giai đoạn build binary Rust cosign-bridge, wheel Python ChiaVDF, và toàn bộ bcore daemon + ví Qt trong một lần. Bạn chỉ cần Docker cài trên máy. Container còn tích hợp Tor cho kết nối mạng hidden-service và VNC server để chạy GUI bên trong container nếu muốn.
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 \
.Sau khi build, chạy container để lộ cổng RPC của ví và (tuỳ chọn) VNC để truy cập 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:devHướng 2 · Native build
Dùng cách này nếu bạn muốn binary nguyên bản trên máy mà không cần container. Đã kiểm thử trên macOS 13+ (arm64 / x86_64) và Ubuntu / Debian; Fedora và Arch được ghi chép trong doc/build-unix.md bên trong submodule bcore.
Clone
git clone --recurse-submodules https://github.com/tensorcash/tensorcash.git
cd tensorcash/services/core-node/bcoreCài phụ thuộc — macOS
Xcode Command Line Tools trước, rồi đến các gói 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=ONCài phụ thuộc — Linux (Ubuntu / Debian)
Cùng nguyên lý, khác trình quản lý gói. Fedora và Arch xem trong upstream doc/build-unix.md bên trong repo.
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-devCài phụ thuộc — Windows (cross-compile)
Build native Windows đi qua MSVC (xem doc/build-windows-msvc.md). Cách nhanh hơn mà hầu hết cộng tác viên dùng là cross-compile từ máy Linux (hoặc WSL) bằng toolchain Mingw-w64 cùng hệ thống depends đi kèm. NSIS chỉ cần cho target trình cài .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)Cấu hình + biên dịch
Trên macOS / Linux bước cấu hình là một lệnh CMake duy nhất. Trên Windows truyền thêm toolchain file do cây depends sinh ra.
# 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 NSISCác cờ cấu hình phổ biến: -DBUILD_GUI=ON (ví Qt), -DENABLE_WALLET=OFF (node chỉ chuỗi), -DWITH_ZMQ=ON (topic pub/sub ZMQ). Chạy cmake -B build -LH để xem danh sách đầy đủ.
Build cosign bridge
Các tính năng Cosign trong ví (ký thiết bị ghép đôi, federated multisig) giao tiếp với một binary Rust sidecar tên cosign-bridge qua socket cục bộ. Hướng Docker build tự động; với native build bạn tạo nó bằng 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.Chạy
Binary ví Qt nằm trong build/bin/. Lần đồng bộ đầu tiên với mainnet mất vài giờ và ghi vài GB chainstate; để kiểm tra nhanh, hãy trỏ nó vào một datadir 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-qtDịch vụ đi kèm
TensorCash Core là ví cộng với một tập nhỏ các dịch vụ sidecar mà nó giao tiếp. Build Docker ở trên gộp tất cả; nếu build natively, đây là những gì bạn cần lắp ráp bên cạnh binary Qt tùy theo tính năng mong muốn.
| Dịch vụ | Đường dẫn nguồn | Vai trò | Cần cho |
|---|---|---|---|
| cosign-bridge | services/core-node/cosign-bridge/ | Sidecar Rust cục bộ xử lý ghép đôi cosign / federated-signing (SPAKE2 + Noise qua WebSocket). Tiếp nhận trực tiếp các luồng ghép đôi thiết bị từ ví Qt. | Tính năng Cosign (ký đa thiết bị, federated multisig) |
| ChiaVDF | shared-utils/chiavdf/ | Hàm Delay có thể kiểm chứng (VDF) dùng trong xác thực chuỗi. Được build thành wheel Python trong quá trình build daemon. | Xác thực bất kỳ khối nào (mainnet, testnet hoặc regtest) |
| core-node REST | services/core-node/src/ | Giao diện REST nhỏ gọn bên cạnh server JSON-RPC. Cung cấp metadata mô hình và metric node. | Tích hợp nhà cung cấp; bản thân ví không cần |
| verification-api | services/verification-api/ | Dịch vụ kiểm chứng OSS. Ví không gọi trực tiếp — bcore gọi khi -validationapi=real. | Xác thực khối thực (không giả lập) trong môi trường production |
| miner-api | services/miner-api/ | Cầu nối giữa chuỗi và engine suy luận (llama.cpp / vLLM). Tạo bằng chứng suy luận để đưa vào khối. | Khai thác (phục vụ suy luận + sản xuất khối) |
Binary từ cộng đồng
Build từ mã nguồn là hướng chuẩn. Để thuận tiện, các thành viên cộng đồng tự phát hành bản build của cùng cây mã nguồn đó. Dự án không tạo, ký hay phân phối binary — đây là các ấn phẩm độc lập từ bên thứ ba, liệt kê ở đây chỉ để tham khảo. Hãy kiểm chứng bất kỳ bản build cộng đồng nào so với bản tự build từ nguồn, hoặc đối chiếu giữa các nhà phát hành.
| Nhà phát hành | Nền tảng | Khóa PGP | Ghi chú |
|---|---|---|---|
| TensorCash | macOS (arm64, x86_64) · Linux (x86_64) · Windows (x86_64) | pending | Build từ cây mã nguồn công khai. Mỗi bản phát hành đi kèm bảng SHA-256 và chữ ký PGP tách rời cùng với binary. |
Để được liệt kê là nhà phát hành cộng đồng: build từ bản phát hành nguồn có tag, công bố bảng SHA-256 các sản phẩm và chữ ký PGP tách rời, rồi mở pull request thêm một hàng vào bảng này.
Kiểm chứng bản build cộng đồng
Hai bước kiểm tra. Bước đầu gắn tuyên bố của nhà phát hành với binary bạn đã tải; bước hai gắn binary với mã nguồn.
Hash + chữ ký
Mỗi nhà phát hành cộng đồng đều công bố file SHA256SUMS và chữ ký tách rời SHA256SUMS.asc. Xác nhận rằng file bạn tải khớp với bảng, và bảng được ký bằng khóa PGP đã công bố của họ.
# 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Đối chiếu chéo
Chữ ký của một nhà phát hành chỉ chứng minh họ bảo đảm cho binary — không chứng minh binary khớp với mã nguồn. Hai cách rút ngắn khoảng cách đó: tự build từ mã nguồn rồi so sánh hash, hoặc đối chiếu với bảng của một nhà phát hành thứ hai cho cùng tag phát hành. Khi hai hay nhiều người build độc lập công bố SHA-256 giống hệt nhau cho cùng sản phẩm, bạn có bằng chứng rằng build có thể tái lập từ mã nguồn công khai.
Tiếp theo
- hướng dẫn regtest — sandbox phát triển cục bộ với xác thực giả lập, hướng dẫn đăng ký mô hình và phát hành tài sản.
- Tài liệu JSON-RPC — console tích hợp trong ví hỗ trợ mọi phương thức trong tài liệu này.
- Tham gia cùng chúng tôi — mọi cách tham gia khác: tổ chức, nhà cung cấp, lập trình viên, người kiểm chứng, nhà nghiên cứu.