Кальтер / Блог

Solana TXID найден, но getTransaction возвращает null: что проверить

Почему Solana RPC возвращает null по signature: проверка сети, commitment и конфигурации. Пример запроса и порядок действий без повторного перевода.

Материал подготовлен с помощью ИИ; первичные источники и примеры проверены редакцией ZASLON 14 ноября 2026 года. Учебные данные и результаты сторонних компаний обозначены в тексте.

Редакционная схема: Ответ Solana RPC. Условные обозначения, не скриншот сервиса или реальной операции.
Редакционная схема: Ответ Solana RPC. Условные обозначения, не скриншот сервиса или реальной операции.

В Solana RPC getTransaction возвращает транзакцию по signature либо null, если она не найдена или ещё не подтверждена на запрошенном уровне commitment. Поэтому null — это ответ «по этому запросу данных нет», а не доказательство, что средства потеряны или что сеть не списала комиссию. Документация Solana RPC. В самой документации приведён пример запроса; результат не фиксирован: он зависит от того, найдена ли транзакция на выбранном commitment и что возвращает конкретный RPC endpoint.

Если TXID уже есть, проверь четыре вещи: скопирована ли signature целиком, выбран ли правильный cluster (mainnet/devnet/testnet), какую commitment ты запросил и поддерживает ли RPC провайдер нужные данные. Не отправляй перевод повторно, пока не сверил исходный кошелёк, историю сети и правильную среду.

Воспроизводимый запрос к Devnet

Solana docs показывают формат вызова getTransaction: signature и объект настроек с commitment, maxSupportedTransactionVersion и encoding. Ниже — запрос по образцу официальной документации, с её демонстрационной signature. Это запрос для Devnet; ответ зависит от актуального состояния RPC и commitment, поэтому не используй пример как обещание, что сервер всегда вернёт один и тот же результат.

curl https://api.devnet.solana.com \
  -sS -X POST \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"getTransaction","params":["4ReKprwf3WdLHRrzp4ctPWNBsQDPL3VZz3zMmoZfcGJMJCHh5Vq937mPdyxhCbw54wNnA6hZ7KfNpQdpt13yY7A9",{"commitment":"confirmed","maxSupportedTransactionVersion":0,"encoding":"json"}]}'

Один из возможных ответов, если RPC не находит signature на указанном commitment (пример формы ответа, не фиксированный результат документационного запроса):

{"jsonrpc":"2.0","result":null,"id":1}

Если твой запрос вернул null, это означает только, что метод не вернул транзакцию на этом commitment. Подставь signature из своего кошелька и сохрани endpoint именно той сети; фактический JSON может отличаться от примера.

Как интерпретировать null

  1. Сверь signature. Она должна быть скопирована без пробелов, обрезки и подмены символов. RPC принимает Base58 signature.
  2. Сверь cluster. Запрос к Devnet не найдёт signature из mainnet, и наоборот. Уточни сеть у кошелька или приложения, откуда отправлял.
  3. Проверь commitment. Метод возвращает confirmed transaction или null, если она не найдена на выбранном уровне. Слишком ранняя проверка может не показать ещё не подтверждённую транзакцию.
  4. Повтори запрос с корректной конфигурацией. Документация предпочитает объект параметров; maxSupportedTransactionVersion нужен, если клиент должен читать versioned transaction. Меняй по одному параметру и фиксируй ответ.
  5. Сверь результат в официальном обозревателе выбранной сети и кошельке. Если провайдер RPC и эксплорер расходятся, не делай вывод о потере; проверь другой доверенный endpoint этой же сети или поддержку кошелька.

Если получен объект, смотри meta.err: null означает, что поле ошибки не показывает неуспех; ненулевое значение говорит о проблеме исполнения. В Solana инструкции транзакции выполняются атомарно: если одна инструкция падает, изменения состояния откатываются, но network fee всё равно может быть списана. Как устроены транзакции Solana. Ответ null вообще не содержит meta, поэтому по нему нельзя определить судьбу комиссии.

Как понять, что проверка завершена

Для проверки должны совпасть cluster, полная signature и настройки commitment; итоговый ответ должен быть сохранён как есть. Не путай тестовую строку с реальным отправленным переводом. Если реальная signature всё ещё даёт null, не создавай второй перевод: сохрани время запроса, endpoint, commitment, signature и данные кошелька, затем сверяй статус через поддержку RPC/кошелька. Для общего сценария зависшего перевода смотри что означает pending-статус криптоперевода.