حزمة مطوّري السلسلة (قوالب EVM وQoreChain Native)

حزمة مطوّري السلسلة هي الجزء من QoreChain SDK 0.11.0 الذي يساعد فرق Solidity والعقود الذكية على البناء على QoreChain بالأدوات التي تستخدمها بالفعل. تضيف تعريفات سلاسل viem ومساعِدات نافذة تفويض EVM إلى @qorechain/evm، وأربعة قوالب مشاريع جديدة إلى create-qorechain-dapp (Foundry وHardhat 3 وviem مع wagmi، ورمز QoreChain Native بصيغة CosmWasm)، وبدايات سريعة لـ EVM بخمس لغات، ومرجعًا يوضح كيف تختلف QoreChain EVM عن Ethereum. وهي موجّهة لفرق Solidity التي تنقل عقودها من Ethereum، ولمطوري الواجهات الأمامية لتطبيقات dApp على wagmi وRainbowKit، ولمطوري CosmWasm، ولمشرفي أدوات EVM الراغبين في إضافة QoreChain.

قريبًا: SDK 0.11.0 موسوم لكنه غير منشور على npm

SDK 0.11.0 موسوم على GitHub (qorechain/qorechain-sdk، الوسم v0.11.0، 27 أكتوبر 2026). إصداره على npm معلّق، وفي 27 أكتوبر 2026 لم يجد npm view للإصدار 0.11.0 من @qorechain/evm و@qorechain/sdk و@qorechain/react و@qorechain/svm وcreate-qorechain-dapp أي شيء. لا تقدّم هذه الصفحة أي أمر تثبيت للإصدار 0.11.0. كل بند موسوم من 0.11.0 أدناه لا يعمل من npm اليوم. أما البنود الموسومة متاح اليوم فتعمل: فهي من @qorechain/sdk 0.10.0 و@qorechain/evm 0.8.0 وcreate-qorechain-dapp 0.10.0 وحِزم SDK للغات الأخرى بالإصدار 0.10.0. الإصدار 0.11.0 يغيّر حزم npm وحدها؛ أما SDK الخاصة بـ Python وRust وGo وJava فتبقى على 0.10.0.

تستهدف الحزمة الشبكة الرئيسية (qorechain-vladi، معرّف سلسلة EVM هو 9801) وشبكة الاختبار (qorechain-diana، معرّف سلسلة EVM هو 9800).

المتاح اليوم والقادم في 0.11.0

البند	الحالة	أين
القراءة باستخدام ethers v6 أو web3.py أو go-ethereum أو alloy أو web3j مقابل نقاط النهاية العامة	متاح اليوم (دون الحاجة إلى أي حزمة QoreChain)	البداية السريعة 1
createEvmClient ومساعِدات ERC-20 وERC-721 وERC-1155 وروابط precompiles وPRECOMPILE_ADDRESSES	متاح اليوم في @qorechain/evm 0.8.0	البداية السريعة 2
فتح نافذة تفويض EVM وقراءتها من TypeScript، باستخدام openEvmWindowMsg وfetchEvmWindow وEthNativeSigner وderiveUnifiedAccount	متاح اليوم في @qorechain/sdk 0.10.0	البداية السريعة 5
منشئات النافذة نفسها في Python وGo وRust وJava	متاح اليوم في SDK بالإصدار 0.10.0	الواجهة البرمجية الرئيسية
مساعِدات موافقة EIP-7702 authorizeEvmDelegationMsg وclearEvmDelegationMsg وclassifyEvmDelegationRejection	متاح اليوم في @qorechain/sdk 0.10.0	الواجهة البرمجية الرئيسية
أداة التوليد مع القوالب evm-solidity وfullstack-web وrollup-app	متاح اليوم في create-qorechain-dapp 0.10.0	البداية السريعة 6
تعريفات سلاسل viem المسمّاة qorechain وqorechainTestnet، وQORECHAIN_CHAINS وQORECHAIN_REST_ENDPOINTS	من 0.11.0 (قريبًا)	البداية السريعة 3
evmWindowStatus وopenEvmWindowMessage وevmWindowCost وclassifyEvmWindowRejection ومحوّلات العناوين وثوابت النافذة والمسار الفرعي @qorechain/evm/window	من 0.11.0 (قريبًا)	البداية السريعة 4
القوالب foundry وhardhat وviem-wagmi وcosmwasm والمساعِد pnpm window	من 0.11.0 (قريبًا)	القوالب
PqcStatusBadge في @qorechain/react	من 0.11.0 (قريبًا)	الواجهة البرمجية الرئيسية

الابتكارات

