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

نظرة عامة على التجميعات

إن مجموعة تطوير التجميعات (Rollup Development Kit - RDK) الخاصة بـ QoreChain هي مجموعة من مكتبات العميل (TypeScript وPython وGo وRust وJava) وأداة سطر أوامر للمشغّلين وقوالب بدء جاهزة لبناء تجميعات (rollups) خاصة بالتطبيقات تُسوَّى على QoreChain عبر وحدة x/rdk على السلسلة. بها تهيّئ تجميعًا، وتبني معاملاته وتوقّعها، وتقرأ حالته، وتتابع نوافذ التحدي الخاصة به، وتُصدر إيصالات التسوية وتتحقق منها، وتجمّع استدعاءات الآلات الافتراضية المتقاطعة وإثباتات السحب. كل تجميع هو بيئة تنفيذ مستقلة لها زمن كتلة خاص بها، وآلة افتراضية، ونموذج رسوم، وترتيب معاملات خاص بها، بينما ترث أمان QoreChain والتشفير ما بعد الكمي وتوافر البيانات. هذه الصفحة موجّهة إلى المطورين الذين يريدون إطلاق تجميع أو تشغيله، وإلى كل من يقرر ما إذا كانت RDK تناسب تطبيقه.

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

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

تعمل الشبكة الرئيسية (qorechain-vladi، معرّف سلسلة EVM 9801، تعمل منذ 7 يونيو 2026) بإصدار السلسلة v3.2.7 (طبّقه مقترح الحوكمة 16 عند الارتفاع 4,164,600 في 12 نوفمبر 2026؛ وكان 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)؛ بينما تعمل شبكة الاختبار (qorechain-diana، معرّف سلسلة EVM 9800) بالإصدار v3.2.8 منذ 12 نوفمبر 2026 (الارتفاع 9,929,500؛ وصلها v3.2.4 في 19 أكتوبر 2026، وv3.2.5 في 26 أكتوبر، وv3.2.6 في 27 أكتوبر، وv3.2.7 في 6 نوفمبر). الشبكة الرئيسية متأخرة بإصدار واحد عن شبكة الاختبار: فهي لم تطبّق v3.2.8. وما يغيّره v3.2.5 بالنسبة إلى التجميعات مذكور تحت سلوك إصدار السلسلة v3.2.5؛ وهو ينطبق على الشبكتين. وحيثما تغيّر السلوك بين v3.2.3 وv3.2.4، يذكر هذا القسم أيّ الإصدارين ينطبق. تحقق من كل عملية نشر على شبكة الاختبار أولًا، واقرأ ملاحظات الحالة في كل صفحة: فعدة قدرات (التحقق بإثباتات ZK، وتوافر البيانات عبر Celestia، ومساعد QCAI، واستدعاءات الآلات الافتراضية المتقاطعة، وإيصالات التسوية) غير قابلة للاستخدام من البداية إلى النهاية اليوم.

الابتكارات​

  • إيصالات تسوية بتوقيع ما بعد كمي. يُوقَّع مرساة حالة الدفعة بـ ML-DSA-87 بواسطة المفتاح المسجّل لمنشئ التجميع. تعيد verifySettlementReceipt قراءة كل حقل من حقول الإيصال من السلسلة (التجميع، والطبقة، وجذر الدفعة، والمرساة: جذر الحالة، وارتفاع الطبقة، وارتفاع السلسلة الرئيسية، ووقت المرساة، وبصمة مجموعة المدققين، وعدد المعاملات، والإثبات، والتوقيع). ويأتي مفتاح التحقق من السلسلة ولا يأتي أبدًا من الإيصال؛ ويجب أن يسمّي الإيصال الشبكة التي تستعلم عنها؛ ويُرفض أي إصدار إيصال غير معروف أو أي خوارزمية غير ML-DSA-87 قبل أي قراءة؛ ولا يُبلَّغ أبدًا عن فحص التوقيع وحده على أنه صالح. لرسالة المرساة صيغة أولى دون ارتفاع إصدار السلسلة v3.2.2 وصيغة ثانية، تربط أيضًا معرّف السلسلة، منه فصاعدًا؛ ويُختار الإصدار بحسب ارتفاع المرساة. راجع إيصالات التسوية.
  • توقيع هجين باشتقاقين للمفتاح. تُوقَّع المعاملات بـ secp256k1 مع ML-DSA-87. يُشتق المفتاح ما بعد الكمي من العبارة السرية (mnemonic) بالطريقة القياسية (SHAKE-256 على qorechain:pqc:v1| والعنوان والعبارة السرية) وبالطريقة القديمة معًا، ويستخدم العميل أيَّ مفتاح سجّلته السلسلة للحساب. توقّع عملاء Python وGo وRust وJava توقيعًا هجينًا منذ 0.8.0، وتوقّعه واجهة سطر الأوامر منذ 0.7.1؛ وقبل ذلك لم يكن يوقّعه إلا عميل TypeScript.
  • إثباتات سحب مبنية كما تبنيها السلسلة. تبني withdrawalsTree (0.7.0، في اللغات الخمس) جذر عمليات السحب الخاص بالدفعة وكل إثبات تمامًا كما تفعل السلسلة: موضع الورقة هو فهرس السحب، وتُجزَّأ العقد بـ SHAKE-256، وتستخدم الدفعات الصادرة من إصدار السلسلة v3.2.5 أوراقًا من الصيغة الثانية تسمّي أيضًا معرّف السلسلة. وقد جرى اختبارها مقابل متجهات ولّدتها شيفرة السلسلة نفسها، وكل إثبات في تلك المتجهات يقبله مُتحقِّق السلسلة. يرفض qorollup withdraw قبل دفع أي رسوم إذا لم تكن نتيجته هي withdrawals_root الخاص بالدفعة على السلسلة.
  • جذر الانتقال القياسي. تحسب batchTransitionRoot جذر الحالة الدقيق الذي تحكم السلسلة على أساسه في الدفعة المتفائلة (الصيغة التي تطبّقها الشبكة الرئيسية اليوم هي التزام SHAKE-256 بجذر الحالة السابق وبصمة البيانات وعدد المعاملات؛ وتختار transitionRootVersionFor الصيغة التي تطبّقها الشبكة المتصلة)، وتبني fraudProof إثبات الـ 64 بايت منه. جرى اختبار كليهما مقابل متجهات ولّدتها شيفرة السلسلة نفسها.
  • نوافذ تحدٍّ مطابقة للسلسلة تمامًا. تحسب batchChallengeWindow نافذة الدفعة بالطريقة التي تحسبها بها السلسلة (قائمة على الزمن: مفتوحة ما دام زمن الكتلة أقل من وقت الإرسال زائد النافذة؛ وللدفعات الأقدم: النافذة مقسومة على ستة بالكتل ابتداءً من ارتفاع الإرسال) وتحكم عليها مقابل رأس السلسلة المقروء من RPC /status لا مقابل الساعة المحلية. يستخدمها Watchtower ومراقب الصحة. ابتداءً من 0.7.0، تبلّغ getRollupHealth أيضًا عن heldBackBy عندما يحتجز الإنهاء بالترتيب في السلسلة (v3.2.5، على الشبكتين، راجع سلوك إصدار السلسلة v3.2.5) دفعةً ما، ويبلّغ qorollup watchtower --canonical عن الدفعات التي سيكسبها تحدٍّ.
  • فحوصات قبل دفع أي رسوم. ترفض المجموعة معرّف تجميع خارج ^[a-z0-9][a-z0-9._-]{2,63}$؛ وسحبًا ليس بعملة uqor أو مبلغه صفر أو يحمل إثباتًا أعمق من 64 مستوى من 32 بايت أو يسمّي عنوان bech32 غير صالح؛ وجذر عمليات سحب ليس فارغًا ولا بطول 32 بايت بالضبط؛ وإيقاف تجميع سترفضه السلسلة (v3.2.5 وما بعده)؛ وعندما تستطيع قراءة التجميع، دفعة تسمّي بصمة بيانات على تجميع توافر بياناته native أو both. كان كلٌّ من هذه سيُرفض لدى السلسلة بعد إنفاق الرسوم.
  • بيانات استدعاء عبر الآلات الافتراضية وفحص مباشر. تبني encodeCrossVmCalldata بيانات الاستدعاء لـ executeCrossVMCall(uint8,string,bytes) (المحدِّد 0x3c11078c، العقد المُصرَّف مسبقًا 0x...0901)، وتقرأ isCrossVmPrecompileActive ما إذا كان العقد المُصرَّف مسبقًا مفعّلًا على الشبكة. ابتداءً من 0.7.0، تغطي getCrossVmParams وcrossVmTargetReady وdecodeCrossVmResult وdecodeRevertReason قائمة السماح وصيغ الردود في إصدار السلسلة v3.2.5 (على الشبكتين). راجع الآلات الافتراضية المتعددة.
  • مجموعة واحدة من متجهات الاختبار لخمس لغات. تُفحص حزم TypeScript وPython وGo وRust وJava مقابل المجموعة المرجعية (golden fixture) نفسها (لحزمة Go ‏100 اختبار وحدة، ولـ Rust ‏77، ولـ Java ‏75).

