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

التثبيت

ثبّت حزمة SDK الخاصة بلغتك. إن النواة المكتوبة بلغة TypeScript‏ (@qorechain/sdk)، ومحوّلا EVM وSVM‏ (@qorechain/evm و@qorechain/svm)، وعدّة React‏ (@qorechain/react)، وعملاء Python وGo وRust وJava جميعها منشورة في سجلّاتها مع تكافؤ كامل مع السلسلة الأصلية (رسائل منمّطة الأنواع، والاستعلامات، ودورة حياة المعاملة، ومعاملات PQC الهجينة، واشتراكات WebSocket). الإصدار الحالي هو 0.14.0، ونُشر في 12 نوفمبر 2026 (جرى التحقق منه مقابل السجلات في 12 نوفمبر 2026):

السجلالحزمةالإصدار
npm@qorechain/sdk و@qorechain/react و@qorechain/evm و@qorechain/svm وcreate-qorechain-dapp0.14.0 (وكذلك create-qorechain-dapp؛ وهو يحمل أيضًا إصلاحات القوالب في 0.13.1)
PyPIqorechain-sdk (الاستيراد qorsdk)0.14.0
crates.ioqorechain-sdk (الاستيراد qorechain)0.14.0
وكيل وحدات Gogithub.com/qorechain/qorechain-sdk/packages/gov0.14.0
Maven Centralio.github.qorechain:qorechain-sdk0.14.0 (JDK 17 أو أحدث)

لا يوجد 0.11.0 لـ Python أو Rust أو Go أو Java: فقد كان لحزم npm إصدار 0.11.0 في 29 أكتوبر 2026 (مجموعة أدوات مطوري السلسلة، انظر أدناه) وانتقلت كل لغة من 0.10.0 إلى 0.12.0 معًا. وتبعه 0.13.0 في 11 نوفمبر 2026 و0.14.0 في 12 نوفمبر 2026 في كل لغة.

اختر لغتك أدناه.

ملاحظات الترقية​

استخدم SDK 0.8.1 أو أحدث على الشبكات الحيّة

تتحقّق الشبكتان العامتان من صيغة sign-bytes الهجينة v2 (الموسومة بالنطاق والمرتبطة بمعرّف السلسلة) وترفضان الصيغة القديمة بالرمز pqc رقم 21. كل إصدار من الـ SDK قبل 0.8.0 يوقّع الصيغة القديمة، أمّا 0.8.0 فتبحث عن التحوّل تحت اسم واحد فقط من اسمَي الترقية اللذين استخدمتهما الشبكتان (سجّلته الشبكة الرئيسية باسم v3.2.0، والشبكة التجريبية باسم v3.1.98 ثم لاحقًا v3.2.0)، ولذلك توقّع الصيغة الخاطئة على الشبكة الرئيسية. استخدم 0.14.0 (أو 0.8.1 على الأقل) في كل لغة؛ ويلزم 0.8.2 أو أحدث لفتح نافذة تفويض EVM. تقبل البُناة الهجينة خيار signBytesVersion ("auto" | "v1" | "v2")؛ و"auto" يسأل الشبكة ولذلك يحتاج إلى نقطة نهاية REST (rest) على qorechain-vladi / qorechain-diana: فهو يرمي خطأً بدلًا من التخمين. انظر أي صيغة لبايتات التوقيع؟. لم تتغير الصيغة في إصدار السلسلة v3.2.3 ولا v3.2.4 (يعمل v3.2.4 على الشبكة التجريبية منذ 19 أكتوبر 2026 وعلى الشبكة الرئيسية منذ 23 أكتوبر 2026؛ ولم يغيّر v3.2.5 ولا v3.2.6 شيئًا هنا؛ وتعمل الشبكة الرئيسية بالإصدار v3.2.7 منذ 12 نوفمبر 2026): فـ "auto" يحلّ إلى v2 على الشبكتين، لأن كلتيهما طبّقت الترقية التي انتقلت إلى هذه الصيغة.

ما الذي يغيّره الإصدار 0.14.0​

الإصدار SDK 0.14.0 (12 نوفمبر 2026) إصدار واحد لكل اللغات: TypeScript وPython وGo وRust وJava، مع @qorechain/react و@qorechain/evm و@qorechain/svm و create-qorechain-dapp (الذي يحمل أيضًا إصلاحات القوالب في 0.13.1). وهو يضيف دعم العميل لسلسلة v3.2.8. تسري القواعد الجديدة على الشبكة متى شغّلت v3.2.8: تعمل شبكة الاختبار qorechain-diana بها منذ 12 نوفمبر 2026؛ ولم تطبّقها الشبكة الرئيسية. وعلى الشبكات الأقدم تبقى الحقول الجديدة اختيارية.

