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

الأسئلة الشائعة واستكشاف الأخطاء وإصلاحها

هل الشبكة الرئيسية مُفعّلة؟​

نعم. الشبكة الرئيسية مُفعّلة (معرّف السلسلة qorechain-vladi، تعمل منذ 7 يونيو 2026) وتعمل بإصدار السلسلة v3.2.7 (طُبّق عند الارتفاع 4,164,600 في 12 نوفمبر 2026، مقترح الحوكمة 16؛ وطُبّق v3.2.6 عند الارتفاع 4,020,000 في 4 نوفمبر 2026، المقترح 15؛ وطُبّق v3.2.5 عند الارتفاع 3,906,833 في 29 أكتوبر 2026 وv3.2.4 عند الارتفاع 3,742,566 في 23 أكتوبر 2026)؛ وتعمل شبكة الاختبار بالإصدار v3.2.6 منذ 27 أكتوبر 2026، وبالإصدار v3.2.7 منذ 6 نوفمبر وبالإصدار v3.2.8 منذ 12 نوفمبر 2026 (الارتفاع 9,929,500؛ ولم تطبّقه الشبكة الرئيسية). لا تزال نسخة الشبكة الاختبارية المُعدة مسبقًا (qorechain-diana) متاحة أيضًا. ابتداءً من SDK 0.12.0 يستخدم كلا الإعدادين نقاط النهاية العامة افتراضيًا؛ اختر الشبكة عبر createClient({ network: "mainnet" }) واستبدل endpoints فقط لعقدتك الخاصة. راجع الشبكة ونقاط النهاية.

لماذا تصل طلباتي إلى localhost؟​

أنت على SDK قبل 0.12.0، وإعداداتها المسبقة تستخدم نقاط نهاية localhost افتراضيًا: قم بالترقية، أو مرّر كائن endpoints. ابتداءً من 0.12.0 تستخدم createClient() و createClient({ network: "mainnet" }) نقاط النهاية العامة، والإعداد المسبق localnet هو الذي يستخدم localhost.

const client = createClient({
endpoints: {
rest: "https://api-testnet.qore.host",
rpc: "https://rpc-testnet.qore.host",
evmRpc: "https://evm-testnet.qore.host",
},
});

وإذا ظهرت لك بدلًا من ذلك الرسالة "endpoint ... is not configured for the mainnet preset"، فالاستدعاء يحتاج نقطة نهاية لا تضبطها الإعدادات المسبقة العامة (gRPC، أو RPC لـ SVM، أو WebSocket لـ EVM على الشبكة الرئيسية)؛ مرّرها في endpoints.

يحتاج مسار التوقيع (connectTx) إلى نقطة نهاية الإجماع rpc؛ وتستخدمها أيضًا عمليات قراءة QoreChain Native. عمليات قراءة REST تستخدم rest؛ واستدعاءات EVM تستخدم evmRpc (وكذلك استدعاءات qor_، على عقدة تخدم ذلك النطاق). عناوين URL الخاصة بالشبكة الرئيسية موجودة في مرجع الشبكة.

"Cannot find module 'viem'" / "'@solana/web3.js'"​

هذه تبعيات نظيرة (peer dependencies) لحزمتَي @qorechain/evm و @qorechain/svm على التوالي. ثبّتها في مشروعك:

npm i @qorechain/evm viem
npm i @qorechain/svm @solana/web3.js

استدعاء precompile يُطلق خطأ "returned no data" / "feature not present"​

الـ precompiles الخاصة بـ EVM في QoreChain مُدمجة في العقدة لكنها غير مُفعّلة على الشبكة الرئيسية، ولا يُفعَّل منها سوى ثلاثة على شبكة الاختبار: فهي تستجيب فقط حيث تكون عناوينها مُدرجة في معامل active_static_precompiles الخاص بوحدة EVM. هذه القائمة فارغة على الشبكة الرئيسية؛ وعلى شبكة الاختبار تحتوي على الـ precompiles الخاصة بالتحقق من PQC (0x…0A01) وحالة مفتاح PQC (0x…0A02) ومعاملات الإجماع (0x…0C01) (جرى التحقق في 27 أكتوبر 2026؛ واحتوت قائمة شبكة الاختبار أيضًا جسر الآلات الافتراضية المتقاطعة 0x…0901 منذ 4 نوفمبر وفي 7 نوفمبر 2026، نشطًا مع قائمة سماح (جرى اختباره بـ eth_call)، وظلت قائمة الشبكة الرئيسية فارغة)، ولذلك لا يزال زوج الذكاء الاصطناعي لا يردّ بشيء هناك. وحيث يكون الـ precompile غير مُفعّل يُرجع الاستدعاء بيانات فارغة، ولذلك تُبلغ viem عن returned no data ("0x") ويُطلق المساعد خطأً (راجع الـ Precompiles في EVM: حالة الشبكة). على عقدة EVM عادية تفشل الاستدعاءات بالطريقة نفسها. تحقّق من GET /cosmos/evm/vm/v1/params ولفّ كل استدعاء precompile بحيث يُعالج الخطأ لكل استدعاء على حدة.