كيفية الاستخدام​

القراءات لا تحتاج إلى مفتاح ولا إلى أموال. تقرأ المقتطفات أدناه معاملات وحدة rdk الحيّة وقائمة التجميعات على شبكة الاختبار العامة (qorechain-diana) وقد شُغّلت في 27 أكتوبر 2026 من الحزم المنشورة (استخدمت هذه التشغيلات 0.7.0؛ والإصدار الحالي هو 0.9.0؛ وأضاف 0.8.0 التوقيع الهجين إلى عملاء Python وGo وRust وJava ويترك استدعاءات القراءة المعروضة هنا دون تغيير، لكن المقتطفات لم تُعد تشغيلها معه). طبعت كلٌّ منها معاملات شبكة الاختبار (الحد الأقصى للتجميعات 200، والحد الأدنى للحصة 10,000 QOR، ومعدل الحرق عند الإنشاء 0.01، ونافذة التحدي الافتراضية 3,600 ثانية، والحد الأقصى لحجم blob توافر البيانات 2,097,152 بايت، ومدة الاحتفاظ بالـ blob 432,000 كتلة، وحد أقصى 10 دفعات لكل كتلة) و0 rollups.

TypeScript (مُختبَر)​

npm install @qorechain/rdk
import { createRdkClient } from "@qorechain/rdk";

// Public testnet (chain id qorechain-diana).
const rdk = createRdkClient({
network: "testnet",
endpoints: { rest: "https://api-testnet.qore.host" },
});

// Read the live rdk module parameters and the registered rollups.
const params = await rdk.params();
const rollups = await rdk.rest.listRollups();
console.log(rdk.network.chainId, params, `${rollups.length} rollups`);

تحمل الإعدادات المسبقة mainnet وtestnet نقاط النهاية العامة qore.host مسبقًا، ولذلك تعمل createRdkClient({ network: "testnet" }) دون الحقل endpoints؛ وهو معروض أعلاه لأن المقتطف المُختبَر مرّره. شغّله بـ Node 20 أو أحدث (استخدم الاختبار Node 26).

Python (مُختبَر)​

pip install qorechain-rdk
from qorrdk import create_rdk_client

# Public testnet (chain id qorechain-diana).
rdk = create_rdk_client(network="testnet", endpoints={"rest": "https://api-testnet.qore.host"})

# Read the live rdk module parameters and the registered rollups.
params = rdk.params()
rollups = rdk.rest.list_rollups()
print(rdk.network.chain_id, params, f"{len(rollups)} rollups")

يتطلب Python 3.10 أو أحدث. تعتمد qorechain-rdk على qorechain-pqc التي تسحب liboqs-python وتحتاج إلى مكتبة liboqs؛ وعلى جهاز لا تتوفر فيه، يبنيها أول استيراد (يلزم git وCMake ومترجم C). اختُبرت في بيئة افتراضية جديدة على Python 3.12.

Go (مُختبَر)​

go get github.com/qorechain/qorechain-rdk/packages/go@v0.9.0
package main

import (
"context"
"fmt"

rdk "github.com/qorechain/qorechain-rdk/packages/go"
)

