توفّر QoreChain ثلاث واجهات أساسية للوصول البرمجي:
| الواجهة | المنفذ الافتراضي | البروتوكول | الوصف |
|---|
| REST | 1317 | HTTP/1.1 | واجهة LCD (Light Client Daemon) REST |
| gRPC | 9090 | HTTP/2 | خدمة gRPC مُرمّزة بـ Protobuf |
| RPC | 26657 | HTTP + WS | واجهة RPC لمحرّك إجماع QoreChain |
تُعيد جميع نقاط REST بيانات JSON. تستخدم نقاط gRPC صيغة Protocol Buffers ويمكن استهلاكها بأي عميل gRPC. توفّر واجهة RPC استعلامات على مستوى الإجماع وبثّ المعاملات.
هذه الواجهات متاحة على كلٍّ من شبكة qorechain-vladi الرئيسية (تعمل منذ 7 يونيو 2026 بإصدار السلسلة v3.1.97) وشبكة الاختبار qorechain-diana. تفترض عناوين URL الأساسية أدناه عقدة تعمل محليًا؛ نقاط النهاية العامة المستضافة (rpc/api/evm/svm.qore.host ونظيراتها بلاحقة -testnet) مُدرجة في الشبكات.
عناوين URL الأساسية
REST: http://localhost:1317
gRPC: localhost:9090
RPC: http://localhost:26657
وحدة الذكاء الاصطناعي (AI)
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /ai/v1/config | تُعيد إعدادات وحدة الذكاء الاصطناعي الحالية |
| GET | /ai/v1/stats | إحصاءات مُجمَّعة لمعالجة الذكاء الاصطناعي |
| GET | /ai/v1/fee-estimate | تقدير رسوم الغاز بمساعدة الذكاء الاصطناعي لمعاملة |
| GET | /ai/v1/fraud/investigations | يسرد كل تحقيقات الاحتيال النشطة |
| GET | /ai/v1/fraud/investigations/{id} | تفاصيل تحقيق احتيال محدد |
| GET | /ai/v1/network/recommendations | توصيات لتحسين الشبكة مُولَّدة بالذكاء الاصطناعي |
| GET | /ai/v1/circuit-breakers | حالات قواطع الدارة الحالية وعتباتها |
وحدة الجسر (Bridge Module)
اعتبارًا من إصدار السلسلة v3.1.77، أصبحت حالة القراءة فقط لوحدة الجسر مُتاحة عبر REST من خلال grpc-gateway ضمن البادئة /qorechain/bridge/v1/... (كانت مقتصرة على gRPC سابقًا). تُقدّم هذه النقاط بيانات JSON حقيقية على السلسلة عبر HTTP للمستكشفات وقياس عن بُعد للعقد الخفيفة. يُظهر إعداد config الخاص بالجسر مثلًا min_validators=10 و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} | تفاصيل عملية جسر محددة |
تبقى نقاط النهاية الأقصر التالية متاحة:
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /bridge/v1/chains | يسرد كل السلاسل المسجَّلة في الجسر |
| GET | /bridge/v1/chains/{id} | تفاصيل سلسلة مُجسَّرة محددة |
| GET | /bridge/v1/validators | يسرد مدقّقي الجسر النشطين |
| GET | /bridge/v1/operations | يسرد عمليات الجسر الأخيرة |
| GET | /bridge/v1/operations/{id} | تفاصيل عملية جسر محددة |
| GET | /bridge/v1/locked/{chain}/{asset} | إجمالي القيمة المقفلة لزوج سلسلة/أصل |
| GET | /bridge/v1/limits/{chain} | حدود المعدل والعتبات لسلسلة مُجسَّرة |
| GET | /bridge/v1/estimate | يقدّر رسوم الجسر ووقت النقل |
وحدة PQC
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /pqc/v1/params | معاملات وحدة PQC الحالية |
| GET | /pqc/v1/accounts/{address} | حالة مفتاح PQC لحساب محدد |
| GET | /pqc/v1/stats | إحصاءات إجمالية لتسجيل وترحيل PQC |
وحدة السمعة (Reputation)
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /reputation/v1/validators | درجات سمعة جميع المدقّقين |
| GET | /reputation/v1/validators/{address} | درجة سمعة مدقّق محدد |
وحدة Cross-VM
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /crossvm/v1/message/{id} | يسترجع رسالة Cross-VM بواسطة المعرّف |
| GET | /crossvm/v1/pending | يسرد رسائل Cross-VM المعلَّقة في الطابور |
| GET | /crossvm/v1/params | معاملات وحدة Cross-VM الحالية |
وحدة الطبقات المتعددة (Multilayer)
اعتبارًا من إصدار السلسلة v3.1.80، أصبحت خدمة الاستعلام الكاملة لوحدة الطبقات المتعددة مُتاحة عبر REST من خلال grpc-gateway ضمن البادئة /qorechain/multilayer/v1/... (كانت مقتصرة على gRPC سابقًا)، بما في ذلك استعلامَي قراءة مرساة الحالة: يُعيد 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. الرسالة القانونية الموقَّعة هي layer_id || layer_height || state_root || validator_set_hash، ويتم التحقق منها مقابل مفتاح PQC المسجَّل لمُنشئ الطبقة.
تبقى نقاط النهاية الأقصر التالية متاحة:
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /multilayer/v1/layer/{id} | تفاصيل طبقة محددة |
| GET | /multilayer/v1/layers | يسرد كل الطبقات المسجَّلة |
| GET | /multilayer/v1/anchor/{id} | تفاصيل سجل مرساة محدد |
| GET | /multilayer/v1/anchors | يسرد آخر عمليات إرسال المراسي |
| GET | /multilayer/v1/routing-stats | إحصاءات توجيه المعاملات عبر الطبقات |
| GET | /multilayer/v1/params | معاملات وحدة الطبقات المتعددة الحالية |
وحدة SVM
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /svm/v1/params | معاملات وحدة SVM الحالية |
| GET | /svm/v1/account/{address} | معلومات حساب SVM لعنوان معين |
| GET | /svm/v1/program/{address} | معلومات البرنامج المنشور لعنوان برنامج معين |
وحدة إجماع RL
يتم عرض معاملات ضبط PRISM وحالة وكيل التعلم المعزز عبر هذه الوحدة.
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /rlconsensus/v1/agent | حالة وكيل PRISM ووضعه الحالي |
| GET | /rlconsensus/v1/observation | متجه الملاحظة الأخير |
| GET | /rlconsensus/v1/rewards | مقاييس المكافآت التراكمية |
| GET | /rlconsensus/v1/params | معاملات وحدة إجماع PRISM الحالية |
| GET | /rlconsensus/v1/policy | إعدادات السياسة النشطة وأوزانها |
وحدة الحرق (Burn)
اعتبارًا من إصدار السلسلة v3.1.77، أصبحت حالة القراءة فقط لوحدة الحرق مُتاحة عبر REST من خلال grpc-gateway ضمن البادئة /qorechain/burn/v1/... (كانت مقتصرة على gRPC سابقًا). تُقدّم هذه النقاط بيانات JSON حقيقية على السلسلة عبر HTTP للمستكشفات وقياس عن بُعد للعقد الخفيفة. تتضمن إحصاءات stats الخاصة بالحرق مثلًا 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 | /burn/v1/stats | إحصاءات الحرق عبر كل القنوات |
| GET | /burn/v1/params | معاملات وحدة الحرق الحالية |
وحدة xQORE
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /xqore/v1/position/{address} | مركز رهان xQORE لعنوان معين |
| GET | /xqore/v1/params | معاملات وحدة xQORE الحالية |
وحدة التضخم (Inflation)
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /inflation/v1/rate | معدل التضخم السنوي الحالي |
| GET | /inflation/v1/epoch | رقم الحقبة الحالية ونسبة تقدّمها |
| GET | /inflation/v1/params | معاملات وحدة التضخم الحالية |
وحدة RDK
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /rdk/v1/rollup/{id} | تفاصيل تجميع (rollup) محدد |
| GET | /rdk/v1/rollups | يسرد كل التجميعات المسجَّلة |
| GET | /rdk/v1/batch/{id}/{index} | يسترجع دفعة تسوية محددة |
| GET | /rdk/v1/batches/{id} | يسرد دفعات تجميع معين |
| GET | /rdk/v1/blob/{id}/{index} | يسترجع كتلة بيانات (DA blob) محددة |
| GET | /rdk/v1/params | معاملات وحدة RDK الحالية |
وحدة Babylon
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /babylon/v1/staking/{address} | مركز رهان BTC لعنوان معين |
| GET | /babylon/v1/checkpoint/{epoch} | بيانات نقطة تفتيش BTC لحقبة معينة |
| GET | /babylon/v1/params | معاملات وحدة Babylon الحالية |
وحدة الحساب المجرَّد (Abstract Account)
اعتبارًا من إصدار السلسلة v3.1.85، أصبحت خدمة استعلام الحساب المجرَّد مُتاحة عبر REST من خلال grpc-gateway ضمن البادئة /qorechain/abstractaccount/v1/...، بما في ذلك مخطط الأذونات المستخدَم للتحقق من نطاقات موثِّق الهوية (authenticator) دون ترميزها يدويًا.
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /qorechain/abstractaccount/v1/config | إعدادات الوحدة (مسبار الميزة: enabled) |
| GET | /qorechain/abstractaccount/v1/accounts | يسرد الحسابات المجرَّدة |
| GET | /qorechain/abstractaccount/v1/accounts/{address} | حالة الحساب المجرَّد لعنوان معين |
| GET | /qorechain/abstractaccount/v1/permission_schema | تصنيف الأذونات، وخريطة الرسالة إلى الإذن، والرسائل غير القابلة للتفويض |
تبقى نقاط النهاية الأقصر التالية متاحة:
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /abstractaccount/v1/account/{address} | تفاصيل الحساب المجرَّد لعنوان معين |
| GET | /abstractaccount/v1/params | معاملات وحدة الحساب المجرَّد الحالية |
وحدة FairBlock
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /fairblock/v1/config | إعدادات تشفير FairBlock الحالية |
| GET | /fairblock/v1/params | معاملات وحدة FairBlock الحالية |
وحدة تجريد الغاز (Gas Abstraction)
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /gasabstraction/v1/accepted-tokens | يسرد الرموز المقبولة لدفع الغاز |
| GET | /gasabstraction/v1/params | معاملات وحدة تجريد الغاز الحالية |
استكشاف gRPC (Reflection)
خاصية استكشاف خادم gRPC مُفعَّلة افتراضيًا، مما يسمح لأدوات مثل grpcurl باكتشاف الخدمات المتاحة:
grpcurl -plaintext localhost:9090 list
للاستعلام عن خدمة محددة:
grpcurl -plaintext localhost:9090 qorechain.pqc.v1.Query/Params
المصادقة
جميع نقاط REST وgRPC غير مُصادَق عليها افتراضيًا. للنشر في بيئة الإنتاج، ضع وكيلًا عكسيًا (مثل Nginx أو Caddy) أمام العقدة للتعامل مع إنهاء TLS والتحكم في الوصول.