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

نشر Rollup

يمكنك إعداد rollup مخصص للتطبيقات بثلاث طرق: عبر لوحة التحكم (Dashboard) (نموذج طلب، وليس معاملة على السلسلة)، أو عبر واجهة سطر الأوامر (CLI) الخاصة بالسلسلة (qorechaind، مع تحكم كامل في المعاملة على السلسلة)، أو باستخدام TypeScript RDK (‏@qorechain/rdk بالإضافة إلى أداة التهيئة create-qorechain-rollup)، التي تغطي التكوين وعمليات القراءة، وعند منحها مفتاحًا ما بعد كمّي، المعاملات الموقَّعة توقيعًا هجينًا (راجع RDK 0.8.0: التغييرات والحدود). تغطي هذه الصفحة الطرق الثلاث، بالإضافة إلى دورة حياة المشغّل وأوامر الدفعات.

قدرة في مرحلة مبكرة

لم يتم إنشاء أي rollup على الشبكة الرئيسية (أرجع GET /qorechain/rdk/v1/rollups قائمة فارغة في 12 نوفمبر 2026)؛ وآخر فحص لشبكة الاختبار كان في 30 أكتوبر 2026 ولم تكن تحوي أيًّا منها. تستخدم الأوامر أدناه شبكة الاختبار qorechain-diana (معرّف سلسلة EVM 9800، إصدار السلسلة v3.2.8: طُبّق v3.2.4 عليها في 19 أكتوبر 2026، وv3.2.5 في 26 أكتوبر عند الارتفاع 8,890,800، وv3.2.6 في 27 أكتوبر عند الارتفاع 8,970,638، وv3.2.7 في 6 نوفمبر عند الارتفاع 9,594,600، وv3.2.8 في 12 نوفمبر عند الارتفاع 9,929,500؛ وv3.2.8 ليس على الشبكة الرئيسية). تعمل الشبكة الرئيسية (qorechain-vladi، معرّف سلسلة EVM 9801، حية منذ 7 يونيو 2026) على إصدار السلسلة v3.2.7 منذ 12 نوفمبر 2026 (طُبّق عند الارتفاع 4,164,600 بمقترح الحوكمة 16؛ وطُبّق v3.2.6 عند الارتفاع 4,020,000 في 4 نوفمبر 2026 بالمقترح 15؛ وطُبّق v3.2.5 عند الارتفاع 3,906,833 في 29 أكتوبر 2026 بالمقترح 14، وv3.2.4 عند الارتفاع 3,742,566 في 23 أكتوبر 2026 بالمقترح 13)، ولذلك فما يغيّره v3.2.5 في حق الـ rollups موسوم بعبارة "اعتبارًا من v3.2.5" وينطبق على الشبكتين (يوجد جدول ملخص في نظرة عامة على الـ Rollups). وتختلف الإصدارات السابقة في بعض التفاصيل، وتصفها هذه الصفحة بعبارة "اعتبارًا من v3.2.4". وشبكة الاختبار شبكة تجريبية لها معاملات وحداتها الخاصة (مثلًا نافذة اعتراض افتراضية مدتها 3,600 ثانية مقابل 604,800 على الشبكة الرئيسية، وحد أقصى 200 rollup مقابل 100)؛ اقرأ GET /qorechain/rdk/v1/params على الشبكة التي تستهدفها. تحقق من كل عملية نشر على شبكة الاختبار أولاً.

الرسوم والتوقيع

تفرض الشبكة حدًا أدنى لسعر الغاز قدره 0.1uqor، لذا يُرفض الأمر المجرّد --fees 500uqor، وتحتاج كل معاملة على المسار الأصلي إلى التوقيع المشترك الهجين ما بعد الكمّي. ولهذا تبني أمثلة CLI في هذه الصفحة المعاملة باستخدام --generate-only وتوقّعها توقيعًا مشتركًا عبر qorechaind tx pqc cosign، الذي يوقّعها ويبثّها (أنشئ المفتاح مرة واحدة عبر qorechaind tx pqc gen-key، وسجّله على السلسلة مرة واحدة عبر qorechaind tx pqc register-key، أو عبر QoreX أو SDK اللذين يتوليان ذلك عنك). تُثبَّت الرسوم عند توليد الملف غير الموقَّع، لذا اضبط حد الغاز والرسوم معًا: يجب ألا تقل الرسوم عن حد الغاز × 0.1 uqor. حدود الغاز أدناه إرشادية — قم بالمحاكاة قبل الاعتماد عليها. راجع أول معاملة والتوقيع ما بعد الكمّي.


المتطلبات​

المتطلبالتفاصيل
الحد الأدنى للحصة (stake)ما لا يقل عن 10,000 QOR (‏min_stake_for_rollup)؛ تُحجز الحصة في الضمان عند إنشاء الـ rollup
حرق الإنشاءيُحرق 1 % من الحصة التي تقدّمها نهائيًا عند الإنشاء (يُرفض أي إنشاء لا يمكن تطبيق الحرق عليه)؛ ويُحتفظ بالباقي في الضمان ويُعاد عند إيقاف الـ rollup
حصة تسجيل الطبقة (layer)يسجّل الإنشاء أيضًا طبقة الـ rollup في وحدة multilayer، مما يحجز 1,000 QOR إضافية (‏min_sidechain_stake) من المنشئ، وتُعاد عند إخراج الطبقة من الخدمة عند الإيقاف. إذا تعذّر تسجيل الطبقة (الرصيد غير كافٍ، أو بلوغ حد السلاسل الجانبية في multilayer وهو 10) يُنشأ الـ rollup مع ذلك لكن دون طبقة، فلا يمكن تثبيت دفعاته
معرّف الـ rollupاستخدم من 3 إلى 64 حرفًا: أحرف إنجليزية صغيرة وأرقام و. و_ و-، على أن يبدأ بحرف أو رقم. تفرض السلسلة هذه القاعدة على الشبكتين منذ v3.2.2 (تتحقق منها واجهة CLI قبل بناء المعاملة)، لذا يُرفض أي معرّف غير مطابق
الحسابحساب QoreChain ممول وله مفتاح مسجّل ما بعد كمّي، برصيد كافٍ للحصة وحصة الطبقة ورسوم المعاملات

استعلم عن معاملات الوحدة الحية لمعرفة الحد الأدنى الحالي للحصة ومعدل الحرق قبل النشر:

qorechaind query rdk config

النشر عبر لوحة التحكم (Tools → Rollups)​

توفر لوحة التحكم نموذج Deploy a Rollup ضمن Tools → Rollups. وهو نموذج طلب: يؤدي إرساله إلى تسجيل طلب تزويد لحسابك، تراجعه The Qore Trust، ويعرض الطلب الجديد حالة provisioning. وهو لا يبثّ معاملة create-rollup على السلسلة — لتسجيل rollup على السلسلة، استخدم واجهة سطر الأوامر أدناه.

الخطوات​

  1. سجّل الدخول. يتطلب النموذج جلسة مصادَق عليها لإرسال طلب ولعرض طلباتك الحالية.
  2. سمِّ الـ rollup الخاص بك. أدخل اسمًا للـ rollup (من 2 إلى 41 حرفًا: حروف، أرقام، مسافات، شرطات، أو شرطات سفلية).
  3. اختر آلة افتراضية. يخزّن السجل على السلسلة تسمية للآلة الافتراضية. يُنفَّذ الـ rollup الخاص بك خارج السلسلة في بيئة تشغيل خاصة به؛ ولا يعمل الاختيار على مسارات EVM أو QoreChain Native أو SVM الخاصة بـ QoreChain نفسها:
    • EVM — عقود Solidity / Vyper مع كامل أدوات Ethereum ‏(Hardhat، Foundry، MetaMask)
    • QoreChain Native — عقود ذكية بلغة Rust على بيئة تشغيل Cosmos SDK (بيئة تشغيل CosmWasm)، مع دعم IBC أصلي
    • SVM — آلة Solana الافتراضية، للتطبيقات ذات التنفيذ المتوازي والإنتاجية العالية
  4. اختر طبقة توفر البيانات (DA). المكان الذي ينشر فيه الـ rollup بيانات المعاملات بحيث يمكن لأي شخص إعادة بناء الحالة: QoreChain DA أو Celestia أو EigenDA. لاحظ أن EigenDA خيار على مستوى لوحة التحكم، بينما خلفيات DA الخاصة بوحدة x/rdk على السلسلة هي: الأصلية (native)، أو Celestia، أو كلاهما — راجع توفر البيانات.
  5. حدد عملة الغاز. العملة المستخدمة لدفع تكاليف التنفيذ على الـ rollup الخاص بك. القيمة الافتراضية هي QOR؛ أدخل رمزًا مخصصًا لاستخدام عملتك الأصلية الخاصة.
  6. اختر المُرتِّب (sequencer). الجهة التي ترتّب المعاملات قبل التسوية: مرتِّب مشترك (المجموعة المشتركة لـ QoreChain)، أو مخصص (فردي) (تشغيل مرتِّب فردي خاص بك)، أو لامركزي (مجموعة مرتِّبات بلا إذن مسبق).
  7. اختر هدف التسوية. المكان الذي يثبّت فيه الـ rollup جذور حالته وبراهين صحته: الشبكة الرئيسية لـ QoreChain أو Ethereum.
  8. أرسل الطلب. تتم مراجعة التزويد من قِبل The Qore Trust، لذا يظهر الطلب المرسل حديثًا بحالة provisioning حتى اكتمال المراجعة.

