Skip to main content
ton-connect is a Python SDK implementing the TON Connect protocol for dApp backends and bots. It handles wallet connections over the HTTP bridge, transaction and sign-data requests, and cryptographic verification of wallet responses — everything a server-side application needs to talk to TON wallets.
The package is standalone and does not require tonutils. It replaces the former tonutils.tonconnect module.

Features

  • Wallet Connection — connect wallets, restore and manage per-user sessions.
  • Send Transaction — build, send, and track transaction requests.
  • Sign Data — request signatures over text, binary, and cell payloads.
  • TON Proof — verify wallet ownership on your backend.
  • Storage — file, in-memory, or any custom key-value backend.
  • TonConnect-UI Interop — import and export sessions created by TonConnect-UI frontends.

Installation

Quick Start

Guide

Installation and Initialization

Manifest, storage backends, wallet catalogue, and the TonConnect manager.

Connect Wallet

Connect links, TON Proof, session restore, import, and export.

Send Transaction

Build transaction payloads and handle wallet responses.

Sign Data

Request signatures over text, binary, and cell payloads.

Reference

  • Event Handling — react to connect, transaction, and sign-data events with registered handlers.
  • Backend Verification — verify TON Proof and sign-data results server-side.
  • Errors — exception hierarchy and wallet RPC error codes.

GitHub

Source code, examples, and issue tracker.