Биржа выдала адрес для пополнения, и он начинается с EQ. Кошелёк показывает ваш собственный адрес, и он начинается с UQ. Обозреватель открывает третий вариант: длинную строку с нулём и двоеточием в начале. Хвосты у первых двух подозрительно похожи, но не совпадают, и неясно, какой из них «настоящий».

Настоящие все три. Это один и тот же адрес, записанный разными способами, примерно как одна дата может быть записана «4 ноября» или «04.11».

Но в отличие от даты, у адреса TON первая буква не просто украшение. Она подсказывает сети, как поступить с переводом, если получатель ещё ни разу не пользовался кошельком.

48 символов
Длина обычного адреса TON вроде UQ… или EQ…
4 статуса
Бывает у адреса в сети: не существует, не инициализирован, активен, заморожен.

Суть

Один адрес, несколько записей

У каждого кошелька в сети TON есть адрес в сыром виде: номер цепочки (обычно 0), двоеточие и длинное шестнадцатеричное число. Это его каноническая форма, которую видит сам блокчейн.

Людям показывают удобную форму: 48 символов, в которые упакованы тот же номер, то же число, пара служебных флагов и контрольная сумма. Флаги и определяют первую букву, а контрольная сумма меняет последние символы. Поэтому у UQ- и EQ-записи одного кошелька совпадает почти вся середина, а различаются начало и хвост.

Начало

Что это

Где встретите

UQ…

Удобная запись без возврата (non-bounceable)

Адрес получения в кошельках

EQ…

Удобная запись с возвратом (bounceable)

Адреса бирж, смарт-контрактов, токенов

0:…

Сырая запись без контрольной суммы

Обозреватели, технические поля

kQ…

Запись с возвратом, только для тестовой сети

Тестовые кошельки разработчиков

0Q…

Запись без возврата, только для тестовой сети

Тестовые кошельки разработчиков

Удобная запись бывает в двух кодировках: с символами «/» и «+» или с «_» и «-». Обе правильные, и кошельки обязаны понимать обе.

Флаг возврата

Что значат U и E

Представьте курьера, который пришёл по адресу, а дома никого нет и квартира ещё даже не заселена. У него два варианта: увезти посылку обратно отправителю или оставить у двери. Первая буква адреса — это инструкция курьеру на такой случай.

  • EQ — «вернуть отправителю». Если получатель не может принять перевод, сеть отправит деньги назад.
  • UQ — «оставить у двери». Деньги останутся на адресе получателя, даже если там ещё нет кошелька.

Если получатель обычный и уже работает, разницы нет: перевод дойдёт по любой из записей. Инструкция пригодится только тогда, когда дома никого.

Стандарт сети TEP-2 советует давать кошелькам адрес получения без возврата, то есть UQ, а адреса с возвратом, EQ, оставить для смарт-контрактов с собственной логикой. Поэтому кошелёк обычно показывает вам UQ, а биржа или сервис нередко присылают EQ.

Два перевода на неактивный адрес: верхний возвращается отправителю, нижний остаётся на адресе получателя.
Схема слева направо, две строки. Для неактивного адреса: сверху EQ с возвратом, снизу UQ без возврата. Это не обещание возврата любой ошибочной отправки.

Самое важное

Когда «дома никого»: статусы адреса

Кошелёк в сети TON — это смарт-контракт, и в блокчейне он появляется не сразу. У адреса есть статус, и его видно в обозревателе:

Статус

Что это значит

Что будет с переводом

nonexist — не существует

С адресом ещё ничего не происходило

EQ: вернётся отправителю. UQ: останется на адресе, статус станет uninit

uninit — не инициализирован

На адресе есть деньги, но кошелёк ещё не развёрнут

EQ: вернётся. UQ: зачислится

active — активен

Обычный работающий кошелёк

Дойдёт при любой записи

frozen — заморожен

Долг за хранение превысил 0,1 GRAM, контракт остановлен

Контракт не работает, пока владелец его не восстановит. Выясните это с получателем до перевода

Новый кошелёк становится активным, когда впервые что-то отправляет. До этого он может только принимать, и именно для таких адресов первая буква решает судьбу перевода.

