Параметры
Массив подписей транзакций для подтверждения в виде строк в кодировке base-58
Показать поля конфигурации
Ответ
Слот, в котором был обработан этот запрос
Слот, в котором была обработана транзакция
Количество блоков с момента подтверждения подписи, null если закреплено или не найдено
Ошибка, если транзакция не удалась, null если транзакция прошла успешно
Статус подтверждения транзакции в кластере: “processed”, “confirmed” или “finalized”
Примеры кода
Базовый запрос
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
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
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)
Примечания
- Возвращает статусы списка подписей транзакций
- По умолчанию ищет только в последнем кэше статусов (последние ~5 минут транзакций)
- Установка searchTransactionHistory в true позволит искать дальше в реестре
- Значения null в массиве ответа указывают на подписи, которые не удалось найти
- confirmationStatus указывает, насколько финализирована транзакция в сети
Рекомендации
- Используйте этот метод для проверки статуса недавно отправленных транзакций
- Передавайте несколько подписей в одном запросе для снижения сетевых расходов
- Устанавливайте searchTransactionHistory в true только при необходимости (влияние на производительность)
- Обрабатывайте значения null в массиве ответа должным образом
- Проверяйте confirmationStatus для определения уровня финализации транзакции
