إنتقل إلى المحتوى الرئيسي

تشغيل عقدة

يغطي هذا الدليل تشغيل نشر QoreChain بعقدة فقط — عقدة كاملة أو عقدة RPC تُزامن السلسلة وتوفّر نقاط نهاية للتكامل، دون مهام المدقّق (validator). وهو موجّه إلى منصات التداول (CEX) والأنظمة الخلفية للمحافظ والمفهرِسات وجهات التكامل التي تحتاج إلى وصول موثوق للقراءة/الكتابة إلى الشبكة لكنها لا توقّع الكتل.

ملاحظة

لإنتاج الكتل، والتحصيص (staking)، والعقوبات (slashing)، وتصنيف المجمّعات، راجع تشغيل مدقّق بدلاً من ذلك. النشر بعقدة فقط لا يحمل أبداً مفتاح إجماع للمدقّق ولا يظهر أبداً في المجموعة النشطة.

تحذير

تُنشر الملفات الثنائية وملف التكوين الأولي (genesis) واللقطات على download.qore.host مع مجاميع تحقق SHA-256. تحقّق دائماً من مجاميع التحقق قبل التثبيت أو الاستخراج، وتحقّق من الإيداعات فقط عبر عقدتك المُزامنة الخاصة.

مصدر الحقيقة: البيان (manifest) الحي

يُنشر الملف الثنائي الحالي وملف genesis والنظراء (peers) والبذور (seeds) ونقطة الثقة لمزامنة الحالة كبيان بصيغة JSON، يُحدَّث بشكل حي — لا تُدرِج إصدار ملف ثنائي أو مجموع تحقق أو اسم ملف لقطة بشكل ثابت في نصوص التثبيت لديك، لأنها تصبح قديمة بمجرد صدور إصدار جديد:

  • الشبكة الرئيسية: https://download.qore.host/mainnet/latest.json
  • شبكة الاختبار: https://download.qore.host/testnet/latest.json

تشمل حقول البيان binary (رابط + sha256)، وgenesis (رابط + sha256 + sizeBytes)، وpeers، وseeds، وp2pPort، وstateSync (نقطة ثقة تُحدَّث كل ساعة)، وminCompatible. تجلب خطوات التثبيت والانضمام أدناه هذا البيان وتستخدم قيمه الحالية.

استخدم الإصدار الذي يسمّيه البيان: v3.2.7 على الشبكة الرئيسية، وv3.2.8 على شبكة الاختبار

العقدة التي تُزامن من ملف genesis أو تُعيد التشغيل من لقطة تجتاز عدة ترقيات حوكمة (راجع الترقيات أدناه)، لذا ثبّت دائماً الملف الثنائي الذي يشير إليه البيان: فهو يحمل كل معالجات الترقية. على الشبكة الرئيسية تساوي قيمتا minCompatible وversion في البيان كلتاهما 3.2.7 (طُبِّقت عند الارتفاع 4,164,600 في 12 نوفمبر 2026، مقترح الحوكمة 16)، لذا تحتاج العقدة التي تنضم الآن إلى v3.2.7: فالملف الثنائي الأقدم يتوقف عند ارتفاع ترقية لا يعرفه. والإصدار هو الحزمة qorechaind-v3.2.7-b3-linux-amd64.tar.gz (99,472,930 بايت، SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5، قُرئت من البيان في 12 نوفمبر 2026؛ والبيان الحي هو المرجع). ويوصي البيان بأن تنضم العقد الجديدة عبر مزامنة الحالة (state sync). وهي تحتوي على qorechaind وlib/ مع libqorepqc.so وlibqoresvm.so وlibwasmvm.x86_64.so. والعقدة التي كانت ما زالت على v3.2.6 توقفت عند الارتفاع 4,164,600 مع الرسالة UPGRADE "v3.2.7" NEEDED: ثبّت الحزمة وأعد التشغيل، وتبقى حالتها محفوظة. لا توجد ترقية أخرى مجدولة للشبكة الرئيسية (قيمة current_plan هي null، تم التحقق في 12 نوفمبر 2026)؛ وعندما يسمّي البيان إصدارًا أحدث فهو الملف الثنائي الواجب تثبيته. وعلى شبكة الاختبار تساوي قيمتا minCompatible وversion في البيان كلتاهما 3.2.8 (وطُبِّق v3.2.5 عند الارتفاع 8,890,800 في 26 أكتوبر 2026 وv3.2.6 عند الارتفاع 8,970,638 في 27 أكتوبر وv3.2.7 عند الارتفاع 9,594,600 في 6 نوفمبر، وv3.2.8 عند الارتفاع 9,929,500 في 12 نوفمبر)، لذا تحتاج العقدة التي تنضم إلى شبكة الاختبار إلى الملف الثنائي v3.2.8: خذ اسم الحزمة وحجمها وSHA-256 من بيان شبكة الاختبار الحي، وهو المرجع (ففي 7 نوفمبر 2026، حين كانت على v3.2.7، سمّى البيان qorechaind-v3.2.7-b3-linux-amd64.tar.gz بحجم 99,472,930 بايت وقيمة SHA-256 هي d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5). والعقدة على شبكة الاختبار التي ما زالت على v3.2.7 تتوقف عند الارتفاع 9,929,500 مع الرسالة UPGRADE "v3.2.8" NEEDED: استبدل qorechaind وانسخ المجلد lib/ كاملًا من الحزمة ثم أعد تشغيلها؛ تبقى حالتها محفوظة ولا تحتاج إلى إعادة مزامنة. وتبقى الشبكة الرئيسية على v3.2.7، أي إصدارًا واحدًا خلف شبكة الاختبار؛ ولم تطبّق v3.2.8، فلا يتغير شيء في ملاحظات v3.2.8 لعقد الشبكة الرئيسية. لا تشغّل ملفاً ثنائياً لشبكة الاختبار مقابل الشبكة الرئيسية ولا العكس: فلكل دليل إصداره الخاص (راجع الترقيات). يُرقّى البيان عمداً على مراحل (شبكة الاختبار أولاً، ثم الشبكة الرئيسية بعد فترة استقرار)، لذا قارن حقل "version" فيه بـ minCompatible قبل الوثوق بـ binary.url.

