Реализация поддержки ENS/Unstoppable Domains в мобильном кошельке
Адреса вроде 0x742d35Cc6634C0532925a3b8D4C9C3... никто не запоминает и не вводит вручную без ошибок. ENS и Unstoppable Domains решают эту проблему: vitalik.eth или myname.crypto превращаются в адрес при разрешении. Реализация в мобильном кошельке требует понимания обеих систем — они работают по-разному.
ENS: Ethereum Name Service
ENS — децентрализованная система имён на Ethereum. Домены .eth хранятся в смарт-контракте ENS Registry на адресе 0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e (mainnet). Разрешение имени — это последовательность вызовов к контрактам.
Прямой путь через ethers.js (для бэкенда или React Native с Web3-библиотеками):
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): современные ENS имена могут использовать offchain резолверы — контракт возвращает URL для HTTP-запроса за данными. Это усложняет прямую реализацию. Рекомендую использовать готовые библиотеки: ensjs для JS, Swift SDK от ENS Labs или REST API https://api.ens.domains/.
Обратное разрешение (адрес → имя): reverseResolve(address) — возвращает Primary ENS Name если пользователь его установил. Полезно для отображения «vitalik.eth» вместо адреса в UI.
Unstoppable Domains
Unstoppable Domains поддерживает домены .crypto, .wallet, .nft, .blockchain и другие. Хранятся на Polygon (для большинства новых) или Ethereum. Протокол разрешения — UNS (Unstoppable Name Service).
Официальный подход — Resolution Libraries. Для iOS: resolution-swift от Unstoppable Domains, для Android — resolution-java.
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 — проще в интеграции, зависит от их сервиса.
Что реализуем в кошельке
При отправке транзакции: поле адреса принимает как 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 библиотеку обязательна.
Сроки: поддержка ENS или Unstoppable Domains по отдельности — 5-7 дней. Оба протокола с кэшированием, аватарами и корректной обработкой ошибок — 2-3 недели.