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

إيصالات التسوية

إيصال التسوية هو سجل محمول يثبت أن دفعة التسوية الخاصة بـ rollup قد تم تثبيتها (anchored) على السلسلة الرئيسية بموجب توقيع ما بعد الكم. وهو يسمّي الـ rollup والدفعة والمرساة، ويحمل توقيع ML-DSA-87 ‏(Dilithium-5، ‏FIPS-204) الخاص بالمرساة، وهو نفس المخطط الذي تستخدمه السلسلة الرئيسية.

مرحلة مبكرة: لا توجد مراسٍ بعد

تعتمد الإيصالات على المراسي، ولا يوجد أي rollup أو مرساة على أيٍّ من الشبكتين حتى الآن (جرى التحقق في 27 أكتوبر 2026). منذ الإصدار v3.2.2 (الحي على كلتا الشبكتين) تُثبَّت الدفعة المُرسلة مع anchor_signature في x/multilayer ضمن المعاملة نفسها؛ أما الدفعة المُرسلة بدونه فتُسوّى غير مثبَّتة. يرسل RDK بلغة TypeScript (الإصدارات من 0.6.0 وما بعده) هذا الحقل عندما يوقّع عميل معاملاته توقيعًا هجينًا ويكون هو منشئ الـ rollup، ويُرسل دفعات غير مثبَّتة في غير ذلك؛ أما عملاء Python وGo وRust وJava فتوقّع توقيعًا هجينًا منذ 0.8.0 لكنها لا تبني هذا الحقل (تم التحقق من Python). ولم يُجرَّب أي من هذا على rollup حي. تعامل مع هذه الصفحة على أنها وصف للتصميم ولمكوّناته الأساسية، وليست وصفًا لخدمة يمكنك الاعتماد عليها اليوم.

الإيصال ادّعاء وليس دليلًا​

كل حقل في الإيصال يوفّره من يسلّمه إليك. والتحقق من التوقيع مقابل مفتاح أُعطيتَ إياه يُظهر أن شخصًا ما يحمل ذلك المفتاح قد وقّع تلك البايتات؛ لكنه لا يُظهر أن QoreChain ثبّتت أي شيء. ولذلك تحتاج الجهة المتحقِّقة إلى عميل متصل بعقدة QoreChain تثق بها، وتعيد قراءة الادّعاء من حالة السلسلة: الـ rollup وطبقته، والدفعة وجذر حالتها، والمرساة، ومفتاح ما بعد الكم المسجَّل للمنشئ.

ما الذي توقّعه المرساة​

يُنشأ توقيع المرساة بواسطة مفتاح ML-DSA-87 المسجَّل الخاص بـمنشئ الـ rollup. وتعتمد الرسالة الموقَّعة على الارتفاع الذي تُرسَل عنده المرساة. منذ الإصدار v3.2.2 (ارتفاع الشبكة الرئيسية 3,556,788، وارتفاع شبكة الاختبار 6,905,034) تكون الرسالة هي رسالة v2: وسم نطاق (domain tag)، ومعرّف السلسلة، ثم الحقول layer_id وlayer_height وstate_root وvalidator_set_hash وعدد المعاملات وإثبات الحالة المضغوط، كلٌّ منها مسبوق بطوله (التخطيط الدقيق في قراءة المراسي). ولا تقبل السلسلة مرساة v1 (layer_id || layer_height || state_root || validator_set_hash، بلا معرّف السلسلة) ابتداءً من ذلك الارتفاع. لا تُدرج أيًّا من الصيغتين في الشيفرة بقيمة ثابتة: اقرأ بايتات التوقيع الخاصة بالشبكة التي تستهدفها. يبني RDK بايتات v2 بالدالة anchorSignBytesForBatch (وكلتا الصيغتين بالدالتين anchorSignBytesV1 / anchorSignBytesV2)، وتطبعها واجهة سطر الأوامر، مثلًا عبر qorechaind query rdk anchor-sign-bytes <layer-id> <batch-index> <state-root-hex> --chain-id <id> --tx-count <n>.

