helius-python 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

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/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/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.1.dist-info → helius_python-0.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: helius-python
-Version: 0.3.1
+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'
@@ -143,11 +144,11 @@ wraps it.
   `programSubscribe`, and the rest) is **supported today**; other
   platform features are **in progress**.
 
-> **Current status:** the standard Solana JSON-RPC surface, the
-> WebSocket subscription surface, and the Admin (account management)
-> usage endpoint are implemented today. Support for Helius RPC
-> extensions and the remaining REST endpoints is actively being worked
-> on.
+**Current status:** the standard Solana JSON-RPC surface, the
+WebSocket subscription surface, and the Admin (account management)
+usage endpoint are implemented today. Support for Helius RPC
+extensions and the remaining REST endpoints is actively being worked
+on.
 
 ## Goals
 
@@ -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.1.dist-info → helius_python-0.3.3.dist-info}/RECORD

@@ -1,13 +1,13 @@
 helius/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 helius/admin/__init__.py,sha256=HboRJXZNzuDAc6r3kj2QZtEcu2U3EWJHv81dYDJGjaA,262
 helius/admin/admin.py,sha256=dcmOgeu10Q43QZC8K-a25vp2JNAb4hs5gu3YWaovV4Y,2541
-helius/laserstream/websockets.py,sha256=ASAltIRlfWKgjkAwox8xbYqULsU6GtJd7TN_nX_F8jA,12417
+helius/laserstream/websockets.py,sha256=MX_3stOzo6EyYJVSlE_zHFNesZkQIfAv2R1e5qdr9b0,12446
 helius/rpc/__init__.py,sha256=ciwM1KfBNyZwCeqOmlWTcSrUD03cbrzgeeEZsn9msi0,85
 helius/rpc/json_rpc_request.py,sha256=hm7WkPo0CnwMnuHE4qR-d93wGArZRPRm-B3uueykL3E,1479
 helius/solana_rpc/__init__.py,sha256=Mfhb6ibrCqAX6AchtL3ViBlpCi9RKP8uhT9e_S5_Wb0,1006
-helius/solana_rpc/client.py,sha256=8WDsBqFYlRcnAYiGB2_gPOm3UuQSSV4JlEY9qwpr63s,34116
-helius/solana_rpc/models.py,sha256=ywzdyUNrJ4mPxwjuntsmJT-tBcHE64pkG96--jKAgIw,5474
-helius_python-0.3.1.dist-info/METADATA,sha256=rtSGuVYxo8jVc1BSiBOBm0ysq0eMrPOb4EafQ4bpDWY,34392
-helius_python-0.3.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-helius_python-0.3.1.dist-info/licenses/LICENSE,sha256=bZc2EDmq_GsWH77uK8LBn1kqqrOPcp2f9p-ys9bYa1E,1072
-helius_python-0.3.1.dist-info/RECORD,,
+helius/solana_rpc/client.py,sha256=dNB5rrOPF1O-wwxmDe3dfjLNSTxB_TT8RUNw-g0XRIQ,37503
+helius/solana_rpc/models.py,sha256=tQmuWi1frDxvQeBSG2ald6Ze2KsaUQQOry45L41MbnQ,7724
+helius_python-0.3.3.dist-info/METADATA,sha256=1ig_sGPRg_mu8adNqPAbBDeiHOe4cOYMFKBjEoz8lMc,34957
+helius_python-0.3.3.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+helius_python-0.3.3.dist-info/licenses/LICENSE,sha256=bZc2EDmq_GsWH77uK8LBn1kqqrOPcp2f9p-ys9bYa1E,1072
+helius_python-0.3.3.dist-info/RECORD,,