From 9a090e3dbc35d36a9729c1d8da7501c5392fd7d7 Mon Sep 17 00:00:00 2001
From: bohd4nx <bohd4n@proton.me>
Date: Sun, 15 Mar 2026 21:45:24 +0200
Subject: [PATCH] feat: implement CI/CD workflows for testing, linting, and
 publishing to PyPI

---
 .github/ISSUE_TEMPLATE/bug.yaml               | 101 ++++++++++++++++++
 .github/ISSUE_TEMPLATE/config.yml             |   5 +
 .github/ISSUE_TEMPLATE/feature.yaml           |  51 +++++++++
 .github/PULL_REQUEST_TEMPLATE.md              |  34 ++++++
 .github/workflows/lint.yml                    |  31 ++++++
 .github/workflows/publish.yml                 |  49 +++++++++
 .github/workflows/tests.yml                   |  11 +-
 .gitignore                                    |  13 +++
 .../unicode_data/15.0.0/charmap.json.gz       | Bin 21726 -> 0 bytes
 fragmentapi/methods/premium.py                |  31 +++---
 fragmentapi/methods/stars.py                  |  26 +++--
 fragmentapi/methods/ton.py                    |  31 +++---
 fragmentapi/types/__init__.py                 |   2 +
 fragmentapi/types/constants.py                |   3 +
 fragmentapi/utils/__init__.py                 |   6 +-
 fragmentapi/utils/decoder.py                  |  15 +++
 fragmentapi/utils/{client.py => http.py}      |  33 +++++-
 fragmentapi/utils/wallet.py                   |  35 +++++-
 pyproject.toml                                |  14 ++-
 requirements-dev.txt                          |   1 +
 requirements.txt                              |   3 +-
 21 files changed, 438 insertions(+), 57 deletions(-)
 create mode 100644 .github/ISSUE_TEMPLATE/bug.yaml
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml
 create mode 100644 .github/ISSUE_TEMPLATE/feature.yaml
 create mode 100644 .github/PULL_REQUEST_TEMPLATE.md
 create mode 100644 .github/workflows/lint.yml
 create mode 100644 .github/workflows/publish.yml
 delete mode 100644 .hypothesis/unicode_data/15.0.0/charmap.json.gz
 rename fragmentapi/utils/{client.py => http.py} (76%)
 create mode 100644 requirements-dev.txt

