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

كيف يرتبط مفتاحك ما بعد الكمّي بحسابك

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

الفكرة في صورة واحدة​

عبارة الاسترداد (أو رمز الاسترداد)
|
v
اشتقاق المفتاحين
- المفتاح الكلاسيكي (secp256k1)
- المفتاح ما بعد الكمّي (ML-DSA-87)، مرتبط بعنوان حسابك
|
v
التسجيل مرة واحدة، مع إثبات الحيازة
|
v
كل معاملة تُوقَّع توقيعًا هجينًا (بالمفتاحين)
|
v
المدقّقون يتحققون من التوقيعين

كلمات تُستخدم في هذه الصفحة​

الكلمةمعناها
المفتاح الكلاسيكيمفتاح حسابك العادي (secp256k1). يوقّع كل معاملة على كل سلسلة كتل من هذا النوع.
مفتاح ML-DSA-87مفتاح التوقيع ما بعد الكمّي. لا يُتوقَّع أن يكسره حاسوب كمّي في المستقبل.
عبارة الاسترداد (mnemonic)الكلمات الـ 12 أو الـ 24 التي تستعيد الحساب.
رمز الاستردادسطر يبدأ بـ QRC1. يحل محل عبارة الاسترداد للمفتاح ما بعد الكمّي عندما يأتي حسابك من مفتاح خاص مجرّد.
التسجيلمعاملة واحدة تخبر السلسلة أي مفتاح ML-DSA-87 يخص حسابك.
إثبات الحيازةتوقيع يُظهر أنك تملك فعلًا النصف السري من المفتاح الذي تسجّله.
التوقيع الهجينالتوقيعان معًا على معاملة واحدة.

1. اشتقاق لا توليد​

لا يُختار المفتاح ما بعد الكمّي عشوائيًا ثم يُحفظ في ملف قد تفقده. بل هو مشتق: المدخل نفسه يعطي المفتاح نفسه دائمًا.

  • مع عبارة الاسترداد. يأتي مفتاح ML-DSA-87 من عبارة الاسترداد نفسها التي يأتي منها المفتاح الكلاسيكي، مع عنوان حسابك. يُعاد بناء المفتاحين معًا من العبارة، لذلك نسخة احتياطية واحدة تستعيدهما معًا. هذا ما يفعله QoreX والحساب الموحّد في الـ SDK.
  • مع مفتاح خاص مجرّد. لا يستطيع المفتاح الخاص وحده أن يعطي مفتاحًا ثانيًا. عندها يُصنع المفتاح ما بعد الكمّي من رمز استرداد منفصل يبدأ بـ QRC1. في مشروع الورشة 1 تنشئه بالأمر pnpm window recovery-code. وفي الـ SDK هو generatePqcRecoveryCode().

ثلاث قواعد لرمز الاسترداد:

  1. احفظه بعيدًا عن المفتاح الخاص. إن كان الاثنان في مكان واحد فسرقة واحدة تأخذهما معًا.
  2. أعد استخدام الرمز نفسه دائمًا للحساب نفسه.
  3. رمز مختلف يعطي مفتاحًا مختلفًا. عندها ترى السلسلة مفتاحًا لا يطابق الذي سجّلته.
لا يمكن إعادة بناء رمز الاسترداد

لا توجد طريقة لاستعادة رمز استرداد ضائع. اكتبه على ورقة عند إنشائه. الاستثناء هو حسابات الشبكة التجريبية المؤقتة: يمكنك إنشاء حساب جديد في دقيقة.

2. اربط مرة واحدة، مع إثبات الحيازة​

الربط معاملة واحدة تُرسل مرة واحدة لكل حساب، واسمها MsgRegisterPQCKeyV2. وهي تحمل:

  • المفتاح العام لـ ML-DSA-87 (2,592 بايت)، و
  • إثبات حيازة: يوقّع المفتاح نصًا قصيرًا يذكر السلسلة وحسابك. لا يستطيع أحد ربط مفتاح لا يملكه، ولا يستطيع أحد نسخ ربط من سلسلة أخرى.

هذه هي الرسالة الوحيدة التي تقبلها السلسلة بالتوقيع الكلاسيكي وحده. والسبب بسيط: قبلها لا يوجد في السلسلة مفتاح ما بعد كمّي مسجّل لحسابك، فلا شيء يُفحص به توقيع ثانٍ.

