A common question from devs entering TON from the EVM world: “Does WalletConnect work for TON?”. Short answer — no. TON uses its own protocol, TON Connect, functionally similar but architecturally completely different.
This piece is the full breakdown of the differences, what to use when, how to support both as a dApp, and where TON Connect has the edge.
Short answer — what to know in 30 seconds
| Item | WalletConnect | TON Connect |
|---|---|---|
| Target networks | EVM (Ethereum, BSC, Polygon, Arbitrum) | TON only |
| 2026 version | v2.x | v2.0 |
| Transaction format | EVM ABI (RLP-encoded) | TON cells (BOC) |
| Connection | QR code / deep link | QR code / Telegram-bridge |
| Signing | secp256k1 (Ethereum signing) | Ed25519 (TON signing) |
| Wallets | MetaMask, Rainbow, Trust, OKX, etc. | Tonkeeper, MyTonWallet, Tonhub, Wallet by TG |
| Mini Apps support | No | Yes (native) |
Writing a TON dApp → use TON Connect. Writing an EVM dApp → WalletConnect. Cross-chain → both.
How WalletConnect works (EVM)
Architecture
WalletConnect is a broker-based protocol via relay servers:
- dApp generates a session token + QR code
- User scans the QR with their wallet (or taps a deep link on mobile)
- Wallet sets up an encrypted session over WalletConnect Relay (centralized or decentralized in v2)
- dApp → Relay → wallet → user approval → wallet → Relay → dApp
- Transaction is signed on the user’s device with secp256k1
Networks
WalletConnect v2 supports chains via CAIP-2 namespaces (eip155:1 for Ethereum mainnet, eip155:137 for Polygon, etc.).
TON is not part of the EVM namespace and has no CAIP-2 chain ID in standard WalletConnect namespaces. Theoretically it could be added via an extension protocol, but in practice nobody does — TON Connect natively is better.
How TON Connect works
Architecture
TON Connect 2.0 has a similar structure with TON-specific details:
- dApp generates a TC-session + TON Connect QR
- User scans the QR with their wallet OR opens a Mini App in Telegram (where the Telegram-bridge auto-connects Wallet by TG)
- Wallet sets up an encrypted session via the TON Connect Bridge (HTTP-based, no centralized relay)
- dApp → Bridge → wallet → approval → signature → returned to dApp
- Transaction is signed with Ed25519 (TON-native cryptography), packed into a BOC (Bag of Cells)
Specifics
- Telegram-bridge — for Mini Apps, the wallet can be embedded into Telegram (Wallet by TG); connection happens without QR scanning
- Local mode — Tonkeeper Pro on desktop can connect without a relay (peer-to-peer over local WebRTC)
-
Native Telegram support — a Mini App developer gets
tg.initData.user.idand can link a TG username to a TON address
Key architectural differences
1. Transaction format
WalletConnect:
// EVM-style RLP-encoded transaction
{
to: '0xabc...',
value: '0x16345785d8a0000', // 0.1 ETH
data: '0x...'
}
TON Connect:
// TON cell-based transaction
{
valid_until: 1700000000,
messages: [{
address: 'EQAB...',
amount: '100000000', // 0.1 TON
payload: '' // forward message body as BOC
}]
}
A fundamental difference. An EVM tx is a flat ABI-encoded JSON; a TON tx is a nested structure of cells (slices, refs).
2. Signing
- WalletConnect uses secp256k1 (same curve as Bitcoin)
- TON Connect uses Ed25519 (faster verification, smaller signature size — 64 bytes vs 65)
3. Relay
- WalletConnect v2 Relay — bridged via WalletConnect Cloud (centralized, hosted by WalletConnect Inc.), or self-hosted
-
TON Connect Bridge — an HTTP server, can be run by anyone (TON Foundation, wallet providers, dApp deployer). Default —
bridge.ton-connect.devor the wallet’s own bridge
4. Mini Apps integration
A unique TON Connect advantage:
- Inside a Telegram Mini App, TON Connect auto-connects to Wallet by Telegram without QR scanning
- Through
tg.WebApp.openInvoice()you can combine Stars payments + TON Connect transactions in one flow
WalletConnect has no such integration — no Telegram-native support.
What to use when
Case 1: TON-only dApp
- Build on TON Connect 2.0
- Wallet support: Tonkeeper, MyTonWallet, Tonhub, Wallet by TG
- Distribution via Telegram Mini App for bonus reach
Case 2: Multi-chain dApp (EVM + TON)
- WalletConnect for the EVM section
- TON Connect for the TON section
- UI with “Select chain” → “Select wallet”
- Examples: Symbiosis (cross-chain bridge), Allbridge (cross-chain swaps), Bitget (multi-chain wallet ops)
Case 3: Telegram Mini App
- TON Connect 2.0 via Telegram-bridge (auto-detect Wallet by TG)
- Optional: add Bitget Wallet / OKX Wallet for multi-chain users
Case 4: Native Web3 (no Telegram)
- TON Connect via QR + manual deep-link
- Support only Tonkeeper, MyTonWallet, Tonhub
- UX slightly worse without Telegram integration, but it works
How a dApp supports both
TypeScript pseudo-code:
import { TonConnectUI } from '@tonconnect/ui-react';
import { Web3Modal } from '@web3modal/wagmi';
// TON Connect
const tonConnect = new TonConnectUI({
manifestUrl: 'https://my-dapp.com/tonconnect-manifest.json'
});
// WalletConnect (Wagmi)
const wagmiModal = new Web3Modal({
projectId: 'WALLET_CONNECT_PROJECT_ID',
chains: [mainnet, polygon, bsc]
});
// UI router
const Connect = () => {
return (
Connect wallet
tonConnect.openModal()}>
Connect TON wallet
wagmiModal.open()}>
Connect EVM wallet
);
};
More detail in our TON Connect piece.
Security
Common rules (apply to both)
- Phishing — top threat. Always verify URL before approve.
- Transaction payload review — read what you sign carefully. No blanket “approve all.”
- Session expiration — sessions have TTL (24h for TON Connect by default). Re-auth is mandatory.
- Pinned domain backup — for critical dApps verify TLS certs and pinned domains.
TON Connect-specific risks
-
Forward message payload — the user signs not only the main transfer but also a forward cell. If the payload is a
transfer-jettoncall, you can unintentionally send USDT-TON. - Mini App spoofing — someone makes a fake Mini App with UI similar to a legit one. The Telegram-bridge connection is “too automatic.”
- Wallet version drift — Tonkeeper v3.x vs Tonkeeper v4.7 may handle complex payloads differently.
Future of TON Connect in 2026–2027
Per the public TON Foundation roadmap:
- TON Connect 2.1 — out in summer 2026, adds batch-approval (multiple transactions one approval)
- Hardware wallet support — Ledger via TON Connect 2.0 already works; Trezor integration expected
- AI-agent integration — via AgenticKit (see our AgenticKit and Teleport piece)
- Cross-protocol bridges — a theoretical WalletConnect–TON Connect adapter, but not a priority
Bottom line
TON Connect ≠ WalletConnect. Two different protocols, both functional, both mature, but for different ecosystems.
- TON-only project — TON Connect, no question
- EVM-only project — WalletConnect
- Cross-chain — both, with a router UI
- Telegram Mini App — TON Connect via the TG bridge (a huge UX bonus)
For users the difference is invisible: both work via QR / deep-link, both are safe (no seed transmission). The difference matters for developers and for understanding which wallets can connect.
Additional reading:

Top comments (0)