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

متعدد الأجهزة الافتراضية (الاستدعاءات عبر الأجهزة الافتراضية)

يتضمّن الـ RDK أدوات مساعدة بلغة TypeScript تُرمّز استدعاءً من عقد EVM إلى precompile الاستدعاءات عبر الأجهزة الافتراضية عند العنوان 0x0000000000000000000000000000000000000901، وهو مصمَّم لتوجيهه إلى عقد QoreChain Native على بيئة تشغيل QoreChain Native (Wasm)، إضافةً إلى قالب هيكلي multivm-rollup يربط بينها. تغطّي هذه الأدوات EVM ← QoreChain Native فقط؛ أما SVM فهو بيئة تشغيل منفصلة وليس جزءًا من الـ precompile.

غير قابل للاستخدام على الشبكات الحيّة بعد

الـ precompile الخاص بالاستدعاءات عبر الأجهزة الافتراضية غير مُفعَّل على الشبكة الرئيسية: قائمة الـ precompiles الثابتة النشطة في وحدة EVM فارغة هناك (جرى التحقق في 4 نوفمبر 2026). أما على شبكة الاختبار فلم تكن القائمة تحتوي إلا 0x…0A01 و0x…0A02 و0x…0C01 عند التحقق في 27 أكتوبر 2026، وصارت تحتوي أيضًا 0x…0901 منذ 4 نوفمبر؛ وقد قُرئت مرة أخرى في 7 نوفمبر 2026 وما زالت تسرد الأربعة جميعًا (راجع الملاحظة تحت إصدار السلسلة v3.2.5). وفي 7 نوفمبر 2026، بعد أن طبّقت شبكة الاختبار إصدار السلسلة v3.2.7، جرى اختبار استدعاء eth_call للقراءة فقط إلى 0x…0901 على شبكة الاختبار: بلغ هدفٌ مدرج في قائمة السماح عقده، ورُفض هدف خارجها (راجع اختُبر على شبكة الاختبار). وعلى الشبكة الرئيسية يُرجع eth_getCode للعنوان 0x…0901 القيمة 0x، والاستدعاء الموجَّه إليه ينجح ببيانات فارغة ولا ينفّذ شيئًا (أرجع eth_call إليه بيانات فارغة في 4 نوفمبر 2026). كما أن رفع عقود QoreChain Native مغلق على الشبكتين، ومسار معاملات SVM معطَّل على مستوى الشبكة بأكملها. وعلى الشبكة الرئيسية، إلى أن يتم تفعيل الـ precompile وإعادة فتح رفع عقود QoreChain Native، لا يوجد ما يمكن استدعاؤه؛ أما على شبكة الاختبار فالـ precompile نشط مع قائمة سماح وجرى اختباره بـ eth_call. توثّق هذه الصفحة الأدوات لتتمكّن من الاستعداد؛ فلا تبنِ عليها تدفقات إنتاجية. راجع EVM Precompiles: Network status.

المُرمِّز يطابق تخطيط السلسلة منذ الإصدار 0.6.0

كانت الدالة encodeCrossVmCalldata في @qorechain/rdk الإصدار 0.5.0 وما قبله (وكذلك نقطة البداية CrossVmCaller.sol في قالب multivm-rollup لتلك الإصدارات) تستخدم executeCrossVMCall(string,bytes)، وهي دالة ذات محدِّد (selector) يختلف عن الذي تفكّ العقدة ترميزه، فلم يكن بإمكان أي استدعاء رمّزته أن يصل إلى الـ precompile حتى على شبكة فعّلته. أما الإصدار 0.6.0 فيرمّز executeCrossVMCall(uint8 targetVM, string targetContract, bytes payload) (المحدِّد 0x3c11078c)، وهو ما تفكّ العقدة ترميزه (محدِّد من 4 بايتات، ثم المعاملات المرمَّزة وفق ABI؛ والقيمة targetVM 1 تعني QoreChain Native، وهي الوجهة الوحيدة المدعومة)، وبحسب ملاحظات الإصدار تمرّ بيانات الاستدعاء الصادرة عن الأداة المساعدة ذهابًا وإيابًا عبر مفكّ الترميز الخاص بالسلسلة نفسها. وقد تتغيّر واجهة ABI قبل التفعيل.