الملف الثنائي المبني من المصدر العام (بناء المجتمع) يرفض البدء على أي من الشبكتين العامتين (v3.2.3 وما بعده): فهو لا يستطيع التحقق من التوقيعات ما بعد الكمّية ولا يستطيع إعادة تشغيل كتل الشبكتين بأمانة. استخدم أرشيف الإصدار فقط.

هناك إعدادان مهمان اعتباراً من v3.2.1: أبقِ ساعة النظام متزامنة عبر NTP (تتوقف العقدة عندما تنحرف ساعتها بأكثر من 60 ثانية)، وعيّن evm-chain-id في app.toml (راجع حدود العقدة).


العقدة مقابل المدقّق​

الجانبعقدة فقط (هذا الدليل)المدقّق
مفتاح الإجماعلا يوجدمفتاح إجماع ed25519 (يجب تأمينه)
إنتاج الكتللانعم — يقترح الكتل ويوقّعها
التحصيص / العقوباتغير قابل للتطبيقتفويض ذاتي، مخاطر العقوبات
الغرض الأساسيتقديم RPC/REST/gRPC/EVM (وSVM للقراءة فقط) لعمليات التكاملتأمين الشبكة (تُطبَّق مكافآت التحصيص)
التعرّض العامنقاط نهاية RPC/EVM مكشوفة عادةًالمدقّق مخفي خلف عقد الحراسة (sentry)

الشبكات المستهدفة​

الشبكةمعرّف السلسلةمعرّف سلسلة EVMملاحظات
الشبكة الرئيسيةqorechain-vladi9801 (بالنظام الست عشري 0x2649)الأساسية — تعمل منذ 7 يونيو 2026؛ إصدار العقدة v3.2.7 (منذ 12 نوفمبر 2026)
شبكة الاختبارqorechain-diana9800جرّب عمليات التكامل هنا أولاً؛ إصدار العقدة v3.2.8 (منذ 12 نوفمبر 2026)

استبدل قيمة --chain-id المناسبة لشبكتك المستهدفة في كل أجزاء هذا الدليل. الأمثلة تستخدم الشبكة الرئيسية افتراضياً.


الملف التعريفيالمعالجالذاكرةالقرص (NVMe SSD)الشبكة
عقدة RPC مع تقليم4 أنوية16 GB500 GB+100 Mbps+
عقدة كاملة/أرشيفية8 أنوية32 GB2 TB+ (تنمو مع الوقت)1 Gbps
تكامل منصات التداول8 أنوية32 GB2 TB+ مع مساحة احتياطية1 Gbps

يوصى بشدة باستخدام NVMe SSD: فحالة السلسلة ومخازن EVM/SVM كثيفة الاستخدام لعمليات الإدخال/الإخراج. أرقام القرص أعلاه سخية. القياس على الشبكة الرئيسية (27 أكتوبر 2026): مدقّق انضم عبر مزامنة الحالة مع pruning = "custom" (keep-recent 100000) وindexer = "null" يشغل نحو 10 GB بعد شهرين، وعقدة بالتقليم الافتراضي تعمل منذ genesis تشغل نحو 100 إلى 130 GB بعد أربعة أشهر. وحجم موارد المدقّق في تشغيل مدقق: العتاد. العقد الأرشيفية (بدون تقليم، مع فهرسة كاملة للمعاملات) تنمو باستمرار؛ خصّص قرصاً بمساحة احتياطية مع مراقبة مستمرة.


النشر​

Docker Compose​

نشر بعقدة فقط باستخدام Docker Compose. لا توجد صورة qorechaind منشورة علناً للسحب (لا شيء منشور تحت مؤسسة المشروع على Docker Hub). يبني ملف Dockerfile في المستودع العام الملف الثنائي المجتمعي (community) (بلا مكتبة ما بعد الكم، ومع keepers بديلة): وهو مناسب للتطوير المحلي لكنه لا يستطيع متابعة الشبكة الرئيسية ولا شبكة الاختبار، ومنذ v3.2.3 يرفض البدء عليهما. لعقدة شبكة، ابنِ صورتك الخاصة من أرشيف الإصدار المذكور في latest.json، وضع لها وسماً بإصدار النسخة (v3.2.6 على الشبكة الرئيسية وعلى شبكة الاختبار، وقت كتابة هذا النص)، ثم اربط وحدة تخزين دائمة لبيانات السلسلة:

