v2026.2.2

Added

• payment_method option ("ton" / "usdt_ton") for:
  • purchase_stars()
  • purchase_premium()
  • giveaway_stars()
  • giveaway_premium()

Changed

• Added runtime validation for payment_method via SUPPORTED_PAYMENT_METHODS and ConfigurationError.INVALID_PAYMENT_METHOD
• Updated method docstrings to explicitly document recipient/channel formats:
  • @username / username / https://t.me/username
• get_wallet() now returns balances as separate fields: ton_balance and usdt_balance
• Wallet/system test output now prints TON and USDT balances on separate lines
• Balance checks are now method-aware with explicit thresholds:
  • ton: minimum TON balance threshold via MIN_TON_BALANCE (based on current 50 Stars purchase amount)
  • usdt_ton: minimum USDT balance threshold via MIN_USDT_BALANCE (based on current 50 Stars purchase amount)

Tests

• Extended stars and premium test suites to cover:
  • invalid payment method
  • payment method propagation to init*Request payloads
  • accepted query formats (@, plain username, t.me link)
• Extended wallet tests to verify separate TON/USDT balance values in WalletInfo

Documentation

• Simplified README usage example