TON Connect overview

What TON Connect is

TON Connect is the standard wallet connection protocol for the TON blockchain.

It links a dApp to a user's wallet over an end-to-end encrypted session so the app can read the connected address, request signatures, and send transactions — without ever touching the user's keys.

Digital goods and services sold inside Telegram Mini Apps use Telegram Stars. TON Connect remains available for permitted blockchain interactions under Telegram's blockchain guidelines.

Choose your path

Build a dApp

TON Connect allows connecting TON wallets to the frontend of web applications or Telegram Mini Apps.

Start here:

Get started — install the SDK, host a manifest, render a Connect button. React, Next.js, and vanilla JS recipes in one page.
How-to recipes — connect, disconnect, send a transaction, sign data, gasless transfers, embedded requests, filter wallets, WalletConnect support.
Core concepts — architecture, bridges, sessions, universal links, manifest, registry, feature negotiation, security model.

When something breaks, jump to Troubleshooting — error codes and manifest 404 / CORS — or the FAQ for design-choice questions.

TON Connect does not provide deeper integrations with the TON blockchain. Implement them manually.

Build a wallet

TON Connect does not provide an SDK for wallets. If you're a wallet developer, implement the protocol directly based on the specification.

When using TypeScript, prefer utilizing interfaces from @tonconnect/protocol.

See the manual implementation guides for more.

Explore an open-source wallet implementation that supports TON Connect and deeper TON blockchain integrations.

API reference

The dApp-facing packages live in the ton-connect/sdk monorepo on GitHub:

@tonconnect/ui-react — hooks and prebuilt components for React.
@tonconnect/ui — framework-agnostic UI, same components without React bindings.
@tonconnect/sdk — headless connector for server-side flows or custom UI.
@tonconnect/protocol — wire-format types and session cryptography for wallet/SDK implementers.

Examples

Working end-to-end example: demo-dapp-with-react-ui, deployed here.