تظهر الطلبات التي أرسلتها في قائمة Your rollups مع الآلة الافتراضية، وطبقة DA، وعملة الغاز، والمرتِّب، وهدف التسوية، والحالة الحالية.

ملاحظة

تصف خيارات النموذج (الآلة الافتراضية، وطبقة توفر البيانات، وعملة الغاز، والمرتِّب، وهدف التسوية) ما تطلبه؛ وهي أوسع مما تدعمه وحدة x/rdk على السلسلة حاليًا. على السلسلة، يكون توفر البيانات native (‏Celestia غير نشط)، ويتم الترتيب بواسطة منشئ الـ rollup أو عنوان مرتِّب مهيَّأ. راجع توفر البيانات.


النشر عبر واجهة سطر الأوامر (CLI)​

تنشئ واجهة سطر الأوامر الـ rollup مباشرة على السلسلة. يأخذ الأمر create-rollup ثلاث وسائط موضعية — معرّف الـ rollup، وملف تعريف (profile)، ومقدار الحصة (بوحدة uqor) — بالإضافة إلى علم اختياري --vm.

تلميح

اعتبارًا من إصدار السلسلة v3.1.74، يقوم create-rollup بتطبيق الإعداد المسبق لملف التعريف المختار تلقائيًا — إذ تؤخذ جميع إعدادات وضع التسوية والمرتِّب وDA ونموذج الغاز والآلة الافتراضية من الإعداد المسبق. لم تعد بحاجة إلى ضبطها يدويًا (سابقًا كانت الرسالة تفرض تكوينًا سياديًا مثبتًا). العلم --vm أصبح الآن فارغًا افتراضيًا، لذا تُطبَّق الآلة الافتراضية لملف التعريف ما لم تتجاوزها صراحة.

qorechaind tx rdk create-rollup [rollup-id] [profile] [stake-amount] \
--from mykey \
--chain-id qorechain-diana \
--gas 600000 --fees 60000uqor \
--generate-only > create-rollup.json

مثال — إنشاء rollup من الإعداد المسبق defi (التسوية والمرتِّب وDA والآلة الافتراضية تأتي كلها من الإعداد المسبق؛ يُحلّ defi إلى تسوية zk على EVM). ابنِ المعاملة غير الموقَّعة، ثم أرفق التوقيع المشترك ما بعد الكمّي وابثّها:

# 1. Build the unsigned transaction (10,000 QOR stake)
qorechaind tx rdk create-rollup my-defi-rollup defi 10000000000 \
--from mykey \
--chain-id qorechain-diana \
--gas 600000 --fees 60000uqor \
--generate-only > create-rollup.json

# 2. Cosign with your post-quantum key and broadcast
qorechaind tx pqc cosign create-rollup.json \
--from mykey --pqc-key mypqckey --chain-id qorechain-diana

لا تنشئ rollup من نوع defi (ZK) على الشبكة الرئيسية بعد. تقبل السلسلة الإنشاء وتحجز الحصة في الضمان. ورسائل مفتاح التحقق مفعَّلة على الشبكة الرئيسية منذ إصدار السلسلة v3.2.7 (12 نوفمبر 2026) وقد قُبلت على شبكة الاختبار، لكن RDK 0.8.0 ليس فيه بنّاء لها ولم يُجرَّب أي rollup من نوع ZK على أي من الشبكتين. اختر الآن ملف تعريف optimistic مثل nft أو custom (راجع ZK / STARK والسحوبات).

الأعلام:

العلمالقيمة الافتراضيةالوصف
--vm(فارغ — استخدام الآلة الافتراضية لملف التعريف)تجاوز نوع الآلة الافتراضية للـ rollup: ‏evm أو cosmwasm أو svm أو custom. اتركه دون ضبط لتطبيق الآلة الافتراضية للإعداد المسبق. (في عملاء RDK، بيئة تشغيل Wasm هي نوع الآلة الافتراضية native — QoreChain Native — مع الإبقاء على cosmwasm كاسم بديل قديم؛ وcosmwasm هي القيمة المرسلة على الشبكة، وهي ما يقبله هذا العلم على مستوى السلسلة.)
تسمية الآلة الافتراضية هي بيانات وصفية

يسجّل --vm بيئة التشغيل التي يستخدمها الـ rollup الخاص بك. تقوم السلسلة المضيفة بتسوية الـ rollup فقط؛ ولا تنفّذ عقوده. رفع QoreChain Native على السلسلة المضيفة نفسها مغلق حاليًا، ومسار معاملات SVM فيها معطّل على مستوى الشبكة، وهذا لا يؤثر في تسوية rollup خارج السلسلة، لكنه يعني أنه لا يمكنك نشر عقود لـ rollup على مساري السلسلة المضيفة هذين.

الوسيط [profile] يحدد تكوينًا مسبقًا يُطبَّق تلقائيًا — راجع ملفات التعريف المسبقة. والوسيط [stake-amount] هو الضمان بوحدة uqor؛ وحرق الإنشاء هو 1 % منه.

افحص ما نشرته​

# Query a specific rollup by ID
qorechaind query rdk rollup my-defi-rollup

# List all registered rollups
qorechaind query rdk list-rollups

النشر باستخدام TypeScript RDK ‏(@qorechain/rdk)​

تُشحن حزمة تطوير الـ Rollup على شكل حزمتي npm عامتين لوحدة x/rdk نفسها على السلسلة التي تتعامل معها واجهة سطر الأوامر. لم يُنشأ أي rollup على أي من الشبكتين بعد، لذا لم يُجرَّب أي مسار معاملات في الحزمة على rollup حي؛ اقرأ RDK 0.8.0: التغييرات والحدود قبل الاعتماد عليها لإرسال المعاملات:

  • @qorechain/rdk ‏(v0.9.0) — حزمة TypeScript SDK: منشئ تكوين مع ملفات تعريف مسبقة، ومساعدات معاملات لدورتي حياة الـ rollup ودفعات التسوية، وDA أصلي، وعملاء قراءة منمّطون، وإيصالات تسوية بتوقيع ML-DSA-87، ومساعد QCAI Rollup Copilot، ومساعدات calldata عبر الآلات الافتراضية، وبرج المراقبة (watchtower). وتعتمد على @qorechain/sdk ‏^0.10.0 (اعتبارًا من 0.7.0؛ وكانت 0.6.x تستخدم ^0.9.0) و@qorechain/evm ‏^0.8.0.
  • create-qorechain-rollup ‏(v0.9.0) — أداة تهيئة تستنسخ قالب بداية قابلاً للتشغيل لكل ملف تعريف (بما في ذلك قالب multivm-rollup).

هذه الحزم منشورة على npm. يشحن المستودع أيضًا واجهة سطر أوامر منشورة للمشغّلين، @qorechain/rdk-cli ‏(qorollup، ‏v0.9.0)، مع أوامر doctor وcreate وstatus وwatch وparams وsuggest وأوامر دورة الحياة (pause/resume/stop) وkeygen وmanifest وwithdraw وfaucet، بالإضافة إلى أوامر receipt وadvise وwatchtower. ومنذ 0.7.1 توقّع أوامر المعاملات فيها توقيعًا هجينًا (راجع الحدود أدناه).