استدعاء client.qor لديّ يفشل بالرمز -32601​

يستدعي client.qor نطاق JSON-RPC المسمى qor_، وهو نطاق لا تخدمه أي نسخة منشورة من العقدة؛ إذ تُدرج rpc_modules على نقاط نهاية EVM العامة فقط eth و net وrpc وtxpool وweb3. استخدم مسار REST بدلًا من ذلك، على سبيل المثال GET /qorechain/pqc/v1/account/{address} (حالة مفتاح PQC) أو GET /qorechain/burn/v1/stats، عبر client.rest.get(...). راجع نطاق qor_.

المبالغ لديّ تختلف بمقدار مليون​

تحتوي وحدة QOR على 10^6 من وحدات uqor الأساسية. استخدم toBase / fromBase وأجرِ كل الحسابات بالوحدات الأساسية:

toBase("1.5"); // "1500000"
fromBase("1500000"); // "1.5"

لاحظ أن بيئة تشغيل EVM تمثّل QOR بـ 18 منزلة عشرية (وفق اصطلاح EVM)، وهذا يختلف عن الوحدة الأساسية uqor في المسار الأصلي (Native) البالغة 10^6.

ما هي الحزم المنشورة، وأين؟​

جميعها (جرى التحقق في 12 نوفمبر 2026). نواة TypeScript (@qorechain/sdk، 0.14.0)، وحزمة React (@qorechain/react، 0.14.0)، وأداة البناء create-qorechain-dapp (0.14.0، الذي يحمل أيضًا إصلاحات القوالب في 0.13.1)، ومحوّلات EVM/SVM (@qorechain/evm، @qorechain/svm، 0.14.0) متوفرة على npm؛ وعميل Python متوفر على PyPI (pip install qorechain-sdk بالإصدار 0.14.0، والاستيراد qorsdk)؛ وعميل Go متوفر على وسيط الوحدات (module proxy) (go get github.com/qorechain/qorechain-sdk/packages/go@v0.14.0)؛ وعميل Rust متوفر على crates.io (cargo add qorechain-sdk، 0.14.0)؛ وعميل Java متوفر على Maven Central (io.github.qorechain:qorechain-sdk، 0.14.0، JDK 17 أو أحدث). راجع التثبيت للاطلاع على أوامر كل لغة كاملةً.

عبارتي التذكيرية (mnemonic) مرفوضة​

تتحقق الـ SDK من قائمة كلمات BIP-39 ومن رقم التحقق (checksum) معًا قبل اشتقاق أي مفتاح، بحيث تُطلق العبارة المكتوبة بخطأ إملائي خطأً بدلاً من إنتاج حساب خاطئ بصمت. تحقق من الكلمات مجددًا؛ واستخدم validateMnemonic لاختبار العبارة.

معاملات PQC الهجينة​

الإرسال الهجين (الكلاسيكي + ML-DSA-87) مُفعّل وإلزامي على المسار الأصلي (Native) — تُرفض معاملات Native الكلاسيكية فقط على السلسلة (إصدار السلسلة v3.2.0). قبل أن تنجح المعاملة الهجينة في التحقق عبر PQC، يجب تسجيل المفتاح العام الخاص بـ PQC للموقّع صراحةً عبر MsgRegisterPQCKeyV2 (معاملة موقّعة تقليديًا ومعفاة من التوقيع الهجين)؛ أما تضمين المفتاح العام في الامتداد (includePqcPublicKey: true) فلا يسجّله، والسلسلة لا تسجّل المفتاح عند أول استخدام. في TypeScript، أعطِ العميل زوج المفاتيح (client.connectTx(signer, { pqcKeypair })، SDK 0.9.0 أو أحدث) فتُوقَّع كل معاملة يرسلها توقيعًا هجينًا. تقبل السلسلة أي توقيع ML-DSA-87 صالح وفق FIPS-204، سواء كان مُحوَّطًا (hedged) أو حتميًا. تُوقّع الـ SDK بشكل حتمي افتراضيًا (منذ الإصدار 0.5.1) كي يكون للمعاملة دائمًا التوقيع نفسه وتجزئة المعاملة نفسها. إذا فشلت معاملة هجينة برمز pqc رقم 21 (hybrid_verify_failed)، فالسبب هو إصدار بايتات التوقيع أو معرّف السلسلة أو مكتبة PQC قديمة أو مفتاح غير مسجّل أو مختلف، وليس التوقيع المُحوَّط أبدًا. تتحقق كلتا الشبكتين من صيغة بايتات التوقيع v2، لذا استخدم الـ SDK بالإصدار 0.8.1 أو أحدث (0.14.0 هو الحالي) ومرّر rest (أو signBytesVersion): تُطلق الأدوات المُنشئة (builders) خطأً على qorechain-vladi / qorechain-diana من دون أحدهما. راجع استكشاف أخطاء الرمز 21 و الحسابات وتوقيع PQC.