Пример

Учебный пример: числа условные

Друг только что установил кошелёк и прислал адрес. Сам он ещё ничего не отправлял, в обозревателе статус nonexist. Вы переводите ему 10 GRAM.

Если вы вставили адрес в виде UQ…, 10 GRAM останутся на его адресе, статус станет uninit, и друг увидит деньги в кошельке. Первым же переводом он активирует кошелёк.

Если вы взяли тот же адрес в виде EQ…, перевод вернётся к вам за вычетом сетевых комиссий. Деньги не потеряны, но друг их не получил, а вы заплатили за попытку.

Если перевод новому получателю вернулся сам, первым делом проверьте, в каком виде вы вставили адрес. Как найти возврат в истории, разобрано в статье «Как читать транзакцию TON».

Частые загадки

Почему «мой адрес» выглядит по-разному

Кроме UQ и EQ, есть ещё три причины, по которым адреса одного человека не совпадают. Их часто путают с форматом.

  • Разные версии кошелька. Одна фраза может открывать кошельки разных версий, например W5 и v4R2, и у каждой версии свой адрес. Это не разные записи одного адреса, а разные адреса. Подробно — в статье «Кошелёк, адрес и секретная фраза».
  • Кошелёк токена. У каждого владельца USDT или другого токена сети TON есть отдельный маленький контракт для этого токена со своим адресом. В обозревателе его легко принять за ваш. Как их различить — в статье «Как проверить jetton в TON».
  • Тестовая сеть. Адрес на k… или 0Q… существует только в тестовой сети. Приложения основной сети должны отказываться на него отправлять.

Две минуты

Как проверить адрес перед переводом

  1. Скопируйте адрес целиком. Не перепечатывайте его вручную и не собирайте из кусков.
  2. Откройте обозреватель, например tonviewer.com, и вставьте адрес в поиск. Обозреватель покажет статус, баланс и другие записи этого адреса.
  3. Посмотрите статус. Active — перевод дойдёт при любой записи. Nonexist или uninit — получатель новый, используйте UQ-запись, которую показывает его кошелёк.
  4. Сверьте начало и конец адреса с тем, что прислал получатель. Если он прислал UQ, а в обозревателе вы видите EQ, сравнивайте середину: она должна совпадать.

Важно

Контрольная сумма ловит опечатки, сырой формат — нет

В удобной записи адреса есть контрольная сумма. Если в адресе ошибка в символе, кошелёк должен показать предупреждение и не дать отправить. У сырой записи 0:… такой защиты нет: одна ошибка в символе может отправить деньги туда, откуда их не вернуть. Поэтому для переводов используйте адреса UQ… и EQ…, а сырую запись оставьте обозревателю.

Вопросы

Какой формат адреса давать бирже или другу?

Тот, что показывает ваш кошелёк на экране получения. Обычно это UQ, и он подходит для любых переводов на ваш адрес.

Почему адрес для пополнения на бирже начинается с EQ?

Это нормально: биржа может использовать запись с возвратом для своего адреса. Отправляйте на адрес ровно в том виде, в каком его показала биржа, и не забудьте комментарий, если экран пополнения его требует. Подробно — в статье «Memo при переводе в TON».

Можно ли самому превратить EQ в UQ?

Технически это та же запись с другим флагом, и обозреватели показывают оба вида. Но вручную менять буквы нельзя: изменится контрольная сумма. Берите нужную запись из обозревателя или из кошелька.

Что будет, если отправить GRAM на адрес из тестовой сети?

Приложение основной сети должно отказаться от такого перевода. Если адрес начинается с k или 0Q и кто-то просит прислать на него настоящие GRAM, это ошибка или обман.


Первая буква адреса TON выглядит как техническая мелочь, и обычно так и есть. Деньги на работающий кошелёк дойдут по любой записи.

Она становится важной в одном случае: когда получатель новый и ещё ни разу ничего не отправлял. Запомните это одно правило, проверяйте статус адреса в обозревателе, и UQ с EQ больше не будут вас пугать.