Тестирование пользовательской программы 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 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");}
Полная настройка тестирования программы
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
Использование стандартных программ
Для тестирования, требующего стандартных программ:
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.
Схема всегда одинакова:
- Загрузка программы: Используйте
addProgramFromFileдля загрузки скомпилированных программ и импортируйте myProgramPlugin() из вашего клиента - Конфигурация: Включите sysvars, builtins и precompiles по мере необходимости
- Настройка аккаунтов: Предварительно заполните аккаунты данных с помощью
setAccount - Отправка: Используйте
client.myProgram.testInstruction({..}).sendTransaction()— без ручного формирования транзакций - Проверка: Проверьте состояние аккаунта после выполнения
(
client.myProgram.myAccount.fetch)
Как только этот каркас заработает, вы сможете создать полный набор тестов, добавляя новые инструкции и проверки.
Is this page helpful?