إعداد المحفظة
تدعم QoreChain أنواعًا متعددة من المحافظ عبر بيئات التنفيذ الأصلية وEVM وSVM. اختر المحفظة التي تناسب حالة الاستخدام الخاصة بك.
القيم أدناه تغطي كلًّا من الشبكة الرئيسية qorechain-vladi (معرّف سلسلة EVM 9801، تعمل منذ 7 يونيو 2026، الإصدار v3.2.7 منذ 12 نوفمبر 2026) وشبكة الاختبار qorechain-diana (معرّف سلسلة EVM 9800، الإصدار v3.2.8 منذ 12 نوفمبر 2026). نقاط النهاية العامة لكلتا الشبكتين مدرجة في الشبكات.
QoreX (موصى بها)
QoreX هي محفظة QoreChain الرسمية غير الحاضنة — تطبيق للهاتف المحمول (Android وiOS) وإضافة للمتصفح (Chrome وFirefox وSafari على macOS). توقّع كل تحويل على المسار الأصلي (Native) بالتوقيع الهجين الإلزامي المقاوم للحوسبة الكمومية، وتسجّل مفتاحك المقاوم للحوسبة الكمومية نيابةً عنك، وتدعم التخزين (staking) وأسماء @handles والشبكات الخارجية، وتقترن بلوحة التحكم (Dashboard). كما تفتح نافذة تفويض EVM التي تحتاجها معاملات MetaMask. ابدأ بـدليل QoreX والبدء.
محفظة Keplr
يمكن لـ Keplr إضافة QoreChain كسلسلة مخصصة (أدناه) لعرض الأرصدة والاستقبال على المسار الأصلي (Native). ولأن QoreChain تشترط توقيعًا مشتركًا مقاومًا للحوسبة الكمومية على المسار الأصلي، فأرسل وخزّن (stake) وصوّت باستخدام محفظة تدعم PQC مثل QoreX بدلًا من الاكتفاء بـ Keplr وحدها.
إضافة QoreChain كسلسلة مخصصة
افتح Keplr وانتقل إلى Settings > Add Custom Chain، ثم أدخل:
| الحقل | الشبكة الرئيسية | شبكة الاختبار |
|---|---|---|
| اسم السلسلة | QoreChain | QoreChain Diana Testnet |
| معرّف السلسلة | qorechain-vladi | qorechain-diana |
| عنوان RPC | https://rpc.qore.host | https://rpc-testnet.qore.host |
| عنوان REST | https://api.qore.host | https://api-testnet.qore.host |
| بادئة Bech32 | qor | qor |
| رمز العملة | QOR | QOR |
| أصغر وحدة للعملة | uqor | uqor |
| الخانات العشرية | 6 | 6 |
| نوع العملة (BIP-44) | 118 | 118 |
بعد إضافة السلسلة، تنشئ Keplr عنوانًا بصيغة qor1... لحسابك.
الحد الأدنى لسعر الغاز في الشبكة هو 0.1uqor. إذا قمت بضبط درجات سعر الغاز في Keplr (مثلًا عبر suggestChain)، فاستخدم قيمًا تساوي أو تتجاوز 0.1 (القيم المقترحة للمنخفض/المتوسط/المرتفع: 0.1 / 0.15 / 0.25) — المعاملات الموقّعة بأقل من هذا الحد تُرفض.
MetaMask (EVM)
تتيح MetaMask التفاعل مع بيئة تنفيذ EVM في QoreChain — نشر عقود Solidity، وإدارة رموز ERC-20، واستخدام أدوات Ethereum المألوفة.
إضافة QoreChain كشبكة مخصصة
افتح MetaMask وانتقل إلى Settings > Networks > Add Network، ثم أدخل:
| الحقل | الشبكة الرئيسية | شبكة الاختبار |
|---|---|---|
| اسم الشبكة | QoreChain | QoreChain Diana Testnet |
| عنوان RPC | https://evm.qore.host | https://evm-testnet.qore.host |
| معرّف السلسلة | 9801 | 9800 |
| رمز العملة | QOR | QOR |
| عنوان مستكشف الكتل | https://explore.qore.network | https://explore.qore.network |
يمتلك QOR الأصلي 18 خانة عشرية على واجهة EVM (بأسلوب wei). بمجرد الاتصال، يمكنك استخدام MetaMask لتوقيع معاملات EVM، والتفاعل مع العقود الذكية المنشورة، وإدارة رموز ERC-20 على QoreChain.
لا تزال MetaMask توقّع بشكل طبيعي، لكن مسار EVM لا يقبل المعاملات إلا من حساب لديه مفتاح مسجّل مقاوم للحوسبة الكمومية ونافذة تفويض EVM مفتوحة (الإصدار v3.2.0 وما بعده). سجّل مفتاحك مرة واحدة، ثم افتح نافذة قبل جلسة من نشاط EVM — راجع نافذة تفويض EVM. لا تستطيع MetaMask فتح النافذة بنفسها؛ افتحها من QoreX أو باستخدام CLI. إضافة الشبكة إلى MetaMask (أعلاه) لم تتغير.
تسجيل الشبكة باستدعاء واحد
بالنسبة للتطبيقات اللامركزية (dApps)، تقوم الحزمة @qorechain/wallet-adapter (المنشورة على npm) بتسجيل QoreChain في محفظة المستخدم باستدعاء واحد — إذ تطلب من MetaMask إضافة الشبكة عبر EIP-3085 (مع QOR الأصلي الصحيح ذي 18 خانة عشرية على مسار EVM) — وتوفّر qoreChainInfo لاقتراح السلسلة في Keplr (بما في ذلك درجة سعر الغاز):
npm install @qorechain/wallet-adapter
import { addQoreEvmToWallet } from "@qorechain/wallet-adapter";
// pass the EIP-1193 provider and the network parameters (rpcUrl is required)
await addQoreEvmToWallet(window.ethereum, {
evmChainId: 9801, // 9800 for the testnet
rpcUrl: "https://evm.qore.host", // https://evm-testnet.qore.host for the testnet
explorerUrl: "https://explore.qore.network",
testnet: false, // true for the testnet
});
حساب واحد، ثلاثة عناوين (الحسابات الموحّدة)
اعتبارًا من إصدار السلسلة v3.1.83، أصبح حساب QoreChain هوية واحدة من 20 بايت بثلاثة ترميزات: qor1… (الأصلي)، و0x… (EVM)، وصيغة base58 (SVM). ويحمل رصيدًا واحدًا و — بالنسبة للحسابات ذات الأصل الإيثيري — يوقّع على المسارات الثلاثة بمفتاح واحد، بما في ذلك التوقيع الهجين المطلوب المقاوم للحوسبة الكمومية على المسار الأصلي.
أنشئ محفظة موحّدة برمجيًا باستخدام @qorechain/wallet-adapter:
import { generateQoreWallet } from "@qorechain/wallet-adapter";
const w = await generateQoreWallet(); // or walletFromMnemonic(mnemonic)
console.log(w.cosmos); // qor1...
console.log(w.evm); // 0x... (same identity)
console.log(w.svm); // base58 (same identity)
// Native-lane sends use signHybridEth (classical eth_secp256k1 + ML-DSA-87 hybrid); pass `rest` so the sign-bytes form is resolved.
الأموال المرسلة إلى أي من الصيغ الثلاث تصل إلى الرصيد نفسه.
المحافظ المرتبطة: Phantom وMetaMask كمفاتيح إنفاق
ميزات الحساب الذكي والمحافظ المرتبطة منفَّذة لكنها معطّلة على الشبكة الرئيسية (abstractaccount.enabled = false): يُرفض هناك تسجيل موثِّق (authenticator) كما يُرفض التنفيذ عبره ما دام هذا الخيار معطّلًا. وهي مفعَّلة على شبكة الاختبار (enabled = true، جرى التحقق في 27 أكتوبر 2026)، فيمكنك تجربة مسار الربط هناك. تحقّق من GET /qorechain/abstractaccount/v1/config على الشبكة التي تستهدفها قبل تقديم مسار للربط. يصف القسم التالي السلوك المصمَّم.
المسار المتوافق مع Solana مغلق على شبكة الاختبار إلى أن يعيد فتحه تصويت حوكمة (الإصدار v3.2.8، على شبكة الاختبار منذ 12 نوفمبر 2026). ولا تتوفر هناك معاملات بنمط Solana إلى حين ذلك.
صُمّم هذا بحيث لا تضطر إلى كشف مفتاحك الجذري للإنفاق من حساب QoreChain داخل تطبيق لامركزي (أُدخل في إصدار السلسلة v3.1.85): يمكن تسجيل مفتاح Phantom (ed25519) أو MetaMask (بواسطة عنوانه على Ethereum، عبر personal_sign) كموثِّق (authenticator) على حسابك — مع صلاحيات محددة النطاق، وحدود إنفاق، وتاريخ انتهاء، وإمكانية إلغاء فوري — ثم يمكنه تفويض تحويلات يمررها الخادم الخلفي للتطبيق اللامركزي. راجع موثِّقات المحافظ المرتبطة للاطلاع على النموذج الكامل والكود، ودليل الموثِّقات في SDK للحصول على أمثلة شاملة من البداية إلى النهاية.
محافظ Solana (SVM)
مسار تنفيذ SVM معطّل حاليًا على مستوى الشبكة بأكملها بالنسبة لإرسال المعاملات — لا تُرسل معاملات عبر محفظة متوافقة مع Solana إلى QoreChain في الوقت الحالي. قد تظل قراءة الأرصدة/الشرائح (slots) تعمل؛ راجع تطوير SVM لمعرفة الوضع الحالي.
بيئة تنفيذ SVM في QoreChain متوافقة مع أدوات Solana القياسية، ويظهر رصيد QOR الأصلي للحساب مباشرة على واجهة SVM (بوحدة lamports، بـ 9 خانات عشرية؛ 1 uqor = 1,000 lamports). يمكنك توصيل أي محفظة أو مكتبة متوافقة مع Solana.
استخدام @solana/web3.js
import { Connection } from "@solana/web3.js";
// Public read-only endpoint (or http://localhost:8899 on your own node)
const connection = new Connection("https://svm.qore.host");
const slot = await connection.getSlot();
console.log("Current slot:", slot);
نقاط نهاية SVM العامة هي للقراءة فقط؛ ويتطلب إرسال المعاملات تشغيل عقدتك الخاصة. راجع تطوير SVM للتفاصيل.
المحافظ الداعمة لـ PQC (إلزامية على مسار Cosmos)
تشترط QoreChain استخدام التشفير الهجين المقاوم للحوسبة الكمومية (PQC) على مسار معاملات cosmos. على الشبكات الحية (الإصدارات v3.2.x)، الإعداد الافتراضي للشبكة هو hybrid_signature_mode = required مع allow_classical_fallback = false — أي أن كل معاملة على مسار cosmos يجب أن تحمل توقيع ML-DSA-87 (Dilithium-5) إلى جانب توقيع secp256k1 (ECDSA) القياسي. معاملات cosmos الكلاسيكية فقط الصادرة من حساب PQC تُرفض.
إرسال معاملة كلاسيكية عادية على مسار cosmos سيؤدي إلى رفضها. يجب عليك إرفاق توقيع Dilithium-5 كامتداد معاملة من نوع PQCHybridSignature. أدوات CosmJS / Keplr القياسية لا تُنتج هذا الامتداد بنفسها — استخدم أمر CLI qorechaind tx pqc cosign، أو التوقيع الهجين في QoreChain SDK (انظر أدناه)، أو، لبنائه بنفسك برمجيًا، مكتبة qorechain-pqc مفتوحة المصدر (hybridSignBytes). الاستثناءات الوحيدة هي معاملات gentx الخاصة بالتكوين الأولي (genesis)، ومعاملات تسجيل/ترحيل مفاتيح PQC، وإلغاء السجن (unjail) من حساب مشغّل ليس لديه مفتاح مسجّل.
كيف يعمل
ترفق المحافظ توقيع PQC من نوع ML-DSA-87 كامتداد للمعاملة إلى جانب توقيع secp256k1 (ECDSA) القياسي. يُحسب التوقيع الكلاسيكي على بايتات توقيع تستثني الامتداد، فيبقى صالحًا للتحقق الكلاسيكي بينما يوفر توقيع PQC المقاومة الكمومية.
توليد مفتاح Dilithium-5
قم بتوليد مفتاح مقاوم للحوسبة الكمومية للتوقيع الهجين:
qorechaind tx pqc gen-key mypqc
يأخذ الأمر اسم مفتاح ويخزّن المفتاح في ~/.qorechaind/pqc/<name>.dilithium (الصلاحيات 0600، غير مشفّر). ويتطلب الملف التنفيذي qorechaind الخاص بالإصدار الرسمي.
سجّل مفتاحك (مرة واحدة)
يُسجَّل مفتاح PQC بشكل صريح، مرة واحدة لكل حساب، بمعاملة تسجيل مفتاح. يجوز توقيع تلك المعاملة الواحدة (وترحيل المفتاح) توقيعًا كلاسيكيًا ليتمكن حساب جديد تمامًا من الإقلاع؛ وبعدها يجب أن تحمل كل معاملة على مسار Cosmos التوقيع الهجين.
# register the public key printed by gen-key for your account
qorechaind tx pqc register-key <public_key_hex> hybrid --from mykey \
--chain-id qorechain-vladi --gas 600000 --fees 90000uqor
منذ v3.2.3 يمكنك إرفاق إثبات حيازة اختياري بالتسجيل عبر qorechaind tx pqc register-key-v2 dilithium5 <public_key_hex> hybrid --pqc-key mypqc --from mykey ...؛ كما ترفض السلسلة المفاتيح الضعيفة والمنحلّة والمستخدمة سابقًا. احتفظ بنسخة احتياطية من ملف مفتاح PQC بالعناية نفسها التي تحتفظ بها بعبارتك الاسترجاعية (mnemonic). (يمكن إعادة اشتقاق المفتاح من العبارة الاسترجاعية بالأمر qorechaind tx pqc recover-key، واستبداله بالأمر tx pqc rotate-key.) تسجّل QoreX وQoreChain SDK المفتاح نيابةً عنك. راجع المعاملة الأولى للاطلاع على عملية إرسال موقّعة كاملة.
التوقيع الهجين باستخدام SDK
يُنتج QoreChain SDK معاملات متوافقة على مسار Cosmos عبر buildHybridTx، الذي يرفق امتداد Dilithium-5. يجب أن يكون مفتاح الحساب مسجّلًا بالفعل (انظر أعلاه). راجع حسابات SDK والتوقيع بـ PQC.
أوضاع PQC
تظل أوضاع الإنفاذ الثلاثة خاضعة للحوكمة؛ الإعداد الافتراضي الحالي للشبكة هو Required:
| الوضع | الوصف |
|---|---|
| Disabled | التحقق من PQC معطّل. التوقيعات القياسية فقط. |
| Optional | يجوز أن تتضمن المعاملات توقيعات PQC. وإذا وُجدت، يتم التحقق منها. |
| Required (الافتراضي) | يجب أن تتضمن جميع المعاملات على مسار cosmos توقيع PQC صالحًا. |
يُضبط الوضع النشط على مستوى السلسلة ويمكن تحديثه عبر الحوكمة.
مسار MetaMask (EVM) الموضح أعلاه لا يحمل الامتداد الهجين، لكن منذ الإصدار v3.2.0 لا يقبل مسار EVM المعاملات إلا من حساب لديه مفتاح مسجّل مقاوم للحوسبة الكمومية ونافذة تفويض EVM مفتوحة. راجع نافذة تفويض EVM.
محفظة سطر الأوامر (CLI)
يتضمن الملف التنفيذي qorechaind نظام إدارة مفاتيح مدمجًا للاستخدام عبر سطر الأوامر.
إنشاء مفتاح جديد
qorechaind keys add mykey
يولّد هذا الأمر زوج مفاتيح جديدًا ويعرض العبارة الاسترجاعية (mnemonic). احفظ العبارة الاسترجاعية بأمان — فهي الطريقة الوحيدة لاستعادة هذا المفتاح.
عرض عنوانك
qorechaind keys show mykey -a
يعرض هذا الأمر عنوانك بصيغة bech32 (qor1...).
عرض جميع المفاتيح
qorechaind keys list
استيراد مفتاح موجود
qorechaind keys add mykey --recover
سيُطلب منك إدخال عبارتك الاسترجاعية.
الخطوات التالية
- معاملتك الأولى — أرسل رموز QOR باستخدام محفظتك الجديدة
- الاتصال بشبكة الاختبار — انضم إلى شبكة اختبار Diana الحية