Zum Hauptinhalt springen

SVM-Entwicklung

QoreChain enthält eine Solana Virtual Machine (SVM)-Ausführungsumgebung, die es Entwicklern ermöglicht, SBF/BPF-Programme mit vertrauten Solana-Tools bereitzustellen und auszuführen. Das SVM-Modul stellt eine Solana-kompatible JSON-RPC-Schnittstelle auf Port 8899 bereit, die von qorechaind start automatisch gestartet wird (siehe JSON-RPC-Server unten).

hinweis

Die folgenden Befehle verwenden das qorechain-vladi-Mainnet (live seit dem 7. Juni 2026), das das Node-Release v3.2.7 seit dem 12. November 2026 ausführt (Governance-Vorschlag 16, Höhe 4.164.600; v3.2.6 seit dem 4. November 2026; v3.2.5 seit dem 29. Oktober 2026, v3.2.4 seit dem 23. Oktober 2026). Ersetzen Sie --chain-id qorechain-diana für das Testnet, das v3.2.8 ausführt (seit dem 12. November 2026; v3.2.4 seit dem 19. Oktober 2026). SVM-Transaktionen sind auf beiden Netzwerken deaktiviert (siehe den nächsten Kasten), daher dienen die tx svm-Befehle auf dieser Seite nur als Referenz: Sie können heute nicht gelingen.


Übermittlung von SVM-Transaktionen derzeit deaktiviert

Seit Chain-Version v3.1.89 (22. August) ist die SVM-Ausführungsspur infolge eines Vorfalls netzwerkweit für die Übermittlung von Transaktionen deaktiviert, sowohl auf qorechain-vladi als auch auf qorechain-diana — jede an x/svm gesendete Transaktion (Programm-Deployment, Instruktionsausführung, Kontoerstellung, Überweisungen) liefert code 11, "SVM module is disabled" zurück. Dies gilt sowohl für Ihren eigenen Node als auch für die öffentlichen Endpunkte. Lesende RPC-Methoden können weiterhin antworten, aber bauen oder proben Sie keine produktive SVM-Integration, bevor die Spur wieder geöffnet ist. Im Mainnet ist die SVM-Spur im aktuellen Release deaktiviert, und sie dort zu aktivieren erfordert ein künftiges Release; sie wird voraussichtlich deaktiviert bleiben, bis ein externes Audit sie freigibt.

Übersicht​

Das Modul x/svm bietet:

  • Natives QOR als erstklassiges SVM-Asset — das einheitliche Guthaben des Kontos, sichtbar in Lamports
  • Bereitstellung und Ausführung von SBF/BPF-Programmen
  • Erstellung und Verwaltung von Daten-Accounts
  • Einen Solana-kompatiblen JSON-RPC-Endpunkt
  • Bidirektionales Adress-Mapping zwischen QoreChain- und Solana-Adressformaten
  • Compute-Budget-Messung und mietbasierte Speicherökonomie

Natives QOR auf der SVM-Schnittstelle​

Seit Chain-Version v3.1.82 ist die SVM-Schnittstelle eine erstklassige native-QOR-Schnittstelle und kein separates Sandbox-Guthaben mehr. Das eine einheitliche Guthaben des Kontos — dieselben Mittel, die auf der Cosmos-Schnittstelle als uqor und auf der EVM als 18-Dezimal-Wei sichtbar sind — erscheint auf der SVM-Seite in Lamports (9 Dezimalstellen):

1 uqor = 1,000 lamports · 1 QOR = 1,000,000,000 lamports
  • getBalance / getAccountInfo liefern das native QOR-Guthaben des Kontos (in Lamports).
  • getSignaturesForAddress liefert den Transaktionsverlauf einer Adresse — nutzbar zur Erkennung von Einzahlungen mit Standard-Solana-Tools.
  • System-Program-Transfers bewegen natives QOR — eine Solana-artige Transfer-Instruktion bewegt dieselben Mittel, die ein Cosmos-MsgSend oder ein EVM-Transfer bewegen würden.
  • SVM-Adressform — die SVM-Adresse eines Kontos sind seine 20 Konto-Bytes, rechts auf 32 Bytes aufgefüllt und Base58-kodiert. Alle drei Adressformen (qor1..., 0x..., Base58) beziehen sich auf dasselbe Konto.