أبرز المستجدات حسب الإصدار:

  • v0.4.2 — يعمل مع الشبكة الحية مباشرة دون إعداد. أصبحت الإعدادات المسبقة mainnet وtestnet تتضمن نقاط الوصول العامة qore.host ‏(REST على api.qore.host / api-testnet.qore.host)، لذا يصل createRdkClient({ network }) إلى السلسلة دون تحديد endpoints يدويًا — تجاوزها فقط لاستهداف عقدتك الخاصة. أعاد الإصدار نفسه تسمية معرّف الآلة الافتراضية لـ rollup من نوع Wasm إلى native ‏(QoreChain Native)؛ ويبقى cosmwasm اسمًا بديلًا قديمًا مقبولًا، وكلاهما يُترجم إلى cosmwasm على الشبكة — دون أي تغيير في السلسلة أو المستكشف أو لوحة التحكم.
  • v0.4.3 — تحديث للاعتماديات لإصلاح ترميز التوقيع الهجين في SDK. وكان عميل المعاملات في RDK نفسه ما زال يوقّع توقيعًا كلاسيكيًا فقط.
  • v0.4.4 — يتتبع @qorechain/sdk ‏^0.7.0، وهو إصدار SDK الخاص بمسارات المصادِقات (authenticator lanes) في إصدار السلسلة v3.1.85. لا يوجد تغيير في واجهة برمجة RDK.
  • v0.5.0 (18 أكتوبر 2026) — يتحقق التحقق من إيصالات التسوية مقابل حالة السلسلة ولا يعلن أبدًا صحة إيصال من حقوله هو؛ ويوقّع عميل المعاملات في TypeScript توقيعًا هجينًا عند تزويده بـ pqcKeypair. وهو يعتمد على @qorechain/sdk ‏^0.8.0.
  • v0.6.0 (إصدار GitHub بتاريخ 20 أكتوبر 2026) — إصدار التوافق مع السلسلة من v3.2.2 إلى v3.2.4: دفعات مثبَّتة (anchored)، وإيصالات تسوية يمكنها التحقق، ونوافذ اعتراض تُقاس كما تقيسها السلسلة، ومرمِّز يطابق تخطيط الاستدعاء عبر الآلات الافتراضية في السلسلة، وقوالب توقّع توقيعًا هجينًا، و@qorechain/sdk ‏^0.9.0. التفاصيل أدناه.
  • v0.6.1 (إصدار GitHub بتاريخ 25 أكتوبر 2026) — إصدار إصلاح أمني وإصلاح للقوالب للسلسلة v3.2.3 وما بعدها، في اللغات الخمس كلها: يقارن التحقق من إيصال التسوية كل حقل يذكره الإيصال مع تثبيت السلسلة، ولم تعد القوالب الستة للبداية ترسل دفعات ترفضها السلسلة (فهي تترك dataHash فارغًا)، وتنشر القوالب المتفائلة (optimistic) جذر الحالة المعتمد للسلسلة بدلًا من قيمة نائبة. ويبقي نطاقَي @qorechain/sdk ‏^0.9.0 و@qorechain/evm ‏^0.8.0. التفاصيل أدناه.
  • v0.6.2 (إصدار GitHub بتاريخ 27 أكتوبر 2026): إصلاح عاجل لواجهة CLI دون أي تغيير في المكتبات: عاد qorollup المثبَّت من npm (محليًا أو عامًا أو عبر npx) إلى العمل، وتطبع qorollup --version وcreate-qorechain-rollup --version إصدارَيهما الحقيقيين. وأُعيد إصدار الحزم الأخرى بالرقم 0.6.2 ليبقى كل سجل على إصدار واحد.
  • v0.7.0 (إصدار GitHub بتاريخ 27 أكتوبر 2026): جاهز للسلسلة v3.2.5 في اللغات الخمس كلها (تعمل به الشبكتان، وبـ v3.2.6 وv3.2.7 أيضًا: طبّقت الشبكة الرئيسية v3.2.5 في 29 أكتوبر 2026 وv3.2.6 في 4 نوفمبر وv3.2.7 في 12 نوفمبر، وشبكة الاختبار v3.2.5 في 26 أكتوبر وv3.2.6 في 27 أكتوبر؛ وانتقلت شبكة الاختبار منذ ذلك الحين إلى v3.2.7 ثم إلى v3.2.8)، ويصلح طريقة تجزئة السحوبات وblobs توفر البيانات: فبراهين السحب المبنية بالقيم الافتراضية في 0.6.x لم تكن تجتاز التحقق على السلسلة أبدًا، ويبني 0.7.0 شجرة السلسلة نفسها بالضبط. وينتقل إلى @qorechain/sdk ‏^0.10.0، وتثبّت القوالب @qorechain/rdk ‏^0.7.0. التفاصيل أدناه.
  • v0.7.1 (إصدار GitHub بتاريخ 30 أكتوبر 2026): إصلاح عاجل لواجهة qorollup CLI للمشغّلين، التي صارت أوامر المعاملات فيها توقّع الآن توقيعًا هجينًا كما تتطلب الشبكتان.
  • v0.8.0 (إصدار GitHub بتاريخ 30 أكتوبر 2026): صارت عملاء Python وGo وRust وJava توقّع توقيعًا هجينًا أيضًا، فيستطيع كل عميل RDK إرسال المعاملات على الشبكة الرئيسية وشبكة الاختبار. ويلزم Java 21.
  • v0.9.0 (إصدار GitHub بتاريخ 12 نوفمبر 2026؛ الحالي): يدعم السلسلة v3.2.8 (تعمل شبكة الاختبار بها منذ 12 نوفمبر 2026): نشر بيانات rollup، والتسلسل القائم على الأساس (based sequencing)، وrollups متفائلة من نوع qledger-v1 مع إثباتات الاحتيال، وrollups خاصة، ومدخلات ZK القانونية؛ والتسوية بـ STARK متوقفة مؤقتًا. راجع ملاحظات الإصدار على GitHub. يجب على الحساب الجديد تسجيل مفتاحه ما بعد الكمّي في معاملة مستقلة قبل أي شيء آخر؛ وعملاء RDK 0.9.0 يتولون هذا التسجيل عنك.

الإصدارات المنشورة (جرى التحقق على كل سجل في 12 نوفمبر 2026). على npm: ‏@qorechain/rdk و@qorechain/rdk-cli وcreate-qorechain-rollup: ‏0.9.0 (latest)؛ على PyPI: ‏qorechain-rdk: ‏0.9.0؛ على crates.io: ‏qorechain-rdk: ‏0.9.0؛ على Maven Central: ‏io.github.qorechain:qorechain-rdk: ‏0.9.0 (وتبقى الإصدارات الأقدم متاحة)؛ وحدة Go ‏github.com/qorechain/qorechain-rdk/packages/go: ‏v0.9.0 (وقد يتأخر @latest في وكيل الوحدات عن وسم جديد، فثبّت @v0.9.0 صراحةً). إصدار GitHub هو v0.9.0.

RDK 0.8.0: التغييرات والحدود​

يبيّن هذا القسم ما تفعله حزم 0.8.0 المنشورة (وما غيّرته 0.7.1 و0.7.0 و0.6.2 و0.6.1 و0.6.0 قبلها)، مُتحقَّقًا منه مقابل محتويات الحزم وملاحظات إصدار GitHub، وما لا تزال عاجزة عن فعله. ولا يمثل أي من هذه البنود سلوكًا للسلسلة. وحيثما يقول بيان "غير مختبَر حيًا"، فلا يوجد rollup على أي من الشبكتين، لذا لم يُفحص المسار إلا مقابل الشيفرة ودون اتصال.

ما الذي تغيّر في 0.8.0 و0.7.1 (تتضمن ملاحظات الإصدار 0.8.0 و0.7.1 القائمة الكاملة). تتطلب الشبكتان توقيعًا هجينًا (ML-DSA-87 + secp256k1) على معاملات المسار الأصلي.

  • 0.7.1: معاملات qorollup مقبولة. كانت create وpause وresume وstop وwithdraw توقّع توقيعًا كلاسيكيًا فقط في 0.7.0 وما قبله، فكانت الشبكتان ترفض كل واحدة منها. وصارت CLI توقّع الآن توقيعًا هجينًا. وهي تحلّ المفتاح ما بعد الكمّي كما تفعل القوالب: مشتقًا من --mnemonic أو QORE_MNEMONIC ومطابَقًا مع المفتاح المسجَّل لدى السلسلة، أو مأخوذًا من --pqc-seed أو QORE_PQC_SEED_HEX مع --key. وبدون مفتاح ترفض الإرسال بدلًا من دفع كلفة معاملة مرفوضة.
  • 0.7.1: إصلاح تكافؤ Python. صارت transition_root_version_for_batch وRestClient.get_applied_plan_height وBatchView.withdrawals_bound موجودة الآن في عميل Python أيضًا (كانت ملاحظات 0.6.1 قد عدّت الأولى في اللغات الخمس؛ وكانت في أربع).
  • 0.8.0: Python وGo وRust وJava توقّع توقيعًا هجينًا. كان الذي يعمل منها سابقًا على الشبكة الرئيسية وشبكة الاختبار هو القراءات فقط. وصار كل منها يوقّع الآن توقيعًا هجينًا عند تزويده بزوج مفاتيح ما بعد كمّي، عبر QoreChain SDK المنشور الخاص به (0.10.x)، مع حلّ صيغة sign-bytes (‏v1 أو v2) من السلسلة. وتذكر ملاحظات الإصدار أن كل عميل ينتج معاملات مطابقة بايتًا ببايت لعميل TypeScript للمدخل نفسه (يضم ملف اختبار مشترك أربع معاملات هجينة تعيد كل لغة إنتاجها بدقة).
  • 0.8.0: حلّ المفتاح في كل لغة، مطابقًا لـ TypeScript: من عبارة استرداد، بالاشتقاق المعتمد أو القديم، أيهما سجّلته السلسلة؛ أو من بذرة بطول 32 بايت من QORE_PQC_SEED_HEX، تُفحص مقابل المفتاح المسجَّل. في Python ‏resolve_pqc_keypair / pqc_keypair_from_env، وفي Go ‏ResolvePqcKeypair / PqcKeypairFromEnv، وفي Rust ‏resolve_pqc_keypair / pqc_keypair_from_env، وفي Java ‏Accounts.resolvePqcKeypair / pqcKeypairFromEnv.
  • 0.8.0: يلزم Java 21 (كان 17)، لأن QoreChain Java SDK الذي تعتمد عليه يتطلبه.
  • 0.8.0: اعتماديات جديدة. ‏qorechain-sdk ‏0.10.x على PyPI، ووحدة Go ‏github.com/qorechain/qorechain-sdk/packages/go ‏v0.10.0، وqorechain-sdk ‏0.10 على crates.io (وتنتقل Rust إلى cosmrs ‏0.22) وio.github.qorechain:qorechain-sdk ‏[0.10.0,0.11) على Maven. وتثبّت القوالب @qorechain/rdk ‏^0.8.0.
  • 0.8.0: تُعيد RdkTxClient.Sign في Go القيمة ([]byte, error)، لأن التوقيع الهجين قد يفشل. ويكسر هذا شيفرة Go التي استخدمت قيمة الإرجاع الواحدة القديمة.
  • غير مختبَر حيًا. لا يوجد rollup على أي من الشبكتين، لذا لم تُرسل أي معاملة هجينة من أي عميل عبر rollup حي.

