Документація SolanaLiteSVMTypeScriptПриклади

Тестування програм

Тестування власної програми Solana означає завантаження скомпільованого файлу .so у SVM, налаштування очікуваних акаунтів і надсилання інструкцій до неї. LiteSVM виконує все це у процесі — validator не потрібен. Ми рекомендуємо генерувати клієнти програм за допомогою Codama JS Renderer, щоб мати доступ до сумісного Kit Plugin.

Завантаження програми

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 testing
client.svm
.withSigverify(false)
.withBlockhashCheck(false)
.withSysvars()
.withBuiltins();
// Load program from .so file
const 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 account
const 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");
}

Повне налаштування тесту програми

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 program
const 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 accounts
const 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 transaction
await client.myProgram.testInstruction({..}).sendTransaction();
// Verify state changes
const updatedAccount = client.myProgram.myAccount.fetch(dataAccountAddress);
// assert on decoded account

Використання стандартних програм

Для тестування, яке вимагає стандартних програм:

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

Зберіть вашу програму Solana за допомогою cargo build-sbf, щоб згенерувати файл .so.

Шаблон завжди однаковий:

  1. Завантаження програми: Використовуйте addProgramFromFile для завантаження скомпільованих програм і імпортуйте myProgramPlugin() з вашого клієнта
  2. Конфігурація: Увімкніть sysvars, builtins і precompiles за потреби
  3. Налаштування акаунтів: Попередньо заповніть акаунти даних за допомогою setAccount
  4. Надсилання: Використовуйте client.myProgram.testInstruction({..}).sendTransaction() — без ручного формування транзакцій
  5. Перевірка: Перевірте стан акаунта після виконання (client.myProgram.myAccount.fetch)

Після того як цей каркас запрацює, ви зможете побудувати повний набір тестів, додаючи більше інструкцій та перевірок.

Is this page helpful?

Зміст

Редагувати сторінку