func main() {
// Public testnet (chain id qorechain-diana).
client := rdk.NewRdkClient(rdk.RdkClientOptions{
Network: "testnet",
Endpoints: &rdk.Endpoints{Rest: "https://api-testnet.qore.host"},
})
ctx := context.Background()
// Read the live rdk module parameters and the registered rollups.
params, err := client.Params(ctx)
if err != nil {
panic(err)
}
rollups, _ := client.Rest.ListRollups(ctx)
fmt.Printf("%s %+v %d rollups\n", client.Network.ChainID, params, len(rollups))
}

اختُبرت مع Go 1.26، مع جلب الوحدة من وكيل Go.

Rust (مُختبَر)​

cargo add qorechain-rdk
use qorechain_rdk::client::{RdkClient, RdkClientOptions};

fn main() -> Result<(), Box<dyn std::error::Error>> {
// Public testnet (chain id qorechain-diana).
let rdk = RdkClient::new(RdkClientOptions {
rest_url: Some("https://api-testnet.qore.host".into()),
..Default::default()
});

// Read the live rdk module parameters and the registered rollups.
let params = rdk.params()?;
let rollups = rdk.rest.list_rollups()?;
println!("{} {:?} {} rollups", rdk.network.chain_id, params, rollups.len());
Ok(())
}

المكتبة هي qorechain_rdk. اختُبرت مع Rust 1.95، ومبنيّة مقابل crates.io.

Java (مُختبَر)​

// build.gradle.kts
implementation("io.github.qorechain:qorechain-rdk:0.9.0")
import io.github.qorechain.rdk.client.RdkClient;
import io.github.qorechain.rdk.client.Views.ParamsView;
import io.github.qorechain.rdk.config.Networks;

public class RdkQuickstart {
public static void main(String[] args) {
// Public testnet (chain id qorechain-diana).
RdkClient.Options options = new RdkClient.Options();
options.network = "testnet";
options.endpoints = new Networks.Endpoints();
options.endpoints.rest = "https://api-testnet.qore.host";
RdkClient rdk = new RdkClient(options);

// Read the live rdk module parameters and the registered rollups.
ParamsView params = rdk.params();
int rollups = rdk.rest.listRollups().size();
System.out.println(rdk.network.chainId + " maxRollups=" + params.maxRollups
+ " minStakeForRollup=" + params.minStakeForRollup + " " + rollups + " rollups");
}
}

يتطلب Java 21 أو أحدث منذ 0.8.0 (كان 0.7.1 وما قبله يعمل على JDK 17)؛ اختُبرت مع JDK 21 وGradle 9.6 مع الحل من Maven Central. يجب تسمية الملف RdkQuickstart.java. تخدّم Maven Central الإصدارات 0.7.0 و0.7.1 و0.8.0 (جرى التحقق في 31 أكتوبر 2026).

سطر الأوامر (مُختبَر)​

npm install -g @qorechain/rdk-cli
qorollup --version
qorollup params --network testnet

يطبع qorollup --version الإصدار المثبَّت (0.7.0 في تشغيل الاختبار) ويطبع qorollup params --network testnet معاملات الوحدة الحيّة. يعمل هذا ابتداءً من 0.6.2. كانت الإصدارات 0.6.1 وما قبله تخرج بالرمز 0 ولا تطبع شيئًا عند تثبيتها من npm. ثبّت الاختبار @qorechain/rdk-cli@0.7.0 في مشروع فارغ وشغّله عبر node_modules/.bin/qorollup؛ ويستخدم التثبيت العام وnpx رابط bin نفسه. يلزم Node 20 أو أحدث.

بناء هيكل مشروع (مُختبَر)​

npx create-qorechain-rollup my-rollup --template nft-rollup --network testnet --yes
cd my-rollup && npm run doctor

القوالب هي defi-rollup وgaming-rollup وnft-rollup وenterprise-rollup وcustom-rollup وmultivm-rollup. يعتمد المشروع المُهيكَل على @qorechain/rdk بالإصدار ^0.9.0 (و^0.8.0 في 0.8.0، و^0.7.0 قبله). أنتج بناء هيكل nft-rollup بمولّد الهياكل 0.6.1 مشروعًا نجح npm run doctor فيه مقابل شبكة الاختبار (REST قابل للوصول، والمعاملات قابلة للقراءة، والشبكة qorechain-diana؛ ويحذّر من توافر البيانات عبر Celestia ومن غياب موقِّع)؛ ونجح بناء هيكل defi-rollup وتشغيل npm run typecheck مرة أخرى في 27 أكتوبر 2026 مع الإصدار الحالي. لا تستخدم defi-rollup لإطلاق تجميع بعد (راجع الحدود). لإنشاء تجميع وإرسال الدفعات، اتبع نشر تجميع؛ تحتاج المعاملات إلى مفتاح ما بعد كمي مسجّل، وفي RDK إلى عميل TypeScript مزوَّد بـ pqcKeypair.

كيفية الوصول​

الشبكات ونقاط النهاية. تتحدث RDK مع نقاط النهاية العامة للشبكتين؛ وتحملها الإعدادات المسبقة mainnet وtestnet مسبقًا.

الشبكةمعرّف السلسلةمعرّف سلسلة EVMنقطة نهاية RESTإصدار السلسلة
الشبكة الرئيسيةqorechain-vladi9801https://api.qore.hostv3.2.7
شبكة الاختبارqorechain-diana9800https://api-testnet.qore.hostv3.2.8

تخدّم الشبكتان معًا استعلامات RDK (/qorechain/rdk/v1/...) عبر REST وgRPC وواجهة سطر الأوامر، ولذلك تعمل قراءات مثل rdk.params() مقابل أيٍّ منهما. شبكة الاختبار شبكة تجريبية لها معاملاتها الخاصة: نافذة التحدي الافتراضية 3,600 ثانية على شبكة الاختبار و604,800 على الشبكة الرئيسية، ويمكن أن يوجد 200 تجميع على الأكثر على شبكة الاختبار و100 على الشبكة الرئيسية، وتسمح وحدة multilayer بـ 64 طبقة جانبية على شبكة الاختبار و10 على الشبكة الرئيسية (جرى التحقق في 27 أكتوبر 2026). اقرأ GET /qorechain/rdk/v1/params على الشبكة التي تستهدفها.

