mirror of
https://github.com/bohd4nx/FragmentAPI.git
synced 2026-07-25 14:24:31 +00:00
bohd4nx
6dd9dcb5d4
- Refactor `get_wallet()` to return `ton_balance` and `usdt_balance` in `WalletInfo`. - Update transaction processing to validate balances for both TON and USDT payment methods. - Introduce `parse_required_payment_amount` utility to extract payment amounts from responses. - Modify tests to cover new balance checks and payment method handling. - Upgrade GitHub Actions artifact upload action to v7. - Enhance documentation and examples to reflect changes in wallet balance handling.
44 lines
1.4 KiB
Python
44 lines
1.4 KiB
Python
from __future__ import annotations
|
|
|
|
import base64
|
|
|
|
from ton_core import Cell
|
|
|
|
from pyfragment.types import ParseError
|
|
|
|
|
|
def clean_decode(payload: str) -> str | Cell:
|
|
"""Decode a base64-encoded BOC payload to a plain-text comment string.
|
|
|
|
Fragment transaction payloads are BOC-serialised TVM cells. This function
|
|
base64-decodes the payload, parses the cell, skips the 32-bit op-code
|
|
prefix, and reads the snake-encoded UTF-8 comment.
|
|
|
|
Args:
|
|
payload: Base64url-encoded BOC string (padding is added automatically).
|
|
|
|
Returns:
|
|
Decoded comment string, ``""`` for an empty payload, or raw ``Cell``
|
|
when payload is a non-UTF8 binary body.
|
|
|
|
Raises:
|
|
ParseError: If the payload cannot be decoded or parsed.
|
|
"""
|
|
s = payload.strip()
|
|
if not s:
|
|
return ""
|
|
s += "=" * (-len(s) % 4)
|
|
try:
|
|
# Fragment may return URL-safe base64 ("-"/"_") in transaction payloads.
|
|
boc = base64.b64decode(s, altchars=b"-_", validate=True)
|
|
cell = Cell.one_from_boc(boc)
|
|
sl = cell.begin_parse()
|
|
sl.load_uint(32) # op code
|
|
try:
|
|
return sl.load_snake_string().strip()
|
|
except UnicodeDecodeError:
|
|
# Some Fragment payloads are binary TVM cells rather than text comments.
|
|
return cell
|
|
except Exception as exc:
|
|
raise ParseError(ParseError.UNPARSEABLE.format(context="payload decode", exc=exc)) from exc
|