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

قبل أن تبدأ: الأدوات ومحفظة الشبكة التجريبية

يبدأ كل درس في هذا القسم من حاسوب لم يُثبَّت عليه شيء. هذه الصفحة هي المكان الوحيد الذي تُجهّز فيه كل ذلك. افعل ذلك مرة واحدة، ثم افتح أي درس. يعود كل درس إلى هذه الصفحة ويكرّر فقط أوامر الفحص القصيرة التي يحتاجها.

المدة المتوقعة: من 20 إلى 40 دقيقة تقريبًا في المرة الأولى، ومعظمها تنزيلات. ثبّت فقط أدوات الدرس الذي تريد اتباعه.

حساب تجريبي مؤقت فقط

كل ما هنا يعمل على الشبكة التجريبية (testnet) في QoreChain، حيث لا قيمة لـ QOR. لا تستخدم أبدًا محفظتك الحقيقية ولا عبارة استرجاع حقيقية ولا أموالًا حقيقية في أي درس. ستنشئ حسابًا جديدًا لهذا التمرين فقط.

ما الأدوات التي يحتاجها كل درس؟​

ثبّت فقط الصفوف التي تحتاجها. أما Git والطرفية ومتصفح الويب فتلزم جميع الدروس.

الدرساللغةالأدوات المطلوب تثبيتهامحفظة QoreX
دليل الورشة 1TypeScriptNode.js وpnpm وcurl وjq (اختياري)غير مطلوبة
Q-Day CounterTypeScriptGit وNode.js وpnpmغير مطلوبة
Q-Day GuestbookTypeScriptGit وNode.js وpnpmمطلوبة، مع حساب Ethereum (coin 60)
Hybrid InspectorTypeScriptGit وNode.js وpnpmمطلوبة
Rust, qday-payRustGit وRustغير مطلوبة
Java, Tip JarJavaGit وJava 21 وMavenغير مطلوبة
Python, AirdropPythonGit وPython 3.10 أو أحدثغير مطلوبة

افتح الطرفية​

الطرفية (terminal) نافذة تكتب فيها الأوامر. ستنسخ الأوامر من هذه الصفحات وتلصقها فيها، واحدًا تلو الآخر.

النظامكيف تفتحها
macOSاضغط Command وSpace، واكتب Terminal، ثم اضغط Return.
Windowsافتح قائمة ابدأ، واكتب PowerShell، ثم افتح Windows PowerShell. لدرس Java تحتاج أيضًا إلى Git Bash (يأتي مع Git، انظر أدناه) أو WSL.
Linuxاضغط Ctrl وAlt وT، أو ابحث عن Terminal في تطبيقاتك.

بعد تثبيت أي أداة، أغلق الطرفية وافتح طرفية جديدة. الطرفية التي كانت مفتوحة أثناء التثبيت لا ترى الأداة الجديدة بعد.

ثبّت الأدوات​

لكل أداة ستجد أمر التثبيت أو رابط التنزيل، ثم أمر الفحص. يسأل أمر الفحص الأداة عن إصدارها. إذا طبع رقم إصدار يساوي المطلوب أو يزيد عليه، فالأداة تعمل.

مديرو الحزم (مساعدون اختياريون)​

مدير الحزم يثبّت برامج أخرى بأمر واحد. ويمكنك أيضًا تنزيل كل أداة يدويًا من موقعها. تستخدم الأوامر أدناه المساعد المناسب لنظامك.

النظامالمساعدكيف تحصل عليه
macOSHomebrewالصق هذا السطر الواحد في الطرفية، ثم اتبع ما يطبعه: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Windowswingetموجود أصلًا في Windows 10 و11. افحصه بالأمر winget --version.
Linuxaptموجود أصلًا في Ubuntu وDebian. للأنظمة الأخرى: استخدم مدير الحزم الخاص بك (dnf أو pacman).

Git​

يُنزّل Git الشيفرة النموذجية من GitHub.

النظامالتثبيت
macOSxcode-select --install (تُفتح نافذة، اختر Install)، أو brew install git
Windowswinget install --id Git.Git -e، أو نزّله من git-scm.com
Linuxsudo apt install -y git

افحصه:

git --version

يجب أن ترى سطرًا مثل git version 2.40.0. أي إصدار يصلح.

Node.js 22.13 أو أحدث​

يشغّل Node.js مشاريع TypeScript. أما Hardhat 3، وهي أداة العقود المستخدمة هنا، فترفض العمل على أي إصدار أقدم من Node.js 22.13.

