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

تشغيل مدقق

يغطي هذا الدليل كيفية إنشاء مدقق (validator) على شبكة QoreChain، وفهم تصميم تصنيف المجمعات، وتسجيل مفتاح PQC (توقيعات هجينة ML-DSA-87 وفق FIPS 204)، ومراقبة عقدتك.

ملاحظة

يستهدف هذا الدليل الشبكة الرئيسية qorechain-vladi (معرّف سلسلة EVM 9801)، الفعّالة منذ 7 يونيو 2026، وتعمل بإصدار العقدة v3.2.7 (طُبِّق عبر مقترح الحوكمة 16 عند الارتفاع 4,164,600 في 12 نوفمبر 2026، بعد 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). يجب أن يشغّل المدقق الملف الثنائي v3.2.7 (قيمة minCompatible في البيان هي 3.2.7)؛ والعقدة التي كانت ما زالت على v3.2.6 توقفت عند الارتفاع 4,164,600 وتحتاج إلى حزمة v3.2.7 (راجع تشغيل عقدة: الترقيات). وتعمل الشبكة التجريبية qorechain-diana (معرّف سلسلة EVM 9800) بالإصدار v3.2.8 منذ 12 نوفمبر 2026 (بعد v3.2.7 في 6 نوفمبر، وv3.2.6 في 27 أكتوبر وv3.2.5 في 26 أكتوبر؛ وقيمة minCompatible في بيانها 3.2.8، راجع ملاحظة شبكة الاختبار في تشغيل عقدة) ويُنصح بها للتدرب على إعدادك قبل الانتقال إلى الإنتاج الفعلي. استبدل قيمة --chain-id المناسبة لشبكتك المستهدفة. تختلف أزمنة الكتل: نحو 3.1 ثانية على الشبكة الرئيسية (استغرقت آخر 1,000 كتلة 52 دقيقة و21 ثانية في 27 أكتوبر 2026) ونحو 1.3 ثانية على الشبكة التجريبية؛ وكلاهما يتفاوت، لذا حوّل عدد الكتل إلى زمن لكل شبكة.

استخدم الملف الثنائي الرسمي، لا البناء من المصدر

