Friendly Address
Человеко-читаемый адрес контракта в TON в base64 (EQ.../UQ...) с CRC и флагами. Формат, который пользователи видят в кошельках и на сайтах.
Синонимы: friendly address, дружественный адрес, base64 address
Friendly Address — это человеко-читаемое представление адреса контракта в TON. Это компактная base64-строка из 48 символов, начинающаяся с EQ, UQ, kQ или 0Q. Внутри закодировано всё, что нужно кошельку для безопасной отправки: workchain, hash контракта, флаги bounce и testnet, плюс CRC-проверка.
Структура
Друг-адрес начинается с двух букв, которые задают флаги:
| Префикс | Bounce | Testnet |
|---|---|---|
EQ… | да | нет |
UQ… | нет | нет |
kQ… | да | да |
0Q… | нет | да |
Дальше идут base64-символы: workchain (1 байт), hash (32 байта), CRC16 (2 байта). Если хоть одна буква в адресе ошибочна, CRC не сходится, и кошелёк отказывается отправлять — это главное, чем friendly лучше raw.
EQ vs UQ
EQ означает «можно бонсить» — адрес с включённым bounce-флагом. Это безопасно для контрактов, но если получатель — ещё не задеплоенный wallet, bounce приведёт к потере gas.
UQ означает «не бонсить»: адрес помечен как «non-bounceable», подходит для перевода на новый кошелёк, который ещё не существует. Кошельки автоматически показывают новый адрес в форме UQ, а уже созданный — в EQ.
Где используется
Везде, где адрес видит человек: в кошельке, на сайте партнёра, в виджетах, в QR-кодах. Внутри SDK и в коде контрактов он почти всегда конвертируется в raw перед использованием.
Полная спецификация — в TEP-2: github.com/ton-blockchain/TEPs. Все основные кошельки и эксплореры формат поддерживают.