pytoniq-core

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 on this page — 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

pytoniq-core on PyPI

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

Evidence: pytoniq_core-0.2.0-py3-none-any.whl

Tags

More Libraries packages