Официальная документация Solana описывает durable nonce как замену recent blockhash сохранённым значением из nonce account. Это позволяет подготовить транзакцию и подписать её офлайн для более поздней отправки, но не делает подпись бессрочно пригодной: после использования nonce account продвигается, и прежнюю подписанную транзакцию нельзя отправить повторно как новую.
Для диагностики нужны три вещи: исходная signature, точный cluster (mainnet/devnet/testnet или другой), и текущее состояние указанного nonce account. Один признак не решает вопрос. Например, изменившийся nonce может означать, что транзакция была обработана, но сам по себе не доказывает, что именно нужная signature завершилась успешно.
Важно: в актуальной документации Solana указано, что durable nonces могут быть deprecated в будущем выпуске. Перед практическим использованием проверь текущий статус спецификации, версию клиента и кошелька. Ниже — разбор уже подготовленной транзакции, не руководство по созданию новой.
Что подготовить без секретов
- transaction signature (публичный идентификатор);
- nonce account public key;
- ожидаемое значение durable nonce, записанное при создании подписанной транзакции;
- cluster и выбранный commitment для чтения;
- RPC/explorer, которому ты доверяешь.
Не показывай seed, приватный ключ или полный подписанный пакет неизвестным сайтам. Signature и public key — публичные данные, но не публикуй их, если это раскрывает коммерческую или персональную информацию.
Read-only проверка
- Сначала сверь cluster. Один и тот же адрес/подпись на разных кластерах может иметь разный статус. Убедись, что explorer или RPC настроен на сеть, где транзакция создавалась.
- Запроси статус signature. Метод Solana RPC
getSignatureStatusesвозвращает состояние каждой предоставленной signature. БезsearchTransactionHistory: trueметод ищет в недавнем кэше; старый статус может потребовать поиска истории или другого доверенного источника.nullв ответе означает, что текущий запрос не нашёл запись в выбранной области поиска, а не абсолютное доказательство, что транзакции никогда не существовало. - Открой детали найденной записи. Сверь
err, confirmation status/slot и инструкции с ожидаемыми. Успешная обработка и ошибка исполнения — разные исходы. Не пересылай транзакцию только потому, что один интерфейс не показывает её. - Прочитай nonce account.
getAccountInfoвозвращает состояние аккаунта (или null на указанном commitment). Убедись, что это нужный account, он принадлежит ожидаемой программе/инициализирован, а значение durable nonce можно прочитать надёжным декодером. - Сравни старое и текущее значения. Совпадение говорит лишь, что наблюдаемое значение не продвинулось на момент чтения. Изменение говорит, что nonce продвинулся; оно может быть следствием этой или другой операции, поэтому сопоставь signature и историю аккаунта.
- Не подписывай заново вслепую. Если исходная подпись неизвестна, nonce account отсутствует, значения не совпадают или RPC не даёт уверенного ответа, остановись и уточни статус у кошелька/валидатора/оператора, который готовил транзакцию.
Четыре учебных состояния
Все строки ниже синтетические. N-old и N-new — короткие обозначения, а не реальные Solana nonce/hash.
| Состояние signature | Nonce account | Наблюдение | Осторожный вывод |
|---|---|---|---|
signature найдена, err=null, достаточный commitment |
N-new, отличается от записанного N-old |
signature присутствует; account уже продвинут | транзакция зафиксирована в наблюдаемом статусе; сверить инструкции и окончательность |
| signature не найдена в recent cache; поиск истории включён, но результата нет | значение всё ещё N-old |
запрос не показывает обработку, nonce совпадает | данных недостаточно; перепроверь cluster, RPC и исходную подпись. Не считать это доказанной неотправкой |
signature найдена с err!=null |
N-new |
запись есть, исполнение завершилось ошибкой; durable nonce продвинут | не повторять старую подпись; изучить статус и последствия, передать детали поддержке |
| signature не найдена, RPC недоступен или аккаунт не читается | неизвестно | наблюдение неполное | остановиться; нельзя делать вывод о потере/успехе |
Первый вариант не означает автоматически, что операция безопасна или что ты ожидал именно эти инструкции. Всегда сравни payload/транзакционные детали с первоначальным намерением. Третий вариант также не равен «ничего не произошло»: Solana описывает, что при прошедшей nonce-валидации, но неудачном исполнении nonce всё равно продвигается и fee payer может оплатить fee. Точный результат смотри в записи транзакции.
Почему подпись не следует повторять
Durable nonce не истекает по обычному окну свежего blockhash, но это не означает, что её можно без риска пересылать бесконечно. Runtime проверяет, что stored nonce соответствует transaction recent_blockhash и что nonce account и authority удовлетворяют правилам. Если проверки прошли, nonce продвигается до исполнения; повторная отправка прежнего значения не будет новой самостоятельной попыткой после продвижения. Ошибка проверки и ошибка выполнения — разные ветки: документация Solana отдельно описывает, что при ошибке валидации транзакция отбрасывается без изменения состояния, а после валидации исполнение может закончиться ошибкой уже после продвижения nonce.
Типичные ошибки
nullтрактуют как доказательство, что транзакции не было. Проверь историю, cluster и область кэша; результат одного RPC-запроса ограничен.- Nonce продвинулся — значит именно моя транзакция успешна. Сверь signature, slot,
errи инструкции. - Ошибка означает, что можно немедленно повторить подпись. При durable nonce значение могло уже продвинуться; сначала проверь состояние.
- RPC и обозреватель показывают разные ответы. Сверь endpoint, commitment, cluster и время; при конфликте не делай необратимых действий.
- Смотрят только на nonce account. Без signature это не связывает продвижение с нужной транзакцией.
- Не учитывают будущую deprecation. Проверяй актуальный status durable nonces для версии runtime/SDK, которую используешь.
Проверка завершена, когда совпали cluster, signature, подтверждённая запись/ошибка, инструкции и read-only состояние nonce account. Если хоть один источник не доступен или ответы расходятся, результат — «не определено», не повод повторять подпись.
Материал подготовлен с помощью ИИ. Состояния в таблице учебные; для обычной ошибки исполнения см. почему неуспешная Solana транзакция может стоить SOL. Транзакции, подписи и обращения к кошельку редакцией не выполнялись.
Источники: https://solana.com/docs/core/transactions. Ещё по теме: как проверить pending crypto transfer.
