Main information

tonpy is a Python package that provides data structures and API to interact with TON blockchain. Tonpy is separate for two packages: C++ bindings and main package that takes pre-built binaries compiled by workflow and creates complete python package with some python code on top of C++ bindings.

We try to provide 100% test coverage on all structures and functions. Github workflow automatically run tests on all supported systems (Linux, Windows, MacOS) / (x86_64 / aarch64) / (py39, py310, py311) and publish package to pypi.

What is supported?

• Basic types:

  • Cell

    • Usage example

  • CellSlice

    • Usage example

  • CellBuilder

    • Usage example

  • VmDict (HashmapE, HashmapAugE)

    • Usage example

  • TypedVmDict (same as VmDict but allow to unpack values / extra with TLB types)

    • Augmented TypedVmDict usage example

  • StackEntry (Tuple included)

    • Usage example

  • Stack

    • Fift usage example

    • TVM usage example

  • Continuation

    • Usage example

  • Augmented data (eval_leaf / skip_extra / eval_fork / eval_empty for HashmapAugE)

    • Usage example

• TVM

  • Raw TVM

    • Usage example

  • Detailed TVM step info

    • Usage example

  • Transaction Emulator

    • Usage example

• TLB

  • TLB basic types

    • Basic TLB examples

  • Python codegen

    • Unpack / pack examples

    • Tag examples

• Autogen

  • Block TLB types

    • Block parse example

• Tools

  • Fift disassembler

    • Usage example

  • Token metadata parser

• Fift

  • Fift (with support of Stack / StackEntry)

    • Usage example

Test examples may show you how to work with library, check tests examples here