• الإرسال مفوَّض عن قصد، بنافذة محدودة. لا تُقبل معاملة EVM إلا من حساب لديه مفتاح ML-DSA-87 مسجَّل ونافذة تفويض EVM مفتوحة. تُفتح النافذة برسالة على المسار الأصلي موقَّعة بالتوقيع الهجين (secp256k1 مع ML-DSA-87)، ولذلك لا يمكن لمفتاح secp256k1 الذي تحتفظ به مكتبة EVM أن يفوّض الإنفاق وحده. أما معاملة Ethereum نفسها فتبقى معاملة Ethereum عادية.
• نافذة تُحدَّد بحدود، لا بالثقة. تحدّ النافذة عدد الكتل (من 1 إلى 17,280) وعدد معاملات EVM (من 1 إلى 1,000) ومجموعًا بوحدة uqor يغطي القيمة زائد الحد الأقصى للرسوم لكل معاملة مقبولة. وnativeOnly تقصرها على تحويلات QOR العادية، وallowedTargets (16 عنوانًا على الأكثر) تحدّ المستلمين وترفض إنشاء العقود.
• حساب واحد، ترميزان. في حساب eth-native يكون العنوانان 0x وqor1... هما البايتات العشرين نفسها ويُظهران الرصيد نفسه، فيعمل مفتاح واحد على EVM وعلى المسار الأصلي. لرمز QOR 18 خانة عشرية على EVM و6 على المسار الأصلي (uqor)؛ و1 uqor يساوي 10^12 wei.
• مساعِدات تسمّي سبب الرفض. تحوّل classifyEvmWindowRejection المعاملة المرفوضة إلى واحد من أربعة أسباب: no-pqc-key أو no-window أو exhausted أو invalid، انطلاقًا من خطأ viem أو ethers أو نتيجة تسليم على المسار الأصلي أو نص.
• تحديد حجم النافذة بوحدة uqor. تحدّد evmWindowCost وweiToUqorCeil حجم النافذة من القيمة والغاز وسقف الرسوم، مع تقريب wei إلى الأعلى إلى uqor، فيغطي المجموع أسوأ الحالات.
• لا فتح تلقائي. لا تتضمن الحزمة عمدًا أي مساعِد يفتح نافذة قبل الإرسال. فالنافذة موجودة ليكون الإنفاق مفوَّضًا عن قصد.
• محاكاة مجانية. يعمل eth_call وeth_estimateGas لأي حساب دون نافذة ودون مفتاح مسجَّل.
• قوالب تربط النافذة. يتضمن قالبا Foundry وHardhat الأمر pnpm window status|register|open، الذي يشتق مفتاح ML-DSA-87 من السر نفسه الذي يُشتق منه مفتاح EVM، ويسجّله مرة واحدة ويبثّ رسالة الفتح الموقَّعة هجينًا.
• سطح توافق موثَّق. تسرد صفحة مرجعية (قُرئت من نقاط النهاية العامة في 27 أكتوبر 2026) ما يختلف عن Ethereum: أنواع المعاملات والـ forks والنهائية وحقول الرسوم ومساحات أسماء JSON-RPC والـ precompiles. وهي ملخّصة أدناه.

ما تحتويه الحزمة

@qorechain/evm

من 0.11.0 (جديد):

• qorechain (9801) وqorechainTestnet (9800): كائنا سلسلة viem مع نقاط النهاية العامة، والعملة الأصلية QOR بـ 18 خانة عشرية، والمستكشف https://explore.qore.network. تسرد QORECHAIN_CHAINS السلسلتين (الشبكة الرئيسية ثم شبكة الاختبار) لاستخدامهما مع wagmi وRainbowKit. وتربط QORECHAIN_REST_ENDPOINTS كل معرّف سلسلة EVM بنقطة REST الخاصة بمساره الأصلي.
• evmWindowStatus({ rest, address }) تقرأ نافذة الحساب عبر REST (/qorechain/pqc/v1/evm_window/{address})، وتقبل عنوانًا بصيغة qor1... أو 0x، وتجيب بـ { found: false } بدل الفشل عند عدم وجود نافذة. وتحلّل parseEvmWindow الإجابة الخام.
• openEvmWindowMessage(params) تتحقق من الحدود وتركّب الرسالة الأصلية MsgOpenEVMWindow ككائن { typeUrl, value } بسيط، جاهز للتوقيع بواسطة @qorechain/sdk. وتُجري checkOpenEvmWindowParams الفحوص وحدها.
• evmWindowCost وweiToUqorCeil وclassifyEvmWindowRejection وisEvmWindowRejection وtoQorAddress وtoEvmAddress، والثوابت OPEN_EVM_WINDOW_TYPE_URL وCLOSE_EVM_WINDOW_TYPE_URL وMAX_EVM_WINDOW_BLOCKS (17,280) وMAX_EVM_WINDOW_TXS (1,000) وMAX_EVM_WINDOW_TARGETS (16).
• تُنشر مساعِدات النافذة أيضًا دون viem في المسار الفرعي @qorechain/evm/window.

متاح اليوم (0.8.0 وما بعده): createEvmClient وevmAccountFromPrivateKey وwriteContract ومساعِدات erc20 ومساعِدات ERC-721 وERC-1155 وروابط precompiles وPRECOMPILE_ADDRESSES. راجع دليل EVM.

القوالب

لدى create-qorechain-dapp ثلاثة قوالب متاحة اليوم (evm-solidity وfullstack-web وrollup-app؛ راجع أدوات التوليد وCLI). من 0.11.0 يصبح لديه سبعة. والأربعة الجديدة هي:

القالب	ما تحصل عليه
foundry	مشروع Foundry: عقد Counter واختبارات ونص نشر ونقاط RPC مسمّاة qorechain وqorechain_testnet، والأمر pnpm window status|register|open.
hardhat	مشروع Hardhat 3 وviem: عقد Counter واختبارات على الشبكة المحاكاة ووحدة نشر Ignition وشبكتان qorechain وqorechainTestnet، والأمر pnpm window status|register|open.
viem-wagmi	تطبيق dApp بـ Vite وReact وwagmi وRainbowKit مع محفظة QoreX (@qorechain/qorex-rainbowkit) وتعريفات السلاسل من @qorechain/evm. يعرض آخر كتلة ورصيد QOR ونافذة EVM للحساب.
cosmwasm	رمز CW20 على QoreChain Native (CosmWasm) مبني على cw20-base من cw-plus، وبناء محسَّن في Docker، ونص مقترح رفع عبر الحوكمة، ونصوص إنشاء نسخة واستعلام على شبكة الاختبار.

تثبّت القوالب @qorechain/evm و@qorechain/sdk على ^0.11.0، ولذلك لا تُثبَّت من npm إلى أن يُنشر 0.11.0.

الأدلة في مستودع SDK

يحتوي المستودع (docs/docs/guides/، الوسم v0.11.0) على evm-quickstarts.md (عمليات قراءة بـ viem وethers v6 وweb3.py وgo-ethereum وalloy وweb3j، مع قسم "Before you send")، وevm-differences.md ("QoreChain EVM compared with Ethereum")، وevm.md وcosmwasm.md. والمادة نفسها على هذا الموقع: دليل EVM وتطوير EVM وتطوير QoreChain Native.