النظامالتثبيت
macOSbrew install node، أو نزّل مثبّت LTS من nodejs.org
Windowswinget install --id OpenJS.NodeJS.LTS -e، أو نزّل مثبّت LTS من nodejs.org
Linux (Ubuntu وDebian)curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - ثم sudo apt install -y nodejs
Linux: لا تستخدم حزمة apt الافتراضية

في Ubuntu وDebian يعطيك الأمر sudo apt install nodejs إصدارًا قديمًا ورقمه أقل من المطلوب. استخدم سطر NodeSource أعلاه.

افحصه:

node -v

يجب أن ترى v22.13.0 أو أعلى، مثل v22.20.0 أو v24.1.0. إذا رأيت رقمًا أقل، فأعد التثبيت وافتح طرفية جديدة.

pnpm 9 أو أحدث​

يثبّت pnpm المكتبات التي يحتاجها مشروع TypeScript. وهو يؤدي عمل npm نفسه، لكن بسرعة أكبر.

ثبّته بأداة التثبيت الخاصة بـ Node.js، وهي npm، على كل الأنظمة:

npm install -g pnpm
الجزءماذا يفعل
npm installينزّل برنامجًا ويثبّته.
-gاختصار لكلمة "global" أي عام: يثبّته لحاسوبك كله لا لمجلد واحد.
pnpmالبرنامج المطلوب تثبيته.

في macOS وLinux، إذا انتهى الأمر بالخطأ EACCES أو "permission denied"، فشغّله مرة أخرى بالصيغة sudo npm install -g pnpm.

Node.js المثبَّت من Homebrew لا يتضمن pnpm

إذا قال لك درس pnpm: command not found (أو zsh: command not found: pnpm)، فهذا يعني أنك لم تثبّت pnpm بعد. شغّل npm install -g pnpm، وافتح طرفية جديدة، ثم أعد المحاولة.

افحصه:

pnpm -v

يجب أن ترى 9.0.0 أو أعلى، مثل 10.4.1.

curl وjq (لدليل الورشة 1 فقط)​

ينزّل curl عنوان ويب من الطرفية. ستستخدمه لقراءة معاملتك من نقطة REST العامة. ويصفّي jq الإجابة الطويلة ليُظهر لك الجزء الذي تريده فقط. استخدام jq اختياري.

النظامcurljq
macOSمضمّن.brew install jq
Windowsمضمّن في Windows 10 و11 باسم curl.exe.winget install --id jqlang.jq -e
Linuxsudo apt install -y curl إن لم يكن موجودًاsudo apt install -y jq

افحصهما:

curl --version
jq --version

يجب أن ترى سطر إصدار لكل منهما، مثل jq-1.7.

Windows PowerShell: اكتب curl.exe

في PowerShell تكون الكلمة القصيرة curl أمرًا مدمجًا مختلفًا. اكتب curl.exe بدلًا من curl في كل أمر في هذه الصفحات. وإذا كنت تستخدم Git Bash فإن curl وحدها تعمل.

Rust 1.88 أو أحدث (لدرس Rust فقط)​

يُترجم Rust تطبيق سطر الأوامر qday-pay. ثبّته بالأداة rustup، وهي المثبّت الرسمي لـ Rust. وهي تثبّت أيضًا cargo، أداة البناء في Rust.

النظامالتثبيت
macOScurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh (اضغط Return لقبول الخيار الافتراضي). أدوات المُصرّف تأتي مع xcode-select --install.
Windowsنزّل rustup-init.exe وشغّله من rustup.rs، أو winget install --id Rustlang.Rustup -e. حين يطلب أدوات Visual Studio C++ Build Tools فوافق: يحتاجها Rust لبناء البرامج على Windows.
Linuxsudo apt install -y build-essential curl ثم curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh (اضغط Return لقبول الخيار الافتراضي)

افحصه:

rustc --version
cargo --version

يجب أن ترى rustc 1.88.0 أو أعلى وسطر إصدار لـ cargo. وإذا كان Rust مثبّتًا عندك أصلًا، فالأمر rustup update يحدّثه.

Java 21 وMaven (لدرس Java فقط)​

يحتاج تطبيق Tip Jar إلى JDK بإصدار Java 21 أو أحدث (أدوات بناء Java وتشغيله) وإلى Maven، أداة البناء التي تنزّل مكتبات Java.

النظامالتثبيت
macOSbrew install --cask temurin@21 ثم brew install maven (أو استخدم المثبّت من adoptium.net)
Windowswinget install --id EclipseAdoptium.Temurin.21.JDK -e، ثم نزّل Maven من maven.apache.org/download.cgi، وفكّ ضغطه، وأضف مجلد bin فيه إلى PATH. الطريق الأسهل: ثبّت WSL (انظر أدناه) واتبع سطر Linux.
Linuxsudo apt install -y openjdk-21-jdk maven

