Configuration

LiteSVM utilise un patron de construction pour la configuration. Toutes les méthodes retournent LiteSVM pour le chaînage.

Configuration typique d'un test

import { createClient, generateKeyPairSigner } from "@solana/kit";
import { litesvm } from "@solana/kit-plugin-litesvm";
import { signer } from "@solana/kit-plugin-signer";

const mySigner = await generateKeyPairSigner();
const client = createClient().use(signer(mySigner)).use(litesvm());

client.svm
  .withSigverify(false) // Skip signature verification (faster)
  .withBlockhashCheck(false) // Skip blockhash validation (simpler)
  .withSysvars() // Enable Clock, Rent, etc.
  .withBuiltins() // Enable ed25519, secp256k1
  .withTransactionHistory(100n); // Store last 100 transactions

Signature & Blockhash

withSigverify

withSigverify(sigverify: boolean): LiteSVM

Activer ou désactiver la vérification des signatures.

// Disable for faster tests (default is enabled)
client.svm.withSigverify(false);

// Enable for production-like testing
client.svm.withSigverify(true);

Désactiver la vérification des signatures rend les tests plus rapides mais moins réalistes.

withBlockhashCheck

withBlockhashCheck(check: boolean): LiteSVM

Activer ou désactiver la vérification d'expiration du blockhash.

// Disable for simpler tests
client.svm.withBlockhashCheck(false);

Programmes & Sysvars

withSysvars

withSysvars(): LiteSVM

Activer les comptes sysvar (Clock, Rent, EpochSchedule, etc.).

client.svm.withSysvars();

// Now you can access sysvars
const clock = client.svm.getClock();
const rent = client.svm.getRent();

withBuiltins

withBuiltins(): LiteSVM

Activer les programmes intégrés (vérification de signatures ed25519, secp256k1).

client.svm.withBuiltins();

withPrecompiles

withPrecompiles(): LiteSVM

Activer les programmes précompilés.

client.svm.withPrecompiles();

withDefaultPrograms

withDefaultPrograms(): LiteSVM

Ajouter les programmes par défaut (System Program, BPF Loader, etc.).

client.svm.withDefaultPrograms();

Limites de ressources

withLamports

withLamports(lamports: bigint): LiteSVM

Définir les lamport par défaut pour les comptes.

client.svm.withLamports(1_000_000_000n); // 1 SOL

withLogBytesLimit

withLogBytesLimit(limit?: bigint): LiteSVM

Définir la limite d'octets pour la sortie des journaux.

client.svm.withLogBytesLimit(10000n);

withTransactionHistory

withTransactionHistory(capacity: bigint): LiteSVM

Activer le stockage de l'historique des transactions.

// Store last 100 transactions
client.svm.withTransactionHistory(100n);

Ensembles de fonctionnalités

withFeatureSet

withFeatureSet(featureSet: FeatureSet): LiteSVM

Configurer l'ensemble de fonctionnalités pour tester des versions spécifiques de Solana.

Table des matières