v2.0.1b2

Release Notes — v2.0.1b2

Beta version 2.0.1b2 of the tonutils library, based on a new architecture.
The project has been fully restructured compared to previous versions.

Installation

This version is published as a pre-release.

pip install --pre tonutils

Key Changes

Core Types and Units

• Switched to nanoton as the base unit of value.

• Introduced standardized core TON entities:

  • network identifiers (mainnet / testnet),
  • workchain identifiers (basechain / masterchain),
  • auxiliary enums and types.

• Improved API type safety and consistency.

ADNL / LiteServer

• Added native AdnlClient and AdnlBalancer.

• Built-in support for:

  • rate limit handling,
  • configurable RPS,
  • automatic retries for common errors (including block not in db).

HTTP Clients and Balancer

• Added ChainstackHttpClient.

• Implemented HttpBalancer:

  • supports multiple providers (Toncenter, TonAPI, etc.),
  • per-client rate limits and RPS configuration,
  • improved fault tolerance.

Contract Wrappers and Utilities

• Refactored contract wrappers and base classes.
• Improved separation of TL-B schemas and get-methods.
• Enhanced type annotations.

Wallet wrappers:

• Added wallet configuration models:

  • initialization configuration,
  • transaction sending parameters.

• All transfer methods now return ExternalMessage instead of a transaction hash:

  • provides helper methods (normalized_hash, as_b64, etc.).

• Added build_external_message:

  • builds and signs an external message without sending,
  • intended for emulation and offline usage.

Additional wrappers and utilities:

• Implemented wrappers for:

  • Vanity (github.com/ton-org/vanity),
  • TON DNS,
  • Telegram usernames and gifts.

• Added and improved utilities:

  • encrypt / decrypt for encrypted comments,
  • hash utilities,
  • TON DNS record parsers and helper methods.

• And much more.

Examples

• Usage examples are available in examples/.

Feedback

This is a beta release. Feedback and testing are welcome.

v0.5.6

What's Changed

• Added one-session support to clients. by @lg1447 in #62

New Contributors

• @lg1447 made their first contribution in #62

Full Changelog: v0.5.5...v0.5.6

v0.5.5

What's Changed

• fix: get router v1 while handling exception by @taiakindaniil in #61

New Contributors

• @taiakindaniil made their first contribution in #61

Full Changelog: v0.5.4...v0.5.5

v0.5.4

What's Changed

• Add the ability to specify query_id when building DeDust native swap messages by @lapismyt in #60

New Contributors

• @lapismyt made their first contribution in #60

Full Changelog: v0.5.3...v0.5.4

v0.5.3

What’s Changed

• Fix timeout initialization in Highload Wallet v3
• Fix domain length validation and address deserialization in verifiers.py
• Add optional fields network and from_ to payload models
  (update request DTOs to include new network field)
• Ensure allowed_domains parameter cannot be None in verification functions
• Refactor models with additional DTO classes for proof and sign data verification
  – update account model with state_init property
  – refactor verifiers to use new DTOs and adjust signature validation logic
• Refactor and secure verify_sign_data and verify_ton_proof:
  add public key parameter, update payload parsing, enforce timestamp validation,
  and handle wallet state initialization decryption

Full Changelog: v0.5.2...v0.5.3

v1.0.0a1

Release Notes — v1.0.0a1

It is an early-stage version that will be expanded over time, as significant work still lies ahead.
Many features from the stable release are not yet implemented, and their absence at this stage is intentional. Please do not expect feature parity with the current stable branch.

Overview

The current stable version of tonutils had a number of architectural and technical issues, so it was decided to rewrite the entire library from scratch. The goal is to fix previous mistakes, improve performance, and simplify future development.

Key Improvements

• Adopted nanoton as the base unit of value representation instead of TON, ensuring compliance with ecosystem standards.
• Significant performance improvements by eliminating repeated client session re-creation.
• Migration from feature-based to layer-based architecture for better scalability and maintainability.
• Overall restructuring of the library and removal of accumulated design flaws.

Removed Features

• Jetton swaps and subdomains are not included in this release, as they are currently considered out of scope. Their inclusion may be reconsidered in the future depending on community demand (issue 904, issue 1081).

Planned Work

• Migration of TonConnect into a separate repository to avoid overloading tonutils and to enable faster release cycles.
• Choosing a new name for the TonConnect library, since tonconnect and pytonconnect are already taken on PyPI. This is currently the main problem :).
• Open to community suggestions on naming or any other proposals.

Tests and Examples

• Minimal tests are provided in the tests/ directory.
• Usage examples are available in the examples/ directory.

Community

Feedback and contributions are welcome.

v0.5.2

What’s Added

• Add JettonMasterStablecoin2 (jetton-contract 2.0) support.

Full Changelog: v0.5.1...v0.5.2

v0.5.1

What's Changed

• fix: comment encrypting algorithm by @miniusercoder in #54

Full Changelog: v0.5.0...v0.5.1

v0.5.0

What's Changed

• Updated pytoniq-core dependency to >=0.1.44 to support upcoming TON protocol changes in ConfigParam#12 and Account TL-B schemes.

Full Changelog: v0.4.9...v0.5.0

v0.4.9

What's Changed

• Added Client.get_transactions and Wallet.transactions methods.

Full Changelog: v0.4.8...v0.4.9