متطلبات إنشاء تجميع.

المتطلبالتفاصيل
حساب ممولحساب فيه ما يكفي من QOR للحصة وحصة الطبقة والرسوم.
حصة مودعة في الضمان (escrow)يودع إنشاء تجميع min_stake_for_rollup في الضمان، أي 10,000 QOR على الشبكتين. يُحرق 1 % من الحصة (100 QOR) عند الإنشاء؛ ويبقى الباقي في الضمان ويُعاد عند إيقاف التجميع.
حصة الطبقةيسجّل الإنشاء أيضًا طبقة التجميع في وحدة multilayer (الحد الأدنى للحصة 1,000 QOR). إذا تعذّر تسجيل الطبقة، يُنشأ التجميع مع ذلك لكن دون طبقة حقيقية، فلا يمكن ترسيخ دفعاته ولا يمكن إصدار إيصالات.
مفتاح ما بعد كمي مسجّلمفتاح ML-DSA-87 مسجّل للحساب. تُرفض معاملات المسار الأصلي الموقّعة بالمفتاح الكلاسيكي وحده. يجب على الحساب الجديد تسجيل مفتاحه ما بعد الكمّي في معاملة مستقلة قبل أي شيء آخر؛ وعملاء RDK 0.9.0 يتولون هذا التسجيل عنك.
الرسومالحد الأدنى للرسوم 0.1 uqor لكل وحدة غاز؛ اضبط حد الغاز والرسوم معًا.
الأدواتNode 20 أو أحدث لأداة سطر الأوامر ومولّد الهياكل؛ وPython 3.10 أو أحدث (مع liboqs، انظر أعلاه) لعميل Python؛ وJava 21 أو أحدث لـ Java (منذ RDK 0.8.0)؛ ووحدة Go ‏github.com/qorechain/qorechain-rdk/packages/go.

قراءة الحالة لا تحتاج إلى أي من ذلك. ويمكنك أيضًا طلب تجميع عبر لوحة التحكم (Dashboard) (نموذج طلب، وليس معاملة على السلسلة) أو إنشاءه بواسطة واجهة سطر أوامر السلسلة؛ راجع نشر تجميع للاطلاع على التدفق الكامل وأوامر سطر الأوامر ومسار التوقيع في TypeScript.

سلوك إصدار السلسلة v3.2.5: يعمل على الشبكتين​

إصدار السلسلة v3.2.5 يعمل على الشبكة الرئيسية (طُبّق عند الارتفاع 3,906,833 في 29 أكتوبر 2026، مقترح الحوكمة 14) وعلى شبكة الاختبار (منذ 26 أكتوبر 2026). وتعمل الشبكة الرئيسية بالإصدار v3.2.7 وشبكة الاختبار بالإصدار v3.2.8، وكلاهما يتضمنه. تدعم RDK 0.7.0 وما بعده كليهما. تنطبق هذه القواعد على الشبكتين؛ ولم يُنشأ أي تجميع على الشبكة الرئيسية بعد (يُرجع GET /qorechain/rdk/v1/rollups قائمة فارغة في 4 نوفمبر 2026)، فالقواعد أدناه هي قواعد الإصدار ولم يجرّبها بعد تجميع حيّ على الشبكة الرئيسية. بالنسبة إلى مطوّر التجميعات:

السلوكالشبكتان (v3.2.5 وما بعده)
من يستطيع حسم تحدٍّأي حساب
بعد احتيال مثبَتتُرفض الدفعة وكل دفعة لاحقة غير منتهية؛ ويعيد المُسلسِل الإرسال من آخر جذر سليم بالفهارس نفسها
ترتيب الإنهاءتُنهى الدفعات بترتيب الفهرس
الدفعات المتفائلة المعلّقة4,096 كحد أقصى لكل تجميع
إيقاف تجميعيُرفض ما دامت آخر دفعة في الحالة submitted أو challenged؛ ويحرّر التجميع الموقوف خانته
withdrawals_rootفارغ أو بطول 32 بايت بالضبط؛ وتسمّي أوراق السحب من الصيغة الثانية معرّف السلسلة
جسر الآلات الافتراضية المتقاطعةيقدّم GET /qorechain/crossvm/v1/params قائمة السماح (bridge_allowed_targets: فارغة على الشبكة الرئيسية، وأُعيد التحقق في 4 نوفمبر 2026؛ وعلى شبكة الاختبار كانت فارغة في 30 أكتوبر وسردت ثلاثة أهداف CosmWasm في 4 نوفمبر)؛ ويُرجع العقد المُصرَّف مسبقًا abi.encode(bytes) ويرفض بـ Error(string)
العقد المُصرَّف مسبقًا للآلات الافتراضية المتقاطعة 0x...0901نشط على شبكة الاختبار، مع قائمة سماح بعقود CosmWasm جرت مراجعتها (جرى اختبار استدعاء في 7 نوفمبر 2026 بـ eth_call)؛ وغير مفعّل على الشبكة الرئيسية

إصدار السلسلة v3.2.6 يعمل على الشبكتين (الشبكة الرئيسية منذ 4 نوفمبر 2026، الارتفاع 4,020,000، المقترح 15). وهو يضيف للتجميعات الحقل withdrawals_bound إلى عرض الدفعة (أي ما إذا كانت عمليات سحب الدفعة مرتبطة بها)؛ ويضيف كذلك تغييرات في IBC وقابلية المراقبة لا تغيّر طريقة تسوية التجميع. لا يوجد تجميع على الشبكة الرئيسية يُظهر الحقل الجديد، ولذلك فهو مذكور من ملاحظات الإصدار لا من المشاهدة.

إصدار السلسلة v3.2.7: على الشبكتين​

