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.

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).

See also

• Protocol specification — bridge, RPC, session, and connect
• Public wallet registry — the wallets-v2.json file each wallet registers in
• HTTP bridge reference implementation — Go bridge implementation.
• @tonconnect/protocol — types and helpers shared between the SDK and wallets