افحصهما:

java -version
mvn -version

يجب أن ترى openjdk version "21 (أو رقمًا أعلى مثل 25) وApache Maven 3. يتبعه رقم إصدار. وإذا أظهر java -version الرقم 17 أو أقل، فثبّت Java 21 وافتح طرفية جديدة.

Python 3.10 أو أحدث مع venv (لدرس Python فقط)​

يشغّل Python تطبيق Airdrop. وينشئ venv مجلدًا خاصًا لمكتباته، فلا يُمَسّ أي شيء آخر على حاسوبك.

النظامالتثبيت
macOSbrew install python، أو نزّله من python.org
Windowswinget install --id Python.Python.3.12 -e، أو نزّله من python.org وفعّل الخيار Add python.exe to PATH في المثبّت
Linuxsudo apt install -y python3 python3-venv python3-pip

افحصه:

python3 --version

يجب أن ترى Python 3.10.0 أو أعلى. في Windows اكتب python --version بدلًا منه (الأمر هو python وليس python3).

Windows وأوامر Linux: WSL​

معظم الأوامر في الدروس واحدة على كل الأنظمة. وبعضها يستخدم ميزات صدفة Linux: source وchmod و./tipjar وsleep. في Windows أمامك خياران:

  1. Windows الأصلي. استخدم PowerShell لدروس TypeScript وRust وPython. تعطي الدروس صيغة Windows حيث تختلف، مثل .venv\Scripts\activate. أما لدرس Java فاستخدم Git Bash (يُثبَّت مع Git).
  2. WSL. يمنحك Windows Subsystem for Linux نظام Linux حقيقيًا داخل Windows. افتح PowerShell كمسؤول، وشغّل الأمر أدناه، وأعد التشغيل، ثم اتبع أسطر Linux في هذه الصفحة داخل نافذة Ubuntu.
wsl --install
الجزءماذا يفعل
wslأداة Windows Subsystem for Linux.
--installيثبّت WSL ونظام Ubuntu Linux في خطوة واحدة.

افحص كل شيء دفعة واحدة​

شغّل الأوامر الخاصة بالأدوات التي ثبّتّها. يجب أن يطبع كل أمر رقم إصدار.

git --version
node -v
pnpm -v
rustc --version
java -version
mvn -version
python3 --version
الفحصالإجابة السليمة
node -vv22.13.0 أو أعلى
pnpm -v9.0.0 أو أعلى
rustc --versionrustc 1.88.0 أو أعلى
java -version21 أو أعلى
mvn -versionApache Maven 3. ورقم إصدار
python3 --versionPython 3.10.0 أو أعلى

احصل على محفظة للشبكة التجريبية​

تحتاج إلى مكان تحتفظ فيه بـ QOR التجريبي. بعض الدروس تنشئ لك حسابًا مؤقتًا داخل ملف. وبعضها يستخدم محفظة QoreX، المحفظة الرسمية لـ QoreChain، بعد تحويلها إلى الشبكة التجريبية. الجدول في ما الأدوات التي يحتاجها كل درس؟ يبيّن أيّها.

QoreX على الشبكة التجريبية​

  1. ثبّت QoreX من الصفحة الرسمية: App Store لأجهزة iPhone، وGoogle Play لأجهزة Android، وChrome Web Store لمتصفحات Chrome وBrave وEdge وArc وOpera، أو Firefox Add-ons. القائمة الكاملة في نظرة عامة على QoreX.
  2. أنشئ محفظة جديدة واحفظ عبارة الاسترجاع على الورق. لا تستورد عبارة تحمل أموالًا حقيقية.
  3. حوّل المحفظة إلى الشبكة التجريبية:
    • تطبيق الهاتف: افتح Settings، ثم فعّل Use testnet (developers).
    • إضافة المتصفح: افتحها، ثم اضغط رقم الإصدار في أسفل الشاشة 7 مرات. يظهر خيار للمطورين. اختر Switch to testnet (diana).
  4. تأكد من ظهور شارة الشبكة التجريبية. اسم الشبكة التجريبية هو qorechain-diana.

ما يجب أن تراه: شارة الشبكة التجريبية في المحفظة، وعنوانًا بصيغة qor1... في الشاشة الرئيسية. أرصدة الشبكة التجريبية لا تُظهر قيمة بالدولار، وهذا طبيعي.