المجالفي 0.14.0
ربط مفتاحيحتاج إلى إثبات حيازة. تحمل البُناة والموقِّعات لـ ed25519 وsecp256k1 وEIP-191 (personal_sign) رسالة ربط نصية صريحة تسمّي السلسلة والحساب والمخطط والمفتاح. وترفض مُركِّبات التسجيل الإثبات الفارغ
المفاتيح التي تنقل قيمةالمفتاح ذو الصلاحية send أو evm أو deploy أو svm أو all يحتاج إلى أن تقيّد أول قاعدة إنفاق مفعّلة في الحساب كل فئة عملة. ومساعد يبني تحديث قاعدة الإنفاق والربط زوجًا في معاملة واحدة يوقّعها المالك، ويفحص القاعدة
معاملات الحوكمةتحتاج مُركِّبات MsgUpdateParams لوحدات crossvm وsvm وrdk إلى كل الحقول (فالسلسلة تستبدل المعاملات دفعة واحدة). ومساعدات جديدة تبني التحديث من المعاملات الحالية المقروءة من الشبكة. ويرفض مُركِّب svm القيمة enabled ما دام السقف الصلب للحفظ 0
استعلام cross-VM المعلّقيعيد الاستعلام المقسَّم إلى صفحات الآن كل الصفحات
نتائج التنفيذيمكن أن تفشل MsgExecuteEVM وMsgExecuteCosmos بـ success=false داخل معاملة بالرمز 0 (ويُستهلك الـ nonce). ومساعدات جديدة تفك ترميز الاستجابات وسبب الفشل، وتُطلق خطأً عند فشل التنفيذ
استدعاءات cross-VM غير المتزامنةتقبل async_gas_limit وasync_max_factor
نطاق نافذة EVMحقول جديدة validators وstaking_validators وibc_receivers
الغازتُرفض معاملات EVM فوق 30,000,000 (المقروءة من evm_limits) ومعاملات Cosmos فوق 50,000,000 قبل التوقيع. وتحصل معاملات CosmWasm وcross-VM على ما لا يقل عن 1.3 ضعف الغاز المحاكى ولا تحصل أبدًا على قيمة احتياطية ثابتة
الحد الأدنى لسعر الغازمساعدات اختيارية تقرأ الحد الأدنى لسعر الغاز في الشبكة؛ وسعر الغاز الافتراضي لم يتغير
Protosالشيفرة المولَّدة في اللغات الخمس تتبع v3.2.8

وجانب المحفظة من التغيير نفسه موجود في @qorechain/wallet-adapter 0.6.0.

ما الذي يغيّره الإصدار 0.13.0​

الإصدار SDK 0.13.0 (11 نوفمبر 2026) إصدار واحد لكل اللغات: TypeScript وPython وGo وRust وJava، مع @qorechain/react و@qorechain/evm و@qorechain/svm و create-qorechain-dapp. وفيه تغيير كاسر واحد في مساعد الحساب على مسار البذرة. الحسابات المشتقة من عبارة ذاكرية دون تغيير، وكذلك صيغة التوقيع الهجين وسلوك السلسلة: تبقى المعاملة المبنية بـ 0.12.0 صالحة.

تغيير كاسر. مساعدات مسار البذرة unifiedAccountFromSeed (TypeScript)، و unified_account_from_seed (Python وRust)، وunified.UnifiedAccountFromSeed (Go)، و UnifiedAccounts.unifiedAccountFromSeed (Java) تحتاج الآن إلى واحد بالضبط من مدخلين: رمز استرداد QRC1، أو سر PQC مستقل من 32 بايتًا. ويُشتق مفتاح ML-DSA-87 من هذا السر الثاني. وإذا استُدعي المساعد دون خيار، أو مع أكثر من واحد، أطلق خطأ.

الخيار legacySeedDerivation (في Python legacy_seed_derivation=True، وفي Go LegacySeedDerivation، وفي Rust SeedPqcOptions::legacy_seed_derivation()، وفي Java SeedPqcOptions.legacy()) اختياري صريح. استخدمه فقط لاسترداد مفتاح PQC لحساب أُنشئ قبل 0.13.0 كي تدوّره بـ MsgRotatePQCKey؛ وهو ليس للحسابات الجديدة.

المجالفي 0.13.0
مساعدات مسار البذرةتحتاج رمز استرداد QRC1 أو سر PQC مستقلًا من 32 بايتًا (واحدًا بالضبط)؛ ودون خيار، أو مع أكثر من واحد، يُطلق خطأ. الحسابات المشتقة من عبارة ذاكرية دون تغيير
legacySeedDerivationاختياري صريح، فقط لاسترداد مفتاح PQC لحساب أُنشئ قبل 0.13.0 كي يمكن تدويره بـ MsgRotatePQCKey
رموز الاسترداد QRC1أُضيفت في كل لغة: generatePqcRecoveryCode وisValidRecoveryCode وnormalizeRecoveryCode وpqcKeyFromRecoveryCode وpqcRecoveryCodeFromSecret (بصيغة snake_case في Python وRust؛ وفي Go GeneratePQCRecoveryCode وIsValidRecoveryCode وPQCKeyFromRecoveryCode وPQCRecoveryCodeFromSecret)
migrateToHybridتُبلغ عن keyVerified
القوالبيطبع pnpm window recovery-code رمزًا جديدًا. ومع PRIVATE_KEY يقرأ pnpm window المتغير QORE_PQC_RECOVERY_CODE ويتوقف برسالة إن كان مفقودًا؛ ومع QORE_MNEMONIC لا يتغير شيء. تعتمد قوالب Foundry وHardhat على ^0.13.0
إصدار بايتات التوقيع "auto"يقرأ أولًا ميزة البروتوكول pqc-sign-bytes-v2 من /qorechain/pqc/v1/protocol_features، ولا يعود إلى خطط الترقية المطبّقة إلا إذا فشلت هذه القراءة
getPqcStatus / get_pqc_statusتُطلق خطأ عندما تخلو إجابة العقدة من علم التسجيل، بدل الإبلاغ بـ "غير مسجّل"
Pythonيحلّل رموز نتيجة المعاملة وحقلي found وlive في نافذة EVM بصرامة؛ وتعدّ wait_for_tx الإجابة الخالية من tx_response أو txhash معلّقة بعد

خيارات مسار البذرة في كل لغة. مرّر واحدًا بالضبط من الثلاثة:

اللغةالاستدعاءرمز الاستردادسر مستقل من 32 بايتًاالمفتاح الأقدم، للاسترداد فقط
TypeScriptunifiedAccountFromSeed(seed32, opts){ recoveryCode } (سلسلة "QRC1-..."){ pqcSecret } (مصفوفة Uint8Array من 32 بايتًا، مستقلة عن seed32){ legacySeedDerivation: true }
Pythonunified_account_from_seed(seed32, ...)recovery_code=...pqc_secret=...legacy_seed_derivation=True
Gounified.UnifiedAccountFromSeed(seed32, opts)unified.SeedPQCOptions{RecoveryCode: ...}unified.SeedPQCOptions{PQCSecret: ...}unified.SeedPQCOptions{LegacySeedDerivation: true}
Rustunified_account_from_seed(seed32, opts)SeedPqcOptions::recovery_code(code)SeedPqcOptions::pqc_secret(secret32)SeedPqcOptions::legacy_seed_derivation()
JavaUnifiedAccounts.unifiedAccountFromSeed(seed32, opts)SeedPqcOptions.withRecoveryCode(code)SeedPqcOptions.withPqcSecret(secret32)SeedPqcOptions.legacy()

خيارات Python تُمرَّر بالاسم فقط. يعطي pqcSecret المفتاح نفسه الذي يعطيه رمز الاسترداد المصنوع منه بـ pqcRecoveryCodeFromSecret(secret32). ويتوفر في TypeScript أيضًا pqcKeyFromRecoveryCode(code, qor1).

الترحيل (TypeScript). أنشئ رمز استرداد مرة واحدة واحفظه بعيدًا عن البذرة:

import { generatePqcRecoveryCode, unifiedAccountFromSeed } from "@qorechain/sdk";

const recoveryCode = generatePqcRecoveryCode(); // once; store it apart from the seed
const account = unifiedAccountFromSeed(seed32, { recoveryCode });

الحساب الذي سجّل مفتاح PQC الخاص به مع 0.12 أو أقدم يحمّل المفتاح القديم بـ { legacySeedDerivation: true } ويدوّره بـ rotatePqcKeyMsg:

const old = unifiedAccountFromSeed(seed32, { legacySeedDerivation: true });
// rotate it with rotatePqcKeyMsg, then use { recoveryCode } from then on

احتفظ برمز الاسترداد: رمز مختلف يعطي مفتاحًا مختلفًا.

ما الذي يضيفه الإصدار 0.12.0​

الإصدار SDK 0.12.0 هو إصدار العميل للسلسلة v3.2.5، التي طبّقتها الشبكة الرئيسية عند الارتفاع 3,906,833 في 29 أكتوبر 2026 (وطبّقتها الشبكة التجريبية في 26 أكتوبر). وتعمل الشبكة الرئيسية بالإصدار v3.2.6 منذ 4 نوفمبر وبالإصدار v3.2.7 منذ 12 نوفمبر؛ وعملت الشبكة التجريبية بالإصدار v3.2.6 منذ 27 أكتوبر، وبالإصدار v3.2.7 من 6 إلى 12 نوفمبر، وبالإصدار v3.2.8 منذ 12 نوفمبر؛ ولم تتغير صيغة التوقيع الهجين ولا العناوين ولا المنازل العشرية ولا الـ memo، فتبقى المعاملة المبنية بالإصدار 0.10.0 صالحة. وتنتقل TypeScript وPython وGo وRust وJava كلها إلى 0.12.0، مع @qorechain/react و@qorechain/evm و@qorechain/svm وcreate-qorechain-dapp. جرى التحقق من الإصدار في كل لغة بإرسال bank هجين على الشبكة التجريبية وبتسجيل مفتاح KEM وقراءته وإزالته هناك، إضافة إلى قراءات على الشبكة الرئيسية.

المجالفي 0.12.0
نقاط النهاية العامة افتراضيًاتشير الإعدادات المسبقة mainnet وtestnet الآن إلى نقاط النهاية العامة (REST وRPC الإجماع وEVM JSON-RPC على الشبكتين، إضافة إلى EVM WebSocket على الشبكة التجريبية) بدلًا من localhost. لذا فإن createClient() المجرّد يتصل بالشبكة التجريبية العامة. انظر الشبكة ونقاط النهاية
الإعداد المسبق localnetمنافذ localhost التي كانت كل الإعدادات المسبقة تستخدمها قبل 0.12.0، ومعرّف السلسلة qorechain-devnet. اختره بـ createClient({ network: "localnet" }) للإبقاء على السلوك القديم
غاز دقيق للمعاملات الهجينةعلى شبكة طبّقت v3.2.5 تكون الرسوم "auto" لمعاملة native هجينة هي ceil(simulated x 1.02) + 2000، لأن المحاكاة صارت تحتسب التحقق ما بعد الكمّي بنفسها. يطلب إرسال bank هجين نحو 171,600 غاز بدلًا من نحو 289,000، وتنخفض الرسوم معه. تحتفظ الشبكات الأقدم والمعاملات الكلاسيكية وحالة فشل جلب الخطة بالقاعدة السابقة؛ والمضاعف الذي تمرّره يحلّ محل أي من القاعدتين. exactHybridGas (ومكافئاتها في كل لغة) وestimateGasDetails في TypeScript (تبلّغ عن المحاكاة وحدّ الغاز والقاعدة التي حدّدته). وأضيف مسار الغاز التلقائي إلى Java
سجل مفاتيح ML-KEM-1024ينشر الحساب مفتاح تغليف ML-KEM-1024 واحدًا (الخوارزمية 2، ‏1,568 بايت) ليشفّر إليه أي شخص: msg.pqc.registerKemKey وmsg.pqc.removeKemKey (يُفحص المفتاح أولًا: الحجم، وكل معامل أصغر من 3329، وألا يكون كله أصفارًا)، وvalidateKemPublicKey، والقراءة fetchKemKey للمسار /qorechain/pqc/v1/kem/{address} (بصيغة bech32 أو 0x). تحتاج الرسالتان إلى التوقيع الهجين. يستجيب المسار على الشبكة الرئيسية وعلى الشبكة التجريبية. لا تشفّر الـ SDK: للحمولات المختومة انظر QoreSeal
الحسابات المجرّدةقراءات قواعد الإنفاق المخزَّنة لحساب ومفاتيحه المرتبطة (بما فيها الملغاة)، وMsgUpdateConfig (رسالة الحوكمة التي تبدّل الوحدة)، وauthenticators_count في عرض الحساب
فحوص قواعد الإنفاقتُفحص القواعد كما تفحصها السلسلة: يجب أن يحدد denom من النوع erc20/ أو erc721/ أو erc1155/ عنوان عقد بصيغة 0x. وتُسمّى الرموز 8 (قاعدة إنفاق غير صالحة) و9 (الوحدة معطّلة) في abstractaccount
معاملات الحوكمةالرسالة MsgUpdateParams الخاصة بـ cross-VM (بما فيها عقود CosmWasm التي يجوز لـ precompile جسر EVM استدعاؤها) وMsgUpdateParams الخاصة بالـ rollup، وتُفحص كل منهما مقابل حدود السلسلة قبل التوقيع. وتحمل قراءة معاملات cross-VM الحقل bridge_allowed_targets
ثابت الترقية والـ protosCHAIN_UPGRADE_V3_2_5؛ وتعريفات protobuf متزامنة مع السلسلة v3.2.5
مجموعة أدوات مطوري السلسلةمن 0.11.0 (npm فقط) وهي مشمولة في 0.12.0: تصدّر @qorechain/evm سلسلتي viem ‏qorechain (‏9801) وqorechainTestnet (‏9800) ومساعدات نافذة تفويض EVM (evmWindowStatus وopenEvmWindowMessage، وهي متاحة أيضًا باسم @qorechain/evm/window بدون viem). وفي create-qorechain-dapp قوالب foundry وhardhat وviem-wagmi وcosmwasm. وفي @qorechain/react المكوّن PqcStatusBadge (وتبقى أسماء QuantumSafeBadge القديمة أسماء بديلة مهجورة)
إصلاحاتكانت @qorechain/svm المعطاة نقاط نهاية بلا svmRpc تستخدم localhost؛ وهي الآن تذكر أن نقطة النهاية غير مضبوطة. ويوجّه توليد شيفرة Python الاستيرادات بين protos الخاصة بـ QoreChain إلى داخل الحزمة