يجب أن يشغّل المدقق ملف qorechaind الرسمي المذكور في البيان (manifest) المباشر (https://download.qore.host/mainnet/latest.json؛ راجع تشغيل عقدة). الملف الثنائي المبني من المصدر العام يحتوي على keepers وهمية (stubs) وليس فيه موقّع ما بعد كمي: لا يمكنه إعادة إنتاج حالة إجماع الشبكة، ولا يمكنه إنشاء التوقيع الهجين الذي يحتاجه create-validator وكل معاملة أخرى عبر مسار Cosmos (راجع البناء من المصدر). واعتبارًا من v3.2.3 يرفض الملف الثنائي المبني من المصدر العام أن يعمل على أي شبكة عامة أصلًا. تحتاج العقدة الجديدة على الشبكة الرئيسية إلى v3.2.0 أو أحدث؛ أبقِ ساعة النظام متزامنة عبر NTP، لأنه اعتبارًا من v3.2.1 تتوقف العقدة عندما تنحرف ساعتها بأكثر من 60 ثانية.

أي أجزاء هذه الصفحة فعّالة

يعتمد إنتاج الكتل على التناوب القياسي للمدققين الموزون بالحصة، ويستخدم الخصم (slashing) والحوكمة وحدات Cosmos SDK القياسية بالمعاملات الموضحة أدناه. أما منطق CPoS الثلاثي المجمعات (تصنيف المجمعات، واختيار المقترح المرجَّح بالمجمع، ومنحنى الربط، والخصم التصاعدي) فهو منفَّذ في وحدة x/qca ومعاملاته على السلسلة، لكنه غير موصول بعد بإنتاج الكتل أو المكافآت أو الخصم. تصف الأقسام الخاصة بهذه المواضيع التصميم؛ لا تخطط على أساس أن عضوية المجمع أو السمعة ستغيّر حصتك من اقتراح الكتل أو مكافآتك اليوم.


المتطلبات الأساسية​

  • عقدة qorechaind رسمية متزامنة بالكامل (راجع الاتصال بالشبكة الرئيسية، أو الاتصال بالشبكة التجريبية للتدرب)
  • مفتاح PQC من نوع ML-DSA-87 مسجَّل على حساب المشغّل (راجع تسجيل مفتاح PQC) — يحتاج create-validator إلى التوقيع الهجين
  • حساب ممول بما لا يقل عن 100,000 QOR (100,000,000,000 uqor) للتفويض الذاتي الأولي — هذا الحد الأدنى مفروض على السلسلة، ويُرفض create-validator دونه
  • منح validator_operator فعّال على عنوان المشغّل الخاص بك، يُصدَر عبر Validator Program في صفحة Nodes & Validators بلوحة التحكم (قدِّم طلبًا، وكن من المختارين، وادفع رسم البرنامج البالغ $1,000)؛ راجع الملاحظة أدناه. فبدونه يفشل create-validator برسالة ErrUnauthorized بغضّ النظر عن مقدار QOR الذي تودعه ذاتيًا
  • الإلمام بنموذج التخزين والتفويض

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

استخدم مزامنة الحالة (state sync) طريقةً افتراضية للانضمام. فهي تجلب حالة تطبيق حديثة من الأقران بدلًا من إعادة تنفيذ الكتل، بدلًا من إعادة تنفيذ كل كتلة منذ التكوين الأول (genesis). تنزيل اللقطة (snapshot) بديل احتياطي فقط: لقطة بيان الشبكة الرئيسية لا تزال أرشيف 21 أغسطس 2026 (الارتفاع 1,966,629، نحو 27 GB)، وهو سابق لعدة ترقيات ثم يعيد تنفيذ كتل نحو شهرين، ولا تنشر الشبكة التجريبية أي لقطة على الإطلاق.

  1. ثبّت qorechaind الرسمي الذي يسميه البيان (راجع تشغيل عقدة)، ثم شغّل qorechaind init <moniker> --chain-id qorechain-vladi، ثم ضع ملف genesis والأقران (peers) والبذور (seeds) الواردة في البيان في أماكنها كما هو موصوف هناك، واضبط minimum-gas-prices = "0.1uqor" في app.toml.
  2. خذ نقطة الثقة من البيان واكتب القسم [statesync] في config.toml:
curl -s https://download.qore.host/mainnet/latest.json -o latest.json
TRUST_HEIGHT=$(jq -r .stateSync.trustHeight latest.json)
TRUST_HASH=$(jq -r .stateSync.trustHash latest.json)
[statesync]
enable = true
rpc_servers = "https://rpc.qore.host:443,https://<a second RPC you run or trust>:26657"
trust_height = <TRUST_HEIGHT>
trust_hash = "<TRUST_HASH>"
trust_period = "168h0m0s"
  1. اختياريًا، أبقِ القرص صغيرًا (راجع العتاد): في app.toml اضبط pruning = "custom" مع pruning-keep-recent = "100000" وpruning-interval = "10"، وفي config.toml اضبط indexer = "null" تحت [tx_index] (المدقق لا يخدم أي استعلامات عن المعاملات؛ لا تستخدم null على عقدة تستعلم منها).
  2. ابدأ التشغيل بالأمر qorechaind start --minimum-gas-prices=0.1uqor وانتظر حتى تصبح catching_up هي false.
تحتاج مزامنة الحالة إلى خادمَي RPC مختلفين

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

أبقِ ساعة النظام متزامنة عبر NTP: اعتبارًا من v3.2.1 تتوقف العقدة عندما تنحرف ساعتها بأكثر من 60 ثانية.


معاملات الشبكة​

قُرئت هذه القيم من REST API للشبكة الرئيسية في 27 أكتوبر 2026 (qorechain-vladi، وكانت حينها على v3.2.4) وأُعيدت قراءتها في 4 نوفمبر 2026 على v3.2.6: دون تغيير (ولم تُعَد قراءتها بعد ترقية v3.2.7) (8 مدققين مرهونين، ولا أحد مسجون). اقرأها مباشرة قبل أن تعتمد عليها: qorechaind query staking params أو qorechaind query slashing params أو GET /cosmos/staking/v1beta1/params وGET /cosmos/slashing/v1beta1/params.

البندالقيمة
حجم المجموعة النشطة (max_validators)100 (يوجد اليوم 8 مدققين مربوطين، ولا أحد مسجون)
فترة فك الربط1,814,400 ثانية (21 يومًا)؛ وبحد أقصى 7 مدخلات فك ربط (max_entries) لكل مفوِّض
الحد الأدنى لمعدل العمولة (min_commission_rate)0 (تختار معدلك بنفسك، حتى commission-max-rate الخاص بك)
نافذة الكتل الموقَّعة10,000 كتلة (signed_blocks_window)
الحد الأدنى للتوقيع ضمن النافذة0.05، فيُسجَن المدقق عندما يوقّع أقل من 5% من النافذة
السجن / الخصم عند التوقف عن العملسجن 600 ثانية، وخصم 1% من الحصة
الخصم عند التوقيع المزدوج5% من الحصة
الحد الأدنى للإيداع الذاتي لإنشاء مدقق100,000 QOR (100000000000uqor)، مفروض على السلسلة؛ ودونه يفشل create-validator بالرمز 18
منح المشغّليلزم منح validator_operator فعّال على المُرسِل؛ وبدونه يفشل create-validator برسالة ErrUnauthorized
حد الرسوم0.1 uqor لكل وحدة غاز

ترتيب الخطوات. نفّذها بهذا الترتيب: (1) سجّل مفتاح PQC للحساب، (2) احصل على منح validator_operator، (3) ابنِ create-validator بالخيار --generate-only ووقّعه بالأمر tx pqc cosign. يأتي المفتاح أولًا لأن الحساب الذي لا يملك مفتاحًا مسجَّلًا لا يستطيع إرسال سوى معاملة التسجيل نفسها (راجع تسجيل مفتاح PQC)، ويُفحص المنح عند تشغيل create-validator. التفاصيل في إنشاء مدقق وتسجيل مفتاح PQC.

min-self-delegation ليس الحد الأدنى البالغ 100,000 QOR

يُظهر مدققو genesis القيمة min_self_delegation = 1 (1 uqor) على السلسلة. وهذا ليس الحد الأدنى: فمعاملات genesis الخاصة بهم كانت معفاة منه. الحقل min-self-delegation في ملف validator.json الخاص بك هو تعهدك بنفسك بإبقاء هذا المقدار على الأقل مودعًا ذاتيًا، وهو غير مرتبط بالحد الأدنى البالغ 100,000 QOR، الذي ينطبق على amount الذي تفوّضه ذاتيًا عند إنشاء المدقق.


العتاد​

قيس على المدققين العاملين على الشبكة الرئيسية (27 أكتوبر 2026): نحو 3.2 إلى 3.5 GB من الذاكرة (RAM) وأقل من 10% من المعالج في الحمل العادي. يعمل المدقق براحة على 3 إلى 4 أنوية vCPU وذاكرة من 8 إلى 16 GB وتخزين NVMe. سرعة النواة الواحدة أهم من عدد الأنوية: التحقق من توقيعات ML-DSA-87 يمثّل نحو نصف عمل فحص المعاملة، ويبلغ ذروته تحت الحمل.

البندالملف المقترح للمدقق
المعالج4 vCPU، بتردد ساعة عالٍ
الذاكرة (RAM)16 GB
القرص100 GB أو أكثر، NVMe
الساعةمتزامنة عبر NTP (قاعدة الـ 60 ثانية أعلاه)
الشبكةيُفتح للعالم منفذ P2P ‏26656 فقط؛ وتُربط RPC وREST وEVM بـ localhost

يعتمد استخدام القرص على طريقة انضمامك. المدقق الذي انضم عبر مزامنة الحالة مع pruning = "custom" (keep-recent 100000) وindexer = "null" يشغل نحو 10 GB بعد شهرين. أما العقدة ذات التقليم الافتراضي التي تعمل منذ genesis فتشغل نحو 100 إلى 130 GB بعد أربعة أشهر. إن الـ 500 GB أو أكثر المقترحة لعقد RPC في تشغيل عقدة سخية بالنسبة إلى المدقق.


كيف تُدار الشبكة​

في 27 أكتوبر 2026 يوجد في الشبكة 8 مدققين نشطين، في عدة دول وعلى أكثر من مزوّد استضافة. تُخدَّم نقاط النهاية العامة (rpc.qore.host وapi.qore.host وevm.qore.host وsvm.qore.host) بواسطة عقد مخصصة غير مدققة خلف شبكة حافة (edge)، ولا تُخدَّم أبدًا بواسطة المدققين، ولا تُنشر عناوين IP الخاصة بالمدققين في DNS. تتبع قوة التصويت الحصة المربوطة: يبدأ المدقق الجديد ذو الحد الأدنى من الإيداع الذاتي بحصة صغيرة من القوة وتنمو مع وصول التفويضات.


إنشاء مدقق​

منح المشغّل: validator_operator​

يخضع create-validator لفحصين مستقلين، كلاهما مفروض على السلسلة، وأنت بحاجة إلى كليهما — فالإيداع الذاتي الكبير وحده لا يكفي:

  1. حد أدنى للإيداع الذاتي قدره 100,000 QOR.
  2. منح validator_operator فعّال على الحساب الذي يقدّم المعاملة.

تُصدر QoreChain Association هذا المنح على السلسلة عبر Validator Program: قدِّم طلبك في صفحة Nodes & Validators بلوحة التحكم (Tools Hub)، وشغّل مدققًا على الشبكة التجريبية diana خلال الفترة التجريبية البالغة 14 يومًا، وبعد اختيارك ادفع رسم البرنامج البالغ $1,000؛ ثم يُوقَّع المنح على دفعات لعنوان المشغّل الوارد في طلبك. تحقق من منحك عبر GET /qorechain/license/v1/check/{grantee}/validator_operator. قيمة expires_at في الترخيص هي ارتفاع كتلة (block height)، وليست تاريخًا أو مدة زمنية — القيمة 0 تعني بلا انتهاء صلاحية. إذا كان الترخيص مفقودًا أو منتهيًا، يفشل create-validator برسالة ErrUnauthorized بغضّ النظر عن مقدار الإيداع الذاتي؛ وهذا هو السبب الأكثر شيوعًا لفشل محاولة ممولة جيدًا دون تفسير واضح. توجد هذه البوابة تحديدًا لأن مسار تنفيذ EVM لا يمكنه رؤيتها أو فرضها (فوجود مُزيِّن (decorator) واحد في السلسلة هناك سيتيح تجاوزها بالكامل) — وهذا أحد أسباب بقاء التخزين والتحقق حصريًا على المسار الأصلي (Native).

أنشئ ملف validator.json (أُزيلت الصيغة المعتمدة على الأعلام في الإصدار الحالي من SDK):

{
"pubkey": {"@type": "/cosmos.crypto.ed25519.PubKey", "key": "<base64 key from: qorechaind comet show-validator>"},
"amount": "100000000000uqor",
"moniker": "my-validator",
"identity": "",
"website": "",
"security": "",
"details": "",
"commission-rate": "0.10",
"commission-max-rate": "0.20",
"commission-max-change-rate": "0.01",
"min-self-delegation": "1"
}

ثم أنشئ المعاملة ووقّعها (تحتاج إلى التوقيع الهجين مثل كل معاملة عبر مسار Cosmos؛ راجع أوامر المعاملات):

qorechaind tx staking create-validator validator.json \
--from mykey --chain-id qorechain-vladi \
--gas 600000 --fees 60000uqor \
--generate-only > tx.json

qorechaind tx pqc cosign tx.json --from mykey --pqc-key mypqc --chain-id qorechain-vladi

حد الرسوم في الشبكة هو 0.1 uqor لكل وحدة غاز، لذا يحتاج حد غاز قدره 600,000 إلى 60,000 uqor على الأقل.

حقل validator.jsonالوصف
amountمبلغ التفويض الذاتي — الحد الأدنى 100,000 QOR (100000000000uqor)
pubkeyالمفتاح العام لإجماع المدقق (ed25519)
monikerاسم مقروء يمثّل مدقّقك
commission-rateمعدل العمولة الأولي (مثال: 0.10 = 10%)
commission-max-rateالحد الأقصى لمعدل العمولة (ثابت بعد الإنشاء)
commission-max-change-rateالحد الأقصى للتغيير اليومي في معدل العمولة
min-self-delegationتعهدك بإبقاء هذا المقدار على الأقل مودعًا ذاتيًا (بوحدة uqor). وهو ليس الحد الأدنى البالغ 100,000 QOR على السلسلة، الذي ينطبق على amount

بعد تأكيد المعاملة، تحقق من مدقّقك:

qorechaind query staking validator $(qorechaind keys show mykey --bech val -a)

تصنيف المجمعات​

تصميم، وغير مفعّل بعد في إنتاج الكتل

تصنيف المجمعات أدناه هو تصميم x/qca. معاملاته على السلسلة (qorechaind query qca config)، لكن مقترحي الكتل لا يُختارون بعد بحسب المجمع، ولا تغيّر المجمعات المكافآت أو الخصم بعد.

تعرّف وحدة x/qca في QoreChain (تخصيص الإجماع الكمي) نظام تصنيف ثلاثي المجمعات. كل 1,000 كتلة (نحو 52 دقيقة عند كتل الشبكة الرئيسية البالغة 3.1 ثانية)، يُفترض أن تتم إعادة تصنيف المدققين إلى واحد من ثلاثة مجمعات بناءً على سمعتهم وحصتهم:

المجمعالمعاييرتخصيص الكتل
RPoS (إثبات الحصة القائم على السمعة)السمعة >= المئين السبعين والحصة >= الوسيط40% من الكتل
DPoS (إثبات الحصة المفوَّض)إجمالي التفويض >= 10,000 QOR35% من الكتل
PoS (إثبات الحصة)جميع المدققين النشطين المتبقين25% من الكتل

في التصميم، يتم اختيار مقترحي الكتل ضمن كل مجمع باستخدام اختيار عشوائي مرجَّح يتناسب مع حصتهم الفعّالة، بحيث يحصل المدققون ذوو السمعة العالية والتفويض المرتفع على تمثيل عادل، مع السماح في الوقت نفسه للمدققين الأصغر بالمشاركة.

الاستعلام عن إعدادات المجمعات​

# Pool weights and classification parameters (there is no per-validator classification query)
qorechaind query qca config

عبر JSON-RPC:

غير متاح بعد: لا يوجد أي إصدار منشور من العقدة يخدم فضاء الأسماء qor_ في JSON-RPC، لذا تُرجع هذه الدعوة -32601 (الطريقة غير موجودة) على كل نقطة نهاية عامة اليوم. راجع فضاء الأسماء qor_.

curl -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "qor_getPoolClassification",
"params": ["qorvaloper1..."],
"id": 1
}'

