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

الاتصال بالشبكة الرئيسية

انضم إلى شبكة QoreChain Vladi الرئيسية المباشرة عبر تهيئة العقدة الخاصة بك باستخدام ملف التكوين الأصلي (genesis) الرسمي والنظراء وإعدادات الشبكة.

ملاحظة

تغطي هذه الصفحة الشبكة الرئيسية qorechain-vladi (معرّف سلسلة EVM ‏9801، بالنظام السداسي عشري 0x2649)، وهي تعمل مباشرةً منذ 7 يونيو 2026 وتشغّل الإصدار v3.2.7 على Cosmos SDK v0.53 منذ 12 نوفمبر 2026 (طُبّق عند الارتفاع 4,164,600، واستأنفت الكتل نحو الساعة 15:01 بالتوقيت العالمي UTC، بمقترح الحوكمة 16؛ وكان v3.2.6 قد طُبّق عند الارتفاع 4,020,000 في 4 نوفمبر 2026). أما شبكة الاختبار qorechain-diana (معرّف سلسلة EVM ‏9800)، فراجع الاتصال بشبكة الاختبار وجرّب إعدادك هناك قبل الانطلاق على الشبكة المباشرة.

نقاط النهاية العامة​

إذا كنت تحتاج فقط إلى الاستعلام عن السلسلة أو بث المعاملات، فلست بحاجة إلى عقدة خاصة بك — نقاط النهاية العامة هي:

الخدمةالرابط
RPC الإجماعhttps://rpc.qore.host (WebSocket: ‏wss://rpc.qore.host/websocket)
Cosmos REST ‏(LCD)https://api.qore.host
EVM JSON-RPChttps://evm.qore.host (معرّف السلسلة 9801)
SVM JSON-RPC (للقراءة فقط)https://svm.qore.host
مستكشف الكتلexplore.qore.network

لأحمال العمل الكثيفة أو الإنتاجية (منصات التداول، أدوات الفهرسة)، شغّل عقدتك الخاصة كما هو موضح أدناه.

المضيفون العامون مشتركون ولذلك تسري عليهم حدود (معدل الطلبات وأحجام SVM RPC ومرشحات EVM)؛ ويمر eth_call وتقدير الغاز عبر مضيف EVM JSON-RPC. راجع الحدود على نقاط النهاية العامة.


التثبيت​

ثبّت الملف التنفيذي qorechaind إما من الحزمة الرسمية المبنية مسبقاً أو عبر البناء من الشيفرة المصدرية.

حزمة الملف التنفيذي المبنية مسبقاً (linux/amd64)​

المصدر المرجعي الموثوق للملف التنفيذي الحالي هو بيان الشبكة الرئيسية (mainnet manifest)، وهو ملف JSON يُحدَّث مباشرةً على العنوان https://download.qore.host/mainnet/latest.json. يحمل هذا الملف رابط الملف التنفيذي الحالي ومجموع التحقق SHA-256 الخاص به، ورابط ملف genesis الحالي ومجموع التحقق SHA-256 الخاص به وحجمه، وقوائم النظراء (peers) والبذور (seeds) الحالية، ومنفذ P2P، ونقطة ثقة لمزامنة الحالة (state-sync)، والحد الأدنى لإصدار السلسلة المتوافق. اجلب هذا الملف واستخدم قيمه بدلاً من ترميز إصدار الملف التنفيذي أو مجموع التحقق مباشرةً في نصوص التثبيت البرمجية — فتلك القيم تصبح قديمة بمجرد صدور إصدار جديد:

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

BINARY_URL=$(jq -r .binary.url latest.json)
BINARY_SHA256=$(jq -r .binary.sha256 latest.json)

curl -fsSL "$BINARY_URL" -o qore.tgz
echo "${BINARY_SHA256} qore.tgz" | sha256sum -c -