ما الذي تغيّر في 0.7.0 (اللغات الخمس كلها، ما لم يذكر سطر غير ذلك؛ وتتضمن ملاحظات الإصدار القائمة الكاملة). السلوك الذي يخص السلسلة v3.2.5 موسوم بشبكته: تعمل الشبكتان على v3.2.5 أو ما بعده (تعمل الشبكة الرئيسية على v3.2.7 منذ 12 نوفمبر 2026، وشبكة الاختبار على v3.2.8 منذ 12 نوفمبر).

  • براهين السحب تجتاز التحقق على السلسلة. كانت مساعدات Merkle والسحب تستخدم SHA-256 افتراضيًا وتعيد تجزئة كل ورقة، بينما تجزّئ السلسلة العقد بـ SHAKE-256 وتبني أوراقها من السحب نفسه، فلم يكن برهان مبني بالقيم الافتراضية في 0.6.x يجتاز التحقق أبدًا. تبني withdrawalsTree الآن جذر سحوبات الدفعة وكل برهان تمامًا كما تفعل السلسلة (موضع الورقة هو فهرس السحب): بأوراق الصيغة الأولى، أو بأوراق الصيغة الثانية التي تسمّي معرّف السلسلة أيضًا، وهي التي تستخدمها السلسلة للدفعات اعتبارًا من v3.2.5 (على الشبكتين). تبني withdrawalLeafV1 وwithdrawalLeafV2 ورقة واحدة، وتبني assembleWithdrawalProof شجرة السلسلة افتراضيًا، وتستخدم مساعدات Merkle العامة SHAKE-256 افتراضيًا. وهذا تغيير كاسر للشيفرة التي اعتمدت على القيم الافتراضية SHA-256 (مرّر hash صراحةً للإبقاء عليها). وقد اختُبرت صيغ البايتات الجديدة مقابل متجهات أنتجتها شيفرة السلسلة نفسها، ويقبل مدقّق السلسلة كل برهان سحب في تلك المتجهات. راجع ترميز الأوراق والعقد.
  • qorollup withdraw يفحص قبل أن يدفع. يأخذ سحوبات الدفعة (qorollup withdraw --file withdrawal.json [--dry-run])، ويبني البرهان بالربط الخاص بالدفعة نفسها، ويمتنع قبل دفع أي رسوم عندما لا تكون النتيجة هي withdrawals_root الخاص بالدفعة على السلسلة.
  • buildDaBlob يلتزم كما تفعل السلسلة. التزامه هو SHAKE-256 لا SHA-256 (لا تنشر أي معاملة blob، لذا يبقى dataHash فارغًا).
  • برج المراقبة. كان برج المراقبة يميّز الدفعات بالفهرس وحده، فيفوته أن دفعة أُعيد إرسالها بفهرس مرفوض. اعتبارًا من السلسلة v3.2.5 (على الشبكتين) يؤدي احتيال مثبَت إلى رفض الدفعة وكل دفعة لاحقة غير منتهية، ويعيد المرتِّب الإرسال بالفهارس نفسها؛ ويميّز برج المراقبة الآن الدفعات بالفهرس وجذر الحالة ولا يصادق أبدًا على دفعة مرفوضة. مساعدان جديدان: transitionRootValidator (دالة شرط validate تطبّق قاعدة الاحتيال في السلسلة) وfraudProofForBatch (البرهان الذي يكسب، أو لا شيء لدفعة نزيهة)، والأمر qorollup watchtower --canonical الذي يبلّغ عن الدفعات التي سيكسبها اعتراض.
  • مساعدات التسوية للسلسلة v3.2.5 (على الشبكتين): تبلّغ getRollupHealth عن heldBackBy عندما كان بوسع آخر دفعة أن تنتهي ضمن نافذتها لكن دفعة أقدم ما زالت submitted أو challenged (تنتهي الدفعات بالترتيب)، ويطبعه qorollup status؛ وstopRollupError وفحص مسبق في stopRollup (في TypeScript وRust)، لأن rollup آخر دفعة فيه submitted أو challenged لا يمكن إيقافه؛ وMAX_PENDING_OPTIMISTIC_BATCHES (‏4,096)؛ وwithdrawalsRootError (جذر السحوبات فارغ أو 32 بايتًا بالضبط)، ويُفحص قبل كل إرسال دفعة في اللغات الخمس كلها.
  • مساعدات عبر الآلات الافتراضية للسلسلة v3.2.5 (على الشبكتين): getCrossVmParams (القائمة المسموح بها، على /qorechain/crossvm/v1/params)، وcrossVmTargetReady (الـ precompile مفعّل، والجسر مفعّل، والهدف ضمن القائمة المسموح بها، مع سبب المنع)، وdecodeCrossVmResult (الرد هو abi.encode(bytes))، وdecodeRevertReason (الرفض هو Error(string))، مُتحقَّق منها مقابل ترميزات أنتجها Solidity. راجع Multi-VM.
  • فك ترميز الأخطاء وإضافات صغيرة. تسمّي decodeRdkTxError وRDK_ERRORS رموز أخطاء وحدة rdk (من 2 إلى 36) وما ينبغي فعله حيال تلك التي يصادفها المشغّل؛ وqorehash (‏SHAKE-256، 32 بايتًا) مُصدَّرة في اللغات الخمس كلها؛ وFEATURE_RDK_CHALLENGE_SETTLEMENT تسمّي علم ميزة السلسلة.
  • قالب defi يتوقف قبل أن يهدر رسومًا. لا يستطيع أي إصدار للسلسلة حتى v3.2.6 تسجيل مفتاح تحقق ZK، فكانت كل دفعة ZK تُرفض هناك. يتوقف القالب الآن قبل الإرسال، ويقرأ RollupView.hasVerificationKey حقلًا مخصصًا للسلسلة v3.2.7 (على شبكة الاختبار منذ 6 نوفمبر، وعلى الشبكة الرئيسية منذ 12 نوفمبر 2026)؛ ولم يمكن فحصه مقابل rollup حي لأنه لا يوجد أي منها.
  • الاعتماديات. ‏@qorechain/sdk ‏^0.10.0 (كانت ^0.9.0)، لذا يشارك تطبيق على SDK 0.10.0 الآن نسخة SDK واحدة مع الحزمة؛ وتثبّت القوالب @qorechain/rdk ‏^0.7.0 (و^0.8.0 منذ 0.8.0).

ما الذي تغيّر في 0.6.2 (واجهة CLI وأداة التهيئة فقط؛ أما حزم المكتبات فلم تتغير):

  • يعمل qorollup عند تثبيته من npm. كانت واجهة CLI لا تبدأ إلا إذا ساوى process.argv[1] مسار ملفها هي، لكن npm يشغّل ملف bin الخاص بالحزمة عبر رابط رمزي في node_modules/.bin، ولذلك كان 0.6.1 وما قبله، سواء ثُبّت محليًا أو عامًا أو شُغّل عبر npx، ينتهي برمز الخروج 0 ولا يطبع شيئًا؛ ولم يكن يعمل إلا node .../dist/index.js. يقارن 0.6.2 المسارات الحقيقية. وبعد npm i -g @qorechain/rdk-cli يعمل qorollup ....
  • تُطبع الإصدارات بشكل صحيح. كانت qorollup --version تطبع 0.4.1 وcreate-qorechain-rollup --version تطبع 0.2.0 في الإصدارات السابقة؛ وكلتاهما الآن تقرأ ملف package.json الخاص بها (جرى التحقق في 27 أكتوبر 2026: تطبع qorollup --version القيمة 0.6.2).

