JSON-RPC — متوافق مع Solana

توفّر QoreChain واجهة JSON-RPC متوافقة مع Solana من خلال بيئة تشغيل SVM (آلة Solana الافتراضية) الخاصة بها، ممّا يتيح لأدوات Solana وحِزم SDK الحالية التفاعل مع QoreChain بشكل أصيل.

إرسال معاملات SVM معطّل حاليًا

اعتبارًا من إصدار السلسلة v3.1.89 (22 أغسطس)، وعقب حادثة، أصبح مسار تنفيذ SVM معطّلاً على مستوى الشبكة بالكامل بالنسبة إلى إرسال المعاملات — أي معاملة تُعيد code 11, "SVM module is disabled". ينطبق هذا على مستوى الشبكة بأكملها، وليس فقط عند نقاط النهاية العامة للقراءة فقط. تستجيب الطرق ذات طابع القراءة في الجدول أدناه (مثل getBalance وgetAccountInfo) بشكل طبيعي على نقاط النهاية العامة، لكن تجنّب أي تكامل فعلي يُرسل معاملات SVM إلى أن يُعاد فتح هذا المسار — هذا التعطيل يتم وقت الترجمة (compile-time) وليس عبر معامل وقت التشغيل، لذا لا يمكن إعادة تفعيله بتصويت حوكمة؛ ومن المتوقع أن يظل معطّلاً إلى أن يُقرّه تدقيق خارجي.

الاتصال

وسيلة النقل	العنوان
HTTP (عقدة خاصة بك)	http://127.0.0.1:8899
HTTPS (عام، الشبكة الرئيسية، للقراءة فقط)	https://svm.qore.host
HTTPS (عام، شبكة الاختبار، للقراءة فقط)	https://svm-testnet.qore.host

يتم تشغيل خادم JSON-RPC بواسطة qorechaind start وهو مفعّل افتراضيًا، ويستمع على 127.0.0.1:8899. تتم تهيئته عبر قسم [svm-rpc] في ملف app.toml (enable + address). العقدة المشغَّلة حديثًا تخدم هذه الواجهة بالفعل — لا حاجة إلى أي عملية إضافية. نقاط النهاية العامة للقراءة فقط (إرسال المعاملات معطَّل عند الحافة).

ملاحظة

اعتبارًا من إصدار السلسلة v3.1.82، تخدم واجهة SVM رصيد QOR الأصلي للحساب — وهو نفس الأموال الموحّدة الظاهرة على واجهتَي Cosmos وEVM — مقوَّمًا بوحدة lamports (9 منازل عشرية؛ 1 uqor = 1,000 lamports). راجع QOR الأصلي على واجهة SVM.

---

الطرق (Methods)

الطريقة	المعاملات	الوصف
getAccountInfo	pubkey (سلسلة base58)	تُعيد بيانات الحساب والمالك وقيمة lamports وعلامة القابلية للتنفيذ
getBalance	pubkey (سلسلة base58)	تُعيد رصيد QOR الأصلي بوحدة lamports للمفتاح العام المحدد
getSignaturesForAddress	address (سلسلة base58)	تُعيد توقيعات المعاملات المتعلقة بالعنوان (كشف الإيداعات)
getSlot	لا شيء	تُعيد رقم الفتحة (slot) الحالية
getMinimumBalanceForRentExemption	dataLength (عدد صحيح)	تُعيد الحد الأدنى للرصيد اللازم للإعفاء من الإيجار وفقًا لحجم البيانات
getVersion	لا شيء	تُعيد إصدار برنامج العقدة
getHealth	لا شيء	تُعيد حالة صحة العقدة ("ok" إذا كانت سليمة)
getBlockHeight	لا شيء	تُعيد ارتفاع الكتلة الحالي
getLatestBlockhash	لا شيء	تُعيد blockhash حديثًا وقيمة lastValidBlockHeight
getRecentBlockhash	لا شيء	الصيغة القديمة من getLatestBlockhash
getFeeForMessage	message (base64)	تُعيد رسوم رسالة (بوحدة lamports)
getMultipleAccounts	pubkeys (مصفوفة)	تُعيد عدة حسابات في استدعاء واحد
getProgramAccounts	programId (base58)	تُعيد الحسابات التي يملكها برنامج
getTokenAccountsByOwner	owner، مرشّح	تُعيد حسابات الرموز الخاصة بمالك
getTokenAccountsByDelegate	delegate، مرشّح	تُعيد حسابات الرموز الخاصة بمفوَّض