والمرساة كائن على مستوى الطبقة: فهي لا تسمّي الـ rollup ولا الدفعة، ولذلك تربط الجهة المتحقِّقة بينهما عبر قراءات من السلسلة (راجع البنية متعددة الطبقات).

قراءة المراسي​

يمكن قراءة المراسي عبر REST وgRPC ‏(/qorechain/multilayer/v1/anchor/{layer_id} لأحدث مرساة و/qorechain/multilayer/v1/anchors/{layer_id} للسجل)، ويمكن قراءة مفتاح ما بعد الكم المسجَّل لحساب ما عبر /qorechain/pqc/v1/account/{address} (account بصيغة المفرد). وتُقرأ دفعات الـ rollup عبر مسارات REST الخاصة بالـ RDK (/qorechain/rdk/v1/batch/{rollup_id}/{batch_index} و/qorechain/rdk/v1/latest_batch/{rollup_id} و/qorechain/rdk/v1/batches/{rollup_id}) التي تخدمها الشبكتان كلتاهما، أو بالأمر qorechaind query rdk batch [rollup-id].

البناء والتحقق (TypeScript)​

import {
createRdkClient,
buildSettlementReceipt,
verifySettlementReceipt,
} from "@qorechain/rdk";

const rdk = createRdkClient({ network: "testnet" });

// Build a receipt for one batch (throws if no anchor covers the batch yet).
const receipt = await buildSettlementReceipt(rdk, "my-rollup", 7);

// Verify it against chain state — pass a client; a receipt on its own proves nothing.
const result = await verifySettlementReceipt(receipt, { client: rdk });
console.log(result.valid);

مرّر client عند كل عملية تحقق. فقد تغيّرت واجهة الإيصالات وفحوصاتها بين الإصدارات، ولذلك استخدم الإصدار 0.8.0 (الإصدار الحالي؛ وفحوصات الإيصالات فيه هي التي استُحدثت في 0.6.1 ولم تتغير منذئذٍ): فالإصدار 0.5.0 لم يكن يستطيع إكمال فحص السلسلة، والإصدار 0.6.0 لم يكن يقارن كل حقل من حقول الإيصال (انظر أدناه). وتوفّر عملاء Python وGo وRust وJava نفس واجهة البناء/التحقق؛ وتستخدم إصداراتها 0.6.1 وما بعدها مسار البحث عن المفتاح بصيغة المفرد نفسه والاختيار نفسه لرسالة المرساة بحسب الارتفاع والمقارنة نفسها حقلًا بحقل.

ما الذي يتحقق منه الإصدار 0.8.0​

لا تُبلغ verifySettlementReceipt عن valid استنادًا إلى الإيصال وحده أبدًا: فبدون client تكون النتيجة mode: "signature-only" وvalid: false. ومع client تعيد قراءة السلسلة وتُبلغ عن كل فحص على حدة:

  • rollupLayerBinding: تفيد السلسلة بأن الـ rollup ينتمي إلى طبقة الإيصال؛
  • batchStateRoot: تحمل دفعة السلسلة جذر حالة الإيصال؛
  • anchorOnChain: توجد على السلسلة مرساة تطابق كل حقل من حقول المرساة التي يذكرها الإيصال: جذر الحالة، وارتفاع الطبقة، وتجزئة مجموعة المدقّقين، والتوقيع، وارتفاع السلسلة الرئيسية، ووقت المرساة، والخوارزمية والإصدار، وفي إيصال الإصدار 2 عدد المعاملات وإثبات الحالة المضغوط. ويُسمّي أي عدم تطابق الحقلَ المعني؛
  • creatorAuthority: قُرئ مفتاح التوقيع من السلسلة (/qorechain/pqc/v1/account/{address})، ولم يؤخذ من الإيصال؛
  • pqcSignature: يتحقق توقيع ML-DSA-87 على رسالة المرساة القانونية؛
  • chainBinding: يسمّي الإيصال السلسلة التي استُعلم عنها فعلًا.

