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

QoreChain SDK

إن QoreChain SDK هي حزمة التطوير الرسمية متعددة اللغات لبناء التطبيقات اللامركزية على QoreChain — شبكة من الطبقة الأولى (Layer 1) ذات ثلاث آلات افتراضية وتوقيعات هجينة بـ ML-DSA-87 (معيار FIPS 204).

تغطي هذه الوثائق كيفية تثبيت SDK، والاتصال بالشبكة، وقراءة الحالة على السلسلة، واشتقاق الحسابات، وتوقيع المعاملات وإرسالها، والعمل مع كل واحدة من الآلات الافتراضية في QoreChain.

ما هي QoreChain؟​

QoreChain هي سلسلة كتل من الطبقة الأولى تضم ثلاث بيئات تشغيل للعقود الذكية من الدرجة الأولى على سلسلة واحدة:

  • QoreChain Native — عقود ذكية بتقنية Wasm عبر Cosmos SDK (بيئة تشغيل CosmWasm).
  • QoreChain EVM Engine — تنفيذ متوافق مع Ethereum ‏(Solidity و viem و JSON-RPC القياسي).
  • SVM — بيئة تشغيل متوافقة مع Solana مع واجهة JSON-RPC على نمط Solana.

الحسابات والأرصدة والرموز المميزة مشتركة بين بيئات التشغيل، كما تتضمن السلسلة وحدة IBC للتشغيل البيني عبر السلاسل (لا توجد قناة IBC مفتوحة على الشبكة الرئيسية؛ وعلى شبكة الاختبار قناة transfer واحدة مفتوحة إلى سلسلة اختبار، فُحصت في 27 أكتوبر 2026).

ما يعمل على الشبكات الحية اليوم (تعمل الشبكة الرئيسية بالإصدار v3.2.7 وشبكة الاختبار بالإصدار v3.2.8)

يعمل: القراءات على كل مسار، ومعاملات المسار الأصلي (Native) الموقَّعة توقيعاً هجيناً، والحسابات الموحّدة، ومعاملات EVM داخل نافذة التفويض، وقراءات SVM. غير متاح بعد: مكوّنات EVM ما قبل التجميع على الشبكة الرئيسية (لا شيء منها مفعَّل هناك؛ وعلى شبكة الاختبار ثلاثة مفعَّلة، هي التحقق من PQC وحالة مفتاح PQC ومعاملات الإجماع، أما زوج الذكاء الاصطناعي وجسر الآلات الافتراضية فغير مفعَّلين على الشبكتين)، ومساحة الأسماء qor_ في JSON-RPC، ومعاملات SVM، والاستدعاءات عبر الآلات الافتراضية على الشبكة الرئيسية (MsgCrossVMCall متوقفة بواسطة قاطع الدائرة)، ورفع عقود QoreChain Native وإنشاء نسخ منها للحسابات العادية (وعلى شبكة الاختبار الإنشاء مفتوح والرفع غير مفتوح)، ومسارات المصادِق / الحساب المجرّد على الشبكة الرئيسية (الوحدة متوقفة هناك ومفعَّلة على شبكة الاختبار)، وxQORE وتجريد الغاز. يكرر كل دليل هذا التنبيه حيثما ينطبق. جرى الفحص مقابل نقاط النهاية الحية في 27 أكتوبر 2026؛ وفي 7 نوفمبر 2026 كانت قائمة الـ precompiles النشطة في الشبكة الرئيسية ما زالت فارغة، بينما احتوت قائمة شبكة الاختبار أيضًا جسر الآلات الافتراضية المتقاطعة 0x…0901 (نشط مع قائمة سماح؛ وجرى اختبار استدعاء eth_call للقراءة فقط في 7 نوفمبر 2026).