منحنى الربط (Bonding Curve)​

تصميم، وغير مفعّل بعد

منحنى الربط منفَّذ في x/qca لكنه غير موصول بعد بتوزيع المكافآت؛ فمكافآت التخزين اليوم تتبع وحدة التوزيع القياسية. الصيغة أدناه هي التصميم.

صُمِّم مقدار مكافأة التخزين للمدقق ليُحدَّد بواسطة منحنى ربط يدمج عوامل متعددة:

R = beta * S * (1 + alpha * log(1 + L)) * Q(r) * P(t)
المتغيرالوصف
Rمقدار المكافأة
betaمعدل المكافأة الأساسي
Sالحصة الفعّالة
alphaثابت تحجيم الولاء
Lمدة الولاء (زمن التخزين المستمر)
Q(r)عامل جودة السمعة، النطاق [0.75 - 1.25]
P(t)مضاعف مرحلة البروتوكول (يُعدَّل عبر دورة حياة الشبكة)

أبرز النقاط:

  • مكافأة مدة الولاء: يضيف التصميم حدًّا لوغاريتميًا لزمن التخزين المستمر.
  • عامل جودة السمعة: يتراوح من 0.75 (سمعة ضعيفة) إلى 1.25 (سمعة ممتازة). أوزان صيغة السمعة على السلسلة (qorechaind query reputation params).
  • مضاعف مرحلة البروتوكول: يُعدَّل مع نضج الشبكة عبر مراحل مختلفة (البدء، النمو، النضج).