ما الذي تغيّر في 0.6.1 (اللغات الخمس كلها، ما لم يذكر سطر غير ذلك؛ وتتضمن ملاحظات الإصدار القائمة الكاملة):

  • التحقق من الإيصال يقارن كل حقل. تشترط verifySettlementReceipt الآن أن يساوي كل حقل تثبيت يذكره الإيصال تثبيتَ السلسلة (ويسمّي أي عدم تطابق الحقل)، وأن يساوي batchStateRoot جذر دفعة السلسلة، وترفض إيصالًا بـ version غير معروف أو بـ algorithm غير ML-DSA-87 قبل قراءة أي شيء من السلسلة. وتحمل النتيجة anchor المطابق من السلسلة، وعند الصحة verifiedReceipt معاد بناؤه من حالة السلسلة؛ ويعيد qorollup receipt verify --json ذلك الإيصال المقروء من السلسلة باسم receipt. راجع إيصالات التسوية.
  • توفر البيانات الأصلي: اترك dataHash فارغًا. تستخدم كل ملفات تعريف الـ rollup توفر البيانات native، حيث لا تقبل السلسلة data_hash غير فارغ إلا عندما يكون blob مطابق مخزَّنًا على السلسلة، ولا تستطيع أي معاملة تخزين واحد (راجع توفر البيانات). وكانت القوالب الستة للبداية تضع تجزئة بيانات على دفعاتها في 0.6.0 وما قبله، فكانت السلسلة ترفض كل دفعة من القوالب بعد دفع الرسوم. وهي الآن تتركها فارغة؛ وSubmitBatchInput.dataHash اختياري في TypeScript (وإغفاله يعني فارغًا)، وتكشف dataHashError ‏(data_hash_error وDataHashError وRules.dataHashError) القاعدة، وترفض RdkTxClient.submitBatch مثل هذه الدفعة قبل البث عندما تستطيع قراءة الـ rollup (عميل هجين مع نقطة REST).
  • القوالب المتفائلة تنشر جذر الحالة المعتمد. تحكم السلسلة على الدفعة المتفائلة بجذر الانتقال المعتمد لها، وهو التزام SHAKE-256 بجذر الحالة السابق للدفعة وتجزئة بياناتها وعدد معاملاتها (‏batchTransitionRoot في RDK، مع اختيار transitionRootVersionFor للربط الذي تطبّقه الشبكة المتصل بها). كانت قوالب custom وmultivm وnft ترسل جذرًا نائبًا ثابتًا لا يطابق الجذر المعتمد الذي تفحصه السلسلة؛ وهي الآن تنشر الجذر المعتمد ولم تعد ترسل برهانًا نائبًا. ويقرأ challenge.ts في قالب nft الدفعة من السلسلة ولا يعترض إلا على دفعة جذرها خاطئ بشكل مثبت. لا تكتب الصيغة يدويًا: استخدم batchTransitionRoot ليطابق الربط الشبكة التي ترسل إليها. وفحص السلسلة نفسه واحد لكل العملاء، فيمكن الاعتراض بنجاح على دفعة متفائلة جذر حالتها ليس الجذر المعتمد، أيًّا كان العميل الذي أرسلها.
  • مساعدات جديدة. ‏fraudProof وtransitionRootVersionForBatch وreceiptSchemaError مع SUPPORTED_RECEIPT_VERSIONS وRestClient.getProtocolFeatures / isProtocolFeatureEnabled (وتُقرأ سلسلة بلا هذا المسار على أنها "غير مفعّلة") وgetAppliedPlanHeight. وتعتمد @qorechain/rdk الآن على @noble/hashes مباشرةً (SHAKE-256 لجذر الانتقال؛ وكانت مثبَّتة أصلًا عبر @qorechain/sdk). وتثبّت القوالب @qorechain/rdk ‏^0.6.1.

ما الذي تغيّر في 0.6.0 (TypeScript، ما لم يذكر سطر غير ذلك):

  • التوقيع. يوقّع RdkClient.connectTx(signer, { pqcKeypair, rest }) توقيعًا هجينًا (secp256k1 + ML-DSA-87) عندما تمرّر زوج مفاتيح؛ وبدونه يوقّع توقيعًا كلاسيكيًا فقط وترفض الشبكتان المعاملة. يجب أن يكون signer من النوع OfflineDirectSigner، ويجب أن تكون الرسوم صريحة (fee، أو gasPrice عند الاتصال). تشتق المساعدتان الجديدتان resolvePqcKeypair وpqcKeypairFromEnv مفتاح ML-DSA-87 القياسي والقديم معًا انطلاقًا من عبارة استرداد (mnemonic) وتستخدمان أيّهما سجّله الحساب على السلسلة؛ وتمتنعان عن الاختيار بدل التخمين عندما يحمل الحساب مفتاحًا مختلفًا. ويوفّر QORE_PQC_SEED_HEX بذرة لمشغّل يوقّع بمفتاح خاص خام. تعتمد الحزمة الآن على @qorechain/sdk ‏^0.9.0، لذا يحمل التثبيت الجديد نسخة SDK واحدة (0.9.0)؛ أما مع 0.5.0 فقد ثبّت npm الإصدار 0.8.3 من SDK متداخلًا تحت الحزمة.
  • الدفعات المثبَّتة. تحمل MsgSubmitBatch الحقلين anchor_signature وvalidator_set_hash. لا يوقّع RdkTxClient.submitBatch التثبيت بنفسه إلا عندما يوقّع العميل توقيعًا هجينًا ويملك نقطة وصول REST ويكون منشئ الـ rollup (إذ تتحقق السلسلة من التثبيت مقابل المفتاح المسجَّل للمنشئ)؛ وفي كل حالة أخرى يرسل الدفعة غير مثبَّتة كما كان من قبل. مرّر anchor: "require" ليمتنع عن الإرسال بدل إرسالها غير مثبَّتة، أو anchor: "off" لعدم التوقيع أبدًا، أو anchorSignature لإرسال توقيع حصلت عليه بنفسك. تبني anchorSignBytesForBatch بايتات v2 لمنشئ يوقّع خارج القناة، وهو ما يحتاجه rollup له مرتِّب منفصل. غير مختبَر حيًا.
  • إيصالات التسوية. يستخدم البحث عن حساب PQC المسار المفرد /qorechain/pqc/v1/account/{address} (استخدم 0.5.0 مسارًا بصيغة الجمع لا تقدّمه الشبكتان). ويدعم التحقق صيغتي بايتات توقيع التثبيت كلتيهما ويختار إحداهما بحسب ارتفاع التثبيت، ولا يجرّب الاثنتين أبدًا: ‏v1 دون نقطة التحوّل في v3.2.2، وv2 منها فصاعدًا. يسجّل مخطط الإيصال v2 الحقل chainId؛ ويرفض التحقق إيصالًا يُفحص مقابل عقدة من سلسلة أخرى، ويُبلغ عن signBytesVersion وعن فحص chainBinding. وما زالت إيصالات الإصدار 1 تجتاز التحقق. راجع إيصالات التسوية.
  • القراءات. تستدعي getLatestBatch المسار /qorechain/rdk/v1/latest_batch/{rollup_id} (كان 0.5.0 يستدعي صيغة لا تقدّمها السلسلة)، وتتبع listBatches كل الصفحات (وتقرأ listBatchesPage صفحة واحدة). ويحمل RollupView الحقل escrowBalance و، حيثما تُبلغ عنها العقدة، challengeWindowSec وchallengeBond وproofSystem؛ ويحمل BatchView الحقل submittedTime.
  • نوافذ الاعتراض. تحسب batchChallengeWindow نافذة الدفعة كما تحسبها السلسلة وتحكم عليها بالنسبة إلى رأس السلسلة (getChainTip)، لا بالساعة المحلية: ثوانٍ من زمن الكتلة للدفعة التي لها وقت إرسال مسجَّل (قاعدة v3.2.4: على شبكة الاختبار منذ الارتفاع 8,337,253، وعلى الشبكة الرئيسية منذ الارتفاع 3,742,566)، وwindow / 6 كتل تُحسب من ارتفاع الإرسال في غير ذلك (قاعدة الدفعات المرسلة قبل ارتفاع الترقية). ويستخدمها الفحص الصحي الذي يقوم عليه qorollup status وبرج المراقبة (راجع برج المراقبة).
  • عبر الآلات الافتراضية (Cross-VM). تُرمِّز encodeCrossVmCalldata الآن executeCrossVMCall(uint8,string,bytes)، وهو التخطيط الذي تفكّ العقدة ترميزه، وتأخذ targetVm. وتقرأ isCrossVmPrecompileActive القائمة الحية للـ precompiles المفعّلة (راجع Multi-VM).
  • قواعد تُفحص قبل دفع الرسوم. تفحص rollupIdError قواعد صياغة المعرّف عند التحقق من تكوين وقبل أن تبثّ createRollup؛ وتفحص withdrawalErrors السحب قبل أن تبثّ executeWithdrawal.
  • القوالب. تتصل القوالب المهيَّأة عبر pqcKeypairFromEnv، لذا توقّع نصوصها create وsubmit-batch توقيعًا هجينًا، وكانت تعتمد على @qorechain/rdk ‏^0.6.0 (و^0.6.1 منذ أداة التهيئة 0.6.1). ويفحص قالب multivm-rollup أن الـ precompile حيّ ويشترط ردًا غير فارغ من الهدف.
  • Python وGo وRust وJava. إصلاحات جانب القراءة أعلاه (مسار PQC المفرد، وlatest_batch، وبايتات توقيع التثبيت v2، وقواعد نافذة الاعتراض، وفحوصات المعرّف والسحب) موجودة في الحزم المنشورة للغات الأربع الأخرى أيضًا.
  • تغييرات كاسرة. تأخذ encodeCrossVmCalldata الوسيط targetVm، وتغيّرت CROSS_VM_DEFAULT_SIGNATURE. ويحمل RollupHealth وBatchDeadline الحقل challengeWindow بدل الموعد النهائي القديم المبني على الثواني.