# Fetch and verify the release archive (see "Joining the Network" below for the manifest steps)
curl -s https://download.qore.host/mainnet/latest.json -o latest.json
curl -fsSL "$(jq -r .binary.url latest.json)" -o qore.tgz
echo "$(jq -r .binary.sha256 latest.json) qore.tgz" | sha256sum -c -
mkdir release && tar xzf qore.tgz -C release

cat > release/Dockerfile <<'EOF'
FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y ca-certificates curl jq && rm -rf /var/lib/apt/lists/*
COPY qorechaind /usr/local/bin/qorechaind
COPY lib/ /opt/qorechain/lib/
ENV LD_LIBRARY_PATH=/opt/qorechain/lib
ENTRYPOINT ["qorechaind"]
EOF
docker build -t qorechain-node:v3.2.7 release/

يحتوي الأرشيف على qorechaind ودليل lib/ يضم مكتباته المشتركة (libqorepqc.so وlibqoresvm.so وlibwasmvm.x86_64.so ومنذ v3.2.8 أيضاً libwasmvmqore_v1.x86_64.so). انسخ مجلد lib/ بأكمله لا ملفات منفردة؛ والصورة أعلاه لمنصة linux/amd64 فقط، مثل أرشيف الإصدار.

# docker-compose.yml
services:
qorechain-node:
image: qorechain-node:v3.2.7
container_name: qorechain-node
restart: unless-stopped
command: ["start", "--home", "/root/.qorechaind"]
volumes:
- qorechain-data:/root/.qorechaind
ports:
- "26657:26657" # RPC
- "26656:26656" # P2P
- "1317:1317" # REST
- "9090:9090" # gRPC
- "8545:8545" # EVM JSON-RPC
- "8546:8546" # EVM WebSocket
- "8899:8899" # SVM RPC (read-only: SVM transactions are disabled)
- "26660:26660" # Prometheus

volumes:
qorechain-data:

هيّئ دليل البيانات مرة واحدة (على سبيل المثال docker compose run --rm qorechain-node init my-node --chain-id qorechain-vladi --home /root/.qorechaind؛ ويُغطى ملف genesis وتكوين النظراء أدناه)، ثم ابدأ التشغيل:

docker compose up -d
docker compose logs -f qorechain-node

systemd​

للتثبيت على خادم مباشر (bare-metal)، شغّل qorechaind تحت systemd:

# /etc/systemd/system/qorechaind.service
[Unit]
Description=QoreChain node
After=network-online.target
Wants=network-online.target

[Service]
User=qorechain
ExecStart=/usr/local/bin/qorechaind start --home /var/lib/qorechaind
Restart=on-failure
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now qorechaind
sudo journalctl -u qorechaind -f

الانضمام إلى الشبكة​

1. التهيئة​

qorechaind init my-node --chain-id qorechain-vladi

2. جلب البيان (manifest)​

curl -s https://download.qore.host/mainnet/latest.json -o latest.json
# testnet: https://download.qore.host/testnet/latest.json

استخدم هذا الملف كمصدر لقيم الملف الثنائي وملف genesis والنظراء في الخطوات أدناه — تحقّق من jq -r .minCompatible latest.json وشغّل ذلك الإصدار على الأقل (والإصدار الموصى به هو jq -r .version latest.json).

3. تنزيل ملف genesis والتحقق منه​

GENESIS_URL=$(jq -r .genesis.url latest.json)
GENESIS_SHA256=$(jq -r .genesis.sha256 latest.json)

curl -fsSL "$GENESIS_URL" -o ~/.qorechaind/config/genesis.json
echo "${GENESIS_SHA256} $HOME/.qorechaind/config/genesis.json" | sha256sum -c -

# Cross-verify against the genesis served live by the chain:
curl -s https://rpc.qore.host/genesis | jq '.result.genesis' > /tmp/genesis-live.json

4. تكوين النظراء والحد الأدنى للرسوم​

اقرأ النظراء (peers) والبذور (seeds) الحالية من البيان بدلاً من تثبيت معرّفات العقد والمضيفين بشكل ثابت — فهذه القيم تتغيّر دورياً:

PEERS=$(jq -r '.peers | join(",")' latest.json)
SEEDS=$(jq -r '.seeds | join(",")' latest.json)

افتح ~/.qorechaind/config/config.toml وعيّن persistent_peers (وseeds) على تلك القيم:

persistent_peers = "<value of $PEERS>"
seeds = "<value of $SEEDS>"

ثم عيّن الحد الأدنى لسعر الغاز في ~/.qorechaind/config/app.toml (الحد الأدنى لرسوم الشبكة: 0.1uqor):

minimum-gas-prices = "0.1uqor"

يكتب الأمر qorechaind init <moniker> --chain-id qorechain-vladi أيضاً معرّف سلسلة EVM الخاص بالشبكة في app.toml (راجع حدود العقدة)؛ تحقّق منه في مجلد home جرت تهيئته منذ زمن بعيد.

5. بدء المزامنة​

qorechaind start --minimum-gas-prices=0.1uqor

الإقلاع السريع​

قد تستغرق المزامنة من ملف genesis وقتاً طويلاً. استخدم مزامنة الحالة (state sync) بوصفها الطريقة الافتراضية للانضمام؛ أما اللقطة (snapshot) فهي احتياطية فقط (لقطة الشبكة الرئيسية تعود إلى 21 أغسطس 2026، ولا تنشر شبكة الاختبار أي لقطة).

مزامنة الحالة​

تجلب مزامنة الحالة لقطة حديثة لحالة التطبيق من خوادم RPC موثوقة بدلاً من إعادة تشغيل كل كتلة. كوّن القسم [statesync] في config.toml:

[statesync]
enable = true
rpc_servers = "https://rpc.qore.host:443,https://<a second RPC you run or trust>:26657"
trust_height = <TRUSTED_BLOCK_HEIGHT>
trust_hash = "<TRUSTED_BLOCK_HASH>"
trust_period = "168h0m0s"

خذ trust_height / trust_hash من حقل stateSync في البيان. يُحدَّث كل ساعة، لذا فهو المصدر المفضّل:

TRUST_HEIGHT=$(jq -r .stateSync.trustHeight latest.json)
TRUST_HASH=$(jq -r .stateSync.trustHash latest.json)
خادما RPC مختلفان

تتحقق مزامنة الحالة من نقطة الثقة مقابل خادمَي RPC. يدرج الحقل stateSync.rpcServers في البيان العنوان https://rpc.qore.host مرتين على الشبكة الرئيسية (وhttps://rpc-testnet.qore.host مرتين على شبكة الاختبار): الإدخالان المتطابقان يستوفيان العدد لكنهما يُبطلان التحقق المتقاطع. أضف خادم RPC ثانياً تشغّله أو تثق به باستقلالية، وقارن تجزئة الثقة بمصدر ثانٍ، مثلاً curl -s "https://<second-rpc>/block?height=$TRUST_HEIGHT" | jq -r .result.block_id.hash، التي يجب أن تساوي $TRUST_HASH.

كبديل احتياطي، يمكنك اشتقاق ارتفاع وتجزئة (hash) موثوقين بنفسك من RPC العام:

curl -s https://rpc.qore.host/block | jq -r '.result.block.header.height, .result.block_id.hash'

الاستعادة من لقطة​

بدلاً من ذلك، نزّل لقطة بيانات السلسلة المنشورة، وتحقّق من مجموع التحقق الخاص بها، ثم استخرجها فوق دليل البيانات لديك. على الشبكة الرئيسية يعطي الكائن snapshot في البيان الرابط وارتفاع الكتلة height والحجم ومجموع التحقق SHA-256. رابط لقطة بيان شبكة الاختبار يعيد حالياً 404 (لا توجد لقطة منشورة لشبكة الاختبار)، لذا استخدم مزامنة الحالة هناك. اقرأ snapshot.height قبل استخدام لقطة الشبكة الرئيسية: فهي أرشيف واحد بحجم نحو 27 GB، واللقطة القديمة تعني لحاقاً طويلاً بالشبكة. اللقطة المنشورة حالياً للشبكة الرئيسية من 21 أغسطس 2026 (الارتفاع 1,966,629): وهي أقدم من ارتفاعات الترقيات v3.1.94 وv3.2.0 وv3.2.2 وv3.2.3 وv3.2.4، لذا تعيد العقدة المستعادة منها تشغيل نحو شهرين من الكتل بالملف الثنائي للإصدار الذي يسمّيه البيان. ومزامنة الحالة هي الخيار الأفضل في أغلب الأحيان.

SNAP_URL=$(jq -r .snapshot.url latest.json)
SNAP_SHA256=$(jq -r .snapshot.sha256 latest.json)
curl -fsSL "$SNAP_URL" -o snapshot.tar.gz
echo "${SNAP_SHA256} snapshot.tar.gz" | sha256sum -c -

tar xzf snapshot.tar.gz -C ~/.qorechaind/
qorechaind start --minimum-gas-prices=0.1uqor
ملاحظة

يوضح الحقلان snapshot.height وsnapshot.ts في البيان مدى حداثة الأرشيف، وغالباً ما تكون مزامنة الحالة (أعلاه) أسرع من تنزيل بحجم 27 GB. تحقّق دائماً من مجموع التحقق قبل الاستخراج، واستخدم إصدار عقدة يحمل كل معالجات الترقية (راجع التنبيه في أعلى هذه الصفحة) عند إعادة التشغيل من لقطة.


الترقيات​

تصل تغييرات الإجماع على هيئة ترقيات حوكمة منسّقة: يسمّي المقترح الذي يُقَرّ خطةً (مثل v3.2.3) وارتفاع كتلة. يحمل الملف الثنائي الرسمي للإصدار معالجات الترقية؛ وعند ارتفاع الخطة يجب أن تشغّله كل عقدة، وتتوقف العقدة التي ما زالت على الملف الثنائي السابق عند ذلك الارتفاع (وهذا هو السلوك المقصود لوحدة الترقية). ويبيّن البيان نوع كل إصدار: القيمة upgradeType هي height للترقية المنسّقة (مع ضبط upgradeHeight) وrolling للإصدار المحلي للعقدة الذي يمكن استبداله عقدةً عقدة. ثبّت الملف الثنائي الجديد قبل الارتفاع؛ وإذا توقفت عقدتك أولاً، فبدّل الملف الثنائي وأعد التشغيل (راجع ملاحظة التراجع ضمن استكشاف الأخطاء وإصلاحها).

الإصدارالشبكة الرئيسية qorechain-vladiشبكة الاختبار qorechain-diana
v3.1.94الارتفاع 2,122,074لم يُطبَّق
v3.2.0الارتفاع 2,981,742الارتفاع 5,920,000
v3.2.1محلي للعقدة، بلا ارتفاعمحلي للعقدة
v3.2.2الارتفاع 3,556,788 (16 أكتوبر 2026)الارتفاع 6,905,034 (2 أكتوبر 2026)
v3.2.3الارتفاع 3,662,051 (20 أكتوبر 2026، مقترح الحوكمة 11)الارتفاع 8,003,746 (15 أكتوبر 2026)
v3.2.4الارتفاع 3,742,566 (23 أكتوبر 2026، مقترح الحوكمة 13)الارتفاع 8,337,253 (19 أكتوبر 2026، مقترح الحوكمة 13)
v3.2.5الارتفاع 3,906,833 (29 أكتوبر 2026، مقترح الحوكمة 14)الارتفاع 8,890,800 (26 أكتوبر 2026)
v3.2.6الارتفاع 4,020,000 (4 نوفمبر 2026، مقترح الحوكمة 15)الارتفاع 8,970,638 (27 أكتوبر 2026)
v3.2.7الارتفاع 4,164,600 (12 نوفمبر 2026، مقترح الحوكمة 16)الارتفاع 9,594,600 (6 نوفمبر 2026، مقترح الحوكمة 33)
v3.2.8لم يُطبَّقالارتفاع 9,929,500 (12 نوفمبر 2026)

ما فعله مشغّل العقدة من أجل v3.2.4 (ارتفاع الشبكة الرئيسية 3,742,566). سمّى مقترح الحوكمة 13 الخطة v3.2.4 عند الارتفاع 3,742,566 (طُبّقت في 23 أكتوبر 2026): بقيت العقد على v3.2.3 حتى ذلك الارتفاع، وتوقفت عنده، وأُعيد تشغيلها على v3.2.4. وفي الترقية المنسّقة التالية تكون الخطوات نفسها:

  1. راقب بيان الشبكة الرئيسية (https://download.qore.host/mainnet/latest.json): وإلى أن يسمّي الإصدار الجديد فلا شيء يُثبَّت، والملف الثنائي من دليل شبكة الاختبار ليس إصدار الشبكة الرئيسية.
  2. عندما يسمّي البيان الإصدار، نزّل الأرشيف من binary.url فيه، وتحقّق من sha256 (ويُنشر نص المقترح أيضًا قيمة sha256 للملف الثنائي)، وجهّزه قبل الارتفاع. افحص GET /cosmos/upgrade/v1beta1/current_plan لمعرفة الخطة المعلّقة (name وheight)، وافحص الارتفاع الحالي عبر GET /status على RPC.
  3. عند ارتفاع الخطة تتوقف العقدة التي ما زالت على الملف الثنائي القديم (وهذا هو السلوك المقصود لوحدة الترقية، وليس عطلًا)؛ أما العقدة التي تشغّل الملف الثنائي الجديد فتطبّق معالج الترقية وتواصل العمل. وإذا توقفت عقدتك أولًا، فبدّل الملف الثنائي وأعد التشغيل. وبعد الترقية يعيد GET /cosmos/upgrade/v1beta1/applied_plan/v3.2.4 الارتفاع بدلًا من 0 (3742566 على الشبكة الرئيسية، و8337253 على شبكة الاختبار).
  4. العقدة التي تنضم إلى الشبكة الرئيسية الآن تثبّت الإصدار الذي يسمّيه البيان (v3.2.7 وقت كتابة هذا النص؛ قارن version بـ minCompatible).

لا يغيّر v3.2.4 شيئًا في توقيع المعاملات ولا العناوين ولا الخانات العشرية ولا الـ memo ولا الرسوم.

v3.2.5 على الشبكة الرئيسية (الارتفاع 3,906,833، 29 أكتوبر 2026، مقترح الحوكمة 14). طُبّقت الخطوات نفسها: سمّى البيان 3.2.5 قيمةً لكلٍّ من version وminCompatible، وتوقفت عند ارتفاع الخطة العقدة التي كانت ما زالت على v3.2.4 مع الرسالة UPGRADE "v3.2.5" NEEDED. والحل هو تثبيت حزمة v3.2.5 (وهي تشحن qorechaind ومكتبات lib/ المشتركة معًا؛ أبقِها جنبًا إلى جنب) وإعادة التشغيل؛ وتبقى حالة العقدة محفوظة.

v3.2.6 على الشبكة الرئيسية (الارتفاع 4,020,000، 4 نوفمبر 2026، مقترح الحوكمة 15). طُبّقت الخطوات نفسها: يسمّي البيان 3.2.6 قيمةً لكلٍّ من version وminCompatible، وتتوقف عند ارتفاع الخطة العقدة التي ما زالت على v3.2.5 مع الرسالة UPGRADE "v3.2.6" NEEDED؛ ثبّت حزمة v3.2.6 وأعد التشغيل. يبقى توقيع المعاملات (sign-bytes v2) والعناوين والخانات العشرية والـ memo والرسوم دون تغيير، ويطلب البيان من المشغّلين إبقاء الساعة متزامنة عبر NTP. يعيد GET /cosmos/upgrade/v1beta1/applied_plan/v3.2.6 القيمة {"height":"4020000"} على الشبكة الرئيسية. لا توجد ترقية أخرى مجدولة للشبكة الرئيسية.

v3.2.7 على الشبكة الرئيسية (الارتفاع 4,164,600، 12 نوفمبر 2026، مقترح الحوكمة 16). طُبّقت الخطوات نفسها: يسمّي البيان 3.2.7 قيمةً لكلٍّ من version وminCompatible، وتتوقف عند ارتفاع الخطة العقدة التي ما زالت على v3.2.6 مع الرسالة UPGRADE "v3.2.7" NEEDED؛ ثبّت حزمة v3.2.7 وأعد التشغيل. يعيد GET /cosmos/upgrade/v1beta1/applied_plan/v3.2.7 القيمة {"height":"4164600"} على الشبكة الرئيسية. فعّلت الترقية أحد عشر مفتاح بروتوكول (multisig هجين ما بعد كمّي، وغاز ثابت قدره 2,000 لكل تحقق ما بعد كمّي، وحدث نافذة EVM، ورسائل مفاتيح التحقق في RDK، وعدة إصلاحات لعناوين SVM والاستدعاء عبر الآلات الافتراضية)، فصار المجموع 101. يبقى مسار SVM والاستدعاء عبر الآلات الافتراضية ورفع عقود CosmWasm وإنشاء نسخ منها متوقفة على الشبكة الرئيسية.

اقرأ السجل الحي عبر GET /cosmos/upgrade/v1beta1/applied_plan/<name> (القيمة 0 = لم يُطبَّق) وأي خطة معلّقة عبر GET /cosmos/upgrade/v1beta1/current_plan. رفع الإصدار v3.2.2 اعتماديات محرك الإجماع وCosmos SDK (v0.53.8) وIBC، وتجعل فحوص المعاملات الأكثر صرامة في SDK هذا الإصدار يستبدل الملف الثنائي السابق عند ارتفاع الترقية بدلاً من استبداله عقدةً عقدة. لم يتغير توقيع المعاملات ولا العناوين ولا الخانات العشرية ولا الـ memo ولا الرسوم في v3.2.2 أو v3.2.3.

مزامنة الحالة والساعة. تأخذ مزامنة الحالة نقطة ثقتها من كتلة stateSync في البيان (trustHeight وtrustHash، وتُحدَّث كل ساعة)؛ وخادم RPC الذي تذكره هو خادم المشروع نفسه، لذا أضف لعقدة الإنتاج خوادم RPC تثق بها وتحقّق من تجزئة الثقة مقابل مصدر آخر. أبقِ الساعة متزامنة عبر NTP: تتوقف العقدة عندما تنحرف بأكثر من 60 ثانية عن الشبكة.


التقليم والفهرسة​

اضبط التقليم وفهرسة المعاملات بما يناسب تكاملك. منصات التداول التي تحتاج إلى سجل معاملات كامل ينبغي أن تعمل بأقل قدر من التقليم مع تفعيل مفهرِس المعاملات.

التقليم (app.toml)​

# Keep recent state only — smallest disk footprint
pruning = "default"

# Keep everything — required for archive / full historical queries
# pruning = "nothing"
pruningالسلوكحالة الاستخدام
defaultيحتفظ بالحالة الحديثة ويقلّم الباقيعقدة RPC، استعلامات الأرصدة/الحالة
nothingيحتفظ بكل الحالة التاريخيةعقدة أرشيفية، سجل كامل
customقيم احتفاظ/فواصل يحددها المشغّلاحتفاظ مضبوط حسب الحاجة

بيئة تشغيل العقود في v3.2.8​

تحتاج العقدة على الإصدار v3.2.8 (على شبكة الاختبار فقط إلى حين ترقية لاحقة للشبكة الرئيسية) إلى: مجلد lib/ بأكمله من الحزمة (يضم libwasmvmqore بجانب libwasmvm وlibqorepqc وlibqoresvm)؛ وقيمة [wasm] memory_cache_size لا تقل عن 256 MiB (تُرفع القيمة الأصغر إلى 256 مع تحذير، فخطّط للذاكرة)؛ ودليل شيفرة العقود في <home>/wasm (ويبقى دليل شيفرة قائم في مكان آخر يعمل مع تحذير). ويضبط ملف app.toml الجديد أيضاً simulation_gas_limit = 50000000 ويخدم مساحات JSON-RPC التالية eth,net,web3.

حدود العقدة (app.toml)​

اعتباراً من إصدار العقدة v3.2.1، يكتب init قسماً باسم [qorechain] يضم ثلاثة حدود محلية للعقدة. وهي لا تغيّر إلا ما تحتفظ به هذه العقدة في الذاكرة وما تضعه في الكتل التي تقترحها، ولا تغيّر أبداً ما يجب أن تحتويه الكتلة لتكون صالحة:

[qorechain]
# Maximum number of Cosmos transactions held in the app-side mempool (default 5000).
# When full, a new transaction that pays more per gas evicts the lowest-paying one; otherwise it is refused.
cosmos-mempool-max-txs = 5000

# Time the node may spend selecting transactions for a proposal before it proposes what it has ("0s" disables the budget).
prepare-proposal-budget = "1s"

# Stop after this many candidates in a row that do not fit in the remaining block space (0 disables the cap).
prepare-proposal-max-skips = 64

يكتب init أيضاً معرّف سلسلة EVM الخاص بالشبكة في الإعداد evm-chain-id ضمن القسم [evm] من app.toml (القيمة 9801 للأمر --chain-id qorechain-vladi، و9800 للشبكة qorechain-diana). العقدة التي يحمل app.toml لديها قيمة مختلفة تبدأ مع ذلك، لكنها تسجّل خطأً عند البدء، ويردّ JSON-RPC الخاص بها (eth_chainId والتوقيع مقابل تلك العقدة) بمعرّف سلسلة خاطئ إلى أن تصحّح الملف؛ أما الإجماع فلا يتأثر. كانت الملفات الثنائية الأقدم تكتب قيمة شبكة الاختبار (9800) بصرف النظر عن --chain-id، لذا ينبغي لعقدة الشبكة الرئيسية التي جرت تهيئتها منذ زمن بعيد أن تتحقق من هذا الإعداد. لا تعيّن QORE_EVM_CHAIN_ID على قيمة غير قيمة الشبكة: فالعقدة التي تفعل ذلك ترفض البدء.

فهرسة المعاملات (config.toml)​

[tx_index]
indexer = "kv"

عيّن indexer = "kv" (أو مفهرِساً أغنى) لتكون المعاملات قابلة للاستعلام حسب التجزئة والحدث — وهو أمر أساسي لمنصات التداول التي تُطابق الإيداعات والسحوبات. عيّن indexer = "null" فقط إذا لم تكن بحاجة إلى استعلامات المعاملات التاريخية.


كشف نقاط النهاية للتكامل​

فعّل خوادم الواجهات البرمجية (API) التي تحتاجها جهات التكامل واربطها في app.toml:

[api]
enable = true
address = "tcp://0.0.0.0:1317"

[grpc]
enable = true
address = "0.0.0.0:9090"

[json-rpc]
enable = true
address = "0.0.0.0:8545"
ws-address = "0.0.0.0:8546"
api = "eth,net,web3,txpool"

حدود JSON-RPC في إصدار العقدة v3.2.4. العقدة التي تشغّل الملف الثنائي v3.2.4 (شبكة الاختبار منذ 19 أكتوبر 2026؛ والشبكة الرئيسية منذ 23 أكتوبر 2026) تضع حدودًا على خادم JSON-RPC الخاص بها. هذه إعدادات محلية للعقدة في القسم [json-rpc] من app.toml ولا تؤثر في الإجماع: http-body-limit (الافتراضي 262144 بايت، أي 256 KiB؛ ويُرفض جسم الطلب الأكبر برمز HTTP 413 قبل قراءته)، وmax-concurrent-requests (الافتراضي 256؛ والطلبات التي تتجاوزه تتلقى HTTP 503 فورًا)، وmax-open-connections (القيمة المفقودة أو الصفرية تعني الآن 1000 لا غير محدود). وإضافة إلى ذلك يُرفض وسيط المرشِّح في eth_getLogs وeth_newFilter إذا ذكر أكثر من 4 مواضع للمواضيع (topics)، أو أكثر من 1000 بديل في موضع واحد، أو أكثر من 1000 عنوان. وعلى المتكامل الذي يرسل إلى عقدته الخاصة طلبات دفعية كبيرة جدًا أو طلبات نشر عقود أن يتأكد من أن أكبر طلب لديه يلائم حد الجسم، وأن يرفعه عند الحاجة.

تخدم نقاط النهاية العامة فضاءات الأسماء eth_ وnet_ وweb3_ وtxpool_ (الحالة فقط)؛ والعقدة المُهيَّأة بالإصدار v3.2.3 أو أحدث تعتمد افتراضياً eth,net,web3 وتترك txpool خارجاً (فهو ينشر المعاملات المعلّقة للعقدة)، لذا أضفه فقط إذا احتجت إليه. أما فضاء الأسماء qor_ فلا يخدمه أي إصدار منشور من العقدة، لذا لا تضفه (راجع فضاء الأسماء qor_).

ومستمع RPC في config.toml:

[rpc]
laddr = "tcp://0.0.0.0:26657"
نقطة النهايةالمنفذتُستخدم من أجل
RPC26657بث المعاملات، والاستعلام عن الكتل/الحالة
REST1317استعلامات HTTP عن حالة السلسلة
gRPC9090وصول برمجي عالي الإنتاجية
EVM JSON-RPC8545عمليات التكامل المتوافقة مع Ethereum (معرّف السلسلة 9801)
EVM WS8546اشتراكات أحداث EVM
SVM RPC8899عمليات قراءة متوافقة مع Solana (معاملات SVM معطّلة)
تحذير

لا تكشف أبداً RPC أو EVM JSON-RPC أو gRPC مباشرةً على الإنترنت العام دون وكيل عكسي (reverse proxy) وتحديد لمعدل الطلبات ومصادقة وجدار حماية. اربط على 0.0.0.0 فقط خلف طبقة دخول (ingress) خاضعة للتحكم.


مراقبة الصحة والمزامنة​

حالة المزامنة​

curl -s localhost:26657/status | jq '.result.sync_info.catching_up'
  • true — لا تزال المزامنة جارية.
  • false — مزامنة كاملة وتقديم الحالة الحالية.
# Latest height and network
curl -s localhost:26657/status | jq '.result.sync_info.latest_block_height, .result.node_info.network'

يجب أن يُظهر الحقل network القيمة qorechain-vladi (الشبكة الرئيسية) أو qorechain-diana (شبكة الاختبار).

Prometheus و Grafana​

يمكن للعقدة كشف مقاييس Prometheus على المنفذ 26660 (عيّن prometheus = true في القسم [instrumentation] من config.toml):

http://localhost:26660/metrics

اجمع هذه المقاييس بأي مجمّع متوافق مع Prometheus. إذا كنت تشغّل حزمة المراقبة الخاصة بـ Docker Compose، فإن Grafana متاحة على http://localhost:3001 — عيّن بيانات اعتمادك الخاصة عند أول تسجيل دخول. راقب تأخر ارتفاع الكتل وعدد النظراء واستخدام الموارد؛ وفعّل التنبيهات عندما يبقى catching_up على true أو ينخفض عدد النظراء إلى الصفر.

فحص نقطة نهاية EVM​

curl -s -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
# Expect "0x2649" (9801) on mainnet

أفضل الممارسات التشغيلية​

  1. ثبّت إصدار السلسلة. شغّل الإصدار الذي يوصي به البيان (v3.2.7 على الشبكة الرئيسية وv3.2.8 على شبكة الاختبار وقت كتابة هذا النص)، وتابع الإصدارات الرسمية للترقيات المنسّقة، وأبقِ ساعة النظام متزامنة عبر NTP.

  2. شغّل عقداً متكررة. شغّل عقدتين على الأقل خلف موزّع أحمال حتى لا تؤدي إعادة تشغيل أو إعادة مزامنة واحدة إلى انقطاع حركة التكامل.

  3. تحقّق من ملف genesis واللقطات. تحقّق دائماً من SHA-256 لملف genesis ومن مجموع تحقق أي لقطة مقابل الإصدار الرسمي قبل البدء.

  4. احمِ نقاط النهاية العامة. ضع RPC/EVM/gRPC خلف وكيل عكسي وتحديد لمعدل الطلبات وجدار حماية. لا تكشف أبداً RPC للكتابة دون مصادقة على الإنترنت.

  5. طابق التقليم مع الحاجة. استخدم pruning = "nothing" مع tx_index = "kv" لمنصات التداول التي تُطابق سجل الإيداعات/السحوبات الكامل؛ واستخدم default للاستعلامات الخفيفة.

  6. راقب المزامنة باستمرار. فعّل التنبيهات عند تأخر ارتفاع الكتل، وانعدام النظراء، وبقاء العقدة عالقة في catching_up.

النشر بعقدة فقط لا يوقّع أبداً. يجب أن تحمل المعاملات التي يبثّها تكاملك عبره التوقيع الهجين لما بعد الكم بالفعل (وفي مسار EVM يحتاج المُرسِل إلى مفتاح مسجَّل ونافذة تفويض مفتوحة)؛ راجع تكامل منصات التداول والتوقيع ما بعد الكمي.

لمراقبة الشبكة دون تشغيل عقدة كاملة، راجع وثائق العقدة الخفيفة.


استكشاف الأخطاء وإصلاحها​

تتوقف العقدة مع خطأ في الساعة​

اعتباراً من إصدار العقدة v3.2.1 يتوقف محرك الإجماع عندما تنحرف ساعة النظام عن الشبكة بأكثر من 60 ثانية. شغّل عميل NTP (chrony أو systemd-timesyncd)، وتأكد من أن الساعة متزامنة باستخدام timedatectl status، ثم أعد تشغيل العقدة.

العقدة المتوقفة قبل الترقية لا تستأنف بعد تبديل الملف الثنائي​

إذا كانت عقدتك متوقفة أو عالقة بالفعل قبل ترقية ملفها الثنائي، فإن مجرد وضع الملف الثنائي الجديد وإعادة التشغيل لا يكفي — فالعقدة تحتفظ بنتائج ABCI قديمة مخبأة (cached) من التشغيل السابق ولن تُعيد تنفيذ الكتلة التي تسببت في التوقف. تراجع (rollback) بشكل صريح قبل إعادة التشغيل:

qorechaind rollback --home <HOME>
systemctl restart <unit>

الأمر هو qorechaind rollback (أمر فرعي من المستوى الأعلى) — لا يوجد أمر فرعي comet rollback ولا علامة --hard له.

تعطّل استعادة اللقطة في حلقة تكرار بسبب غياب priv_validator_state.json​

لا يتضمن الأرشيف/اللقطة المنشورة data/priv_validator_state.json، وترفض العقدة البدء بدونه. إذا كان مفقوداً بعد استعادة لقطة، أنشئه — لكن فقط إذا لم يكن موجوداً بالفعل. لا تستبدل أبداً ملفاً حقيقياً: فعلى المدقّق، يُعدّ هذا الملف حارس مانع التوقيع المزدوج (anti-double-signing)، والكتابة فوقه تُخاطر بتوقيع مزدوج (double-sign).

echo '{"height":"0","round":0,"step":0}' > <HOME>/data/priv_validator_state.json

الخطوات التالية​