الخصم (Slashing)​

عقوبات المخالفة الأساسية، القابلة للاستعلام حاليًا وقت كتابة هذا الدليل:

qorechaind query slashing params
المعاملالقيمة
نافذة الكتل الموقَّعة10,000 كتلة (نحو 8.7 ساعات على الشبكة الرئيسية عند 3.1 ثانية لكل كتلة؛ وأقصر على الشبكة التجريبية)
الحد الأدنى للتوقيع ضمن النافذة5% (min_signed_per_window = 0.05): يُسجَن المدقق عندما يوقّع أقل من 5% من آخر 10,000 كتلة، أي عندما يفوّت أكثر من 95%
مدة السجن عند التوقف عن العمل600 ثانية (10 دقائق)
نسبة الخصم عند التوقف عن العمل1% من الحصة
نسبة الخصم عند التوقيع المزدوج5% من الحصة

السجن هو مهلة ثابتة مدتها 10 دقائق بعقوبة ثابتة. يستغرق فك الربط 21 يومًا (1,814,400 ثانية)، وتضم المجموعة النشطة 100 مدقق كحد أقصى (max_validators)، ويمكن لكل مفوِّض أن يكون لديه 7 مدخلات فك ربط كحد أقصى (max_entries). النموذج التصاعدي أدناه تصميم منفصل يضيف عواقب إضافية متصاعدة فوق المخالفات المتكررة؛ وهو غير موصول بعد.