تُوقِّع SDK المنشورة (0.14.0، 12 نوفمبر 2026) بالصيغة التي تتحقق منها الشبكتان (بايتات التوقيع الهجينة v2، تُحدَّد من حالة السلسلة)، ولم تتغير صيغة التوقيع والعناوين والمنازل العشرية والمذكرات والرسوم في v3.2.3 ولا في v3.2.4 ولا في v3.2.5 ولا في v3.2.6 (تعمل الشبكة الرئيسية بالإصدار v3.2.7 منذ 12 نوفمبر 2026، الارتفاع 4,164,600، مقترح الحوكمة 16، بعد v3.2.6 في 4 نوفمبر؛ وشبكة الاختبار منذ 27 أكتوبر، وعملت منذ 6 نوفمبر بالإصدار v3.2.7 وتعمل منذ 12 نوفمبر بالإصدار v3.2.8 اللذين يضيفان رسائل لدى SDK 0.14.0 أدوات بناء لها؛ وتسري قواعد شبكة الاختبار الجديدة منذ v3.2.8 ولم تطبّقها الشبكة الرئيسية؛ ورسائل v3.2.7 على الشبكة الرئيسية منذ 12 نوفمبر 2026). وهي تحمل جانب العميل من القواعد اللاحقة للتشفير ما بعد الكمومي (إثبات الحيازة عند تسجيل المفتاح، ونوافذ EVM ذات النطاق المحدد، ورسائل الموافقة الخاصة بـ EIP-7702) ومن v3.2.4 (طبقات التحصيص، وnonce المصادِق، ومفاتيح تفعيل ميزات البروتوكول) ومن v3.2.5 (الغاز الدقيق للمعاملات الهجينة، وسجل مفاتيح ML-KEM)؛ أما الإصدارات السابقة للإصدار 0.9.0 فلا تحمل المجموعة الأولى، راجع الإصدارات السابقة للإصدار 0.9.0، وما الذي يضيفه الإصدار 0.12.0 وما الذي يغيّره الإصدار 0.13.0 وما الذي يغيّره الإصدار 0.14.0.

التوقيع في المحافظ والخوادم الخلفية: راجع QoreSign.

توقيع ML-DSA-87 الهجين​

توفر QoreChain أساسيات التشفير ما بعد الكمومي (PQC) المبنية على ML-DSA-87 ‏(Dilithium-5، معيار FIPS 204). وإلى جانب التوقيع الكلاسيكي بـ secp256k1، تدعم السلسلة وضعية توقيع هجينة تحمل فيها المعاملة توقيعاً كلاسيكياً وتوقيعاً ما بعد كمومي معاً، بحيث تبقى صالحة وفق التحقق الكلاسيكي اليوم مع اكتساب حماية ما بعد كمومية.

تتيح SDK اليوم توليد مفاتيح ML-DSA-87 والتوقيع والتحقق بها، إضافة إلى اللبنات الأساسية للمعاملات الهجينة. وعلى الشبكات الحية يجب أن تكون معاملة المسار الأصلي موقَّعة توقيعاً هجيناً، وأن يكون مفتاح ML-DSA-87 للحساب مسجَّلاً أولاً. راجع الحسابات وتوقيع PQC للتفاصيل. لا ادعاءات تسويقية هنا — تتيح SDK بالضبط الأساسيات التي تنفذها السلسلة.

ما الذي يميز هذه SDK​

إلى جانب التكافؤ الكامل متعدد السلاسل، هناك ثلاث قدرات ممكنة فقط على QoreChain، لأنها مبنية على ميزات بروتوكولية لا تملكها أي سلسلة أخرى من الطبقة الأولى:

  • تقييم المخاطر المسبق بالذكاء الاصطناعي — افحص المعاملة بالذكاء الاصطناعي على السلسلة قبل بثها. تُرجع simulateWithRiskScore تقدير الغاز إضافة إلى حكم بالمخاطر/الشذوذ صادر عن precompiles حتمية على EVM، بحيث تستطيع المحفظة أو التطبيق اللامركزي التحذير (أو المنع) قبل التوقيع. لم تُفعَّل مكوّنات ما قبل التجميع الخاصة بالذكاء الاصطناعي بعد على الشبكة الرئيسية ولا على شبكة الاختبار. راجع الفحص المسبق بالذكاء الاصطناعي.
  • استدعاءات موحّدة عبر الآلات الافتراضية — حساب واحد، ثلاث آلات افتراضية، معاملة واحدة. تستدعي createCrossVMClient عقداً على أي آلة افتراضية، وتحزم callAtomic عدة استدعاءات عبر الآلات الافتراضية في معاملة ذرية واحدة تُوقَّع مرة واحدة. راجع الاستدعاءات عبر الآلات الافتراضية.
  • تجربة تطوير للتوقيع الهجين — سجّل مفتاح ML-DSA-87 للمُوقِّع باستدعاء واحد قابل للتكرار (ensurePqcRegistered / migrateToHybrid)، مع شارة React جاهزة للاستخدام. راجع التوقيع الهجين.