تغيير في السلوك يجب فحصه عند الترقية. إذا كانت شيفرتك تعتمد على القيمة الافتراضية localhost، فاختر localnet أو مرّر endpoints. نقاط نهاية الشبكة التجريبية العامة محدودة المعدل لكل IP، لذا ينبغي أن تشغّل حركة الإنتاج عقدتها الخاصة أو تستخدمها. لا يضبط أي إعداد مسبق نقطة gRPC ولا نقطة SVM على الشبكات العامة (معاملات SVM غير مفتوحة)، وليس للشبكة الرئيسية EVM WebSocket عام: والشيفرة التي تحتاج إلى إحداها تفشل بخطأ يسمّي نقطة النهاية المطلوب تمريرها، بدلًا من الرجوع إلى localhost. وفي Rust صارت نقاط النهاية الاختيارية Option<String>؛ وفي Python وGo وJava تكون نقطة النهاية غير المضبوطة None وسلسلة فارغة وnull على التوالي.

لا تُبلغ العقد عن إصدار ملفها التنفيذي. لاكتشاف ميزة، اسأل isUpgradeApplied عن كل اسم ترقية يجلبها، أو اقرأ .version من https://download.qore.host/<net>/latest.json.

ما الذي أضافه الإصدار 0.10.0​

الإصدار SDK 0.10.0 هو إصدار العميل للسلسلة v3.2.4، التي طبّقتها الشبكة الرئيسية عند الارتفاع 3,742,566 في 23 أكتوبر 2026 (وطبّقتها الشبكة التجريبية عند الارتفاع 8,337,253 في 19 أكتوبر). لم تتغير صيغة التوقيع ولا العناوين ولا المنازل العشرية ولا الـ memo ولا الرسوم، وتبقى المعاملة المبنية بالإصدار 0.9.0 صالحة. جرى التحقق من الإصدار في كل لغة بمعاملات حقيقية على الشبكة التجريبية. ولم يكن فيه بُناة لأي شيء استُحدث بعد v3.2.4؛ وجاءت إضافات v3.2.5 مع 0.12.0. وتعمل الشبكة الرئيسية بالإصدار v3.2.7 منذ 12 نوفمبر 2026 (الارتفاع 4,164,600، مقترح الحوكمة 16؛ وقبله v3.2.6 منذ 4 نوفمبر عند الارتفاع 4,020,000؛ وقبله v3.2.5 منذ 29 أكتوبر عند الارتفاع 3,906,833) ويستمر 0.10.0 في العمل عليها لأن صيغة التوقيع لم تتغير. وقد طبّقت الشبكة التجريبية v3.2.5 وv3.2.6 في 26 و27 أكتوبر 2026، وv3.2.7 في 6 نوفمبر وv3.2.8 في 12 نوفمبر (ليس في أي إصدار من SDK أدوات بناء لرسائل v3.2.7، وهي على الشبكة الرئيسية منذ 12 نوفمبر 2026). ما جاء به 0.10.0 (وكله ما زال في 0.14.0):