الخصم التصاعدي (Progressive Slashing)​

تصميم، وغير مفعّل بعد

الخصم التصاعدي منفَّذ في x/qca لكنه غير موصول بالخصم: العقوبات السارية هي قيم x/slashing القياسية في الجدول أعلاه. المعاملات أدناه هي التصميم (qorechaind query qca config).

يصعّد تصميم الخصم التصاعدي العقوبات على المخالفين المتكررين مع السماح للمدققين بالتعافي بمرور الوقت:

penalty = base_rate * escalation^effective_count * severity
المعاملالقيمة
الحد الأقصى للعقوبة لكل حدث33% من الحصة
عمر النصف للتحلل100,000 كتلة
شدة التوقف عن العمل1.0
شدة التوقيع المزدوج2.0
شدة هجوم العميل الخفيف3.0
  1. تزيد كل مخالفة العدد الفعّال. تؤدي كل مخالفة (توقف عن العمل، توقيع مزدوج، إلخ) إلى زيادة العدد الفعّال للمدقق، مما يؤثر على العقوبات المستقبلية.

  2. تتصاعد العقوبة أسّيًا. تتصاعد العقوبة بناءً على العدد الفعّال وفق الصيغة أعلاه، لذا يواجه المخالفون المتكررون عقوبات أكبر بكثير.

  3. يتحلل العدد الفعّال بمرور الوقت. يتحلل العدد الفعّال بعمر نصف قدره 100,000 كتلة (نحو 3.6 أيام عند كتل الشبكة الرئيسية البالغة 3.1 ثانية)، مما يسمح للمدققين بالتعافي بعد فترة من السلوك الجيد.

  4. الأحداث الفردية مقابل المخالفات المتكررة. يؤدي حدث توقف عرضي واحد إلى عقوبة طفيفة، بينما تؤدي المخالفات المتكررة إلى عواقب متصاعدة أسّيًا.