الحدود التي تبقى في 0.8.0:

  • لم تُجرَّب تسوية ZK على أي من الشبكتين. يتأثر بذلك ملف التعريف defi وقالب defi-rollup وكل rollup أُنشئ بتسوية zk: رسائل مفتاح التحقق مفعَّلة على الشبكة الرئيسية منذ إصدار السلسلة v3.2.7 (12 نوفمبر 2026) وعلى شبكة الاختبار منذ 6 نوفمبر 2026، لكن لم يُنشأ أي rollup من نوع ZK وليس في RDK 0.8.0 بنّاء لهذه الرسائل. استخدم تسوية optimistic في الوقت الحالي (راجع ZK / STARK والسحوبات).

  • دائرة العرض التوضيحي في قالب defi لا يمكنها أن تجتاز التحقق. إنها دائرة ضرب من snarkjs، بينما تفحص السلسلة Groth16 على BLS12-381 بثلاثة مدخلات عامة (جذر الحالة السابق وجذر الحالة الجديد وتجزئة البيانات). وحتى بعد توفر تسجيل المفاتيح، لن يجتاز برهان من دائرة العرض التوضيحي؛ استبدل الدائرة بدائرة انتقال الحالة الخاصة بك.

  • أُصلح في 0.7.0: مساعدات Merkle للسحب. في 0.6.2 وما قبله كانت المساعدات تستخدم SHA-256 افتراضيًا، وكان البرهان المبني بالقيم الافتراضية لا يجتاز التحقق على السلسلة أبدًا؛ استخدم withdrawalsTree / assembleWithdrawalProof اعتبارًا من 0.7.0 (راجع ترميز الأوراق والعقد).

  • التوقيع الهجين يحتاج إلى مفتاحك ما بعد الكمّي. يوقّع كل عميل (TypeScript، وواجهة qorollup CLI منذ 0.7.1، وPython وGo وRust وJava منذ 0.8.0) توقيعًا هجينًا فقط عندما يملك زوج مفاتيح ما بعد كمّي؛ وبدونه تكون المعاملة كلاسيكية فقط وترفضها الشبكتان. وتوقّع الإصدارات السابقة لهذه الإصدارات توقيعًا كلاسيكيًا فقط، فلا تستطيع CLI قبل 0.7.1 ولا عملاء Python وGo وRust وJava قبل 0.8.0 إرسال معاملة تقبلها الشبكتان. وليس في بُناة الرسائل في Python حقل anchor_signature ولا validator_set_hash (جرى التحقق منه في مصدر 0.8.0؛ ولم يُتحقق من اللغات الثلاث الأخرى)، لذا ففي دفعة مثبَّتة من Python ابنِ ووقّع باستخدام CLI الخاص بالسلسلة (--generate-only، ثم qorechaind tx pqc cosign) أو استخدم عميل TypeScript مزوَّدًا بـ pqcKeypair.

  • لم يُجرَّب إنشاء rollup بتوقيع هجين على شبكة حية، لأنه لا يوجد rollup على أي من الشبكتين. والأمر نفسه ينطبق على الدفعات المثبَّتة والسحوبات ومسار الإيصالات كله.

  • التثبيت يحتاج إلى المنشئ. لا تُثبَّت الدفعة في المعاملة نفسها إلا إذا كان توقيع المنشئ فيها. وإذا كان المرتِّب عنوانًا آخر، فعلى المنشئ أن يوقّع بايتات v2 خارج القناة وأن يرسل المرتِّب الناتج.

  • الـ precompile عبر الآلات الافتراضية على العنوان 0x…0901 غير مفعّل على الشبكة الرئيسية، لذا فإن الاستدعاء من عقد لا يفعل شيئًا هناك. وعلى شبكة الاختبار هو نشط مع قائمة سماح، وجرى اختبار استدعاء عبره بـ eth_call في 7 نوفمبر 2026 (راجع Multi-VM).

  • طول نافذة الاعتراض. تقرأ الحزمة نافذة الـ rollup الخاصة به فقط عندما تُبلغ عنها العقدة (وتوثّق الحزمة ذلك على أنه v3.2.4 وما بعده، وهو ما تشغّله الشبكتان). وإلا فإنها تستخدم نافذة الوحدة الافتراضية؛ مرّر challengeWindowSecs لـ rollup هيّأ نافذته الخاصة. وما زالت الدالتان القديمتان challengeWindowDeadline وisChallengeWindowClosed مصدَّرتين وما زالتا تأخذان ثواني، فلا تمرّر لهما ارتفاع كتلة.

  • توفر البيانات. لا تنشر أي معاملة blob، لذا يجب أن تترك الدفعة على rollup من نوع native أو both الحقل dataHash فارغًا (راجع توفر البيانات). كان buildDaBlob يجزّئ بـ SHA-256 في 0.6.2 وما قبله؛ واعتبارًا من 0.7.0 التزامه هو SHAKE-256 الخاص بالسلسلة.

الإصدارات السابقة لـ 0.8.0. لا تستطيع 0.7.0 وما قبلها إرسال معاملات qorollup تقبلها الشبكتان (أُصلح ذلك في 0.7.1)، وقبل 0.8.0 لم تكن عملاء Python وGo وRust وJava تستطيع إرسال أي معاملة. ويبني 0.6.2 وما قبله براهين سحب لا تجتاز التحقق على السلسلة أبدًا ويجزّئ buildDaBlob بـ SHA-256؛ فاستخدم 0.8.0. وكان 0.6.1 وما قبله يثبّت واجهة qorollup CLI من npm بحالة لا تطبع فيها شيئًا وتنتهي برمز الخروج 0 (أُصلح ذلك في 0.6.2). يقارن 0.6.0 حقولًا أقل في التحقق من الإيصالات من 0.6.1، ويشحن قوالب ترسل دفعات ترفضها السلسلة (تجزئة بيانات على rollup بتوفر بيانات أصلي، وجذر حالة نائب في القوالب المتفائلة). ولا ينبغي استخدام 0.5.0 وما قبله لإيصالات التسوية أو برج المراقبة أو calldata عبر الآلات الافتراضية: فقد بحث 0.5.0 عن مفتاح المنشئ في مسار لا تقدّمه الشبكتان (فكان التحقق من الإيصالات يفشل مغلقًا مع كل إيصال حقيقي)، وأعاد بناء رسالة التثبيت v1 فقط، وقرأ ارتفاع الكتلة على أنه طابع زمني (فكان عمر كل دفعة وكل موعد نهائي للاعتراض خاطئًا، وكان برج المراقبة يُطلق تنبيه الموعد النهائي فورًا لكل دفعة)، واستدعى مسار آخر دفعة لا تقدّمه السلسلة، وقرأ أول 50 دفعة فقط، وشفّر دالة لا يفكّها الـ precompile، وشحن قوالب توقّع توقيعًا كلاسيكيًا فقط. ولم يكن في 0.4.x توقيع هجين في عميل المعاملات.

عملاء Python وGo وRust وJava​

إلى جانب حزمة TypeScript، توفر RDK عملاء كاملين بلغات Python وGo وRust وJava يعكسون واجهة TypeScript: منشئ التكوين مع التحقق، وملفات التعريف المسبقة الخمسة، وأدوات denom/الاقتصاديات/bech32، ومساعدات Merkle الثنائية وبراهين السحب، وبيانات manifest للـ rollup، وعملاء قراءة عبر REST وواجهة qor_ JSON-RPC، وفحوصات الجاهزية والصحة، والحسابات (عبارة استرداد → عنوان qor)، ومنذ 0.8.0 توقيع المعاملات الهجين + البث (‏ML-DSA-87 + secp256k1، كما تتطلب الشبكتان؛ وقبل 0.8.0 كانت توقّع توقيعًا كلاسيكيًا فقط ولم تكن تعمل منها سوى القراءات — راجع RDK 0.8.0: التغييرات والحدود). جميعها متحقق منها مقابل متجهات ذهبية مشتركة عبر اللغات وجميعها منشورة في سجلاتها:

# Python — installs as qorechain-rdk, imports as qorrdk
pip install qorechain-rdk

# Rust
cargo add qorechain-rdk

# Go (pin the version)
go get github.com/qorechain/qorechain-rdk/packages/go@v0.9.0

# Java (Maven / Gradle)
# io.github.qorechain:qorechain-rdk:0.9.0 (needs Java 21)
import qorrdk

