Валидация транзакции

Каждая транзакция проходит проверку на валидность в следующих случаях:

• Нода получает транзакцию методом broadcast через Node REST API или gRPC Server.
• Нода получает транзакцию по бинарному протоколу от другой ноды в сети.
• Генератор блока добавляет транзакцию в блок.
• Нода получает блок (или микроблок) от другой ноды в сети.

Полная валидация транзакции включает следующие проверки:

1. Проверка корректности полей транзакции, в том числе:

   • Проверка временной метки: временная метка транзакции может отличаться от временной метки текущего блока не более чем на 2 часа назад или 1,5 часа вперед.

   • Проверка версии транзакции: активированы ли все фичи, необходимые для поддержки данной версии.

   • Проверка типа транзакции: активированы ли все фичи, необходимые для поддержки данного типа.

   • Проверка количества токенов: значения должны быть неотрицательными.

   • Проверка полей, зависящих от типа транзакции.

2. Проверка баланса отправителя.

   Достаточно ли средств на оплату комиссии. Если используется спонсорский ассет, проверяется также баланс спонсора.

   В зависимости от типа транзакции: достаточно ли средств для перевода; для перечисления платежей, приложенных к транзакции вызова скрипта; достаточно ли средств у отправителей ордеров в транзакции обмена.

3. Проверка подписи транзакции для обычного аккаунта, или верификация скриптом аккаунта при отправке транзакции со смарт-аккаунта, или верификация функцией-верификатором при отправке с dApp. Аналогичная проверка выполняется для ордеров в транзакции обмена.

4. Для транзакции вызова скрипта и Ethereum-транзакции, которая выполняет вызов dApp-скрипта:

   4.1. Вычисление результата выполнения вызываемой функции.

   4.2. Проверка баланса dApp: достаточно ли средств на выполнение действий скрипта.

   4.3. Проверка, что комиссия за транзакцию не ниже минимальной комиссии с учетом действий скрипта.

5. Верификация транзакции скриптами ассетов, если в транзакции используются смарт-ассеты, включая скрипты ассетов в действиях скрипта.

При получении транзакции методом broadcast, при добавлении транзакции в блок, а также при получении блока по сети выполняется полная валидация. В случае получения транзакции вызова скрипта по сети выполняется только часть вычислений вызываемой функции в пределах порога для сохранения неуспешных транзакций.

Результат валидации

При получении транзакции методом broadcast и по сети:

• Если транзакция не прошла какую-либо из проверок, она отбрасывается.
• Если транзакция прошла все проверки, она добавляется в UTX pool — список транзакций, ожидающих попадания в блок.

При добавлении транзакции в блок результат зависит от типа транзакции.

Транзакция вызова скрипта или Ethereum-транзакция, которая выполняет вызов dApp-скрипта:

• Если транзакция не прошла одну из проверок 1–3, она отбрасывается.
• Если транзакция успешно прошла проверки 1–3, а вычисление результата (проверка 4.1) завершилось ошибкой или выбрасыванием исключения прежде, чем сложность выполненных вычислений превысила порог для сохранения неуспешных транзакций, транзакция также отбрасывается.
• Если транзакция прошла проверки 1–3, но не прошла проверки 4–5 (при этом результат вызываемой функции вычислен успешно либо сложность вычислений превысила порог), транзакция сохраняется на блокчейне как неуспешная: "applicationStatus": "script_execution_failed". С отправителя транзакции взимается комиссия. Других изменений состояния блокчейна транзакция не влечет.
• Если транзакция прошла все проверки, она сохраняется на блокчейне как успешная: "applicationStatus": "succeeded", за нее также взимается комиссия.

Транзакция обмена:

• Если транзакция не прошла одну из проверок 1–3, она отбрасывается.
• Если транзакция успешно прошла проверки 1–3, но не прошла проверку 5, транзакция сохраняется на блокчейне как неуспешная: "applicationStatus": "script_execution_failed". С отправителя транзакции (матчера) взимается комиссия. Других изменений в балансах транзакция не влечет, в частности, комиссия матчера с отправителей ордеров не взимается.
• Если транзакция прошла все проверки, она сохраняется на блокчейне как успешная: "applicationStatus": "succeeded". Взимается как комиссия за транзакцию с матчера, так и комиссия с отправителей ордеров.

Транзакции остальных типов:

• Если транзакция не прошла какую-либо из проверок, она отбрасывается.
• Если транзакция прошла все проверки, она сохраняется на блокчейне как успешная и за нее взимается комиссия.

До активации фичи № 15

До активации фичи № 15 “Ride V4, VRF, Protobuf, Failed transactions” действовал другой порядок валидации транзакций. В частности, была возможной оплата комиссии за транзакцию вызова скрипта за счет средств, переведенных dApp-скриптом отправителю.

1. Проверка корректности полей транзакции, в том числе:

   • Проверка временной метки: временная метка транзакции может отличаться от временной метки текущего блока не более чем на 2 часа назад или 1,5 часа вперед.

   • Проверка версии транзакции: активированы ли все фичи, необходимые для поддержки данной версии.

   • Проверка типа транзакции: активированы ли все фичи, необходимые для поддержки данного типа.

   • Проверка полей, зависящих от типа транзакции.

2. Проверка подписи транзакции для обычного аккаунта, или верификация скриптом аккаунта при отправке транзакции со смарт-аккаунта, или верификация функцией-верификатором при отправке с dApp. Аналогичная проверка выполняется для ордеров в транзакции обмена.

3. Верификация транзакции скриптами ассетов, если в транзакции используются смарт-ассеты, за исключением скриптов ассетов в действиях dApp-скрипта, которые выполняются в п. 5.

4. Проверка баланса отправителя.

   Достаточно ли средств на оплату комиссии. Если используется спонсорский ассет, проверяется также баланс спонсора.

   В зависимости от типа транзакции: достаточно ли средств для перевода; для перечисления платежей, приложенных к транзакции вызова скрипта; достаточно ли средств у отправителей ордеров в транзакции обмена.

5. Для транзакции вызова скрипта:

   5.1. Вычисление результата вызываемой функции dApp-скрипта.

   5.2. Верификация скриптами ассетов, если в действиях скрипта используются смарт-ассеты.

   5.3. Проверка баланса dApp: достаточно ли средств на выполнение действий скрипта.

   5.4. Проверка, что комиссия за транзакцию не ниже минимальной комиссии с учетом действий скрипта.

Транзакция сохраняется в блокчейне и за нее взимается комиссия, если она успешно прошла все проверки.