تسجيل مفتاح PQC​

سجّل مفتاحك العام لتشفير ما بعد الكم (PQC) (ML-DSA-87) قبل تشغيل create-validator، وفي أبكر وقت ممكن: تفحصه لوحة Validator Readiness منذ لحظة تقديم طلبك. هذا الأمر ليس اختياريًا وليس تلقائيًا: تتطلب السلسلة توقيع PQC هجينًا على كل معاملة عبر مسار Cosmos، وMsgCreateValidator ليس من أنواع الرسائل المستثناة، ولا يسجّل أي حساب مفتاحه تلقائيًا: التسجيل معاملة صريحة يجب على كل حساب (ومنه حسابات مشغّلي المدققين) أن يرسلها بنفسه مسبقًا. أنشئ المفتاح أولًا:

qorechaind tx pqc gen-key mypqc # prints the public key (hex); stored unencrypted under ~/.qorechaind/pqc/
qorechaind tx pqc register-key-v2 dilithium5 <pubkey-hex> hybrid \
--from mykey \
--pqc-key mypqc \
--chain-id qorechain-vladi \
--gas 600000 --fees 60000uqor \
-y

يُرفق --pqc-key mypqc إثبات حيازة (proof of possession): يوقّع المفتاح السلسلة qorechain-pqc-pop-v1|chainid|algo|address|hex(pubkey) وتتحقق منها السلسلة، فلا يستطيع أحد تسجيل مفتاح عام لا يملك نصفه الخاص. وهو اختياري في v3.2.3 ومُوصى به. ومن v3.2.4 (الشبكة الرئيسية منذ 23 أكتوبر 2026، والشبكة التجريبية منذ 19 أكتوبر 2026) يُبلغ سجل الحساب أيضًا عمّا إذا جرى التحقق من إثبات (possession_proven، في GET /qorechain/pqc/v1/account/{address}).

ما الذي غيّره v3.2.3 في تسجيل المفاتيح
  • الحساب الذي لا يملك مفتاحًا مسجّلًا لا يمكنه إرسال سوى معاملة التسجيل نفسها: تُرفض أي معاملة أخرى تحمل امتداد توقيع هجين. سجّل أولًا، ثم وقّع كل ما عدا ذلك بالأمر tx pqc cosign.
  • تُرفض عند التسجيل المفاتيح من نوع classical_only والمفاتيح الفارغة والمعيبة (degenerate).
  • بمجرد أن يملك الحساب مفتاحًا، يجب أن تكون أي صيانة لاحقة للمفتاح (التدوير، والترحيل، وإعادة التسجيل) موقَّعة توقيعًا هجينًا هي نفسها، ولا يمكن إرسالها عبر authz.
  • لا يستبدل tx pqc gen-key أبدًا ملف مفتاح موجودًا.
المعاملالوصف
dilithium5الخوارزمية (ML-DSA-87)
<pubkey-hex>مفتاح عام من نوع ML-DSA-87 بحجم 2592 بايت بترميز hex
hybridنوع المفتاح (هجين = كلاسيكي + PQC معًا)

(الأمر qorechaind tx pqc register-key <pubkey-hex> hybrid هو الصيغة القديمة المكافئة لخوارزمية Dilithium-5.)

اضبط --gas صراحةً

