mirror of
https://github.com/bohd4nx/FragmentAPI.git
synced 2026-07-25 06:14:29 +00:00
bohd4nx
3e14a01c92
- Security & validation: tighten hash regex, add HTTP timeouts to all requests, pass client.timeout through get_fragment_hash and AsyncClient - Constants: move all constants to types/constants.py; remove re-exports from types/__init__.py; add DEFAULT_TIMEOUT, REQUIRED_COOKIE_KEYS - FragmentClient: add timeout param (default 30 s); async-context-manager support; remove WALLET_CLASSES from public API - Exceptions: remove dead INVALID_USERNAME constant (Fragment validates server-side); keep full hierarchy intact - Tests: add 006_test_methods_mock.py (6 mock tests for all 3 methods); DRY-refactor 004_test_balance.py (_patch_wallet context manager); clean up 005_test_methods.py (remove fragile network test, rename tests) - Examples: switch all 4 examples to async-with; align error messages; replace %-format with f-strings - README: rewrite usage section with single comprehensive async-with example covering all 3 methods and full exception hierarchy - CI: add mypy step to lint job; add pytest-mock and mypy to dev deps; set FORCE_JAVASCRIPT_ACTIONS_TO_NODE24 on all jobs; fix COOKIES_JSON to job-level env var
44 lines
1.3 KiB
Python
44 lines
1.3 KiB
Python
"""
|
||
Example: top up a Telegram Ads account with TON.
|
||
|
||
Amount must be an integer between 1 and 1 000 000 000 TON.
|
||
Your wallet must hold at least the topup amount + ~0.056 TON for gas.
|
||
"""
|
||
|
||
import asyncio
|
||
|
||
from pyfragment import ConfigurationError, FragmentClient, UserNotFoundError, WalletError
|
||
|
||
SEED = "word1 word2 ... word24"
|
||
API_KEY = "YOUR_TONAPI_KEY"
|
||
COOKIES = {
|
||
"stel_ssid": "YOUR_STEL_SSID",
|
||
"stel_dt": "YOUR_STEL_DT",
|
||
"stel_token": "YOUR_STEL_TOKEN",
|
||
"stel_ton_token": "YOUR_STEL_TON_TOKEN",
|
||
}
|
||
|
||
USERNAME = "@username"
|
||
AMOUNT = 10 # TON, integer — 1–1 000 000 000
|
||
|
||
|
||
async def main() -> None:
|
||
async with FragmentClient(seed=SEED, api_key=API_KEY, cookies=COOKIES) as client:
|
||
try:
|
||
result = await client.topup_ton(USERNAME, amount=AMOUNT, show_sender=True)
|
||
except UserNotFoundError:
|
||
print(f"User {USERNAME} was not found on fragment.com — check the username and try again.")
|
||
return
|
||
except WalletError as e:
|
||
print(f"Wallet error — insufficient balance or misconfiguration: {e}")
|
||
return
|
||
except ConfigurationError as e:
|
||
print(f"Invalid argument: {e}")
|
||
return
|
||
|
||
print(f"{result.amount} TON successfully sent to {result.username} | tx: {result.transaction_id}")
|
||
|
||
|
||
if __name__ == "__main__":
|
||
asyncio.run(main())
|