المجالفي 0.10.0
طبقات الرهن (x/stakingtier)الملحّنات lockDelegation (بفحوص السلسلة نفسها: مدة 3 أو 6 أو 12 شهرًا ومبلغ موجب صحيح) وunlockEarly وclaimBonus وupdateParams؛ وقراءات لمعاملات الوحدة وأقفال الحامل وصندوق المكافأة (fetchStakingTierParams وfetchStakingLocks وfetchStakingTierPool)؛ ورموز أخطاء الوحدة. وما تفعله الوحدة موصوف في التفويض والحصص
nonce الموثِّقتقرأ fetchAuthNonce({ rest, address, pubkey }) التسلسل الذي يجب أن يوقّعه مفتاح مرتبط لاحقًا في MsgExecuteEVM / MsgExecuteCosmos من /qorechain/abstractaccount/v1/auth_nonce/{address}/{pubkey_hex}، بدلًا من تتبّعه يدويًا. تقدّم الشبكتان المسار؛ أما وحدة abstractaccount نفسها فمطفأة على الشبكة الرئيسية (ومفعَّلة على شبكة الاختبار)، لذا يُرفض الإنفاق على الشبكة الرئيسية قبل فحص أي nonce
مفاتيح تبديل ميزات البروتوكولتقرأ fetchProtocolFeatures وisProtocolFeatureEnabled أي قواعد إجماع تفرضها الشبكة، بالاسم، من /qorechain/pqc/v1/protocol_features (تقدّمه الشبكتان). والشبكة الأقدم من v3.2.4 لا تقدّم المسار؛ استخدم isUpgradeApplied هناك
possessionProvenتبيّن حالة PQC ما إذا سُجّل مفتاح الحساب بإثبات حيازة
ibcTimeoutTimestamp(seconds)مهلة IBC مطلقة بالوحدة التي تأخذها MsgTransfer (نانوثانية Unix). مهل IBC أوقات مطلقة؛ وحزم IBC v2 تأخذ ثواني Unix مطلقة، وتُرفض القيمة النسبية هناك بعد اقتطاع الرسوم. لا توجد قناة IBC مفتوحة على الشبكة الرئيسية (جرى التحقق في 27 أكتوبر 2026)
ثابت الترقية والـ protos‏CHAIN_UPGRADE_V3_2_4؛ وتعريفات protobuf متزامنة مع السلسلة v3.2.4 (حقول جديدة في تسجيل مُصدِّق الجسر والعقدة الخفيفة واستعلامات الـ rollup)
ensurePqcRegisteredكانت تعدّ حالةً بلا مفتاح عام مطابقةً؛ وهي الآن تقرأ المفتاح عبر rest وتقارنه. وإذا لم يتوفر مصدر لقراءته، تُبلغ النتيجة keyVerified: false بدلًا من الادعاء بأن المفتاح للمستدعي
الرفض أثناء محاكاة الرسومالرفض الذي تعيده السلسلة نصًا فقط (مثل "no bonus to claim") يُسمّى الآن من أوصاف الأخطاء المسجَّلة في السلسلة في كل لغة: decodeTxError (TypeScript) وSimulationRefusedError (Python) وtx.DecodeRefusalText (Go) وtx::decode_refusal_text (Rust) وTxError.decode (Java)

انتقل @qorechain/react وcreate-qorechain-dapp إلى 0.10.0 معه؛ وكلاهما على 0.14.0 الآن.

ما الذي أضافه الإصدار 0.9.0​

كان الإصدار SDK 0.9.0 إصدار العميل للسلسلة v3.2.2 وv3.2.3 (طبّقتهما الشبكة الرئيسية عند الارتفاعين 3,556,788 و3,662,051؛ وعملت الشبكة الرئيسية بالإصدار v3.2.4 من 23 أكتوبر 2026 (الارتفاع 3,742,566) وبالإصدار v3.2.5 من 29 أكتوبر وعملت بالإصدار v3.2.6 منذ 4 نوفمبر وتعمل بالإصدار v3.2.7 منذ 12 نوفمبر 2026، وتعمل الشبكة التجريبية بالإصدار v3.2.4 أو أحدث منذ 19 أكتوبر 2026). لم تتغير صيغة التوقيع ولا العناوين ولا المنازل العشرية ولا الـ memo ولا الرسوم، لذا فصيغة sign-bytes الهجينة v2 التي يوقّعها 0.8.1 وما بعده لا تزال الصيغة الصحيحة. الجديد:

المجالفي 0.9.0 (وما بعده)
TxClient الهجين (TypeScript)مرّر زوج مفاتيح الحساب: client.connectTx(signer, { pqcKeypair }) أو TxClient.connect({ …, pqcKeypair, rest }). عندئذٍ تُوقَّع كل معاملة توقيعًا هجينًا ويحاكي fee: "auto" المعاملة الهجينة نفسها؛ أما تسجيل المفتاح المجرّد فيبقى كلاسيكيًا (مسار التهيئة الأولية في السلسلة). تستخدمه bankSend وعملاء SDK الخاصون بـ rollup وmultilayer وcross-VM. وبدون زوج مفاتيح لا يتغير شيء
مفتاح PQC قابل للاستردادderivePqcCanonical(address, mnemonic) ومكافئاتها في كل لغة (انظر التوقيع الهجين)
ensurePqcRegisteredتقرأ حالة المفتاح عبر REST أولًا (rest)، وترفض التسجيل عندما لا تستطيع التحديد، وترمي PqcKeyMismatchError عندما يحمل الحساب مفتاحًا مختلفًا بالفعل، وتعدّ رفض السلسلة بعبارة «مسجَّل بالفعل» نجاحًا. ابتداءً من السلسلة v3.2.3 توقّع إثبات الحيازة وترفقه بنفسها؛ وقبل v3.2.3 تترك الحقل فارغًا
نوافذ EVM المحدّدة النطاقيقبل openEvmWindowMsg الوسيطين nativeOnly وallowedTargets (16 كحد أقصى، دون تكرار)؛ وتقرأ fetchEvmWindow كليهما (انظر دليل EVM)
موافقة EIP-7702authorizeEvmDelegationMsg وclearEvmDelegationMsg وfetchEvmDelegationConsent وevmDelegationTupleNonce وclassifyEvmDelegationRejection
سلامة المفاتيحترفض بُناة التسجيل classical_only والمفتاح الفارغ ومفتاح ML-DSA-87 المنحلّ، وهي أمور ترفضها السلسلة ابتداءً من v3.2.3. تُصدَّر signProofOfPossession / verifyProofOfPossession؛ وترسل migratePqcKeyHybrid الرسالة MsgMigratePQCKey الموقَّعة توقيعًا هجينًا التي تحتاجها الحسابات ذات المفاتيح ابتداءً من v3.2.3
ملخّص الحساب المجرَّد v2evmAuthSignBytesV2 (يربط حدّ غاز الاستدعاء) وresolveEvmAuthDigestVersion. وحدة abstractaccount معطَّلة على الشبكة الرئيسية (ومفعَّلة على شبكة الاختبار)، لذا هذا للرجوع فقط على الشبكة الرئيسية
اكتشاف الترقيةisUpgradeApplied وrequireUpgradeApplied: لا تُضبط الحقول الاختيارية الجديدة إلا بعد أن يُبلغ applied_plan عن الإصدار، لأن العقدة التي لم تطبّق إصدارًا ترفض المعاملة بأكملها عند ضبط أحد الحقول الجديدة لذلك الإصدار
فكّ ترميز الأخطاءيحتفظ الفشل داخل كتلة بالـ codespace الخاص به (مثل pqc 231 لا sdk_231)؛ وتُفكَّك rate_limited ورموز التفويض؛ وتقرأ decodeTxError سجلَّ الخطأ المُطلَق أو رسالته
قواعد الإنفاقتعمل validateSpendingRules داخل بُناة MsgUpdateSpendingRules وترفض قاعدة لا تقيّد شيئًا
إصلاحاتمسار حساب PQC هو المفرد /qorechain/pqc/v1/account/{address} في كل SDK (وفي client.rest.getPqcAccount وisPqcRegistered وgetPqcStatus عند تمرير العميل المركَّب)؛ ويطابق VERSION المُصدَّر الحزمة؛ ويتوقف عميلا Go وRust اللذان ينشئهما الـ SDK عند انتهاء المهلة بدل التعليق؛ وتعتمد قوالب create-qorechain-dapp على الإصدار الذي تُشحن معه