تُختار رسالة المرساة بحسب الارتفاع الذي سُجّلت عنده المرساة (v1 قبل نقطة التحوّل في v3.2.2، وv2 منها فصاعدًا)، ولا تُجرَّب الصيغتان معًا أبدًا، لأن توقيع v1 لا يحمل معرّف سلسلة وكان سيتحقق على كل سلسلة. وتحمل الحزمة ارتفاع التحوّل للشبكة الرئيسية (3,556,788) ولشبكة الاختبار (6,905,034). وتُبلغ النتيجة عن الصيغة التي استخدمتها في signBytesVersion. ويسجّل مخطط الإيصال v2 قيمة chainId؛ أما إيصال الإصدار 1 فلا يحملها، ولذلك يجتاز chainBinding فقط لأن مرساته وُجدت على السلسلة التي استعلمتَ عنها. ويرفض التحقق إيصالًا جرى فحصه مقابل عقدة تتبع سلسلة أخرى. وقبل قراءة أي شيء من السلسلة، ترفض receiptSchemaError إيصالًا ذا version غير معروف، أو algorithm غير ML-DSA-87، أو (في الإصدار 2) بلا chainId.

منذ الإصدار 0.6.1 تحمل النتيجة أيضًا anchor الخاصة بالسلسلة نفسها، وعندما تكون valid صحيحة (true) تحمل verifiedReceipt أُعيد بناؤه من حالة السلسلة (verified_receipt في Python وRust، وVerifiedReceipt في Go): اقرأ الوقائع من هذه، لا من الإيصال الذي سُلّم إليك. ويُعيد qorollup receipt verify --json ذلك الإيصال المقروء من السلسلة بوصفه receipt (وهو null عندما لا يكون الإيصال صالحًا) بدلًا من ترديد الملف. وتظل إيصالات الإصدار 1، التي تسبق عدد المعاملات والإثبات، قابلة للتحقق.

لا توجد أي مرساة على أيٍّ من الشبكتين، ولذلك لم يُفحص هذا إلا مقابل شيفرة الحزمة وفي وضع غير متصل، لا مقابل مرساة حقيقية. ولا تعمل buildSettlementReceipt إلا بعد أن تغطي مرساةٌ الدفعة.

إصدارات ما قبل 0.6.1

طابقت verifySettlementReceipt في الإصدار 0.6.0 مرساة السلسلة على جذر حالتها وارتفاع طبقتها وتجزئة مجموعة المدقّقين وتوقيعها، لكنها لم تقارن الحقول الأخرى التي يعرضها الإيصال (ارتفاع السلسلة الرئيسية، ووقت المرساة، والخوارزمية، والإصدار، وفي إيصال الإصدار 2 عدد المعاملات وإثبات الحالة المضغوط)، وعاملت جذر حالة الدفعة بوصفه معلومة إرشادية. أما ادّعاء التسوية نفسه (جذر الحالة وتوقيع المرساة ومفتاح المنشئ) فكان مربوطًا دائمًا؛ وما لم يكن بوسع 0.6.0 إخبارك به هو ما إذا كانت البيانات الوصفية المطبوعة بجواره تطابق السلسلة. استخدم الإصدار 0.8.0.

أخفقت verifySettlementReceipt في الإصدار 0.5.0 بصورة آمنة (fail-closed) مقابل الشبكات الحيّة، لسببين كانا في العميل لا في السلسلة: فقد كانت تبحث عن مفتاح المنشئ عبر صيغة الجمع accounts من مسار حساب ما بعد الكم، وهو مسار لا تخدمه الشبكتان (HTTP 501)، وكانت تعيد بناء رسالة v1 فقط، التي لا تقبلها السلسلة للمراسي منذ الإصدار v3.2.2. ولذلك لم يكن بوسع إيصال حقيقي أن يتحقق، ومع ذلك كان الإيصال المزوَّر يُرفض. استخدم الإصدار 0.8.0.

واجهة سطر الأوامر (CLI)​

qorollup receipt my-rollup 7 # build and print
qorollup receipt my-rollup 7 --out receipt.json

راجع نشر Rollup للاطلاع على واجهة سطر الأوامر الكاملة للمشغّل qorollup.