helius-python 0.3.2__tar.gz → 0.3.3__tar.gz

{helius_python-0.3.2 → helius_python-0.3.3}/AGENTS.md

@@ -1,14 +1,3 @@
-
-## Conventions
-
-- Use **double-quoted triple strings** (`"""..."""`).
-- Wrap docstring lines at 88 columns.
-- Refer to parameters in backticks: `` `commitment` ``, `` `min_context_slot` ``.
-- Refer to other client methods with their snake_case name in backticks: `` `get_balance` ``.
-- Do NOT include the upstream JSON-RPC method name in the summary — that's already in the See Also URLs.
-- Do NOT copy-paste large chunks from the Helius docs. Summarize and link.
-- Examples (`Example:` section) are encouraged for methods with non-trivial argument combinations (e.g. `get_block_production`, `get_token_accounts_by_owner`), optional for everything else.
-
 ## Implementation conventions
 
 - **If the RPC returns an `RpcResponse` wrapper (`{context, value}`), the Python method MUST return `(context, value)`** — never silently drop `context`. For methods whose `value` is itself a small composite, flatten the tuple (e.g. `get_latest_blockhash` returns `tuple[dict, str, int]`, not `tuple[dict, tuple[str, int]]`). Check the upstream Helius API reference page to see whether the response is wrapped.
