Sari la conținutul principal

Dezvoltare SVM

QoreChain include un mediu de execuție Solana Virtual Machine (SVM), care permite dezvoltatorilor să implementeze și să execute programe SBF/BPF folosind uneltele Solana cu care sunt deja obișnuiți. Modulul SVM expune o interfață JSON-RPC compatibilă cu Solana pe portul 8899, pe care qorechaind start o pornește automat (vezi Server JSON-RPC mai jos).

notă

Comenzile de mai jos folosesc rețeaua mainnet qorechain-vladi (live din 7 iunie 2026), care rulează versiunea de nod v3.2.7 din 12 noiembrie 2026 (propunerea de guvernanță 16, înălțimea 4.164.600; v3.2.6 din 4 noiembrie 2026; v3.2.5 din 29 octombrie 2026, v3.2.4 din 23 octombrie 2026). Înlocuiți cu --chain-id qorechain-diana pentru testnet, care rulează v3.2.8 (din 12 noiembrie 2026; v3.2.4 din 19 octombrie 2026). Tranzacțiile SVM sunt dezactivate pe ambele rețele (vezi caseta următoare), așa că comenzile tx svm de pe această pagină sunt doar de referință: nu pot reuși în prezent.


Trimiterea de tranzacții SVM este momentan dezactivată

Începând cu versiunea de chain v3.1.89 (22 august), în urma unui incident, lane-ul de execuție SVM este dezactivat la nivelul întregii rețele pentru trimiterea de tranzacții atât pe qorechain-vladi, cât și pe qorechain-diana — orice tranzacție trimisă către x/svm (implementare de programe, execuție de instrucțiuni, creare de conturi, transferuri) returnează code 11, "SVM module is disabled". Acest lucru se aplică atât nodului propriu, cât și endpoint-urilor publice. Metodele RPC de tip citire pot răspunde în continuare, dar nu construiți și nu repetați o integrare SVM live până când lane-ul nu se redeschide. Pe mainnet, lane-ul SVM este dezactivat în release-ul curent, iar activarea lui pe mainnet necesită un release viitor; se așteaptă să rămână dezactivat până când un audit extern îl aprobă.

Prezentare generală​

Modulul x/svm oferă:

  • QOR nativ ca activ SVM de prim rang — soldul unificat al contului, vizibil în lamporți
  • Implementare și execuție de programe SBF/BPF
  • Creare și gestionare de conturi de date
  • Un endpoint JSON-RPC compatibil cu Solana
  • Corespondență bidirecțională de adrese între formatele de adrese QoreChain și Solana
  • Măsurare a bugetului de calcul și economie de stocare bazată pe chirie

QOR nativ pe interfața SVM​

Începând cu versiunea de chain v3.1.82, interfața SVM este o interfață native-QOR de prim rang, nu un sold separat de tip sandbox. Soldul unic unificat al contului — aceiași bani vizibili ca uqor pe interfața Cosmos și ca wei cu 18 zecimale pe EVM — apare pe partea SVM în lamporți (9 zecimale):

1 uqor = 1,000 lamports · 1 QOR = 1,000,000,000 lamports
  • getBalance / getAccountInfo returnează QOR-ul nativ al contului (în lamporți).
  • getSignaturesForAddress returnează istoricul de tranzacții care implică o adresă — utilizabil pentru detectarea depunerilor cu uneltele standard Solana.
  • Transferurile din System Program mută QOR nativ — o instrucțiune de transfer în stil Solana mută aceiași bani pe care i-ar muta un MsgSend Cosmos sau un transfer EVM.
  • Forma adresei SVM — adresa SVM a unui cont este cei 20 de bytes ai contului, completați la dreapta până la 32 de bytes și codificați base58. Toate cele trei forme de adresă (qor1..., 0x..., base58) se referă la același cont.

Release v3.2.8 (testnet din 12 noiembrie 2026). Upgrade-ul închide lane-ul SVM pe qorechain-diana: scrierile SVM eșuează, MsgRegisterSVMPQCKey este refuzat, iar JSON-RPC SVM refuză metodele de scriere pe id-urile de chain publice, până când un vot de guvernanță îl redeschide (testnet-ul are un comutator guvernat). Pe mainnet, lane-ul este dezactivat în release-ul curent, iar activarea lui necesită un release viitor. Clienții ar trebui să citească starea lane-ului din parametrii modulului SVM (enabled) înainte de a oferi acțiuni SVM.

