JSON-RPC — Solana Uyumlu

QoreChain, SVM (Solana Virtual Machine) çalışma zamanı üzerinden Solana uyumlu bir JSON-RPC arayüzü sunar; böylece mevcut Solana araçları ve SDK'ları QoreChain ile doğrudan (natif olarak) etkileşim kurabilir.

Bağlantı

Aktarım	Adres
HTTP (kendi düğümünüz)	http://127.0.0.1:8899
HTTPS (genel, mainnet, salt okunur)	https://svm.qore.host
HTTPS (genel, testnet, salt okunur)	https://svm-testnet.qore.host

JSON-RPC sunucusu qorechaind start tarafından başlatılır ve varsayılan olarak etkindir; 127.0.0.1:8899 üzerinde dinler. app.toml içindeki bir [svm-rpc] bölümü (enable + address) aracılığıyla yapılandırılır. Yeni başlatılmış bir düğüm bu arayüzü zaten sunar — ek bir sürece gerek yoktur. Genel uç noktalar salt okunurdur (işlem gönderimi uçta devre dışıdır).

not

Zincir sürümü v3.1.82 itibarıyla SVM arayüzü, hesabın natif QOR bakiyesini — Cosmos ve EVM arayüzlerinde görünen aynı birleşik fonları — lamports cinsinden sunar (9 ondalık; 1 uqor = 1.000 lamports). Bkz. SVM Arayüzünde Natif QOR.

---

Metotlar

Metot	Parametreler	Açıklama
getAccountInfo	pubkey (base58 dize)	Hesap verilerini, sahibini, lamports miktarını ve executable bayrağını döndürür
getBalance	pubkey (base58 dize)	Verilen genel anahtar için natif QOR bakiyesini lamports cinsinden döndürür
getSignaturesForAddress	address (base58 dize)	Adresi içeren işlem imzalarını döndürür (yatırma işlemi tespiti)
getSlot	yok	Geçerli slot numarasını döndürür
getMinimumBalanceForRentExemption	dataLength (tam sayı)	Verilen veri boyutu için kira muafiyeti (rent exemption) asgari bakiyesini döndürür
getVersion	yok	Düğüm yazılım sürümünü döndürür
getHealth	yok	Düğüm sağlık durumunu döndürür (sağlıklıysa "ok")

---

Yanıt Biçimi

Tüm yanıtlar JSON-RPC 2.0 spesifikasyonunu izler. Zincir üstü duruma başvuran yanıtlar, geçerli slot değerini içeren bir context nesnesi içerir:

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

---

Örnekler

getAccountInfo

İstek:

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

Yanıt:

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

getBalance

İstek:

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

Yanıt:

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

getVersion

İstek:

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

Yanıt:

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

1.18.0-qorechain sürüm dizesi, QoreChain SVM çalışma zamanı üzerinde çalışan Solana 1.18.0 RPC arayüzü ile uyumluluğu belirtir.

---

@solana/web3.js Entegrasyonu

Mevcut Solana uygulamaları, Connection nesnesini yerel SVM uç noktasına yönlendirerek QoreChain'e bağlanabilir:

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);
}

---

Notlar

• Adres biçimi: SVM hesapları, natif Cosmos SDK modüllerinin kullandığı qor1 Bech32 önekini değil, base58 kodlu genel anahtarları (standart Solana biçimi) kullanır.
• VM'ler arası köprüleme: Varlıkları EVM ve SVM çalışma zamanları arasında taşımak için Cross-VM modülünü (x/crossvm) kullanın. crossvm call söz dizimi için İşlem Komutları sayfasına bakın.
• Program dağıtımı: BPF programlarını CLI ile (qorechaind tx svm deploy-program) veya programatik olarak SVM çalışma zamanı üzerinden dağıtın.
• Hesaplama bütçesi: SVM çalışma zamanı, varsayılan olarak işlem başına 1.400.000 hesaplama birimlik bir hesaplama bütçesi uygular. Bu değer, modül parametreleri aracılığıyla yapılandırılabilir.