الاتصال بالشبكة الرئيسية
انضم إلى شبكة 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-RPC | https://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
مرجع المنافذ
| المنفذ | البروتوكول | الوصف |
|---|---|---|
26657 | TCP | RPC — الاستعلام عن المعاملات وبثها |
26656 | TCP | P2P — اتصال الشبكة بين النظراء |
1317 | HTTP | REST API — الاستعلام عن حالة السلسلة عبر HTTP |
9090 | gRPC | gRPC API — الوصول البرمجي إلى السلسلة |
8545 | HTTP | EVM JSON-RPC — واجهة RPC متوافقة مع Ethereum (معرّف السلسلة 9801) |
8546 | WebSocket | EVM WebSocket — اشتراكات أحداث EVM في الوقت الفعلي |
8899 | HTTP | SVM RPC — واجهة RPC متوافقة مع Solana (للقراءة فقط؛ مسار معاملات SVM معطَّل) |
26660 | HTTP | نقطة نهاية مقاييس Prometheus |
حقائق الشبكة
| الحقل | القيمة |
|---|---|
| معرّف السلسلة | qorechain-vladi |
| معرّف سلسلة EVM | 9801 (بالنظام السداسي عشري 0x2649) |
| إصدار السلسلة | v3.2.7 (طُبِّق عند الارتفاع 4,164,600 في 12 نوفمبر 2026) |
| مباشرة منذ | 7 يونيو 2026 |
| زمن الكتلة | نحو 3.1 ثانية (متوسط مقيس) |
| الرمز | QOR (uqor، 10^6 وحدة دقيقة = 1 QOR) |
| الحد الأدنى لسعر الغاز | 0.1uqor |
| بادئة الحسابات | qor |
| بادئة المدققين | qorvaloper |
| SDK | Cosmos SDK v0.53 |
الخطوات التالية
- تشغيل عقدة — تشغيل عقدة كاملة/عقدة RPC لمنصات التداول والجهات المتكاملة
- دليل منصات التداول والجهات المتكاملة — الإيداعات والسحوبات والمراقبة
- تشغيل مدقق — إنشاء مدقق وتشغيله
- إعداد المحفظة — تهيئة محفظة للشبكة الرئيسية
- معاملتك الأولى — أرسل أول تحويل QOR لك
- الاتصال بشبكة الاختبار — انضم إلى شبكة اختبار Diana للتجربة المجانية
- الشبكات — معرّفات السلاسل والمنافذ والمرجع الكامل للشبكات