Endpoint-urile publice (https://svm.qore.host, https://svm-testnet.qore.host) sunt doar pentru citire — trimiterea de tranzacții este dezactivată la nivelul marginii rețelei. În mod normal ați rula propriul nod (portul 8899) pentru a trimite tranzacții SVM, dar vedeți avertismentul de mai sus: lane-ul de tranzacții x/svm însuși este momentan dezactivat la nivelul întregii rețele, inclusiv pe propriul nod.


Server JSON-RPC​

Serverul JSON-RPC compatibil cu Solana este pornit de qorechaind start și este activat implicit. Este configurat printr-o secțiune [svm-rpc] în app.toml:

[svm-rpc]
# Enable the Solana-compatible JSON-RPC server
enable = true
# Address the server listens on
address = "127.0.0.1:8899"

Valorile implicite sunt enable = true și address = "127.0.0.1:8899", astfel încât un nod pornit recent servește deja interfața JSON-RPC Solana pe portul 8899 — @solana/web3.js se conectează la http://127.0.0.1:8899 fără configurări suplimentare. getVersion raportează 1.18.0-qorechain, iar getBalance / getAccountInfo returnează conturi SVM live, de pe chain.

ProprietateValoare
URL implicithttp://127.0.0.1:8899
ActivatDa, implicit
Pornit deqorechaind start
CompatibilitateJSON-RPC Solana (subset)
getVersion1.18.0-qorechain

Metode suportate​

MetodăDescriere
getAccountInfoPreia datele contului și soldul în lamporți
getBalanceObține soldul contului în lamporți (QOR nativ)
getSignaturesForAddressIstoricul tranzacțiilor pentru o adresă
getSlotNumărul slotului curent
getMinimumBalanceForRentExemptionSoldul minim pentru o dimensiune de date dată
getVersionInformații despre versiunea runtime-ului SVM
getHealthVerificare de sănătate pentru endpoint-ul SVM
getGenesisHashGenesis hash-ul clusterului (din v3.2.7: testnet din 6 noiembrie 2026, mainnet din 12 noiembrie 2026; base58)

Identitatea clusterului (v3.2.7). Wallet-urile care urmează Wallet Standard au nevoie de o identitate stabilă a clusterului. Începând cu versiunea v3.2.7 (testnet din 6 noiembrie 2026, mainnet din 12 noiembrie 2026), nodul servește genesis hash-ul clusterului și ID-ul său de lanț Wallet Standard. Pe testnet, pe 7 noiembrie 2026, GET /qorechain/svm/v1/cluster_info a răspuns cu chain_id qorechain-diana, un genesis_hash, un caip2_chain_id (solana: urmat de primele 32 de caractere ale genesis hash-ului) și execution_enabled false, iar getGenesisHash pe https://svm-testnet.qore.host a returnat același genesis hash. Hash-ul este derivat din chain id, nu dintr-un cluster Solana real. Execuția SVM rămâne oprită pe ambele rețele; aceasta doar identifică clusterul. Pe 12 noiembrie 2026, aceeași rută pe mainnet a răspuns cu 200, cu chain_id qorechain-vladi, propriul genesis hash și execution_enabled false.


Implementarea și interacțiunea cu programe​

info

Execuție SBF modernă. Motorul de execuție SVM a fost modernizat pe solana-sbpf 0.21.1, astfel încât programele SBF compilate recent cu toolchain-ul Solana curent (platform-tools v1.53 / agave 4.x) atât se implementează, cât și rulează pe QoreChain — execuția este complet suportată, nu doar implementarea. Programele construite fie cu cargo build-sbf --arch v0, fie cu --arch v3 sunt suportate.

  1. Implementarea unui program SBF — Compilați programul Solana într-un obiect partajat SBF cu platform-tools-ul curent (v1.53 / agave 4.x), apoi implementați-l pe QoreChain:

    # Build with the current Solana toolchain (--arch v0 or --arch v3)
    cargo build-sbf --arch v3

    # Deploy the compiled program
    qorechaind tx svm deploy-program ./my_program.so \
    --from mykey \
    --gas 2000000 --fees 200000uqor \
    --generate-only > tx.json

    Pe o rețea unde lane-ul este activat, fiecare comandă tx svm este o tranzacție pe lane-ul Cosmos: semnați și difuzați tx.json cu qorechaind tx pqc cosign tx.json --from mykey --pqc-key mypqc --chain-id <chain-id> și setați o limită de gaz explicită, cu un comision de cel puțin gaz × 0.1 uqor. Răspunsul tranzacției include ID-ul programului în format base58.

  2. Executarea unei instrucțiuni — Apelați un program BPF de pe chain cu date de instrucțiune:

    # Execute instruction
    qorechaind tx svm execute <program-id-base58> <data-hex> \
    --from mykey \
    --gas 400000 --fees 40000uqor \
    --generate-only > tx.json
    ParametruFormatDescriere
    program-id-base58Șir base58Adresa programului implementat
    data-hexBytes codificați hexDate de instrucțiune serializate
  3. Crearea unui cont de date — Programele au adesea nevoie de conturi pentru a stoca starea. Creați unul cu o dimensiune și un proprietar specificate:

    # Create data account
    qorechaind tx svm create-account <owner-base58> <space> <lamports> \
    --from mykey \
    --gas 400000 --fees 40000uqor \
    --generate-only > tx.json
    ParametruDescriere
    owner-base58Programul care deține acest cont (base58)
    spaceDimensiunea câmpului de date în bytes
    lamportsSoldul inițial (trebuie să atingă minimul de scutire de chirie)

    Interogați soldul minim scutit de chirie pentru o dimensiune dată:

    # RPC: getMinimumBalanceForRentExemption
    curl -X POST http://localhost:8899 \
    -H "Content-Type: application/json" \
    -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getMinimumBalanceForRentExemption",
    "params": [1024]
    }'
  4. Folosind @solana/web3.js — SDK-ul JavaScript Solana funcționează direct cu endpoint-ul SVM QoreChain:

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

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

    // Check health
    const health = await connection.getHealth();
    console.log("SVM health:", health);

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

    // Get account info
    const pubkey = new PublicKey("YourBase58ProgramId...");
    const accountInfo = await connection.getAccountInfo(pubkey);
    console.log("Account data:", accountInfo);

    // Get balance
    const balance = await connection.getBalance(pubkey);
    console.log("Balance (lamports):", balance);