في الوسم أيضًا ملفات مساهمة لأدوات أخرى (تعريفات سلاسل viem وإدخالات سلاسل Sourcify وامتداد Scaffold-ETH 2) تحت contrib/ وtemplates/scaffold-eth-extension/. وهي ملفات مُعدَّة في المستودع، وليست مدمجة في المشاريع الأصلية.

حالات الاستخدام

1. فريق Solidity ينقل مشروعه من Ethereum. ولّد القالب foundry (من 0.11.0)، وانسخ العقود إليه، ونفّذ forge test محليًا، ونفّذ pnpm window register مرة واحدة وpnpm window open قبل كل دفعة نشر. تسرد الاختلافات ما يجب تغييره: لا معاملات blob، وPREVRANDAO ثابت، ولا تتبّع debug_* على نقاط النهاية العامة.
2. مشروع Hardhat 3 متجه إلى شبكة الاختبار. ولّد القالب hardhat (من 0.11.0)، وأبقِ وحدات Ignition لديك وانشر بـ pnpm deploy:testnet بعد فتح نافذة.
3. واجهة dApp أمامية على wagmi. استورد QORECHAIN_CHAINS في إعداد wagmi وRainbowKit (من 0.11.0)، واعرض نافذة المستخدم بـ evmWindowStatus، وفسّر الإرسال المرفوض بـ classifyEvmWindowRejection.
4. خدمة خلفية بلغة أخرى. تقرأ خدمة Python أو Go أو Rust أو Java الأرصدة وتستدعي العقود باستخدام web3.py أو go-ethereum أو alloy أو web3j كما على Ethereum، اليوم. وللإرسال تبني MsgOpenEVMWindow بـ QoreChain SDK 0.10.0 الخاص بتلك اللغة، وهو متاح.
5. مطوّر CosmWasm. ولّد القالب cosmwasm (من 0.11.0)، واختبر CW20 بـ cargo test، وابنِ Wasm المحسَّن، وقدّم مقترح حوكمة لتخزين الشيفرة، ثم أنشئ نسخة منها على شبكة الاختبار بعد أن يمرّ المقترح.
6. تكامل محفظة أو حفظ. التكامل الذي يحتفظ بالمفاتيح للمستخدمين عليه أن يعلم أن مفتاح secp256k1 وحده لا يستطيع الإنفاق على مسار EVM. فهو يفتح نوافذ ضيقة (nativeOnly أو allowedTargets) موقَّعة بمفتاح ML-DSA-87 للحساب، اليوم باستخدام openEvmWindowMsg من @qorechain/sdk 0.10.0.
7. مشرفو أدوات EVM. يستطيع مشرفو viem وSourcify وScaffold-ETH 2 قراءة ملفات المساهمة المُعدَّة لإضافة معرّفي السلسلة 9800 و9801.

كيف تعمل

• قاعدة التفويض. تقبل السلسلة معاملة EVM من حساب لديه مفتاح ML-DSA-87 مسجَّل ونافذة سارية، وترفضها خلاف ذلك. القاعدة هي ميزة البروتوكول evm-pqc-authorisation-window، المفعّلة على الشبكتين؛ اقرأها في /qorechain/pqc/v1/protocol_features. راجع نافذة تفويض EVM ودليل المعاملة الأولى.
• الفتح والإغلاق. تفتح MsgOpenEVMWindow (/qorechain.pqc.v1.MsgOpenEVMWindow) نافذة، وهي موقَّعة هجينًا؛ وفتح نافذة يحلّ محل أي نافذة سابقة. وتغلقها MsgCloseEVMWindow.
• ما تحدّه النافذة. الكتل (عدد كتل لا مدة زمنية)، ومعاملات EVM، ومجموع بوحدة uqor يغطي القيمة زائد الحد الأقصى للرسوم (حد الغاز مضروبًا في سقف الرسوم) لكل معاملة مقبولة. وتضيّقها nativeOnly وallowedTargets أكثر (راجع تحديد نطاق النافذة).
• الـ nonce. التسلسل الأصلي وnonce الخاص بـ EVM هما العدّاد نفسه. وفتح النافذة يقدّمه، ولذلك افتح النافذة، ثم اقرأ الـ nonce، ثم وقّع معاملة EVM.
• مساعِد القالب. في foundry وhardhat يشتق pnpm window الحساب من PRIVATE_KEY (أو QORE_MNEMONIC)، ويشتق مفتاح ML-DSA-87 الخاص به من السر نفسه، ويسجّل المفتاح مرة واحدة (register) ويبثّ MsgOpenEVMWindow موقَّعة هجينًا (open). وهو يحدّد افتراضيًا نافذة من 600 كتلة و5 معاملات لمعاملات تصل إلى 3,000,000 غاز بسقف رسوم 250 gwei.
• CosmWasm على QoreChain Native. رفع الشيفرة يتم عبر الحوكمة على الشبكتين (code_upload_access تساوي Nobody): تُخزَّن الشيفرة بمقترح حوكمة يحمل MsgStoreCode ومرسله وحدة الحوكمة. الإنشاء (instantiation) مفتوح للجميع على شبكة الاختبار ومغلق على الشبكة الرئيسية (instantiate_default_permission تساوي Everybody على شبكة الاختبار وNobody على الشبكة الرئيسية، قُرئت في 27 أكتوبر 2026). اقرأ الاثنين في /cosmwasm/wasm/v1/codes/params؛ واعرض الشيفرات المخزَّنة في /cosmwasm/wasm/v1/code. لم تكن على الشبكة الرئيسية أي شيفرة مخزَّنة في 27 أكتوبر 2026.

QoreChain EVM مقارنةً بـ Ethereum

قُرئ من نقاط النهاية العامة في 27 أكتوبر 2026 (دليل SDK evm-differences.md). حالة الشبكة (الرسوم وأزمنة الكتل والـ precompiles المفعّلة) مؤرَّخة؛ اقرأها مباشرة قبل الاعتماد عليها.