معاملة EVM لديّ مرفوضة برسالة "no open EVM authorisation window"​

منذ إصدار السلسلة v3.2.0، لا يقبل مسار EVM معاملة إلا من حساب لديه مفتاح PQC مسجّل ونافذة تفويض مفتوحة. سجّل مفتاحًا، وافتح نافذة، ثم أرسل. راجع نافذة تفويض EVM. ومع الـ SDK، تُرجع classifyEvmWindowRejection(err) إحدى القيم "no-pqc-key" أو "no-window" أو "exhausted" أو "invalid".

معاملاتي الهجينة تفشل عند CheckTx بخطأ تحليل (parse) للمعاملة​

قم بترقية الـ SDK. الإصدارات 0.6.0 وما قبلها كانت تُسلسل (JSON-serialize) امتداد جسم المعاملة /qorechain.pqc.v1.PQCHybridSignature، وهو ما يرفضه مُفكِّك معاملات السلسلة عند CheckTx. ومنذ الإصدار 0.6.1 أصبح الامتداد مُرمَّزًا بصيغة protobuf (تبدأ القيمة بـ 0x08) في جميع اللغات الخمس — المعاملات الهجينة المُنشأة بإصدارات أقدم تُرفض على السلسلة، في كل مسار (بما في ذلك eth-native).

مع أي إصدارات من السلسلة تعمل الـ SDK؟​

الـ SDK بالإصدار 0.12.0 هي إصدار العميل الخاص بالسلسلة v3.2.5 (الشبكة الرئيسية منذ 29 أكتوبر 2026 عند الارتفاع 3,906,833؛ وشبكة الاختبار منذ 26 أكتوبر). وتعمل الشبكة الرئيسية بالإصدار v3.2.7 (منذ 12 نوفمبر) وشبكة الاختبار بالإصدار v3.2.8 (منذ 12 نوفمبر؛ وv3.2.7 منذ 6 نوفمبر، وv3.2.6 منذ 27 أكتوبر)؛ ولم تتغير صيغة التوقيع حتى v3.2.7، لذا يعمل 0.12.0 على الشبكة الرئيسية. وليس في 0.12.0 أدوات بناء لإضافات v3.2.7 (تسجيل التوقيع المتعدد بعد الكم، ووضع التوقيع النصي، وAPR، وهوية العنقود، ورسائل مفتاح التحقق)، وهي على الشبكة الرئيسية منذ 12 نوفمبر 2026، ولم يُعَد فحص مسار التوقيع فيه مقابل v3.2.7؛ فاستخدم واجهة سطر الأوامر لها. وهي تضيف قاعدة الغاز الدقيقة للمعاملات الهجينة، وأدوات بناء وقراءة سجل مفاتيح ML-KEM، وقراءات الحساب المجرّد، وأدوات بناء معاملات الحوكمة المفحوصة (راجع ما الذي يضيفه 0.12.0)، فوق ما أضافه 0.10.0 للإصدار v3.2.4 (أدوات بناء وقراءات لمستويات الرهن، وfetchAuthNonce وقراءات ميزات البروتوكول، راجع ما الذي أضافه 0.10.0) وما أضافه 0.9.0 للإصدارين v3.2.2 وv3.2.3: أدوات بناء (builders) لإثبات الحيازة الاختياري عند التسجيل (تُرفقه ensurePqcRegistered تلقائيًا متى طبّقت الشبكة v3.2.3)، ونوافذ EVM ذات النطاق المحدد، ورسائل الموافقة الخاصة بـ EIP-7702. أما الـ SDK بالإصدار 0.8.1 أو أحدث فهي تُجري أيضًا معاملات على الشبكتين (صيغة بايتات التوقيع الهجين v2، والتسجيل، والإرسال الهجين، ونافذة EVM، كلها تعمل دون تغيير)، لكن ليس فيها أي من أدوات البناء تلك: استخدم واجهة سطر الأوامر لها (راجع الإصدارات قبل 0.9.0). لم تتغير صيغة التوقيع في v3.2.4 ولا v3.2.5 ولا v3.2.6. وتعمل الشبكة الرئيسية بالإصدار v3.2.7 وشبكة الاختبار بالإصدار v3.2.8 (طُبّق v3.2.5 على شبكة الاختبار في 26 أكتوبر 2026 وv3.2.6 في 27 أكتوبر، وv3.2.7 في 6 نوفمبر وv3.2.8 في 12 نوفمبر؛ وطُبّق على الشبكة الرئيسية v3.2.5 في 29 أكتوبر وv3.2.6 في 4 نوفمبر وv3.2.7 في 12 نوفمبر). ويستمر SDK 0.10.0 و0.9.0 في العمل عليهما لكن ليست فيهما أدوات بناء لإضافات v3.2.5 (سجل مفاتيح ML-KEM، وقاعدة الغاز الدقيقة)؛ ومع هذين الإصدارين استخدم واجهة سطر الأوامر، أو قم بالترقية إلى 0.14.0. وقد بُني 0.12.0 وفُحص مقابل v3.2.5.

