Durable nonce Solana: зачем нужен и как работает
Durable nonce Solana — механизм, который позволяет подписать транзакцию заранее и отправить позже, без обычного срока давности recent blockhash. Вместо хеша недавнего блока транзакция использует значение из отдельного nonce account. Это полезно, когда подписи собирают с задержкой или на устройстве без интернета. Для обычного перевода из кошелька создавать такой аккаунт не нужно.
Зачем обычной транзакции недавний blockhash
Недавний blockhash ограничивает время, в течение которого сеть может принять обычную транзакцию Solana. Он входит в подписываемое сообщение и помогает защищать сеть от повторного исполнения. Если вы долго проверяете операцию перед подписью, часть этого времени уже проходит: срок отсчитывается от возраста blockhash, а не от нажатия кнопки «Отправить».
В документации по подтверждению описан допустимый возраст до 150 включительно: с учётом нулевого возраста это 151 значение в очереди. Ориентир по времени — примерно 60–90 секунд, но использовать его как точный таймер нельзя. Производство блоков и состояние RPC, то есть узла доступа к сети, меняют доступное окно.
Приложение получает через getLatestBlockhash сам хеш и lastValidBlockHeight — последнюю допустимую высоту блока. Для контроля истечения нужна именно высота, а не секундомер.
Если вы уже столкнулись с такой ошибкой, сначала проверьте почему истёк blockhash в Solana, а не переходите к nonce account.
Чем durable nonce отличается от recent blockhash
Главное отличие durable nonce от recent blockhash — условие потери актуальности. Обычный хеш стареет по мере появления блоков. Durable nonce связан с состоянием отдельного аккаунта: пока сохранённое значение подходит транзакции, обычное окно давности её не ограничивает. При этом подписи, баланс и инструкции всё равно должны пройти проверки сети.
| Критерий | Recent blockhash | Durable nonce |
|---|---|---|
| Откуда берут значение | Из недавнего блока через RPC | Из данных nonce account |
| Что ограничивает актуальность | Возраст хеша | Состояние nonce account и сохранённое значение |
| Нужен отдельный аккаунт | Нет | Да |
| Первая инструкция обновления nonce | Не требуется | Нужна AdvanceNonceAccount |
| Когда выбирать | Подпись и отправка без долгой паузы | Подписи или отправка с задержкой |
Название поля сообщения остаётся recent_blockhash: в случае durable nonce туда подставляют сохранённое nonce-значение. Это не означает, что оно должно оставаться в очереди недавних хешей.
Например, перевод, который вы проверили и сразу подтвердили в кошельке, не получает пользы от дополнительного аккаунта. Другая задача — передать неизменное сообщение второму подписанту, который сможет вернуться к нему только после рабочей встречи.
Как сеть использует durable nonce
Для durable nonce приложение ставит сохранённое значение в поле blockhash, а первой инструкцией добавляет AdvanceNonceAccount. Нужные участники подписывают получившееся сообщение. При обработке сеть проверяет nonce account и соответствие значения, затем меняет nonce. Благодаря этому старое подписанное сообщение нельзя снова исполнить с уже использованным значением.
Приложение читает nonce account и собирает сообщение с нужным nonce.
Участники подписывают одно сообщение, сохраняя его инструкции и параметры.
Сеть сверяет значение и обновляет nonce, защищая операцию от повторного исполнения.
Одного копирования nonce в поле blockhash недостаточно. Имеют значение порядок инструкций, указанный аккаунт и разрешение authority.
После сбора подписей нельзя незаметно заменить получателя, сумму или плательщика комиссии. Подписи относятся к конкретному сообщению; изменение его содержимого требует новых подписей.
Для проверки сборки полезна симуляция транзакции Solana. Она показывает результат на выбранном состоянии сети, но не резервирует это состояние на будущее. Между проверкой и реальной отправкой условия исполнения могут измениться.
Что хранит nonce account и кто им управляет
Nonce account хранит durable nonce и адрес полномочного подписанта — nonce authority. Аккаунтом владеет System Program, системная программа Solana. Authority разрешает обновление nonce и управляет предусмотренными операциями с аккаунтом. Этот адрес может совпадать с отправителем или плательщиком комиссии, но роли нужно различать: они отвечают за разные разрешения.
Для хранения данных аккаунту нужен баланс, достаточный для освобождения от rent. Это отдельное требование, а не сумма вашего будущего перевода. Не переносите фиксированный баланс из учебного примера в рабочую операцию: необходимое значение нужно запрашивать для нужного размера аккаунта. Подробнее об этом — в объяснении rent-exempt баланса Solana.
Полезно представить три записи: адрес nonce account, его текущее значение и authority. Публичный адрес аккаунта не даёт права обновлять nonce. Для разрешения операции нужна соответствующая подпись.
Если вы передаёте сборку транзакции другому участнику, заранее согласуйте эти роли. Иначе можно собрать подпись владельца монет, но обнаружить перед отправкой, что разрешения authority в сообщении не хватает.
Когда нужна отложенная подпись
Отложенная подпись нужна, когда участники не могут подписать одно сообщение в пределах короткого окна recent blockhash. Durable nonce позволяет сохранить уже собранные подписи и дождаться остальных. Подписание без интернета — соседний сценарий: устройство получает подготовленное сообщение, подписывает его локально, а другой компьютер позднее передаёт транзакцию в сеть.
Учебный пример: вы готовите перевод 2 SOL с отдельным плательщиком комиссии. Утром владелец монет проверяет получателя и подписывает сообщение. Плательщик подключается после обеда. Допустим, nonce authority совпадает с владельцем монет: его разрешение тоже предусмотрено при сборке. Стороны обмениваются сообщением и подписями, не приватными ключами.
При обычном blockhash такая пауза выходит за окно давности. С durable nonce сама задержка не требует пересобирать сообщение, если nonce не поменялся и остальные условия сохранились.
Durable nonce даёт время собрать подписи. Он не отправляет транзакцию по расписанию.
Для запланированной отправки всё равно нужен отправляющий участник или программа. Если никто не передаст подписанную транзакцию в сеть, перевод не произойдёт. А проверять получателя нужно до первой подписи, пока исправления не требуют нового согласования.
Где заканчивается польза durable nonce
Durable nonce решает проблему давности blockhash, но не сохраняет условия будущей операции. Если до отправки изменился баланс, состояние программы или допустимые параметры обмена, транзакция может завершиться ошибкой. Для обычного перевода, который вы подписываете и сразу отправляете, выбирайте recent blockhash: дополнительный nonce account только усложнит подготовку и контроль.
- Позволяет разнести подписи участников по времени.
- Подходит для заранее подготовленного сообщения с подписью без интернета.
- Требует отдельного аккаунта и контроля authority.
- Не фиксирует баланс и состояние программ до отправки.
Конкретная граница: если вы подписали обмен с допустимым проскальзыванием, а к отправке цена вышла за разрешённые условия, durable nonce не заставит программу выполнить обмен.
Он также не добавляет операции приоритет. Если проблема связана с попаданием транзакции в блок, отдельно разберите priority fee в Solana.
Основная документация Solana предупреждает и о возможном отказе от durable nonces в будущем. Это не сообщение об уже состоявшемся отключении, но для новой интеграции нужно проверять поддержку механизма выбранными инструментами.
Что происходит при ошибке и отмене
Ошибка исполнения не всегда оставляет durable nonce пригодным для повторной отправки. Если транзакция прошла предварительные проверки сети, но одна из инструкций завершилась ошибкой исполнения, сеть сохраняет обновлённый nonce и списывает комиссию. Основное действие при этом не происходит. Поэтому сначала выясните результат обработки, затем решайте, нужно ли собирать новое сообщение.
Другая ситуация — отказ до исполнения: например, сохранённый nonce уже не совпадает или отсутствует нужная подпись. Документация отделяет такой отказ от ошибки инструкции: при нём nonce не меняется и комиссия не списывается.
Не делайте вывод по одному сообщению интерфейса. Проверьте статус подписи и состояние аккаунта; различия confirmed и finalized помогут понять степень подтверждения.
Неудавшийся перевод и неиспользованный nonce — разные утверждения. Одно не доказывает другое.
Для отзыва подготовленной транзакции authority может отдельно обновить nonce. Старая подпись тогда перестаёт подходить к сохранённому значению. Но отмена требует подтверждения: если исходная транзакция успела исполниться раньше обновления, смена nonce не вернёт перевод. Удаление файла с подписью на вашем компьютере тоже не отзывает копии у других участников.
Что проверить перед отложенной отправкой
Перед отложенной отправкой проверьте само сообщение и текущее состояние nonce account. Наличие всех подписей ещё не означает готовность операции: за время ожидания могли измениться разрешения, баланс или условия программы. Сверяйте эти данные перед передачей в сеть, особенно если сообщение хранилось у нескольких участников и вы не контролировали каждое его использование.
- Адрес nonce account. Убедитесь, что сообщение ссылается на согласованный аккаунт в нужном кластере Solana.
- Текущее nonce-значение. Сравните данные аккаунта со значением в подписанном сообщении; после смены нужны новая сборка и подписи.
- Полномочия и подписи. Проверьте authority, отправителя и плательщика комиссии, учитывая совмещение ролей.
- Порядок инструкций. AdvanceNonceAccount должна стоять первой; остальные действия должны совпадать с согласованными.
- Получатель и условия исполнения. Повторно сверьте адрес, сумму, доступный баланс и ограничения вызываемой программы.
Этот список не требует создавать аккаунт для каждой операции. Он нужен, когда ваш процесс уже использует durable nonce. Если приложение не показывает состав сообщения или не поддерживает такой формат, ручная подстановка хеша проблему не решит: потребуется совместимый инструмент.
Вывод
Для обычного перевода Solana выбирайте свежий recent blockhash и отправляйте транзакцию после проверки. Durable nonce нужен при конкретной задержке: подписи собирают в разное время или готовое сообщение отправляют позднее. Его польза заканчивается там, где проблема связана с балансом, условиями программы или отсутствием нужных разрешений, а не с возрастом хеша.
Практический критерий простой: можете ли вы собрать все подписи и отправить сообщение без длительной паузы? Если да, отдельный nonce account обычно лишний. Если нет, сначала согласуйте, кто управляет authority, кто отправляет транзакцию и как участники узнают об использовании или отзыве nonce.
Не считайте сохранённую подпись обещанием будущего перевода. Это разрешение на конкретное сообщение при определённых условиях обработки. Чем дольше сообщение ждёт отправки, тем важнее проверить, что эти условия ещё подходят вашей задаче.
Начните с проверки того, какое именно ограничение мешает вашей операции: истечение blockhash или ошибка исполнения.
Частые вопросы
Durable nonce действует бессрочно?
У него нет обычного срока давности recent blockhash. Однако транзакция зависит от сохранённого nonce и состояния аккаунта. Использование или отдельное обновление значения делает старое сообщение непригодным. Кроме того, остальные условия исполнения могут измениться, даже если nonce остался прежним.
Можно ли подписать транзакцию без интернета?
Да, подготовленное сообщение можно подписать на отключённом устройстве. Но получить актуальные данные аккаунта и позднее отправить транзакцию нужно через устройство с доступом к сети. Приватный ключ передавать отправляющей стороне не требуется.
Можно ли заранее подписать несколько переводов с одним nonce?
Подготовить такие сообщения можно, но рассчитывать на последовательное исполнение всех нельзя. Как только одна транзакция использует значение, остальные сообщения с ним перестают подходить. Обновлять nonce между подписями тоже нельзя: прежние подписи относятся к старому сообщению.
Durable nonce ускоряет подтверждение?
Нет, он меняет условие давности сообщения. Очерёдность обработки и итоговое подтверждение — отдельные вопросы. Ожидание подписи второго участника и ожидание исполнения в сети требуют разных решений; добавление nonce account само по себе вторую задачу не устраняет.
Источники
- Durable & Offline Transaction Signing using Nonces — Solana.
- Transaction Confirmation & Expiration — Solana.
- Durable Nonces: механизм и поведение при ошибках — Solana.
- Durable Transaction Nonces — Anza.
Материал сверен с документацией 02.11.2026.