Corespondența adreselor​

QoreChain menține o corespondență bidirecțională de adrese între adresele Bech32 native (qor1...) și adresele base58 în stil Solana:

DirecțieExemplu
Nativ către SVMqor1abc...xyz corespunde unei adrese base58 deterministe
SVM către nativAdresele de program base58 corespund înapoi echivalentelor qor1...

Corespondența este deterministă și gestionată de modulul x/svm. Ambele reprezentări se referă la același cont subiacent.


Modelul de chirie​

Modulul SVM folosește un model de stocare bazat pe chirie pentru a preveni umflarea stării:

ParametruValoare
Lamporți pe byte pe an3,480
Multiplicator de scutire de chirie2.0
Frecvența colectăriiLa fiecare epocă
  • Conturile cu un sold peste 2 * (data_size * 3480 / seconds_per_year) lamporți sunt scutite de chirie și nu sunt taxate niciodată.
  • Conturile sub pragul de scutire de chirie sunt taxate cu chirie la fiecare epocă. Dacă soldul ajunge la zero, contul este eliminat.
info

Bună practică: Alimentați întotdeauna conturile de date peste minimul de scutire de chirie pentru a evita ștergerea neașteptată a contului.


Bugetul de calcul​

Fiecare execuție de instrucțiune este măsurată cu unități de calcul:

ParametruValoare
Unități de calcul maxime pe instrucțiune1,400,000
Adâncime maximă CPI (invocare cross-program)4
Dimensiune maximă a programului10 MB
Dimensiune maximă a datelor contului10 MB

Programele care depășesc bugetul de calcul sunt oprite, iar tranzacția este anulată.


Rezumat parametri​

ParametruValoare
max_program_size10 MB
max_account_data_size10 MB
compute_budget_max1,400,000 CU
max_cpi_depth4
lamports_per_byte_year3,480
rent_exemption_multiplier2.0
Port JSON-RPC8899

Interoperabilitate cross-VM​

Programele SVM sunt concepute să comunice cu contractele EVM și QoreChain Native prin mesajul MsgCrossVMCall al modulului x/crossvm (chain-ul stabilește singur lane-ul sursă). Deoarece lane-ul SVM este dezactivat pentru tranzacții, iar MsgCrossVMCall este oprit pe mainnet, în prezent nu există nicio cale cross-VM SVM funcțională. Vezi Interoperabilitate cross-VM pentru starea curentă, ciclul de viață al mesajelor și comportamentul de timeout.


Pașii următori​