عملت شبكة الاختبار بإصدار السلسلة v3.2.7 منذ 6 نوفمبر 2026 (الارتفاع 9,594,600، طُبّق بالحوكمة) وانتقلت إلى v3.2.8 في 12 نوفمبر. وتعمل الشبكة الرئيسية بالإصدار v3.2.7 منذ 12 نوفمبر 2026 (الارتفاع 4,164,600، مقترح الحوكمة 16). جرت الفحوص أدناه على شبكة الاختبار في 7 نوفمبر 2026؛ ولم تُكرَّر على الشبكة الرئيسية، حيث لا يُعرف سوى بوابات الإصدار. بالنسبة إلى التجميعات:

  • رسائل مفتاح تحقق ZK. قبلت شبكة الاختبار MsgSetVerificationKey وMsgUpdateVerificationKey (معاملة محاكاة برسالة فارغة تجاوزت مرحلة تحديد نوع الرسالة وفشلت عند حقل العنوان الفارغ؛ أما الشبكة الرئيسية فردّت "unable to resolve type URL" للرسالة نفسها في 7 نوفمبر، قبل أن تطبّق v3.2.7). ورسائل مفتاح التحقق مفعَّلة على الشبكة الرئيسية منذ 12 نوفمبر 2026. وتقول ملاحظات الإصدار إن دفعة ZK بلا مفتاح مسجَّل تُرفض قبل دفع الرسوم. لا يوجد أي تجميع على شبكة الاختبار (أرجع GET /qorechain/rdk/v1/rollups قائمة فارغة)، وأرجع GET /qorechain/rdk/v1/rollups قائمة فارغة أيضًا على الشبكة الرئيسية في 12 نوفمبر 2026، فلم يُسجَّل أي مفتاح ولم يُتحقَّق من أي دفعة ZK. وليس في RDK 0.8.0 بنّاء لهاتين الرسالتين.
  • الـ precompile عبر الآلات الافتراضية 0x...0901. نشط على شبكة الاختبار مع قائمة سماح من ثلاثة عقود CosmWasm جرت مراجعتها؛ وبلغ استدعاء eth_call للقراءة فقط عقدًا مسموحًا به، ورُفض لأي هدف آخر (التفاصيل في Multi-VM). وعلى الشبكة الرئيسية يبقى الـ precompile واستدعاءات الآلات الافتراضية المتقاطعة متوقفة، بما في ذلك بعد v3.2.7 (رسالة استدعاء cross-VM متوقفة).

ما هو موجود اليوم​

الحالة
التجميعات المسجّلة (الشبكة الرئيسية وشبكة الاختبار)لا يوجد
وحدة x/rdk ومعاملاتهامنشورة على الشبكتين؛ اقرأها باستخدام qorechaind query rdk config
استعلامات RDKمتاحة على الشبكتين عبر واجهة سطر الأوامر وgRPC وREST (/qorechain/rdk/v1/...)، ولذلك تعمل القراءات المعتمدة على REST مثل rdk.params() في TypeScript مقابل الشبكة الرئيسية
مراسي التسوية التي تكتبها RDKلا يوجد. منذ v3.2.2 يمكن أن تحمل الدفعة الحقل anchor_signature وعندئذٍ تُرسَّخ في x/multilayer ضمن المعاملة نفسها؛ وبدونه تُسوَّى الدفعة غير مُرسَّخة. لا يوجد بعد أي تجميع أو طبقة أو مرساة. يرسل RDK بلغة TypeScript (من 0.6.0 وما بعده) الحقل حين يوقّع عميله توقيعًا هجينًا ويكون هو منشئ التجميع (لم يُختبر على الشبكة الحيّة)؛ أما عملاء Python وGo وRust وJava فيوقّعون توقيعًا هجينًا منذ 0.8.0 لكنهم لا يرسلونه (تم التحقق من Python)
طبقات التجميعات المسجّلة في x/multilayerلا يوجد
تسوية ZKرسائل مفتاح التحقق مفعَّلة على الشبكة الرئيسية (v3.2.7، 12 نوفمبر 2026) ومقبولة على شبكة الاختبار؛ ولم يُجرَّب بعد أي تجميع من نوع ZK على أي منهما
عمليات السحبتُدفع من دفتر ضمان (escrow) خاص بكل تجميع منذ v3.2.3 (راجع ZK / STARK وعمليات السحب)؛ لم تُجرَ أي عملية سحب لأنه لا يوجد تجميع

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

أين تُنشر​

جرى التحقق من الإصدارات على السجلات في 12 نوفمبر 2026. جميع الحزم بترخيص Apache-2.0.

يدعم RDK 0.9.0 (12 نوفمبر 2026) السلسلة v3.2.8 (تعمل شبكة الاختبار بها منذ 12 نوفمبر 2026): نشر بيانات rollup، والتسلسل القائم على الأساس (based sequencing)، وrollups متفائلة من نوع qledger-v1 مع إثباتات الاحتيال، وrollups خاصة، ومدخلات ZK القانونية؛ والتسوية بـ STARK متوقفة مؤقتًا. راجع ملاحظات الإصدار على GitHub.

السجلالحزمةالإصدار الحاليالرابط
npm@qorechain/rdk (عميل TypeScript)0.9.0npmjs.com
npm@qorechain/rdk-cli (qorollup)0.9.0npmjs.com
npmcreate-qorechain-rollup (مولّد الهياكل)0.9.0npmjs.com
PyPIqorechain-rdk (الاستيراد qorrdk)0.9.0pypi.org
crates.ioqorechain-rdk (المكتبة qorechain_rdk)0.9.0crates.io
وكيل وحدات Gogithub.com/qorechain/qorechain-rdk/packages/gov0.9.0pkg.go.dev
Maven Centralio.github.qorechain:qorechain-rdk0.9.0central.sonatype.com

تخدّم Maven Central الإصدارات 0.7.0 و0.7.1 و0.8.0 و0.9.0 إضافة إلى الإصدارات الأقدم، وقد يتأخر @latest في وكيل Go عن وسم جديد، فثبّت إصدار Go. الشيفرة المصدرية عامة على github.com/qorechain/qorechain-rdk، وملاحظات الإصدار على v0.9.0 (وv0.8.0 وv0.7.1)، ووثائق المجموعة نفسها على qorechain.github.io/qorechain-rdk. تعتمد حزمة TypeScript على @qorechain/sdk ‏^0.10.0 (من 0.7.0؛ وكان 0.6.x يستخدم ^0.9.0؛ وتستخدم حزم Python وGo وRust وJava QoreChain SDK 0.10.x المطابق منذ 0.8.0) و@qorechain/evm ‏^0.8.0، وتعتمد حزمة Python على qorechain-pqc ‏0.2.x. أما منطق وحدة x/rdk على السلسلة نفسه فليس جزءًا من المجموعة العامة.

