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

أوامر العقدة

مرجع لأوامر qorechaind المستخدمة لتهيئة عقدة QoreChain وضبطها وتشغيلها.

ملاحظة

تُشغّل QoreChain شبكتين: الشبكة الرئيسية qorechain-vladi (تعمل منذ 7 يونيو 2026؛ إصدار العقدة v3.2.7، طُبّق عند الارتفاع 4,164,600 في 12 نوفمبر 2026 بمقترح الحوكمة 16؛ وطُبّق v3.2.6 عند الارتفاع 4,020,000 في 4 نوفمبر 2026؛ وطُبّق v3.2.5 عند الارتفاع 3,906,833 في 29 أكتوبر 2026 وv3.2.4 عند الارتفاع 3,742,566 في 23 أكتوبر 2026 وv3.2.3 عند الارتفاع 3,662,051 في 20 أكتوبر 2026) والشبكة التجريبية qorechain-diana (إصدار العقدة v3.2.8، طُبّق عند الارتفاع 9,929,500 في 12 نوفمبر 2026، بعد v3.2.7 عند الارتفاع 9,594,600 في 6 نوفمبر، وv3.2.6 عند الارتفاع 8,970,638 في 27 أكتوبر وv3.2.5 عند الارتفاع 8,890,800 في 26 أكتوبر وv3.2.4 عند الارتفاع 8,337,253 في 19 أكتوبر؛ ولم تطبّق الشبكة الرئيسية v3.2.8). مرّر قيمة --chain-id المناسبة للشبكة التي تريد الانضمام إليها — الأمثلة أدناه تستهدف الشبكة التجريبية؛ استخدم --chain-id qorechain-vladi للشبكة الرئيسية. الإصدار الحالي لكل شبكة مدرج في latest.json ضمن download.qore.host.

جرى التحقق من الأوامر في هذه الصفحة مقابل الملف الثنائي للإصدار v3.2.3. ويضيف الملف الثنائي v3.2.4 أوامر ليست موجودة في الملف الثنائي v3.2.3 (مثل stakingtier)؛ وهي تعمل على الشبكتين (شبكة الاختبار منذ 19 أكتوبر 2026، والشبكة الرئيسية منذ 23 أكتوبر 2026)، وحيثما يذكر هذا الدليل أحدها فإنه يوضّح ذلك. ويضيف الملف الثنائي v3.2.6 (الشبكتان) أمري استعلام آخرين هما query rlconsensus applied-params وlast-action (انظر أوامر الاستعلام). وكل ما عدا ذلك في هذه الصفحة يعمل بالطريقة نفسها على الإصدارين.


init​

تهيئة عقدة جديدة بالاسم المستعار المحدد.

qorechaind init <moniker> --chain-id qorechain-diana
العلمالنوعالوصف
--chain-idstringمعرّف السلسلة (مرّره دائمًا؛ يُنشأ معرّف عشوائي إذا حُذف)
--homestringدليل العقدة الرئيسي (الافتراضي: ~/.qorechaind)
--overwriteboolاستبدال ملف genesis.json الحالي
--recoverboolتقديم عبارة استرداد (seed phrase) لاسترداد مفتاح موجود بدلًا من إنشاء مفتاح جديد

ينشئ هيكل الدليل ضمن --home مع config/ وdata/ وملف genesis.json أولي. بالنسبة إلى عقدة شبكة، استبدل ملف genesis.json هذا بملف التكوين الأولي (genesis) الخاص بالشبكة قبل البدء (انظر الاتصال بالشبكة الرئيسية).

يكتب init أيضًا معرّف سلسلة EVM الخاص بالشبكة (9801 للشبكة qorechain-vladi، و9800 للشبكة qorechain-diana) في الإعداد evm-chain-id داخل app.toml، لذا مرّر قيمة --chain-id الصحيحة.


start​

بدء تشغيل العقدة والشروع في المزامنة أو إنتاج الكتل.

qorechaind start [flags]
العلمالنوعالوصف
--homestringدليل العقدة الرئيسي
--minimum-gas-pricesstringالحد الأدنى لسعر الغاز الذي تقبله هذه العقدة. الحد الأدنى للشبكة هو 0.1uqor؛ اضبط هذه القيمة عند هذا الحد على الأقل
--pruningstringاستراتيجية التقليم: default، nothing، everything، custom (مع --pruning-keep-recent و--pruning-interval)
--halt-heightuintإيقاف العقدة عند هذا الارتفاع للكتلة
--halt-timeuintإيقاف العقدة عند هذا الطابع الزمني من نوع Unix
--log_levelstringمستوى تفصيل السجلّ: info، debug، warn، error
--traceboolتفعيل تتبّع المكدّس الكامل عند حدوث أخطاء

الملف الثنائي المبني من شجرة المصدر العامة (بناء المجتمع) يرفض البدء على qorechain-vladi أو qorechain-diana: فهو لا يستطيع التحقق من التوقيعات ما بعد الكمومية ولا يستطيع إعادة تشغيل كتل الشبكتين بأمانة (إصدار العقدة v3.2.3 وما بعده). استخدم الملف الثنائي للإصدار من download.qore.host؛ انظر البناء من المصدر.


version​

لا يُبلغ qorechaind version عن رقم الإصدار في الملفات الثنائية للإصدارات: فهو يطبع سطرًا فارغًا، ولا يضيف version --long أي تفاصيل بناء. لا تعتمد عليه للتمييز بين الإصدارات. للتأكد مما تشغّله:

  • قارن SHA-256 للأرشيف الذي نزّلته مع binary.sha256 في البيان (manifest) الخاص بالشبكة قبل فك ضغطه (واحتفظ بذلك الأرشيف، أو بمجموعه الاختباري، كسجل لما ثبّتّه).
  • اسأل السلسلة عن الترقيات التي طبّقتها: يُرجع GET /cosmos/upgrade/v1beta1/applied_plan/<upgrade_name> الارتفاع الذي طُبّقت عنده الترقية، أو 0 إن لم تُطبَّق.
