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 con QoreChain in modo nativo.
A partire dalla versione della chain v3.1.89 (22 agosto), a seguito di un incidente, la lane di esecuzione SVM è disabilitata a livello di rete per l'invio di transazioni — qualsiasi transazione restituisce code 11, "SVM module is disabled". Questo vale a livello di rete, non solo sugli endpoint pubblici di sola lettura. I metodi in stile lettura elencati nella tabella sottostante (ad es. getBalance, getAccountInfo) rispondono normalmente sugli endpoint pubblici, ma non tentare un'integrazione live che invii transazioni SVM finché la lane non viene riaperta — si tratta di una disabilitazione a livello di compilazione, non di un parametro a runtime, quindi non può essere riattivata con un voto di governance; si prevede che resterà disattivata finché un audit esterno non la sblocchi.
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 di default, in ascolto su 127.0.0.1:8899. Viene configurato 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 di sola lettura (l'invio di transazioni è disabilitato al margine).
A partire dalla versione della chain v3.1.82, l'interfaccia SVM espone il saldo QOR nativo dell'account — gli stessi fondi unificati visibili sulle interfacce Cosmos ed EVM — denominato in lamport (9 decimali; 1 uqor = 1.000 lamport). Vedi QOR nativo sull'interfaccia SVM.
Metodi
| Metodo | Parametri | Descrizione |
|---|---|---|
getAccountInfo | pubkey (stringa base58) | Restituisce i dati dell'account, il proprietario, i lamport e il flag eseguibile |
getBalance | pubkey (stringa base58) | Restituisce il saldo QOR nativo in lamport per la chiave pubblica indicata |
getSignaturesForAddress | address (stringa base58) | Restituisce le firme delle transazioni che coinvolgono l'indirizzo (rilevamento depositi) |
getSlot | nessuno | Restituisce il numero dello 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 in salute) |
getBlockHeight | nessuno | Restituisce l'altezza del blocco corrente |
getLatestBlockhash | nessuno | Restituisce un blockhash recente e lastValidBlockHeight |
getRecentBlockhash | nessuno | Forma legacy di getLatestBlockhash |
getFeeForMessage | message (base64) | Restituisce la commissione per un messaggio (lamport) |
getMultipleAccounts | pubkeys (array) | Restituisce più account in una sola chiamata |
getProgramAccounts | programId (base58) | Restituisce gli account posseduti da un programma |
getTokenAccountsByOwner | owner, filtro | Restituisce gli account token di un proprietario |
getTokenAccountsByDelegate | delegate, filtro | Restituisce gli account token di un delegato |
I metodi non presenti in questo elenco, come getEpochInfo, restituiscono -32601 method not found (verificato su https://svm.qore.host e https://svm-testnet.qore.host, 23 ottobre 2026, e getEpochInfo di nuovo sulla testnet il 7 novembre 2026). Testnet, v3.2.7: getGenesisHash risponde (il 7 novembre 2026 ha restituito 6Z9pa53SwiprqiAoNCqqUdj5c3C4P1zRw31gQVnF4Czj) e getVersion riporta anche qorechain-chain-id, qorechain-cluster (il chain id del Wallet Standard, solana: seguito dai primi 32 caratteri dell'hash di genesi) e qorechain-genesis-hash. La stessa identità è servita via REST su GET /qorechain/svm/v1/cluster_info (vedi Endpoint REST / gRPC). Sulla mainnet (v3.2.6) getGenesisHash risponde ancora -32601 e getVersion ha solo solana-core e feature-set (verificato il 7 novembre 2026). SVM resta disattivata: questa identità permette a un wallet di riconoscere il cluster, non abilita le transazioni. Dalla v3.2.2 gli indirizzi base58 nelle query RPC e gRPC devono essere canonici e di lunghezza limitata; uno malformato viene rifiutato. getTransaction viene accettato ma al momento risponde con una busta priva del campo result, quindi non fare affidamento su di esso. Lo slot riportato da getSlot segue l'altezza del blocco della chain.
Formato della risposta
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": 0
}
}
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
qor1usato dai moduli nativi del Cosmos SDK. - Bridging cross-VM: per spostare asset tra i runtime EVM e SVM, usa il modulo Cross-VM (
x/crossvm). Vedi i Comandi di transazione per la sintassi dicrossvm call. La lane SVM è disabilitata eMsgCrossVMCallè disattivato sulla mainnet, quindi oggi questo è solo di riferimento. - Deploy dei programmi: esegui il deploy dei programmi BPF tramite la CLI (
qorechaind tx svm deploy-program) oppure programmaticamente tramite il runtime SVM. - Compute budget: il runtime SVM applica per default un compute budget di 1.400.000 compute unit per transazione. È configurabile tramite i parametri del modulo.