أوامر الاستعلام
تتبع جميع أوامر الاستعلام النمط التالي:
qorechaind query <module> <command> [args] [flags]
تُنفَّذ الاستعلامات على العقدة التي يشير إليها الخيار --node. استخدم نقطة نهاية RPC للشبكة الرئيسية qorechain-vladi للحصول على بيانات حية (مثل --node https://rpc.qore.host:443)، أو نقطة نهاية شبكة الاختبار qorechain-diana (--node https://rpc-testnet.qore.host:443) للاختبار. القيمة الافتراضية tcp://localhost:26657 تستهدف عقدة تشغّلها بنفسك. تشغّل الشبكة الرئيسية إصدار العقدة v3.2.3 حتى الارتفاع 3,742,566 وإصدار v3.2.4 من تلك الكتلة (مقترح الحوكمة 13)؛ وتشغّل شبكة الاختبار v3.2.4 منذ 19 أكتوبر 2026. ويضيف الإصدار v3.2.4 بعض المسارات والأوامر (موسومة بعبارة v3.2.4 أدناه): وهي تعمل على شبكة الاختبار الآن وعلى الشبكة الرئيسية من الارتفاع 3,742,566، أما عقدة على الشبكة الرئيسية ما زالت على v3.2.3 فتجيب عنها بـ Not Implemented. جرى التحقق من الأوامر في هذه الصفحة مقابل الملف الثنائي للإصدار v3.2.3، مُشغَّلًا على https://rpc.qore.host:443.
تنطبق الرايات (Flags) الشائعة على كل أمر فرعي من أوامر query:
| الراية | النوع | الوصف |
|---|---|---|
--node | string | نقطة نهاية RPC (الافتراضية: tcp://localhost:26657) |
--output | string | تنسيق الإخراج: json أو text |
--height | int | الاستعلام عن الحالة عند ارتفاع كتلة محدد |
ليس لكل وحدة استعلام في سطر الأوامر. وحيثما يغيب أمر، استخدم نقطة نهاية REST (https://api.qore.host/...)؛ راجع REST API.
bank
qorechaind query bank balances <address>
qorechaind query bank total-supply
qorechaind query bank total-supply-of uqor
qorechaind query bank spendable-balances <address>
(لا يوجد query bank total.)
staking
qorechaind query staking validator <validator_address>
qorechaind query staking validators
qorechaind query staking validators --status BOND_STATUS_BONDED
qorechaind query staking delegation <delegator_address> <validator_address>
qorechaind query staking delegations <delegator_address>
qorechaind query staking delegations-to <validator_address>
qorechaind query staking unbonding-delegation <delegator_address> <validator_address>
qorechaind query staking unbonding-delegations <delegator_address>
qorechaind query staking redelegation <delegator_address> <src_validator> <dst_validator>
qorechaind query staking params
qorechaind query staking pool
يقبل --status اسم التعداد (enum) الكامل: BOND_STATUS_BONDED أو BOND_STATUS_UNBONDING أو BOND_STATUS_UNBONDED (يُرفض --status bonded).
distribution
qorechaind query distribution rewards <delegator_address>
qorechaind query distribution commission <validator_address>
qorechaind query distribution validator-outstanding-rewards <validator_address>
qorechaind query distribution community-pool
qorechaind query distribution params
gov
qorechaind query gov proposals
qorechaind query gov proposals --proposal-status voting-period
qorechaind query gov proposal <proposal_id>
qorechaind query gov votes <proposal_id>
qorechaind query gov vote <proposal_id> <voter_address>
qorechaind query gov tally <proposal_id>
qorechaind query gov params
يقبل --proposal-status القيم deposit-period أو voting-period أو passed أو rejected أو failed. عوامل تصفية أخرى: --voter و--depositor.
tx
qorechaind query tx <txhash>
qorechaind query txs --query "message.sender='<address>'"
pqc
qorechaind query pqc account <address>
qorechaind query pqc algorithms
qorechaind query pqc algorithm dilithium5
qorechaind query pqc stats
qorechaind query pqc params
qorechaind query pqc migration <algorithm_id>
qorechaind query pqc hybrid-mode
qorechaind query pqc evm-window <address>
qorechaind query pqc evm-delegation-consent <address>
- يقبل
algorithmاسم خوارزمية (dilithium5أوmlkem1024) أو معرّفاً رقمياً. - يقبل
migrationمعرّف خوارزمية (مثل1)، وليس عنواناً، ويُبلغ عنNo active migrationعندما لا توجد عملية ترحيل جارية. - يُبلغ
accountعن المفتاح المسجَّل. إلى جانب المفتاح وkey_typeوalgorithm_name، يحتوي السجل علىclassical_key_source(storedأوauth_accountأوnone: أي مصدر المفتاح العام الكلاسيكي). ومن v3.2.4 (على شبكة الاختبار منذ 19 أكتوبر 2026؛ وعلى الشبكة الرئيسية من الارتفاع 3,742,566) يحمل أيضاًpossession_proven، وتكون قيمتهاtrueعندما سُجّل المفتاح بإثبات حيازة جرى التحقق منه. - يعرض
evm-windowما إذا كان للعنوان نافذة تفويض مفتوحة على مسار EVM وكم كتلة ومعاملة وقيمة متبقية (foundوliveوremaining_blocksوremaining_txsوremaining_value)، إضافةً إلى نطاق النافذة (native_onlyوallowed_targets؛ منذ v3.2.3 على الشبكة الرئيسية). REST:GET /qorechain/pqc/v1/evm_window/{address}. - يعرض
evm-delegation-consentموافقة العنوان على التفويض بموجب EIP-7702 (foundوliveوdelegateوgranted_heightوexpiry_height)، وتفويضه الحالي، وقيمة nonce الخاصة به على EVM. REST:GET /qorechain/pqc/v1/evm_delegation_consent/{address}. - يُبلغ
paramsوhybrid-modeعنhybrid_signature_mode(القيمة2= مطلوب على الشبكتين) وعنallow_classical_fallback(false).
burn
لا تملك وحدة الحرق (burn) استعلاماً في سطر الأوامر. استخدم REST:
curl -s https://api.qore.host/qorechain/burn/v1/params
curl -s https://api.qore.host/qorechain/burn/v1/stats
curl -s https://api.qore.host/qorechain/burn/v1/records
curl -s https://api.qore.host/qorechain/burn/v1/milestone
curl -s https://api.qore.host/qorechain/burn/v1/stranded_rewards
يُبلغ stranded_rewards عن حصة المخزِّنين (stakers) التي أُودعت في وحدة التوزيع دون أن تغطي أي مطالبة (reserved وreleased وsnapshot_height). ولا يمكن الإفراج عنها إلا بتصويت حوكمة. سُجّل الاحتياطي أول مرة عند الترقية إلى v3.2.0 وأُعيد حسابه عند ارتفاع الترقية إلى v3.2.3، لذا اقرأ القيم الحية بدلاً من رقم مذكور في موضع آخر.
يقسّم stats الحرق التراكمي بحسب المصدر، بما في ذلك failed_tx التي ظلّت قيمتها غير صفرية منذ الترقية إلى v3.2.2.
mint وinflation
يقرأ qorechaind query mint params|inflation|annual-provisions وحدة mint القياسية التي معدّلها 0 على الشبكتين؛ وهو لا يُبلغ عن جدول الإصدار الخاص بالبروتوكول. لا يوجد أمر query inflation في سطر الأوامر. أما إعدادات الإصدار الخاصة بالبروتوكول وتقدّمه فتُقدَّم عبر REST منذ v3.2.2:
curl -s https://api.qore.host/qorechain/inflation/v1/params # emission_mode, fixed_epoch_emission, max_total_emission, epoch_length
curl -s https://api.qore.host/qorechain/inflation/v1/epoch_info # current_epoch, next_epoch_height, total_minted, remaining_emission
تُبلغ هذه الاستعلامات على الشبكة الرئيسية عن emission_mode: "fixed"، وإصدار ثابت قدره 86,000 QOR لكل حقبة من 43,200 كتلة، وسقف تراكمي قدره 590,000,000 QOR (مقترح الحوكمة 10، أُقرّ في 19 أكتوبر 2026؛ وتبدأ أول حقبة بالمبلغ الجديد عند الكتلة 3,672,000). المبالغ بوحدة uqor. وما زالت شبكة الاختبار تُبلغ عن قيمها الخاصة المختلفة؛ ويضيف إصدار v3.2.4 وضع إصدار آخر (على شبكة الاختبار منذ 19 أكتوبر 2026؛ وعلى الشبكة الرئيسية من الارتفاع 3,742,566)، لكن الشبكة لا تنتقل إليه إلا بتصويت الحوكمة الخاص بها، ولذلك تُبقي الشبكة الرئيسية على fixed إلى أن يُقرّ تصويت كهذا.
ai
qorechaind query ai config
qorechaind query ai stats
reputation وqca
qorechaind query reputation params
qorechaind query qca config
لا توجد استعلامات سمعة لكل مُدقِّق ولا استعلامات تصنيف المجمّعات (pools).
lightnode
qorechaind query lightnode params
qorechaind query lightnode stats
qorechaind query lightnode light-nodes
qorechaind query lightnode light-node <operator_address>
qorechaind query lightnode rewards <operator_address>
qorechaind query lightnode reward-pool
يعرض reward-pool كيف ينقسم رصيد مكافآت الوحدة إلى reserved وoutstanding وpayable وdistributable، وحدود كل عقدة: max_reward_per_block_per_node ومنذ v3.2.3 max_reward_per_month_per_node (2,000 QOR، موزّعة بالتناسب بحسب زمن الكتلة ووقت التشغيل). ومن v3.2.4 (على شبكة الاختبار منذ 19 أكتوبر 2026؛ وعلى الشبكة الرئيسية من الارتفاع 3,742,566) يُبلغ أيضاً عن monthly_cap_active وlast_distribution_time وlast_distribution_height.
license
qorechaind query license check <grantee_address> <feature_id>
qorechaind query license holders <feature_id>
qorechaind query license list <grantee_address>
يُرجع check الخطأ NotFound عندما لا يحمل المستفيد ترخيصاً للميزة.
bridge
qorechaind query bridge config
qorechaind query bridge chains
qorechaind query bridge chain <chain_id>
qorechaind query bridge validators
qorechaind query bridge operations
qorechaind query bridge operation <operation_id>
crossvm
qorechaind query crossvm message <message_id>
qorechaind query crossvm pending
qorechaind query crossvm params
svm
qorechaind query svm account <base58_address>
qorechaind query svm program <base58_address>
qorechaind query svm params
qorechaind query svm slot
multilayer
qorechaind query multilayer layer <layer_id>
qorechaind query multilayer layers
qorechaind query multilayer routing-stats
qorechaind query multilayer params
rdk
qorechaind query rdk config
qorechaind query rdk rollup <rollup_id>
qorechaind query rdk list-rollups
qorechaind query rdk batch <rollup_id> # latest batch
qorechaind query rdk batch <rollup_id> --index 42 # a specific batch
qorechaind query rdk batches <rollup_id> [--start 0] [--limit 100] # batches in index order
qorechaind query rdk anchor-sign-bytes <layer_id> <batch_index> <state_root_hex> --tx-count <n> --validator-set-hash <hex>
يعرض config معاملات الوحدة (الحد الأدنى للحصة، ومعدل الحرق عند الإنشاء، ونافذة التحدي، وحدود DA). ويطبع anchor-sign-bytes بالنظام السداسي عشري بايتات توقيع الإرساء (anchor) بالإصدار v2 التي يوقّعها منشئ الرول-أب لأجل tx rdk submit-batch --anchor-signature. وتُقدَّم الاستعلامات نفسها عبر REST تحت /qorechain/rdk/v1/... منذ v3.2.2 (راجع نقاط نهاية REST / gRPC). أما suggest-profile <use_case> فلا يستعلم عن السلسلة؛ بل يطبع فقط إشارة إلى طريقة JSON-RPC لا تقدّمها نقاط النهاية العامة، لذا اختر ملفاً من الملفات الجاهزة.
rlconsensus
qorechaind query rlconsensus agent-status
qorechaind query rlconsensus observation
qorechaind query rlconsensus reward
qorechaind query rlconsensus params
qorechaind query rlconsensus policy
abstractaccount
وحدة الحسابات المجرَّدة متوقفة حالياً على الشبكتين (config.enabled تساوي false)، لذا لا تُرجع هذه الاستعلامات أي حسابات.
qorechaind query abstractaccount config
qorechaind query abstractaccount accounts
qorechaind query abstractaccount account <address>
qorechaind query abstractaccount permission-schema
تبني auth-keygen وauth-sign-cosmos <chain_id> <account> <to> <amount> <nonce> وauth-sign-evm <chain_id> <account> <to_0x> <value_wei> <data_hex> <nonce> تواقيع المصادقة دون اتصال. بذرة المصادقة ليست وسيطاً أبداً: تُقرأ من --seed-file <file> (أو - للإدخال القياسي)، أو من متغير البيئة QORE_AUTH_SEED، أو من مطالبة بلا صدى، وتكتبها auth-keygen في ملف 0600 جديد (--out) بدلاً من طباعتها.
gasabstraction
تُقدَّم استعلامات تجريد الغاز على الشبكتين منذ v3.2.2:
qorechaind query gasabstraction config
qorechaind query gasabstraction accepted-tokens
qorechaind query gasabstraction conversion-rate <denom> # what one unit of a fee token is worth in uqor, and whether it can pay fees
qorechaind query gasabstraction float # the conversion float's balances and this block's usage
لا تحتوي قائمة الرموز المقبولة سوى uqor الأصلي على الشبكتين، لذا تُدفع الرسوم بـ uqor ولا يجري أي تحويل؛ وتقرّر الحوكمة أي الرموز الأخرى تُقبل. REST: /qorechain/gasabstraction/v1/config و/conversion_rate?denom= و/float. راجع تجريد الغاز.
amm
qorechaind query amm params
qorechaind query amm pools
qorechaind query amm pool <pool_id>
qorechaind query amm pool-by-denoms <denom_a> <denom_b>
qorechaind query amm lp-balance <pool_id> <address>
qorechaind query amm quote-exact-in <pool_id> <denom_in> <amount_in>
qorechaind query amm quote-exact-out <pool_id> <denom_out> <amount_out>
لا يوجد أي مجمّع (pool) على أي من الشبكتين وقت كتابة هذا.
stakingtier (v3.2.4)
qorechaind query stakingtier params
qorechaind query stakingtier locks <holder_address>
qorechaind query stakingtier pool
وحدة طبقات التخزين (staking tiers) جزء من إصدار v3.2.4: وهي تعمل على شبكة الاختبار منذ 19 أكتوبر 2026 وتعمل على الشبكة الرئيسية من الارتفاع 3,742,566 (مقترح الحوكمة 13). وقبل ذلك الارتفاع تجيب عقدة الشبكة الرئيسية عن هذه الاستعلامات بـ Not Implemented. REST: /qorechain/stakingtier/v1/params و/locks/{holder} و/pool. راجع أوامر المعاملات.
circuit, feemarket, upgrade
qorechaind query circuit disabled-list # message types switched off network-wide
qorechaind query feemarket params
qorechaind query feemarket base-fee
qorechaind query upgrade plan
qorechaind query upgrade applied <upgrade_name>
qorechaind query upgrade module-versions
query upgrade applied <name> هو الطريقة لمعرفة متى دخلت الترقية حيّز التنفيذ: على الشبكة الرئيسية طُبّق v3.2.2 عند الارتفاع 3,556,788 وv3.2.3 عند الارتفاع 3,662,051؛ وعلى شبكة الاختبار طُبّق v3.2.2 عند 6,905,034 وv3.2.3 عند 8,003,746 وv3.2.4 عند 8,337,253 (القيمة 0 تعني أنها لم تُطبَّق). وتضم قائمة قاطع الدائرة (circuit breaker) على الشبكة الرئيسية (disabled-list) حالياً رسائل إنشاء حسابات الاستحقاق التدريجي (vesting)، وتخزين QoreChain Native وإنشاء نسخ منه، وإيقاف مجمّعات AMM مؤقتاً واستئنافها، والاستدعاء عبر الآلات الافتراضية (cross-VM)، وتحديث حالة طبقة multilayer، وإهمال خوارزميات PQC وتعطيلها، ورسائل حوكمة إجماع PRISM؛ أما قائمة شبكة الاختبار فلا تضم سوى رسائل QoreChain Native الثلاث.
evm, erc20, wasm
تقرأ أوامر wasm بيئة QoreChain Native، وهو اسم QoreChain لبيئة تشغيل العقود الذكية CosmWasm؛ وتحتفظ أسماء الأوامر والوحدة بالتهجئة wasm.
qorechaind query evm params
qorechaind query evm balance-bank <0x_address> uqor
qorechaind query erc20 token-pairs
qorechaind query wasm params
qorechaind query wasm list-code
qorechaind query wasm list-contract-by-code <code_id>
qorechaind query wasm contract <contract_address>
qorechaind query wasm contract-state smart <contract_address> '<json_query>'
وحدات بلا سطر أوامر
ليس لدى xqore وbabylon وfairblock أوامر معاملات أو استعلام. ولا يمكن استخدامها من سطر الأوامر أو من أي واجهة برمجة عامة في الوقت الحالي.