وصلت قدرتان إضافيتان على مستوى السلسلة في 0.6.0 و 0.7.0 (الثانية غير قابلة للاستخدام بعد على الشبكات الحية، انظر أدناه):

  • حسابات موحّدة أصلية بنمط eth — مفتاح eth_secp256k1 واحد هو هوية واحدة من 20 بايت تُعرض بصيَغ qor1… و 0x… وعنوان base58 لـ SVM، وكلها تتشارك رصيداً واحداً. راجع الحسابات الموحّدة.
  • مسارات المصادقة (Authenticator lanes) — اربط مفتاح Phantom أو MetaMask بالحساب القانوني الذي يتطلب PQC ودعه ينفق عبر مُرحِّل وفق شروط قائمة على أدنى الامتيازات ومحدودة الإنفاق وقابلة للإلغاء. وحدة abstractaccount التي تقوم عليها متوقفة على الشبكة الرئيسية ومفعَّلة على شبكة الاختبار. راجع المصادِقات والإنفاق المفوَّض.

كما أن حزمة @qorechain/react الجديدة (مزوِّد، وخطافات hooks، و ConnectButton، و PqcStatusBadge) تجعل بناء تطبيق لامركزي بتوقيع ML-DSA-87 هجين هو المسار الافتراضي — راجع دليل حزمة React. وللاطلاع على الحجة الكاملة، اقرأ لماذا QoreChain SDK.

عائلة SDK​

تُشحن SDK كعائلة من الحزم لتتمكن من البناء بلغتك المفضلة. وتتشارك الحزم نفس الإعدادات المسبقة للشبكة، ومخططات الاشتقاق، وحسابات وحدات العملة، وواجهات القراءة.

الحزمةاللغةالتثبيتالحالة
@qorechain/sdkTypeScriptnpm i @qorechain/sdkمنشورة (npm، الإصدار v0.14.0)
qorechain-sdkPythonpip install qorechain-sdk (الاستيراد باسم qorsdk)منشورة (PyPI، الإصدار v0.14.0)
qorechain-sdk (وحدة Go)Gogo get github.com/qorechain/qorechain-sdk/packages/go/...منشورة (وكيل Go، الوسم packages/go/v0.14.0)
qorechain-sdkRustcargo add qorechain-sdk (الاستيراد باسم qorechain)منشورة (crates.io، الإصدار v0.14.0)
io.github.qorechain:qorechain-sdkJavaio.github.qorechain:qorechain-sdk:0.14.0منشورة (Maven Central، الإصدار 0.14.0؛ JDK 17 أو أحدث)
@qorechain/evmTypeScript (محوِّل EVM)npm i @qorechain/evm viemمنشورة (npm، الإصدار v0.14.0)
@qorechain/svmTypeScript (محوِّل SVM)npm i @qorechain/svm @solana/web3.jsمنشورة (npm، الإصدار v0.14.0)
@qorechain/reactTypeScript (حزمة React)npm i @qorechain/reactمنشورة (npm، الإصدار v0.14.0)
create-qorechain-dappCLInpm create qorechain-dappمنشورة (npm، الإصدار v0.14.0)

توزيعة Python تُثبَّت باسم qorechain-sdk لكنها تُستورَد باسم qorsdk. جميع العملاء منشورون في سجلاتهم — راجع التثبيت لأوامر كل لغة.

النواة المكتوبة بـ TypeScript ‏(@qorechain/sdk) هي أساس الأمثلة في هذه الوثائق. ويصل عملاء Python و Go و Rust و Java إلى تكافؤ كامل مع السلسلة الأصلية مثل TypeScript: الإعدادات المسبقة للشبكة، وأدوات وحدات العملة/العناوين، واشتقاق الحسابات الهرمي HD ‏(native/EVM/SVM)، وتوقيع PQC ‏(ML-DSA-87)، ومُنشئات رسائل منمَّطة لكل وحدة مخصصة إضافة إلى وحدات Cosmos القياسية، وعملاء استعلام منمَّطون، ودورة حياة المعاملة الكاملة (الغاز التلقائي، وفك ترميز الأخطاء، وتتبع المعاملات، والبحث في الكتل/المعاملات)، والمعاملات الهجينة ما بعد الكمومية، واشتراكات WebSocket. جميع هؤلاء العملاء منشورون: ‏TypeScript على npm ‏(@qorechain/sdk 0.14.0)، و Python على PyPI ‏(qorechain-sdk 0.14.0، الاستيراد باسم qorsdk)، و Go على وكيل الوحدات (الوسم packages/go/v0.14.0)، و Rust على crates.io ‏(qorechain-sdk 0.14.0)، و Java على Maven Central ‏(io.github.qorechain:qorechain-sdk 0.14.0). أما محوِّلات التنفيذ EVM/SVM ‏(@qorechain/evm و @qorechain/svm، وكلاهما 0.14.0)، وحزمة @qorechain/react ‏(0.14.0)، وأداة السقالة create-qorechain-dapp ‏(0.14.0، الذي يحمل أيضًا إصلاحات القوالب في 0.13.1) فهي خاصة بـ TypeScript فقط ومنشورة كذلك على npm. راجع التثبيت للاطلاع على الحزم المصاحبة.

