pytoniq-core

library0.1.46pypypi✓ verified 86d ago

Core data structures and serialization for the TON Blockchain SDK. Currently at version 0.1.46, released under MIT license. Active development with frequent releases.

serialization database

pip install pytoniq-core

github ↗package ↗

INSTALL

IMPORT

SIG · PYTONIQ-CORE

pytoniq-core

serializationpythonv0.1.46

Install

3.9s avg

Import

118ms

Disk

41MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.1.46 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.118s · 37.2MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.9s · import 0.118s · 39MB

41MB installed

● package 41MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Cell

✓ from pytoniq_core import Cell

✗ from pytoniq.cell import Cell

pytoniq-core renamed its top-level module to pytoniq_core (underscore). Old import from pytoniq no longer works.

Address

✓ from pytoniq_core import Address

✗ from pytoniq.address import Address

Address moved to pytoniq_core package.

Slice

✓ from pytoniq_core import Slice

Correct import path.

begin_cell

✓ from pytoniq_core import begin_cell

Function used to start building a Cell.

Create a Cell with basic builder pattern.

from pytoniq_core import Cell, begin_cell, Address # Build a simple cell builder = begin_cell() builder.store_uint(42, 8) cell = builder.end_cell() print(cell.hash.hex())

Debug

Known issues

breakingModule renamed from 'pytoniq' to 'pytoniq_core'. All imports must use the new underscore name.

fix

Change imports: e.g. `from pytoniq_core import Cell` instead of `from pytoniq.cell import Cell`.

affects: >=0.1.0

gotchaCell builder methods like store_uint expect (value, bit_length) not just value. Common mistake: store_uint(42) without bits raises TypeError.

fix

Always provide bit length: `builder.store_uint(42, 8)`.

affects: all

deprecatedOld TON SDK function 'run_get_method' renamed to 'run_get_method_remote' in pytoniq v0.1.35. pytoniq-core itself is not affected but breaking change in sibling library.

fix

Use `run_get_method_remote` in pytoniq if you rely on remote execution.

affects: >=0.1.35

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'pytoniq'

Old import path for core types. pytoniq-core now lives in pytoniq_core package.

fix

Install pytoniq-core and use `from pytoniq_core import ...`

TypeError: store_uint() missing 1 required positional argument: 'bit_len'

store_uint requires two arguments: value and bit_length.

fix

Call as `builder.store_uint(value, bit_length)`

Upgrade

Version history

0.1.46latest on PyPI · released Nov 28, 2025

Audit

Dependencies

blessedoptionalUsed for terminal UI in some tools

Agent activity

7 hits · last 30 days

node

Resources

githubhttps://github.com/yungwine/pytoniq ↗

packagehttps://pypi.org/project/pytoniq-core/ ↗