> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Как использовать getTransaction
> Узнайте о сценариях использования getTransaction, примерах кода, параметрах запроса, структуре ответа и рекомендациях.
Метод RPC [`getTransaction`](https://www.helius.dev/docs/api-reference/rpc/http/gettransaction) позволяет получить подробную информацию о подтвержденной транзакции по ее подписи. Эта информация включает слот транзакции, время блока, метаданные (например, комиссии, статус и изменения баланса), а также структуру самой транзакции.
**Для повышения производительности не объединяйте запросы в пакеты**
Пакетное выполнение архивных методов значительно увеличивает задержку. Пакеты размером более 100 запросов не допускаются.
## Распространенные сценарии использования
* **Проверка транзакции:** подтверждение обработки транзакции и проверка ее результата (успех или ошибка).
* **Отображение истории транзакций:** отображение пользователям сведений об их прошлых транзакциях в кошельке или обозревателе.
* **Аудит и анализ:** изучение деталей транзакции, включая выполненные инструкции, уплаченные комиссии и задействованные аккаунты.
* **Отладка неуспешных транзакций:** проверка полей `logMessages` и `err` в метаданных, чтобы понять причину сбоя транзакции.
* **Индексирование данных:** извлечение определенной информации из транзакций для хранения и анализа вне блокчейна.
## Параметры запроса
1. **`transactionSignature`** (строка, обязательный): подпись транзакции в кодировке base58, которую требуется запросить.
2. **`options`** (объект, необязательный): необязательный объект конфигурации, который может включать:
* **`commitment`** (строка, необязательный): задает [уровень подтверждения](https://www.helius.dev/blog/solana-commitment-levels) (например, `"finalized"`, `"confirmed"`). Если параметр не указан, используется уровень подтверждения узла по умолчанию (обычно `"finalized"`).
* **`encoding`** (строка, необязательный): кодировка данных `transaction`. Распространенные значения:
* `"json"`: возвращает данные транзакции в структурированном формате JSON (однако инструкции могут по-прежнему быть закодированы в base64).
* `"jsonParsed"`: возвращает данные транзакции, по возможности преобразуя инструкции конкретных программ в удобочитаемую структуру JSON. Эта кодировка часто наиболее удобна для анализа.
* `"base58"`: возвращает данные транзакции в виде строки в кодировке base58.
* `"base64"`: возвращает данные транзакции в виде строки в кодировке base64.
* Если Helius не задает значение, по умолчанию используется `"json"`, однако значение по умолчанию в Solana может отличаться. Рекомендуется указывать этот параметр явно.
* **`maxSupportedTransactionVersion`** (число, необязательный): максимальная версия транзакции, которую должна обрабатывать конечная точка RPC.
* Установите значение `1`, чтобы включить устаревшие транзакции, а также транзакции v0 и v1.
* Если параметр не указан или его значение ниже версии транзакции, запрос завершается ошибкой JSON-RPC `-32015` (`Transaction version (1) is not supported by the requesting client`). Всегда устанавливайте для него значение `1`. См. раздел [Поддержка транзакций v1](/docs/ru/rpc/transaction-v1).
## Структура ответа
Метод возвращает `null`, если транзакция не найдена (например, еще не обработана или подпись указана неверно) либо не подтверждена на указанном уровне. В противном случае он возвращает объект со следующими полями:
* **`slot`** (u64): номер слота, в котором транзакция была включена в блок.
* **`blockTime`** (i64 | null): приблизительная временная метка Unix (количество секунд с начала эпохи), соответствующая моменту создания блока с транзакцией. Если значение недоступно, может быть `null`.
* **`meta`** (объект | null): объект с метаданными о выполнении транзакции. Может иметь значение `null`, если транзакция завершилась с ошибкой до обработки или метаданные недоступны.
* **`err`** (объект | null): объект ошибки, если транзакция завершилась с ошибкой; в противном случае — `null`.
* **`fee`** (u64): комиссия за транзакцию в лампортах.
* **`preBalances`** (массив u64): балансы задействованных аккаунтов в лампортах *до* обработки транзакции.
* **`postBalances`** (массив u64): балансы задействованных аккаунтов в лампортах *после* обработки транзакции.
* **`preTokenBalances`** (массив объектов | null): балансы токенов на задействованных токен-аккаунтах *до* транзакции.
* **`postTokenBalances`** (массив объектов | null): балансы токенов на задействованных токен-аккаунтах *после* транзакции.
* **`innerInstructions`** (массив объектов | null): массив инструкций, выполненных в рамках CPI (межпрограммных вызовов) в этой транзакции.
* **`logMessages`** (массив строк | null): массив сообщений журнала, созданных инструкциями транзакции и всеми внутренними инструкциями.
* **`loadedAddresses`** (объект, необязательный): указывает аккаунты, загруженные из таблиц поиска адресов для этой транзакции. Содержит массивы открытых ключей `writable` и `readonly`.
* **`returnData`** (объект, необязательный): данные, возвращенные транзакцией через `sol_set_return_data` и `sol_get_return_data`. Содержит `programId` (строка) и `data` (массив: `[string, encoding]`).
* **`computeUnitsConsumed`** (u64, необязательный): количество вычислительных единиц, использованных этой транзакцией.
* **`transaction`** (объект | массив): структура самой транзакции. Формат зависит от параметра `encoding`:
* Если `encoding` имеет значение `"jsonParsed"` или `"json"`: объект с `message` (содержащим `accountKeys`, `instructions`, `recentBlockhash` и т. д.) и `signatures` (массив строк).
* Если `encoding` имеет значение `"base58"` или `"base64"`: массив `[encoded_string, encoding_format_string]`.
* **`version`** ("legacy" | число | undefined): версия транзакции. Для старых транзакций может иметь значение `"legacy"`, а для версионированных — числовое значение (`0` или `1`). Значение `undefined`, если параметр `maxSupportedTransactionVersion` не задан, а транзакция является версионированной. Транзакция v1 также содержит объект `transactionConfig` в своем `message` с бюджетом вычислений (`computeUnitLimit`, `heapSize`, `loadedAccountsDataSizeLimit`, `priorityFee`), который заменяет инструкции программы ComputeBudget. Поле `priorityFee` содержит общую комиссию в лампортах, а не количество микролампортов на вычислительную единицу.
**Пример ответа (кодировка `jsonParsed`):**
```json theme={"system"}
{
"jsonrpc": "2.0",
"result": {
"blockTime": 1635900000,
"meta": {
"err": null,
"fee": 5000,
"innerInstructions": [],
"logMessages": [
"Program Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS invoke [1]",
"Program log: Memo 'Hello, Solana!'",
"Program Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS success"
],
"postBalances": [
499999999999994999,
1000000000
],
"postTokenBalances": [],
"preBalances": [
500000000000000000,
1000000000
],
"preTokenBalances": [],
"rewards": [],
"status": { "Ok": null },
"computeUnitsConsumed": 200
},
"slot": 98765432,
"transaction": {
"message": {
"accountKeys": [
"SysvarRent111111111111111111111111111111111",
"Vote111111111111111111111111111111111111111"
],
"instructions": [
{
"parsed": {
"type": "vote",
"info": {
"votePubkey": "Vote111111111111111111111111111111111111111",
"slot": 123,
"hash": "abc..."
}
},
"program": "vote",
"programId": "Vote111111111111111111111111111111111111111"
}
],
"recentBlockhash": "xyz..."
},
"signatures": [
"sig1..."
]
},
"version": "legacy"
},
"id": 1
}
```
## Примеры кода
```bash cURL theme={"system"}
# Replace with an actual signature
curl -X POST -H "Content-Type: application/json" -d \
'{
"jsonrpc": "2.0",
"id": 1,
"method": "getTransaction",
"params": [
"",
{
"encoding": "jsonParsed",
"maxSupportedTransactionVersion": 1
}
]
}' \
```
```javascript JavaScript (using @solana/web3.js) theme={"system"}
const { Connection } = require('@solana/web3.js');
async function getTransactionDetails(signature) {
// Replace with your RPC endpoint
const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=');
try {
const transaction = await connection.getTransaction(signature, {
maxSupportedTransactionVersion: 1, // Required for legacy, v0, and v1 transactions
// commitment: 'confirmed', // Optional: specify commitment level
});
if (transaction) {
console.log('Transaction Details:');
console.log(` Slot: ${transaction.slot}`);
console.log(` Block Time: ${transaction.blockTime ? new Date(transaction.blockTime * 1000).toLocaleString() : 'N/A'}`);
console.log(` Fee: ${transaction.meta ? transaction.meta.fee : 'N/A'} lamports`);
console.log(` Status: ${transaction.meta && transaction.meta.err ? 'Failed' : 'Success'}`);
if (transaction.meta && transaction.meta.err) {
console.log(` Error: ${JSON.stringify(transaction.meta.err)}`);
}
// console.log(JSON.stringify(transaction, null, 2)); // Log full transaction details
if (transaction.meta && transaction.meta.logMessages) {
console.log(' Log Messages:');
transaction.meta.logMessages.forEach(log => console.log(` ${log}`));
}
} else {
console.log('Transaction not found or not confirmed.');
}
} catch (error) {
console.error(`Error fetching transaction ${signature}:`, error);
}
}
// Replace with an actual transaction signature from Mainnet-beta or your test environment
const exampleSignature = '5h4zCwobYsdL3mY26FgfXy8c4rTPkX6gYVXW8w2tTjCXZMWzE9jX9p8Q2Y8Yj9p8ZQ8Yj9p8ZQ8Yj9p8ZQ8Yj9'; // Replace with a real signature
// getTransactionDetails(exampleSignature);
// Example of a known transaction (you'll need to find a recent one on an explorer)
// getTransactionDetails('2xNdnHjZDmJRy1L6jC1mF87K3V9nXZo2bY6vA8GzQ3T7bS9xU8cM7sR5eD3fG2hJ1aB0cE9lK6mN5pP4qR7');
console.log("Please replace 'exampleSignature' with a real transaction signature to run the example.");
```
## Рекомендации разработчикам
* **Финализация транзакции:** запрашивайте данные с подходящим уровнем `commitment`. При запросе транзакции, которая не достигла указанного уровня подтверждения, будет возвращено значение `null`.
* **Объем данных:** объект ответа может быть очень большим, особенно для сложных транзакций с множеством инструкций или подробным журналированием. Учитывайте это при обработке данных.
* **`jsonParsed` и `json`:** хотя `jsonParsed` очень удобен, поддержка синтаксического анализа зависит от возможностей узла RPC для конкретных программ. Если программа не распознана, ее инструкции могут быть представлены в менее структурированном формате даже при использовании `jsonParsed`.
* **Версионированные транзакции:** всегда задавайте `maxSupportedTransactionVersion: 1` в параметрах запроса, чтобы ваше приложение могло обрабатывать как устаревшие, так и версионированные транзакции. В противном случае вы можете пропустить данные или столкнуться с ошибками при работе с новыми форматами транзакций.
* **Различия между поставщиками RPC:** хотя основной API стандартизирован, некоторые поставщики RPC могут предлагать расширенный синтаксический анализ или дополнительные поля. Например, Helius обеспечивает подробный анализ транзакций.
В этом руководстве представлен исчерпывающий обзор метода RPC `getTransaction`, который поможет вам получать и понимать подробные данные о транзакциях Solana.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.