توفر QoreChain ثلاث واجهات رئيسية للوصول البرمجي:
| الواجهة | المنفذ الافتراضي | البروتوكول | الوصف |
|---|
| REST | 1317 | HTTP/1.1 | واجهة REST API لعميل LCD (Light Client Daemon) |
| 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.85) وشبكة الاختبار 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 | الحالات والعتبات الحالية لقواطع الدارة |
وحدة الجسر
اعتبارًا من إصدار السلسلة 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 والترحيل إليه |
وحدة السمعة
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /reputation/v1/validators | درجات السمعة لجميع المدققين |
| GET | /reputation/v1/validators/{address} | درجة السمعة لمدقق محدد |
وحدة Cross-VM
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /crossvm/v1/message/{id} | تسترجع رسالة عابرة للآلات الافتراضية حسب المعرّف |
| GET | /crossvm/v1/pending | تسرد الرسائل العابرة للآلات الافتراضية المعلّقة في الطابور |
| GET | /crossvm/v1/params | المعاملات الحالية لوحدة Cross-VM |
الوحدة متعددة الطبقات
اعتبارًا من إصدار السلسلة 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 | تهيئة السياسة النشطة وأوزانها |
وحدة الحرق
اعتبارًا من إصدار السلسلة 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 |
وحدة التضخم
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /inflation/v1/rate | معدل التضخم السنوي الحالي |
| GET | /inflation/v1/epoch | رقم الحقبة الحالية وتقدُّمها |
| GET | /inflation/v1/params | المعاملات الحالية لوحدة التضخم |
وحدة RDK
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /rdk/v1/rollup/{id} | تفاصيل rollup محدد |
| GET | /rdk/v1/rollups | تسرد جميع سلاسل rollup المسجَّلة |
| GET | /rdk/v1/batch/{id}/{index} | تسترجع دفعة تسوية محددة |
| GET | /rdk/v1/batches/{id} | تسرد الدفعات الخاصة بسلسلة rollup محددة |
| GET | /rdk/v1/blob/{id}/{index} | تسترجع blob بيانات محددًا لتوافر البيانات |
| GET | /rdk/v1/params | المعاملات الحالية لوحدة RDK |
وحدة Babylon
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /babylon/v1/staking/{address} | مركز تحصيص BTC لعنوان معيّن |
| GET | /babylon/v1/checkpoint/{epoch} | بيانات نقطة تفتيش BTC لحقبة معيّنة |
| GET | /babylon/v1/params | المعاملات الحالية لوحدة Babylon |
وحدة الحساب المجرَّد
اعتبارًا من إصدار السلسلة v3.1.85، أصبحت خدمة استعلام الحساب المجرَّد معروضة عبر REST من خلال grpc-gateway تحت البادئة /qorechain/abstractaccount/v1/...، بما في ذلك مخطط الأذونات المستخدم للتحقق من نطاقات المصادِقات دون ترميزها بشكل ثابت.
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /qorechain/abstractaccount/v1/config | تهيئة الوحدة (فحص توفر الميزة: enabled) |
| GET | /qorechain/abstractaccount/v1/accounts | تسرد الحسابات المجرَّدة |
| GET | /qorechain/abstractaccount/v1/accounts/{address} | حالة الحساب المجرَّد لعنوان ما |
| GET | /qorechain/abstractaccount/v1/permission_schema | تصنيف الأذونات، وخريطة msg→permission، والرسائل غير القابلة للتفويض |
ولا تزال نقاط النهاية التالية ذات المسارات الأقصر متاحة:
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /abstractaccount/v1/account/{address} | تفاصيل الحساب المجرَّد لعنوان معيّن |
| GET | /abstractaccount/v1/params | المعاملات الحالية لوحدة الحساب المجرَّد |
وحدة FairBlock
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /fairblock/v1/config | تهيئة تشفير FairBlock الحالية |
| GET | /fairblock/v1/params | المعاملات الحالية لوحدة FairBlock |
وحدة تجريد الغاز
| الطريقة | نقطة النهاية | الوصف |
|---|
| GET | /gasabstraction/v1/accepted-tokens | تسرد الرموز المقبولة لدفع الغاز |
| GET | /gasabstraction/v1/params | المعاملات الحالية لوحدة تجريد الغاز |
انعكاس gRPC
انعكاس خادم gRPC مفعَّل افتراضيًا، ما يتيح لأدوات مثل grpcurl اكتشاف الخدمات المتاحة:
grpcurl -plaintext localhost:9090 list
للاستعلام عن خدمة محددة:
grpcurl -plaintext localhost:9090 qorechain.pqc.v1.Query/Params
المصادقة
جميع نقاط نهاية REST وgRPC غير مصادَق عليها افتراضيًا. لعمليات النشر الإنتاجية، ضع وكيلًا عكسيًا (مثل Nginx أو Caddy) أمام العقدة للتعامل مع إنهاء TLS والتحكم في الوصول.