tonsdk
Python SDK for TON
Decision gist · record as of 2026-08-14
Yes, with conditions. The library is suitable for TON blockchain development if you need low-level wallet and message construction. Install friction is low and the Apache 2.0 license is permissive. However, maintenance is dormant (766 days since last release), so verify compatibility with your target TON network version and be prepared to handle the acknowledged 'dirty' provider implementation yourself or use supplementary libraries for blockchain queries and message submission.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low install friction with only two runtime dependencies (pynacl, bitarray).
- Maintenance is dormant—last commit was 2024-10-06, over 766 days since the latest release, though the repository remains active and not archived.
License · maintenance · safety
Apache 2.0 (permissive) — Apache 2.0 permissive license allows commercial and private use with minimal restrictions, making it safe for most projects.
last release 2024-07-09 (766 days) · last repo commit 2024-10-06 · 123 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 93,867 downloads/mo, #13,361 on PyPI
Alternatives
Verify before relying
pip install tonsdk
from tonsdk.contract.wallet import WalletVersionEnum, Wallets
from tonsdk.crypto import mnemonic_new
wallet_mnemonics = mnemonic_new()
_mnemonics, _pub_k, _priv_k, wallet = Wallets.from_mnemonics(
wallet_mnemonics, WalletVersionEnum.v3r2, 0)- Whether the dormant maintenance status (766 days since release) affects compatibility with current TON network protocol versions
- Scope and impact of the acknowledged 'dirty' provider implementation on production reliability
- Whether optional dependencies (tvm_valuetypes, aiohttp) are required for core functionality or only for client usage
What it is and what it does
tonsdk is a low-level Python library for working with the TON blockchain. It provides tools to create wallets from mnemonics, construct blockchain messages for deployment and token transfers (NFTs and Jettons), and serialize those messages into BOC (Bag of Cells) format for transmission. The library depends on pynacl for cryptographic operations and bitarray for bit-level data manipulation.
The package is designed for developers building TON applications who need direct control over wallet creation, message construction, and blockchain interaction. It includes wallet classes supporting multiple versions (v3r2 and others), address utilities, and contract interfaces for NFT and Jetton operations. The provider layer (for querying blockchain state and sending messages) is noted as incomplete in the documentation, suggesting it may require supplementary libraries or custom implementation for production use.
Use it for
- Create TON wallets from mnemonics and generate deployment messages for wallet initialization
- Construct and serialize NFT transfer messages to send to the blockchain
- Build Jetton (fungible token) transfer messages with specified amounts and destinations
- Generate raw blockchain messages (BOC format) for custom smart contract interactions
- Manage wallet addresses in multiple formats (raw, bounceable, user-friendly)
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, with conditions.
The library is suitable for TON blockchain development if you need low-level wallet and message construction. Install friction is low and the Apache 2.0 license is permissive. However, maintenance is dormant (766 days since last release), so verify compatibility with your target TON network version and be prepared to handle the acknowledged 'dirty' provider implementation yourself or use supplementary libraries for blockchain queries and message submission.
Install
tonsdk on PyPI
Before you install
Low install friction with only two runtime dependencies (pynacl, bitarray). Maintenance is dormant—last commit was 2024-10-06, over 766 days since the latest release, though the repository remains active and not archived.
License in practice
Apache 2.0 permissive license allows commercial and private use with minimal restrictions, making it safe for most projects.
Quickstart
pip install tonsdk
from tonsdk.contract.wallet import WalletVersionEnum, Wallets
from tonsdk.crypto import mnemonic_new
wallet_mnemonics = mnemonic_new()
_mnemonics, _pub_k, _priv_k, wallet = Wallets.from_mnemonics(
wallet_mnemonics, WalletVersionEnum.v3r2, 0)Verify before relying
- Whether the dormant maintenance status (766 days since release) affects compatibility with current TON network protocol versions
- Scope and impact of the acknowledged 'dirty' provider implementation on production reliability
- Whether optional dependencies (tvm_valuetypes, aiohttp) are required for core functionality or only for client usage
Package facts
| License | Apache 2.0 permissive |
| Python support | Supports the current Python release >=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagespynaclbitarray |
| Maintenance | Dormant 766 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 93,867 / month, #13,361 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Environment :: ConsoleEnvironment :: Web EnvironmentIntended Audience :: DevelopersIntended Audience :: End Users/DesktopLicense :: OSI Approved :: Apache Software LicenseNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Adaptive Technologies |
Evidence: tonsdk-1.0.15-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “TON wallet creation”
- tonsdkLow-level Python library for interacting with the TON blockchain,…
- pytoniq-corepytoniq-core provides low-level primitives for working with the TON…
- pytoniq-core-forkProvides TON Blockchain SDK primitives for Python 3.7–3.14, including…
Give your agent the search over MCP, or paste the wish link into any chat.
Similar packages
Provides TON Blockchain SDK primitives for Python 3.7–3.14, including cell serialization, cryptography, Merkle proof verification, and TL-schema (de)serialization.
However, verify the license status before use in proprietary projects, and confirm that the fork's feature set meets your needs relative to the original upstream…
pytoniq-core provides low-level primitives for working with the TON blockchain: binary object containers (cells, slices, builders), cryptographic operations, Merkle proof verification, and TL-schema serialization for blockchain data structures.
However, verify the license terms first—they are not declared in the metadata—and confirm it fits your use case, as this is a foundational library, not a high-level…
Python client library for the Coinbase Developer Platform that enables creating and managing EVM and Solana blockchain accounts, sending transactions, and interacting with wallet and policy APIs.
Install it if you are building on Coinbase Developer Platform; avoid it if you need a general-purpose web3 library or are not using Coinbase's infrastructure.
Official Python SDK for the Fireblocks API that enables programmatic access to Fireblocks' digital asset custody and blockchain services, including wallet management, transaction handling, and smart contract tokenization.
However, the 354-day release gap warrants checking whether the latest Fireblocks API features are supported before committing to a critical integration—contact…
CosmPy provides Python bindings to interact with Cosmos SDK-based blockchain networks, enabling account queries, token transfers, staking, and smart contract interactions.
Manages cryptographic keys and wallets for the Bittensor network, providing Python bindings to a Rust-based wallet implementation for creating and accessing blockchain credentials.
Install only if you are maintaining legacy code that explicitly depends on bittensor-wallet.
See also bittensor · vonage-subaccounts · xrpl-py