Testowanie własnego programu Solana polega na załadowaniu skompilowanego pliku .so do
SVM, skonfigurowaniu oczekiwanych przez niego kont i wysyłaniu do niego instrukcji.
LiteSVM obsługuje to wszystko w procesie — nie jest potrzebny żaden validator. Zalecamy
generowanie klientów programów za pomocą
Codama JS Renderer, aby mieć
dostęp do kompatybilnej wtyczki Kit Plugin.
Ładowanie programu
import { createClient, address, generateKeyPairSigner } from "@solana/kit";import { litesvm } from "@solana/kit-plugin-litesvm";import { signer } from "@solana/kit-plugin-signer";import { myProgramPlugin } from "@my-program/sdk";import * as fs from "node:fs";const mySigner = await generateKeyPairSigner();const client = createClient().use(signer(mySigner)).use(litesvm()).use(myProgramPlugin());// Configure for program testingclient.svm.withSigverify(false).withBlockhashCheck(false).withSysvars().withBuiltins();// Load program from .so fileconst programId = address("YourProgramId111111111111111111111111111");const soPath = "/path/to/target/deploy/my_program.so";if (fs.existsSync(soPath)) {client.svm.addProgramFromFile(programId, soPath);console.log("Program loaded:", programId);// Verify program accountconst programAccount = client.svm.getAccount(programId);if (programAccount.exists) {console.log(" Executable:", programAccount.executable);console.log(" Data size:", programAccount.data.length, "bytes");}} else {console.log("Program file not found:", soPath);console.log("Build with: cargo build-sbf");}
Kompletna konfiguracja testu programu
import { createClient, address, generateKeyPairSigner, lamports } from '@solana/kit';import { litesvm } from '@solana/kit-plugin-litesvm';import { signer } from '@solana/kit-plugin-signer';import { myProgramPlugin } from '@my-program/sdk';import * as fs from 'node:fs';const mySigner = await generateKeyPairSigner();const client = createClient().use(signer(mySigner)).use(litesvm()).use(myProgramPlugin());client.svm.withSigverify(false).withBlockhashCheck(false).withSysvars().withBuiltins().withPrecompiles().withTransactionHistory(100n);// Load programconst programId = address('YourProgramId111111111111111111111111111');const soPath = '/path/to/target/deploy/my_program.so';if (fs.existsSync(soPath)) {client.svm.addProgramFromFile(programId, soPath);}// Set up any required data accountsconst dataAccountAddress = address('DataAccount111111111111111111111111111');const minBalance = client.svm.minimumBalanceForRentExemption(100n);client.svm.setAccount({address: dataAccountAddress,data: new Uint8Array(100),executable: false,lamports: lamports(minBalance),programAddress: programId,space: 100n,});// Send the transactionawait client.myProgram.testInstruction({..}).sendTransaction();// Verify state changesconst updatedAccount = client.myProgram.myAccount.fetch(dataAccountAddress);// assert on decoded account
Korzystanie z domyślnych programów
Do testowania wymagającego standardowych programów:
const mySigner = await generateKeyPairSigner();const client = createClient().use(signer(mySigner)).use(litesvm());// Add all default programs (System, BPF Loader, etc.)client.svm.withDefaultPrograms();// Or add specific programs you need// The Token program, Associated Token program, etc. would need// to be added manually via addProgramFromFile if needed
Zbuduj swój program Solana za pomocą cargo build-sbf, aby wygenerować plik .so.
Schemat jest zawsze taki sam:
- Ładowanie programu: Użyj
addProgramFromFiledo załadowania skompilowanych programów i zaimportuj myProgramPlugin() ze swojego klienta - Konfiguracja: Włącz sysvars, wbudowane elementy i prekompilacje według potrzeb
- Konfiguracja kont: Wstępnie wypełnij konta danych za pomocą
setAccount - Wysyłanie: Użyj
client.myProgram.testInstruction({..}).sendTransaction()— bez ręcznego budowania transakcji - Weryfikacja: Sprawdź stan konta po wykonaniu
(
client.myProgram.myAccount.fetch)
Gdy ten szkielet zacznie działać, możesz rozbudować pełny zestaw testów, dodając kolejne instrukcje i asercje.
Is this page helpful?