@@ -124,7 +113,7 @@ For methods with branching logic (e.g. `get_block_production`, `get_token_accoun
 ## Running
 
 ```bash
-pytest
+.venv/bin/pytest
 ```
 
 All tests must pass and there must be no real network traffic. If a test fails because it tried to hit the network, that's a bug in the test — add the missing `@respx.mock` or `respx` route.

{helius_python-0.3.2 → helius_python-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: helius-python
-Version: 0.3.2
+Version: 0.3.3
 Summary: Typed Python client for the Helius API
 Project-URL: Homepage, https://github.com/markosnarinian/helius-python
 Project-URL: Issues, https://github.com/markosnarinian/helius-python/issues
@@ -13,6 +13,7 @@ Requires-Python: >=3.10
 Requires-Dist: httpx
 Requires-Dist: pydantic
 Requires-Dist: python-dotenv
+Requires-Dist: typing-extensions
 Requires-Dist: websockets
 Provides-Extra: dev
 Requires-Dist: pytest; extra == 'dev'
@@ -322,6 +323,8 @@ continuously.
 | `minimumLedgerSlot`                 | `minimum_ledger_slot()`                       | [guide](https://www.helius.dev/docs/rpc/guides/minimumledgerslot), [reference](https://www.helius.dev/docs/api-reference/rpc/http/minimumledgerslot)                                 |
 | `requestAirdrop`                    | `request_airdrop(...)`                        | [guide](https://www.helius.dev/docs/rpc/guides/requestairdrop), [reference](https://www.helius.dev/docs/api-reference/rpc/http/requestairdrop)                                       |
 | `sendTransaction`                   | `send_transaction(...)`                       | [guide](https://www.helius.dev/docs/rpc/guides/sendtransaction), [reference](https://www.helius.dev/docs/api-reference/rpc/http/sendtransaction)                                     |
+| `getTransactionsForAddress`         | `get_transactions_for_address(...)`           | [reference](https://www.helius.dev/docs/api-reference/rpc/http/gettransactionsforaddress)                                                                                            |
+| `getTransfersByAddress`             | `get_transfers_by_address(...)`               | [guide](https://www.helius.dev/docs/rpc/gettransfersbyaddress), [reference](https://www.helius.dev/docs/api-reference/rpc/http/gettransfersbyaddress)                                |
 
 ## WebSocket subscriptions
 

{helius_python-0.3.2 → helius_python-0.3.3}/README.md

@@ -301,6 +301,8 @@ continuously.
 | `minimumLedgerSlot`                 | `minimum_ledger_slot()`                       | [guide](https://www.helius.dev/docs/rpc/guides/minimumledgerslot), [reference](https://www.helius.dev/docs/api-reference/rpc/http/minimumledgerslot)                                 |
 | `requestAirdrop`                    | `request_airdrop(...)`                        | [guide](https://www.helius.dev/docs/rpc/guides/requestairdrop), [reference](https://www.helius.dev/docs/api-reference/rpc/http/requestairdrop)                                       |
 | `sendTransaction`                   | `send_transaction(...)`                       | [guide](https://www.helius.dev/docs/rpc/guides/sendtransaction), [reference](https://www.helius.dev/docs/api-reference/rpc/http/sendtransaction)                                     |
+| `getTransactionsForAddress`         | `get_transactions_for_address(...)`           | [reference](https://www.helius.dev/docs/api-reference/rpc/http/gettransactionsforaddress)                                                                                            |
+| `getTransfersByAddress`             | `get_transfers_by_address(...)`               | [guide](https://www.helius.dev/docs/rpc/gettransfersbyaddress), [reference](https://www.helius.dev/docs/api-reference/rpc/http/gettransfersbyaddress)                                |
 
 ## WebSocket subscriptions
 

helius_python-0.3.3/TODO.md

@@ -0,0 +1,4 @@
+- Mangling __
+- WebSocket subscription manager
+- Use typeddicts where useful
+- When Python 3.10 and 3.11 go out of support we should use TypedDict from typing instead of typing_extensions

{helius_python-0.3.2 → helius_python-0.3.3}/pyproject.toml

@@ -10,7 +10,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "helius-python"
-version = "0.3.2"
+version = "0.3.3"
 authors = [
   { name="Markos Narinian", email="manarinian@gmail.com" },
 ]
@@ -21,6 +21,7 @@ dependencies = [
   "httpx",
   "pydantic",
   "python-dotenv",
+  "typing-extensions",
   "websockets",
 ]
 classifiers = [

{helius_python-0.3.2 → helius_python-0.3.3}/src/helius/laserstream/websockets.py

@@ -1,11 +1,12 @@
 import json
 from os import environ
-from typing import Annotated, Literal, TypedDict
+from typing import Annotated, Literal
 
 import httpx
 from dotenv import dotenv_values
 from pydantic import AliasGenerator, BaseModel, ConfigDict, Field, model_validator
 from pydantic.alias_generators import to_camel
+from typing_extensions import TypedDict
 from websockets.sync.client import connect
 
 from helius.rpc import JsonRpcRequest

{helius_python-0.3.2 → helius_python-0.3.3}/src/helius/solana_rpc/client.py

@@ -25,7 +25,12 @@ from helius.solana_rpc.models import (
     TokenAccountBalance,
     TokenSupply,
     Transaction,
+    TransactionFilters,
+    TransactionFullDetail,
     TransactionSignature,
+    TransactionSignaturesDetail,
+    Transfer,
+    TransferFilters,
     VotingAccount,
 )
 
@@ -983,3 +988,83 @@ class SolanaRpcClient:
         )
         response = self._send(request)
         return response["result"]
+
+    @validate_call
+    def get_transactions_for_address(
+        self,
+        *,
+        address: str,
+        transaction_details: Literal["signatures", "full"] | None = None,
+        sort_order: Literal["asc", "desc"] | None = None,
+        commitment: Literal["confirmed", "finalized"] | None = None,
+        min_context_slot: int | None = None,
+        limit: Annotated[int, Field(ge=1, le=1000)] | None = None,
+        pagination_token: str | None = None,
+        encoding: Literal["json", "jsonParsed", "base58", "base64"] | None = None,
+        max_supported_transaction_version: int | None = None,
+        filters: TransactionFilters | None = None,
+    ) -> tuple[
+        list[TransactionSignaturesDetail] | list[TransactionFullDetail], str | None
+    ]:
+        request = (
+            JsonRpcRequest(method="getTransactionsForAddress")
+            .add(address)
+            .set("transactionDetails", transaction_details)
+            .set("sortOrder", sort_order)
+            .set("commitment", commitment)
+            .set("minContextSlot", min_context_slot)
+            .set("limit", limit)
+            .set("paginationToken", pagination_token)
+            .set("encoding", encoding)
+            .set("maxSupportedTransactionVersion", max_supported_transaction_version)
+            .set("filters", filters)
+            .build()
+        )
+        response = self._send(request)
+        pagination_token = response["result"]["paginationToken"]
+        data = response["result"]["data"]
+        ta = TypeAdapter(
+            list[TransactionSignaturesDetail]
+            if transaction_details == "signatures"
+            else list[TransactionFullDetail]
+        )
+        transactions = ta.validate_python(data)
+        return transactions, pagination_token
+
+    @validate_call
+    def get_transfers_by_address(
+        self,
+        *,
+        address: str,
+        with_address: str | None = None,
+        direction: Literal["in", "out", "any"] | None = None,
+        mint: str | None = None,
+        sol_mode: Literal["merged", "separate"] | None = None,
+        filters: TransferFilters | None = None,
+        limit: Annotated[int, Field(ge=1, le=100)] | None = None,
+        pagination_token: str | None = None,
+        commitment: Literal["finalized", "confirmed"] | None = None,
+        min_context_slot: int | None = None,
+        sort_order: Literal["asc", "desc"] | None = None,
+    ) -> tuple[list[Transfer], str | None]:
+        request = (
+            JsonRpcRequest(method="getTransfersByAddress")
+            .add(address)
+            .set("with", with_address)
+            .set("direction", direction)
+            .set("mint", mint)
+            .set("solMode", sol_mode)
+            .set("filters", filters)
+            .set("limit", limit)
+            .set("paginationToken", pagination_token)
+            .set("commitment", commitment)
+            .set("minContextSlot", min_context_slot)
+            .set("sortOrder", sort_order)
+            .build()
+        )
+        response = self._send(request)
+        pagination_token = response["result"]["paginationToken"]
+        data = response["result"]["data"]
+        ta = TypeAdapter(list[Transfer])
+        transfers = ta.validate_python(data)
+        return transfers, pagination_token

{helius_python-0.3.2 → helius_python-0.3.3}/src/helius/solana_rpc/models.py

@@ -2,6 +2,9 @@ from typing import Literal
 
 from pydantic import AliasGenerator, BaseModel, ConfigDict
 from pydantic.alias_generators import to_camel
+from typing_extensions import TypedDict
+
+# TODO: Improve camelCase <-> snake_case
 
 
 class Account(BaseModel):
@@ -221,3 +224,98 @@ class Transaction(BaseModel):
     meta: TransactionMetadata | None
     transaction: dict | list
     version: Literal["legacy"] | int | None = None
+
+
+class RangeFilter(TypedDict, total=False):
+    gt: int
+    gte: int
+    lt: int
+    lte: int
+
+
+class ComparisonFilter(TypedDict, total=False):
+    gte: int
+    gt: int
+    lte: int
+    lt: int
+    eq: int
+
+
+TokenTransferFilter = TypedDict(
+    "TokenTransferFilter",
+    {
+        "with": str,
+        "direction": Literal["in", "out", "any"],
+        "mint": str,
+        "amount": RangeFilter,
+    },
+    total=False,
+)
+
+
+class TransactionFilters(TypedDict, total=False):
+    slot: RangeFilter
+    blockTime: ComparisonFilter
+    signature: RangeFilter
+    status: Literal["succeeded", "failed", "any"]
+    tokenAccounts: Literal["none", "balanceChanged", "all"]
+    tokenTransfer: TokenTransferFilter
+
+
+class TransferFilters(TypedDict, total=False):
+    amount: RangeFilter
+    blockTime: RangeFilter
+    slot: RangeFilter
+
+
+class Transfer(BaseModel):
+    model_config = ConfigDict(alias_generator=AliasGenerator(validation_alias=to_camel))
+
+    signature: str
+    slot: int
+    block_time: int
+    type: Literal[
+        "transfer",
+        "mint",
+        "burn",
+        "wrap",
+        "unwrap",
+        "changeOwner",
+        "withdrawWithheldFee",
+    ]
+    from_user_account: str | None
+    to_user_account: str | None
+    mint: str
+    amount: str
+    decimals: int
+    ui_amount: str
+    confirmation_status: Literal["finalized", "confirmed"]
+    transaction_idx: int
+    instruction_idx: int
+    inner_instruction_idx: int
+    from_token_account: str | None = None
+    to_token_account: str | None = None
+    fee_amount: str | None = None
+    fee_ui_amount: str | None = None
+
+
+class TransactionSignaturesDetail(BaseModel):
+    model_config = ConfigDict(alias_generator=AliasGenerator(validation_alias=to_camel))
+
+    signature: str
+    slot: int
+    transaction_index: int
+    err: dict | None
+    memo: str | None
+    block_time: int | None
+    confirmation_status: Literal["finalized", "confirmed"] | None
+
+
+class TransactionFullDetail(BaseModel):
+    model_config = ConfigDict(alias_generator=AliasGenerator(validation_alias=to_camel))
+
+    slot: int
+    transaction_index: int
+    transaction: dict
+    meta: dict | list
+    block_time: int | None

{helius_python-0.3.2 → helius_python-0.3.3}/tests/unit/solana_rpc/test_client.py

@@ -1333,6 +1333,339 @@ def test_get_transaction_count():
     assert_api_key(route)
 
 
+# ---------------------------------------------------------------------------
+# get_transactions_for_address
+# ---------------------------------------------------------------------------
+
+
+@respx.mock
+def test_get_transactions_for_address_signatures():
+    route = mock_rpc(
+        {
+            "data": [
+                {
+                    "signature": "5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
+                    "slot": 1054,
+                    "transactionIndex": 42,
+                    "err": None,
+                    "memo": None,
+                    "blockTime": 1641038400,
+                    "confirmationStatus": "finalized",
+                },
+                {
+                    "signature": "kwjd820slPK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
+                    "slot": 1055,
+                    "transactionIndex": 15,
+                    "err": None,
+                    "memo": None,
+                    "blockTime": 1641038460,
+                    "confirmationStatus": "finalized",
+                },
+            ],
+            "paginationToken": "1055:5",
+        }
+    )
+    with SolanaRpcClient(api_key="test") as client:
+        data, pagination_token = client.get_transactions_for_address(
+            address="Vote111111111111111111111111111111111111111",
+            transaction_details="signatures",
+            sort_order="desc",
+            limit=50,
+            filters={
+                "status": "succeeded",
+                "slot": {"gte": 1000, "lt": 2000},
+                "tokenTransfer": {
+                    "direction": "in",
+                    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+                },
+            },
+        )
+    assert len(data) == 2
+    assert data[0].signature.startswith("5h6x")
+    assert data[0].slot == 1054
+    assert data[0].transaction_index == 42
+    assert data[0].err is None
+    assert data[0].memo is None
+    assert data[0].block_time == 1641038400
+    assert data[0].confirmation_status == "finalized"
+    assert data[1].slot == 1055
+    assert data[1].transaction_index == 15
+    assert pagination_token == "1055:5"
+    assert body(route)["method"] == "getTransactionsForAddress"
+    assert body(route)["params"] == [
+        "Vote111111111111111111111111111111111111111",
+        {
+            "transactionDetails": "signatures",
+            "sortOrder": "desc",
+            "limit": 50,
+            "filters": {
+                "status": "succeeded",
+                "slot": {"gte": 1000, "lt": 2000},
+                "tokenTransfer": {
+                    "direction": "in",
+                    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+                },
+            },
+        },
+    ]
+    assert_api_key(route)
+
+
+@respx.mock
+def test_get_transactions_for_address_full():
+    route = mock_rpc(
+        {
+            "data": [
+                {
+                    "slot": 1054,
+                    "transactionIndex": 42,
+                    "transaction": {
+                        "signatures": [
+                            "5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv"
+                        ],
+                        "message": {
+                            "accountKeys": ["AccountA", "AccountB"],
+                            "instructions": [],
+                        },
+                    },
+                    "meta": {
+                        "fee": 5000,
+                        "preBalances": [1000000, 2000000],
+                        "postBalances": [999995000, 2000000],
+                    },
+                    "blockTime": 1641038400,
+                }
+            ],
+            "paginationToken": "1055:5",
+        }
+    )
+    with SolanaRpcClient(api_key="test") as client:
+        data, pagination_token = client.get_transactions_for_address(
+            address="Vote111111111111111111111111111111111111111",
+            transaction_details="full",
+            encoding="jsonParsed",
+            max_supported_transaction_version=0,
+        )
+    assert len(data) == 1
+    assert data[0].slot == 1054
+    assert data[0].transaction_index == 42
+    assert data[0].block_time == 1641038400
+    assert data[0].meta["fee"] == 5000
+    assert data[0].transaction["message"]["accountKeys"] == ["AccountA", "AccountB"]
+    assert pagination_token == "1055:5"
+    assert body(route)["method"] == "getTransactionsForAddress"
+    assert body(route)["params"] == [
+        "Vote111111111111111111111111111111111111111",
+        {
+            "transactionDetails": "full",
+            "encoding": "jsonParsed",
+            "maxSupportedTransactionVersion": 0,
+        },
+    ]
+    assert_api_key(route)
+
+
+@respx.mock
+def test_get_transactions_for_address_minimal():
+    route = mock_rpc({"data": [], "paginationToken": None})
+    with SolanaRpcClient(api_key="test") as client:
+        data, pagination_token = client.get_transactions_for_address(address="Addr")
+    assert data == []
+    assert pagination_token is None
+    assert body(route)["params"] == ["Addr"]
+    assert_api_key(route)
+
+
+@respx.mock
+def test_get_transactions_for_address_rejects_out_of_range_limit():
+    mock_rpc({"data": [], "paginationToken": None})
+    with SolanaRpcClient(api_key="test") as client:
+        with pytest.raises(Exception):
+            client.get_transactions_for_address(address="Addr", limit=1001)
+
+
+# ---------------------------------------------------------------------------
+# get_transfers_by_address
+# ---------------------------------------------------------------------------
+
+
+@respx.mock
+def test_get_transfers_by_address():
+    route = mock_rpc(
+        {
+            "data": [
+                {
+                    "signature": "5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG",
+                    "slot": 315073428,
+                    "blockTime": 1736159420,
+                    "type": "transfer",
+                    "fromUserAccount": "7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx",
+                    "toUserAccount": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
+                    "fromTokenAccount": "HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x",
+                    "toTokenAccount": "CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY",
+                    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+                    "amount": "2500000",
+                    "decimals": 6,
+                    "uiAmount": "2.5",
+                    "confirmationStatus": "finalized",
+                    "transactionIdx": 35,
+                    "instructionIdx": 1,
+                    "innerInstructionIdx": 0,
+                }
+            ],
+            "paginationToken": "315073428:35:1:0:splTransfer",
+        }
+    )
+    with SolanaRpcClient(api_key="test") as client:
+        data, pagination_token = client.get_transfers_by_address(
+            address="86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
+            with_address="7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx",
+            direction="in",
+            mint="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+            sol_mode="separate",
+            filters={
+                "amount": {"gte": 1000000000, "lt": 10000000000},
+                "blockTime": {"gte": 1735718400},
+            },
+            limit=50,
+            pagination_token="315069220:308:2:1:splTransfer",
+            sort_order="desc",
+        )
+    assert len(data) == 1
+    transfer = data[0]
+    assert transfer.signature.startswith("5GEX")
+    assert transfer.slot == 315073428
+    assert transfer.block_time == 1736159420
+    assert transfer.type == "transfer"
+    assert transfer.from_user_account == "7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx"
+    assert transfer.to_user_account == "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"
+    assert transfer.from_token_account == "HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x"
+    assert transfer.to_token_account == "CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY"
+    assert transfer.mint == "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
+    assert transfer.amount == "2500000"
+    assert transfer.decimals == 6
+    assert transfer.ui_amount == "2.5"
+    assert transfer.confirmation_status == "finalized"
+    assert transfer.transaction_idx == 35
+    assert transfer.instruction_idx == 1
+    assert transfer.inner_instruction_idx == 0
+    assert transfer.fee_amount is None
+    assert transfer.fee_ui_amount is None
+    assert pagination_token == "315073428:35:1:0:splTransfer"
+    assert body(route)["method"] == "getTransfersByAddress"
+    assert body(route)["params"] == [
+        "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
+        {
+            "with": "7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx",
+            "direction": "in",
+            "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+            "solMode": "separate",
+            "filters": {
+                "amount": {"gte": 1000000000, "lt": 10000000000},
+                "blockTime": {"gte": 1735718400},
+            },
+            "limit": 50,
+            "paginationToken": "315069220:308:2:1:splTransfer",
+            "sortOrder": "desc",
+        },
+    ]
+    assert_api_key(route)
+
+
+@respx.mock
+def test_get_transfers_by_address_native_sol_transfer():
+    """Native SOL transfers omit token-account fields."""
+    route = mock_rpc(
+        {
+            "data": [
+                {
+                    "signature": "5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG",
+                    "slot": 315073428,
+                    "blockTime": 1736159420,
+                    "type": "transfer",
+                    "fromUserAccount": "7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx",
+                    "toUserAccount": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
+                    "mint": "So11111111111111111111111111111111111111111",
+                    "amount": "1000000000",
+                    "decimals": 9,
+                    "uiAmount": "1",
+                    "confirmationStatus": "finalized",
+                    "transactionIdx": 0,
+                    "instructionIdx": 0,
+                    "innerInstructionIdx": 0,
+                }
+            ],
+            "paginationToken": None,
+        }
+    )
+    with SolanaRpcClient(api_key="test") as client:
+        data, pagination_token = client.get_transfers_by_address(
+            address="86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
+            sol_mode="merged",
+        )
+    assert pagination_token is None
+    assert data[0].from_token_account is None
+    assert data[0].to_token_account is None
+    assert data[0].mint == "So11111111111111111111111111111111111111111"
+    assert body(route)["params"][1] == {"solMode": "merged"}
+
+
+@respx.mock
+def test_get_transfers_by_address_fee_bearing_transfer():
+    """Token-2022 fee-bearing transfers include feeAmount and feeUiAmount."""
+    route = mock_rpc(
+        {
+            "data": [
+                {
+                    "signature": "5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG",
+                    "slot": 315073428,
+                    "blockTime": 1736159420,
+                    "type": "transfer",
+                    "fromUserAccount": "7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx",
+                    "toUserAccount": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
+                    "fromTokenAccount": "HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x",
+                    "toTokenAccount": "CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY",
+                    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+                    "amount": "2500000",
+                    "feeAmount": "13450000",
+                    "decimals": 6,
+                    "uiAmount": "2.5",
+                    "feeUiAmount": "13.45",
+                    "confirmationStatus": "finalized",
+                    "transactionIdx": 35,
+                    "instructionIdx": 1,
+                    "innerInstructionIdx": 0,
+                }
+            ],
+            "paginationToken": None,
+        }
+    )
+    with SolanaRpcClient(api_key="test") as client:
+        data, _ = client.get_transfers_by_address(address="Addr")
+    assert data[0].fee_amount == "13450000"
+    assert data[0].fee_ui_amount == "13.45"
+    assert_api_key(route)
+
+
+@respx.mock
+def test_get_transfers_by_address_minimal():
+    route = mock_rpc({"data": [], "paginationToken": None})
+    with SolanaRpcClient(api_key="test") as client:
+        data, pagination_token = client.get_transfers_by_address(address="Addr")
+    assert data == []
+    assert pagination_token is None
+    assert body(route)["params"] == ["Addr"]
+    assert_api_key(route)
+
+
+@respx.mock
+def test_get_transfers_by_address_rejects_out_of_range_limit():
+    mock_rpc({"data": [], "paginationToken": None})
+    with SolanaRpcClient(api_key="test") as client:
+        with pytest.raises(Exception):
+            client.get_transfers_by_address(address="Addr", limit=101)
+
+
 # ---------------------------------------------------------------------------
 # get_version
 # ---------------------------------------------------------------------------

helius_python-0.3.2/TODO.md

@@ -1,3 +0,0 @@
-- Mangling __
-- WebSocket subscription manager
-- Use typeddicts where useful