ملاحظة

اعتبارًا من RDK v0.4.2 أصبح معرّف خيار الجهاز الافتراضي لبيئة تشغيل Wasm هو native ‏(QoreChain Native)؛ ويبقى cosmwasm اسمًا بديلًا قديمًا مقبولًا، وكلاهما يُترجم إلى cosmwasm على مستوى الشبكة.

عنوان الـ precompile​

import { CROSS_VM_PRECOMPILE } from "@qorechain/rdk";

console.log(CROSS_VM_PRECOMPILE); // 0x0000000000000000000000000000000000000901

ترميز استدعاء عبر الأجهزة الافتراضية​

رمِّز تخطيط العقدة مباشرةً. والمعامل payload هو رسالة التنفيذ الخاصة بالعقد على هيئة بايتات JSON بترميز UTF-8 (يظهر المثال باستخدام viem):

import { encodeFunctionData, parseAbi, toHex } from "viem";

const abi = parseAbi([
"function executeCrossVMCall(uint8 targetVM, string targetContract, bytes payload)",
]);

const calldata = encodeFunctionData({
abi,
functionName: "executeCrossVMCall",
args: [
1, // QoreChain Native
"qor1cosmwasmcontractaddress...",
toHex(new TextEncoder().encode(JSON.stringify({ transfer: { recipient: "qor1...", amount: "100" } }))),
],
});

تبني الدالة encodeCrossVmCalldata من @qorechain/rdk الإصدار 0.6.0 وما بعده (و0.8.0 هو الحالي) بيانات الاستدعاء نفسها نيابةً عنك:

import {
CROSS_VM_PRECOMPILE,
CROSS_VM_TARGET,
encodeCrossVmCalldata,
isCrossVmPrecompileActive,
} from "@qorechain/rdk";

// Ask the node first: today this answers `active: false` on both networks.
const status = await isCrossVmPrecompileActive("https://api.qore.host");
console.log(status.active, status.reason);

const calldata = encodeCrossVmCalldata({
contract: "qor1cosmwasmcontractaddress...",
msg: JSON.stringify({ increment: {} }),
targetVm: CROSS_VM_TARGET.NATIVE, // 1 = QoreChain Native (CosmWasm); the default
});
// An EVM transaction to CROSS_VM_PRECOMPILE with `data: calldata`.

تقرأ الدالة isCrossVmPrecompileActive(restBase) معامل EVM المسمّى active_static_precompiles عبر REST ولا تُجيب بـ active: true إلا إذا كان عنوان الـ precompile مدرجًا فيه. وهذا هو الفحص الموثوق الوحيد، ويجب أن يتم خارج السلسلة: فالـ precompile يُرجع الرد الخام للهدف، ولذلك لا يستطيع الرد الفارغ التمييز بين precompile غير نشط واستدعاء حقيقي لعقد لا يُرجع شيئًا، كما أن الـ precompile لا يملك bytecode سواء كان نشطًا أم لا. وحتى حين تُبلغ الدالة active: true، توثّق الحزمة أنه منذ إصدار السلسلة v3.2.3 لا يصل الاستدعاء إلا إلى الأهداف التي أدرجتها الحوكمة في قائمة السماح (معامل الأجهزة الافتراضية المتقاطعة bridge_allowed_targets، وكل إدخال بالصيغة <vm>:<contract>)، وأن الاستدعاء من EVM إلى EVM مرفوض.

تغيّرت شبكة الاختبار بعد 30 أكتوبر 2026

