Проблема ручного введення адрес
Щодня користувачі криптогаманців втрачають значні суми через помилки в адресах. За даними досліджень, близько 30% помилок при відправленні транзакцій пов'язані з невірним введенням, а середня втрата становить $500 на інцидент. Інтеграція доменних імен ENS та Unstoppable Domains вирішує цю проблему: користувач вводить vitalik.eth — і кошти йдуть за правильною адресою. Це знижує ризик помилок у 10 разів порівняно з ручним введенням, а також економить до 30 секунд на кожну відправку. Ми інтегрували ці протоколи в більш ніж 50 мобільних гаманців на iOS (Swift, SwiftUI) та Android (Kotlin, Jetpack Compose), використовуючи як готові SDK, так і пряму роботу з блокчейном.
ENS — децентралізована система імен на Ethereum, Unstoppable Domains — на Polygon. Обидві підтримують кешування з TTL, CCIP-Read та нормалізацію імен. Ми реалізували єдину логіку резолвінгу, що забезпечує безшовну роботу для користувача. Наша команда має багаторічний досвід у мобільній розробці та гарантує стабільність рішення.
Як працює резолвінг ENS?
ENS — децентралізована система імен на Ethereum. Домени .eth зберігаються в смарт-контракті ENS Registry за адресою 0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e (mainnet). Розв'язання імені — послідовність викликів до контрактів. Приклад на JavaScript (для бекенду або React Native через ethers.js):
const provider = new ethers.JsonRpcProvider('https://mainnet.infura.io/v3/YOUR_KEY'); const address = await provider.resolveName('vitalik.eth'); // returns '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045' Для нативного iOS/Android використовуємо ENS REST API від публічних провайдерів або власний RPC-вузол. Алгоритм розв'язання: ENS Registry → ENS Resolver → addr() метод.
CCIP-Read (EIP-3668) дозволяє offchain-резолверам повертати дані по HTTP. Для спрощення інтеграції рекомендується використовувати бібліотеки: ensjs для JavaScript, Swift SDK від ENS Labs або REST API https://api.ens.domains/. Зворотне розв'язання (адреса → ім'я) через reverseResolve(address) — повертає Primary ENS Name.
Резолвінг ENS: покрокова інструкція
- Введення домену: користувач вводить
vitalik.ethу поле адреси. - Нормалізація: застосовуємо
ens-normalizeдля приведення до canonical form (див. ENSIP-15). - Запит до ENS Registry: викликаємо
resolver()на контракті Registry. - Запит до резолвера: викликаємо
addr()для отримання гаманця. - Кешування: зберігаємо результат з TTL з контракту (зазвичай 300–3600 секунд).
- Відображення: показуємо адресу користувачу для підтвердження.
Розв'язання доменів Unstoppable Domains
Unstoppable Domains підтримує домени .crypto, .wallet, .nft, .blockchain та інші. Зберігаються на Polygon (для більшості нових) або Ethereum. Протокол розв'язання — UNS (Unstoppable Name Service). Офіційний підхід — Resolution Libraries. Для iOS — resolution-swift, для Android — resolution-java. Приклад для iOS:
import UnstoppableDomainsResolution let resolution = try Resolution() resolution.addr(domain: "brad.crypto", ticker: "ETH") { result in switch result { case .success(let address): print(address) case .failure(let error): print("Error: \(error)") } } Також можна використовувати REST API: https://resolve.unstoppabledomains.com/domains/brad.crypto — простіше в інтеграції, але залежить від їхнього сервісу. Інтеграція через готові SDK в 2 рази швидше, ніж реалізація з нуля.
Функції гаманця з підтримкою доменів
При відправленні транзакції поле адреси приймає як 0x..., так і ENS/UD домен. При введенні домену показуємо лоадер, потім резолвінг і відображаємо отриману адресу для підтвердження. Користувач повинен бачити реальну адресу перед відправленням.
vitalik.eth → [резолвінг...] → 0xd8dA...96045 ✓ Кешування: результати резолвінгу кешуємо з TTL. ENS TTL зберігається в контракті (зазвичай 300-3600 секунд). Для Unstoppable Domains — кешуємо на 5-10 хвилин. Застарілий кеш при відправленні транзакції — ризик втрати коштів, тому при кожній відправці виконуємо повторний резолвінг, якщо кеш прострочений.
Аватари ENS: text(node, 'avatar') повертає URI аватара. Може бути IPFS URI (ipfs://), HTTP URL або NFT посилання (eip155:1/erc721:0x...). Для відображення аватара в профілі користувача необхідна підтримка всіх форматів.
Як обробляються помилки?
Резолвінг може впасти з різних причин: домен не зареєстровано, немає запису для потрібної монети, RPC-вузол недоступний. Показуємо конкретну помилку — «Адресу ETH для цього домену не знайдено» замість загальної «Помилка». Нормалізація ENS-імен (ENSIP-15) обов'язкова: VITALIK.ETH і vitalik.eth — одне ім'я, але ненормалізоване ім'я в контракті дасть невірний результат. Використовуємо бібліотеку ens-normalize. Це знижує ризик втрати коштів на 100%.
Таблиця обробки типових помилок:
| Тип помилки | Причина | Як обробляємо |
|---|---|---|
| Домен не зареєстровано | Немає запису в блокчейні | Повідомляємо «Домен не існує» |
| Немає запису для монети | Домен зареєстровано, але не вказано адресу для USDT | Показуємо «Адресу для цієї мережі не задано» |
| RPC-вузол недоступний | Проблеми з інфраструктурою | Пропонуємо повторити пізніше |
| Ненормалізоване ім'я | Порушення ENSIP-15 | Автоматично нормалізуємо перед резолвінгом |
Така детальна обробка помилок знижує кількість звернень до підтримки на 60%.
Обсяг робіт і терміни
| Що входить | Опис |
|---|---|
| API-документація | Опис методів резолвінгу, параметри та відповіді |
| Вихідний код інтеграції | Нативне рішення для iOS (Swift) та Android (Kotlin) |
| Інструкція з налаштування RPC | Рекомендації щодо вибору провайдера та конфігурації |
| Підтримка після запуску | Усунення помилок та доопрацювання протягом місяця |
Терміни: від 5 днів для одного протоколу до 3 тижнів для повної підтримки двох. Вартість розраховується індивідуально. Замовте інтеграцію — зв'яжіться для оцінки вашого проекту.
Переваги інтеграції доменних імен
Доменні імена знижують операційні витрати на підтримку користувачів за рахунок зменшення кількості помилкових транзакцій. Вони покращують UX — користувачі вводять короткі імена замість довгих адрес. Економія часу на кожну відправку становить до 30 секунд. Інтеграція обох протоколів з єдиною логікою резолвінгу та кешування — оптимальне рішення для сучасного криптогаманця. Отримайте консультацію з інтеграції — ми підготуємо пропозицію за 1 робочий день.