TensorCash Core.

البناء من المصدر

القطعة المرجعيّة هي شجرة المصدر في services/core-node/bcore/. محفظة Qt تُبنى من هدف CMake نفسه المستخدَم للعفريت بلا واجهة — مرِّر ‎-DBUILD_GUI=ON‎ وقت الضبط. مساران: Dockerfile يبني الحزمة كاملةً (الأسهل، معزول)، أو اعتماديّات مباشرة على جهازك (تكرار أسرع، حجم صورة أصغر).

المسار 1 · Docker (موصى به)

يشحن المستودع Dockerfile متعدّد المراحل يبني الثنائي cosign-bridge بلغة Rust، وعجلة ChiaVDF بلغة Python، وعفريت bcore الكامل مع محفظة Qt دفعةً واحدة. لا تحتاج سوى Docker مثبَّتًا على الجهاز. يتضمّن الحاوي أيضًا Tor لشبكة الخدمة المخفيّة وخادم VNC لتشغيل واجهة المستخدم داخل الحاوي إن شئتَ.

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

بعد البناء، شغِّل الحاوي كاشفًا منفذ RPC للمحفظة و(اختياريًّا) VNC للوصول إلى الواجهة:

# 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 · البناء المباشر

استخدم هذا إن أردتَ ثنائيّات مباشرة على جهازك دون حاوٍ. مختبَر على macOS 13+‏ (arm64 / x86_64) وUbuntu / Debian؛ Fedora وArch موثَّقتان داخل doc/build-unix.md في الوحدة الفرعيّة bcore.

الاستنساخ

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

تثبيت الاعتماديّات — macOS

ابدأ بأدوات سطر أوامر Xcode، ثمّ حزم 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

تثبيت الاعتماديّات — Linux (Ubuntu / Debian)

الفكرة نفسها، مدير حزم مختلف. Fedora وArch في upstream doc/build-unix.md داخل المستودع.

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

تثبيت الاعتماديّات — Windows (تجميع عابر)

بناء Windows الأصليّ يمرّ عبر MSVC (راجع doc/build-windows-msvc.md). المسار الأسرع الذي يسلكه معظم المساهمين هو التجميع العابر من مضيف Linux (أو WSL) باستخدام سلسلة أدوات Mingw-w64 مع نظام depends المحزوم. NSIS مطلوب فقط لهدف مثبّت 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)

الضبط + التجميع

على macOS / Linux خطوة الضبط استدعاء CMake واحد. على Windows مرِّر ملف سلسلة الأدوات المُولَّد من شجرة 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

علامات الضبط الشائعة: ‎-DBUILD_GUI=ON‎ (محفظة Qt)، ‎-DENABLE_WALLET=OFF‎ (عقدة سلسلة فقط)، ‎-DWITH_ZMQ=ON‎ (مواضيع ZMQ pub/sub). نفِّذ cmake -B build -LH للقائمة الكاملة.

بناء جسر cosign

ميزات Cosign في المحفظة (توقيع الجهاز المزدوج، multisig متحكَّم فيه) تتواصل مع ثنائي Rust مرافق يُسمّى cosign-bridge عبر مقبس محلّي. مسار Docker يبنيه تلقائيًّا؛ في البناء المباشر تُنتجه بـ 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.

التشغيل

ثنائي محفظة Qt يُوضع في build/bin/. المزامنة الأولى مع mainnet تستغرق ساعات وتكتب حالة سلسلة بحجم غيغابايتات؛ لاختبار سريع، وجِّهه إلى 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-qt

راجع دليل regtest للإعداد الكامل لبيئة التطوير المحلّيّة بما في ذلك التحقّق الوهمي وRPCs الخاصّة بـ TensorCash.

الخدمات المرافقة

TensorCash Core هو المحفظة مع مجموعة صغيرة من الخدمات المرافقة التي تتواصل معها. بناء Docker أعلاه يحزمها جميعًا؛ إن بنيتَ مباشرةً، هذا ما ستجمعه إلى جانب ثنائي Qt حسب الميزات التي تريدها.

ثنائيّات المتبرّعين

البناء من المصدر هو المسار المرجعيّ. للتيسير، يُصدر متبرّعون من المجتمع بنياتهم الخاصّة من شجرة المصدر نفسها. المشروع لا يُنتج ولا يوقِّع ولا يُوزِّع ثنائيّات — هذه منشورات مستقلّة من أطراف ثالثة، مدرجة هنا للاطلاع فقط. تحقّق من أيّ بناء لمتبرّع بمقارنته ببنائك الخاصّ من المصدر، أو بالمقارنة المتبادلة بين المتبرّعين.

للإدراج كمتبرّع: ابنِ من إصدار مُصنَّف بعلامة، وانشر بيان SHA-256 لقطعك الفنيّة وتوقيع PGP منفصلًا، وافتح طلب سحب لإضافة صفّ إلى هذا الجدول.

التحقّق من بناء المتبرّع

فحصان: الأوّل يربط ادّعاء المتبرّع بالثنائي الذي نزّلتَه، والثاني يربط الثنائي بالمصدر.

التجزئة + التوقيع

كلّ متبرّع يُصدر ملف SHA256SUMS وتوقيع SHA256SUMS.asc منفصلًا. تأكّد أنّ الملف الذي نزّلتَه يطابق البيان، وأنّ البيان موقَّع بمفتاح PGP المنشور للمتبرّع.

# 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

المقارنة التبادليّة

توقيع متبرّع واحد يُثبت فقط أنّه يضمن الثنائي — لا أنّ الثنائي يطابق المصدر. طريقتان لسدّ هذه الفجوة: ابنِ من المصدر بنفسك وقارن التجزئات، أو قارن ببيان متبرّع ثانٍ للعلامة نفسها. حين يُصدر بنّاؤون مستقلّون أو أكثر تجزئات SHA-256 متطابقة للقطعة نفسها، لديك دليل على أنّ البناء قابل للإعادة من المصدر العامّ.

ما التالي

• دليل regtest — بيئة تطوير محلّيّة معزولة مع تحقّق وهمي، وإرشادات تسجيل النماذج وإصدار الأصول.
• مرجع JSON-RPC — وحدة التحكّم المدمجة في المحفظة تدعم كلّ دالّة في هذا المرجع.
• شارك معنا — كلّ الطرق الأخرى للمشاركة: مؤسسات، ومزوّدون، ومطوّرون، ومُحقِّقون، وباحثون.