TON Connect vs deeplink

Сравнение TON Connect и подключения через deeplink: что выбрать для Mini App и веб-dApp на TON.

TON Connect vs deeplink — коротко

Для Mini App и веб-dApp дефолт — TON Connect (@tonconnect/ui-react): сессия, список кошельков, единый sendTransaction, меньше адской матрицы ton:// ссылок. Deeplink оставляй для простых one-shot сценариев (оплата по ссылке) или как fallback, не как основную архитектуру.

Таблица сравнения

Параметр	TON Connect	Deeplink (`ton://`, …)
Сессия	Есть (reconnect)	Обычно one-shot
UX	Модалка / список кошельков	Уход в приложение по ссылке
send tx	Стандартный request	Ручная сборка URL / boc
Mini Apps	Рекомендуемый путь	Хрупко между клиентами
Ответ в dApp	Через протокол / события	Часто нет надёжного callback
Поддержка кошельков	Широкая через bridge	Зависит от схемы кошелька

Когда выбрать TON Connect

Telegram Mini App, веб-приложение, кабинет с повторными входами
Нужны статус подключения, смена аккаунта, несколько транзакций за сессию
Хочешь меньше веток «Tonkeeper / другой кошелёк / мобильный Safari»

Когда deeplink ещё уместен

Разовая оплата из сообщения/кнопки без полноценного dApp
Очень простой flow «открой кошелёк → подтверди» без возврата сложного состояния
Временный fallback, пока TON Connect недоступен в узком окружении

Пример: TON Connect как основной путь

tsx

// @tonconnect/ui-react ^2
import { TonConnectButton, useTonConnectUI } from "@tonconnect/ui-react";

export function PayButton() {
  const [tonConnectUI] = useTonConnectUI();

  async function pay() {
    await tonConnectUI.sendTransaction({
      validUntil: Math.floor(Date.now() / 1000) + 300,
      messages: [
        {
          address: "EQD__________________________________________0",
          amount: "10000000", // 0.01 TON в nanotons
        },
      ],
    });
  }

  return (
    <>
      <TonConnectButton />
      <button type="button" onClick={pay}>
        Оплатить
      </button>
    </>
  );
}

Deeplink можно держать рядом для шаринга платежа, но состояние приложения и подпись транзакций в продукте строй вокруг TON Connect.

Материалы gramdocs.tech носят образовательный характер и не являются финансовой, юридической или инвестиционной рекомендацией. Работа с блокчейном TON и токеном Gram связана с рисками потери средств. Правовая информация