الاشتقاق القديم لـ PQC للمفاتيح الجديدة (derivePqcLegacy، "bridge") مهجور: فهو غير مرتبط بالحساب، لذا ستعطي عبارة استذكارية واحدة مفتاحًا واحدًا لكل حساب. ترفضه أدوات التدوير المساعدة بوصفه المفتاح الجديد؛ أما الاسترداد من مفتاح قديم قائم أو التدوير بعيدًا عنه فما زال يعمل.

الإصدارات السابقة للإصدار 0.9.0​

إذا كنت على 0.8.x فهو لا يزال يوقّع الصيغة التي تتحقق منها الشبكتان ويعمل على الشبكة الرئيسية والشبكة التجريبية. هذه هي الحدود التي أزالها 0.9.0، وبعضها يكلّف رسومًا إن لم تعرفها:

الإصدار السابق للإصدار 0.9.0الحل البديل
لا توجد بُناة لإثبات الحيازة ولا للنوافذ المحدّدة النطاق ولا لموافقة EIP-7702استخدم qorechaind tx pqc register-key-v2 … --pqc-key <name>، وopen-evm-window --native-only / --allowed-targets، وauthorize-evm-delegation / clear-evm-delegation (انظر نافذة تفويض EVM، تفويضات EIP-7702)
كانت ensurePqcRegistered دون status تبثّ التسجيل دون تحقق، وتُبلغ عن النجاح عندما يكون مفتاح مختلف مسجَّلًايُرفض التسجيل الثاني لحساب يحمل مفتاحًا بالفعل بعد اقتطاع الرسوم. اقرأ GET /qorechain/pqc/v1/account/{address} أولًا ومرّر status: { registered: found }
client.rest.getPqcAccount وisPqcRegistered وgetPqcStatusكانت تستدعي مسارًا بصيغة الجمع /accounts/ أو مساحة الأسماء qor_، وهما لا تخدمهما نقاط النهاية العامة (HTTP 501، -32601). اقرأ مسار REST بصيغة المفرد أعلاه
كانت TxClient / bankSend وعملاء rollup وmultilayer وcross-VM توقّع توقيعًا كلاسيكيًا فقطترفض الشبكتان ذلك لأي حساب له مفتاح. أرسل عبر signAndBroadcastHybrid
فقدت المعاملات الفاشلة داخل الكتلة الـ codespace الخاص بهااقرأ المعاملة من GET /cosmos/tx/v1beta1/txs/{hash}
كان الثابت المُصدَّر VERSION في 0.8.3 يُبلغ عن 0.8.0اقرأ الإصدار المثبَّت من package.json
ثبّت create-qorechain-dapp 0.8.0 الحزمتين @qorechain/sdk / @qorechain/evm على ^0.3.0 (علامة الإقحام caret على إصدار 0.x تبقى داخل 0.3)شغّل npm i @qorechain/sdk@latest بعد التهيئة
كان @qorechain/react 0.8.x يترك حالة المفتاح المسجَّل غير قابلة للقراءة على نقاط النهاية العامةاستخدم @qorechain/react 0.9.0 أو أحدث
إصلاحات أقدم

أصلح إصدار SDK 0.6.1 خللًا حرجًا على مستوى الإجماع: كان امتداد جسم المعاملة /qorechain.pqc.v1.PQCHybridSignature يُسلسل بصيغة JSON داخل Any.value وترفضه السلسلة عند CheckTx. المعاملات الهجينة (PQC + كلاسيكية) المبنية بإصدار SDK ‏≤ 0.6.0 تُرفض على السلسلة. وقد أزال الإصدار 0.8.0 مساعِدات الحساب القائمة على توقيعات المحافظ (انظر الحسابات وتوقيع PQC).

TypeScript​

الحزمة الأساسية:

npm i @qorechain/sdk

تستهدف Node.js 20 فما فوق وتأتي مزوّدة بـ ESM وCommonJS وتعريفات الأنواع. وتستورد أمثلة المعاملات الهجينة في هذه الوثائق أيضًا StargateClient من @cosmjs/stargate (npm i @cosmjs/stargate).