الحدود والمشكلات المعروفة​

  • لم تُجرَّب تسوية ZK على أي من الشبكتين. ويشمل ذلك الملف التعريفي defi وقالب defi-rollup وكل تجميع أُنشئ بتسوية zk. رسائل مفتاح التحقق مفعَّلة على الشبكة الرئيسية منذ إصدار السلسلة v3.2.7 (12 نوفمبر 2026) وعلى شبكة الاختبار منذ 6 نوفمبر 2026، لكن لم يُنشأ أي تجميع من نوع ZK، وليس في RDK 0.8.0 بنّاء لهذه الرسائل، وتُرفض دفعة ZK بلا مفتاح مسجَّل. استخدم تسوية optimistic في الوقت الحالي (راجع ZK / STARK وعمليات السحب).
  • لم يُنشأ أي تجميع على أيٍّ من الشبكتين. مسارات الإنشاء والدفعات والتحدي والإيصالات والسحب مغطاة باختبارات الوحدة والمتجهات المشتركة، لكنها لم تُجرَّب على السلسلة.
  • التوقيع الهجين يحتاج إلى مفتاحك ما بعد الكمّي. منذ RDK 0.8.0 توقّع العملاء الخمسة جميعًا توقيعًا هجينًا عند تزويدها بزوج مفاتيح ما بعد كمّي، وتفعل ذلك أوامر المعاملات في qorollup (create وpause وresume وstop وwithdraw) منذ 0.7.1؛ وبدون مفتاح، أو في الإصدارات الأقدم، تكون المعاملة كلاسيكية فقط وترفضها الشبكتان. ولم تُرسل أي معاملة هجينة من أي عميل عبر rollup حي. ولا يرسل الدفعات المثبَّتة سوى عميل TypeScript.
  • (a) لم تكن أداة qorollup تطبع شيئًا عند تثبيتها من npm في 0.6.1 وما قبله. تم إصلاح هذا في 0.6.2: بعد npm i -g @qorechain/rdk-cli تعمل qorollup ... ويطبع qorollup --version القيمة 0.6.2.
  • (b) كانت دوال Merkle المساعدة للسحب تستخدم SHA-256 افتراضيًا في 0.6.2 وما قبله، بينما تستخدم السلسلة SHAKE-256. لم يكن أي إثبات مبني بتلك القيم الافتراضية يتحقق على السلسلة أبدًا. جرى الإصلاح في 0.7.0: تبني withdrawalsTree شجرة السلسلة بدقة وقد فُحصت مقابل مُتحقِّق السلسلة نفسه (راجع ترميز الأوراق والعقد). قم بالترقية؛ ويجب الآن على الشيفرة التي اعتمدت على القيم الافتراضية SHA-256 أن تمرّر hash صراحةً.
  • (c) كانت buildDaBlob تجزّئ بـ SHA-256 في 0.6.2 وما قبله، بينما التزام الـ blob لدى السلسلة هو SHAKE-256. جرى الإصلاح في 0.7.0، حيث صار التزامها هو التزام السلسلة. لم يكن له أثر عملي قط، لأنه لا توجد معاملة تنشر blob؛ اترك dataHash فارغًا في توافر البيانات native وboth (راجع توافر البيانات).
  • (d) لا تستطيع الدائرة التوضيحية في قالب defi التحقق. إنها مضاعِف snarkjs، بينما تفحص السلسلة Groth16 على BLS12-381 مع جذر الحالة السابق وجذر الحالة وبصمة البيانات كمدخلات عامة، ولا تكشفها تلك الدائرة. وحتى بعد صدور تسجيل المفاتيح، تحتاج إلى دائرتك الخاصة.
  • يستطيع أي حساب حسم التحدي (v3.2.5 وما بعده، على الشبكتين). تتحقق السلسلة من إثبات الاحتيال بنفسها؛ وقبل v3.2.5 كان منشئ التجميع وحده يستطيع إرسال الحسم (راجع سلوك إصدار السلسلة v3.2.5 والمتفائل).
  • غير قابل للاستخدام على الشبكات الحيّة: توافر البيانات عبر Celestia (غير منفَّذ)، ومساعد QCAI للتجميعات (خدماته الاستشارية غير موجودة على نقاط النهاية العامة)، واستدعاءات الآلات الافتراضية المتقاطعة (العقد المُصرَّف مسبقًا عند 0x...0901 غير مفعّل على الشبكة الرئيسية؛ وعلى شبكة الاختبار هو نشط مع قائمة سماح، وجرى اختباره بـ eth_call في 7 نوفمبر 2026)، والمرتِّبون المشتركون والمستندون إلى L1 (لا تقبل السلسلة إلا المرتِّب المُهيَّأ أو، إذا لم يُعيَّن أحد، المنشئ)، وsuggest-profile (يُرجع defi كبديل ثابت).
  • ملاحظات الإصدار. استخدم 0.9.0 لكل شيء (فالإصدار 0.7.0 وما قبله لا يستطيع إرسال معاملات qorollup تقبلها الشبكتان، وقبل 0.8.0 لا تستطيع عملاء Python وGo وRust وJava إرسال أي معاملة): فالإصدار 0.6.2 وما قبله يبني إثباتات سحب لا تتحقق على السلسلة أبدًا، والإصدار 0.6.1 وما قبله لا يطبع شيئًا من qorollup عند تثبيته من npm. ولا ينبغي استخدام 0.5.0 وما قبله للإيصالات أو Watchtower أو بيانات الاستدعاء عبر الآلات الافتراضية. القائمة الكاملة بما غيّره كل إصدار في RDK 0.8.0: التغييرات والحدود.

مرجع: مما يتكوّن التجميع​

ما الذي تقدمه لك RDK​

يجمع التجميع الذي يتم إنشاؤه عبر RDK بين أربعة جوانب قابلة للتهيئة:

الجانبما الذي يتحكم فيهالخيارات
وضع التسويةكيفية التحقق من انتقالات حالة التجميع وإنهائها على QoreChainoptimistic, zk, based, sovereign
نظام الإثباتالآلية التشفيرية أو الاقتصادية الداعمة للتسويةfraud, snark, stark, none
وضع المرتِّب (Sequencer)من يتولى ترتيب المعاملات قبل تسويتهاdedicated, shared, based
توافر البياناتأين يتم نشر بيانات المعاملات بحيث يمكن لأي شخص إعادة بناء الحالةnative, celestia, both

يُسجَّل كل تجميع بمعرّف فريد rollup-id، مدعوم بسند حصة (stake bond) بعملة QOR، ويُخصَّص له حالة دورة حياة (pending، active، paused، stopped). راجع نشر تجميع للاطلاع على تدفق الإنشاء ودورة الحياة الكاملة.

قدرات خاصة بـ QoreChain وحالتها​

بالإضافة إلى الحد الأدنى المشترك بين أي مجموعة أدوات تجميعات، تتضمن RDK ثلاث قدرات مبنية حول الطبقة الأولى (Layer 1) الخاصة بـ QoreChain، إضافة إلى نظام تحدٍّ تلقائي (watchtower auto-challenger). تختلف حالتها؛ ويوضح الجدول ما يعمل اليوم.

القدرةما الذي تقوم به
إيصالات التسويةتحويل مرساة التسوية إلى إيصال قابل للنقل يحمل توقيعًا ما بعد كمي (ML-DSA-87 / Dilithium-5). مرحلة مبكرة: لا توجد مراسٍ بعد، ولذلك لم يُتحقَّق من شيء مقابل مرساة حقيقية؛ والإيصال ادّعاء يجب التحقق منه مقابل حالة السلسلة، وهو ما يفعله المُتحقِّق في الإصدار 0.7.0، حقلًا بحقل.
مساعد QCAI للتجميعاتمساعد استشاري للقراءة فقط لتجميع واحد (تقدير الرسوم، والتوصيات، وتحقيقات الاحتيال). الخدمات الاستشارية التي يقرأ منها غير معروضة على نقاط النهاية العامة بعد.
استدعاءات الآلات الافتراضية المتعددة (Multi-VM)أدوات لترميز استدعاء من EVM إلى QoreChain Native عبر العقد المُصرَّف مسبقًا العابر للآلات الافتراضية (0x...0901). العقد المُصرَّف مسبقًا غير مفعّل على الشبكة الرئيسية (ولذلك لا يفعل الاستدعاء شيئًا هناك) ونشط على شبكة الاختبار مع قائمة سماح (جرى اختباره بـ eth_call في 7 نوفمبر 2026)؛ ويطابق المُرمِّز منذ الإصدار 0.6.0 التخطيط الذي تفكّ السلسلة ترميزه.
Watchtowerإطار عمل للتحدي التلقائي (auto-challenger) للتجميعات المتفائلة (optimistic) يعرض الدفعات الجديدة والمواعيد النهائية لنافذة التحدي ويطعن في الدفعات غير الصالحة استنادًا إلى محمول الصلاحية (validity predicate) الخاص بك. يقرأ عبر REST، الذي تخدّمه الشبكتان؛ ومنذ الإصدار 0.6.0 يحكم على نافذة كل دفعة بالطريقة نفسها التي تحكم بها السلسلة (وتحافظ الإصدارات اللاحقة على ذلك).

راجع لماذا RDK الخاصة بـ QoreChain للاطلاع على الأساس المنطقي الكامل وأمثلة الشيفرة.

نماذج التسوية الأربعة​

تدعم RDK الخاصة بـ QoreChain أربعة أوضاع تسوية، لكل منها افتراضات ثقة مختلفة، وخصائص نهائية مختلفة، ومتطلبات إثبات مختلفة. يتم التحقق من صحة الجمع بين وضع التسوية ونظام الإثبات على السلسلة، ويُرفض أي إقران غير متوافق عند الإنشاء. يوضح المخطط كيفية ربط كل وضع تسوية بنظام الإثبات الصالح له.

متفائل (Optimistic)​

تفترض التجميعات المتفائلة (Optimistic) أن الدفعات المُرسلة صالحة افتراضيًا وتعتمد على إثباتات الاحتيال (fraud proofs) لحل النزاعات.

  • نظام الإثبات: fraud (إثباتات احتيال تفاعلية).
  • المرتِّب (Sequencer): dedicated أو shared.
  • النهائية (Finality): تتأخر حتى تنتهي نافذة تحدٍّ قابلة للتهيئة دون أي تحدٍّ ناجح.
  • النزاعات: يمكن لأي شخص الطعن في دفعة مُرسلة خلال هذه النافذة بنشر سند وإثبات احتيال. يجمّد الطعن الدفعة؛ ومنذ v3.2.5 (على الشبكتين) يستطيع أي حساب حسمه عندئذٍ، بينما كان قبل v3.2.5 منشئ التجميع وحده يستطيع ذلك. وتتحقق السلسلة من الإثبات بنفسها: فالاحتيال المثبت يرفض الدفعة ويدفع للطاعن، أما الطعن المرفوض فيعيد الدفعة إلى الحالة submitted. ومنذ v3.2.5 يرفض الاحتيال المثبت أيضًا كل دفعة لاحقة غير منتهية، ويعيد المُسلسِل إرسالها من آخر جذر سليم بالفهارس نفسها (راجع سلوك إصدار السلسلة v3.2.5). راجع نشر تجميع.
  • طول النافذة: النافذة الافتراضية هي 604,800 "ثانية" على الشبكة الرئيسية (قيمة default_challenge_window في الوحدة؛ والافتراضي في شبكة الاختبار 3,600 ثانية، قُرئ في 27 أكتوبر 2026، ويمكن لكل تجميع ضبط نافذته الخاصة). قبل v3.2.4 (على الشبكة الرئيسية، قبل الارتفاع 3,742,566) تحوّلها السلسلة إلى كتل بمعدل ثابت قدره 6 ثوانٍ لكل كتلة، أي 100,800 كتلة، ولذلك يتبع الزمن الفعلي المنقضي زمن الكتلة الحقيقي (نحو 3.7 أيام عند كتل الشبكة الرئيسية الحالية البالغة ≈3.1 ثانية)؛ فخطّط بالكتل لا بالأيام. ابتداءً من v3.2.4، تحصل الدفعة المُرسلة ابتداءً من ارتفاع الترقية على نافذة تُقاس بثواني زمن الكتلة (7 أيام كاملة)؛ أما الدفعات السابقة فتبقى على قاعدة عدد الكتل. ارتفاع الترقية هو 8,337,253 على شبكة الاختبار (منذ 19 أكتوبر 2026) و3,742,566 على الشبكة الرئيسية (23 أكتوبر 2026).