الجديد من 0.6 إلى 0.14​

0.6.0 — الحسابات الموحّدة الأصلية بنمط eth (السلسلة v3.1.83). مفتاح eth_secp256k1 واحد هو هوية واحدة من 20 بايت تُعرض بجميع ترميزات العناوين الثلاثة، وتتشارك رصيداً واحداً قابلاً للإنفاق على كل مسار:

import { deriveUnifiedAccount } from "@qorechain/sdk";

const account = await deriveUnifiedAccount(mnemonic);
account.cosmos; // "qor1…" (bech32, Native lane)
account.evm; // "0x…" (EIP-55, EVM lane)
account.svm; // base58 (20 bytes + 12 zero bytes)

التوقيع على المسار الأصلي بنفس المفتاح يتم عبر signClassicalEth / signHybridEth، ويُربط مفتاح Phantom أو MetaMask بالحساب كمُصادِق (أُزيل الاشتقاق من توقيع Phantom في الإصدار 0.8.0). أما الاشتقاق التقليدي بنوع العملة 118 عبر deriveNativeAccount فيبقى دون تغيير. راجع الحسابات الموحّدة.

0.6.1 — إصلاح حرج للإجماع. أصبح امتداد جسم المعاملة PQCHybridSignature الآن مُرمَّزاً بصيغة protobuf (كان مُرمَّزاً بصيغة JSON ويُرفض عند CheckTx). المعاملات الهجينة المبنية بإصدار SDK ‏≤ 0.6.0 تُرفض على السلسلة — قم بالترقية.

0.7.0 — مسارات المصادقة (السلسلة v3.1.85). وحدة abstractaccount التي تقوم عليها متوقفة حالياً على الشبكة الرئيسية ومفعَّلة على شبكة الاختبار (راجع دليل المصادِقات). يمكن لمفتاح Phantom مرتبط ‏(ed25519) أو MetaMask ‏(secp256k1، عبر عنوان من 20 بايت) أن ينفق من الحساب القانوني الذي يتطلب PQC عبر مُرحِّل، وفق شروط قائمة على أدنى الامتيازات ومحدودة الإنفاق وقابلة للإلغاء: مُنشئات MsgExecuteEVM / MsgExecuteCosmos / MsgRotatePQCKey، ومساعدات مطابقة للبايت evmAuthSignBytes / cosmosAuthSignBytes / rotationSignBytes، واستعلام permissionSchema، ورموز أخطاء مفكوكة الترميز، ومُنشئات محافظ بـ TypeScript ‏(buildPhantomExecuteCosmos و buildMetaMaskExecuteEvm، …). شرح كامل مع أمثلة قابلة للنسخ واللصق: المصادِقات والإنفاق المفوَّض.

0.8.0 – 0.8.3 — بايتات التوقيع الهجينة v2 ونافذة تفويض EVM (السلسلة v3.2.0). يُوقَّع النصف ما بعد الكمومي من المعاملة الهجينة الآن بالصيغة التي تتحقق منها الشبكة المستهدفة (v1 أو v2، signBytesVersion: "auto" | "v1" | "v2"). كلتا الشبكتين العامتين على v2، لذا يلزم SDK 0.8.1 أو أحدث للتعامل على الشبكة الرئيسية (استخدم الإصدار الحالي). تضيف 0.8.2 الدوال openEvmWindowMsg و closeEvmWindowMsg و fetchEvmWindow و classifyEvmWindowRejection الخاصة بـ نافذة التفويض على مسار EVM. أزالت 0.8.0 مساعدات الحساب المعتمدة على توقيع المحفظة (connectPhantomUnified و unifiedAccountFromPhantomSignature، أُزيلتا في 0.8.0)، وتطبق فحوص صارمة لأحجام ML-DSA-87 في كل لغة، وتضيف العلم async وبيانات المُستدعى المُعادة إلى الاستدعاءات عبر الآلات الافتراضية. وتصلح 0.8.3 البحث عن المعاملات، وسباقات خطافات React، وترتيب تسلسل migrate_to_hybrid في Python، والاشتقاق القانوني لـ PQC المستقل عن صيغة العنوان (derivePqcCanonical، canonicalAccount). راجع ملاحظات الترقية.