• الإرسال. تحتاج كل معاملة EVM إلى مفتاح ML-DSA-87 مسجَّل ونافذة مفتوحة لمرسلها، دون استثناءات لأي حساب. وتشمل النشر والتحويلات واستدعاءات العقود جميعًا. والحساب الذي لديه مفتاح مسجَّل لا يملك مسار توقيع كلاسيكيًا على المسار الأصلي أيضًا: كل معاملة أصلية يوقّعها تكون هجينة.
• المحاكاة. لا يحتاج eth_call وeth_estimateGas إلى نافذة.
• أنواع المعاملات. تُقبل الأنواع 0 (legacy) و1 (قائمة الوصول) و2 (EIP-1559) و4 (EIP-7702). معاملات EIP-4844 blob (النوع 3) مرفوضة. تعمل شيفرات Cancun، لكن blobGasUsed وexcessBlobGas تساويان 0 دائمًا، وeth_blobBaseFee غير موجودة، والـ precompile الخاص بتقييم النقطة (0x0a) يعيد خطأ.
• الـ forks. حتى London منذ التكوين الأول؛ وShanghai وCancun وPrague مفعّلة؛ أما Osaka فغير مفعّلة.
• PREVRANDAO (EIP-4399) ثابت (0xff...ff) وmixHash في الترويسة صفر. لا تستخدمه أبدًا مصدرًا للعشوائية.
• EIP-7702 مقبول مع قاعدة خاصة بـ QoreChain: كل سلطة (authority) يكون تفويضها نافذًا تحتاج إلى مفتاح PQC مسجَّل وموافقة لمرة واحدة مسجَّلة بـ MsgAuthorizeEVMDelegation (8 تفويضات على الأكثر في المعاملة الواحدة، ولا سلطة مكرّرة). ولا تُحتسب نافذة الراعي موافقةً من السلطات. وتزيل MsgClearEVMDelegation التفويض. راجع موافقة EIP-7702.
• النهائية. تكون الكتل نهائية عند اعتمادها: تعيد latest وsafe وfinalized الكتلة نفسها، دون إعادة تنظيم ودون كتل أعمام (uncles).
• الرسوم (الشبكتان، 27 أكتوبر 2026). eth_gasPrice تساوي 112.5 gwei؛ والرسم الأساسي 100 gwei (حد السلسلة الأدنى 0.1 uqor للغاز الواحد)؛ وeth_maxPriorityFeePerGas تساوي 12.5 gwei؛ وgasLimit في الترويسة 4,294,967,295. الأدوات التي تضبط سقف الرسوم قرابة ضعف الرسم الأساسي (ومنها Foundry) تحجز من النافذة ما يصل إلى نحو 200 gwei للغاز الواحد بينما تدفع نحو 112.5 gwei.
• مساحات أسماء JSON-RPC. eth وnet وweb3 وtxpool. جميع طرائق debug_* وpersonal_* وadmin_* وminer_* غير متاحة (-32601)، وكذلك trace_* وeth_coinbase وeth_mining وeth_hashrate وeth_getWork وeth_submitWork وeth_blobBaseFee وeth_simulateV1 وeth_callMany وeth_signTransaction وeth_pendingTransactions وeth_config. الأدوات التي تحتاج إلى التتبّع لا تعمل مع نقاط النهاية العامة.
• سلوك مختلف. تعمل eth_getProof لكنها تعيد إثباتات IAVL الخاصة بالسلسلة، لا إثباتات Merkle-Patricia. وتغطي eth_getLogs 10,000 كتلة على الأكثر في الاستعلام الواحد. وتعمل eth_subscribe عبر WebSocket وحده. وتُرفض eth_accounts وeth_sign وeth_sendTransaction لأن العقدة لا تحتفظ بأي حسابات: وقّع محليًا واستخدم eth_sendRawTransaction. وتُرفض txpool_content على نقاط النهاية العامة؛ أما txpool_status فتعمل. وweb3_clientVersion ليست وسيلة موثوقة لاكتشاف العقدة.
• الأرصدة. تعيد eth_getBalance الرصيد المصرفي بوحدة uqor مضروبًا في 10^12 زائد أي باقٍ أقل من uqor.
• الـ precompiles. تستجيب الـ precompiles القياسية في Ethereum كالمعتاد. أما pqcVerify (0x0A01) وpqcKeyStatus (0x0A02) فهما مفعّلان على شبكة الاختبار فقط؛ ولا يوجد أي منها مفعّل على الشبكة الرئيسية، وتفعيل أحدها يحتاج إلى قرار حوكمة، دون موعد. وتسرد شبكة الاختبار أيضًا 0x0C01 (rlConsensusParams). واستدعاء precompile غير مفعّل يعيد بيانات فارغة بدل أن يتراجع، ولذلك اقرأ active_static_precompiles في /cosmos/evm/vm/v1/params قبل الاعتماد على أي منها. راجع EVM Precompiles.
• الأدوات. QoreChain ليست في viem/chains بعد: استورد السلاسل من @qorechain/evm (من 0.11.0). ولا تسرد Sourcify معرّفي السلسلة 9800 و9801 بعد. ومسار SVM غير مفتوح.

طريقة الاستخدام

كل المقاطع التي تقرأ تستخدم شبكة الاختبار العامة (qorechain-diana، معرّف سلسلة EVM هو 9800)، ولا تحتاج إلى مفتاح ولا ترسل شيئًا. رمز ERC-20 التجريبي على العنوان 0x9C2F20329750c16B215bDc50455d320De2a7Ba1c هو رمز على شبكة الاختبار (الرمز WQOR، 18 خانة عشرية)؛ استبدله هو والعنوان بما يخصّك.

التثبيت لكل لغة

