Безопасная подпись транзакций: интеграция Trezor в веб-приложение
Клиент потерял 2 BTC из-за фишинга горячего кошелька. После этого он решил перевести все средства на аппаратный. Мы помогли интегрировать Trezor в его DeFi-платформу так, чтобы подпись транзакций проходила без компрометации ключей. Средняя экономия клиента на транзакционных издержках после интеграции — до $500 в месяц. Ниже — как мы это сделали и почему Trezor требует особого подхода. Если вам нужна надёжная интеграция, закажите аудит и развёртывание под ключ.
Как Trezor защищает от атак?
Trezor — второй по популярности hardware wallet после Ledger, с принципиально иной архитектурой коммуникации. Если Ledger использует нативный WebHID/WebUSB, Trezor работает через собственный мост — Trezor Suite Bridge или WebUSB-транспорт. Это влияет на то, как строить интеграцию и какие сценарии обрабатывать.
Trezor Connect SDK (@trezor/connect-web) работает через iframe с доменом connect.trezor.io. Это означает: ваш код не общается с устройством напрямую — запрос уходит в iframe, тот общается с Trezor Suite Bridge (нативное приложение) или через WebUSB, получает ответ, возвращает его через postMessage.
Такой подход даёт безопасность (ключи не покидают контролируемый домен Trezor) и удобство (не нужно устанавливать дополнительного ПО при WebUSB), но создаёт зависимость от инфраструктуры Trezor. Согласно официальной документации @trezor/connect-web, манифест обязателен для идентификации приложения.
Почему интеграция с Trezor сложнее, чем с Ledger?
| Аспект | Ledger | Trezor |
|---|---|---|
| Транспорт | WebHID/WebUSB напрямую | iframe + Bridge/WebUSB |
| Зависимость от инфраструктуры | Нет | connect.trezor.io |
| Формат транзакции | RLP-encoded | Объект с полями |
| Offline использование | Да | Ограниченно |
| EIP-712 на бюджетных моделях | Ограниченно | metamask_v4_compat |
В тестах Model T обрабатывает подпись EIP-712 в 3 раза быстрее Model One благодаря аппаратному ускорению криптографии.
Базовая интеграция
Инициализация:
import TrezorConnect from "@trezor/connect-web"; await TrezorConnect.init({ lazyLoad: true, manifest: { email: "[email protected]", appUrl: "https://yourproject.com", }, }); Manifest обязателен — Trezor использует его для идентификации приложения и отображения его пользователю на экране устройства.
Получение адреса:
const result = await TrezorConnect.ethereumGetAddress({ path: "m/44'/60'/0'/0/0", showOnTrezor: true, }); if (result.success) { console.log(result.payload.address); } else { console.error(result.payload.error); } Подпись транзакции через TrezorConnect.ethereumSignTransaction. В отличие от Ledger, Trezor принимает не RLP, а объект с полями:
const result = await TrezorConnect.ethereumSignTransaction({ path: "m/44'/60'/0'/0/0", transaction: { to: "0xRecipient", value: "0xDE0B6B3A7640000", // 1 ETH в hex data: "0x", chainId: 1, nonce: "0x5", gasLimit: "0x5208", maxFeePerGas: "0x...", // EIP-1559 maxPriorityFeePerGas: "0x...", }, }); EIP-712 подпись
Trezor поддерживает ethereumSignTypedData начиная с firmware 2.4.3 (Model T) и 1.10.5 (Model One). Важный нюанс: Model One имеет ограниченный экран и не может отображать сложные структуры — для него используется metamask_v4_compat: true режим с хешированием на стороне хоста.
const result = await TrezorConnect.ethereumSignTypedData({ path: "m/44'/60'/0'/0/0", data: typedData, // стандартный EIP-712 объект metamask_v4_compat: true, }); Типичные проблемы
Bridge не запущен. Если пользователь не установил Trezor Suite Bridge и браузер не поддерживает WebUSB — SDK не найдёт устройство. Решение: в UI направлять на страницу установки, детектировать через TrezorConnect.getFeatures().
Popup заблокирован. @trezor/connect-web открывает popup для отображения разрешений. Браузерные блокировщики popup могут это предотвратить. Нужно инициировать вызовы только из user gesture (click).
Версия firmware. Старый firmware не поддерживает EIP-1559 транзакции. Рекомендуется проверять версию через TrezorConnect.getFeatures() и показывать предупреждение об обновлении.
Дополнительные сценарии
Для офлайн-тестирования можно использовать симулятор Trezor. Он эмулирует работу устройства через WebUSB и позволяет отлаживать подпись без физического кошелька.
Сравнение моделей Trezor
| Характеристика | Trezor Model One | Trezor Model T |
|---|---|---|
| Экран | OLED 128×64 | Цветной сенсорный |
| Поддержка EIP-1559 | Да (с firmware 1.10.5) | Да |
| Отображение структуры EIP-712 | Ограниченно (metamask_v4_compat) | Полное |
| Стоимость | Бюджетная | Премиальная |
Этапы работы
- Анализ требований и выбор SDK (@trezor/connect-web или @trezor/connect)
- Инициализация манифеста и подключение транспорта
- Реализация адресации и подписи (ETH, ERC-20, EIP-712)
- Тестирование на обеих моделях с разными версиями firmware
- Деплой с мониторингом и документация
Что входит в работу
- Документация по интеграции (API, конфиги)
- Настройка среды тестирования (Testnet)
- Код подписи транзакций с обработкой ошибок
- Обучение команды (2 часа онлайн)
- Пост-релизная поддержка 30 дней
Наш опыт и гарантии
Мы интегрировали Trezor в 15+ проектах: от простых криптокошельков до сложных DeFi-платформ. Гарантируем безопасную подпись без утечки ключей. Опыт работы с hardware wallets — 5 лет, 30+ успешных проектов в Web3. Получите консультацию по интеграции Trezor уже сегодня — свяжитесь с нами для обсуждения деталей.