TON Connect

TON Connect is an open-source framework that provides a standard method for user authentication between TON wallets and decentralized applications (dApps). It replaces manual seed‑phrase entry and address copying with a single, secure connection flow.

TON Connect lets users link their TON wallet to any dApp with one click, offering cross‑platform compatibility, built‑in security, and developer‑friendly SDKs. It streamlines authentication and transaction signing across desktop, mobile, and browser environments.

Core Features#

Cross‑Platform Compatibility

The protocol works on desktops, smartphones, and tablets, supporting mobile apps, desktop clients, and browser extensions. This ensures a consistent experience regardless of device.

Developer‑Friendly Toolkit

TON Connect supplies a JavaScript SDK (@tonconnect/sdk), UI components (@tonconnect/ui), and React bindings (@tonconnect/ui-react). These packages let developers integrate wallet connections without building custom bridges for each wallet.

Robust Security

Seed phrases and private keys never leave the wallet. dApps receive only signed responses, keeping user credentials isolated from the application layer.

Streamlined User Experience

Connection is initiated with a single click. Interfaces can display QR codes or deep‑link schemes to guide users on mobile devices.

Community‑Driven Development

The specification and SDKs are open‑source, with contributions from independent developers across the TON ecosystem.

How TON Connect Works#

A user triggers an action in a dApp that requires wallet interaction (e.g., signing a transaction).
The dApp sends a connection request to the TON Connect bridge.
The bridge forwards the request to the user's wallet (mobile app, desktop client, or browser extension).
The wallet prompts the user to approve the request.
Upon approval, the wallet returns a signed response to the bridge.
The bridge relays the signed response back to the dApp, which can then submit the transaction or verify the user's identity.

SDKs and Resources#

@tonconnect/sdk – core JavaScript library for any web dApp.
@tonconnect/ui – ready‑made UI components (modals, buttons).
@tonconnect/ui-react – React bindings for quick integration.

Documentation and installation instructions are available at the official TON Connect documentation site.

Benefits for Developers#

Reduces integration time by providing a single API for all TON wallets.
Offers pre‑built UI components, eliminating the need to design connection dialogs from scratch.
Ensures a standardized authentication flow across the ecosystem.