> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getSignatureStatuses

> Возвращает статусы списка подписей

## Параметры

<ParamField query="signatures" type="array" required>
  Массив подписей транзакций для подтверждения в виде строк в кодировке base-58
</ParamField>

<ParamField query="config" type="object" optional>
  <Expandable title="поля конфигурации">
    <ParamField name="searchTransactionHistory" type="boolean" optional>
      Если true, узел Solana будет искать в своём кэше реестра подписи, не найденные в последнем кэше статусов
    </ParamField>
  </Expandable>
</ParamField>

## Ответ

<ResponseField name="result" type="object">
  <Expandable title="поля результата">
    <ResponseField name="context" type="object">
      <ResponseField name="slot" type="number">
        Слот, в котором был обработан этот запрос
      </ResponseField>
    </ResponseField>

    <ResponseField name="value" type="array">
      <Expandable title="элементы value">
        <ResponseField name="slot" type="number">
          Слот, в котором была обработана транзакция
        </ResponseField>

        <ResponseField name="confirmations" type="number | null">
          Количество блоков с момента подтверждения подписи, null если закреплено или не найдено
        </ResponseField>

        <ResponseField name="err" type="object | null">
          Ошибка, если транзакция не удалась, null если транзакция прошла успешно
        </ResponseField>

        <ResponseField name="confirmationStatus" type="string | null">
          Статус подтверждения транзакции в кластере: "processed", "confirmed" или "finalized"
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Примеры кода

### Базовый запрос

```bash theme={null}
curl http://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getSignatureStatuses",
  "params": [
    [
      "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
      "5j7s6NiJS3JAkvgkoc18WVAsiSaci2pxB2A6ueCJP4tprA2TFg9wSyTLeYouxPBJEMzJinENTkpA52YStRW5Dia7"
    ]
  ]
}'
```

### Использование web3.js

```typescript theme={null}
import { Connection } from '@solana/web3.js';

const connection = new Connection('http://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY');
const signatures = [
  '5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW',
  '5j7s6NiJS3JAkvgkoc18WVAsiSaci2pxB2A6ueCJP4tprA2TFg9wSyTLeYouxPBJEMzJinENTkpA52YStRW5Dia7'
];
const statuses = await connection.getSignatureStatuses(signatures);
console.log(statuses);
```

### Использование Python

```python theme={null}
from solana.rpc.api import Client

client = Client("http://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY")
signatures = [
    "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
    "5j7s6NiJS3JAkvgkoc18WVAsiSaci2pxB2A6ueCJP4tprA2TFg9wSyTLeYouxPBJEMzJinENTkpA52YStRW5Dia7"
]
response = client.get_signature_statuses(signatures)
print(response)
```

## Примечания

1. Возвращает статусы списка подписей транзакций
2. По умолчанию ищет только в последнем кэше статусов (последние \~5 минут транзакций)
3. Установка searchTransactionHistory в true позволит искать дальше в реестре
4. Значения null в массиве ответа указывают на подписи, которые не удалось найти
5. confirmationStatus указывает, насколько финализирована транзакция в сети

## Рекомендации

1. Используйте этот метод для проверки статуса недавно отправленных транзакций
2. Передавайте несколько подписей в одном запросе для снижения сетевых расходов
3. Устанавливайте searchTransactionHistory в true только при необходимости (влияние на производительность)
4. Обрабатывайте значения null в массиве ответа должным образом
5. Проверяйте confirmationStatus для определения уровня финализации транзакции