FragmentAPI/docs/reference/models.md

Result Models

Every high-level method returns a typed model, so you can rely on predictable fields instead of raw payload parsing.

Exported result models:

• CookieResult(cookies, expires)
• StarsResult(transaction_id, username, amount)
• PremiumResult(transaction_id, username, amount)
• AdsTopupResult(transaction_id, username, amount)
• AdsRechargeResult(transaction_id, amount)
• StarsGiveawayResult(transaction_id, channel, winners, amount)
• PremiumGiveawayResult(transaction_id, channel, winners, amount)
• WalletInfo(address, state, ton_balance, usdt_balance)
• LoginCodeResult(number, code, active_sessions)
• TerminateSessionsResult(number, message)
• UsernamesResult(items, next_offset_id)
• NumbersResult(items, next_offset_id)
• GiftsResult(items, next_offset)

Most high-level methods return one of these dataclasses.

Where they are used

• Stars/Premium purchase: StarsResult, PremiumResult
• Stars/Premium giveaway: StarsGiveawayResult, PremiumGiveawayResult
• Ads: AdsTopupResult, AdsRechargeResult
• Wallet and utility: WalletInfo, LoginCodeResult, TerminateSessionsResult
• Marketplace search: UsernamesResult, NumbersResult, GiftsResult

Use these models directly in your app layer and avoid passing raw dictionaries around.