اللغة أو الأداة	التثبيت	الحالة	الحد الأدنى للمنصة
TypeScript، قراءات EVM ومساعِدات ERC	npm install @qorechain/evm viem (يُحلّ إلى 0.8.0، الذي لا يتضمن تعريفات السلاسل ولا مساعِدات النافذة)	متاح اليوم	Node.js 20 أو أحدث؛ مع peer هو viem ^2
TypeScript، توقيع رسالة النافذة	npm install @qorechain/sdk (يتضمن 0.10.0 الدوال openEvmWindowMsg وfetchEvmWindow وEthNativeSigner وderiveUnifiedAccount)	متاح اليوم	Node.js 20 أو أحدث
TypeScript، تعريفات سلاسل viem ومساعِدات النافذة	لا شيء بعد	قريبًا (0.11.0)	Node.js 20 أو أحدث
أداة التوليد، القوالب evm-solidity وfullstack-web وrollup-app	npx create-qorechain-dapp my-app --template <name>	متاح اليوم (0.10.0)	Node.js 20 أو أحدث
أداة التوليد، القوالب foundry وhardhat وviem-wagmi وcosmwasm	لا شيء بعد	قريبًا (0.11.0)	Foundry وNode.js 20؛ وNode.js 22 لـ Hardhat 3؛ وRust وDocker لـ cosmwasm
Python (قراءات EVM)	pip install "web3>=7,<8"؛ ورسالة النافذة من qorechain-sdk 0.10.0	متاح اليوم	Python 3.10 أو أحدث
Go (قراءات EVM)	go get github.com/ethereum/go-ethereum@latest؛ ورسالة النافذة من QoreChain Go SDK v0.10.0	متاح اليوم	سلسلة أدوات Go
Rust (قراءات EVM)	alloy = { version = "1", features = ["provider-http", "contract", "sol-types"] }؛ ورسالة النافذة من الحزمة qorechain-sdk 0.10.0	متاح اليوم	Rust المستقرة
Java (قراءات EVM)	org.web3j:core:5.0.0؛ ورسالة النافذة من io.github.qorechain:qorechain-sdk:0.10.0	متاح اليوم	JDK 21 (يُبنى QoreChain Java SDK بسلسلة أدوات JDK 21)

البداية السريعة 1: القراءة بـ ethers v6 (متاح اليوم)

لا حاجة إلى أي حزمة QoreChain. عند تشغيله في 27 أكتوبر 2026 مقابل شبكة الاختبار طبع chain id: 9800n ورصيدًا وtoken: WQOR 18n.

import { Contract, JsonRpcProvider, formatEther } from "ethers";

const provider = new JsonRpcProvider("https://evm-testnet.qore.host", 9800, { staticNetwork: true });

const ADDRESS = "0x000000000000000000000000000000000000dEaD"; // any 0x address
const TOKEN = "0x9C2F20329750c16B215bDc50455d320De2a7Ba1c"; // a test ERC-20 on the testnet
const erc20 = new Contract(
  TOKEN,
  ["function symbol() view returns (string)", "function decimals() view returns (uint8)"],
  provider,
);

const { chainId } = await provider.getNetwork();
const balance = await provider.getBalance(ADDRESS);
const symbol: string = await erc20.symbol();
const decimals: bigint = await erc20.decimals();

console.log("chain id:", chainId); // 9800n
console.log("balance:", formatEther(balance), "QOR");
console.log("token:", symbol, decimals);

القراءة نفسها في web3.py وgo-ethereum وalloy وweb3j موجودة في دليل SDK evm-quickstarts.md (مذكور هناك أنها اختُبرت مع web3.py 7.16 وgo-ethereum 1.17.10 وalloy 1.8 وweb3j 5.0.0 على JDK 21؛ ولم تعِد هذه الصفحة تشغيلها).

البداية السريعة 2: القراءة بالحزمة المنشورة @qorechain/evm 0.8.0 (متاح اليوم)

بداية سريعة مُختبَرة من مركز المطورين. تتصل وتكتشف معرّف سلسلة EVM تلقائيًا وتطبع رصيد QOR لحساب صنبور شبكة الاختبار العامة.

import { createEvmClient } from "@qorechain/evm";
import { formatEther } from "viem";

// Public testnet EVM JSON-RPC (EVM chain ID 9800, auto-detected).
const client = await createEvmClient({ rpcUrl: "https://evm-testnet.qore.host" });

// A public testnet address (the testnet faucet account, EVM form).
const address = "0xf1e70c24817e00aee286f7275e14e61cabd20741";
const wei = await client.publicClient.getBalance({ address });
console.log(await client.getChainId(), address, formatEther(wei), "QOR");

البداية السريعة 3: القراءة بتعريف سلسلة viem (من 0.11.0، قريبًا)

لا يعمل هذا من npm اليوم، لأن 0.8.0 لا تتضمن qorechainTestnet. وعند تشغيله في 27 أكتوبر 2026 بتعريف السلسلة من 0.11.0 محمّلًا من شيفرة المستودع المصدرية (لا من npm)، طبع chain id: 9800 والرمز WQOR.

import { createPublicClient, erc20Abi, formatEther, http } from "viem";
import { qorechainTestnet } from "@qorechain/evm";

const client = createPublicClient({ chain: qorechainTestnet, transport: http() });

const ADDRESS = "0x000000000000000000000000000000000000dEaD"; // any 0x address
const TOKEN = "0x9C2F20329750c16B215bDc50455d320De2a7Ba1c"; // a test ERC-20 on the testnet

const chainId = await client.getChainId();
const balance = await client.getBalance({ address: ADDRESS });
const symbol = await client.readContract({ address: TOKEN, abi: erc20Abi, functionName: "symbol" });
const decimals = await client.readContract({ address: TOKEN, abi: erc20Abi, functionName: "decimals" });

console.log("chain id:", chainId); // 9800
console.log("balance:", formatEther(balance), "QOR");
console.log("token:", symbol, decimals);

البداية السريعة 4: فحص نافذة وتركيب رسالة الفتح (من 0.11.0، قريبًا)