ZK (المعرفة الصفرية)​

ترفق تجميعات ZK إثبات صلاحية تشفيري بكل دفعة، مما يثبت صحة انتقال الحالة دون الحاجة إلى إعادة التنفيذ.

  • نظام الإثبات: snark (إثباتات موجزة) أو stark (إثباتات شفافة، دون إعداد موثوق).
  • المرتِّب (Sequencer): dedicated أو shared.
  • النهائية (Finality): عند التحقق من صحة الإثبات، دون نافذة تحدٍّ.
  • مستوى النضج: لم تُجرَّب تسوية ZK على أي من الشبكتين. يُقصد أن يُتحقَّق من دفعات SNARK على السلسلة (Groth16 على BLS12-381) مقابل مفتاح تحقق مخزّن مع التجميع؛ ورسائل مفتاح التحقق مفعَّلة على الشبكة الرئيسية منذ إصدار السلسلة v3.2.7 (12 نوفمبر 2026) وعلى شبكة الاختبار منذ 6 نوفمبر 2026، ولم يُجرَّب أي تجميع من نوع ZK بعد. أما التحقق بـ STARK فهو تجريبي: اختياري ويفحص دائرة توضيحية، لا انتقال الحالة الخاص بتجميعك. راجع ZK / STARK وعمليات السحب.

Based (المستند إلى L1)​

تُفوِّض تجميعات Based ترتيب المعاملات إلى مقترحي (proposers) QoreChain (L1)، لترث بذلك حيوية السلسلة المضيفة ومقاومتها للرقابة.

  • نظام الإثبات: none (مقترحو L1 هم مصدر حقيقة الترتيب).
  • المرتِّب (Sequencer): based (مطلوب، ويُفرض عبر التحقق على السلسلة).
  • النهائية (Finality): تتبع تأكيد السلسلة المضيفة.
  • المفاضلة: أبسط نموذج تشغيلي، بما أن مدققي QoreChain يتولون الترتيب، وذلك على حساب التحكم في زمن الاستجابة الذي يوفره المرتِّب المخصص.
  • الحالة اليوم: يُسجَّل based في إعدادات التجميع، لكن QoreChain لا تقبل بعد مقترحي L1 كمُرسِلي دفعات؛ فمنشئ التجميع هو من يُرسل (راجع أوضاع المرتِّب).

Sovereign (السيادي)​

تُشغِّل تجميعات Sovereign إجماعها الخاص وتُرتِّب معاملاتها ذاتيًا. وهي تُرسِّخ حالتها في QoreChain لغرض إمكانية التحقق، لكنها لا تعتمد على السلسلة المضيفة لتحقيق النهائية.

  • نظام الإثبات: none.
  • المرتِّب (Sequencer): يُدار ذاتيًا بواسطة التجميع.
  • النهائية (Finality): مستقلة، يحددها إجماع التجميع الخاص به.
  • ترسيخ الحالة: تُنشر جذور الحالة (state roots) في QoreChain من أجل الشفافية، لكن السلسلة المضيفة لا تفرضها.

توافق أنظمة الإثبات​

يحدد وضع التسوية أنظمة الإثبات الصالحة. تُفرض هذه الإقرانات عند إنشاء التجميع.

وضع التسويةfraudsnarkstarknone
optimisticمطلوب---
zk-مدعوممدعوم-
based---مطلوب
sovereign---مطلوب

أوضاع المرتِّب (Sequencer)​

يحدد المرتِّب (Sequencer) الجهة التي ترتب المعاملات داخل كتلة التجميع قبل التسوية.

الوضعمن يقوم بالترتيبملاحظات
dedicatedعنوان مشغّل واحد مُعيَّنأقل زمن استجابة؛ يتطلب الثقة بالمشغّل لضمان الحيوية والترتيب العادل
sharedمجموعة مرتِّبين مشتركةيُوزَّع الترتيب عبر المجموعة؛ عبء تنسيق أعلى قليلًا
basedمقترحو (proposers) QoreChain L1يرث أمان مدققي السلسلة المضيفة ومقاومتها للرقابة؛ مطلوب لتسوية based
ما يُفرض اليوم

على السلسلة، لا يجوز إرسال دفعة إلا من عنوان المرتِّب المُهيَّأ للتجميع، أو من منشئه عندما لا يكون هناك عنوان مُعيَّن (وهذا حال كل الإعدادات المسبقة). يُسجَّل الوضعان shared وbased في إعدادات التجميع، لكن QoreChain لا تقبل بعد قائمة مرتِّبين مشتركة ولا مقترحي L1 كمُرسِلي دفعات؛ وهذان الوضعان يصفان التصميم المقصود.

اختيار النموذج (Paradigm)​

إذا كنت تريد...ففكّر في
أبسط إعداد تشغيلي، مع قيام مدققي QoreChain بالترتيبbased
نهائية سريعة بضمانات تشفيرية (غير قابلة للاستخدام بعد)zk (snark / stark)
نموذج مفهوم جيدًا مع حل نزاعات اقتصاديoptimistic (fraud)
استقلالية كاملة بإجماعك الخاص، مُرسَّخة لإمكانية التحققsovereign

لست متأكدًا من أين تبدأ؟ تُشحن RDK مع ملفات تعريف مسبقة (preset profiles) تجمع هذه الخيارات لفئات التطبيقات الشائعة؛ راجع ملفات التعريف المسبقة. توجد أداة مساعدة suggest-profile، لكنها تُرجع حاليًا بديلًا ثابتًا هو defi (ولا يمكن استخدام defi بعد)، فاختر من جدول ملفات التعريف.

ذات صلة​