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.

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 integration with the TON blockchain. You need to implement it manually or use AppKit — an SDK for integrating TON into dApps.

Build a wallet

TON Connect does not provide an SDK for wallets. If you're a wallet developer, take one of these approaches:

Implement the protocol directly based on the TON Connect specification. Additionally, you can use @tonconnect/protocol for interfaces.
Use WalletKit — an SDK for wallet services with built-in support for TON Connect

API reference

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

@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

Here you can find a working end-to-end example of an application using TON Connect: demo-dapp-with-react-ui (live).