أضف حساب Ethereum (coin 60)​

يستخدم درس Guestbook مسار EVM، لذلك تحتاج المحفظة إلى حساب بنمط Ethereum.

  1. في QoreX افتح قائمة الحسابات واختر Add an Ethereum account (coin 60).
  2. أنشئ حسابًا جديدًا. لا تستعد عبارة تحمل أموالًا حقيقية.
  3. اختر ذلك الحساب. سيظهر عنوان يبدأ بـ 0x....

ما يجب أن تراه: حسابًا عنوانه Ethereum, coin 60، وعنوانًا يبدأ بـ 0x. وللحساب نفسه عنوان آخر بصيغة qor1....

للمزيد عن الحسابات: حساب QoreX ولوحة التحكم وابدأ مع QoreX.

احصل على QOR تجريبي من الحنفية​

تعطي الحنفية (faucet) QOR تجريبيًا مجانيًا لعنوان على الشبكة التجريبية. يجب أن يستلم الحساب الجديد بعضًا منه قبل أن يفعل أي شيء، لأن كل معاملة تدفع رسمًا صغيرًا للشبكة.

  1. افتح dashboard.qorechain.io/faucet في متصفحك.
  2. سجّل الدخول إلى لوحة تحكم QoreChain.
  3. الصق عنوانك qor1... في خانة العنوان.
  4. اختر Request Tokens.
  5. انتظر ظهور Tokens Sent!.

ما يجب أن تراه: البطاقة Tokens Sent! مع 100 QOR، ورابط View on Explorer.

تدفع الحنفية 100 QOR مرة كل 24 ساعة لكل حساب ولكل عنوان. وإذا طلبت مرة أخرى مبكرًا جدًا فستظهر Rate Limit Reached. انتظر حتى تنقضي الـ 24 ساعة. طلب واحد يكفي لكل دروس هذه الصفحة.

معاملتك الأولى تسجّل مفتاحك ما بعد الكمّي​

لكل حساب في QoreChain مفتاحان: مفتاح كلاسيكي ومفتاح ML-DSA-87 ما بعد كمّي. المعاملة الأولى لأي حساب جديد تسجّل مفتاح ML-DSA-87 على السلسلة. يحدث ذلك مرة واحدة فقط لكل حساب، وتبلغ كلفته نحو 0.09 QOR. وبعدها تُوقَّع كل معاملة بالمفتاحين معًا.

لترى كيف يُصنع المفتاح ويُربط بحسابك، اقرأ كيف يرتبط مفتاحك ما بعد الكمّي بحسابك.

تنفّذ الدروس هذه الخطوة نيابة عنك بأمر اسمه register. لا تحتاج إلى فعل شيء الآن. فالـ 100 QOR من الحنفية تغطيها مرات كثيرة.

QOR وuqor​

سترى اسمين للعملة نفسها. QOR هو العملة كاملة. وuqor هو أصغر جزء منها.

1 QOR = 1,000,000 uqor.

ما تراهمعناه
1 QOR1,000,000 uqor
0.1 QOR100,000 uqor
0.09 QOR90,000 uqor
0.15uqorسعر 0.15 uqor لكل وحدة غاز، يُستخدم عند دفع رسم

تستخدم المحافظ ومعظم الأوامر QOR. أما السلسلة نفسها فتحسب بوحدة uqor. والمذكرة (memo) نص قصير تُرفقه بالمعاملة، مثل Hello from the workshop. يستطيع أي شخص قراءتها على السلسلة، فلا تضع فيها سرًا أبدًا.

الغاز (gas) هو مقياس العمل الذي تطلب المعاملة من الشبكة إنجازه. والرسم هو الغاز المستهلك مضروبًا في سعر الغاز. تقدّر الأدوات في هذا القسم الغاز نيابة عنك، فلا تحسب شيئًا بنفسك.

حافظ على مفاتيحك المؤقتة​