من ملف README الخاص بـ @qorechain/evm عند الوسم v0.11.0. تقرأ ثم تبني كائن رسالة؛ ولا توقّع ولا ترسل. وفي حساب لا نافذة له تعيد evmWindowStatus القيمتين found: false, live: false (جرى التحقق على الشبكتين في 27 أكتوبر 2026).

import { evmWindowStatus, openEvmWindowMessage, evmWindowCost } from "@qorechain/evm";

const w = await evmWindowStatus({ rest: "https://api-testnet.qore.host", address: "0x..." });
// w.live, w.remainingTxs, w.remainingValue (uqor), w.remainingBlocks

const msg = openEvmWindowMessage({
  sender: "qor1...", // the same account; toQorAddress("0x...") converts
  blocks: 600,
  maxTxs: 5,
  maxValue: evmWindowCost({ gas: 3_000_000n, maxFeePerGas: 112_500_000_000n }) * 5n,
});
// Sign `msg` hybrid on the native lane, then read the nonce (opening advances it).

البداية السريعة 5: فتح نافذة من TypeScript (متاح اليوم، SDK 0.10.0 وما بعده)

من دليل SDK evm-quickstarts.md، قسم "Before you send". هذا يرسل معاملة على المسار الأصلي: شغّله فقط بحساب الاختبار الممول الخاص بك، ولا تستخدم أبدًا عبارة مشتركة أو عامة.

import { StargateClient } from "@cosmjs/stargate";
import { EthNativeSigner, deriveUnifiedAccount, openEvmWindowMsg } from "@qorechain/sdk";

const account = await deriveUnifiedAccount(mnemonic); // account.evm = 0x..., account.cosmos = qor1...
const signer = new EthNativeSigner(account, { rest: "https://api-testnet.qore.host" });
const transport = await StargateClient.connect("https://rpc-testnet.qore.host");

await signer.signAndBroadcast(transport, {
  chainId: "qorechain-diana",
  accountNumber, // from /cosmos/auth/v1beta1/accounts/{qor1...}
  sequence,
  fee: { amount: [{ denom: "uqor", amount: "100000" }], gas: "800000" },
  messages: [openEvmWindowMsg({ sender: account.cosmos, blocks: 600, maxTxs: 5, maxValue: "3750000" })],
});
// Now read the nonce and send with viem, ethers, Foundry or Hardhat.

لم يُعَد تشغيل هذا المقطع لأجل هذه الصفحة. القيمة maxValue: "3750000" تساوي 5 معاملات بـ 3,000,000 غاز وسقف رسوم 250 gwei.

البداية السريعة 6: توليد مشروع بأداة التوليد المتاحة

اختُبرت في 27 أكتوبر 2026 داخل مجلد فارغ بـ npx من سجل npm العام (0.10.0، القالب fullstack-web): ولّدت المشروع ونجح البناء.

npx -y create-qorechain-dapp my-dapp --template fullstack-web --network testnet --package-manager npm --yes
cd my-dapp && npm run build

القوالب الجديدة (من 0.11.0، قريبًا)

بعد نشر 0.11.0 ستقبل أداة التوليد أسماء القوالب الأربعة الجديدة (راجع جدول الأعلام أدناه). عندها يُبنى مشروع foundry ويُختبر محليًا بـ forge build وforge test (دون شبكة)، ويقرأ pnpm window status الحساب ومفتاح PQC الخاص به ونافذته. أما pnpm window register وpnpm window open فتبثّان معاملات على المسار الأصلي من حسابك الممول، ويقوم forge script ... --broadcast بالنشر. لا تضع أبدًا مفتاحًا حقيقيًا في .env.example، ولا ترفع .env أبدًا، ولا تموّل أبدًا عبارة BIP-39 التجريبية العامة (abandon مكرَّرة 11 مرة، ثم about).

الواجهة البرمجية الرئيسية

@qorechain/evm (من 0.11.0)

الاسم	ما يفعله
qorechain، qorechainTestnet	كائنا سلسلة viem للمعرّفين 9801 و9800 مع نقاط النهاية العامة والمستكشف.
QORECHAIN_CHAINS	السلسلتان (الشبكة الرئيسية ثم شبكة الاختبار)، لاستخدامهما مع wagmi أو RainbowKit.
QORECHAIN_REST_ENDPOINTS	من معرّف سلسلة EVM إلى عنوان REST للمسار الأصلي.
evmWindowStatus	تقرأ نافذة عبر REST: { found, live, remainingBlocks, remainingTxs, remainingValue, nativeOnly, allowedTargets, ... }.
parseEvmWindow	تحلّل إجابة REST.
openEvmWindowMessage	تتحقق من الحدود وتبني MsgOpenEVMWindow بصيغة { typeUrl, value }.
checkOpenEvmWindowParams	فحوص الحدود وحدها.
evmWindowCost، weiToUqorCeil	تحديد حجم النافذة بوحدة uqor.
classifyEvmWindowRejection، isEvmWindowRejection	تفسّر الرفض: no-pqc-key أو no-window أو exhausted أو invalid.
toQorAddress، toEvmAddress	تحوّل بين 0x وqor1... للحساب نفسه.
OPEN_EVM_WINDOW_TYPE_URL، CLOSE_EVM_WINDOW_TYPE_URL، MAX_EVM_WINDOW_BLOCKS، MAX_EVM_WINDOW_TXS، MAX_EVM_WINDOW_TARGETS	ثوابت.
@qorechain/evm/window	مساعِدات النافذة دون اعتماد viem.

لا توقّع @qorechain/evm معاملات المسار الأصلي ولا تبثّها؛ استخدم @qorechain/sdk أو SDK الخاصة باللغات لذلك.

بناء نافذة وقراءتها في كل SDK (متاح اليوم، 0.10.0)

