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

EIP-712: что проверить перед подписью вложенного запроса

Чек-лист domain, первичных полей, вложенных данных и replay controls; только гипотетический образец, без транзакции.

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

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

EIP-712 задаёт формат структурированных typed data, но не гарантирует, что кошелёк покажет каждое вложенное значение понятным человеку. Стандарт также прямо не включает replay protection: nonce, срок действия и правила повторного применения задаёт приложение, а не обязательный набор EIP (EIP-712). Подпись означает согласие с конкретными полями и тем, как контракт их интерпретирует; читаемый внешний заголовок сам по себе не раскрывает скрытую calldata.

Ethereum Foundation обсуждает clear signing как подход к более ясному отображению намерения, но это не независимая гарантия безопасности приложения или конкретного кошелька (анонс Clear Signing). Ниже учебный разбор структуры; ничего не подписывай и не используй как инструкцию к реальной транзакции.

Поля domain выбираются схемой приложения: EIP-712 не требует наличия всех перечисленных полей в каждом сообщении. Отсутствие поля нужно оценивать вместе с фактической защитой приложения от повторного применения.

Условный структурированный запрос

Представим приложение, которое показывает сообщение BatchAction с полями account, chainId, nonce, deadline и массивом calls. В одном элементе calls есть target, value и data: 0x…. Этот data — лишь непрозрачные байты без декодированного пояснения. Это синтетический образец, не адрес, контракт или payload реальной операции.

Что сверить Вопрос перед подписью Условие остановки
Domain Какие из полей name, version, chainId, verifyingContract используются? Совпадают ли сеть и контракт с ожидаемым приложением? Не подписывать при неизвестном домене или несоответствии сети/контракта
primaryType и типы Какой тип является главным? Понятны ли все вложенные structs, поля и порядок? Остановиться, если кошелёк скрывает тип или приложение не объясняет вложенность
Получатель и сумма Какие target, value, токен и количество заданы в каждой операции? Не считать внешний “Approve”/“Batch” достаточным описанием внутренних действий
Calldata Можно ли декодировать data в известный метод и параметры? Непонятные bytes — не «пустое поле»; не подписывать, пока смысл не подтверждён
Replay controls Где приложение проверяет nonce, deadline, salt или статус использования? Не предполагать, что защита автоматически следует из EIP-712
Контрактная логика Как verifying contract использует signed struct, есть ли вложенный вызов и ограничения? Если взаимодействие нельзя проверить по доверенной документации/коду, отказ от подписи

Проверяй по цепочке

  1. Сопоставь domain с сетью и контрактом, открытыми из независимого источника, а не только из того же dApp.
  2. Разверни каждую вложенную структуру до конечных полей. Особое внимание — массивам операций, адресам, суммам, value и data.
  3. Определи, что делает приложение с signature: одноразово ли использует nonce, проверяет ли deadline и может ли тот же подписанный объект быть отправлен повторно в другом контексте.
  4. Если интерфейс показывает только человекочитаемый outer struct, а внутренняя операция остаётся opaque, считай намерение непроверенным. Запроси декодированное описание у доверенного источника приложения; не подставляй публичный decoder как единственное доказательство.
  5. Не подписывай запрос, если поля расходятся с действием, которое ты собирался выполнить. Никакое объяснение в чате не заменяет чтение полного сообщения и ожидаемого поведения контракта.

EIP-712 помогает кодировать typed data и domain separation, но не подтверждает честность интерфейса, намерение пользователя, отсутствие ошибок контракта или безопасность токена. Clear-signing решения могут улучшить читаемость определённых полей, но не превращают неизвестный код или calldata в безопасное действие. Задача памятки — показать, где заканчивается понятное представление и начинается непроверенная вложенная операция.

Для конкретного разрешения Permit2 дополнительно нужен разбор подписанного лимита, spender и получателя. Здесь же проверяется произвольный вложенный запрос, включая непрозрачные байты операций.