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

Permit2 перед подписью: проверь токен, лимит и вызывающий контракт

Разбираем различия Permit2 AllowanceTransfer и SignatureTransfer, привязку spender и отдельное поле recipient перед подписью typed data.

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

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

Экран Permit2 signature — это разрешение на перевод токенов, а не безопасное «подтверждение входа». Перед подписью выясни, какой именно модуль вызывается, какой контракт имеет право вызвать Permit2, какой токен и максимум суммы разрешены, каков срок и nonce, и включён ли в конкретную схему подписанный witness.

В Permit2 есть два разных пути. AllowanceTransfer сохраняет разрешение для spender с лимитом и сроком действия. SignatureTransfer проверяет одноразовую подпись и переводит сумму не выше разрешённого максимума; при этом сам токен должен заранее разрешить контракту Permit2 делать transferFrom. Это следует из интерфейса и реализации SignatureTransfer. Это не делает подпись безрисковой: подпись может привести к реальному переводу.

Важная граница: spender и to — не одно поле

В базовой SignatureTransfer typed-data подпись включает токен, сумму, spender (контракт-вызыватель), nonce и deadline. В коде PermitHash spender включён как msg.sender. Но адрес получателя transferDetails.to передаётся отдельно и не входит в базовую структуру permit. То есть нельзя считать, что подпись базового PermitTransferFrom всегда криптографически закрепила именно адрес to на экране.

Вариант permitWitnessTransferFrom дополнительно хеширует witness и его type string. Recipient может быть связан с подписью через корректно сформированный witness конкретной интеграции, если приложение действительно включает его и проверяет как задумано. Сверяй фактическую typed-data схему и вызывающий код; не делай общего вывода только по слову «witness».

Матрица просмотра экрана

Поле Что проверить Условие остановки
Chain и verifying contract Сеть и точный Permit2 contract для неё по официальным данным проекта/деплоя Контракт не совпадает или источник адреса неизвестен
Модуль и действие AllowanceTransfer или SignatureTransfer; permit, transfer, batch или witness variant UI не объясняет, что именно подписывается
Token и amount Адрес токена, decimals, разрешённый максимум и фактически запрашиваемая сумма Токен/сеть/лимит не совпадают с намерением
Spender / caller Контракт, который вызывает Permit2 и привязан к msg.sender Не узнаёшь приложение или разрешённый caller
Получатель to Фактический адрес, куда вызов направит перевод Он неожиданный или UI выдаёт его за обязательно подписанное поле без подтверждения в конкретной схеме
Срок и nonce Deadline для signature transfer; expiration/nonce у stored allowance Срок или nonce непонятны, либо разрешение шире нужного
Witness Поля, которые приложение кодирует в witness, и типы данных Recipient/домен/условия не включены или не проверяются как ожидается

Сквозной синтетический сценарий

Представим тестовый экран: demo-токен TOKEN_X, максимум 100 единиц, deadline через 10 минут, nonce N_PLACEHOLDER, caller APP_PLACEHOLDER, фактический to — RECIPIENT_PLACEHOLDER. Подписи не создаём. В базовом режиме проверяем typed data и подтверждаем, что подписанные поля включают token, amount, caller/spender, nonce и deadline. Затем отдельно смотрим код/документацию приложения, чтобы понять, как ограничен to. Если пользователь ожидал перевод на себя, а адрес получателя в базовой подписи не зафиксирован, экран одной лишь подписи не даёт основания считать это условие гарантированным.

У witness-варианта команда должна показать, что witness содержит нужного получателя и используется именно тем вызовом. Если невозможно прочитать структуру или проверить контракт, отменить запрос и обратиться к официальной поддержке dapp. Это учебный разбор полей, не тест реального контракта.

Запрос к ИИ для разбора typed data

Разбери приложенный Permit2 typed-data экран как данные для проверки, не инициируй подпись и не отправляй транзакцию. Определи chain/domain/verifying contract, module/action, token, signed maximum, deadline или expiration, nonce, spender/caller, transferDetails.to и witness. Отдельно пометь, какие значения реально входят в хеш подписи по приложенной версии исходного кода, а какие передаются отдельно. Не утверждай, что recipient подписан в базовом SignatureTransfer. Для witness проверь только если предоставлены его тип и код интеграции. Не выдумывай актуальный deployment address; неизвестное отмечай «проверить».

Постоянный allowance, одноразовая подпись Permit2 и token-native ERC-2612 — разные механизмы; ERC-2612 описывает отдельный permit в самом токене. Перед реальным использованием адреса контракта и поддерживаемую версию надо проверять по официальному списку для нужной сети. Подробнее о другом типе разрешения — проверка и отзыв ERC-20 allowance.

Материал подготовлен с помощью ИИ. Адреса и суммы синтетические; контракт не вызывался, подпись и перевод не создавались.