Release v3.2.8 (Testnet seit dem 12. November 2026). Das Upgrade schließt die SVM-Spur auf qorechain-diana: SVM-Schreibvorgänge schlagen fehl, MsgRegisterSVMPQCKey wird abgelehnt, und das SVM-JSON-RPC lehnt Schreibmethoden auf den öffentlichen Chain-IDs ab, bis eine Governance-Abstimmung sie wieder öffnet (das Testnet hat einen per Governance gesteuerten Schalter). Im Mainnet ist die Spur im aktuellen Release deaktiviert, und sie zu aktivieren erfordert ein künftiges Release. Clients sollten den Zustand der Spur aus den SVM-Modulparametern (enabled) lesen, bevor sie SVM-Aktionen anbieten.

Die öffentlichen Endpunkte (https://svm.qore.host, https://svm-testnet.qore.host) sind nur lesend — die Übermittlung von Transaktionen ist am Edge deaktiviert. Normalerweise würden Sie einen eigenen Node (Port 8899) betreiben, um SVM-Transaktionen zu übermitteln, aber beachten Sie den Hinweis oben: Die x/svm-Transaktionsspur selbst ist derzeit netzwerkweit deaktiviert, auch auf Ihrem eigenen Node.


JSON-RPC-Server​

Der Solana-kompatible JSON-RPC-Server wird von qorechaind start gestartet und ist standardmäßig aktiviert. Er wird über einen [svm-rpc]-Abschnitt in app.toml konfiguriert:

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

Die Standardwerte sind enable = true und address = "127.0.0.1:8899", sodass ein frisch gestarteter Node bereits die Solana-JSON-RPC-Schnittstelle auf Port 8899 bereitstellt — @solana/web3.js verbindet sich ohne zusätzliche Einrichtung mit http://127.0.0.1:8899. getVersion meldet 1.18.0-qorechain, und getBalance / getAccountInfo liefern live On-Chain-SVM-Accounts.

EigenschaftWert
Standard-URLhttp://127.0.0.1:8899
AktiviertJa, standardmäßig
Gestartet vonqorechaind start
KompatibilitätSolana JSON-RPC (Teilmenge)
getVersion1.18.0-qorechain

Unterstützte Methoden​

MethodeBeschreibung
getAccountInfoKontodaten und Lamport-Guthaben abrufen
getBalanceKontoguthaben in Lamports abrufen (natives QOR)
getSignaturesForAddressTransaktionsverlauf für eine Adresse
getSlotAktuelle Slot-Nummer
getMinimumBalanceForRentExemptionMindestguthaben für eine gegebene Datengröße
getVersionVersionsinformationen der SVM-Laufzeit
getHealthHealth-Check für den SVM-Endpunkt
getGenesisHashGenesis-Hash des Clusters (seit v3.2.7: Testnet ab 6. November 2026, Mainnet ab 12. November 2026; base58)

Cluster-Identität (v3.2.7). Wallets, die dem Wallet Standard folgen, brauchen eine stabile Cluster-Identität. Ab Release v3.2.7 (Testnet seit dem 6. November 2026, Mainnet seit dem 12. November 2026) stellt der Node den Genesis-Hash des Clusters und seine Wallet-Standard-Chain-ID bereit. Im Testnet antwortete am 7. November 2026 GET /qorechain/svm/v1/cluster_info mit chain_id qorechain-diana, einem genesis_hash, einer caip2_chain_id (solana: gefolgt von den ersten 32 Zeichen des Genesis-Hashs) und execution_enabled false, und getGenesisHash auf https://svm-testnet.qore.host lieferte denselben Genesis-Hash. Der Hash wird aus der Chain-ID abgeleitet, nicht aus einem echten Solana-Cluster. Die SVM-Ausführung bleibt auf beiden Netzwerken aus; dies identifiziert nur den Cluster. Am 12. November 2026 antwortete dieselbe Route im Mainnet mit 200, chain_id qorechain-vladi, einem eigenen Genesis-Hash und execution_enabled false.


Programme bereitstellen und mit ihnen interagieren​

Info

Moderne SBF-Ausführung. Die SVM-Ausführungs-Engine wurde auf solana-sbpf 0.21.1 modernisiert, sodass frisch kompilierte SBF-Programme aus der aktuellen Solana-Toolchain (platform-tools v1.53 / agave 4.x) auf QoreChain sowohl bereitgestellt als auch ausgeführt werden — die Ausführung wird vollständig unterstützt, nicht nur das Deployment. Programme, die mit cargo build-sbf --arch v0 oder --arch v3 gebaut wurden, werden unterstützt.

  1. Ein SBF-Programm bereitstellen — Kompilieren Sie Ihr Solana-Programm mit den aktuellen platform-tools (v1.53 / agave 4.x) zu einem SBF-Shared-Object und stellen Sie es dann auf QoreChain bereit:

    # 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

    Auf einem Netzwerk, in dem die Spur aktiviert ist, ist jeder tx svm-Befehl eine Transaktion auf dem Cosmos-Pfad: Signieren und übertragen Sie tx.json mit qorechaind tx pqc cosign tx.json --from mykey --pqc-key mypqc --chain-id <chain-id> und legen Sie ein explizites Gas-Limit fest, mit einer Gebühr von mindestens Gas × 0.1 uqor. Die Transaktionsantwort enthält die Programm-ID im Base58-Format.

  2. Eine Instruktion ausführen — Rufen Sie ein On-Chain-BPF-Programm mit Instruktionsdaten auf:

    # Execute instruction
    qorechaind tx svm execute <program-id-base58> <data-hex> \
    --from mykey \
    --gas 400000 --fees 40000uqor \
    --generate-only > tx.json
    ParameterFormatBeschreibung
    program-id-base58Base58-StringDie Adresse des bereitgestellten Programms
    data-hexHex-kodierte BytesSerialisierte Instruktionsdaten
  3. Ein Daten-Account erstellen — Programme benötigen oft Accounts, um Zustand zu speichern. Erstellen Sie eines mit einer angegebenen Größe und einem Owner:

    # Create data account
    qorechaind tx svm create-account <owner-base58> <space> <lamports> \
    --from mykey \
    --gas 400000 --fees 40000uqor \
    --generate-only > tx.json
    ParameterBeschreibung
    owner-base58Das Programm, das dieses Account besitzt (Base58)
    spaceGröße des Datenfelds in Bytes
    lamportsAnfangsguthaben (muss das Mindestmaß der Rent-Befreiung erfüllen)

    Fragen Sie das mietbefreite Mindestguthaben für eine gegebene Größe ab:

    # RPC: getMinimumBalanceForRentExemption
    curl -X POST http://localhost:8899 \
    -H "Content-Type: application/json" \
    -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getMinimumBalanceForRentExemption",
    "params": [1024]
    }'
  4. Verwendung von @solana/web3.js — Das Solana-JavaScript-SDK funktioniert direkt mit dem QoreChain-SVM-Endpunkt:

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

