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

واجهة الأوامر: create-qorechain-dapp

أنشئ هيكل تطبيق QoreChain لامركزي جديد من قالب بدء رسمي.

# interactive
npm create qorechain-dapp my-dapp
# or
npx create-qorechain-dapp my-dapp

# non-interactive (CI)
npx create-qorechain-dapp my-dapp --template evm-solidity --yes --no-install

منشورة على npm باسم create-qorechain-dapp (0.14.0، الذي يحمل أيضًا إصلاحات القوالب في 0.13.1). تعتمد ملفات package.json المُنشأة على @qorechain/sdk ‏^0.14.0 (وقوالب EVM على @qorechain/evm ‏^0.14.0). كان الإصدار 0.8.0 من أداة الهيكلة يكتب نطاقات ^0.3.0، وهو ما يحلّه npm إلى إصدار 0.3 لا يستطيع التوقيع للشبكات الحيّة؛ وإن كنت قد أنشأت الهيكل بـ 0.8.0، فنفّذ npm i @qorechain/sdk@latest.

القوالب​

القالبالوصف
evm-solidityعقد Counter بلغة Solidity + سكربت نشر/تفاعل بـ viem (@qorechain/evm). شغّل السكربت بـ pnpm run deploy (وليس pnpm deploy، فهو أمر pnpm مختلف)؛ يقرأ .env، ويشرح README فتح نافذة EVM قبل النشر.
fullstack-webتطبيق لامركزي بـ Vite + React + TypeScript يقرأ الأرصدة واقتصاديات الرمز (@qorechain/sdk). يمر REST عبر وكيل Vite باسم /lcd لأن REST العام لا يرسل ترويسات CORS، فيستدعي كود المتصفح /lcd/... أثناء التطوير.
rollup-appتطبيق rollup + سلسلة جانبية/paychain يستخدم RollupClient ومساعد multilayer (@qorechain/sdk).
foundryمشروع Foundry لمحرك EVM في QoreChain. يسجّل pnpm window مفتاح ML-DSA-87 للحساب ويفتح نافذة تفويض EVM قبل النشر (أُضيف في 0.11.0 الخاص بـ npm فقط).
hardhatالشيء نفسه لـ Hardhat 3، مع pnpm window status وregister وopen.
viem-wagmiتطبيق ويب لامركزي على viem وwagmi يستخدم سلسلتي qorechain وqorechainTestnet من @qorechain/evm. يثبّت viem على ~2.53.1 ويستخدم وكيل /lcd نفسه لـ REST.
cosmwasmمشروع عقد على QoreChain Native (Wasm). على الشبكتين الحيّتين رفع الشيفرة بالحوكمة فقط؛ راجع دليل QoreChain Native.

يُجري قالب rollup-app (منذ أداة الهيكلة 0.10.0) تشغيلًا تجريبيًا افتراضيًا. ومع QORE_BROADCAST=1 يشتق مفتاح ML-DSA-87 للحساب من عبارة الاسترجاع، ويسجّله مرة واحدة ويوقّع توقيعًا هجينًا، وهو ما لم يكن القالب السابق قادرًا عليه. وقيم الـ rollup النموذجية فيه (profile: "default"، والحصة) توضيحية: خذ أسماء الملفات التعريفية الحقيقية والحصة من الإعدادات المسبقة ومن معاملات الوحدة الحيّة قبل أن تبثّ.

يقرأ قالب fullstack-web نظرة اقتصاديات الرمز عبر client.qor، وهو استدعاء JSON-RPC من نوع qor_ لا تخدمه نقاط النهاية العامة، لذا تعرض تلك اللوحة خطأً على الشبكة الرئيسية والتجريبية؛ أما قراءة الرصيد فتعمل. بدّله إلى قراءة REST مثل client.rest.getBurnStats() للشبكات العامة.

الخيارات​

الرايةالوصف
-t, --template <name>القالب المراد استخدامه (evm-solidity | fullstack-web | rollup-app | foundry | hardhat | viem-wagmi | cosmwasm).
--network <name>إعداد الشبكة المسبق (testnet | mainnet). يكتب نقاط النهاية العامة للشبكة المختارة في ملف .env المولَّد (منذ 0.13.1).
--package-manager <pm>pnpm | npm | yarn.
-y, --yesتخطّ المطالبات واستخدم الإعدادات الافتراضية.
--no-installلا تثبّت التبعيات بعد إنشاء الهيكل.
--localأعد كتابة تبعيات @qorechain/* إلى روابط file: محلية داخل مستودع SDK الموحّد.
-h, --helpإظهار المساعدة.
-v, --versionطباعة الإصدار.

التطوير المحلي مقابل مساحة العمل​

حزم @qorechain/* منشورة على npm، لذا يعمل npm install العادي. استخدم --local لتوجيه المشروع المُنشأ إلى حزم المستودع الموحّد بدلًا من ذلك (ابنها أولاً بـ pnpm -r build):

npx create-qorechain-dapp my-dapp --template fullstack-web --local