# archive checksum, as published
curl -s https://download.qore.host/mainnet/latest.json | jq -r '.version, .binary.sha256'
# has v3.2.3 / v3.2.4 / v3.2.5 / v3.2.6 / v3.2.7 been applied on mainnet, and at which height? (a name that was not applied returns {"height":"0"})
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.3 # {"height":"3662051"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.4 # {"height":"3742566"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.6 # {"height":"4020000"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.7 # {"height":"4164600"}

status​

استعلام العقدة قيد التشغيل عن حالتها الحالية، بما في ذلك حالة المزامنة وأحدث ارتفاع للكتلة ومعلومات الإجماع.

qorechaind status
العلمالنوعالوصف
--nodestringنقطة نهاية RPC (الافتراضي: tcp://localhost:26657)

تُعيد JSON يحتوي على أقسام node_info وsync_info وvalidator_info.


client configuration​

لا يوجد أمر فرعي config. تُقرأ القيم الافتراضية للعميل (chain-id وkeyring-backend وoutput وnode) من الملف <home>/config/client.toml؛ عدّل هذا الملف، أو مرّر العلم مع كل أمر (--chain-id و--keyring-backend و--output و--node).


keys​

إدارة سلسلة المفاتيح المحلية لتوقيع المعاملات.

إضافة مفتاح جديد​

qorechaind keys add <name> [flags]
العلمالنوعالوصف
--keyring-backendstringالخلفية: os، file، kwallet، pass، test، memory
--key-typestringخوارزمية المفتاح: secp256k1 (الافتراضي) أو eth_secp256k1
--coin-typeuint32نوع العملة في HD (الافتراضي 118)
--recoverboolاسترداد المفتاح من العبارة التذكارية (mnemonic)
--multisigstringقائمة مفاتيح مفصولة بفواصل للتوقيع المتعدد
--multisig-thresholduintالحد الأدنى للتوقيعات المطلوبة

سرد جميع المفاتيح​

qorechaind keys list --keyring-backend <backend>

عرض تفاصيل مفتاح​

qorechaind keys show <name> [flags]
العلمالنوعالوصف
--bechstringصيغة الإخراج: acc، val، cons
--addressboolعرض العنوان فقط
--pubkeyboolعرض المفتاح العام فقط

حذف مفتاح​

qorechaind keys delete <name> --keyring-backend <backend>

تصدير مفتاح (مشفّر بدرع Armor)​

qorechaind keys export <name>

استيراد مفتاح​

qorechaind keys import <name> <keyfile>

genesis​

إدارة ملف التكوين الأولي (genesis).

إضافة حساب في ملف التكوين الأولي​

qorechaind genesis add-genesis-account <address> <coins> [flags]
العلمالنوعالوصف
--vesting-amountstringمبلغ الاستحقاق التدريجي (vesting)
--vesting-start-timeintوقت بدء الاستحقاق التدريجي (طابع زمني من نوع Unix)
--vesting-end-timeintوقت انتهاء الاستحقاق التدريجي (طابع زمني من نوع Unix)

إنشاء معاملة تكوين أولي (genesis)​

qorechaind genesis gentx <key-name> <stake-amount> [flags]
العلمالنوعالوصف
--chain-idstringمعرّف السلسلة
--monikerstringالاسم المستعار للمدقّق (validator)
--commission-ratestringمعدّل العمولة الأولي
--commission-max-ratestringالحد الأقصى لمعدّل العمولة

تجميع معاملات التكوين الأولي​

qorechaind genesis collect-gentxs

الأوامر الفرعية الأخرى لـ genesis: bulk-add-genesis-account وmigrate.

التحقق من صحة ملف التكوين الأولي​

qorechaind genesis validate

محرّك الإجماع​

تتفاعل هذه الأوامر الفرعية مع طبقة محرّك الإجماع الخاصة بـ QoreChain.

عرض مفتاح المدقّق​

qorechaind comet show-validator

يُخرج مفتاح الإجماع العام بصيغة JSON. يُستخدم للتحقق من هوية المدقّق (validator).

عرض معرّف العقدة​

qorechaind comet show-node-id

يُخرج معرّف عقدة الشبكة النظيرة (P2P) بترميز سداسي عشري. يُستخدم لتكوين النظراء الدائمين (persistent peers).


export​

تصدير حالة السلسلة الحالية كملف JSON للتكوين الأولي (genesis). مفيد لترقيات السلسلة أو اللقطات (snapshots).

qorechaind export [flags]
العلمالنوعالوصف
--for-zero-heightboolتجهيز التصدير لإعادة التشغيل من الارتفاع صفر
--heightintتصدير الحالة عند ارتفاع كتلة محدد
--homestringدليل العقدة الرئيسي
--output-documentstringكتابة ناتج التصدير في هذا الملف بدلًا من STDOUT
--modules-to-exportstringsقائمة مفصولة بفواصل بالوحدات المراد تصديرها (الافتراضي: الكل)
--jail-allowed-addrsstringsعناوين المشغّلين للمدقّقين المسجونين (jailed) المراد إلغاء سجنهم

rollback​

التراجع بحالة السلسلة كتلة واحدة إلى الخلف. مفيد للتعافي من فشل في الإجماع.

qorechaind rollback [flags]
العلمالنوعالوصف
--hardboolإزالة آخر كتلة من مخزن الكتل أيضًا
--homestringدليل العقدة الرئيسي

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