في 4 نوفمبر 2026 كانت قائمة الـ precompiles النشطة في شبكة الاختبار (active_static_precompiles في معاملات EVM) تحتوي أيضًا 0x…0901، وسرد GET /qorechain/crossvm/v1/params على شبكة الاختبار ثلاثة أهداف CosmWasm في bridge_allowed_targets. أما الشبكة الرئيسية فلم تتغير في ذلك اليوم: قائمة نشطة فارغة، وقائمة سماح فارغة، وأرجع الاستدعاء eth_call إلى 0x…0901 بيانات فارغة. قُرئت قائمة شبكة الاختبار مرة أخرى في 7 نوفمبر 2026 وما زالت تحتوي 0x…0901. العبارات أدناه التي تقول إن الـ precompile أو قائمة السماح غير نشطة أو فارغة على شبكة الاختبار تصف الفترة من 27 إلى 30 أكتوبر 2026؛ أما السلوك الحالي لشبكة الاختبار ففي اختُبر على شبكة الاختبار.

إصدار السلسلة v3.2.5: قائمة السماح وصيغة الرد وحالات الرفض (على الشبكتين)​

يغيّر إصدار السلسلة v3.2.5 سلوك الجسر. تشغّله الشبكة الرئيسية منذ 29 أكتوبر 2026 (مقترح الحوكمة 14، الارتفاع 3,906,833) وشبكة الاختبار منذ 26 أكتوبر؛ وتعمل الشبكة الرئيسية الآن بالإصدار v3.2.7 وشبكة الاختبار بالإصدار v3.2.8. ولأن الـ precompile غير نشط على الشبكة الرئيسية، فإن صيغة الرد الواردة أدناه هي سلوك هذا الإصدار ولم تُجرَّب هناك؛ أما صيغة الرفض فقد شوهدت على شبكة الاختبار في 7 نوفمبر 2026 (راجع اختُبر على شبكة الاختبار). وحيثما تذكر هذه الصفحة أن الـ precompile يُرجع الرد الخام للهدف فإن ذلك يصف الإصدارات السابقة لـ v3.2.5.

  • مسار لقائمة السماح. يقدّم GET /qorechain/crossvm/v1/params معاملات الجسر، بما فيها قائمة السماح بالأهداف. وقائمة السماح على الشبكة الرئيسية فارغة (جرى التحقق في 4 نوفمبر 2026)، فلا يُسمح بأي هدف بعد؛ وعلى شبكة الاختبار كانت فارغة في 30 أكتوبر (راجع الملاحظة أعلاه).
  • صيغة ثابتة للرد. يُرجع الـ precompile القيمة abi.encode(bytes)، لذا يبلغ الرد دائمًا 64 بايت على الأقل ويمكن تمييز الرد الفارغ من الرد المفقود؛ فكّ ترميزه بـ abi.decode(ret, (bytes)).
  • حالات الرفض تحمل سببًا. عندما يرفض الجسر استدعاءً فإنه يعيده بـ Error(string) (revert)، ويستطيع العقد قراءته وتمريره.
  • نشط على شبكة الاختبار، وغير نشط على الشبكة الرئيسية. العنوان 0x...0901 غير مدرج في قائمة الـ precompile النشطة على الشبكة الرئيسية؛ وتحتويه قائمة شبكة الاختبار (قراءة 7 نوفمبر 2026)، وجرى هناك في ذلك اليوم اختبار الرفض وسلوك قائمة السماح. وتُبقي الشبكة الرئيسية استدعاءات الآلات الافتراضية المتقاطعة متوقفة إلى حين قرار حوكمة منفصل، وكذلك بعد ترقية v3.2.7 (طُبّقت على الشبكة الرئيسية في 12 نوفمبر 2026؛ ورسالة استدعاء cross-VM تبقى متوقفة بقاطع الدائرة).

اختُبر على شبكة الاختبار​