0.9.0 — دعم العميل للسلسلة v3.2.2 وv3.2.3. يوقّع TxClient في TypeScript توقيعاً هجيناً عندما تمرّر زوج مفاتيح الحساب (client.connectTx(signer, { pqcKeypair }))، فتعمل bankSend وعملاء SDK الخاصون بـ rollup وmultilayer وcross-VM على الشبكات العامة. وتتحقق ensurePqcRegistered من المفتاح المسجَّل عبر REST أولاً، وترفض تسجيل مفتاح ثانٍ مختلف، وترفق إثبات الحيازة بنفسها متى طبّقت الشبكة v3.2.3. وتغطي مُنشئات جديدة نوافذ EVM المحدّدة النطاق (nativeOnly وallowedTargets) ورسائل موافقة EIP-7702، وتعطي derivePqcCanonical(address, mnemonic) مفتاحاً يمكنك استرداده من العبارة الاستذكارية في كل لغة. ومسار حساب PQC هو المفرد /qorechain/pqc/v1/account/{address}، وتحتفظ حالات الفشل داخل الكتلة بالـ codespace الخاص بها، وتهيّئ create-qorechain-dapp المشاريع على SDK الحالية. راجع ما الذي أضافه الإصدار 0.9.0.

0.10.0 — دعم العميل للسلسلة v3.2.4. مُنشئات وقراءات طبقات التحصيص (lockDelegation وunlockEarly وclaimBonus وfetchStakingTierParams وfetchStakingLocks)، وfetchAuthNonce لمعرفة التسلسل التالي لمفتاح مرتبط، وfetchProtocolFeatures / isProtocolFeatureEnabled لمعرفة قواعد الإجماع التي تفرضها الشبكة بالاسم، وpossessionProven في حالة PQC، وibcTimeoutTimestamp. وتقارن ensurePqcRegistered الآن المفتاح المسجَّل بدلًا من الوثوق بحالة بلا مفتاح، ويُسمّى رفض السلسلة الذي يصل كنص أثناء محاكاة الرسوم في كل لغة. راجع ما الذي أضافه الإصدار 0.10.0.

0.12.0، دعم العميل للسلسلة v3.2.5. تشير الإعدادات المسبقة mainnet وtestnet الآن افتراضيًا إلى نقاط النهاية العامة (ويحتفظ إعداد localnet، ومعرّف السلسلة qorechain-devnet، بمنافذ localhost القديمة). وتستخدم الرسوم "auto" للمعاملة الهجينة قاعدة الغاز الدقيقة على الشبكات التي طبّقت v3.2.5 (ceil(simulated x 1.02) + 2000، أي نحو 171,600 غاز لإرسال bank هجين بدلًا من نحو 289,000). ولسجل مفاتيح ML-KEM-1024 مؤلِّفات (msg.pqc.registerKemKey و msg.pqc.removeKemKey) وقراءة (fetchKemKey)، وهي تستجيب على الشبكة الرئيسية. وهناك قراءات لقواعد إنفاق الحسابات المجرّدة ومفاتيحها المرتبطة، وبُناة مفحوصون لمقترحات معاملات cross-VM وrollup. وتدخل في ذلك مجموعة أدوات مطوري السلسلة (قوالب EVM وQoreChain Native، وسلاسل viem للشبكتين). لم يكن هناك 0.11.0 خارج npm؛ وانتقلت اللغات الأخرى من 0.10.0 إلى 0.12.0. انظر ما الذي يضيفه الإصدار 0.12.0.

0.13.0، تغيير واحد في مساعد الحساب على مسار البذرة. تحتاج unifiedAccountFromSeed ونظائرها في اللغات الأخرى الآن إلى رمز استرداد QRC1 أو سر PQC مستقل من 32 بايتًا؛ أما الحسابات المشتقة من عبارة ذاكرية وصيغة التوقيع وسلوك السلسلة فدون تغيير. أُضيفت دوال رمز الاسترداد في كل لغة، وتُبلغ migrateToHybrid عن keyVerified. انظر ما الذي يغيّره الإصدار 0.13.0.

0.14.0، دعم العميل لسلسلة v3.2.8. يحتاج ربط المفتاح إلى إثبات حيازة، وتحتاج المفاتيح التي تنقل قيمة إلى قاعدة إنفاق (ومساعد يبني الزوج)، وتحتاج تحديثات معاملات الحوكمة إلى كل الحقول، ويمكن قراءة التنفيذات المفوَّضة الفاشلة، وتقبل نافذة EVM ثلاث قوائم إضافية. تسري القواعد الجديدة متى شغّلت الشبكة v3.2.8: شبكة الاختبار منذ 12 نوفمبر 2026؛ ولم تطبّقها الشبكة الرئيسية. انظر ما الذي يغيّره الإصدار 0.14.0.

إلى أين تتجه بعد ذلك​