اللغة	فتح نافذة	قراءة نافذة
TypeScript	openEvmWindowMsg (@qorechain/sdk)؛ openEvmWindowMessage (@qorechain/evm، من 0.11.0)	fetchEvmWindow؛ evmWindowStatus (من 0.11.0)
Python	qorsdk.msg.pqc.open_evm_window	qorsdk.evm_window.get_evm_window
Go	messages.NewOpenEVMWindow (وNewOpenEVMWindowScoped لـ nativeOnly أو allowedTargets)	REST /qorechain/pqc/v1/evm_window/{address}
Rust	qorechain::msg::pqc::open_evm_window	REST /qorechain/pqc/v1/evm_window/{address}
Java	io.github.qorechain.evm.EvmWindow.open	EvmWindow.restPath

موافقة EIP-7702 (TypeScript، @qorechain/sdk 0.10.0): authorizeEvmDelegationMsg وclearEvmDelegationMsg وclassifyEvmDelegationRejection.

تضيف @qorechain/react 0.11.0 المكوّن PqcStatusBadge (التسميتان الافتراضيتان "PQC key registered" و"No PQC key").

أعلام create-qorechain-dapp

العلم	ما يفعله
-t, --template <name>	evm-solidity وfullstack-web وrollup-app (متاحة اليوم)؛ foundry وhardhat وviem-wagmi وcosmwasm (من 0.11.0).
--network <name>	الإعداد المسبق testnet أو mainnet.
--package-manager <pm>	pnpm أو npm أو yarn.
-y, --yes	تخطّي الأسئلة واستخدام القيم الافتراضية.
--no-install	عدم تثبيت الاعتماديات.
-h, --help / -v, --version	المساعدة والإصدار.

نصوص القوالب (من 0.11.0)

القالب	النص	ما يفعله
foundry، hardhat	pnpm window status	يعرض الحساب، وهل مفتاح ML-DSA-87 الخاص به مسجَّل (وهل هو هذا المفتاح)، ونافذته.
foundry، hardhat	pnpm window register	يسجّل مفتاح ML-DSA-87 للحساب، مرة واحدة لكل حساب.
foundry، hardhat	pnpm window open	يفتح نافذة (افتراضيًا 600 كتلة و5 معاملات).
foundry	pnpm deploy:testnet	forge script script/Counter.s.sol --rpc-url qorechain_testnet --broadcast.
hardhat	pnpm build، pnpm test، pnpm deploy:testnet	بناء Hardhat والاختبارات ونشر Ignition إلى qorechainTestnet.
viem-wagmi	pnpm dev، pnpm build	خادم تطوير على http://localhost:5173؛ وبناء للإنتاج.
cosmwasm	pnpm build:wasm، pnpm propose-store، pnpm instantiate، pnpm query	بناء محسَّن، ومقترح رفع عبر الحوكمة، وإنشاء نسخة (شبكة الاختبار)، واستعلامات REST.

متغيرات البيئة للقوالب (في .env، لا تُرفع أبدًا): PRIVATE_KEY وQORE_MNEMONIC وQORE_NETWORK (testnet أو mainnet) وQORE_WINDOW_BLOCKS وQORE_WINDOW_TXS وQORE_WINDOW_MAX_UQOR وCOUNTER_INITIAL؛ وQORE_CODE_ID وQORE_I_KNOW_THIS_IS_MAINNET=yes لنصوص CosmWasm (نص المقترح يرفض الشبكة الرئيسية بدونه)؛ وVITE_WALLETCONNECT_PROJECT_ID لمحفظة WalletConnect في viem-wagmi.

طريقة الوصول

	شبكة الاختبار	الشبكة الرئيسية
معرّف السلسلة الأصلي	qorechain-diana	qorechain-vladi
معرّف سلسلة EVM (eth_chainId)	9800 (0x2648)	9801 (0x2649)
EVM JSON-RPC	https://evm-testnet.qore.host	https://evm.qore.host
EVM WebSocket	wss://evm-ws-testnet.qore.host	غير منشور
REST	https://api-testnet.qore.host	https://api.qore.host
RPC الإجماع	https://rpc-testnet.qore.host	https://rpc.qore.host
المستكشف	https://explore.qore.network	https://explore.qore.network

• القراءات لا تحتاج إلى شيء: لا حساب ولا مفتاح ولا نافذة.
• الإرسال على مسار EVM يحتاج إلى حساب ممول ومفتاح ML-DSA-87 الخاص به مسجَّل على السلسلة (مرة واحدة) ونافذة مفتوحة. وتسجيل المفتاح والنافذة كلاهما معاملتان على المسار الأصلي.
• التكلفة. الحد الأدنى للرسوم 0.1 uqor للغاز الواحد على الشبكتين. والقراءة مجانية. ويأتي QOR الخاص بشبكة الاختبار من الصنبور.
• CosmWasm. لا رفع للشيفرة دون حوكمة على أي من الشبكتين؛ ولا إنشاء نسخ على الشبكة الرئيسية دون حوكمة. لم تكن على الشبكة الرئيسية أي شيفرة مخزَّنة في 27 أكتوبر 2026.
• إصدارات Node والأدوات. راجع جدول التثبيت أعلاه.

أين يُنشر

الإصدارات مقروءة مباشرة من كل سجل في 27 أكتوبر 2026. الوسم v0.11.0 على GitHub موجود (27 أكتوبر 2026)، ولا يوجد بعد كائن إصدار (release) على GitHub له (آخر إصدار هو v0.10.0).

