Guide SVM
@qorechain/svm est un adaptateur fin et fortement typé au-dessus de
@solana/web3.js pour le JSON-RPC
compatible Solana de QoreChain. @solana/web3.js est une dépendance pair. Le paquet
ajoute une fabrique de client ciblant le point de terminaison RPC SVM, des assistants de clés,
des wrappers de lecture typés, la construction/signature/envoi de transferts SOL, et des
constructeurs d'instructions minimaux pour les programmes natifs.
npm i @qorechain/svm @solana/web3.js
La voie d'exécution SVM est désactivée sur l'ensemble du réseau pour l'envoi de transactions
(code 11, "SVM module is disabled"), et les points de terminaison RPC SVM publics sont
en lecture seule. Les lectures (getBalance, getAccountInfo, getSlot,
getSignaturesForAddress, getMinimumBalanceForRentExemption,
getLatestBlockhash) fonctionnent. Ne construisez pas encore de flux de transfert ou de déploiement de programme sur
SVM : les assistants de construction, de signature et d'envoi ci-dessous constituent la surface de la bibliothèque cliente
et ne peuvent aujourd'hui faire aboutir aucune transaction sur les réseaux publics. Voir
Développement SVM.
Créer un client
import { createSvmClient } from "@qorechain/svm";
const client = createSvmClient({
endpoints: { svmRpc: "https://svm-testnet.qore.host" }, // mainnet: https://svm.qore.host
});
Vous pouvez aussi passer rpcUrl, une connection existante, ou vous appuyer sur
DEFAULT_SVM_RPC_URL (localhost 8899).
Clés
Reconstruisez un Keypair @solana/web3.js à partir d'une clé secrète SVM dérivée, ou
affichez une adresse :
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
Transférer du SOL
Construisez un transfert non signé (hors ligne). L'envoi est présenté par souci d'exhaustivité, mais il ne peut pas aboutir sur les réseaux publics tant que la voie de transactions SVM est désactivée :
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);
Programmes
Constructeurs pour les programmes natifs courants plus un constructeur d'invocation générique :
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.
Voir l'exemple svm-transfer pour une version exécutable.