Bounceable Address

Bounceable Address — это friendly-форма TON-адреса с включённым bounce-флагом. В base64-форме такой адрес начинается с EQ или kQ (testnet). Когда вы шлёте сообщение на bounceable-адрес, и контракт его не обрабатывает, TON автоматически возвращает деньги обратно.

Когда нужен

Bounceable — это «защитный» режим. Используется в большинстве сценариев:

• Перевод на DeFi-контракт. Если транзакция упадёт (нехватка газа, отказ контракта), TON вернётся, а не потеряются.
• jetton-перевод через jetton-wallet. Стандартные jetton-операции рассчитаны на bounce — это часть TEP-74.
• Любой вызов, где есть риск отказа. DEX-свапы, NFT-минты, голосования — везде bounce включён по умолчанию.

Когда не нужен

Bounceable плох в одном сценарии: отправка на несуществующий контракт. Если адресат — wallet-контракт, ещё не задеплоенный (новый кошелёк, который ни разу не получал TON), bounce приведёт к ошибке и потере gas. Поэтому в этом случае нужно использовать non-bounceable форму (UQ…).

Современные кошельки делают это автоматически: они проверяют статус адресата и показывают EQ для существующих контрактов, UQ — для новых.

Как переключиться

В большинстве UI «полный» адрес (raw 0:abc…) можно отобразить и как EQ, и как UQ — это просто разные кодировки одного и того же hash. SDK предоставляют параметр bounceable: boolean в address.toString(). Семантика одинакова, отличается только поведение сети при ошибке.

Тонкость

Если кто-то шлёт вам TON на ваш кошелёк с bounce=true и кошелёк ещё не задеплоен, TON вернётся отправителю, и вы ничего не получите. Поэтому при первом получении TON просите отправителя использовать UQ-форму или сначала задеплойте кошелёк (любая исходящая транзакция деплоит).