قابلية التشغيل البيني عبر الأنوية الافتراضية
صُمّمت بنية الأنوية الافتراضية الثلاثية في QoreChain (EVM، QoreChain Native، SVM) لتتيح للعقود الذكية على أي آلة افتراضية التواصل مع العقود على أي آلة افتراضية أخرى. توفر وحدة x/crossvm رسالة استدعاء لها مسار ضمن المعاملة نفسها ومسار عبر الطابور.
لا تتوفر الاستدعاءات عبر الأنوية الافتراضية إلا بقدر توفر المسار (lane) الهدف:
MsgCrossVMCallمعطّلة على الشبكة الرئيسية بواسطة قاطع الدائرة (circuit breaker) (qorechaind query circuit disabled-list)؛ وهي مفعّلة على شبكة الاختبار.- مسار SVM معطّل للمعاملات على كلتا الشبكتين، لذا لا يمكن تشغيل مقطع SVM.
- رفع عقود QoreChain Native مقيّد بأذونات على كلتا الشبكتين، وإنشاء النسخ منها مقيّد بأذونات على الشبكة الرئيسية، التي لا تحتوي على أي شيفرة عقد مخزّنة، لذا لا يوجد بعدُ عقد QoreChain Native يمكن استدعاؤه على الشبكة الرئيسية. وعلى شبكة الاختبار خزّنت الحوكمة بضعة عقود مراجَعة يستطيع أي حساب إنشاء نسخة منها (انظر تطوير QoreChain Native)، لذا يمكن أن يوجد هناك هدف QoreChain Native.
- الـ precompile المتزامن في EVM غير مفعّل على الشبكة الرئيسية ومفعّل على شبكة الاختبار مع قائمة سماح بعقود QoreChain Native جرت مراجعتها (قُرئ في 7 نوفمبر 2026؛ وأُجري بعد ترقية v3.2.7 استدعاء للقراءة فقط عبره، انظر أدناه). توجد نسخة مُحصَّنة منه في الملف الثنائي منذ v3.2.3. (وفي 27 أكتوبر 2026 فعّلت حوكمة شبكة الاختبار ثلاثة precompiles أخرى هي PQC Verify وPQC Key Status وPRISM Consensus Params، وانضم جسر CrossVM إلى قائمة شبكة الاختبار بحلول 4 نوفمبر؛ ولا يوجد أي منها مفعّلًا على الشبكة الرئيسية.)
على الشبكة الرئيسية، مسارات REST الخاصة بالوحدة (/qorechain/crossvm/v1/...) لا تقدّمها البوابة العامة (501)؛ اقرأ الرسائل عبر واجهة سطر الأوامر أو عبر عميل استعلام gRPC/ABCI.
تُعيَّن نقاط النهاية أدناه افتراضياً إلى عقدة محلية. على الشبكة الرئيسية، استخدم نقاط نهاية RPC الخاصة بـ qorechain-vladi (Cosmos RPC 26657، EVM JSON-RPC 8545)؛ أما شبكة الاختبار فهي qorechain-diana.
نظرة عامة على البنية
EVM (Solidity) QoreChain Native (Rust/Wasm) SVM (BPF)
| | |
|--- sync (precompile) ->| |
| | |
|<-- async (EndBlocker) -|-- async (EndBlocker) ->|
| | |
|<------------ async (EndBlocker) ----------------|
| المسار | الاتجاه | التوقيت | الآلية |
|---|---|---|---|
| المتزامن | EVM إلى QoreChain Native | المعاملة نفسها | Precompile عند 0x0000...0901 (مفعّل على شبكة الاختبار، وغير مفعّل على الشبكة الرئيسية؛ انظر أدناه) |
| رسالة، الافتراضي | أي آلة افتراضية إلى أي آلة افتراضية أخرى | المعاملة نفسها | MsgCrossVMCall؛ ينفَّذ الاستدعاء فوراً، ويؤدي أي إخفاق إلى ارتداد المعاملة بأكملها |
| رسالة، عبر الطابور | أي آلة افتراضية إلى أي آلة افتراضية أخرى | الكتلة التالية (أو لاحقاً) | MsgCrossVMCall مع ضبط async؛ تنتظر الرسالة في الطابور |
المسار المتزامن (EVM إلى QoreChain Native)
يستخدم المسار المتزامن precompile في EVM عند العنوان 0x0000000000000000000000000000000000000901. وهو مصمَّم ليتيح لعقود Solidity استدعاء عقود QoreChain Native وتلقي استجابة ضمن المعاملة نفسها.
الـ precompile الخاص بجسر CrossVM غير مفعّل على qorechain-vladi: ينجح الاستدعاء إلى 0x…0901 هناك ويعيد بيانات فارغة. وعلى qorechain-diana تحتوي القائمة active_static_precompiles على 0x…0901 (قُرئت في 7 نوفمبر 2026)؛ وأُجري عبره استدعاء eth_call للقراءة فقط في 7 نوفمبر 2026، بعد ترقية v3.2.7 (النتائج أدناه). يحمل الملف الثنائي v3.2.3 نسخة مُحصَّنة منه (يرفض STATICCALL، ويحتسب استدعاءه المتداخل ضمن غاز الإطار المستدعي ويسجّله في السجل بحيث يتراجع جانب QoreChain Native أيضاً عند ارتداد EVM، ولا يصل إلا إلى أهداف QoreChain Native المدرجة في قائمة السماح، ويحترم قاطع الدائرة الخاص بالاستدعاءات عبر الأنوية الافتراضية)، لكنه لا يعمل إلا حيث أضافه مقترح معتمد بالحوكمة إلى القائمة المفعّلة (شبكة الاختبار حتى الآن، لا الشبكة الرئيسية). وعلى الشبكة الرئيسية يبقى الـ precompile والاستدعاءات عبر الآلات الافتراضية متوقفة، حتى بعد ترقية v3.2.7 في 12 نوفمبر 2026، إلى أن يصدر قرار حوكمة منفصل. المثال أدناه هو الشكل الذي تفكّ العقدة ترميزه؛ ولا يمكن أن يعمل على الشبكة الرئيسية ما لم يُفعَّل الـ precompile. أما على شبكة الاختبار فيمكن استدعاؤه ضمن قائمة السماح (القسم التالي). راجع الـ Precompiles في EVM: حالة الشبكة.
مثال Solidity
تفكّ العقدة ترميز مُدخل الـ precompile على أنه محدِّد (selector) من 4 بايتات يليه الوسائط المُرمَّزة بـ ABI للدالة executeCrossVMCall(uint8 targetVM, string targetContract, bytes payload) (المحدِّد 0x3c11078c). تكون قيمة targetVM هي 1 لعقد QoreChain Native (وQoreChain Native هو وقت تشغيل CosmWasm؛ أما 0 فهو EVM، الذي يرفضه الجسر المُحصَّن هدفًا). أما targetContract فهو عنوان bech32 للعقد كسلسلة نصية، وpayload هو رسالة execute الخاصة بالعقد كبايتات JSON بترميز UTF-8. ويعيد الـ precompile بايتات استجابة الهدف الخام.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
contract CrossVMCaller {
address constant CROSSVM = 0x0000000000000000000000000000000000000901;
uint8 constant TARGET_QORECHAIN_NATIVE = 1;
function callQoreChainNative(string calldata contractAddr, bytes calldata executeMsg)
external
returns (bytes memory)
{
bytes memory data = abi.encodeWithSignature(
"executeCrossVMCall(uint8,string,bytes)",
TARGET_QORECHAIN_NATIVE,
contractAddr,
executeMsg
);
(bool ok, bytes memory ret) = CROSSVM.call(data);
require(ok, "cross-VM call failed");
// While the precompile is not active, the call succeeds with empty data
// and nothing executes; treat an empty reply as a failure.
require(ret.length > 0, "cross-VM precompile not active or empty reply");
return ret;
}
}
هذا هو الشكل الذي تفكّ العقدة ترميزه؛ وهو الشكل نفسه الذي يبنيه مرمِّز @qorechain/rdk، ويطابق العقد أعلاه نموذج البداية في Multi-VM. لا يمكن إرفاق أموال عبر الـ precompile (فمسار الرسالة MsgCrossVMCall يقبل --funds). ولا يستطيع هذا النموذج فعل أي شيء اليوم على الشبكة الرئيسية، لأن الـ precompile غير مفعّل هناك؛ وعلى شبكة الاختبار يعمل ضمن قائمة السماح الموصوفة تاليًا؛ أما العقد النموذجي نفسه فلم يُنشر لأجل هذه الصفحة، وقد أُجري الاستدعاء أدناه مباشرة بالطريقة eth_call.
حيثما يكون الـ precompile مفعّلًا، ينفّذ عقد QoreChain Native فوراً ويُرجع النتيجة. (تبني دالة المساعدة encodeCrossVmCalldata في @qorechain/rdk، المتاحة منذ 0.6.0 وفي الإصدار الحالي 0.8.0، بيانات الاستدعاء (calldata)؛ راجع Multi-VM.) تكلفة الغاز: 50,000 أساسية + 4 لكل بايت إدخال + تكلفة التنفيذ.
سلوك شبكة الاختبار (قائمة السماح، جرى التحقق في 7 نوفمبر 2026)
على qorechain-diana (إصدار العقدة v3.2.8 منذ 12 نوفمبر 2026) لا يصل الـ precompile إلا إلى عقود QoreChain Native الموجودة في قائمة سماح الجسر. يسردها GET /qorechain/crossvm/v1/params في bridge_allowed_targets (ثلاثة إدخالات في 7 نوفمبر 2026، مكتوبة بالصيغة cosmwasm:qor1...)، إلى جانب enabled بقيمة true وmax_message_size بقيمة 65536 وmax_queue_size بقيمة 1000 وqueue_timeout_blocks بقيمة 100. أُجري طلبا eth_call للقراءة فقط إلى 0x…0901 بالاستدعاء executeCrossVMCall(1, target, 0x7b7d) في 7 نوفمبر 2026:
- هدف خارج قائمة السماح: يرتدّ مع الرسالة
cross-VM bridge call refused: target cosmwasm:qor1... is not allowlisted. - هدف في قائمة السماح: يصل الاستدعاء إلى العقد (وتُبلغ العقدة عن خطأ العقد نفسه بسبب الرسالة الفارغة
{}:Error parsing into type cw20::msg::Cw20ExecuteMsg). وهذا يبيّن أن المسار يعمل؛ ولم تُرسل لأجل هذه الصفحة أي معاملة عبر الآلات الافتراضية تغيّر الحالة من خلال الـ precompile.
على الشبكة الرئيسية يبقى الـ precompile (0x…0901) والاستدعاءات عبر الآلات الافتراضية متوقفة (قاطع الدائرة) حتى بعد ترقية v3.2.7 في 12 نوفمبر 2026، إلى أن يصدر قرار حوكمة منفصل.
ما الذي يغيّره v3.2.7 في الاستدعاءات عبر الآلات الافتراضية
تسري هذه التغييرات على شبكة الاختبار منذ 6 نوفمبر 2026 وعلى الشبكة الرئيسية منذ 12 نوفمبر 2026 (يبقى الاستدعاء عبر الآلات الافتراضية نفسه متوقفًا على الشبكة الرئيسية، فلا تهمّ هناك إلا إذا جرى تشغيله):
- الاستدعاء الذي يفشل في الآلة الافتراضية الهدف يفشل الآن بنظافة: يكون فشل ذلك الاستدعاء وحده وتتابع الطابور مع الرسالة التالية.
- تُرفض الأهداف المشوَّهة وقت الإرسال بالرمز 5 في codespace
crossvm. - لم يعد بإمكان استدعاء عبر الآلات الافتراضية أن يستهدف عنوان EVM precompile.
مسار الرسائل (MsgCrossVMCall)
تستخدم الاستدعاءات الأخرى عبر الأنوية الافتراضية معاملة MsgCrossVMCall. تستنتج السلسلة المسار المصدر من المُرسِل، لذا لا تحمل الرسالة سوى الآلة الافتراضية الهدف، والعقد الهدف، والحمولة، والأموال الاختيارية. افتراضياً ينفَّذ الاستدعاء فوراً ضمن المعاملة، وترتدّ المعاملة بأكملها إذا أخفق الهدف. أما مع العلم async فتوضع الرسالة في الطابور بدلاً من ذلك وتعالجها تمريرة طابور نهاية الكتلة (end-block) الخاصة بالوحدة في كتلة لاحقة (انظر دورة الحياة أدناه). وكما ذُكر أعلاه، هذه الرسالة معطّلة على الشبكة الرئيسية.
واجهة سطر الأوامر (CLI)
يأخذ tx crossvm call الآلة الافتراضية الهدف (evm أو cosmwasm أو svm) والعقد الهدف كوسائط موضعية، مع الحمولة بصيغة Hex. لا تطلب واجهة CLI الآلة الافتراضية المصدر: إذ تستخرج السلسلة مسار المُستدعي من الحالة وتتجاهل الحقل المُعلَن (وتملأ CLI قيمة مؤقتة ليجتاز الرسالة تحققها الخاص):
qorechaind tx crossvm call evm 0x1234567890123456789012345678901234567890 \
--payload 0a0b0c --from mykey --generate-only > tx.json
أعلام أخرى: --funds <coins> (لأهداف QoreChain Native فقط) و--async لوضع الاستدعاء في الطابور بدلاً من تنفيذه الآن. وقّع tx.json وأذِعه باستخدام tx pqc cosign (راجع التوقيع ما بعد الكمومي)؛ والحد الأدنى للرسوم هو 0.1 uqor لكل وحدة غاز. يُرفض الاستدعاء إلى مسار المُستدعي نفسه (منذ v3.2.3).
MsgCrossVMCall معطّلة على الشبكة الرئيسية بواسطة قاطع الدائرة، لذا لا يمكن أن ينجح الأمر هناك اليوم. (كانت الملفات التنفيذية للإصدارات السابقة لـ v3.2.3 تبني أيضاً رسالة تفشل في التحقق الخاص بها لأن الآلة الافتراضية المصدر فارغة؛ ويصلح الملف الثنائي v3.2.3 ذلك.) وعلى شبكة الاختبار تكون الرسالة مفعّلة، لكن مسار SVM معطّل، لذا لا يمكن الوصول إلى هدف SVM؛ ويمكن الوصول إلى هدف EVM، وإلى هدف QoreChain Native متى أُنشئت نسخة من عقد هناك.
دورة حياة الرسالة
تنتقل كل رسالة عبر الأنوية الافتراضية موضوعة في الطابور خلال مجموعة محددة من الحالات:
Submitted --> Pending --> Executed
|
+--> Failed
|
+--> Timed Out
| الحالة | الوصف |
|---|---|
| Submitted | قُبِلت الرسالة في الطابور |
| Pending | بانتظار التنفيذ في تمريرة EndBlocker التالية |
| Executed | استُدعي العقد الهدف بنجاح؛ سُجِّلت الاستجابة |
| Failed | ارتدّ تنفيذ العقد الهدف؛ سُجِّل الخطأ |
| Timed Out | تجاوزت الرسالة queue_timeout_blocks دون تنفيذ |
منذ v3.2.3 يُتراجع عن الاستدعاء الموضوع في الطابور والذي يفشل بكامله: لا يبقى منه سوى سجل Failed، ولم تعد الأموال المرفقة باستدعاء QoreChain Native فاشل تُنقل إلى العقد. وما دامت الوحدة معطّلة، أو دامت MsgCrossVMCall معطّلة بواسطة قاطع الدائرة، فإن الطابور لا يُنفَّذ: تبقى الرسائل الموضوعة فيه معلّقة وتنتهي صلاحيتها عند انتهاء مهلتها ما لم يُرفع التعطيل قبل ذلك.
الاستدعاءات غير المتزامنة إلى CosmWasm (v3.2.8)
منذ الإصدار v3.2.8 (على شبكة الاختبار فقط إلى حين ترقية لاحقة للشبكة الرئيسية) يُدفع مسبقاً ثمن الاستدعاء غير المتزامن إلى CosmWasm ويوضع في الطابور بحدود:
حقل MsgCrossVMCall | المعنى |
|---|---|
async_gas_limit (8) | وحدات غاز العقد التي تحجزها للاستدعاء الموضوع في الطابور (الافتراضي 500,000) |
async_max_factor (9) | أعلى عامل ازدحام تقبله له (الافتراضي 4x)؛ يُرفض الاستدعاء إذا كان العامل السائد أعلى منه |
- الضمان (escrow). يدفع المرسل مسبقاً وحدات الغاز x العامل x سعر الغاز إلى حساب ضمان. وعند القيم الافتراضية يساوي ذلك 500,000 x 4 x 0.1 uqor، أي نحو 0.2 QOR. ويُردّ ما لم يستخدمه الاستدعاء عند تنفيذه.
- رسم موضع الطابور. يدفع وضع الاستدعاء في الطابور أيضاً رسماً صغيراً للموضع.
- 100 استدعاء معلّق لكل مرسل كحد أقصى. يُرفض أي استدعاء إضافي حتى ينتهي أحدها أو تنتهي مهلته.
- تُحاسَب الاستدعاءات الفاشلة. الاستدعاء الذي يفشل يدفع مع ذلك ثمن العمل المنجز.
- الاستدعاءات الثقيلة: ارفع
async_gas_limitوasync_max_factorللعقود التي تحمّل شيفرة كبيرة؛ فعقد بحجم cw721 لا يناسب القيم الافتراضية في أول استدعاء له في الكتلة. - من الشيفرة. يقبل SDK 0.14.0 الحقلين في كل لغة (في TypeScript:
asyncGasLimitوasyncMaxFactor، وتتحقق منهماvalidateCrossVmAsyncGas؛ وقيمةasyncMaxFactorبالجزء من المليون، فـ 1,000,000 تعني 1x). ويعيد أيضاً كل صفحات الاستعلام المقسَّم إلى صفحات عن الاستدعاءات المعلّقة. لم يُشغَّل هذا على شبكة الاختبار.
المعاملات (Parameters)
| المعامل | القيمة | الوصف |
|---|---|---|
enabled | true | مفتاح على مستوى الوحدة (أما رسالة الاستدعاء نفسها فمعطّلة بشكل منفصل على الشبكة الرئيسية) |
max_message_size | 65,536 bytes | الحد الأقصى لحجم الحمولة لكل رسالة |
max_queue_size | 1,000 | الحد الأقصى للرسائل المعلّقة في الطابور |
queue_timeout_blocks | 100 | عدد الكتل قبل انتهاء مهلة رسالة غير معالَجة |
الأحداث
تُصدر وحدة x/crossvm الأحداث التالية:
| الحدث | السمات | الوصف |
|---|---|---|
crossvm_request | message_id, source_vm, target_vm, target_contract, sender | تم إرسال رسالة جديدة عبر الأنوية الافتراضية |
crossvm_response | message_id, status, result | نُفّذت الرسالة (نجاح أو فشل) |
crossvm_timeout | message_id, source_vm, target_vm | انتهت صلاحية الرسالة دون تنفيذ |
اشترك في الأحداث عبر WebSocket:
wscat -c ws://localhost:26657/websocket
> {"jsonrpc":"2.0","method":"subscribe","params":["tm.event='Tx' AND crossvm_request.message_id EXISTS"],"id":1}
الاستعلام عن الرسائل
واجهة سطر الأوامر (CLI)
# Query a specific message by ID
qorechaind query crossvm message <message-id>
# List pending messages (from v3.2.8 one page of at most 100; follow the next key for more)
qorechaind query crossvm pending
# Module parameters
qorechaind query crossvm params
JSON-RPC
غير مُقدَّم بعد: لا يوجد أي إصدار منشور للعقدة يقدّم مساحة أسماء JSON-RPC
qor_، لذا يعيد هذا الاستدعاء اليوم-32601(الطريقة غير موجودة) على كل نقطة نهاية عامة. راجع مساحة الأسماءqor_.
curl -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "qor_getCrossVMMessage",
"params": ["<message-id>"],
"id": 1
}'
صيغة الاستجابة
{
"message_id": "crossvm-00000042",
"source_vm": "cosmwasm",
"target_vm": "evm",
"target_contract": "0x1234...abcd",
"sender": "qor1sender...",
"payload": "...",
"status": "executed",
"result": "0x...",
"submitted_height": 12345,
"executed_height": 12346
}
اعتبارات التصميم
الذرّية (Atomicity): صُمّمت الاستدعاءات المتزامنة (EVM إلى QoreChain Native عبر الـ precompile) لتكون ذرّية، بحيث إذا ارتدّ أي من الطرفين ترتدّ المعاملة بأكملها. يسجّل الـ precompile المُحصَّن الاستدعاء المتداخل في السجل، بحيث يتراجع جانب QoreChain Native أيضًا عند ارتداد العقد المستدعي؛ وهو مفعّل على شبكة الاختبار فقط. أما الاستدعاءات غير المتزامنة فهي ليست ذرّية عبر الكتل؛ صمّم عقودك لتتعامل مع حالتي Failed وTimed Out بسلاسة.
الترتيب: تُعالَج الرسائل في الطابور بنظام الوارد أولاً يخرج أولاً (FIFO) ضمن كل تمريرة EndBlocker. لا يوجد ترتيب مضمون عبر الأنوية الافتراضية المصدرية المختلفة.
ترميز الحمولة: تعتمد صيغة الحمولة على الآلة الافتراضية الهدف:
- أهداف EVM: استدعاءات دوال مُرمَّزة بـ ABI
- أهداف QoreChain Native: رسائل execute مُرمَّزة بـ JSON
- أهداف SVM: بيانات تعليمات BPF مُرمَّزة بصيغة Hex
الخطوات التالية
- الـ Precompiles في EVM — حالة الـ precompile المتزامن لـ CrossVM والـ precompiles المخطَّط لها الأخرى
- تطوير EVM — تطوير Solidity على QoreChain
- تطوير QoreChain Native — تطوير عقود Rust/Wasm
- تطوير SVM — نشر برامج BPF