الطرق الواقعة خارج هذه القائمة، مثل getGenesisHash وgetEpochInfo، تُعيد -32601 method not found (جرى التحقق منها مقابل https://svm.qore.host وhttps://svm-testnet.qore.host، في 20 أكتوبر 2026). ومنذ v3.2.2 يجب أن تكون عناوين base58 في استعلامات RPC وgRPC قانونية (canonical) ومحدودة الطول؛ ويُرفض العنوان المشوَّه. تُقبل الطريقة getTransaction لكنها تردّ حاليًا بغلاف لا يحتوي على الحقل result، فلا تعتمد عليها. وتتبع الفتحة (slot) التي تُبلغ عنها getSlot ارتفاع كتل السلسلة.

---

تنسيق الاستجابة

تتبع جميع الاستجابات مواصفة JSON-RPC 2.0. الاستجابات التي تشير إلى حالة على السلسلة تتضمن كائن context يحتوي على قيمة slot الحالية:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "context": {
      "slot": 123456
    },
    "value": { ... }
  }
}

---

أمثلة

getAccountInfo

الطلب:

curl -X POST http://localhost:8899 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "getAccountInfo",
    "params": [
      "4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T",
      { "encoding": "base64" }
    ],
    "id": 1
  }'

الاستجابة:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "context": {
      "slot": 123456
    },
    "value": {
      "data": ["AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=", "base64"],
      "executable": false,
      "lamports": 1000000000,
      "owner": "11111111111111111111111111111111",
      "rentEpoch": 0
    }
  }
}

getBalance

الطلب:

curl -X POST http://localhost:8899 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "getBalance",
    "params": ["4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T"],
    "id": 2
  }'

الاستجابة:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "context": {
      "slot": 123456
    },
    "value": 1000000000
  }
}

getVersion

الطلب:

curl -X POST http://localhost:8899 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "getVersion",
    "params": [],
    "id": 3
  }'

الاستجابة:

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "solana-core": "1.18.0-qorechain",
    "feature-set": 0
  }
}

تشير سلسلة الإصدار 1.18.0-qorechain إلى التوافق مع واجهة RPC الخاصة بـ Solana 1.18.0 العاملة على بيئة تشغيل SVM في QoreChain.

---

تكامل @solana/web3.js

يمكن لتطبيقات Solana الحالية الاتصال بـ QoreChain عبر توجيه كائن Connection إلى نقطة نهاية SVM المحلية:

import { Connection, PublicKey, LAMPORTS_PER_SOL } from "@solana/web3.js";

const connection = new Connection("http://127.0.0.1:8899", "confirmed");

// Check version
const version = await connection.getVersion();
console.log("Node version:", version["solana-core"]);

// Get balance
const pubkey = new PublicKey("4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T");
const balance = await connection.getBalance(pubkey);
console.log("Balance:", balance / LAMPORTS_PER_SOL);

// Get slot
const slot = await connection.getSlot();
console.log("Current slot:", slot);

// Get account info
const accountInfo = await connection.getAccountInfo(pubkey);
if (accountInfo) {
  console.log("Owner:", accountInfo.owner.toBase58());
  console.log("Executable:", accountInfo.executable);
  console.log("Data length:", accountInfo.data.length);
}

---

ملاحظات

• تنسيق العناوين: تستخدم حسابات SVM مفاتيح عامة مرمّزة بترميز base58 (تنسيق Solana القياسي)، وليس بادئة Bech32 qor1 المستخدمة في وحدات Cosmos SDK الأصلية.
• الجسور بين الآلات الافتراضية (Cross-VM): لنقل الأصول بين بيئتَي تشغيل EVM وSVM، استخدم وحدة Cross-VM (x/crossvm). راجع أوامر المعاملات لصيغة الأمر crossvm call. مسار SVM معطّل وMsgCrossVMCall مُوقَف على الشبكة الرئيسية، لذا فهذا للرجوع فقط اليوم.
• نشر البرامج: انشر برامج BPF عبر سطر الأوامر (qorechaind tx svm deploy-program) أو برمجيًا من خلال بيئة تشغيل SVM.
• ميزانية الحوسبة: تفرض بيئة تشغيل SVM افتراضيًا ميزانية حوسبة قدرها 1,400,000 وحدة حوسبة لكل معاملة. وهذا قابل للتهيئة عبر معاملات الوحدة (module parameters).