Модели и Типы данных
====================

Ниже описаны структуры объектов, которые возвращаются методами библиотеки.

WalletInfo
----------
.. py:class:: WalletInfo()

    Информация о состоянии кошелька.

    * **address** (str): Форматированный адрес кошелька.
    * **balance** (float): Баланс в TON.
    * **state** (str): Состояние кошелька (``active``, ``uninitialized``).

StarsResult / PremiumResult / AdsTopupResult
--------------------------------------------
.. py:class:: PurchaseResult()

    Результат успешной покупки.

    * **transaction_id** (str): Хеш транзакции в блокчейне TON.
    * **username** (str): Юзернейм получателя.
    * **amount** (int): Количество купленного актива.

UsernamesResult / NumbersResult
-------------------------------
.. py:class:: MarketplaceResult()

    Результат поиска в маркетплейсе.

    * **items** (list[dict]): Список найденных лотов.
        * ``name``: Имя лота.
        * ``price``: Цена в TON.
        * ``status``: Статус продажи.
    * **next_offset_id** (str): ID для пагинации.