كيف تفعل ذلك:

أينكيف
QoreXتلقائيًا عند أول إرسال. ويكلّف رسمًا لمرة واحدة نحو 0.09 QOR.
الورشة 1 والتطبيقات التجريبيةpnpm window register (الخطوة 5 من دليل الورشة 1).
شيفرتك أنتالدالة ensurePqcRegistered في الـ SDK.

يمكن استدعاء ensurePqcRegistered مرة أخرى بأمان. فهي تقرأ حسابك أولًا. إن كان مفتاحك مربوطًا فلا ترسل شيئًا. وإن كان مربوطًا مفتاح مختلف فتتوقف بالخطأ PqcKeyMismatchError ولا ترسل شيئًا. وإن أرسلت تسجيلًا ثانيًا يدويًا فترفضه السلسلة وتأخذ الرسم مع ذلك، لذلك دع المساعد يجري الفحص.

ما تطلبه السلسلة اليوم

تفحص السلسلة إثبات الحيازة كلما وُجد، وترفض التسجيل إن لم يتحقق. ويرفق الـ SDK وQoreX إثباتًا تلقائيًا. على الشبكة الرئيسية ما زال التسجيل بلا إثبات مقبولًا. وعلى الشبكة التجريبية، ابتداءً من الإصدار v3.2.8، يجب أن تكون أول معاملة لحساب جديد هي هذا التسجيل. التفاصيل: التوقيع ما بعد الكمّي.

3. بعد الربط، كل شيء هجين​

من ذلك الحين تحمل كل معاملة أصلية توقيعين:

  • التوقيع الكلاسيكي secp256k1 (64 بايت)، و
  • توقيع ML-DSA-87 (4,627 بايت) في إضافة اسمها PQCHybridSignature.

يتحقق المدقّقون من الاثنين. وعندما يفعلون تسجّل السلسلة الحدث pqc_hybrid_verify بالحالة verified.

وبلا مفتاح مسجّل تُرفض المعاملة بالرسالة account has no PQC key and classical fallback is disabled.

المعاملات على مسار EVM (مثل نشر عقد) تحتاج إلى شيء إضافي: نافذة تفويض EVM تُفتح برسالة موقّعة توقيعًا هجينًا. راجع مرجع نافذة EVM.

تحقق بنفسك​

تحتاج إلى curl. أما jq فاختياري. وكلاهما مشروح في قبل أن تبدأ.

هل مفتاحي مسجّل؟​

  1. استبدل qor1... بعنوانك أنت ثم شغّل:
curl -s https://api-testnet.qore.host/qorechain/pqc/v1/account/qor1...

ما يفعله: يسأل الخادم العام للشبكة التجريبية عن سجل المفتاح لحسابك.

المعاملات:

  • curl: برنامج يجلب عنوان ويب.
  • -s: صامت، فيخفي شريط التقدم ويعرض الإجابة فقط.
  • https://api-testnet.qore.host/qorechain/pqc/v1/account/qor1...: عنوان REST للشبكة التجريبية، يليه حسابك.

ما ينبغي أن تراه: لحساب مسجّل، إجابة مثل هذه (الأماكن المحجوزة ظاهرة، وإجابتك فيها قيم حقيقية):

{
"found": true,
"account": {
"address": "qor1...",
"public_key": "<base64 ML-DSA-87 public key>",
"algorithm_id": 1,
"algorithm_name": "dilithium5",
"ecdsa_pubkey": "<your classical public key>",
"key_type": "hybrid",
"created_at_height": "<block height>",
"migration_public_key": null,
"migration_algorithm_id": 0,
"classical_key_source": "auth_account",
"possession_proven": true
}
}

تكون found قيمتها true عندما يكون مفتاح مربوطًا، وfalse عندما لا يكون. وتكون possession_proven قيمتها true عندما سُجّل المفتاح بإثبات حيازة متحقَّق منه.

هل وُقّعت معاملتي توقيعًا هجينًا؟​

هذا هو الفحص نفسه من الورشة 1، الخطوة 6.

  1. استبدل <HASH> بتجزئة إحدى معاملاتك (بدون < و>) ثم شغّل:
curl -s https://api-testnet.qore.host/cosmos/tx/v1beta1/txs/<HASH>

ما يفعله: يسأل الخادم العام للشبكة التجريبية عن السجل الكامل لمعاملتك.

