feat: update changelog and examples; unify result fields and improve error messages

examples/giveaway_premium.py

@@ -35,7 +35,7 @@ async def main() -> None:
             return
 
     print(
-        f"Premium giveaway created for {result.channel} — {result.winners} winners × {result.amount} months | tx: {result.transaction_id}"
+        f"Premium giveaway created for {result.channel} — {result.winners} winner(s) × {result.amount} months each | tx: {result.transaction_id}"
     )
 
 

examples/giveaway_stars.py

@@ -35,7 +35,7 @@ async def main() -> None:
             return
 
     print(
-        f"Stars giveaway created for {result.channel} — {result.winners} winners × {result.amount} stars | tx: {result.transaction_id}"
+        f"Stars giveaway created for {result.channel} — {result.winners} winner(s) × {result.amount} stars each | tx: {result.transaction_id}"
     )
 
 

examples/topup_ton.py

@@ -36,7 +36,7 @@ async def main() -> None:
             print(f"Invalid argument: {e}")
             return
 
-    print(f"{result.amount} TON successfully sent to {result.username} | tx: {result.transaction_id}")
+    print(f"{result.amount} TON successfully topped up for {result.username} | tx: {result.transaction_id}")
 
 
 if __name__ == "__main__":