محوّل EVM​

@qorechain/evm هو محوّل خفيف وآمن الأنواع فوق viem. تُعد viem اعتمادية نظيرة (peer dependency) — ثبّتها معه:

npm i @qorechain/evm viem

منشور على npm بالإصدار 0.14.0. يصدّر سلسلتي viem ‏qorechain (معرّف السلسلة 9801) وqorechainTestnet (‏9800) ومساعدات نافذة تفويض EVM.

محوّل SVM​

@qorechain/svm هو محوّل خفيف فوق @solana/web3.js، وهي اعتمادية نظيرة:

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

منشور على npm بالإصدار 0.14.0.

عدّة React​

@qorechain/react هي طبقة React الرسمية فوق @qorechain/sdk — مزوّد (provider)، وخطافات (hooks)، ومكوّنا ConnectButton / PqcStatusBadge. تُعد react (‏>=18) اعتمادية نظيرة:

npm i @qorechain/react

منشورة على npm بالإصدار 0.14.0؛ وتعتمد على @qorechain/sdk ‏^0.14.0. انظر دليل عدّة React.

أداة التهيئة (Scaffolder)​

تقوم create-qorechain-dapp (على npm، الإصدار 0.14.0) بتهيئة تطبيق dApp جاهز للتشغيل:

npm create qorechain-dapp@latest my-dapp

تعتمد ملفات package.json المُولَّدة على إصدار SDK الذي تُشحن معه أداة التهيئة (@qorechain/sdk ‏^0.14.0؛ وتستخدم قوالب EVM الحزمة @qorechain/evm ‏^0.14.0). غيّر الإصدار 0.13.1 القوالب فقط ويحمل 0.14.0 تلك الإصلاحات؛ راجع أدوات التوليد وCLI. وفيها أيضًا قوالب foundry وhardhat وviem-wagmi وcosmwasm لأعمال العقود. كتب الإصدار 0.8.0 من أداة التهيئة نطاقات ^0.3.0، وهي على إصدار 0.x تبقى داخل 0.3 ولا تستطيع التوقيع للشبكات الحيّة؛ فإذا هيّأت بالإصدار 0.8.0 فشغّل npm i @qorechain/sdk@latest. انظر مرجع CLI.

Python​

pip install qorechain-sdk

تتطلب Python 3.10 فما فوق. تأتي الحزمة مزوّدة بتلميحات الأنواع وعلامة py.typed.

تُثبَّت التوزيعة باسم qorechain-sdk (منشورة على PyPI بالإصدار 0.14.0) لكنها تُستورد باسم qorsdk:

import qorsdk

Go​

go get github.com/qorechain/qorechain-sdk/packages/go/...

تتطلب Go 1.23 فما فوق. استورد الحزم الفرعية التي تحتاجها، على سبيل المثال:

import (
"github.com/qorechain/qorechain-sdk/packages/go/qorechain/client"
"github.com/qorechain/qorechain-sdk/packages/go/qorechain/accounts"
)

منشورة كوحدة Go مستقلة بذاتها (الوسم packages/go/v0.14.0). ثبّت الإصدار صراحةً: go get github.com/qorechain/qorechain-sdk/packages/go@v0.14.0.

Rust​

cargo add qorechain-sdk

أو، لتتبّع رأس المستودع (repository head):

[dependencies]
qorechain-sdk = { git = "https://github.com/qorechain/qorechain-sdk" }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

تتطلب Rust 1.74 فما فوق. عملاء القراءة غير متزامنين (Tokio). تُستورد الحزمة (crate) باسم qorechain‏ (use qorechain;).

منشورة على crates.io باسم qorechain-sdk (0.14.0)؛ يقوم الأمر cargo add qorechain-sdk بتثبيت أحدث إصدار.

Java​

Maven‏ (pom.xml):

<dependency>
<groupId>io.github.qorechain</groupId>
<artifactId>qorechain-sdk</artifactId>
<version>0.14.0</version>
</dependency>

أو Gradle:

implementation 'io.github.qorechain:qorechain-sdk:0.14.0'

منشورة على Maven Central باسم io.github.qorechain:qorechain-sdk (0.14.0 هو الإصدار الحالي). ويحتاج JDK 17 أو أحدث. لا يحتوي Central على إصدار 0.8.0 أو 0.8.1، لذا استخدم على الشبكات الحيّة 0.8.2 أو أحدث. وكان 0.9.1 إصدارًا خاصًا بـ Java فقط نقل Bouncy Castle من 1.80 إلى 1.85 دون تغيير في واجهة API.

