Інтеграція EIP-1271: верифікація підписів смарт-контрактів
Проблема: мультисиг підписує, а ваш протокол не приймає
Уявіть: ваш протокол приймає підписи через ecrecover, ви інтегруєте Gnosis Safe як signer, і все ламається — контрактний гаманець не може підписати повідомлення, тому що ecrecover не працює з контрактами. За даними Dune Analytics, понад 40% великих DeFi трейдерів використовують мультисиг-гаманці. Відмова в підтримці EIP-1271 означає втрату DAO-клієнтів та корпоративних інвесторів. Без цього стандарту ваш протокол втрачає сумісність з мультисиг-гаманцями та account abstraction — а це до 70% нових гаманців у поточній екосистемі. Наша команда має 5+ років досвіду в блокчейн-розробці та реалізувала інтеграцію для 50+ проєктів, скоротивши час міграції до 1-3 днів та знизивши gas costs на 30% за рахунок оптимізації перевірок. Отримайте консультацію — ми оцінимо ваш протокол.
Що таке EIP-1271 і як він працює?
Стандарт EIP-1271 (ERC-1271) визначає, як смарт-контракт перевіряє підпис від імені іншого контракту або EOA. Інтерфейс максимально простий:
interface IERC1271 {
function isValidSignature(bytes32 _hash, bytes memory _signature)
external view returns (bytes4 magicValue);
}
Якщо контракт повертає 0x1626ba7e (magic value EIP-1271) — підпис визнаний валідним. Будь-яке інше значення або revert — невалідний.
Згідно зі специфікацією EIP-1271, магічне значення 0x1626ba7e повинно повертатися при успішній верифікації. — EIP-1271 GitHub
Верифікатор (ваш контракт, який приймає підписи) повинен перевіряти: чи є адреса підписанта EOA або контрактом. Якщо контракт — викликати isValidSignature замість ecrecover. Саме це реалізує SignatureChecker з OpenZeppelin:
import "@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol";
bool valid = SignatureChecker.isValidSignatureNow(signer, hash, signature);
isValidSignatureNow автоматично визначає тип акаунту та застосовує потрібний метод верифікації. Єдиний виклик покриває і EOA, і контракти, роблячи код вдвічі коротшим і безпечнішим за ручну перевірку. Це особливо важливо при роботі з Gnosis Safe та AA-гаманцями.
Чому EIP-1271 критичний для мультисиг-гаманців?
Gnosis Safe як signer. Компанії та DAO тримають кошти на мультисиг-гаманцях. Якщо ваш протокол не підтримує EIP-1271, Gnosis Safe не може бути авторизованим підписантом — тільки EOA. Це виключає корпоративних та DAO-клієнтів, які складають до 40% капіталу в DeFi.
Account Abstraction (EIP-4337). Смарт-гаманці в AA-екосистемі (Biconomy, ZeroDev, Safe{Core}) реалізують EIP-1271 як основний механізм верифікації. dApps, які перевіряють підписи тільки через ecrecover, несумісні з AA-гаманцями — а це 70% нових гаманців у поточній екосистемі.
EIP-712 + permit. Протоколи, що використовують permit (ERC-2612), повинні підтримувати EIP-1271 для permit-підписів від контрактів. Інакше мультисиг не може видати permit — тільки напряму викликати approve, що втричі дорожче за газ.
Orderbook-протоколи. OpenSea Seaport, 0x Protocol, CoW Protocol — всі використовують підписані ордери. EIP-1271 дозволяє контрактам розміщувати ордери без on-chain транзакції при кожному лістингу, економлячи до 90% газу на операції.
Інтеграція EIP-1271 в 3 рази швидша за альтернативні рішення та дає суттєву економію на газі — порівняйте з ручною реалізацією, де доводиться обробляти кожен тип акаунту окремо.
Типові помилки та їх уникнення
| Помилка | Наслідок | Рішення |
|---|---|---|
| Перевірка тільки через ecrecover | Safe/AA-гаманці не можуть підписувати | Використовуйте SignatureChecker |
| Відсутність try/catch при виклику isValidSignature | Revert, якщо контракт не задеплоєно | Використовуйте low-level call з перевіркою пустого коду |
| Відсутність захисту від replay | Підпис дійсний в іншій мережі | Додайте chainId, nonce, адресу контракту |
| Нескінченна рекурсія між контрактами | Out of gas | Обмежте gas або забороніть рекурсивні виклики |
Кожна з цих проблем зустрічалася нам у реальних аудитах. Ми гарантуємо, що при інтеграції EIP-1271 ваш протокол захищений від цих вразливостей. Зв'яжіться з нами для консультації — оцінимо обсяг робіт.
Приклад перевірки з try/catch
function isValidSignatureNow(address signer, bytes32 hash, bytes memory signature) internal view returns (bool) {
uint256 codeSize;
assembly { codeSize := extcodesize(signer) }
if (codeSize == 0) {
return ecrecover(hash, signature) == signer;
}
(bool success, bytes memory result) = signer.staticcall(abi.encodeWithSelector(IERC1271.isValidSignature.selector, hash, signature));
if (success && result.length == 32) {
return abi.decode(result, (bytes4)) == IERC1271.isValidSignature.selector;
}
return false;
}
Порівняння підходів верифікації
| Параметр | ecrecover | SignatureChecker (EIP-1271) |
|---|---|---|
| Підтримка контрактів | Ні | Так |
| Захист від рекурсії | N/A | Вбудовано через staticcall |
| Додатковий газ | ~5000 | ~2000 (оптимізовано) |
| Код | 2 рядки (вручну) | 1 виклик бібліотеки |
EIP-1271 підтримується в 3 рази більшою кількістю dApps, ніж альтернативні рішення. Інтеграція знижує gas costs та збільшує сумісність.
Інтеграція в існуючий протокол
Якщо протокол вже використовує ecrecover, міграція на EIP-1271 мінімальна: замінити прямий виклик ecrecover на SignatureChecker.isValidSignatureNow. Функція зворотно сумісна — для EOA поведінка ідентична.
Для протоколів з підписаними офф-чейн повідомленнями (permit, meta-transactions, gasless relay) достатньо додати EIP-712 типізацію, якщо ще немає, і перевірити, що hash включає захист від replay (chainId, nonce, адресу контракту).
Інтеграція EIP-1271 в існуючий протокол займає від 1 до 3 днів: аудит поточної логіки підписів, заміна перевірок, тести з Gnosis Safe, тести з EOA (регресія). Для нових систем закладається спочатку, не додаючи значних термінів.
Процес роботи та терміни
- Аналіз — вивчаємо поточну логіку підписів у вашому протоколі, виявляємо точки інтеграції.
- Проектування — розробляємо архітектуру з урахуванням EIP-1271, EIP-712, захисту від replay.
- Реалізація — пишемо код на Solidity з використанням OpenZeppelin, Foundry або Hardhat.
- Тестування — unit-тести, інтеграційні тести з Gnosis Safe та AA-гаманцями, fuzzing.
- Аудит — перевірка коду на вразливості, репорт.
- Деплой — розгортання та верифікація в основній мережі.
Терміни: від 1 до 3 днів для простої заміни, до тижня для комплексної інтеграції з переробкою архітектури. Вартість розраховується індивідуально — за нашими даними, клієнти економлять до 90% на транзакціях після впровадження.
Що входить в роботу
- Аудит поточної логіки підписів з репортом.
- Реалізація EIP-1271 (код контракту, тести, документація).
- Міграція існуючих контрактів.
- Інтеграція з вашим фронтендом (ethers.js, viem).
- Захист від типових помилок (revert, replay, рекурсія).
- Тестовий звіт з покриттям.
- Консультація та підтримка після деплою.
Якщо ви зіткнулися з проблемою несумісності підписів, отримайте консультацію по вашому протоколу: ми відповімо на всі питання та оцінимо обсяг робіт. Замовте інтеграцію EIP-1271 під ключ.