نشر 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 على السلسلة، استخدم واجهة سطر الأوامر أدناه.
الخطوات
- سجّل الدخول. يتطلب النموذج جلسة مصادَق عليها لإرسال طلب ولعرض طلباتك الحالية.
- سمِّ الـ rollup الخاص بك. أدخل اسمًا للـ rollup (من 2 إلى 41 حرفًا: حروف، أرقام، مسافات، شرطات، أو شرطات سفلية).
- اختر آلة افتراضية. يخزّن السجل على السلسلة تسمية للآلة الافتراضية. يُنفَّذ الـ rollup الخاص بك خارج السلسلة في بيئة تشغيل خاصة به؛ ولا يعمل الاختيار على مسارات EVM أو QoreChain Native أو SVM الخاصة بـ QoreChain نفسها:
- EVM — عقود Solidity / Vyper مع كامل أدوات Ethereum (Hardhat، Foundry، MetaMask)
- QoreChain Native — عقود ذكية بلغة Rust على بيئة تشغيل Cosmos SDK (بيئة تشغيل CosmWasm)، مع دعم IBC أصلي
- SVM — آلة Solana الافتراضية، للتطبيقات ذات التنفيذ المتوازي والإنتاجية العالية
- اختر طبقة توفر البيانات (DA). المكان الذي ينشر فيه الـ rollup بيانات المعاملات بحيث يمكن لأي شخص إعادة بناء الحالة: QoreChain DA أو Celestia أو EigenDA. لاحظ أن EigenDA خيار على مستوى لوحة التحكم، بينما خلفيات DA الخاصة بوحدة
x/rdkعلى السلسلة هي: الأصلية (native)، أو Celestia، أو كلاهما — راجع توفر البيانات. - حدد عملة الغاز. العملة المستخدمة لدفع تكاليف التنفيذ على الـ rollup الخاص بك. القيمة الافتراضية هي QOR؛ أدخل رمزًا مخصصًا لاستخدام عملتك الأصلية الخاصة.
- اختر المُرتِّب (sequencer). الجهة التي ترتّب المعاملات قبل التسوية: مرتِّب مشترك (المجموعة المشتركة لـ QoreChain)، أو مخصص (فردي) (تشغيل مرتِّب فردي خاص بك)، أو لامركزي (مجموعة مرتِّبات بلا إذن مسبق).
- اختر هدف التسوية. المكان الذي يثبّت فيه الـ rollup جذور حالته وبراهين صحته: الشبكة الرئيسية لـ QoreChain أو Ethereum.
- أرسل الطلب. تتم مراجعة التزويد من قِبل 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): إصلاح عاجل لواجهة
qorollupCLI للمشغّلين، التي صارت أوامر المعاملات فيها توقّع الآن توقيعًا هجينًا كما تتطلب الشبكتان. - 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-sdk0.10.x على PyPI، ووحدة Go github.com/qorechain/qorechain-sdk/packages/gov0.10.0، وqorechain-sdk0.10 على crates.io (وتنتقل Rust إلىcosmrs0.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، وواجهة
qorollupCLI منذ 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؛ ولا تقدّمه نقاط الوصول العامة، لذا اختر ملف تعريف من جدول ملفات التعريف المسبقة |
الخطوات التالية
- توفر البيانات — خلفيات DA الأصلية وCelestia والمكررة.
- ZK / STARK والسحوبات — التحقق من البراهين وتدفق السحب من L2 إلى L1 عبر
execute-withdrawal.