ينشئ الدرس سرًّا لحسابك على الشبكة التجريبية ويخزّنه على حاسوبك. تعامل معه بعناية، رغم أن QOR التجريبي بلا قيمة، لتكوّن هذه العادة قبل الشبكة الرئيسية.

  1. أين يوجد. في دروس TypeScript تُحفظ الأسرار في ملف اسمه .env داخل مجلد المشروع. أما تطبيقات Rust وJava وPython فتكتب ملف مفتاح بالأمر new، في مجلد مخفي اسمه .config/qday داخل مجلدك الشخصي. ويذكر الدرس اسم الملف بدقة.
  2. لا تشاركه أبدًا. لا تلصقه في محادثة أو بريد إلكتروني أو لقطة شاشة أو فيديو. أخفِ الملف عند مشاركة شاشتك.
  3. لا ترفعه أبدًا إلى Git. لا تضف .env ولا ملف مفتاح إلى Git، ولا تدفعه إلى GitHub. أضف .env إلى .gitignore إن لم يكن المشروع يتجاهله أصلًا.
  4. للشبكة التجريبية فقط. لا تعِد استخدام مفتاح تجريبي أو عبارة استرجاع أو رمز استرداد على الشبكة الرئيسية.
  5. احذفه عند الانتهاء. حين تنهي الدرس، احذف ملف المفتاح أو .env. يمكنك دائمًا إنشاء حساب جديد في دقيقة.
أموال حقيقية

لا تضع أبدًا مفتاح حساب يحمل أموالًا حقيقية، ولا mnemonic (عبارة الاسترجاع)، ولا رمز الاسترداد، في ملف .env أو ملف مفتاح أو أي أمر في هذا القسم.

الشبكة ونقاط النهاية العامة​

الخدمةالقيمة
اسم الشبكة التجريبيةqorechain-diana
معرّف سلسلة EVM9800
REST (قراءة البيانات عبر الويب)https://api-testnet.qore.host
RPChttps://rpc-testnet.qore.host
EVM JSON-RPChttps://evm-testnet.qore.host
المستكشفexplore.qore.network، ثم بدّل إلى Testnet
الحنفيةdashboard.qorechain.io/faucet

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

ما تراهالسببما تفعله
pnpm: command not foundpnpm غير مثبّت. لا يتضمنه Node.js، حتى عند تثبيته بـ Homebrew.شغّل npm install -g pnpm، وافتح طرفية جديدة، ثم شغّل pnpm -v.
node: command not found، أو إصدار قديم بعد التثبيتكانت الطرفية مفتوحة أثناء التثبيت، أو أن الإصدار القديم يأتي أولًا.أغلق الطرفية، وافتح واحدة جديدة، وشغّل node -v. في Linux استخدم سطر NodeSource لا حزمة apt الافتراضية.
ERROR: You are using Node.js ... which is not supported by HardhatNode.js أقدم من 22.13.ثبّت Node.js 22.13 أو أحدث، ثم شغّل pnpm install في المشروع من جديد.
EACCES أو permission denied أثناء npm install -g pnpmلا يملك مستخدمك صلاحية الكتابة في المجلد العام.شغّل sudo npm install -g pnpm في macOS وLinux.
rustc: command not found بعد تثبيت Rustالطرفية لا تعرف قيمة PATH الجديدة بعد.افتح طرفية جديدة. وإن استمر الخطأ فشغّل source "$HOME/.cargo/env".
linker 'cc' not found أو link.exe not found عند بناء Rustأدوات مُصرّف C مفقودة.macOS: xcode-select --install. Linux: sudo apt install -y build-essential. Windows: ثبّت Visual Studio C++ Build Tools.
java -version يُظهر 17 أو أقلإصدار Java أقدم يأتي أولًا.ثبّت Java 21، وافتح طرفية جديدة، ثم افحص مرة أخرى.
تقول PowerShell إن تشغيل السكربتات معطّل عند تفعيل بيئة Python venvيمنع Windows السكربتات افتراضيًا.شغّل Set-ExecutionPolicy -Scope CurrentUser RemoteSigned، وأجب Y، ثم فعّل البيئة من جديد.
Rate Limit Reached في الحنفيةتدفع الحنفية مرة كل 24 ساعة لكل حساب ولكل عنوان.انتظر حتى تنتهي الـ 24 ساعة. طلب واحد يكفي لكل الدروس.
لا تُظهر المحفظة شارة الشبكة التجريبيةما زالت المحفظة على الشبكة الرئيسية.تطبيق الهاتف: Settings، ثم Use testnet (developers). الإضافة: اضغط رقم الإصدار 7 مرات، ثم Switch to testnet (diana).
account has no PQC key and classical fallback is disabledلم يسجّل الحساب الجديد مفتاح ML-DSA-87 بعد.شغّل خطوة register الخاصة بالدرس أولًا (فهي أول معاملة للحساب).
أخطاء CORS في وحدة تحكم المتصفحلا ترسل نقطة REST العامة ترويسات CORS، فلا تستطيع صفحة ويب استدعاءها مباشرة.استدعِ النقطة عبر وكيل /lcd الخاص بالمشروع، كما يفعل القالب.

الخطوة التالية​

اختر درسًا من النظرة العامة واتبعه من أول أمر.