تعمل شبكة الاختبار بإصدار السلسلة v3.2.8 منذ 12 نوفمبر 2026 (الارتفاع 9,929,500). وفي 7 نوفمبر 2026 أُرسل طلبا eth_call للقراءة فقط إلى 0x…0901 ببيانات استدعاء executeCrossVMCall(uint8,string,bytes) (الآلة الافتراضية الهدف 1، والحمولة {}):

الهدفالنتيجة
عنوان CosmWasm غير مدرج في bridge_allowed_targetsارتدّ بالرسالة cross-VM bridge call refused: target cosmwasm:<address> is not allowlisted
عقد CosmWasm من bridge_allowed_targetsبلغ الاستدعاء العقد، فرفض الحمولة الفارغة (Error parsing into type cw20::msg::Cw20ExecuteMsg)، أي أن الجسر سلّمه؛ ولم تُرسل أي رسالة يقبلها العقد

يُظهر هذا قائمة السماح وسبب الارتداد. ولا يُظهر استدعاءً ناجحًا يغيّر الحالة، لأن eth_call لا يغيّر شيئًا ولأن الحمولة لم تكن رسالة صالحة عمدًا. ويقبل الـ precompile ثلاث وسائط؛ أما الصيغة ذات الوسيطين في 0.5.0 وما قبله فلا تبلغه. والشبكة الرئيسية لا تملك هذا السلوك: فالـ precompile متوقف هناك.

في @qorechain/rdk 0.7.0 وما بعده مساعدات لهذا (جرى التحقق منها مقابل ترميزات أنتجها Solidity): getCrossVmParams (قائمة السماح) وcrossVmTargetReady (الـ precompile نشط والجسر مفعّل والهدف في قائمة السماح، مع سبب الحظر عندما لا يكون كذلك) وdecodeCrossVmResult (abi.decode(ret, (bytes))) وdecodeRevertReason (Error(string)).

جانب Solidity​

من عقد EVM تستدعي عنوان الـ precompile باستخدام الاستدعاء المرمّز:

address constant CROSS_VM_PRECOMPILE = 0x0000000000000000000000000000000000000901;

function callCosmWasm(string calldata contractAddr, bytes calldata msg_)
external returns (bytes memory)
{
bytes memory data = abi.encodeWithSignature(
"executeCrossVMCall(uint8,string,bytes)", uint8(1), contractAddr, msg_
);
(bool ok, bytes memory ret) = CROSS_VM_PRECOMPILE.call(data);
require(ok, "cross-VM call failed");
return ret;
}

ولأن الـ precompile غير نشط على الشبكة الرئيسية، فإن استدعاء .call عاديًا إليه هناك يُرجع نجاحًا مع بيانات فارغة ولا ينفّذ شيئًا؛ فالعلم ok لا يدل على أن الاستدعاء قد أحدث أثرًا. والحارس الموثوق داخل العقد هو هدف يُرجع دائمًا إقرارًا غير فارغ، مع require(ret.length > 0) بعد الاستدعاء، بحيث يُعامَل الرد الفارغ على أنه فشل؛ وقالب multivm-rollup يفعل ذلك (من 0.6.0 فصاعدًا).

إنشاء هيكل rollup متعدد الأجهزة الافتراضية​

npm create qorechain-rollup my-app -- --template multivm-rollup

يتضمّن قالب multivm-rollup الملف src/crossvm-call.ts (يتحقق من أن الـ precompile حيّ، ثم يطبع بيانات الاستدعاء) والملف contracts/CrossVmCaller.sol الذي يستدعي executeCrossVMCall(uint8,string,bytes) ويشترط ردًا غير فارغ من الهدف. ومن 0.7.0 يفكّ العقد ترميز النتيجة abi.encode(bytes)، ويشترط الحد الأدنى البالغ 64 بايت الذي يُرجعه precompile نشط، ويمرّر سبب الرفض الصادر عن السلسلة. وهو لا يجعل الاستدعاء يعمل ما دام الـ precompile غير نشط. راجع نشر Rollup للاطلاع على جميع قوالب أداة الإنشاء الهيكلي.