---
id: pytoniq-core
version: "0.2.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# pytoniq-core — TON Blockchain SDK

License: unclear · Maintenance: active · Downloads: 120.4K/mo

## What it is and what it does

pytoniq-core is a low-level SDK for the TON blockchain, providing the foundational data structures and cryptographic primitives needed to interact with TON at the protocol level. It handles binary serialization (cells, slices, builders), address encoding, key generation, signature operations, and TL-schema (de)serialization—the wire format used throughout the TON network.

The package is organized into five main modules: boc (binary object containers and address handling), crypto (ADNL cryptography, CRC functions, key and signature operations), proof (Merkle proof verification), tl (automatic TL serialization), and tl-b (wrappers for TON's block schema and custom schemes). It targets developers building blockchain tools, wallets, or protocol-level applications on TON, and is actively maintained with support for Python 3.9 through 3.14.

Use it for:

- Building TON wallet or node software that needs to serialize and deserialize blockchain messages.
- Verifying Merkle proofs from TON blockchain data to validate state or transaction inclusion.
- Implementing custom TON smart contract interaction libraries that require low-level cell manipulation.
- Generating and managing TON addresses and cryptographic keys for protocol-level operations.
- Parsing and constructing TL-serialized data structures for TON network communication.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

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.

Yes, if you are building TON blockchain applications and need low-level protocol primitives. The package is actively maintained, has no known vulnerabilities, and installs with low friction. 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 wallet or node interface.

## Install

pip install pytoniq-core
uv add pytoniq-core
poetry add pytoniq-core

## Installing pytoniq-core

Before you install: Low friction: pure Python wheel with six runtime dependencies (pycryptodomex, bitarray, requests, x25519, setuptools, PyNaCl). Active maintenance—last commit 2025-11-30, release 7 days old—suggests ongoing support.

License in practice: License status is unclear; neither SPDX nor raw license metadata is available. Verify the actual license terms in the repository before using in proprietary or copyleft-sensitive contexts.

Quickstart:

pip install pytoniq-core

from pytoniq_core import Cell, Address

# Create a cell and address
cell = Cell()
addr = Address('EQBvW8Z5huBkMJYdnfAEM5JqTNkuWX3diqYENkWsIL0XggGG')

Requires Python 3.9 or later; depends on compiled cryptographic libraries (pycryptodomex, PyNaCl, x25519).

Verify before relying:

- Whether the package is suitable for production blockchain applications or primarily for development/testing.
- Performance characteristics when handling large or deeply nested cell structures.
- Compatibility guarantees across minor versions given the active development pace.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 120.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ton blockchain sdk, ton cell serialization, ton cryptography primitives, blockchain binary data structures, ton tl schema deserialization, ton merkle proof verification, ton address handling, blockchain, ton-protocol, cryptography

[View on SkillFed](https://skillfed.io/packages/pytoniq-core) · [View on PyPI](https://pypi.org/project/pytoniq-core/)