Adress-Mapping​

QoreChain unterhält ein bidirektionales Adress-Mapping zwischen nativen Bech32-Adressen (qor1...) und Solana-artigen Base58-Adressen:

RichtungBeispiel
Nativ zu SVMqor1abc...xyz wird auf eine deterministische Base58-Adresse abgebildet
SVM zu NativBase58-Programmadressen werden zurück auf äquivalente qor1...-Adressen abgebildet

Das Mapping ist deterministisch und wird vom Modul x/svm verwaltet. Beide Darstellungen beziehen sich auf dasselbe zugrunde liegende Konto.


Rent-Modell​

Das SVM-Modul verwendet ein mietbasiertes Speichermodell, um Zustandsaufblähung zu verhindern:

ParameterWert
Lamports pro Byte pro Jahr3,480
Rent-Befreiungsmultiplikator2.0
ErhebungshäufigkeitJede Epoche
  • Accounts mit einem Guthaben über 2 * (data_size * 3480 / seconds_per_year) Lamports sind rent-befreit und werden nie belastet.
  • Accounts unter der Rent-Befreiungsschwelle werden jede Epoche mit Miete belastet. Erreicht das Guthaben null, wird das Account gelöscht.
Info

Best Practice: Statten Sie Daten-Accounts immer mit mehr als dem Rent-Befreiungsminimum aus, um eine unerwartete Kontolöschung zu vermeiden.


Compute-Budget​

Jede Instruktionsausführung wird mit Compute-Units gemessen:

ParameterWert
Max. Compute-Units pro Instruktion1,400,000
Max. CPI-Tiefe (Cross-Program Invocation)4
Max. Programmgröße10 MB
Max. Konto-Datengröße10 MB

Programme, die das Compute-Budget überschreiten, werden angehalten, und die Transaktion wird zurückgesetzt.


Parameterübersicht​

ParameterWert
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
JSON-RPC-Port8899

Cross-VM-Interoperabilität​

SVM-Programme sind dafür ausgelegt, über die Nachricht MsgCrossVMCall des Moduls x/crossvm mit EVM- und QoreChain Native-Contracts zu kommunizieren (die Chain ermittelt die Quellspur selbst). Da die SVM-Spur für Transaktionen deaktiviert und MsgCrossVMCall auf dem Mainnet abgeschaltet ist, gibt es heute keinen funktionierenden SVM-Cross-VM-Pfad. Siehe Cross-VM-Interoperabilität für den aktuellen Status, den Nachrichtenlebenszyklus und das Timeout-Verhalten.


Nächste Schritte​