SVM-Leitfaden
@qorechain/svm ist ein schlanker, typsicherer Adapter über
@solana/web3.js für QoreChains
Solana-kompatibles JSON-RPC. @solana/web3.js ist eine Peer-Abhängigkeit. Das Paket
ergänzt eine Client-Factory, die auf den SVM-RPC-Endpunkt abzielt, Schlüsselhelfer, typisierte
Lese-Wrapper, Aufbau/Signieren/Senden von SOL-Überweisungen sowie minimale Builder für
Anweisungen nativer Programme.
npm i @qorechain/svm @solana/web3.js
Die SVM-Ausführungs-Lane ist netzwerkweit für das Senden von Transaktionen deaktiviert
(code 11, "SVM module is disabled"), und die öffentlichen SVM-RPC-Endpunkte sind
schreibgeschützt. Lesezugriffe (getBalance, getAccountInfo, getSlot,
getSignaturesForAddress, getMinimumBalanceForRentExemption,
getLatestBlockhash) funktionieren. Bauen Sie noch keinen Überweisungs- oder Programm-Deployment-Ablauf auf
SVM auf: Die unten gezeigten Build-, Sign- und Send-Helfer sind die Oberfläche der Client-Bibliothek
und können heute keine Transaktion in den öffentlichen Netzwerken unterbringen. Siehe
SVM-Entwicklung.
Einen Client erstellen
import { createSvmClient } from "@qorechain/svm";
const client = createSvmClient({
endpoints: { svmRpc: "https://svm-testnet.qore.host" }, // mainnet: https://svm.qore.host
});
Sie können auch rpcUrl, eine bestehende connection übergeben oder sich auf
DEFAULT_SVM_RPC_URL (localhost 8899) verlassen.
Schlüssel
Rekonstruieren Sie ein @solana/web3.js-Keypair aus einem abgeleiteten SVM-Geheimschlüssel oder
geben Sie eine Adresse aus:
import { deriveSvmAccount } from "@qorechain/sdk";
import { svmKeypairFromSecretKey, svmAddress } from "@qorechain/svm";
const account = await deriveSvmAccount(mnemonic);
const keypair = svmKeypairFromSecretKey(account.secretKey);
console.log(svmAddress(keypair)); // base58
SOL überweisen
Erstellen Sie eine unsignierte Überweisung (offline). Das Senden wird der Vollständigkeit halber gezeigt, kann aber in den öffentlichen Netzwerken nicht gelingen, solange die SVM-Transaktions-Lane deaktiviert ist:
import { LAMPORTS_PER_SOL, PublicKey } from "@solana/web3.js";
const lamports = Math.round(0.01 * LAMPORTS_PER_SOL);
const recipient = new PublicKey("<recipient base58 address>"); // `to` is a PublicKey, not a string
// Build only (no broadcast):
const tx = client.buildTransferSol({ from: keypair, to: recipient, lamports });
// Or build + sign + send + confirm in one call:
// const sig = await client.transferSol({ from: keypair, to: recipient, lamports });
// Send an arbitrary transaction:
// const sig = await client.sendTransaction(tx, [keypair]);
// Simulate without submitting:
// const sim = await client.simulateTransaction(tx);
Programme
Builder für die gängigen nativen Programme sowie ein generischer Invoke-Builder:
import {
createMemoInstruction,
createTransferTokenInstruction,
createAssociatedTokenAccountInstruction,
getAssociatedTokenAddress,
createInvokeInstruction,
PROGRAM_IDS,
SYSTEM_PROGRAM_ID,
TOKEN_PROGRAM_ID,
ASSOCIATED_TOKEN_PROGRAM_ID,
MEMO_PROGRAM_ID,
} from "@qorechain/svm";
// Attach a memo to a transaction.
tx.add(createMemoInstruction("hello from @qorechain/svm", [keypair.publicKey]));
// SPL-Token transfer, ATA creation, and a generic program invoke are also
// available via the builders above.
Eine lauffähige Version finden Sie im svm-transfer-Beispiel.