الإصدارات المنشورة حاليًا، وكلها 0.9.0 (جرى التحقق في 12 نوفمبر 2026): Python ‏qorechain-rdk ‏(PyPI، الاستيراد باسم qorrdk)، ووحدة Go ‏github.com/qorechain/qorechain-rdk/packages/go ‏(v0.9.0)، وRust ‏qorechain-rdk ‏(crates.io)، وJava ‏io.github.qorechain:qorechain-rdk ‏(Maven Central؛ Java 21 أو أحدث منذ 0.8.0). تقرأ هذه العملاء حالة السلسلة، ومنذ 0.8.0 ترسل معاملات موقَّعة توقيعًا هجينًا عندما تزوّدها بزوج مفاتيح ما بعد كمّي (راجع RDK 0.8.0: التغييرات والحدود).

ملاحظة

تستهدف TypeScript RDK وقوالبها افتراضيًا شبكة الاختبار qorechain-diana، وتصل الإعدادات المسبقة إلى نقاط الوصول العامة الحية مباشرة دون إعداد. ثبّت الإصدارات وتحقق على شبكة الاختبار قبل الشبكة الرئيسية.

تهيئة مشروع باستخدام create-qorechain-rollup​

لكل ملف تعريف قالب بداية مطابق (defi-rollup، ‏gaming-rollup، ‏nft-rollup، ‏enterprise-rollup، ‏custom-rollup). هيّئ أحدها بأي من الصيغتين:

npm create qorechain-rollup my-rollup
# or
npx create-qorechain-rollup my-rollup

للاستخدام غير التفاعلي / في بيئات CI، مرّر القالب والشبكة صراحة:

npx create-qorechain-rollup my-rollup --template defi-rollup --network testnet --yes

تعرض أداة التهيئة تكلفة الحصة وحرق الإنشاء الموثّقة، والخطوات التالية لإنشاء الـ rollup الخاص بك وقراءة حالته.

ما الذي تستطيع النصوص المهيَّأة فعله

تعتمد قوالب create-qorechain-rollup 0.9.0 على @qorechain/rdk ‏^0.9.0. تتصل نصوصها create وsubmit-batch عبر connectOperator() في src/signer.ts، التي تحلّ مفتاحك ما بعد الكمّي من QORE_MNEMONIC (أو من QORE_PQC_SEED_HEX عندما توقّع بـ QORE_OPERATOR_PRIVATE_KEY_HEX)، وتفحصه مقابل السلسلة، وتوقّع توقيعًا هجينًا؛ وإذا لم يُضبط أي منهما يحذّر النص ويوقّع توقيعًا كلاسيكيًا فقط، وترفضه الشبكتان. لم يُنشأ أي rollup عبر قالب على شبكة حية، لذا فهذا المسار غير مختبَر حيًا. نص submit-batch في قالب البداية هو تدفق مرجعي فقط: فهو يترك منذ 0.6.1 الحقل dataHash فارغًا (إذ ترفض السلسلة تجزئة بيانات على rollup بتوفر بيانات أصلي)، وتنشر القوالب المتفائلة جذر الحالة المعتمد بدلًا من قيمة نائبة؛ وما زال يستخدم قيمًا توضيحية لبقية الحقول، ولا يُتوقع أن ينهي دفعة على شبكة حية. ويتوقف قالب defi-rollup (ZK) قبل إرسال دفعة اعتبارًا من 0.7.0، لأن السلسلة سترفضها (راجع ZK / STARK والسحوبات).

بناء تكوين rollup من الكود​

ابنِ تكوينًا من إعداد مسبق، واقرأ الحصة ومعدل الحرق الحيين من السلسلة، ثم أنتج رسالة الإنشاء. يفرض منشئ التكوين مصفوفة التوافق بين التسوية والبرهان عند استدعاء validate() / build(). أرسل القيم الناتجة عبر CLI أعلاه، أو عبر عميل TypeScript مزوَّد بـ pqcKeypair — راجع RDK 0.8.0: التغييرات والحدود.

import { createRdkClient, presets, estimateCreationCost, uqorToQor } from "@qorechain/rdk";

// A config builder pre-filled with the defi preset's defaults; override via .set({ ... }).
const config = presets.defi({ rollupId: "my-defi-rollup" }).validate();

// The public qore.host endpoints are baked into the presets (RDK ≥ 0.4.2).
// `params()` is a REST read of /qorechain/rdk/v1/params, served on both networks.
const rdk = createRdkClient({ network: "testnet" });

// Read the live module parameters — never hardcode the stake or burn rate.
const params = await rdk.params();
const cost = estimateCreationCost({
stakeUqor: params.minStakeForRollup,
burnRate: params.rollupCreationBurnRate,
});
console.log(`Stake: ${uqorToQor(cost.stakeUqor)} QOR — burned: ${uqorToQor(cost.burnUqor)} QOR`);

// The values to pass to `qorechaind tx rdk create-rollup`.
const msg = config.toCreateMsg("<your qor address>", { stakeAmount: params.minStakeForRollup });
console.log(msg.rollupId, msg.profile, msg.vmType, msg.stakeAmount);

لست متأكدًا من ملف التعريف المناسب؟ من المفترض أن يعيد rdk.suggestProfile(...) توصية بمساعدة QCAI؛ وعلى نقاط الوصول العامة الحالية يعيد دائمًا الخيار الاحتياطي defi (‏source: "fallback")، لذا اختر من جدول ملفات التعريف.

قراءة الحالة من الكود​

لا يحتاج عميل REST المنمّط إلى موقّع، ويقرأ من الشبكتين:

const rollup = await rdk.rest.getRollup("my-defi-rollup");
console.log(rollup.status, rollup.settlementMode, rollup.daBackend, rollup.vmType);

بالنسبة إلى الدفعات، استخدم rdk.rest.getBatch(rollupId, index) أو qorechaind query rdk batch [rollup-id] (أدناه)؛ وتقرأ الدالتان getLatestBatch وlistBatches منذ 0.6.0 مسار latest_batch في السلسلة وكل صفحات قائمة الدفعات (راجع RDK 0.8.0: التغييرات والحدود).


إدارة دورة الحياة​

يمر الـ rollup بالحالات pending وactive وpaused وstopped؛ ويبدأ الـ rollup الجديد بحالة active فورًا. لا يستطيع إيقافه مؤقتًا أو استئنافه أو إيقافه نهائيًا سوى المنشئ (يُفرض ذلك منذ إصدار السلسلة v3.2.0). يتبع كل أمر أدناه نمط الخطوتين نفسه الخاص بالإنشاء: توليد المعاملة غير الموقَّعة، ثم توقيعها توقيعًا مشتركًا.

الإيقاف المؤقت​

أوقف الـ rollup مؤقتًا. تُحفظ الحالة ويمكن استئناف الـ rollup. يلزم تقديم نص يوضح السبب.

qorechaind tx rdk pause-rollup [rollup-id] [reason] \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > pause.json
qorechaind tx pqc cosign pause.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana

الاستئناف​

استأنف rollup سبق إيقافه مؤقتًا.

qorechaind tx rdk resume-rollup [rollup-id] \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > resume.json
qorechaind tx pqc cosign resume.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana

الإيقاف النهائي​

أوقف الـ rollup نهائيًا وحرر حصته. تُعاد عملات QOR المحجوزة — مطروحًا منها حرق الإنشاء لمرة واحدة، ومطروحًا منها أي مبلغ سبق دفعه من ضمان الـ rollup عبر السحوبات أو مكافآت إثباتات الاحتيال — إلى المنشئ: فمنذ v3.2.3 يسجّل سجل ضمان لكل rollup ما لا يزال كل rollup يحتفظ به، ويعيد stop-rollup هذا الرصيد بالضبط، ولا يدفع الـ rollup المتوقف أي سحوبات أخرى. وتُعاد حصة تسجيل الطبقة البالغة 1,000 QOR بشكل منفصل عند إخراج طبقة الـ rollup من الخدمة.

اعتبارًا من السلسلة v3.2.5 (على الشبكتين): لا يمكن إيقاف rollup ما دامت آخر دفعة فيه submitted أو challenged، فسوِّها أو أنهِها أولًا؛ ويُخلي الـ rollup المتوقف خانته ضمن حد الـ rollups في الوحدة. وقبل v3.2.5 لم تكن أي من القاعدتين تنطبق. ومن TypeScript، تخبرك stopRollupError والفحص المسبق في stopRollup قبل أن تدفع الرسوم.

qorechaind tx rdk stop-rollup [rollup-id] \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > stop.json
qorechaind tx pqc cosign stop.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
خطر

إيقاف الـ rollup نهائي. لا يمكن إعادة تشغيل الـ rollup بعد إيقافه.


أوامر المشغّل: الدفعات والاعتراضات​

يرسل مشغّلو الـ rollup دفعات التسوية، ويمكن للمعترضين الطعن في الدفعات التفاؤلية. تشكل هذه الأوامر أساس طبقة التسوية الموضحة في نظرة عامة على الـ Rollups و**ZK / STARK والسحوبات**.