المفتاح العام ML-DSA-87 بحجم 2,592 بايت، وكتابته على السلسلة قد تتجاوز حد الغاز الافتراضي البالغ 200,000 (استهلكت عمليات التسجيل على الشبكة الرئيسية ما بين 220,000 و350,000 غاز). دون --gas 600000 (أو أعلى)، قد تفشل المعاملة برسالة خطأ غامضة out of gas. يجب أن تكون الرسوم على الأقل حد الغاز مضروبًا في 0.1 uqor، لذا يحتاج --gas 600000 إلى --fees 60000uqor أو أكثر.

تحقق من التسجيل:

qorechaind query pqc account <account-address>

ملف المفتاح الموجود تحت ~/.qorechaind/pqc/ هو مفتاح التوقيع ما بعد الكمي للحساب: احتفظ بنسخة احتياطية منه كما تفعل مع العبارة الاستعادية (mnemonic)، وأبقه بعيدًا قدر الإمكان عن الجهاز الذي يشغّل مفتاح الإجماع. راجع التوقيع ما بعد الكمي للاستعادة والتدوير.


المراقبة​

مقاييس Prometheus​

تعرض QoreChain مقاييس Prometheus على المنفذ 26660:

http://localhost:26660/metrics

فعّل نقطة النهاية بإضافة prometheus = true في القسم [instrumentation] من config.toml. تعرض العقدة المقاييس القياسية لمحرك الإجماع (ارتفاع الكتلة، وجولات الإجماع، ومجموعة المدققين، والأقران، ومجمّع المعاملات mempool)؛ اعرض ما تخدمه عقدتك بالأمر curl -s localhost:26660/metrics | grep -i -E 'height|validator|peers|mempool'. تُقرأ سلامة التوقيع لكل مدقق على نحو أكثر موثوقية من السلسلة نفسها (راجع فحوصات السلامة أدناه)، لأن سجل السلسلة نفسه هو ما يقرر السجن.

الاستعلام عن معاملات السمعة​

# Formula weights only (there is no per-validator score query)
qorechaind query reputation params

عبر JSON-RPC:

غير متاح بعد: لا يوجد أي إصدار منشور من العقدة يخدم فضاء الأسماء qor_ في JSON-RPC، لذا تُرجع هذه الدعوة -32601 (الطريقة غير موجودة) على كل نقطة نهاية عامة اليوم. راجع فضاء الأسماء qor_.

curl -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "qor_getReputationScore",
"params": ["qorvaloper1..."],
"id": 1
}'

فحوصات السلامة​

# Node status
qorechaind status | jq '.sync_info'

# Validator signing info (uptime, missed blocks)
qorechaind query slashing signing-info $(qorechaind comet show-validator)

# Check if your validator is in the active set
qorechaind query staking validators --status BOND_STATUS_BONDED | grep "my-validator"

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

  1. استخدم بنية عقد الحراسة (sentry nodes). شغّل مدقّقك خلف عقد حراسة لحمايته من هجمات DDoS. اكشف فقط عقد الحراسة للشبكة العامة.

  2. أعدّ نظام تنبيهات. اضبط تنبيهات للكتل الفائتة، وانخفاض وقت التشغيل، وإعادة التشغيل غير المتوقعة. فوات بضع كتل أمر طبيعي؛ أما الفوات المستمر فسيؤدي إلى الخصم.

  3. حافظ على وقت تشغيل مرتفع. يؤدي التوقف الممتد إلى سجن المدقق (توقيع أقل من 5% من آخر 10,000 كتلة) وخصم جزء من حصته؛ راجع الخصم.

  4. حافظ على تحديث البرمجيات. تابع إصدارات QoreChain وطبّق التحديثات فورًا. نسّق مع مجتمع المدققين عند ترقيات السلسلة.

  5. أمّن مفاتيحك. احمِ مفتاح إجماع المدقق (priv_validator_key.json) واحتفظ بنسخ احتياطية غير متصلة بالإنترنت؛ وفكّر في استخدام موقّع عن بُعد. لم يُتحقَّق من التوقيع عن بُعد (priv_validator_laddr) مع الملف الثنائي الرسمي qorechaind، ولا تغيّر وحدة ما بعد الكم نوع مفتاح الإجماع (ed25519)، فاختبر أي إعداد لموقّع على الشبكة التجريبية قبل أن تعتمد عليه. أبقِ مفاتيح حساب المشغّل وملف مفتاح PQC الخاص به بعيدًا عن الجهاز الذي يشغّل المدقق قدر الإمكان.

  6. سجّل مفتاح PQC أولًا. يحتاج حساب المشغّل إلى مفتاح ML-DSA-87 مسجَّل قبل أن يتمكن من إنشاء مدقق أو إرسال أي معاملة أخرى عبر مسار Cosmos.

  7. أبقِ الساعة متزامنة. شغّل عميل NTP؛ اعتبارًا من v3.2.1 تتوقف العقدة عندما تنحرف ساعتها بأكثر من 60 ثانية.


