feat: implement CI/CD workflows for testing, linting, and publishing to PyPI

fragmentapi/utils/decoder.py

@@ -6,6 +6,21 @@ from fragmentapi.types import RequestError
 
 
 def clean_decode(payload: str) -> str:
+    """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, or ``""`` for an empty payload.
+
+    Raises:
+        RequestError: If the payload cannot be decoded or parsed.
+    """
     s = payload.strip()
     if not s:
         return ""