Saltar al contenido principal

Guía de SVM

@qorechain/svm es un adaptador ligero y con tipado seguro sobre @solana/web3.js para el JSON-RPC compatible con Solana de QoreChain. @solana/web3.js es una dependencia entre pares. El paquete añade una factoría de clientes que apunta al endpoint RPC de SVM, utilidades para claves, envoltorios de lectura tipados, construcción/firma/envío de transferencias de SOL y constructores mínimos de instrucciones de programas nativos.

npm i @qorechain/svm @solana/web3.js
El envío de transacciones SVM está desactivado

El carril de ejecución SVM está desactivado en toda la red para el envío de transacciones (code 11, "SVM module is disabled"), y los endpoints RPC públicos de SVM son de solo lectura. Las lecturas (getBalance, getAccountInfo, getSlot, getSignaturesForAddress, getMinimumBalanceForRentExemption, getLatestBlockhash) funcionan. No construyas todavía un flujo de transferencia ni de despliegue de programas sobre SVM: los ayudantes de construcción, firma y envío que se muestran abajo son la superficie de la biblioteca cliente y hoy no pueden incluir una transacción en las redes públicas. Consulta Desarrollo en SVM.

Crear un cliente​

import { createSvmClient } from "@qorechain/svm";

const client = createSvmClient({
endpoints: { svmRpc: "https://svm-testnet.qore.host" }, // mainnet: https://svm.qore.host
});

También puedes pasar rpcUrl, una connection existente, o apoyarte en DEFAULT_SVM_RPC_URL (localhost 8899).

Claves​

Reconstruye un Keypair de @solana/web3.js a partir de una clave secreta SVM derivada, o imprime una dirección:

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

Transferir SOL​

Construye una transferencia sin firmar (sin conexión). El envío se muestra para completar el ejemplo, pero no puede tener éxito en las redes públicas mientras el carril de transacciones SVM esté desactivado:

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

Programas​

Constructores para los programas nativos comunes más un constructor de invocación genérico:

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.

Consulta el ejemplo svm-transfer para una versión ejecutable.