من يمكنه الإرسال، وبأي ترتيب​

  • لا يستطيع إرسال الدفعات سوى عنوان المرتِّب المهيَّأ للـ rollup — أو منشئه عندما لا يكون هناك عنوان مهيَّأ (في كل الإعدادات المسبقة). لا يقبل الترتيب القائم (based) والمشترك (shared) حتى الآن مجموعات مقترِحين أو قوائم: فهي مجرد تسميات اليوم، والمنشئ هو من يرسل.
  • تشكّل الدفعات سلسلة: للدفعة الأولى الفهرس 0؛ ويجب أن تستخدم كل دفعة لاحقة الفهرس التالي وأن تحمل جذر حالة الدفعة السابقة بوصفه prev_state_root.
  • تُرفض الدفعة التي تحمل تجزئة بيانات (data hash) على rollup من نوع native أو both ما لم تكن كتلة بيانات (blob) مطابقة مخزّنة بالفعل (راجع توفر البيانات). ولا تُفحص الدفعة التي لا تحمل تجزئة بيانات.
  • يجب على rollup من نوع zk إرفاق برهان، ويجب أن يجتاز البرهان التحقق؛ ولا يمكن قبول أي دفعة ZK حتى الآن (راجع ZK / STARK والسحوبات).
  • اعتبارًا من السلسلة v3.2.5 (على الشبكتين): يجب أن يكون withdrawals_root الخاص بالدفعة فارغًا أو 32 بايتًا بالضبط، ويحتفظ الـ rollup بما لا يزيد على 4,096 دفعة متفائلة معلّقة (‏MAX_PENDING_OPTIMISTIC_BATCHES في RDK)؛ كما تنتهي الدفعات بترتيب الفهرس، فتنتظر الدفعة اللاحقة دفعة أقدم ما زالت submitted أو challenged. ويفحص RDK طول الجذر قبل كل إرسال. وقبل v3.2.5 لم تكن أي من هذه القواعد الثلاث تنطبق.

إرسال دفعة​

أرسل دفعة تسوية لـ rollup. يأخذ الأمر معرّف الـ rollup، ورقم فهرس الدفعة، وجذر حالة مرمّزًا بالنظام الست عشري. وبالنسبة إلى كل دفعة بعد الأولى، مرّر جذر حالة الدفعة السابقة بوصفه --prev-state-root.

qorechaind tx rdk submit-batch [rollup-id] [batch-index] [state-root-hex] \
--prev-state-root <previous-state-root-hex> --tx-count 120 \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > batch.json
qorechaind tx pqc cosign batch.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
العلمالوصف
--prev-state-rootجذر الحالة بالنظام الست عشري الذي تبدأ منه الدفعة (مطلوب لكل دفعة بعد الفهرس 0)
--tx-countعدد معاملات الـ rollup في الدفعة
--data-hashتجزئة بالنظام الست عشري لبيانات الدفعة المنشورة كـ blob في DA (اتركه فارغًا اليوم: لا توجد طريقة لنشر blob، راجع توفر البيانات)
--withdrawals-rootجذر Merkle بالنظام الست عشري لسحوبات الدفعة من L2 إلى L1 (راجع ZK / STARK والسحوبات)
--anchor-signatureتوقيع ML-DSA-87 بالنظام الست عشري من منشئ الـ rollup على بايتات توقيع التثبيت v2 (منذ v3.2.2)؛ وتُثبَّت الدفعة عندئذٍ في x/multilayer في المعاملة نفسها، ويؤدي رفض التثبيت إلى رفض الدفعة
--validator-set-hashالتزام مجموعة المدقّقين بالنظام الست عشري الذي يحمله التثبيت ويغطيه التوقيع

بدون --anchor-signature تُسوّى الدفعة غير مثبَّتة. ولتثبيت دفعة، اطبع البايتات المراد توقيعها، ووقّعها بمفتاح المنشئ المسجَّل ما بعد الكمّي، ومرّر التوقيع (يجب أن تطابق القيمتان --tx-count و--validator-set-hash ما ترسله):

qorechaind query rdk anchor-sign-bytes [layer-id] [batch-index] [state-root-hex] \
--chain-id qorechain-diana --tx-count 120

layer-id هو معرّف طبقة الـ rollup (وهو معرّف الـ rollup نفسه بالنسبة إلى الـ rollups المنشأة بواسطة RDK). ومن TypeScript، توقّع RdkTxClient.submitBatch في @qorechain/rdk بالإصدار 0.6.0 وما بعده التثبيت نيابةً عنك عندما يوقّع العميل توقيعًا هجينًا ويكون منشئ الـ rollup، وتعطي anchorSignBytesForBatch المنشئَ البايتات ليوقّعها خارج القناة (راجع RDK 0.8.0: التغييرات والحدود). ليس للعلم --proof الخاص بـ ZK في rollup من نوع zk علم في CLI اليوم، ورسالة حسم الاعتراض ليست أمرًا في CLI: استخدم عميلًا. راجع إيصالات التسوية لمعرفة ما يثبته التثبيت وما لا يثبته. لا يوجد rollup ولا طبقة ولا تثبيت على أي من الشبكتين حتى الآن.

الاعتراض على دفعة (الـ rollups التفاؤلية)​

يمكن لأي حساب الاعتراض على دفعة بحالة submitted ضمن نافذة الاعتراض (100,800 كتلة افتراضيًا لدفعة أُرسلت على الشبكة الرئيسية قبل الارتفاع 3,742,566؛ ومنذ v3.2.4، نافذة بالثواني من زمن الكتلة للدفعات الجديدة: على شبكة الاختبار منذ الارتفاع 8,337,253، وعلى الشبكة الرئيسية منذ الارتفاع 3,742,566) عبر إيداع ضمان (‏challenge_bond الخاص بالـ rollup؛ ‏1,000 QOR للإعدادين المسبقين nft وcustom) وبرهان احتيال. يُحكم على الدفعة المتفائلة بما إذا كان جذر حالتها هو جذر الانتقال المعتمد، لذا ينبغي لمن يرسلها أن ينشر ذلك الجذر بالضبط (وهذا ما تفعله قوالب RDK منذ 0.6.1؛ راجع RDK 0.8.0: التغييرات والحدود). يأخذ الأمر معرّف الـ rollup وفهرس الدفعة؛ مرّر برهان الاحتيال عبر --proof:

qorechaind tx rdk challenge-batch [rollup-id] [batch-index] \
--proof <hex-encoded-fraud-proof> \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > challenge.json
qorechaind tx pqc cosign challenge.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
العلمالوصف
--proofبرهان احتيال مرمّز بالنظام الست عشري

يؤدي الاعتراض إلى تجميد الدفعة (‏challenged): فلا يمكن إنهاؤها. وقبل v3.2.5 كان منشئ الـ rollup وحده يستطيع حسمه؛ واعتبارًا من v3.2.5 (على الشبكتين) يستطيع أي حساب ذلك، كما هو موصوف أدناه. ويُرسل الحسم برسالة حسم الاعتراض (غير متاحة كأمر CLI؛ استخدم عميلًا). تقرر السلسلة النتيجة بنفسها عبر التحقق من البرهان المخزَّن. إذا ثبت الاحتيال تصبح الدفعة rejected ويُعاد الضمان ويُمنح المعترض مبلغًا إضافيًا مساويًا للضمان من حصة الـ rollup؛ وإذا رُفض الاعتراض يذهب الضمان إلى المنشئ وتعود الدفعة إلى submitted.

اعتبارًا من السلسلة v3.2.5 (على الشبكتين): يستطيع أي حساب حسم اعتراض، لا المنشئ وحده. ويرفض الاحتيال المثبَت تلك الدفعة وكل دفعة لاحقة لم تنتهِ بعد، ويعيد المرتِّب إرسال تلك الدفعات من آخر جذر حالة سليم بالفهارس نفسها؛ ويواصل الـ rollup من هناك. ويميّز برج المراقبة مثل هذه الدفعات بالفهرس وجذر الحالة (راجع برج المراقبة).

فحص الدفعات​

# Latest batch for a rollup
qorechaind query rdk batch [rollup-id]

# A specific batch by index
qorechaind query rdk batch [rollup-id] --index 42

# A page of batches in index order (--limit up to 100, default 50)
qorechaind query rdk batches [rollup-id] --start 0 --limit 50

الاستعلام​

الأمرالغرض
qorechaind query rdk rollup [rollup-id]تفاصيل rollup محدد
qorechaind query rdk list-rollupsجميع الـ rollups المسجلة
qorechaind query rdk batch [rollup-id]أحدث دفعة تسوية (أو --index)
qorechaind query rdk batches [rollup-id]صفحة من الدفعات بترتيب الفهرس (--start، --limit)
qorechaind query rdk anchor-sign-bytes [layer-id] [batch-index] [state-root-hex]بايتات توقيع التثبيت v2 لدفعة (دون اتصال)
qorechaind query rdk configمعاملات وحدة RDK
qorechaind query rdk suggest-profile [use-case]يطبع مؤشرًا إلى استدعاء RPC ‏qor_suggestRollupProfile؛ ولا تقدّمه نقاط الوصول العامة، لذا اختر ملف تعريف من جدول ملفات التعريف المسبقة

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