نقاط REST / gRPC
توفّر QoreChain ثلاث واجهات أساسية للوصول البرمجي:
| الواجهة | المنفذ الافتراضي | البروتوكول | الوصف |
|---|---|---|---|
| REST | 1317 | HTTP/1.1 | بوابة REST (خادم API الخاص بـ Cosmos SDK) |
| gRPC | 9090 | HTTP/2 | خدمة gRPC مُرمّزة بـ Protobuf |
| RPC | 26657 | HTTP + WS | واجهة RPC لمحرّك إجماع QoreChain |
تُعيد جميع نقاط REST بيانات JSON. تستخدم نقاط gRPC صيغة Protocol Buffers ويمكن استهلاكها بأي عميل gRPC. توفّر واجهة RPC استعلامات على مستوى الإجماع وبثّ المعاملات.
هذه الواجهات متاحة على كلٍّ من الشبكة الرئيسية qorechain-vladi (تعمل منذ 7 يونيو 2026) وشبكة الاختبار qorechain-diana. تعمل شبكة الاختبار بإصدار العقدة v3.2.8 (طبّقته حوكمة شبكة الاختبار عند الارتفاع 9,929,500 في 12 نوفمبر 2026، بعد v3.2.7 عند الارتفاع 9,594,600 في 6 نوفمبر 2026) وتعمل الشبكة الرئيسية بإصدار v3.2.7، أي بإصدار واحد خلفها. طبّقت الشبكة الرئيسية v3.2.7 عند الارتفاع 4,164,600 في 12 نوفمبر 2026 (مقترح الحوكمة 16، بعد v3.2.6 عند الارتفاع 4,020,000 في 4 نوفمبر 2026، مقترح الحوكمة 15، وv3.2.5 عند الارتفاع 3,906,833 في 29 أكتوبر 2026، المقترح 14، وv3.2.4 عند الارتفاع 3,742,566 في 23 أكتوبر 2026)؛ وطبّقت شبكة الاختبار v3.2.5 عند الارتفاع 8,890,800 في 26 أكتوبر 2026 وv3.2.6 عند الارتفاع 8,970,638 في 27 أكتوبر 2026، وv3.2.7 عند الارتفاع 9,594,600 وv3.2.8 عند الارتفاع 9,929,500. ولم تطبّق الشبكة الرئيسية v3.2.8. لا تظهر المسارات والحقول التي يضيفها إصدار على شبكة ما إلا بعد أن تطبّق تلك الشبكة الإصدار. وقد أُجريت فحوص المسارات الموسومة بتاريخ 4 نوفمبر 2026 أدناه على مضيف الشبكة الرئيسية العام بعد ترقية v3.2.6؛ أما المسارات الموسومة بعبارة v3.2.7 فقد جرى التحقق منها على مضيف شبكة الاختبار العام في 7 نوفمبر 2026 وعلى مضيف الشبكة الرئيسية العام في 12 نوفمبر 2026 بعد أن طبّقت الشبكة الرئيسية v3.2.7 (وجميعها موجَّهة؛ انظر الملاحظات عند كل مسار). تفترض عناوين URL الأساسية أدناه عقدة تعمل محليًا. نقاط النهاية العامة المستضافة هي https://api.qore.host / https://api-testnet.qore.host (REST) وhttps://rpc.qore.host / https://rpc-testnet.qore.host (RPC)، وهي مُدرجة في الشبكات. لا توجد نقطة gRPC عامة: اسما المضيف grpc.qore.host وgrpc-testnet.qore.host غير موجودين، لذا شغّل عقدتك الخاصة إذا كنت بحاجة إلى gRPC.
عناوين URL الأساسية
REST: http://localhost:1317
gRPC: localhost:9090
RPC: http://localhost:26657
المسارات الموجودة
تُعرض الوحدات الخاصة بـ QoreChain عبر REST تحت البادئة /qorechain/<module>/v1/...، ولا تملك مسارات REST سوى الوحدات المذكورة أدناه. أما الوحدات الأخرى فيمكن الوصول إليها عبر gRPC فقط (انظر وحدات gRPC فقط). وتُدرج مسارات Cosmos SDK وEVM وQoreChain Native القياسية في المسارات القياسية.
يردّ المسار غير الموجود بـ HTTP 501 مع {"code":12,"message":"Not Implemented"}. وهذا يعني أن المسار غير مخدَّم، لا أن الاستعلام عاد فارغًا. أما المسارات المختصرة بدون البادئة /qorechain/ (مثل /bridge/v1/chains أو /pqc/v1/params) فهي غير مخدَّمة. ويُعيد سجل غير معروف على مسار موجود HTTP 404 مع {"code":5,"message":"... not found"}.
تستخدم الأمثلة أدناه المضيف العام للشبكة الرئيسية؛ استبدله بـ https://api-testnet.qore.host لشبكة الاختبار. قُرئت القيم في الأمثلة من الشبكتين الحيّتين بين 20 و27 أكتوبر 2026 وتتغيّر مع الوقت؛ استخدمها لمعرفة شكل الاستجابة. أضاف إصدار v3.2.4 بعض المسارات والحقول. وهي موسومة أدناه بعبارة v3.2.4: تخدمها شبكة الاختبار منذ 19 أكتوبر 2026 والشبكة الرئيسية منذ 23 أكتوبر 2026. وأضاف إصدار v3.2.5 (على الشبكة الرئيسية منذ 29 أكتوبر 2026، وعلى شبكة الاختبار منذ 26 أكتوبر) مسارات المعلمات والرسائل لوحدة cross-VM ومسار سجل المفاتيح الأصلي، وهي موسومة بعبارة v3.2.5. وأضاف إصدار v3.2.6 (على شبكة الاختبار منذ 27 أكتوبر 2026، وعلى الشبكة الرئيسية منذ 4 نوفمبر 2026) المزيد، وهو موسوم بعبارة v3.2.6: وقد ردّ عليها مضيف الشبكة الرئيسية بالرمز 200 في 4 نوفمبر 2026 (مع الإشارة إلى الاستثناء حيث ينطبق). أما العقدة التي ما زالت على إصدار أقدم فتردّ على أي مسار جديد بـ 501. وأضاف إصدار v3.2.7 (على شبكة الاختبار منذ 6 نوفمبر 2026، وعلى الشبكة الرئيسية منذ 12 نوفمبر 2026) المسارات الموسومة بعبارة v3.2.7: تعدد التوقيع PQC والتوقيع النصي، وAPR للستيكينغ، وهوية كتلة SVM.
وحدة PQC
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/pqc/v1/account/{address} | تسجيل مفتاح ما بعد الكم لحساب (found، نوع المفتاح، الخوارزمية) |
| GET | /qorechain/pqc/v1/evm_window/{address} | نافذة التفويض الخاصة بمسار EVM للحساب وما تبقّى منها |
| GET | /qorechain/pqc/v1/evm_limits | حدود غاز EVM السارية (لكل معاملة 30,000,000)؛ على شبكة الاختبار فقط، من v3.2.8؛ ولم تطبّق الشبكة الرئيسية v3.2.8 وتردّ بالرمز 501 (جرى التحقق في 12 نوفمبر 2026) |
| GET | /qorechain/pqc/v1/evm_delegation_consent/{address} | موافقة الحساب على تفويض EIP-7702، والتفويض الحالي، ورقم تسلسل EVM (nonce) (منذ v3.2.2) |
| GET | /qorechain/pqc/v1/protocol_features | v3.2.4 (شبكة الاختبار منذ 19 أكتوبر 2026؛ الشبكة الرئيسية منذ 23 أكتوبر 2026؛ و501 على عقدة أقدم). كل ميزة بروتوكول يعرفها الملف التنفيذي، مع العلامات enabled وknown وstaged |
| GET | /qorechain/pqc/v1/kem/{address} | v3.2.5 (على الشبكة الرئيسية منذ 29 أكتوبر 2026 وعلى شبكة الاختبار منذ 26 أكتوبر؛ و501 على عقدة أقدم). مفتاح التشفير ML-KEM المسجَّل لعنوان ما في سجل المفاتيح الأصلي: {"found":false,"key":null} عندما لا يكون أي مفتاح مسجَّلًا |
| GET | /qorechain/pqc/v1/params | v3.2.6 (شبكة الاختبار منذ 27 أكتوبر 2026، والشبكة الرئيسية منذ 4 نوفمبر 2026؛ و501 على عقدة أقدم). معاملات الوحدة |
| GET | /qorechain/pqc/v1/multisig/{address} | v3.2.7 (شبكة الاختبار منذ 6 نوفمبر 2026، والشبكة الرئيسية منذ 12 نوفمبر 2026؛ و501 على عقدة أقدم). سجل multisig الهجين ما بعد الكمّي لعنوان: {"found":false,"multisig":null} عندما لا يوجد سجل |
| POST | /qorechain/pqc/v1/textual_sign_doc | v3.2.7 (شبكة الاختبار منذ 6 نوفمبر 2026، والشبكة الرئيسية منذ 12 نوفمبر 2026؛ و501 على عقدة أقدم؛ وتردّ GET أيضًا بـ 501). يبني مستند SIGN_MODE_TEXTUAL لمعاملة كي تعرضه محفظة ويب وتوقّعه (انظر أدناه) |
لاحظ أن مقطع المسار هو المفرد account. لا يوجد مسار /qorechain/pqc/v1/stats (استخدم qorechaind query pqc stats). ويُخدَّم /qorechain/pqc/v1/params من v3.2.6 وقد ردّ بالرمز 200 على الشبكتين في 4 نوفمبر 2026 (على الشبكة الرئيسية: pqc_primary هي true، وallow_classical_fallback هي false، وmin_security_level هي 5، وdefault_signature_algo_name هي dilithium5، وhybrid_signature_mode_name هي required). وعلى عقدة أقدم من v3.2.6 استخدم qorechaind query pqc params بدلًا من ذلك.
تعدد التوقيع PQC والتوقيع النصي (v3.2.7)
منذ v3.2.7 (شبكة الاختبار منذ 6 نوفمبر 2026، والشبكة الرئيسية منذ 12 نوفمبر 2026، حيث تُفعَّل ميزة البروتوكول pqc-multisig من الارتفاع 4,164,600) يمكن أن يكون لحساب ما multisig هجين ما بعد كمّي من نوع k-of-n. الرسالة هي /qorechain.pqc.v1.MsgRegisterPQCMultisig؛ وتتبع المجموعة ما بعد الكمّية أعضاء ومفاتيح multisig الكلاسيكي الحالي للحساب. يعيد GET /qorechain/pqc/v1/multisig/{address} التسجيل. وفي 7 نوفمبر 2026 ردّ بالرمز 200 مع {"found":false,"multisig":null} لحساب بلا multisig (يحتاج المسار إلى عنوان qor1... صالح؛ ويردّ العنوان المشوَّه بالرمز 400). وعلى الشبكة الرئيسية يُخدَّم المسار منذ 12 نوفمبر 2026 (وردّ طلب بعنوان غير صالح بالرمز 400، وهو ما يدل على أن المسار مركَّب). لم تُقرأ هنا حقول سجل multisig مسجَّل، لأنه لا يوجد multisig مسجَّل على شبكة الاختبار بعد.
يخدم POST /qorechain/pqc/v1/textual_sign_doc المحافظ العتادية ومحافظ الويب التي توقّع بالنمط SIGN_MODE_TEXTUAL. يحمل جسم JSON الحقل tx_json (المعاملة غير الموقّعة كسلسلة JSON) أو tx_bytes (base64)، إضافةً إلى chain_id وaccount_number وsequence وpublic_key (نوع Any يضم @type وkey). وتتضمن الاستجابة sign_bytes (base64، المستند المراد توقيعه) وscreens، أي قائمة الأسطر التي يعرضها الجهاز (title وcontent وindent وexpert). وعلى الشبكة الرئيسية ردّ جسم JSON خالٍ بالرمز 400 في 12 نوفمبر 2026، فالمسار مركَّب هناك. ويردّ الجسم الخالي من معاملة بالرمز 400 (tx_bytes or tx_json is required)، وتُرفض المعاملة التي لا تحتوي أي رسالة أو التي تحتوي أكثر من 32 رسالة. وفي سطر الأوامر يدعم qorechaind tx pqc cosign نمط التوقيع النصي من v3.2.7 (انظر أوامر المعاملات).
curl -s https://api.qore.host/qorechain/pqc/v1/multisig/qor1... # or api-testnet.qore.host
curl -s -X POST https://api.qore.host/qorechain/pqc/v1/textual_sign_doc \
-H 'content-type: application/json' -d @request.json
الغاز المحتسب لفحص توقيع ما بعد كمّي هو 2,000 وحدة غاز ثابتة لكل تحقق منذ v3.2.7 (شبكة الاختبار منذ 6 نوفمبر 2026، والشبكة الرئيسية منذ 12 نوفمبر 2026، البوابة pqc-verify-gas-calibrated)؛ انظر سجل الإصدارات.
curl -s https://api.qore.host/qorechain/pqc/v1/account/qor1...
{
"found": true,
"account": {
"address": "qor1...",
"public_key": "<base64 ML-DSA-87 public key>",
"algorithm_id": 1,
"algorithm_name": "dilithium5",
"ecdsa_pubkey": null,
"key_type": "hybrid",
"created_at_height": "209015",
"migration_public_key": null,
"migration_algorithm_id": 0,
"classical_key_source": "auth_account"
}
}
يوضّح classical_key_source مصدر ecdsa_pubkey: القيمة stored (المفتاح المُعطى عند التسجيل)، أو auth_account (لم يُخزَّن شيء، فهو المفتاح العام للحساب نفسه على السلسلة)، أو none. ومن v3.2.4 (على شبكة الاختبار منذ 19 أكتوبر 2026؛ وعلى الشبكة الرئيسية منذ 23 أكتوبر 2026) يحمل السجل أيضًا الحقل "possession_proven": false، وتصبح قيمته true متى سُجّل المفتاح مع إثبات حيازة جرى التحقق منه؛ أما العقدة على إصدار أقدم فلا تُبلغ عن هذا الحقل.
يُعيد الحساب الذي لا يملك مفتاحًا مسجَّلًا {"found": false, "account": null}. استخدم found لتقرير ما إذا كان على الحساب تسجيل مفتاح قبل أن يتمكن من الإرسال.
curl -s https://api.qore.host/qorechain/pqc/v1/evm_window/qor1...
{
"found": false,
"live": false,
"opened_height": "0",
"expiry_height": "0",
"max_txs": "0",
"used_txs": "0",
"max_value": "",
"used_value": "",
"remaining_blocks": "0",
"remaining_txs": "0",
"remaining_value": "",
"native_only": false,
"allowed_targets": []
}
لا يفشل هذا المسار أبدًا لعنوان بلا نافذة؛ بل يُعيد found: false. منذ v3.2.0 لا يقبل مسار EVM معاملةً إلا من حساب لديه مفتاح PQC مسجَّل ونافذة مفتوحة. تكون قيمة live هي true ما دامت النافذة تقبل معاملة واحدة إضافية على الأقل عند الارتفاع الحالي. تُظهر remaining_blocks وremaining_txs وremaining_value أيّ حدٍّ هو الأقرب إلى النفاد؛ والقيم أعداد صحيحة بوحدة uqor تُعاد على هيئة سلاسل نصية. ومنذ v3.2.3 يمكن أن تحمل النافذة نطاقًا: native_only (تحويلات QOR العادية فقط) وallowed_targets (المستلمون المدرجون فقط؛ يحدّ من العقود والرموز التي يجوز لمسها، لا من المقدار). انظر تطوير EVM لمعرفة كيف يعمل مسار EVM.
curl -s https://api.qore.host/qorechain/pqc/v1/evm_delegation_consent/qor1...
{
"found": false,
"live": false,
"delegate": "",
"granted_height": "0",
"expiry_height": "0",
"current_delegate": "",
"nonce": "0"
}
لا يسري تفويض EIP-7702 لحساب ما إلا بموافقة الحساب نفسه بمفتاح ما بعد الكم (MsgAuthorizeEVMDelegation). تُبلغ found وlive عن موافقة مسجَّلة ما زالت صالحة للاستخدام لصالح delegate؛ أما current_delegate فهو التفويض الذي ضبطه الحساب الآن، وnonce هو رقم تسلسل EVM الخاص به.
وحدة الجسر (Bridge Module)
تُعرض حالة القراءة فقط لوحدة الجسر عبر REST تحت /qorechain/bridge/v1/... (وتخدم بيانات JSON حقيقية على السلسلة منذ إصدار السلسلة v3.1.77). يُظهر إعداد config الخاص بالجسر مثلًا min_validators=10 وattestation_threshold=7.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/bridge/v1/config | إعدادات وحدة الجسر الحالية |
| GET | /qorechain/bridge/v1/chains | يسرد كل السلاسل المسجَّلة في الجسر |
| GET | /qorechain/bridge/v1/chains/{chain_id} | تفاصيل سلسلة مُجسَّرة محددة |
| GET | /qorechain/bridge/v1/validators | يسرد مدقّقي الجسر المسجَّلين |
| GET | /qorechain/bridge/v1/validators/{address} | تفاصيل مدقّق جسر محدد |
| GET | /qorechain/bridge/v1/operations | يسرد عمليات الجسر |
| GET | /qorechain/bridge/v1/operations/{id} | تفاصيل عملية جسر محددة |
curl -s https://api.qore.host/qorechain/bridge/v1/config
{
"config": {
"min_validators": 10,
"attestation_threshold": 7,
"challenge_period_secs": "86400",
"large_transfer_threshold": "100000000000",
"enabled": true
}
}
يُعيد chains/{chain_id} إدخالًا واحدًا مثل {"chain": {"chain_id": "ethereum", "name": "Ethereum", "chain_type": "evm", "bridge_contract": "0x000…0", "status": "pending", "min_confirmations": 12, ...}}.
تُبلغ جميع سلاسل الجسر المُهيَّأة وعددها 37 عن "status": "pending" على الشبكتين، وتكون validators وoperations قائمتين فارغتين. تعرض هذه المسارات إعدادات الوحدة؛ ولا تعني أنه يمكن تجسير الأصول اليوم. انظر معمارية الجسر.
وحدة الطبقات المتعددة (Multilayer)
تُعرض خدمة الاستعلام الكاملة لوحدة الطبقات المتعددة عبر REST تحت /qorechain/multilayer/v1/... (منذ إصدار السلسلة v3.1.80)، بما في ذلك استعلامَي قراءة مرساة الحالة: يُعيد anchor/{layer_id} أحدث مرساة تسوية لطبقة، ويُعيد anchors/{layer_id} سجل مراسيها التاريخي. تحمل كل مرساة توقيع ML-DSA-87 (Dilithium-5) فوق حقولها القانونية، بحيث يمكن للعميل جلب مرساة والتحقق منها بشكل مستقل — وهذا هو الأساس على السلسلة لـإيصالات التسوية الخاصة بحزمة تطوير التجميعات (Rollup Development Kit).
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/multilayer/v1/params | معاملات وحدة الطبقات المتعددة الحالية |
| GET | /qorechain/multilayer/v1/layers | يسرد كل الطبقات المسجَّلة |
| GET | /qorechain/multilayer/v1/layers/{layer_id} | تفاصيل طبقة محددة |
| GET | /qorechain/multilayer/v1/anchor/{layer_id} | أحدث مرساة حالة لطبقة |
| GET | /qorechain/multilayer/v1/anchors/{layer_id} | سجل مراسي الحالة لطبقة |
| GET | /qorechain/multilayer/v1/routing-stats | إحصاءات توجيه المعاملات عبر الطبقات |
يحتوي StateAnchorView على الحقول layer_id وlayer_height وstate_root وvalidator_set_hash وmain_chain_height وanchored_at وpqc_aggregate_signature وtransaction_count وcompressed_state_proof. ومنذ v3.2.2 تكون الرسالة الموقَّعة هي رسالة المرساة v2: وسم النطاق qorechain-multilayer-anchor-v2، ثم معرّف السلسلة ومعرّف الطبقة وارتفاع الطبقة وجذر الحالة وتجزئة مجموعة المدقّقين وعدد المعاملات وإثبات الحالة المضغوط، ويُسبق كل حقل متغيّر الطول بطوله في 8 بايتات بترتيب big-endian (لم تكن الرسالة v1 السابقة تتضمن معرّف السلسلة ولا بادئات الطول، لذا كان التوقيع صالحًا على كل سلسلة). ويتم التحقق منها مقابل مفتاح PQC المسجَّل لمُنشئ الطبقة. يطبع qorechaind query rdk anchor-sign-bytes البايتات الخاصة بدفعة rollup. تُعيد طبقة بلا مرساة HTTP 404 (no anchor for layer ...) من anchor/{layer_id} وقائمة فارغة ({"anchors": []}) من anchors/{layer_id}.
curl -s https://api.qore.host/qorechain/multilayer/v1/params
{
"params": {
"max_sidechains": "10",
"max_paychains": "50",
"min_anchor_interval": "100",
"max_anchor_interval": "1000",
"default_challenge_period": "86400",
"min_sidechain_stake": "1000000000",
"min_paychain_stake": "100000000",
"routing_enabled": true,
"routing_confidence_threshold": "0.6",
"cross_layer_fee_bundling": true
}
}
وقت كتابة هذا، تكون layers قائمة فارغة على الشبكتين. المثال هو استجابة الشبكة الرئيسية؛ وعلى شبكة الاختبار تكون max_sidechains هي 64 (رُفعت بمقترح الحوكمة 16، الذي أُقرّ في 25 أكتوبر 2026، لفعالية المطوّرين).
وحدة الحرق (Burn)
تُعرض حالة القراءة فقط لوحدة الحرق عبر REST تحت /qorechain/burn/v1/.... تتضمن معاملات params الخاصة بالحرق مثلًا gas_burn_rate=0.30.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/burn/v1/params | معاملات وحدة الحرق الحالية |
| GET | /qorechain/burn/v1/stats | إجمالي الحرق التراكمي موزَّعًا حسب المصدر |
| GET | /qorechain/burn/v1/records | يسرد سجلات الحرق الأخيرة |
| GET | /qorechain/burn/v1/milestone | تقدم معلَم الحرق (العدد التراكمي للمعاملات) |
| GET | /qorechain/burn/v1/stranded_rewards | حصة المُوثِّقين (stakers) التي خُصّصت جانبًا ولم تُفرِج عنها الحوكمة بعد |
curl -s https://api.qore.host/qorechain/burn/v1/stats
{
"stats": {
"total_burned": "31574710367921",
"burns_by_source": {
"gas_fee": "31574710282421",
"failed_tx": "85500",
"milestone": "0",
"amm": "0",
"xqore_penalty": "0"
},
"last_burn_height": "3666968"
}
}
تسرد الاستجابة الحقيقية كل مصدر حرق (ai_service وamm وauto_buyback وbridge_fee وcontract_create وfailed_tx وgas_fee وmilestone وrollup_create وtge وtreasury_buyback وxqore_penalty، ومن v3.2.4 أيضًا staking_tier_penalty، وهي عقوبة الفتح المبكر لقفل مستوى الرهن، وتُحرق)؛ والمثال مقتطع. المبالغ بوحدة uqor. تكون قيمة failed_tx غير صفرية منذ ترقية v3.2.2، حين بدأ حرق المعاملات الفاشلة يُطبَّق على الرسوم المحتسبة فعليًا. ومنذ v3.2.3 تُقتطع سجلات records القديمة لكل عملية حرق، لذا فإن records نافذة حديثة لا السجل الكامل؛ أما الإجماليات في stats فهي تراكمية.
curl -s https://api.qore.host/qorechain/burn/v1/stranded_rewards
{ "reserved": "0", "released": "10500542706858", "initialized": true, "snapshot_height": "2981742" }
reserved هو ما تبقّى للإفراج عنه، وreleased هو ما نقلته الحوكمة بالفعل، وsnapshot_height هو ارتفاع ترقية v3.2.0 التي سجّلت الاحتياطي. القيم أعلاه هي القيم المقروءة في 23 أكتوبر 2026: أفرجت الحوكمة عن المبلغ الأول (6,693,045.921330 QOR) في 19 أكتوبر 2026، وأعادت ترقية v3.2.3 حساب الاحتياطي المتبقي عند ارتفاعها (3,807,496.785528 QOR)، وأفرج مقترح الحوكمة 12 عن ذلك المبلغ (أُقرّ، وانتهى التصويت في 21 أكتوبر 2026)، فأصبح الاحتياطي الآن فارغًا وبلغ مجموع released ما قدره 10,500,542.706858 QOR. اقرأ القيم الحيّة. انظر الاقتصاد الرمزي (Tokenomics).
وحدة الحساب المجرَّد (Abstract Account)
تُعرض خدمة استعلام الحساب المجرَّد عبر REST تحت /qorechain/abstractaccount/v1/... (منذ إصدار السلسلة v3.1.85)، بما في ذلك مخطط الأذونات المستخدَم للتحقق من نطاقات موثِّق الهوية (authenticator) دون ترميزها يدويًا.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/abstractaccount/v1/config | إعدادات الوحدة (مسبار الميزة: enabled) |
| GET | /qorechain/abstractaccount/v1/accounts | يسرد الحسابات المجرَّدة |
| GET | /qorechain/abstractaccount/v1/accounts/{address} | حالة الحساب المجرَّد لعنوان (404 إن لم يوجد) |
| GET | /qorechain/abstractaccount/v1/permission_schema | schema_version وpermissions وmsg_permissions وkey_management_msgs وlane_rules |
| GET | /qorechain/abstractaccount/v1/auth_nonce/{address}/{pubkey_hex} | v3.2.4 (شبكة الاختبار منذ 19 أكتوبر 2026؛ الشبكة الرئيسية منذ 23 أكتوبر 2026؛ و501 على عقدة أقدم). التسلسل الذي يجب أن يوقّعه مفتاح الموثِّق المرتبط تاليًا (nonce وlinked) |
curl -s https://api.qore.host/qorechain/abstractaccount/v1/config
{ "config": { "enabled": false, "max_session_keys": 10, "max_spending_rules": 5, "default_session_ttl": "86400" } }
المثال أعلاه هو استجابة الشبكة الرئيسية: قيمة enabled هي false هناك (وaccounts قائمة فارغة)، لذا فإن ميزات الحساب المجرَّد مثل الإنفاق من المحافظ المرتبطة غير متاحة على الشبكة الرئيسية. أما على شبكة الاختبار فقيمة enabled هي true منذ مقترح الحوكمة 18 (الذي أُقرّ في 27 أكتوبر 2026)، وتسرد accounts الحسابات المُنشأة حتى الآن (جرى التحقق في 27 أكتوبر 2026). استخدم config.enabled كمسبار للميزة قبل الاعتماد على هذه الوحدة. انظر تجريد الحساب.
وحدة AMM
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/amm/v1/params | معاملات AMM الحالية (الرسوم بالنقاط الأساسية، والحدود) |
| GET | /qorechain/amm/v1/pools | يسرد المجمّعات (pools) |
| GET | /qorechain/amm/v1/pools/{pool_id} | مجمّع واحد (404 إن كان غير معروف) |
| GET | /qorechain/amm/v1/pools/{pool_id}/lp/{address} | رصيد رمز LP لعنوان في مجمّع |
| GET | /qorechain/amm/v1/pool_by_denoms?denom_a=&denom_b= | يجد المجمّع الخاص بزوج من الفئات (denoms) (404 إن لم يوجد) |
| GET | /qorechain/amm/v1/quote/exact_in?pool_id=&denom_in=&amount_in= | عرض سعر: المخرَج مقابل مُدخَل محدد بدقة |
| GET | /qorechain/amm/v1/quote/exact_out?pool_id=&denom_out=&amount_out= | عرض سعر: المُدخَل اللازم لمخرَج محدد بدقة |
curl -s https://api.qore.host/qorechain/amm/v1/params
{
"params": {
"swap_fee_bps": 30,
"protocol_fee_bps": 10,
"min_liquidity": "1000",
"max_pools_per_creator": 50,
"lp_token_decimals": 6,
"pool_creation_fee": "100000000",
"max_swap_impact_bps": 500,
"enabled": true
}
}
تردّ جميع مسارات AMM السبعة على الشبكتين (جرى التحقق في 27 أكتوبر 2026). وقت كتابة هذا لا توجد مجمّعات على أيٍّ من الشبكتين ({"pools": []}). وهذه هي الردود على مُدخلات لا تطابق شيئًا: يُعيد pools/{pool_id} بمعرّف غير معروف HTTP 404 ({"code":5,"message":"pool 1 not found"})؛ ويُعيد pool_by_denoms عند عدم وجود مجمّع للزوج 404 (no pool for uqor/foo)؛ ويُعيد عرض السعر لمجمّع غير معروف HTTP 400 مع {"code":3,"message":"pool not found"}؛ ويُعيد pools/{pool_id}/lp/{address} القيمة {"balance":"0"} لعنوان لا يملك مركز LP (ويجب أن يكون العنوان عنوان bech32 صالحًا من النوع qor1، وإلا 400). وتقرأ مساران لعرض السعر ومسار pool_by_denoms مُدخلاتها من سلسلة الاستعلام، لذا فهي تحتاج إلى معاملات: وبدون amount_in / amount_out تردّ بـ 400 (invalid amount_in / invalid amount_out).
على شبكة الاختبار تتوفر الفئة الثانية التي يحتاجها المجمّع: ثلاثة رموز اختبار سجّلتها الحوكمة، انظر رموز الاختبار على شبكة الاختبار (Fest). ولا يوجد ما يعادلها على الشبكة الرئيسية، التي فئتها المصرفية الوحيدة هي uqor.
وحدة الترخيص (Licence)
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/license/v1/check/{grantee}/{feature_id} | هل يحمل grantee منحة نشطة للميزة (404 إن لم توجد) |
| GET | /qorechain/license/v1/holders/{feature_id} | كل المنح الخاصة بميزة |
| GET | /qorechain/license/v1/list/{grantee} | كل المنح التي يحملها عنوان |
للمنحة (LicenseView) الحقول grantee وfeature_id وexpires_at وgranted_at وgranted_by وsuspended وmetadata. ويُعيد check أيضًا active. يُعيد استعلام القائمة أو الحاملين بلا نتائج {"licenses": []}؛ ويُعيد check لعنوان بلا منحة HTTP 404 مع {"code":5,"message":"no license for <grantee>/<feature_id>"}.
curl -s https://api.qore.host/qorechain/license/v1/holders/lightnode_operator
{
"licenses": [
{
"grantee": "qor1...",
"feature_id": "lightnode_operator",
"expires_at": "0",
"granted_at": "3536305",
"granted_by": "qor1...",
"suspended": false,
"metadata": "",
"active": true
}
]
}
تعني القيمة expires_at: "0" أن المنحة لا تنتهي صلاحيتها. ومنذ v3.2.3 يمكن للحوكمة استبدال جهة الترخيص التي تمنح هذه التراخيص (MsgUpdateAuthority)؛ وتبقى المنح التي مُنحت بالفعل قائمة.
وحدة العقدة الخفيفة (Light Node)
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/lightnode/v1/params | معاملات التسجيل ونبضات الحياة (heartbeat) والمكافآت |
| GET | /qorechain/lightnode/v1/stats | total_registered وtotal_active وtotal_rewards وlast_reward_height |
| GET | /qorechain/lightnode/v1/nodes | يسرد العقد الخفيفة المسجَّلة |
| GET | /qorechain/lightnode/v1/node/{address} | عقدة واحدة ({"node": null, "found": false} إن لم تكن مسجَّلة) |
| GET | /qorechain/lightnode/v1/rewards/{address} | المكافآت المتراكمة لعنوان مشغّل (accumulated_rewards) |
| GET | /qorechain/lightnode/v1/reward_pool | محاسبة مجمّع المكافآت (balance وreserved وoutstanding وpayable وdistributable وmax_reward_per_block_per_node وmax_reward_per_month_per_node وinitialized) |
curl -s https://api.qore.host/qorechain/lightnode/v1/params
{
"registration_fee": "1000000",
"heartbeat_interval": "1000",
"min_delegated_stake": "1000000000",
"reward_share": "0.030000000000000000",
"min_uptime_for_rewards": "0.800000000000000000",
"max_light_nodes": "10000",
"heartbeat_grace_period": "100"
}
curl -s https://api.qore.host/qorechain/lightnode/v1/reward_pool
{
"balance": "5645408555",
"reserved": "5645276228",
"outstanding": "130077",
"payable": "0",
"max_reward_per_block_per_node": "1713",
"distributable": "2250",
"initialized": true,
"max_reward_per_month_per_node": "2000000000",
"monthly_cap_active": true,
"last_distribution_time": "1792775155",
"last_distribution_height": "3744000"
}
reserved هو الجزء من المجمّع المحجوز والذي لا يمكن نقله إلا بتصويت حوكمة. والحدود لكل عقدة بوحدة uqor: max_reward_per_block_per_node هو السقف لكل كتلة، ومنذ v3.2.3 يمثّل max_reward_per_month_per_node (2000000000 uqor = 2,000 QOR لكل 30 يومًا) السقف الشهري، ويُحتسب بالتناسب مع زمن الكتلة ونسبة التشغيل (uptime) فلا يعود يعتمد على سرعة توليد الكتل. السقف ليس مبلغًا موعودًا. المثال هو الاستجابة الحيّة للشبكة الرئيسية المقروءة في 23 أكتوبر 2026، بعد أن أفرجت الحوكمة عن الاحتياطي السابق (المقترح 8، 19 أكتوبر 2026). ومن v3.2.4 (على شبكة الاختبار منذ 19 أكتوبر 2026؛ وعلى الشبكة الرئيسية منذ 23 أكتوبر 2026) تتضمن الاستجابة أيضًا monthly_cap_active وlast_distribution_time وlast_distribution_height، ويبدأ حدّ العقدة من تسجيلها هي.
ترفض السلسلة تسجيل عقدة خفيفة بدون منحة ترخيص lightnode_operator نشطة (يسرد holders/lightnode_operator المنح). في 27 أكتوبر 2026 تُبلغ stats عن "total_registered": "1" على كلٍّ من الشبكة الرئيسية وشبكة الاختبار. انظر العقد الخفيفة لمعرفة حالة البرنامج.
وحدة RDK
تُعرض خدمة استعلام حزمة تطوير التجميعات (Rollup Development Kit) عبر REST تحت /qorechain/rdk/v1/... (منذ إصدار السلسلة v3.2.2؛ وكانت في v3.2.0 وv3.2.1 عبر gRPC فقط).
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/rdk/v1/params | معاملات الوحدة |
| GET | /qorechain/rdk/v1/rollups | يسرد الـ rollups |
| GET | /qorechain/rdk/v1/rollup/{rollup_id} | rollup واحد (404 إن كان غير معروف) |
| GET | /qorechain/rdk/v1/latest_batch/{rollup_id} | أحدث دفعة تسوية للـ rollup |
| GET | /qorechain/rdk/v1/batch/{rollup_id}/{batch_index} | دفعة تسوية واحدة |
| GET | /qorechain/rdk/v1/batches/{rollup_id} | دفعات الـ rollup بترتيب الفهرس (مع ترقيم الصفحات) |
| GET | /qorechain/rdk/v1/blob/{rollup_id}/{blob_index} | سجل blob واحد لتوفّر البيانات |
curl -s https://api.qore.host/qorechain/rdk/v1/params
{
"params": {
"max_rollups": 100,
"min_stake_for_rollup": "10000000000",
"rollup_creation_burn_rate": "0.01",
"default_challenge_window": "604800",
"max_da_blob_size": "2097152",
"blob_retention_blocks": "432000",
"max_batches_per_block": 10
}
}
وقت كتابة هذا تكون rollups قائمة فارغة على الشبكتين، لذا تردّ المسارات الخاصة بكل rollup بـ 404 (مثلًا {"code":5,"message":"rollup foo not found"}). وتُعبَّر default_challenge_window بالثواني (604800). ومن v3.2.4 تُقاس نافذة التحدّي التفاؤلية لدفعة مُقدَّمة حديثًا بزمن الكتلة: على شبكة الاختبار منذ الارتفاع 8,337,253 (19 أكتوبر 2026)، وعلى الشبكة الرئيسية منذ الارتفاع 3,742,566 (23 أكتوبر 2026). وقبل الترقية كانت السلسلة تحوّل قيمة الثواني إلى كتل بمعدل ثابت قدره 6 ثوانٍ لكل كتلة. وعلى شبكة الاختبار ضبط مقترح الحوكمة 17 (الذي أُقرّ في 27 أكتوبر 2026) القيمة default_challenge_window على 3600 (ساعة واحدة) والقيمة max_rollups على 200 لفعالية المطوّرين، لذا يختلف المثال أعلاه (الشبكة الرئيسية) عن شبكة الاختبار في ذلك؛ وما زالت rollups فارغة على شبكة الاختبار وقت كتابة هذا.
v3.2.7 (شبكة الاختبار منذ 6 نوفمبر 2026؛ وبوابة rdk-zk-verification-key مفعَّلة للشبكة الرئيسية منذ 12 نوفمبر 2026): يمكن لـ ZK rollup تسجيل مفتاح التحقق الخاص به بالرسالة MsgSetVerificationKey (وتغييره لاحقًا بالرسالة MsgUpdateVerificationKey)، وتُرفض دفعة ZK لـ rollup لا مفتاح له قبل دفع الرسوم. هذه رسائل لا استعلامات: لا يوجد مسار REST يقرأ مفتاحًا مسجَّلًا (ردّت المسارات البديهية بالرمز 501 في 7 نوفمبر 2026)، ولا يوجد ZK rollup مسجَّل على شبكة الاختبار (rollups فارغة؛ ولم يكن على الشبكة الرئيسية أي rollup أيضًا عند آخر فحص في 4 نوفمبر 2026)، لذا لم يُجرَّب التسجيل من البداية إلى النهاية هنا. انظر سجل الإصدارات.
وحدة التضخم (Inflation)
تُعرض إعدادات الإصدار وتقدّمه عبر REST تحت /qorechain/inflation/v1/... (منذ إصدار السلسلة v3.2.2). وهي غير متاحة عبر أي أمر في CLI.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/inflation/v1/params | معاملات الإصدار: emission_mode وfixed_epoch_emission وmax_total_emission وepoch_length وenabled |
| GET | /qorechain/inflation/v1/epoch_info | التقدّم: current_epoch وblock_start وnext_epoch_height وtotal_minted وmax_total_emission وremaining_emission |
curl -s https://api.qore.host/qorechain/inflation/v1/params
curl -s https://api.qore.host/qorechain/inflation/v1/epoch_info
على الشبكة الرئيسية تكون emission_mode هي "fixed"، وقيمة fixed_epoch_emission هي "86000000000" (86,000 QOR لكل حقبة)، وقيمة epoch_length هي "43200" كتلة، وقيمة max_total_emission هي "590000000000000" (590,000,000 QOR، السقف التراكمي). وقد ضُبطت هذه القيم بمقترح الحوكمة 10 (الذي أُقرّ في 19 أكتوبر 2026)؛ وتبدأ أول حقبة تستخدم المبلغ الثابت الجديد عند الكتلة 3,672,000، ويُظهر epoch_info الحقبة الجارية والمبلغ المُصدَر حتى الآن. أما قائمة schedule في الاستجابة فتعود إلى نمط schedule الأصلي؛ ولا تصف ما تُصدره حقبة في النمط الثابت. جميع المبالغ بوحدة uqor. وتُبلغ شبكة الاختبار عن قيمها الخاصة المختلفة. ومن v3.2.4 يوجد نمط ثالث هو target_apy، مع الحقل target_apy_bps (على شبكة الاختبار منذ 19 أكتوبر 2026؛ وعلى الشبكة الرئيسية منذ 23 أكتوبر 2026). ولا تنتقل الشبكة إلى هذا النمط إلا بتصويت حوكمة خاص بها، لذا تبقى الشبكة الرئيسية على fixed إلى أن يُقرّ تصويت كهذا (جرى التحقق في 27 أكتوبر 2026: ما زالت fixed). وانتقلت شبكة الاختبار إلى target_apy عبر حوكمتها الخاصة (المقترح 14، الذي أُقرّ في 20 أكتوبر 2026) وتُبلغ وقت كتابة هذا عن "emission_mode": "target_apy"، ويُظهر epoch_info أن السقف التراكمي قد بُلغ بالفعل (remaining_emission هي 0).
وحدة تجريد الغاز (Gas Abstraction)
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/gasabstraction/v1/config | رموز الرسوم المقبولة، والعلاوة، وسقف التحويل لكل كتلة |
| GET | /qorechain/gasabstraction/v1/conversion_rate?denom= | كم تساوي وحدة واحدة من رمز رسوم بوحدة uqor، وهل هو usable (صالح للاستخدام) |
| GET | /qorechain/gasabstraction/v1/float | عنوان رصيد التحويل (float) وأرصدته واستخدامه في هذه الكتلة |
curl -s https://api.qore.host/qorechain/gasabstraction/v1/config
{
"config": {
"enabled": true,
"native_denom": "uqor",
"accepted_tokens": [
{ "denom": "uqor", "conversion_rate": "1.0", "price_source": "", "rate_expiry_height": "0",
"pool_id": "0", "min_liquidity": "", "max_deviation_bps": 0 }
],
"premium_bps": 300,
"max_tip_multiplier": 3,
"float_min": "0",
"block_conversion_cap": "0"
}
}
تحتوي قائمة الرموز المقبولة على uqor الأصلي فقط على الشبكتين، لذا تُدفع الرسوم بـ uqor ولا يجري أي تحويل. تضيف الحوكمة رمزًا (مع مجمّع، وحدٍّ أدنى للسيولة، وأقصى انحراف بين السعر المرجَّح زمنيًا والسعر الفوري)؛ وتُحوَّل الرسوم المدفوعة بمثل هذا الرمز عبر رصيد تحويل (float) من QOR ويُعاد ملؤه عبر مجمّع AMM. وتردّ conversion_rate بدون ?denom= بالرمز 500 (denom is required).
وحدة إجماع التعلّم المعزَّز (RL Consensus) (v3.2.6)
وصلت بوابة REST لوحدة rlconsensus مع v3.2.6، التي طبّقتها شبكة الاختبار qorechain-diana عند الارتفاع 8,970,638 في 27 أكتوبر 2026 والشبكة الرئيسية عند الارتفاع 4,020,000 في 4 نوفمبر 2026. وفي 4 نوفمبر 2026 ردّت المسارات السبعة أدناه كلها بـ HTTP 200 على مضيف الشبكة الرئيسية العام وعلى شبكة الاختبار على حد سواء؛ ولا يحتاج أيٌّ منها إلى معامل. وقبل v3.2.6 كانت تردّ بـ 501 ({"code":12,"message":"Not Implemented"}) وكان الوصول إلى الوحدة عبر gRPC فقط.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/rlconsensus/v1/agent | حالة الوكيل: mode وcurrent_epoch وtotal_steps وlast_observation_at وlast_action_at وcircuit_breaker_active وblocks_since_revert |
| GET | /qorechain/rlconsensus/v1/params | معاملات الوحدة: فترة المراقبة، ووضع الوكيل، وحدود الخطوات، ونافذة قاطع الدائرة وعتبته، وأوزان المكافأة، وزمن الكتلة الافتراضي، وسعر الغاز، وحجم مجموعة المدقّقين |
| GET | /qorechain/rlconsensus/v1/observation | أحدث متجه مراقبة (height و25 قيمة في values) |
| GET | /qorechain/rlconsensus/v1/reward | أحدث إشارة مكافأة ومكوّناتها |
| GET | /qorechain/rlconsensus/v1/policy | شبكة السياسة المخزَّنة: epoch وupdated_at وweight_count (لا تُعاد الأوزان نفسها) |
| GET | /qorechain/rlconsensus/v1/applied_params | القيم التي يحتفظ بها الوكيل بوصفها مطبَّقة: block_time_ms وgas_limit وgas_price_floor وpool_weight_rpos وpool_weight_dpos |
| GET | /qorechain/rlconsensus/v1/last_action | الإجراء الذي اقترحه الوكيل في خطوته الأخيرة: height وmode وخمس قيم في values وapplied |
curl -s https://api-testnet.qore.host/qorechain/rlconsensus/v1/agent
curl -s https://api-testnet.qore.host/qorechain/rlconsensus/v1/last_action
{ "mode": "shadow", "current_epoch": "1", "total_steps": "209", "last_observation_at": "8975660",
"last_action_at": "8975660", "circuit_breaker_active": false, "blocks_since_revert": "0" }
{ "height": "8975660", "mode": "shadow", "values": ["-0.334711810000000000", "-0.500000000000000000",
"0.000000000000000000", "0.000000000000000000", "0.000000000000000000"], "applied": false }
العيّنات أعلاه من شبكة الاختبار. وعلى الشبكة الرئيسية (جرى التحقق في 4 نوفمبر 2026) الوكيل في وضع conservative مع current_epoch بقيمة 0 وtotal_steps بقيمة 0 وcircuit_breaker_active بقيمة false، وتُبلغ policy عن weight_count بقيمة 0 (لا سياسة مخزَّنة)، وlast_action فارغة (height هي 0 وapplied هي false)، وتحتوي applied_params على القيم الافتراضية. يتخذ الوكيل خطوة واحدة كل observation_interval من الكتل (10). وفي وضع shadow يحسب إجراءً ويسجّله دون تطبيق أي شيء، لذا تكون applied هي false وتبقى applied_params على قيمها الافتراضية (block_time_ms هي 5000، وgas_price_floor هي 100، وأوزان المجمّعات 0.40 و0.35). وعلى شبكة الاختبار بدأ تشغيل الوكيل في وضع Shadow مع سياسة مخزَّنة بمقترح الحوكمة 29 (الذي أُقرّ في 27 أكتوبر 2026)؛ وقيمة circuit_breaker_active هي false. ولم تبدأ الشبكة الرئيسية تشغيل الوكيل. المبالغ والقيم سلاسل نصية. والقيم المطبَّقة معلوماتية في هذا الإصدار: القارئ الوحيد على السلسلة هو المعالِج المسبق rlConsensusParams للقراءة فقط. وطرق gRPC المقابلة هي AgentStatus وParams وObservation وReward وPolicy وAppliedParams وLastAction (الخدمة qorechain.rlconsensus.v1.Query)، وأوامر CLI موجودة في أوامر الاستعلام.
وحدة مستويات الرهن (v3.2.4)
وحدة مستويات الرهن جزء من v3.2.4. تخدم شبكة الاختبار هذه المسارات منذ 19 أكتوبر 2026، وتخدمها الشبكة الرئيسية منذ 23 أكتوبر 2026 (مقترح الحوكمة 13، الارتفاع 3,742,566). وتردّ عليها العقدة التي على إصدار أقدم بـ 501.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/stakingtier/v1/params | مستويات القفل، والحد الأدنى لمبلغ القفل، وغرامة فك القفل المبكر |
| GET | /qorechain/stakingtier/v1/locks/{holder} | أقفال حامل، وما يستحقه كل قفل حاليًا، وما يمكن المطالبة به |
| GET | /qorechain/stakingtier/v1/pool | مجمّع المكافآت الإضافية: الرصيد، والمستحق، والفائض، وآخر تسوية |
| GET | /qorechain/stakingtier/v1/apr | v3.2.7 (شبكة الاختبار منذ 6 نوفمبر 2026، والشبكة الرئيسية منذ 12 نوفمبر 2026؛ و501 على عقدة أقدم). معدل الستيكينغ الأساسي ومكافآت المستويات |
| GET | /qorechain/stakingtier/v1/apr/{delegator} | v3.2.7 (التوفر نفسه). المعلومات نفسها لمفوِّض واحد: حالة مكافأة العقدة الخفيفة والتفويضات والمعدل الفعلي |
تسرد params أطوال القفل الثلاثة (3 و6 و12 شهرًا) مع معاملاتها وmin_lock_amount ("10000000" uqor، أي 10 QOR). تُجرى الأقفال بالأمر tx stakingtier lock (انظر أوامر المعاملات).
مسارات APR (v3.2.7). وفي 12 نوفمبر 2026 ردّ مسار الشبكة الرئيسية بالرمز 200 مع source بقيمة emission وbonus_enabled بقيمة true وmax_total_apy_bps بقيمة 2500، وردّ مسار المفوِّض بالرمز 400 لعنوان غير صالح. يعيد GET /qorechain/stakingtier/v1/apr الحقل base (gross_base_apr_bps وsource وcomputed_height وbonus_enabled وmax_total_apy_bps) وbase_apr_bps وقائمة tiers (لمدة 3 و6 و12 شهرًا: bonus_bps بقيم 150 و300 و500، مع القيم الفعلية) ومكافآت العقدة الخفيفة والمدقّق (light_node_bonus_bps 200 وvalidator_bonus_bps 300). وفي 7 نوفمبر 2026 كان المعدل الأساسي على شبكة الاختبار 0 (قيمة source هي fees_only)، فلم يكن غير صفري سوى مكافآت المستويات؛ ويعرض مسار المجمّع مجمّع المكافآت الإضافية. وبالنسبة إلى عنوان بلا تفويض يردّ مسار المفوِّض بالرمز 200 مع قائمة delegations فارغة ومعدل فعلي 0. كل رقم هو قراءة بالنقاط الأساسية (basis points) لما حسبته السلسلة عند آخر تسوية. وهو غير مضمون، ويتغيّر مع الرسوم والتمويل، وليس وعدًا بأي عائد.
وحدة السمعة
تظهر مسارات REST لوحدة السمعة مع سلسلة v3.2.6 وتخدمها الشبكتان (شبكة الاختبار منذ 27 أكتوبر 2026، والشبكة الرئيسية منذ 4 نوفمبر 2026). جرى التحقق على مضيف الشبكة الرئيسية العام في 4 نوفمبر 2026: ردّت /qorechain/reputation/v1/params و/validators و/validator/{address} كلها بـ 200. وقبل v3.2.6 كان كل مسار يردّ بـ HTTP 501 ({"code":12,"message":"Not Implemented"}) وكان الوصول إلى الوحدة عبر gRPC فقط.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/reputation/v1/params | أوزان الدرجة (alpha وbeta وgamma وdelta) وlambda وmin_score |
| GET | /qorechain/reputation/v1/validator/{address} | سجل مدقّق واحد. {address} هو عنوان مشغّل بصيغة qorvaloper1... أو عنوان إجماع بصيغة qorvalcons1.... تشمل الحقول composite_score وstake_score وperformance_score وcontribution_score وtime_score وuptime_blocks وmissed_blocks وlast_updated_height. يعني 404 أن المدقّق ليست له درجة بعد؛ وأي سلسلة ليست عنوان مشغّل ولا عنوان إجماع تردّ بـ 400 |
| GET | /qorechain/reputation/v1/validators | سجلات جميع المدقّقين الذين لهم درجات (reputations) |
الدرجات سلاسل عشرية بين 0 و1. تقرأ العقدة الخفيفة المسار الخاص بكل مدقّق لتحذّر عندما يكون مدقّق مفوَّض إليه أدنى من min_reputation (انظر المكافآت والمراقبة). وتعمل المسارات نفسها على المضيفين العامين.
هوية كتلة SVM (v3.2.7)
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
| GET | /qorechain/svm/v1/cluster_info | v3.2.7 (شبكة الاختبار منذ 6 نوفمبر 2026، والشبكة الرئيسية منذ 12 نوفمبر 2026؛ و501 على عقدة أقدم). هوية كتلة SVM: chain_id وgenesis_hash وcaip2_chain_id (معرّف سلسلة Wallet Standard) وderivation وexecution_enabled |
في 7 نوفمبر 2026 ردّت شبكة الاختبار بالقيم genesis_hash 6Z9pa53SwiprqiAoNCqqUdj5c3C4P1zRw31gQVnF4Czj وcaip2_chain_id solana:6Z9pa53SwiprqiAoNCqqUdj5c3C4P1zR وexecution_enabled false. يُشتق genesis hash من معرّف السلسلة (SHA-256 لوسم ثابت ومعرّف السلسلة، بترميز base58)، لذا فهو ثابت. والقيم نفسها موجودة في getGenesisHash وgetVersion من SVM JSON-RPC (انظر JSON-RPC المتوافق مع Solana). يبقى SVM متوقفًا: قيمة execution_enabled هي false. وفي 12 نوفمبر 2026 ردّت الشبكة الرئيسية بالرمز 200 مع chain_id بقيمة qorechain-vladi وgenesis_hash 4LQ9znKk8J3C8YBz2unNdqRCC35ZXvSiFN9YGJNwu3er وcaip2_chain_id solana:4LQ9znKk8J3C8YBz2unNdqRCC35ZXvSi وexecution_enabled false؛ ومسار SVM ما زال متوقفًا على الشبكة الرئيسية.
وحدات gRPC فقط
على الشبكة الرئيسية (إصدار العقدة v3.2.7 منذ 12 نوفمبر 2026؛ وقد جرى التحقق من قائمة الوحدات في 4 نوفمبر 2026 على v3.2.6، باستثناء صف svm) لهذه الوحدات خدمة gRPC من نوع Query لكن بلا مسار REST، باستثناء ما ورد في الجدول. تتبع أسماء الخدمات الصيغة qorechain.<module>.v1.Query.
| الوحدة | طرق استعلام gRPC (الشبكة الرئيسية، إصدار السلسلة v3.2.7) |
|---|---|
ai | Config, Stats |
crossvm | PendingMessages (عبر REST منذ v3.2.5: Params على /qorechain/crossvm/v1/params وMessage على /qorechain/crossvm/v1/message/{id}) |
reputation | Params (عبر REST أيضًا منذ v3.2.6، انظر وحدة السمعة) |
rlconsensus | AgentStatus, Params, Observation, Reward, Policy, AppliedParams, LastAction (عبر REST أيضًا منذ v3.2.6) |
svm | Slot, Account, Program (يضيف v3.2.7 الطريقة ClusterInfo على الشبكتين، وهي متاحة أيضًا عبر REST، انظر هوية كتلة SVM) |
qca | Config |
تُخدَّم استعلامات rlconsensus عبر REST على الشبكتين من v3.2.6 (مع طريقتين إضافيتين هما AppliedParams وLastAction)؛ انظر وحدة إجماع التعلّم المعزَّز (RL Consensus). استخدم grpcurl مقابل عقدتك الخاصة، أو أوامر الاستعلام في CLI. واستعلامات rdk متاحة أيضًا عبر REST (انظر وحدة RDK)؛ وكانت عبر gRPC فقط قبل v3.2.2.
لا تملك وحدات xQORE وإعادة الرهن بـ BTC (Babylon) وFairBlock أي خدمة استعلام في الإصدار الحالي على الإطلاق، لا عبر REST ولا عبر gRPC. أما وحدتا التضخم وتجريد الغاز، اللتان لم تكن لهما خدمة قبل v3.2.2، فتُخدَّمان عبر REST (انظر وحدة التضخم ووحدة تجريد الغاز).
المسارات القياسية
تُخدَّم أيضًا مسارات REST القياسية لـ Cosmos SDK وIBC وEVM وQoreChain Native. أمثلة تم التحقق منها على الشبكتين:
| نقطة النهاية | الوصف |
|---|---|
/cosmos/bank/v1beta1/supply | الإمداد الكلي |
/cosmos/bank/v1beta1/balances/{address} | أرصدة الحساب |
/cosmos/staking/v1beta1/validators | المدقّقون |
/cosmos/staking/v1beta1/params | معاملات الرهن |
/cosmos/distribution/v1beta1/params | معاملات التوزيع |
/cosmos/gov/v1/params/voting | معاملات الحوكمة |
/cosmos/slashing/v1beta1/params | معاملات المعاقبة (slashing) |
/cosmos/upgrade/v1beta1/current_plan, /applied_plan/{name} | الترقيات المعلَّقة / المطبَّقة (يُعيد applied_plan/v3.2.3 القيمة {"height":"3662051"} على الشبكة الرئيسية) |
/cosmos/circuit/v1/disable_list | أنواع الرسائل المعطَّلة على مستوى الشبكة |
/cosmos/base/node/v1beta1/config | الحد الأدنى لسعر الغاز في العقدة (0.1uqor على الشبكتين) |
/cosmos/base/tendermint/v1beta1/blocks/latest | أحدث كتلة |
/cosmos/tx/v1beta1/txs, /txs/{hash}, /txs/block/{height} | البحث عن المعاملات / الاستعلام عنها / حسب الكتلة |
/cosmos/evm/vm/v1/params | معاملات وحدة EVM |
/cosmos/evm/feemarket/v1/params | معاملات سوق رسوم EVM |
/cosmwasm/wasm/v1/codes/params | أذونات رفع/إنشاء نسخ QoreChain Native |
/ibc/apps/transfer/v1/params | معاملات تحويل IBC |
/ibc/core/client/v2/counterparty_info/{client_id} | v3.2.6. الطرف المقابل في IBC v2 المسجَّل لعميل (404 إن لم يوجد) |
/ibc/core/client/v2/config/{client_id} | v3.2.6. إعدادات عميل IBC v2 (allowed_relayers) |
/cosmos/evm/erc20/v1/token_pairs, /token_pairs/{token} | أزواج رموز ERC20 (شبكة الاختبار: رموز Fest التجريبية الثلاثة ورمز IBC واحد؛ الشبكة الرئيسية: لا شيء) |
بادئة QoreChain Native هي /cosmwasm/wasm/v1/...؛ أما /cosmos/wasm/v1/... فغير مخدَّمة.
مسارات عميل IBC v2 (v3.2.6)
كانت خدمة استعلام عميل IBC v2 مخدَّمة عبر gRPC من قبل، لكن مسارات REST الخاصة بها كانت مفقودة؛ ويركّبها v3.2.6. يقرأ المُرحِّل (relayer) الطرف المقابل لعميل من هنا. يأخذ كلا المسارين معرّف العميل في المسار (مثلًا 07-<type>-0)؛ ويردّ المعرّف الفارغ بـ 400. جرى التحقق على شبكة الاختبار في 27 أكتوبر 2026 وعلى الشبكة الرئيسية في 4 نوفمبر 2026:
| المسار | شبكة الاختبار | الشبكة الرئيسية (v3.2.6) |
|---|---|---|
/ibc/core/client/v2/counterparty_info/{client_id} | 200 مع الطرف المقابل، أو 404 (client 07-<type>-0 counterparty not found) لعميل لم يُسجَّل له طرف مقابل؛ ويردّ المعرّف الفارغ بـ 400 | بالأشكال نفسها: 404 (client 07-tendermint-0 counterparty not found) لعميل بلا طرف مقابل (ليس في الشبكة الرئيسية أي عميل IBC بعد) |
/ibc/core/client/v2/config/{client_id} | 200، {"config":{"allowed_relayers":[]}} (تعني القائمة الفارغة أي مُرحِّل) | 200، {"config":{"allowed_relayers":[]}} |
/ibc/core/channel/v2/clients/{client_id}/next_sequence_send و/packet_commitments ومسارات قنوات IBC v2 الأخرى | تردّ (404 عندما لا يُسجَّل شيء للعميل، و200 مع قائمة فارغة للالتزامات) | تردّ، بالأشكال نفسها (جرى التحقق في 4 نوفمبر 2026) |
تردّ مسارات IBC v1 (/ibc/core/client/v1/... و/ibc/core/channel/v1/...) على الشبكتين. وقت كتابة هذا تحتوي شبكة الاختبار على عميل IBC واحد وقناة تحويل مفتوحة واحدة (channel-0، مع رمز واحد مقوَّم بـ IBC)، وليس في الشبكة الرئيسية أي عميل IBC أو قناة أو رمز مقوَّم بـ IBC. وتردّ وحدة تحديد المعدل على /Stride-Labs/ibc-rate-limiting/ratelimit/ratelimits وقائمة المجاميع الاختبارية لـ 08-wasm على /ibc/lightclients/wasm/v1/checksums: وعلى الشبكتين تُعيد الأولى قائمة rate_limits فارغة (لا حدّ مضبوط) والثانية قائمة checksums فارغة. وقد ردّت الشبكة الرئيسية على كليهما بـ 200 في 4 نوفمبر 2026 (وقبل v3.2.6 كانت تردّ بـ 501). أما مسار استعلام إعادة توجيه الحزم /ibc/apps/packetforward/v1/params فقد ردّ بـ 501 على الشبكة الرئيسية؛ ولم يُعثر على مسار عام له، لذا لا يمكن قراءة إعداداته عبر REST هناك.
رموز الاختبار على شبكة الاختبار (Fest)
الرموز الثلاثة أدناه موجودة فقط على شبكة الاختبار qorechain-diana. وهي رموز اختبار للمطوّرين: لا قيمة لها، وليس في الشبكة الرئيسية أي زوج رموز ERC20 على الإطلاق (جرى التحقق في 27 أكتوبر 2026: token_pairs فارغة وإمداد المصرف يحتوي uqor فقط). سجّلتها الحوكمة بوصفها أزواج رموز ERC20 في 27 أكتوبر 2026 (المقترح 26).
على شبكة الاختبار يوجد الرمز المسجَّل من نوع ERC20 أيضًا كعملة مصرفية، فيمكن الاحتفاظ به وإرساله واستخدامه فئةً ثانية لـمجمّع AMM. الفئة المصرفية هي erc20: متبوعة بعنوان العقد بـصيغة المجموع الاختباري EIP-55 ذات الحالة المختلطة للأحرف، وسلسلة الفئة حساسة لحالة الأحرف: فالصيغة المكتوبة كلها بأحرف صغيرة سلسلة مختلفة ولا يُعثر عليها.
| الرمز | عنوان العقد | الفئة المصرفية | الخانات العشرية |
|---|---|---|---|
| fUSD (FestUSD) | 0x97143B771D34ddb9130b807b135Ae675A5a963CA | erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA | 6 |
| fETH (FestETH) | 0x02292293c13880a26242690eb70a0e42B8E91c28 | erc20:0x02292293c13880a26242690eb70a0e42B8E91c28 | 18 |
| fBTC (FestBTC) | 0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451A | erc20:0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451A | 8 |
# the three tokens and their display names / decimals
curl -s https://api-testnet.qore.host/cosmos/bank/v1beta1/denoms_metadata
# one denom: the case matters (this returns the metadata, the lowercase spelling returns 404)
curl -s "https://api-testnet.qore.host/cosmos/bank/v1beta1/denoms_metadata/erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA"
# the ERC20 token pairs, and the supply of one denom
curl -s https://api-testnet.qore.host/cosmos/evm/erc20/v1/token_pairs
curl -s "https://api-testnet.qore.host/cosmos/bank/v1beta1/supply/by_denom?denom=erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA"
تسرد denoms_metadata كل رمز مع symbol هي fUSD / fETH / fBTC وdisplay هي FestUSD / FestETH / FestBTC والخانات العشرية بوصفها أُسَّ وحدة العرض. ويُظهر استعلام الرصيد (/cosmos/bank/v1beta1/balances/{address}) الجزء المحوَّل من رصيد الحامل تحت الفئة erc20:...؛ أما الرموز التي ما زالت محفوظة في جانب EVM فتظهر في balanceOf الخاصة بعقد ERC20 نفسه. ويجري التحويل بين الشكلين بالرسالة MsgConvertERC20 (من EVM إلى المصرف) والرسالة MsgConvertCoin (من المصرف إلى EVM)؛ ويجب كتابة مُرسِل MsgConvertERC20 بعنوان bech32 من النوع qor1. انظر تطوير EVM.
استكشاف gRPC (Reflection)
تخدم العقدة التي تشغّلها بنفسك gRPC على المنفذ 9090. وحيثما يكون استكشاف الخادم (server reflection) مُفعَّلًا، يمكن لأدوات مثل grpcurl اكتشاف الخدمات المتاحة:
grpcurl -plaintext localhost:9090 list
للاستعلام عن خدمة محددة:
grpcurl -plaintext -d '{"address":"qor1..."}' localhost:9090 qorechain.pqc.v1.Query/Account
لدى qorechain.pqc.v1.Query ثلاث طرق على عقدة v3.2.3 هي Account وEVMWindow وEVMDelegationConsent، وطريقة رابعة من v3.2.4 (شبكة الاختبار منذ 19 أكتوبر 2026، والشبكة الرئيسية منذ 23 أكتوبر 2026) هي ProtocolFeatures. وتُضاف طريقة Params في v3.2.6 (شبكة الاختبار منذ 27 أكتوبر 2026، والشبكة الرئيسية منذ 4 نوفمبر 2026)؛ وليس لدى عقدة أقدم من v3.2.6 طريقة Params. ويضيف الإصدار v3.2.7 (على الشبكتين) مسارَي multisig والمستند النصي الموصوفين في تعدد التوقيع PQC والتوقيع النصي.
المصادقة
جميع نقاط REST وgRPC غير مُصادَق عليها افتراضيًا. للنشر في بيئة الإنتاج، ضع وكيلًا عكسيًا (مثل Nginx أو Caddy) أمام العقدة للتعامل مع إنهاء TLS والتحكم في الوصول.