JSON-RPC — Compatibile con Solana

QoreChain fornisce un'interfaccia JSON-RPC compatibile con Solana tramite il proprio runtime SVM (Solana Virtual Machine), consentendo agli strumenti e agli SDK Solana esistenti di interagire nativamente con QoreChain.

Connessione

Trasporto	Indirizzo
HTTP (nodo proprio)	http://127.0.0.1:8899
HTTPS (pubblico, mainnet, sola lettura)	https://svm.qore.host
HTTPS (pubblico, testnet, sola lettura)	https://svm-testnet.qore.host

Il server JSON-RPC viene avviato da qorechaind start ed è abilitato per impostazione predefinita, in ascolto su 127.0.0.1:8899. Si configura tramite una sezione [svm-rpc] in app.toml (enable + address). Un nodo appena avviato serve già questa interfaccia — non è richiesto alcun processo aggiuntivo. Gli endpoint pubblici sono in sola lettura (l'invio di transazioni è disabilitato a livello di edge).

nota

A partire dalla versione della chain v3.1.82, l'interfaccia SVM espone il saldo nativo in QOR dell'account — gli stessi fondi unificati visibili sulle interfacce Cosmos ed EVM — denominato in lamports (9 decimali; 1 uqor = 1,000 lamports). Consulta QOR nativo sull'interfaccia SVM.

---

Metodi

Metodo	Parametri	Descrizione
getAccountInfo	pubkey (stringa base58)	Restituisce i dati dell'account, il proprietario, i lamports e il flag executable
getBalance	pubkey (stringa base58)	Restituisce il saldo in QOR nativo, espresso in lamports, per la chiave pubblica indicata
getSignaturesForAddress	address (stringa base58)	Restituisce le firme delle transazioni che coinvolgono l'indirizzo (rilevamento dei depositi)
getSlot	nessuno	Restituisce il numero di slot corrente
getMinimumBalanceForRentExemption	dataLength (intero)	Restituisce il saldo minimo per l'esenzione dal rent in base alla dimensione dei dati
getVersion	nessuno	Restituisce la versione del software del nodo
getHealth	nessuno	Restituisce lo stato di salute del nodo ("ok" se integro)

---

Formato delle risposte

Tutte le risposte seguono la specifica JSON-RPC 2.0. Le risposte che fanno riferimento allo stato on-chain includono un oggetto context con lo slot corrente:

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

---

Esempi

getAccountInfo

Richiesta:

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

Risposta:

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

getBalance

Richiesta:

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

Risposta:

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

getVersion

Richiesta:

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

Risposta:

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

La stringa di versione 1.18.0-qorechain indica la compatibilità con l'interfaccia RPC di Solana 1.18.0 in esecuzione sul runtime SVM di QoreChain.

---

Integrazione con @solana/web3.js

Le applicazioni Solana esistenti possono connettersi a QoreChain puntando l'oggetto Connection all'endpoint SVM locale:

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

---

Note

• Formato degli indirizzi: gli account SVM utilizzano chiavi pubbliche codificate in base58 (formato Solana standard), non il prefisso Bech32 qor1 usato dai moduli nativi del Cosmos SDK.
• Bridging cross-VM: per spostare asset tra i runtime EVM e SVM, utilizza il modulo Cross-VM (x/crossvm). Consulta i Comandi di transazione per la sintassi di crossvm call.
• Deploy dei programmi: distribuisci i programmi BPF tramite la CLI (qorechaind tx svm deploy-program) o in modo programmatico attraverso il runtime SVM.
• Compute budget: il runtime SVM applica per impostazione predefinita un compute budget di 1,400,000 unità di calcolo per transazione. Questo valore è configurabile tramite i parametri del modulo.