الحزمةالغرضالإصدار
@qorechain/wallet-adapterمساعِدات من جانب المحفظة: إنشاء المحافظ (generateQoreWallet)، والتوقيع الهجين بـ eth_secp256k1 (signHybridEth، QoreChainSigner)، وتسجيل شبكة MetaMask (addQoreEvmToWallet)، وبُناة رسائل المصادِقين ونافذة EVM (تبني openEvmWindowMsg فيها الصيغة غير المحدّدة النطاق فقط)، وملخّص v2 للحساب المجرَّد. لا ترفق إثبات حيازة. الاعتماديات النظيرة: @cosmjs/proto-signing و@cosmjs/stargate ‏^0.32 (يستخدم SDK الإصدار 0.39 من cosmjs، لذا يؤدي تثبيت الاثنين في مشروع واحد إلى أن يُبلغ npm عن تعارض في الاعتماديات النظيرة، ERESOLVE؛ أبقِهما في مشروعين منفصلين أو مرّر --legacy-peer-deps)0.5.0
@qorechain/chain-bridgeعامل (worker) من جانب الخادم للأنظمة الخلفية: يشتق مفتاح PQC، ويوقّع هجينًا ويبثّ (sendTokens وregisterPqc وغيرهما). مرّر cosmosRest: فمعه يحمل التسجيل إثبات الحيازة متى طبّقت الشبكة v3.2.3، ويُفحص أي رفض يبدو متعلقًا بـ PQC مقابل السلسلة قبل أي إعادة تسجيل (يثير مفتاح مسجَّل مختلف الخطأ pqc_key_mismatch بدلًا من دفع رسوم تسجيل ثانٍ)0.2.3
@qorechain/pqcبدائيات ML-DSA / ML-KEM / SHAKE-256 المطابقة للمعايير فقط وhybridSignBytes (انظر التوقيع ما بعد الكمّي)؛ وهي متاحة أيضًا على PyPI وcrates.io وMaven Central ووكيل Go (Go v0.2.3) بالإصدار نفسه0.2.3
@qorechain/handlesحلّ @handle الموثَّق (HandleClient): أنت تقدّم المفتاح العام للسجل ومخزن التثبيت، وتثبّت العنوان بعد أن يراه المستخدم؛ ولا تثبّت الحزمة شيئًا من تلقاء نفسها. انظر جسر السلسلة والـ handles0.1.0
@qorechain/connectمهجورة على npm ولم تعد تُصان؛ لا تستخدمها في أي عمل جديد. استخدم @qorechain/wallet-adapter بدلًا منها (بدائل الاتصال بـ QoreX في نظرة عامة على أدوات المطورين). موصِّل واحد لمحافظ EVM وCosmos وSVM، مبني على محوّل المحفظة (نطاق اعتماديته النظيرة هو @qorechain/wallet-adapter ‏^0.2.1، الذي لا يشمل 0.5.0). وهو لا يفتح نافذة تفويض EVM، لذا يُرفض أي إرسال EVM عبره إلى أن يكون للحساب مفتاح مسجّل ونافذة مفتوحة0.2.1
@qorechain/rdkعميل Rollup Development Kit (انظر Rollups). ابتداءً من 0.7.0 يعتمد على @qorechain/sdk ‏^0.10.0 و@qorechain/evm ‏^0.8.0 (جرى التحقق على npm في 4 نوفمبر 2026). وعلامة caret على إصدار 0.x تبقى داخل ذلك الإصدار الفرعي، لذا يحصل التطبيق الذي يستخدم SDK 0.13.0 على نسخة SDK 0.10.x ثانية متداخلة من أجل العدّة؛ أبقِ الاثنتين منفصلتين (لا تمرّر عميلًا من نسخة إلى أخرى) إلى أن ينتقل إصدار من العدّة إلى 0.13. يوقّع هجينًا فقط عندما تمرّر pqcKeypair؛ وتعمل القراءات بدونه. وهو منشور أيضًا باسم qorechain-rdk على PyPI وcrates.io وMaven Central، وكوحدة Go (ثبّت @v0.8.0)؛ ومنذ 0.8.0 توقّع هذه العملاء الأربعة توقيعًا هجينًا أيضًا (كانت الإصدارات السابقة توقّع توقيعًا كلاسيكيًا فقط؛ ويحتاج Java إلى Java 21). انظر RDK 0.8.0: التغييرات والحدود0.9.0
@qorechain/rdk-cliواجهة CLI للمشغّلين qorollup الخاصة بـ RDK. منذ 0.7.1 توقّع أوامر معاملاتها (create وpause وresume وstop وwithdraw) توقيعًا هجينًا (كان 0.7.0 وما قبله يوقّع توقيعًا كلاسيكيًا فقط وترفضه الشبكتان)؛ وعند تثبيتها من npm تعمل ويطبع --version الإصدار المثبَّت (كان 0.6.1 وما قبله لا يطبع شيئًا)0.9.0
@qorechain/qoresealQoreSeal: تشفير حمولة إلى مفاتيح ML-KEM-1024 التي تنشرها الحسابات في سجل KEM (يسجّل SDK 0.12.0 وما بعده المفاتيح ويقرؤها؛ ويتولى QoreSeal التشفير). متاحة أيضًا على PyPI (qorechain-qoreseal؛ عجلات macOS وLinux، وعجلة Windows في الإصدار التالي) وcrates.io وMaven Central (io.github.qorechain:qoreseal وqoreseal-android؛ ويحتاج مستهلكو Kotlin إلى Kotlin 2.3 أو أحدث) ووكيل وحدات Go (github.com/qorechain/qoreseal/go، ‏Go v0.1.0) وكحزمة Swift. انظر QoreSeal0.1.0
@qorechain/asset-kitAsset Kit: أدوات لرموز الأصول الواقعية ذات الأذونات على محرك EVM، مع عملاء بلغات TypeScript وPython وJava وGo وعقود Solidity (forge install qorechain/qorechain-asset-kit@v0.1.0). ترخيص Apache-2.0، عدا سكربتات واختبارات ERC-3643 (GPL-3.0-or-later). الوحدات الأصلية التي يصفها مقترح، وليست مبنية. وهي أيضًا qorechain-asset-kit على PyPI وio.github.qorechain:asset-kit على Maven Central. انظر Asset Kit0.1.0
@qorechain/qoresignQoreSign: توقيع المحافظ والواجهات الخلفية، وinspectTransaction لفحص طبقة ما بعد الكمّي في معاملة مثبَّتة. متاحة أيضًا على PyPI وcrates.io وMaven Central. انظر QoreSign0.2.0
create-qorechain-rollupأداة تهيئة بدايات الـ rollup؛ تعتمد قوالبها على @qorechain/rdk ‏^0.9.0 وتوقّع هجينًا حين تستطيع استخلاص مفتاحك ما بعد الكمّي من QORE_MNEMONIC أو QORE_PQC_SEED_HEX0.9.0

التالي​

تابع إلى البدء السريع للاتصال وقراءة الحالة على السلسلة.