تسجيل مفتاح PQC لديّ رُفض لكن الرسوم خُصمت​

ترفض السلسلة تسجيلًا لحساب يملك مفتاحًا بالفعل بعد خصم الرسوم. تقرأ ensurePqcRegistered في 0.9.0 وما بعده المسار GET /qorechain/pqc/v1/account/{address} أولًا (مرّر rest)، وتتخطى التسجيل عندما يكون مفتاح زوج المفاتيح هذا مسجّلًا، وتُطلق PqcKeyMismatchError عندما يكون المسجّل مفتاحًا مختلفًا. أما الإصدارات الأقدم فلم تكن تتحقق أولًا ما لم تمرّر status: { registered: found } بنفسك، حيث تأتي found من ذلك المسار. ومنذ v3.2.3 ترفض السلسلة أيضًا المفاتيح الضعيفة والمنحلّة والمُعاد استخدامها؛ أما المفاتيح الصادرة عن derivePqcCanonical أو tx pqc gen-key فهي سليمة.

الأداة create-qorechain-dapp تثبّت SDK لا تستطيع التوقيع​

النسخة 0.8.0 وحدها من أداة البناء فعلت ذلك: كانت تكتب نطاقات ^0.3.0 لكل من @qorechain/sdk و@qorechain/evm، ونطاق caret على إصدار 0.x يبقى ضمن 0.3. أما النسخة 0.9.0 وما بعدها فتبني الهيكل على الـ SDK الحالية؛ وإن كنت قد استخدمت 0.8.0 فشغّل npm i @qorechain/sdk@latest (و@qorechain/evm@latest) بعد إنشاء الهيكل.

VERSION يقول 0.8.0 لكنني ثبّتّ 0.8.3​

لم يُحدَّث الثابت المُصدَّر VERSION في 0.8.3 وما زال يُبلغ عن 0.8.0؛ ومنذ 0.9.0 يطابق الحزمة. اقرأ الإصدار المثبّت من package.json في الإصدارات الأقدم.

إنفاق المُخوِّل (authenticator) لديّ مرفوض برمز authenticator_replay​

(وحدة abstractaccount معطّلة على الشبكة الرئيسية؛ ويُرفض الإنفاق هناك برسالة abstract account module is disabled قبل فحص أي nonce. وهي مفعَّلة على شبكة الاختبار. راجع المُخوِّلون والإنفاق المفوَّض. تنطبق الإرشادات أدناه أينما كانت الوحدة مفعَّلة.)

الـ nonce غير صحيح. كل من MsgExecuteEVM.nonce وMsgExecuteCosmos.nonce هو تسلسل المُخوِّل (authenticator sequence) للمفتاح المرتبط عن الزوج (account, pubkey): عدّاد تحتفظ به السلسلة لكل مفتاح مرتبط، يبدأ من 0 ويزداد مع كل تنفيذ ناجح. وهو ليس nonce EVM الخاص بالحساب. اقرأه بالدالة fetchAuthNonce (SDK 0.10.0 أو أحدث، والسلسلة v3.2.4 أو أحدث)، أو تتبّعه لكل مفتاح مرتبط في الإصدارات الأقدم. ومنذ v3.2.3 يوقّع مسار EVM أيضًا evmAuthSignBytesV2، الذي يربط حد غاز الاستدعاء (تختار resolveEvmAuthDigestVersion الصيغة). استخدم العدّاد الذي قرأته (أو تتبعته) لذلك المفتاح ووقّع من جديد.

أخطاء المُخوِّل الأخرى تُفكَّك عبر decodeTxError: رموز abstractaccount رقم 5 (spending_limit_exceeded)، ورقم 6 (session_key_expired)، ورقم 10 (permission_denied). راجع المُخوِّلون والإنفاق المفوَّض.