مرجع أوامر المدقق​

# Edit validator metadata
qorechaind tx staking edit-validator \
--new-moniker "new-name" \
--website "https://myvalidator.com" \
--details "Description of my validator" \
--from mykey --gas 400000 --fees 40000uqor --generate-only > tx.json

# Unjail after downtime slashing
qorechaind tx slashing unjail --from mykey --gas 300000 --fees 30000uqor --generate-only > tx.json

# Delegate additional stake
qorechaind tx staking delegate $(qorechaind keys show mykey --bech val -a) \
500000000uqor --from mykey --gas 400000 --fees 40000uqor --generate-only > tx.json

# Withdraw rewards and commission
qorechaind tx distribution withdraw-rewards $(qorechaind keys show mykey --bech val -a) \
--commission --from mykey --gas 400000 --fees 40000uqor --generate-only > tx.json

# Sign and broadcast any of the above (hybrid signature):
qorechaind tx pqc cosign tx.json --from mykey --pqc-key mypqc --chain-id qorechain-vladi

حد الرسوم في الشبكة هو 0.1 uqor لكل وحدة غاز. يمكن لحساب مشغّل ليس لديه مفتاح PQC مسجَّل أن يرسل unjail بالطريقة الكلاسيكية؛ أما بعد تسجيل مفتاح، فتحتاج كل معاملة (ومنها unjail) إلى التوقيع الهجين.


التحقق من الشبكات المتصلة​

لا توجد شبكة متصلة فعّالة بعد

وحدة الجسر منشورة على الشبكة الرئيسية والتجريبية، لكن لا يوجد أي مسار جسر فعّال: جميع إعدادات السلاسل البالغ عددها 37 في حالة pending، ولا يوجد مدققو جسر مسجَّلون، ولم تُنشأ أي عملية جسر قط، ولا توجد قناة IBC مفتوحة على الشبكة الرئيسية (في الشبكة التجريبية قناة تحويل واحدة، وليست مسار جسر). يصف الإطار أدناه التصميم؛ ولا يوجد شيء للتحقق منه على شبكة متصلة اليوم.

يتيح التصميم (منذ إصدار السلسلة v3.1.80) لمدقق QoreChain أيضًا المساعدة في التحقق من الشبكات المتصلة عبر الجسر. هذا الأمر مقيّد بترخيص واختياري:

  1. امتلك الترخيص. يجب أن يمتلك المدقق ترخيصًا فعّالًا من نوع validator_<chain> (أو qcb_bridge) للشبكة المستهدفة. يرفض المنسّق تشغيل عميل خارجي دون ذلك (فشل مغلق).
  2. يوفّر التفعيل العميل تلقائيًا. عند تفعيل الترخيص، توفّر QoreChain عميل الشبكة المطابقة على عقدتك — بتنزيل العميل المثبَّت، وإنشاء إعداداته، وتشغيله تحت إشراف تنسيق QoreChain. لا يتم جلب أي شيء قبل التفعيل.
  3. زوّد مفاتيح وحصة الشبكة. مفاتيح المدقق/الحصة والتوقيع الخاصة بالشبكة الخارجية يوفّرها المشغّل لكل شبكة؛ توفّر QoreChain إطار عمل المشغّلات وبوابة الترخيص المفروضة، وليس حصتك في السلسلة الخارجية.

توجد مشغّلات لجميع شبكات الجسر البالغ عددها 37، مصنَّفة حسب طريقة مشاركة المدقق:

الفئةالمشاركةأمثلة
مدقق بلا إذنالتخزين والتشغيلSolana, Ethereum, Avalanche, Sui, Aptos, Cardano, Tezos, Algorand, Starknet
محدود / بالانتخاب / بالقبولالتخزين، خاضع لحد أقصى أو انتخابBSC, Polygon, Polkadot, TRON, Sei, Injective, NEAR, Hedera
عقدة كاملة من الطبقة الثانية (L2)تشغيل عقدة كاملة (بدون تخزين)Optimism, Base, zkSync Era, Linea, Scroll, Arbitrum
بدون تخزين / قائمة ثقةالمراقبة / المشاركة بدون تخزينBitcoin, Filecoin, XRPL, Stellar
ملاحظة

تثبيت إصدارات العميل (client version pins) هو أفضل جهد ممكن؛ تحقق من إصدار العميل الرسمي (upstream) لشبكتك المستهدفة قبل أي تفعيل في بيئة الإنتاج.

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