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).
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.
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/getAccountInfoliefern das native QOR-Guthaben des Kontos (in Lamports).getSignaturesForAddressliefert 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-
MsgSendoder 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.
| Eigenschaft | Wert |
|---|---|
| Standard-URL | http://127.0.0.1:8899 |
| Aktiviert | Ja, standardmäßig |
| Gestartet von | qorechaind start |
| Kompatibilität | Solana JSON-RPC (Teilmenge) |
getVersion | 1.18.0-qorechain |
Unterstützte Methoden
| Methode | Beschreibung |
|---|---|
getAccountInfo | Kontodaten und Lamport-Guthaben abrufen |
getBalance | Kontoguthaben in Lamports abrufen (natives QOR) |
getSignaturesForAddress | Transaktionsverlauf für eine Adresse |
getSlot | Aktuelle Slot-Nummer |
getMinimumBalanceForRentExemption | Mindestguthaben für eine gegebene Datengröße |
getVersion | Versionsinformationen der SVM-Laufzeit |
getHealth | Health-Check für den SVM-Endpunkt |
getGenesisHash | Genesis-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
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.
-
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 programqorechaind tx svm deploy-program ./my_program.so \--from mykey \--gas 2000000 --fees 200000uqor \--generate-only > tx.jsonAuf einem Netzwerk, in dem die Spur aktiviert ist, ist jeder
tx svm-Befehl eine Transaktion auf dem Cosmos-Pfad: Signieren und übertragen Sietx.jsonmitqorechaind 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. -
Eine Instruktion ausführen — Rufen Sie ein On-Chain-BPF-Programm mit Instruktionsdaten auf:
# Execute instructionqorechaind tx svm execute <program-id-base58> <data-hex> \--from mykey \--gas 400000 --fees 40000uqor \--generate-only > tx.jsonParameter Format Beschreibung program-id-base58Base58-String Die Adresse des bereitgestellten Programms data-hexHex-kodierte Bytes Serialisierte Instruktionsdaten -
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 accountqorechaind tx svm create-account <owner-base58> <space> <lamports> \--from mykey \--gas 400000 --fees 40000uqor \--generate-only > tx.jsonParameter Beschreibung 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: getMinimumBalanceForRentExemptioncurl -X POST http://localhost:8899 \-H "Content-Type: application/json" \-d '{"jsonrpc": "2.0","id": 1,"method": "getMinimumBalanceForRentExemption","params": [1024]}' -
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 healthconst health = await connection.getHealth();console.log("SVM health:", health);// Get slotconst slot = await connection.getSlot();console.log("Current slot:", slot);// Get account infoconst pubkey = new PublicKey("YourBase58ProgramId...");const accountInfo = await connection.getAccountInfo(pubkey);console.log("Account data:", accountInfo);// Get balanceconst 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:
| Richtung | Beispiel |
|---|---|
| Nativ zu SVM | qor1abc...xyz wird auf eine deterministische Base58-Adresse abgebildet |
| SVM zu Nativ | Base58-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:
| Parameter | Wert |
|---|---|
| Lamports pro Byte pro Jahr | 3,480 |
| Rent-Befreiungsmultiplikator | 2.0 |
| Erhebungshäufigkeit | Jede 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.
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:
| Parameter | Wert |
|---|---|
| Max. Compute-Units pro Instruktion | 1,400,000 |
| Max. CPI-Tiefe (Cross-Program Invocation) | 4 |
| Max. Programmgröße | 10 MB |
| Max. Konto-Datengröße | 10 MB |
Programme, die das Compute-Budget überschreiten, werden angehalten, und die Transaktion wird zurückgesetzt.
Parameterübersicht
| Parameter | Wert |
|---|---|
max_program_size | 10 MB |
max_account_data_size | 10 MB |
compute_budget_max | 1,400,000 CU |
max_cpi_depth | 4 |
lamports_per_byte_year | 3,480 |
rent_exemption_multiplier | 2.0 |
| JSON-RPC-Port | 8899 |
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
- Cross-VM-Interoperabilität — Kommunikation zwischen SVM, EVM und QoreChain Native
- EVM-Entwicklung — Solidity-Smart-Contracts auf QoreChain
- QoreChain Native-Entwicklung — Rust-basierte WebAssembly-Contracts