ما ينبغي أن تراه: كتلة نص طويلة. ابحث عن ثلاثة أشياء:

  1. "code": 0 داخل tx_response. الرمز 0 يعني النجاح.

  2. إضافة PQCHybridSignature التي تحمل توقيع ML-DSA-87: 4,627 بايت، بجانب توقيع secp256k1 ذي الـ 64 بايت.

  3. في events، حدث من النوع pqc_hybrid_verify وسمته status تساوي verified.

  4. لطباعة هذا الحدث وحده (يحتاج إلى jq):

curl -s https://api-testnet.qore.host/cosmos/tx/v1beta1/txs/<HASH> | jq '.tx_response.events[] | select(.type=="pqc_hybrid_verify")'

ما يفعله: يجلب السجل نفسه ويمرّره عبر jq الذي يُبقي حدث التحقق فقط.

ما ينبغي أن تراه: حدث واحد تساوي سمة status فيه verified.

  • مفاتيح التشفير. مفاتيح ML-KEM-1024، التي يستخدمها QoreSeal لتشفير البيانات لحساب ما، تقع في سجل منفصل. تنشر المفتاح بالرسالة MsgRegisterKEMKey في معاملة موقّعة توقيعًا هجينًا، لذلك يجب أن يملك الحساب مفتاح ML-DSA-87 الخاص به مسبقًا.
  • تغيير مفتاح التوقيع. الرسالة MsgRotatePQCKey تستبدل مفتاح ML-DSA-87 بآخر جديد من النوع نفسه، مثلًا للتخلص من مفتاح مخترَق. والرسالة MsgMigratePQCKey تنقل من خوارزمية إلى أخرى. كلتاهما تحتاج إلى توقيعين من المفتاح القديم والجديد، وترفض السلسلة مفتاحًا استخدمه الحساب من قبل. وكلتاهما تعملان على الشبكة الرئيسية والتجريبية. القواعد الكاملة: التوقيع ما بعد الكمّي.

استكشاف الأخطاء​

ما تراهالسببما تفعله
account has no PQC key and classical fallback is disabledلم يسجّل الحساب مفتاح ML-DSA-87 بعد.سجّل أولًا (pnpm window register، أو أول إرسال في QoreX، أو ensurePqcRegistered) ثم أرسل مجددًا. تحقق باستعلام الحساب أعلاه.
PqcKeyMismatchError، أو registered, but NOT this key في pnpm window statusمفتاح مختلف مربوط أصلًا. استخدمت رمز استرداد أو عبارة غير التي استخدمتها أول مرة.أعد رمز الاسترداد أو العبارة الأصلية. وللحساب المؤقت، ابدأ من جديد بحساب جديد.
رُفض التسجيل لأنه مسجّل أصلًايملك الحساب مفتاحًا بالفعل. والتسجيل الثاني الخام ما زال يأخذ الرسم.لا تفعل شيئًا. اقرأ الحساب باستعلام أعلاه، أو استخدم ensurePqcRegistered الذي يفحص أولًا.
ضاع رمز الاستردادلا يمكن إعادة بنائه من المفتاح الخاص.إن كان الحساب من عبارة استرداد فاستخدم العبارة نفسها: تعطي المفتاح نفسه. وإلا فاستخدم حسابًا جديدًا. وعلى الشبكة التجريبية لا يكلّف ذلك شيئًا.
يفشل التسجيل برسالة عن الرسم أو الرصيديملك الحساب QOR أقل من اللازم للرسم (نحو 0.09 QOR)، أو الرسم دون الحد الأدنى للشبكة وهو 0.1 uqor لكل وحدة غاز.احصل على QOR من الحنفية، واضبط الغاز على نحو 600,000 للتسجيل اليدوي، ثم حاول مجددًا.
found تساوي false رغم أنك سجّلتتسأل الشبكة الخطأ، أو العنوان الخطأ.تأكد أنك تستخدم api-testnet.qore.host للشبكة التجريبية وعنوانك أنت qor1.... قد تعرض المحفظة شبكة غير شبكة مشروعك.
يجيب الحساب found: true لكن معاملاتك تفشلالمفتاح على السلسلة ليس الذي يشتقه مشروعك.شغّل pnpm window status وقارن مع رمز الاسترداد في .env.

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

ارجع إلى دليل الورشة 1 وسجّل مفتاحك، أو اقرأ النظرة العامة.