أوامر العُقدة
مرجع لأوامر qorechaind المستخدمة لتهيئة عُقدة QoreChain وإعدادها وتشغيلها.
تشغّل QoreChain شبكتين: الشبكة الرئيسية qorechain-vladi (الحيّة منذ 7 يونيو 2026 على إصدار السلسلة v3.1.85) وشبكة الاختبار qorechain-diana. مرّر الـ --chain-id المناسب للشبكة التي تنوي الانضمام إليها — تستهدف الأمثلة أدناه شبكة الاختبار؛ استخدم --chain-id qorechain-vladi للشبكة الرئيسية.
init
تهيئة عُقدة جديدة بالاسم المستعار المُعطى.
qorechaind init <moniker> --chain-id qorechain-diana
| العَلَم | النوع | الوصف |
|---|---|---|
--chain-id | string | معرّف السلسلة (مطلوب) |
--home | string | دليل المنزل للعُقدة (الافتراضي: ~/.qorechaind) |
--overwrite | bool | استبدال ملفات التكوين والتكوين الأولي (genesis) الموجودة |
ينشئ بنية الأدلة ضمن --home مع config/ وdata/ وملف genesis.json أولي.
start
تشغيل العُقدة وبدء المزامنة أو إنتاج الكتل.
qorechaind start [flags]
| العَلَم | النوع | الوصف |
|---|---|---|
--home | string | دليل المنزل للعُقدة |
--minimum-gas-prices | string | الحد الأدنى لأسعار الغاز المقبولة (مثل 0.001uqor) |
--pruning | string | استراتيجية التقليم: default وnothing وeverything |
--halt-height | uint | إيقاف العُقدة عند ارتفاع الكتلة هذا |
--halt-time | uint | إيقاف العُقدة عند طابع Unix الزمني هذا |
--log_level | string | مستوى تفصيل السجل: info وdebug وwarn وerror |
--trace | bool | تفعيل تتبّع المكدّس الكامل عند الأخطاء |
version
طباعة إصدار البرنامج الثنائي qorechaind ومعلومات البناء.
qorechaind version
استخدم --long للحصول على تفاصيل بناء موسّعة تشمل إصدار Go وتجزئة الـ commit وعلامات البناء:
qorechaind version --long
status
استعلام عن العُقدة قيد التشغيل لمعرفة حالتها الحالية، بما في ذلك حالة المزامنة وأحدث ارتفاع للكتلة ومعلومات الإجماع.
qorechaind status
| العَلَم | النوع | الوصف |
|---|---|---|
--node | string | نقطة نهاية RPC (الافتراضي: tcp://localhost:26657) |
يُرجع JSON يحتوي على أقسام node_info وsync_info وvalidator_info.
config
قراءة أو كتابة القيم في تكوين العُقدة.
تعيين قيمة تكوين
qorechaind config set <key> <value>
الحصول على قيمة تكوين
qorechaind config get <key>
تشمل مفاتيح التكوين الشائعة chain-id وkeyring-backend وoutput وnode.
keys
إدارة سلسلة المفاتيح المحلية لتوقيع المعاملات.
إضافة مفتاح جديد
qorechaind keys add <name> [flags]
| العَلَم | النوع | الوصف |
|---|---|---|
--keyring-backend | string | الخلفية: os وfile وtest |
--algo | string | خوارزمية المفتاح: secp256k1 (الافتراضية)، ed25519 |
--recover | bool | استعادة المفتاح من العبارة التذكيرية (mnemonic) |
--multisig | string | قائمة مفاتيح مفصولة بفواصل للتوقيع المتعدد |
--multisig-threshold | uint | الحد الأدنى للتواقيع المطلوبة |
عرض جميع المفاتيح
qorechaind keys list --keyring-backend <backend>
عرض تفاصيل المفتاح
qorechaind keys show <name> [flags]
| العَلَم | النوع | الوصف |
|---|---|---|
--bech | string | تنسيق الإخراج: acc وval وcons |
--address | bool | عرض العنوان فقط |
--pubkey | bool | عرض المفتاح العام فقط |
حذف مفتاح
qorechaind keys delete <name> --keyring-backend <backend>
تصدير مفتاح (مشفّر بالدرع Armor)
qorechaind keys export <name>
استيراد مفتاح
qorechaind keys import <name> <keyfile>
genesis
إدارة ملف التكوين الأولي (genesis).
إضافة حساب تكوين أولي
qorechaind genesis add-genesis-account <address> <coins> [flags]
| العَلَم | النوع | الوصف |
|---|---|---|
--vesting-amount | string | مبلغ الاستحقاق التدريجي (vesting) |
--vesting-end-time | int | وقت انتهاء الاستحقاق التدريجي (طابع Unix الزمني) |
إنشاء معاملة تكوين أولي
qorechaind genesis gentx <key-name> <stake-amount> [flags]
| العَلَم | النوع | الوصف |
|---|---|---|
--chain-id | string | معرّف السلسلة |
--moniker | string | الاسم المستعار للمدقق |
--commission-rate | string | معدل العمولة الأولي |
--commission-max-rate | string | الحد الأقصى لمعدل العمولة |
تجميع معاملات التكوين الأولي
qorechaind genesis collect-gentxs
التحقق من ملف التكوين الأولي
qorechaind genesis validate-genesis
محرك الإجماع
تتفاعل هذه الأوامر الفرعية مع طبقة محرك الإجماع في QoreChain.
عرض مفتاح المدقق
qorechaind comet show-validator
يُخرج المفتاح العام للإجماع بتنسيق JSON. يُستخدم للتحقق من هوية المدقق.
عرض معرّف العُقدة
qorechaind comet show-node-id
يُخرج معرّف عُقدة الـ P2P (مُرمَّزًا بنظام السداسي عشري). يُستخدم لإعداد النظراء الدائمين.
export
تصدير حالة السلسلة الحالية كملف تكوين أولي بصيغة JSON. مفيد لترقيات السلسلة أو اللقطات (snapshots).
qorechaind export [flags]
| العَلَم | النوع | الوصف |
|---|---|---|
--for-zero-height | bool | تجهيز التصدير لإعادة التشغيل عند الارتفاع 0 |
--height | int | تصدير الحالة عند ارتفاع كتلة محدد |
--home | string | دليل المنزل للعُقدة |
rollback
التراجع بحالة السلسلة كتلة واحدة. مفيد للتعافي من فشل في الإجماع.
qorechaind rollback [flags]
| العَلَم | النوع | الوصف |
|---|---|---|
--hard | bool | إزالة الكتلة الأخيرة من متجر الكتل أيضًا |
--home | string | دليل المنزل للعُقدة |
يتراجع هذا الأمر عن كل من حالة التطبيق وحالة الإجماع. استخدمه بحذر، فلا يمكن التراجع عنه.