Транзакції

Методи для відправлення, симуляції та керування транзакціями.

sendTransaction

sendTransaction(tx: Transaction): TransactionMetadata | FailedTransactionMetadata

Виконати транзакцію. Повертає метадані в разі успіху або деталі помилки в разі невдачі.

const result = client.svm.sendTransaction(signedTx);

// Check for errors
if ("err" in result && result.err()) {
  console.error("Transaction failed:", result.err());
  return;
}

// Access result properties (note: these are getter functions)
console.log("Signature:", result.signature());
console.log("Compute units:", result.computeUnitsConsumed());
console.log("Logs:", result.logs());

Властивості результату транзакції, такі як err(), computeUnitsConsumed(), logs() та signature(), є функціями-гетерами, а не властивостями. Завжди викликайте їх з дужками.

Методи TransactionMetadata

Метод	Повертає	Опис
`signature()`	`Uint8Array`	Байти підпису транзакції
`computeUnitsConsumed()`	`bigint`	Використані одиниці обчислення
`logs()`	`string[]`	Журнали програми
`innerInstructions()`	`InnerInstruction[]`	Внутрішні інструкції (CPI)
`returnData()`	`TransactionReturnData`	Дані, повернуті програмами
`prettyLogs()`	`string`	Відформатовані журнали з кольорами

simulateTransaction

simulateTransaction(tx: Transaction): SimulatedTransactionInfo | FailedTransactionMetadata

Симулювати транзакцію без зміни стану.

const simResult = client.svm.simulateTransaction(signedTx);

if ("err" in simResult && simResult.err()) {
  console.error("Simulation failed:", simResult.err());
  return;
}

// Use .meta() to get TransactionMetadata
const meta = simResult.meta();
console.log("Would use", meta.computeUnitsConsumed(), "compute units");
console.log("Logs:", meta.logs());

// Get post-execution account states
const postAccounts = simResult.postAccounts();
console.log("Post-state accounts:", postAccounts);

Симуляція не змінює стан. Використовуйте її для перевірки транзакцій перед відправленням.

Керування блокхешем

latestBlockhash

latestBlockhash(): Blockhash

Отримати поточний блокхеш.

const blockhash = client.svm.latestBlockhash();
console.log("Blockhash:", blockhash);

getLatestBlockhash (через client.rpc)

Отримати блокхеш разом з інформацією про термін дії для ручного формування транзакцій. Використовуйте RPC-помічник, оскільки він повертає як blockhash, так і lastValidBlockHeight.

import {
  createTransactionMessage,
  setTransactionMessageLifetimeUsingBlockhash
} from "@solana/kit";

const { value: blockhashLifetime } = await client.rpc
  .getLatestBlockhash()
  .send();

const tx = setTransactionMessageLifetimeUsingBlockhash(
  blockhashLifetime,
  createTransactionMessage({ version: 0 })
);

Під час використання плагінів програм, таких як systemProgram() або tokenProgram(), вам ніколи не потрібно отримувати блокхеш самостійно — client.sendTransaction() (і помічник .sendTransaction() у ланцюжках інструкцій) роблять це за вас.

expireBlockhash

expireBlockhash(): LiteSVM

Перейти до нового блокхешу. Корисно для тестування сценаріїв із закінченням терміну дії блокхешу.

const oldBlockhash = client.svm.latestBlockhash();
client.svm.expireBlockhash();
const newBlockhash = client.svm.latestBlockhash();

console.log("Old:", oldBlockhash);
console.log("New:", newBlockhash);
// Blockhashes will be different

Історія транзакцій

Увімкніть історію транзакцій для отримання транзакцій після їх відправлення:

// Enable history storage (stores last N transactions)
client.svm.withTransactionHistory(100n);

// Send a transaction
const result = client.svm.sendTransaction(signedTx);

// Later, retrieve it by signature (base58 string)
// Note: getTransaction expects a base58-encoded signature string

Зміст