tar xzf qore.tgz
sudo install -m0755 qorechaind /usr/local/bin/
sudo mkdir -p /opt/qorechain/lib && sudo cp lib/*.so /opt/qorechain/lib/
export LD_LIBRARY_PATH=/opt/qorechain/lib

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

حافظ على تحديث عقدتك

يجب على العقد الكاملة مواكبة الإصدار المباشر للشبكة — ثبّت دائماً الملف التنفيذي الذي يشير إليه البيان (manifest)، ولا تُثبّت إصداراً قديماً بشكل ثابت. البيان الحالي (جرى التحقق في 12 نوفمبر 2026) هو v3.2.7 وقيمة minCompatible فيه 3.2.7 وقيمة upgradeHeight فيه 4,164,600: طبّقت الشبكة الرئيسية v3.2.7 عند ذلك الارتفاع في 12 نوفمبر 2026 عبر مقترح الحوكمة 16 (استأنفت الكتل نحو الساعة 15:01 بالتوقيت العالمي UTC)، ولا تستطيع العقدة التي لا تزال على إصدار أقدم متابعة السلسلة بعد ذلك الارتفاع. الحزمة هي qorechaind-v3.2.7-b3-linux-amd64.tar.gz (99,472,930 بايت، SHA-256 هو d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5). يذكر البيان أن عليك نسخ مجلد lib/ كاملًا من الحزمة؛ وهو يضم في v3.2.7 الملفات libqorepqc.so وlibqoresvm.so وlibwasmvm.x86_64.so. والعقدة التي لا تزال على v3.2.6 وفاتتها الترقية تتوقف عند الارتفاع 4,164,600 مع الرسالة UPGRADE "v3.2.7" NEEDED، والحل هو تثبيت هذه الحزمة (مع مجلد lib/ الخاص بها) ثم إعادة التشغيل (تبقى الحالة محفوظة). أما ترقيات الحوكمة السابقة على الشبكة الرئيسية فكانت v3.1.94 عند الارتفاع 2,122,074 (سقف الإصدار)، وv3.2.0 عند الارتفاع 2,981,742 (نافذة تفويض EVM وبايتات التوقيع الهجين v2)، وv3.2.2 عند الارتفاع 3,556,788 (16 أكتوبر 2026، المقترح 7)، وv3.2.3 عند الارتفاع 3,662,051 (20 أكتوبر 2026، المقترح 11)، وv3.2.4 عند الارتفاع 3,742,566 (23 أكتوبر 2026، المقترح 13)، وv3.2.5 عند الارتفاع 3,906,833 (29 أكتوبر 2026، المقترح 14) وv3.2.6 عند الارتفاع 4,020,000 (4 نوفمبر 2026، المقترح 15). وكان v3.2.1 إصداراً محلياً للعقدة بلا ارتفاع. لم يتغيّر توقيع المعاملات في v3.2.6؛ ويضيف v3.2.7 نمط التوقيع النصي خيارًا إضافيًا. والعقدة التي تنضم من جديد تحتاج إلى الملف التنفيذي v3.2.7 الذي يسميه البيان؛ ففضّل مزامنة الحالة (أدناه) على إعادة التشغيل من genesis. اللقطة المنشورة لبيانات السلسلة أقدم من كل ارتفاعات الترقية هذه، ولذلك يجب على العقدة المستعادة منها أن تعيد تشغيلها.

اضبط evm-chain-id = 9801 في app.toml (تُسجَّل أي قيمة مختلفة كخطأ) وأبقِ ساعة النظام متزامنة عبر NTP: تتوقف العقدة إذا انحرفت ساعتها بأكثر من 60 ثانية. تحقق دائماً من حقلَي "version" و"minCompatible" في البيان قبل الوثوق بـ binary.url — إذ يُروَّج البيان بشكل مدروس (أولاً على شبكة الاختبار، ثم على الشبكة الرئيسية بعد فترة اختبار). لم تتغير صيغة التوقيع ولا العناوين ولا الخانات العشرية ولا المذكّرات ولا الرسوم في v3.2.3 أو v3.2.4.

تعمل شبكة الاختبار (qorechain-diana) بالإصدار v3.2.8، أي بإصدار واحد قبل الشبكة الرئيسية (طُبّق v3.2.5 عليها في 26 أكتوبر 2026 وv3.2.6 في 27 أكتوبر 2026، وv3.2.7 في 6 نوفمبر 2026 وv3.2.8 في 12 نوفمبر 2026؛ ولم تطبّق الشبكة الرئيسية v3.2.8). لا تنسخ ملفًا تنفيذيًا بين الشبكتين أبدًا: اتبع دائمًا بيان الشبكة التي تشغّلها.

عندما تُجدول ترقية منسَّقة، يسمّي نص المقترح الارتفاع ويطلب منك البقاء على الإصدار السابق حتى ذلك الحين: تتوقف العقدة عند ذلك الارتفاع وتعيد تشغيلها بالملف التنفيذي الجديد. اقرأ status للمقترح (curl -s https://api.qore.host/cosmos/gov/v1/proposals/<id>) وحقلَي version وupgradeHeight في بيان الشبكة الرئيسية قبل استبدال أي ملف تنفيذي، ولا تثبّت أبداً الملف التنفيذي للترقية قبل بلوغ ارتفاعها: فالعقدة التي تحمله مبكراً تتوقف هي الأخرى. في 12 نوفمبر 2026 لم تكن خطة ترقية مضبوطة (أعاد curl -s https://api.qore.host/cosmos/upgrade/v1beta1/current_plan القيمة "plan": null). وآخرها، مقترح الحوكمة 16، طبّق v3.2.7 (البناء 3) عند الارتفاع 4,164,600 في 12 نوفمبر 2026 (وقبله طبّق المقترح 15 الإصدار v3.2.6 عند الارتفاع 4,020,000 في 4 نوفمبر 2026)؛ والبيان أعلاه هو المرجع لما تثبّته عقدة جديدة.

البناء من الشيفرة المصدرية (للتطوير فقط)​

git clone https://github.com/qorechain/qorechain-core.git
cd qorechain-core
CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/

ينتج هذا الأمر النسخة المجتمعية من الملف التنفيذي مع مدراء (keepers) وهميين ومن دون موقِّع لما بعد الكم، ولا يمكنها إعادة إنتاج حالة الإجماع للشبكات ولا إنشاء معاملات موقَّعة توقيعاً هجيناً. لتشغيل عقدة على الشبكة الرئيسية، ثبّت الملف التنفيذي الرسمي للإصدار المذكور أعلاه. راجع البناء من الشيفرة المصدرية للاطلاع على المتطلبات الأساسية الكاملة (Go 1.26+‎، وCGO، والمكتبات الأصلية).

تهيئة العقدة​

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

ينشئ هذا الأمر التكوين الافتراضي ومجلدات البيانات ضمن ~/.qorechaind/.


تنزيل ملف Genesis​

استبدل ملف genesis المحلي لديك بملف genesis الرسمي للشبكة الرئيسية، باستخدام الرابط ومجموع التحقق SHA-256 من البيان الذي جلبته أعلاه:

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 -

يُقدَّم الملف نفسه مباشرةً من السلسلة ذاتها أيضاً — ويمكنك التحقق المتقاطع من الملف المنزَّل مقابله:

curl -s https://rpc.qore.host/genesis | jq '.result.genesis' > /tmp/genesis-live.json

يحدد هذا الملف الحالة الأولية لشبكة Vladi الرئيسية، بما في ذلك مجموعة مدققي genesis، وتخصيصات الرموز (حدث إصدار الرمز TGE عند genesis)، ومعاملات الوحدات.


تكوين النظراء​

عدّل تكوين عقدتك للاتصال بعقد الحراسة (sentry) العامة للشبكة الرئيسية. اقرأ قوائم النظراء والبذور الحالية من البيان بدلاً من ترميز معرّفات العقد والمضيفين مباشرةً — فهذه القيم تتغيّر دورياً:

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"

الإعدادات الموصى بها​

لا تختار العقدة الكاملة زمن الكتلة — بل يختاره المدققون (تنتج الشبكة الرئيسية حالياً كتلة كل 3.1 ثانية تقريباً). أبقِ مهلات الإجماع على قيمها الافتراضية ما لم تكن تشغّل مدققاً وقد زوّدتك مجموعة المدققين بقيم محددة. إعداد مفيد لذاكرة المعاملات (mempool) في عقدة RPC عامة، في config.toml:

[mempool]
size = 5000

الإقلاع السريع (اللقطة أو مزامنة الحالة)​

قد تستغرق المزامنة من genesis وقتاً طويلاً. يحمل حقل stateSync في البيان زوجاً من ارتفاع الثقة (trust height) وتجزئة الثقة (trust hash) يُحدَّث كل ساعة — استخدمه لتكوين مزامنة الحالة (state sync) بدلاً من البحث عن ارتفاع يدوياً:

TRUST_HEIGHT=$(jq -r .stateSync.trustHeight latest.json)
TRUST_HASH=$(jq -r .stateSync.trustHash latest.json)

ثم اضبط قسم [statesync] في config.toml بهاتين القيمتين — راجع تشغيل عقدة للاطلاع على سير العمل الكامل، بما في ذلك بديل احتياطي يدوي قائم على RPC إذا احتجت إلى اشتقاق نقطة ثقة بنفسك.

تُدرَج لقطة لبيانات السلسلة أيضاً في البيان (snapshot.url وsnapshot.sha256 وsnapshot.height). اقرأ القيم من البيان بدلاً من ترميز اسم ملف أو ارتفاع بشكل ثابت، إذ تحل كل لقطة جديدة محل القديمة. اللقطة كبيرة (عشرات الغيغابايت)، وقد أُخذت، كما نُشرت في أكتوبر 2026، عند الارتفاع 1,966,629 (21 أغسطس 2026) — أي قبل كل ارتفاع ترقية مذكور أعلاه — ولذلك يجب على العقدة المستعادة منها أن تعيد تشغيل تلك الترقيات؛ وعادةً ما تكون مزامنة الحالة أسرع وتتجنب ذلك:

SNAPSHOT_URL=$(jq -r .snapshot.url latest.json)
SNAPSHOT_SHA256=$(jq -r .snapshot.sha256 latest.json)

curl -fsSL "$SNAPSHOT_URL" -o snapshot.tar.gz
echo "${SNAPSHOT_SHA256} snapshot.tar.gz" | sha256sum -c -

tar xzf snapshot.tar.gz -C ~/.qorechaind/

بدء تشغيل العقدة​

شغّل عقدتك لبدء المزامنة مع الشبكة:

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

تتصل العقدة بالنظراء وتبدأ في تنزيل الكتل (بدءاً من genesis، أو من ارتفاع اللقطة إذا كنت قد استعدت واحدة).


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

تحقق من أن عقدتك تلحق بأحدث كتلة:

curl localhost:26657/status | jq '.result.sync_info.catching_up'
  • true — لا تزال العقدة قيد المزامنة. انتظر حتى تلحق بالشبكة.
  • false — العقدة متزامنة بالكامل وتعالج الكتل الجديدة.

يمكنك أيضاً التحقق من أحدث ارتفاع للكتلة:

curl localhost:26657/status | jq '.result.sync_info.latest_block_height'

تأكد من أنك على الشبكة الصحيحة — يجب أن يُظهر الحقل network القيمة qorechain-vladi:

curl localhost:26657/status | jq '.result.node_info.network'

المراقبة​

توفر QoreChain عدة نقاط نهاية لمراقبة صحة العقدة وأدائها.

مقاييس Prometheus​

المقاييس الخام متاحة على:

http://localhost:26660/metrics

يمكن لأي مجمّع متوافق مع Prometheus جمع هذه المقاييس.

لوحات Grafana​

عند التشغيل عبر Docker Compose، تكون Grafana متاحة على:

http://localhost:3001

عند تسجيل الدخول لأول مرة، عيّن بيانات اعتمادك الخاصة عند مطالبتك بذلك — ولا تُبقِ على القيم الافتراضية. تعرض اللوحات المهيأة مسبقاً إنتاج الكتل، ومعدل معالجة المعاملات، واتصالات النظراء، واستخدام الموارد.

فحص الحالة عبر REST​

توفر واجهة REST API نقطة نهاية سريعة لفحص الحالة:

http://localhost:1317

مرجع المنافذ​

المنفذالبروتوكولالوصف
26657TCPRPC — الاستعلام عن المعاملات وبثها
26656TCPP2P — اتصال الشبكة بين النظراء
1317HTTPREST API — الاستعلام عن حالة السلسلة عبر HTTP
9090gRPCgRPC API — الوصول البرمجي إلى السلسلة
8545HTTPEVM JSON-RPC — واجهة RPC متوافقة مع Ethereum (معرّف السلسلة 9801)
8546WebSocketEVM WebSocket — اشتراكات أحداث EVM في الوقت الفعلي
8899HTTPSVM RPC — واجهة RPC متوافقة مع Solana (للقراءة فقط؛ مسار معاملات SVM معطَّل)
26660HTTPنقطة نهاية مقاييس Prometheus

حقائق الشبكة​

الحقلالقيمة
معرّف السلسلةqorechain-vladi
معرّف سلسلة EVM9801 (بالنظام السداسي عشري 0x2649)
إصدار السلسلةv3.2.7 (طُبِّق عند الارتفاع 4,164,600 في 12 نوفمبر 2026)
مباشرة منذ7 يونيو 2026
زمن الكتلةنحو 3.1 ثانية (متوسط مقيس)
الرمزQOR (‏uqor، ‏10^6 وحدة دقيقة = 1 QOR)
الحد الأدنى لسعر الغاز0.1uqor
بادئة الحساباتqor
بادئة المدققينqorvaloper
SDKCosmos SDK v0.53

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