السجل	الحزمة	الإصدار المتاح اليوم	حالة 0.11.0	الرابط
npm	@qorechain/evm	0.8.0	معلّق، غير منشور	https://www.npmjs.com/package/@qorechain/evm
npm	@qorechain/sdk	0.10.0	معلّق، غير منشور	https://www.npmjs.com/package/@qorechain/sdk
npm	@qorechain/react	0.10.0	معلّق، غير منشور	https://www.npmjs.com/package/@qorechain/react
npm	@qorechain/svm	0.8.0	معلّق، غير منشور	https://www.npmjs.com/package/@qorechain/svm
npm	create-qorechain-dapp	0.10.0 (القوالب evm-solidity وfullstack-web وrollup-app)	معلّق، غير منشور	https://www.npmjs.com/package/create-qorechain-dapp
npm	@qorechain/qorex-rainbowkit (تستخدمه viem-wagmi)	0.1.0	ليس جزءًا من 0.11.0	https://www.npmjs.com/package/@qorechain/qorex-rainbowkit
PyPI	qorechain-sdk	0.10.0	ليس جزءًا من 0.11.0	https://pypi.org/project/qorechain-sdk/
crates.io	qorechain-sdk	0.10.0	ليس جزءًا من 0.11.0	https://crates.io/crates/qorechain-sdk
Go proxy	github.com/qorechain/qorechain-sdk/packages/go	v0.10.0	ليس جزءًا من 0.11.0	https://pkg.go.dev/github.com/qorechain/qorechain-sdk/packages/go
Maven Central	io.github.qorechain:qorechain-sdk	0.10.0	ليس جزءًا من 0.11.0	https://central.sonatype.com/artifact/io.github.qorechain/qorechain-sdk

المصدر: github.com/qorechain/qorechain-sdk، الوسم v0.11.0؛ والمسارات packages/evm وcli/ وtemplates/ وdocs/docs/guides/ وcontrib/. ترخيص Apache-2.0، تشرف عليه جمعية QoreChain.

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

• 0.11.0 ليس على npm بعد. كل ما وُسم "من 0.11.0" (تعريفات سلاسل viem ومساعِدات النافذة و@qorechain/evm/window والقوالب الأربعة الجديدة وPqcStatusBadge) لا يمكن تثبيته من أي سجل اليوم. وتعتمد القوالب الجديدة على حزم ^0.11.0، ولذلك حتى التوليد من المستودع لن يُثبَّت من npm إلى أن يتم النشر. وستتغير هذه الصفحة عندما تقدّم npm الإصدار 0.11.0.
• 0.11.0 يغيّر حزم npm وحدها. تبقى Python وRust وGo وJava على 0.10.0، وهي تحتوي أصلًا على منشئات النافذة المذكورة أعلاه.
• @qorechain/evm تقرأ النافذة وتركّب الرسالة؛ ولا توقّع ولا تبثّ معاملات المسار الأصلي.
• لا يوجد مساعِد يفتح نافذة تلقائيًا قبل الإرسال، بحكم التصميم.
• محفظة QoreX في القالب viem-wagmi تجيب على eth_chainId وeth_accounts وeth_requestAccounts وwallet_switchEthereumChain؛ أما طرائق التوقيع الخاصة بـ EVM فيها فغير متاحة بعد. استخدمها للاتصال والقراءة، ووقّع بمحفظة EIP-1193 محقونة.
• مساعِد pnpm window في القوالب يشتق مفتاح ML-DSA-87 من السر نفسه الذي يُشتق منه مفتاح EVM. إذا كان مفتاح الحساب قد سُجّل بمحفظة أخرى، فافتح النافذة من تلك المحفظة بدلًا من ذلك.
• غير متاح على نقاط النهاية العامة: معاملات blob والتتبّع ومساحات الأسماء debug وpersonal وadmin وminer.
• رفع CosmWasm يمرّ عبر الحوكمة على الشبكتين؛ والقالب cosmwasm لا يستطيع تخزين الشيفرة بنفسه.
• المساهمات في الأدوات الأخرى (viem وSourcify وScaffold-ETH 2) هي ملفات مُعدَّة في المستودع، وليست مدمجة في المشاريع الأصلية.
• EVM precompiles على الشبكة الرئيسية: لا يوجد أي منها مفعّل. أما pqcVerify (0x0A01) وpqcKeyStatus (0x0A02) فمفعّلان على شبكة الاختبار فقط.
• حالة الشبكة مؤرَّخة. قُرئت أرقام الرسوم وأزمنة الكتل في 27 أكتوبر 2026.

ملاحظات أمنية

• تصميم النافذة يعني أن مفتاح secp256k1 الذي تحتفظ به مكتبة EVM لا يستطيع أبدًا تفويض الإنفاق وحده: فتح النافذة يحتاج إلى توقيع هجين بمفتاح ML-DSA-87 للحساب. أبقِ النوافذ صغيرة (blocks وmaxTxs وmaxValue) واستخدم nativeOnly أو allowedTargets حيثما أمكن.
• تتضمن maxValue الحد الأقصى لرسوم كل معاملة؛ حدّد حجمها بـ evmWindowCost لا بالقيمة وحدها.
• تقرأ القوالب المفاتيح من .env، المستثنى من git؛ ويحتوي .env.example على قيم نائبة. ويستطيع مستخدمو Hardhat حفظ المفتاح مشفّرًا بـ npx hardhat keystore set PRIVATE_KEY.
• لا تموّل أبدًا عبارة BIP-39 التجريبية العامة (abandon مكرَّرة 11 مرة، ثم about).
• في مقترح CosmWasm على الشبكة الرئيسية، انشر الشيفرة المصدرية وبناءً قابلًا لإعادة الإنتاج (يطبع المحسِّن المجموع الاختباري) كي يتحقق المصوّتون من الملف الثنائي.
• أبلغ عن الثغرات بسرية على security@qore.network.

صفحات ذات صلة

• نظرة عامة على حزم المطورين وأدوات التوليد وCLI (الأداة create-qorechain-dapp 0.10.0 المتاحة)
• نظرة عامة على SDK وتثبيت SDK ودليل EVM (النافذة والنوافذ المحدّدة النطاق وموافقة EIP-7702 والـ precompiles)
• تطوير EVM وEVM Precompiles
• تطوير QoreChain Native (CosmWasm ومقترحات الحوكمة)
• تكاملات QoreX (@qorechain/qorex-rainbowkit)
• QoreSign (التوقيع الهجين على المسار الأصلي)
• QoreScan (جرد استخدام ecrecover وPQC precompile في مصادر Solidity)