diff --git a/.github/ISSUE_TEMPLATE/bug.yaml b/.github/ISSUE_TEMPLATE/bug.yaml
new file mode 100644
index 0000000..230a733
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug.yaml
@@ -0,0 +1,101 @@
+name: Bug report
+description: Report an issue or unexpected behavior in FragmentAPI.
+labels:
+  - bug
+body:
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      options:
+        - label: I am sure the error is coming from FragmentAPI code
+          required: true
+        - label: I have searched the issue tracker for similar bug reports, including closed ones
+          required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        ## Context
+        Please provide as much detail as possible to help us reproduce and fix the issue.
+
+  - type: input
+    attributes:
+      label: Operating system
+      placeholder: e.g. Ubuntu 22.04 / macOS 14 / Windows 11
+    validations:
+      required: true
+
+  - type: input
+    attributes:
+      label: Python version
+      description: Run `python --version` inside your virtualenv
+      placeholder: e.g. 3.12.3
+    validations:
+      required: true
+
+  - type: input
+    attributes:
+      label: FragmentAPI version
+      description: Run `pip show fragmentapi` inside your virtualenv
+      placeholder: e.g. 2026.1.0
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Expected behavior
+      description: Describe what you expected to happen.
+      placeholder: e.g. Stars should be gifted and StarsResult returned.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Current behavior
+      description: Describe what is actually happening.
+      placeholder: e.g. RequestError is raised with status 400.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Steps to reproduce
+      description: Minimal steps that reproduce the issue.
+      placeholder: |
+        1. Create FragmentClient with valid credentials
+        2. Call gift_stars("@username", amount=100)
+        3. See error
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Code example
+      description: Provide a [minimal reproducible example](https://stackoverflow.com/help/minimal-reproducible-example) if applicable.
+      placeholder: |
+        import asyncio
+        from fragmentapi import FragmentClient
+
+        async def main():
+            client = FragmentClient(...)
+            result = await client.gift_stars("@username", amount=100)
+
+        asyncio.run(main())
+      render: python
+
+  - type: textarea
+    attributes:
+      label: Traceback / logs
+      description: Paste the full traceback or relevant logs.
+      placeholder: |
+        Traceback (most recent call last):
+          File "main.py", line 7, in main
+            ...
+        fragmentapi.types.RequestError: ...
+      render: sh
+
+  - type: textarea
+    attributes:
+      label: Additional information
+      description: Anything else that might help us diagnose the problem.
+      placeholder: e.g. Only happens with V5R1 wallet version.
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..7fc7197
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Ask a question or start a discussion
+    url: https://github.com/bohd4nx/FragmentAPI/discussions
+    about: General questions, ideas, and community help go here — not in the issue tracker.
diff --git a/.github/ISSUE_TEMPLATE/feature.yaml b/.github/ISSUE_TEMPLATE/feature.yaml
new file mode 100644
index 0000000..ae3d319
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature.yaml
@@ -0,0 +1,51 @@
+name: Feature request
+description: Suggest an improvement or new feature for FragmentAPI.
+labels:
+  - enhancement
+body:
+  - type: dropdown
+    attributes:
+      label: FragmentAPI version
+      description: Which version are you running?
+      options:
+        - latest
+        - older
+        - n/a
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Problem
+      description: Is your request related to a specific problem? Describe it.
+      placeholder: e.g. There is no way to check my current TON balance before sending.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Proposed solution
+      description: Describe what you would like to see added or changed.
+      placeholder: e.g. Add a get_balance() method to FragmentClient.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Alternatives considered
+      description: Any workarounds or alternative approaches you have thought of.
+      placeholder: e.g. I manually call the Fragment API, but it's not ergonomic.
+
+  - type: textarea
+    attributes:
+      label: Code example
+      description: A short example demonstrating the desired API, if applicable.
+      placeholder: |
+        balance = await client.get_balance()
+        print(balance.ton)
+      render: python
+
+  - type: textarea
+    attributes:
+      label: Additional information
+      description: Any other context, screenshots, or references.
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..631b583
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,34 @@
+# Description
+
+Please include a summary of the change and which issue is fixed.
+Include relevant motivation and context.
+
+Fixes # (issue)
+
+## Type of change
+
+- [ ] Documentation (typos, examples, or any docs update)
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] This change requires a documentation update
+
+## How has this been tested?
+
+Describe the tests you ran to verify the change and list any relevant details.
+
+- [ ] Existing tests pass (`pytest`)
+- [ ] New tests added for this change
+
+**Test configuration:**
+* OS:
+* Python version:
+* FragmentAPI version:
+
+## Checklist
+
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my own code
+- [ ] I have updated documentation where necessary
+- [ ] I have added tests that prove my fix or feature works
+- [ ] All new and existing tests pass locally
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
new file mode 100644
index 0000000..ed1ead3
--- /dev/null
+++ b/.github/workflows/lint.yml
@@ -0,0 +1,31 @@
+name: Lint
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  lint:
+    name: Lint & format
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6.0.2
+
+      - uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7.5.0
+
+      - name: Install dev dependencies
+        run: uv pip install --system ".[dev]"
+
+      - name: Run ruff
+        run: ruff check .
+
+      - name: Run black
+        run: black --check . --target-version py312
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
new file mode 100644
index 0000000..bc243b9
--- /dev/null
+++ b/.github/workflows/publish.yml
@@ -0,0 +1,49 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches: [master]
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6.0.2
+
+      - uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7.5.0
+
+      - name: Build distribution
+        run: uv build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/*
+
+  publish:
+    name: Publish
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/fragmentapi/
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v8.0.1
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.13.0
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index d698a55..4edd34f 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -8,18 +8,21 @@ on:
 
 jobs:
   test:
+    name: Run tests
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v6.0.2
 
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-python@v6.2.0
         with:
           python-version: "3.12"
-          cache: "pip"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7.5.0
 
       - name: Install dependencies
-        run: pip install -r requirements.txt pytest pytest-asyncio
+        run: uv pip install --system ".[dev]"
 
       - name: Write cookies.json
         if: ${{ env.COOKIES_JSON != '' }}
diff --git a/.gitignore b/.gitignore
index 9cb8f25..082dca9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -24,3 +24,16 @@ logs/
 .DS_Store
 Thumbs.db
 cookies.json
+
+# Testing & tooling artifacts
+.hypothesis/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Build & distribution
+dist/
+build/
+*.egg-info/
diff --git a/.hypothesis/unicode_data/15.0.0/charmap.json.gz b/.hypothesis/unicode_data/15.0.0/charmap.json.gz
deleted file mode 100644
index c740c027cc85b3221abcca5382b71ad927e89785..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 21726
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

diff --git a/fragmentapi/methods/premium.py b/fragmentapi/methods/premium.py
index b409d63..4f5cce6 100644
--- a/fragmentapi/methods/premium.py
+++ b/fragmentapi/methods/premium.py
@@ -17,9 +17,9 @@ from fragmentapi.types import (
 )
 from fragmentapi.utils import (
     execute_transaction_request,
+    fragment_post,
     get_account_info,
     get_fragment_hash,
-    parse_json_response,
     process_transaction,
 )
 
@@ -40,16 +40,16 @@ async def _search_recipient(
     username: str,
     months: int,
 ) -> str:
-    resp = await session.post(
-        f"https://fragment.com/api?hash={fragment_hash}",
-        headers=HEADERS,
-        data={
+    result = await fragment_post(
+        session,
+        fragment_hash,
+        HEADERS,
+        {
             "query": username,
             "months": months,
             "method": "searchPremiumGiftRecipient",
         },
     )
-    result = parse_json_response(resp, "searchPremiumGiftRecipient")
     recipient = result.get("found", {}).get("recipient")
     if not recipient:
         raise UserNotFoundError(UserNotFoundError.NOT_FOUND.format(username=username))
@@ -62,26 +62,27 @@ async def _init_request(
     recipient: str,
     months: int,
 ) -> str:
-    await session.post(
-        f"https://fragment.com/api?hash={fragment_hash}",
-        headers=HEADERS,
-        data={
+    await fragment_post(
+        session,
+        fragment_hash,
+        HEADERS,
+        {
             "mode": "new",
             "lv": "false",
             "dh": str(int(time.time())),
             "method": "updatePremiumState",
         },
     )
-    resp = await session.post(
-        f"https://fragment.com/api?hash={fragment_hash}",
-        headers=HEADERS,
-        data={
+    result = await fragment_post(
+        session,
+        fragment_hash,
+        HEADERS,
+        {
             "recipient": recipient,
             "months": months,
             "method": "initGiftPremiumRequest",
         },
     )
-    result = parse_json_response(resp, "initGiftPremiumRequest")
     req_id = result.get("req_id")
     if not req_id:
         raise FragmentAPIError(FragmentAPIError.NO_REQUEST_ID.format(context="Premium purchase"))
diff --git a/fragmentapi/methods/stars.py b/fragmentapi/methods/stars.py
index 36bd271..9f15853 100644
--- a/fragmentapi/methods/stars.py
+++ b/fragmentapi/methods/stars.py
@@ -16,9 +16,9 @@ from fragmentapi.types import (
 )
 from fragmentapi.utils import (
     execute_transaction_request,
+    fragment_post,
     get_account_info,
     get_fragment_hash,
-    parse_json_response,
     process_transaction,
 )
 
@@ -38,12 +38,16 @@ async def _search_recipient(
     fragment_hash: str,
     username: str,
 ) -> str:
-    resp = await session.post(
-        f"https://fragment.com/api?hash={fragment_hash}",
-        headers=HEADERS,
-        data={"query": username, "quantity": "", "method": "searchStarsRecipient"},
+    result = await fragment_post(
+        session,
+        fragment_hash,
+        HEADERS,
+        {
+            "query": username,
+            "quantity": "",
+            "method": "searchStarsRecipient",
+        },
     )
-    result = parse_json_response(resp, "searchStarsRecipient")
     recipient = result.get("found", {}).get("recipient")
     if not recipient:
         raise UserNotFoundError(UserNotFoundError.NOT_FOUND.format(username=username))
@@ -56,16 +60,16 @@ async def _init_request(
     recipient: str,
     amount: int,
 ) -> str:
-    resp = await session.post(
-        f"https://fragment.com/api?hash={fragment_hash}",
-        headers=HEADERS,
-        data={
+    result = await fragment_post(
+        session,
+        fragment_hash,
+        HEADERS,
+        {
             "recipient": recipient,
             "quantity": amount,
             "method": "initBuyStarsRequest",
         },
     )
-    result = parse_json_response(resp, "initBuyStarsRequest")
     req_id = result.get("req_id")
     if not req_id:
         raise FragmentAPIError(FragmentAPIError.NO_REQUEST_ID.format(context="Stars purchase"))
diff --git a/fragmentapi/methods/ton.py b/fragmentapi/methods/ton.py
index 325d8e0..e4556cc 100644
--- a/fragmentapi/methods/ton.py
+++ b/fragmentapi/methods/ton.py
@@ -16,9 +16,9 @@ from fragmentapi.types import (
 )
 from fragmentapi.utils import (
     execute_transaction_request,
+    fragment_post,
     get_account_info,
     get_fragment_hash,
-    parse_json_response,
     process_transaction,
 )
 
@@ -38,17 +38,16 @@ async def _search_recipient(
     fragment_hash: str,
     username: str,
 ) -> str:
-    await session.post(
-        f"https://fragment.com/api?hash={fragment_hash}",
-        headers=HEADERS,
-        data={"mode": "new", "method": "updateAdsTopupState"},
+    await fragment_post(session, fragment_hash, HEADERS, {"mode": "new", "method": "updateAdsTopupState"})
+    result = await fragment_post(
+        session,
+        fragment_hash,
+        HEADERS,
+        {
+            "query": username,
+            "method": "searchAdsTopupRecipient",
+        },
     )
-    resp = await session.post(
-        f"https://fragment.com/api?hash={fragment_hash}",
-        headers=HEADERS,
-        data={"query": username, "method": "searchAdsTopupRecipient"},
-    )
-    result = parse_json_response(resp, "searchAdsTopupRecipient")
     recipient = result.get("found", {}).get("recipient")
     if not recipient:
         raise UserNotFoundError(UserNotFoundError.NOT_FOUND.format(username=username))
@@ -61,16 +60,16 @@ async def _init_request(
     recipient: str,
     amount: int,
 ) -> str:
-    resp = await session.post(
-        f"https://fragment.com/api?hash={fragment_hash}",
-        headers=HEADERS,
-        data={
+    result = await fragment_post(
+        session,
+        fragment_hash,
+        HEADERS,
+        {
             "recipient": recipient,
             "amount": amount,
             "method": "initAdsTopupRequest",
         },
     )
-    result = parse_json_response(resp, "initAdsTopupRequest")
     req_id = result.get("req_id")
     if not req_id:
         raise FragmentAPIError(FragmentAPIError.NO_REQUEST_ID.format(context="TON topup"))
diff --git a/fragmentapi/types/__init__.py b/fragmentapi/types/__init__.py
index addcddd..13b69d4 100644
--- a/fragmentapi/types/__init__.py
+++ b/fragmentapi/types/__init__.py
@@ -1,6 +1,7 @@
 from fragmentapi.types.constants import (
     BASE_HEADERS,
     DEVICE,
+    MIN_TON_BALANCE,
     PREMIUM_PAGE,
     REQUIRED_COOKIE_KEYS,
     STARS_PAGE,
@@ -30,6 +31,7 @@ __all__ = [
     # constants
     "BASE_HEADERS",
     "DEVICE",
+    "MIN_TON_BALANCE",
     "PREMIUM_PAGE",
     "REQUIRED_COOKIE_KEYS",
     "STARS_PAGE",
diff --git a/fragmentapi/types/constants.py b/fragmentapi/types/constants.py
index 073d1e7..2bb799d 100644
--- a/fragmentapi/types/constants.py
+++ b/fragmentapi/types/constants.py
@@ -10,6 +10,9 @@ SUPPORTED_WALLET_VERSIONS: frozenset[str] = frozenset(get_args(WalletVersion))
 # Wallet class map — used to resolve the correct contract from WALLET_VERSION
 WALLET_CLASSES: dict[str, type] = {"V4R2": WalletV4R2, "V5R1": WalletV5R1}
 
+# Minimum wallet balance required to cover TON network gas fees.
+MIN_TON_BALANCE: float = 0.056
+
 # Required Fragment session cookie keys
 REQUIRED_COOKIE_KEYS: tuple[str, ...] = ("stel_ssid", "stel_dt", "stel_token", "stel_ton_token")
 
diff --git a/fragmentapi/utils/__init__.py b/fragmentapi/utils/__init__.py
index c570db8..a888ac8 100644
--- a/fragmentapi/utils/__init__.py
+++ b/fragmentapi/utils/__init__.py
@@ -1,14 +1,16 @@
-from fragmentapi.utils.client import (
+from fragmentapi.utils.decoder import clean_decode
+from fragmentapi.utils.http import (
     execute_transaction_request,
+    fragment_post,
     get_fragment_hash,
     parse_json_response,
 )
-from fragmentapi.utils.decoder import clean_decode
 from fragmentapi.utils.wallet import get_account_info, process_transaction
 
 __all__ = [
     "clean_decode",
     "execute_transaction_request",
+    "fragment_post",
     "get_account_info",
     "get_fragment_hash",
     "parse_json_response",
diff --git a/fragmentapi/utils/decoder.py b/fragmentapi/utils/decoder.py
index 43a9e75..77e076a 100644
--- a/fragmentapi/utils/decoder.py
+++ b/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 ""
diff --git a/fragmentapi/utils/client.py b/fragmentapi/utils/http.py
similarity index 76%
rename from fragmentapi/utils/client.py
rename to fragmentapi/utils/http.py
index 53be7bc..0874645 100644
--- a/fragmentapi/utils/client.py
+++ b/fragmentapi/utils/http.py
@@ -76,6 +76,35 @@ def parse_json_response(response: httpx.Response, context: str) -> dict[str, Any
         raise RequestError(RequestError.UNPARSEABLE.format(context=context, exc=exc)) from exc
 
 
+async def fragment_post(
+    session: httpx.AsyncClient,
+    fragment_hash: str,
+    headers: dict[str, str],
+    data: dict[str, Any],
+) -> dict[str, Any]:
+    """POST a single request to the Fragment API.
+
+    Builds the ``/api?hash=`` URL, sends the request, and returns the
+    parsed JSON body. Use this for every API method call — search,
+    init, state updates, etc.
+
+    Args:
+        session: Active httpx session with Fragment cookies.
+        fragment_hash: Short-lived hash from the Fragment page HTML.
+        headers: Page-specific HTTP headers.
+        data: Form data payload; must include a ``"method"`` key.
+
+    Returns:
+        Parsed API response as a dict.
+    """
+    resp = await session.post(
+        f"https://fragment.com/api?hash={fragment_hash}",
+        headers=headers,
+        data=data,
+    )
+    return parse_json_response(resp, data.get("method", "request"))
+
+
 async def execute_transaction_request(
     session: httpx.AsyncClient,
     headers: dict,
@@ -97,9 +126,7 @@ async def execute_transaction_request(
         VerificationError: If Fragment requires KYC verification.
         RequestError: If the response cannot be parsed.
     """
-    url = f"https://fragment.com/api?hash={fragment_hash}"
-    resp = await session.post(url, headers=headers, data=tx_data)
-    transaction = parse_json_response(resp, tx_data.get("method", "transaction"))
+    transaction = await fragment_post(session, fragment_hash, headers, tx_data)
 
     if transaction.get("need_verify"):
         raise VerificationError(VerificationError.KYC_REQUIRED)
diff --git a/fragmentapi/utils/wallet.py b/fragmentapi/utils/wallet.py
index e852bdc..01a0939 100644
--- a/fragmentapi/utils/wallet.py
+++ b/fragmentapi/utils/wallet.py
@@ -4,7 +4,7 @@ from typing import TYPE_CHECKING, Any
 from tonutils.clients import TonapiClient
 from tonutils.types import NetworkGlobalID
 
-from fragmentapi.types import WALLET_CLASSES, TransactionError, WalletError
+from fragmentapi.types import MIN_TON_BALANCE, WALLET_CLASSES, TransactionError, WalletError
 from fragmentapi.utils.decoder import clean_decode
 
 if TYPE_CHECKING:
@@ -16,6 +16,22 @@ def _init_ton_client(client: "FragmentClient") -> TonapiClient:
 
 
 async def process_transaction(client: "FragmentClient", transaction_data: dict) -> str:
+    """Sign and broadcast a Fragment transaction to the TON network.
+
+    Validates the payload structure, checks the wallet balance, decodes the
+    on-chain comment, and calls ``wallet.transfer``.
+
+    Args:
+        client: Authenticated :class:`FragmentClient` instance.
+        transaction_data: Raw transaction dict from ``execute_transaction_request``.
+
+    Returns:
+        Normalised transaction hash string.
+
+    Raises:
+        TransactionError: If the payload is malformed or the broadcast fails.
+        WalletError: If the wallet balance is too low or cannot be fetched.
+    """
     if "transaction" not in transaction_data or "messages" not in transaction_data["transaction"]:
         raise TransactionError(TransactionError.INVALID_PAYLOAD)
 
@@ -30,7 +46,7 @@ async def process_transaction(client: "FragmentClient", transaction_data: dict)
         try:
             await wallet.refresh()
             balance_ton = wallet.balance / 1_000_000_000
-            if balance_ton < 0.056:
+            if balance_ton < MIN_TON_BALANCE:
                 raise WalletError(WalletError.LOW_BALANCE.format(balance=balance_ton))
         except WalletError:
             raise
@@ -54,6 +70,21 @@ async def process_transaction(client: "FragmentClient", transaction_data: dict)
 
 
 async def get_account_info(client: "FragmentClient") -> dict[str, Any]:
+    """Fetch wallet address, public key, and state-init for the Fragment API.
+
+    Fragment requires account info to build each transaction payload. The
+    returned dict is JSON-serialised and passed as the ``account`` field in
+    ``getBuy*Link`` / ``get*Link`` requests.
+
+    Args:
+        client: Authenticated :class:`FragmentClient` instance.
+
+    Returns:
+        Dict with ``address``, ``publicKey``, ``chain``, ``walletStateInit``.
+
+    Raises:
+        WalletError: If account info cannot be retrieved.
+    """
     async with _init_ton_client(client) as ton:
         try:
             wallet_cls = WALLET_CLASSES[client.wallet_version]
diff --git a/pyproject.toml b/pyproject.toml
index 3a407fb..d62ec9c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -30,6 +30,14 @@ dependencies = [
     "tonutils[pytoniq]==2.0.0",
 ]
 
+[project.optional-dependencies]
+dev = [
+    "pytest>=9.0",
+    "pytest-asyncio>=1.0",
+    "ruff",
+    "black",
+]
+
 [project.urls]
 Homepage = "https://github.com/bohd4nx/FragmentAPI"
 Repository = "https://github.com/bohd4nx/FragmentAPI"
@@ -49,11 +57,13 @@ line-length = 128
 target-version = ["py312"]
 
 [tool.ruff]
-target-version = "py312"
 line-length = 128
+target-version = "py312"
 
 [tool.ruff.lint]
 # E — pycodestyle errors, F — pyflakes, W — warnings, I — isort
 select = ["E", "F", "W", "I"]
-# E501 — line too long (covered by line-length above)
 ignore = ["E501"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["E402"]
diff --git a/requirements-dev.txt b/requirements-dev.txt
new file mode 100644
index 0000000..aefbcb6
--- /dev/null
+++ b/requirements-dev.txt
@@ -0,0 +1 @@
+-e .[dev]
diff --git a/requirements.txt b/requirements.txt
index 5d930d9..d6e1198 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,2 +1 @@
-httpx==0.28.1
-tonutils[pytoniq]==2.0.0
+-e .