helius-python 0.0.4__tar.gz → 0.1.0__tar.gz

{helius_python-0.0.4 → helius_python-0.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: helius-python
-Version: 0.0.4
+Version: 0.1.0
 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

{helius_python-0.0.4 → helius_python-0.1.0}/pyproject.toml

@@ -10,7 +10,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "helius-python"
-version = "0.0.4"
+version = "0.1.0"
 authors = [
   { name="Markos Narinian", email="manarinian@gmail.com" },
 ]

{helius_python-0.0.4 → helius_python-0.1.0}/src/helius/client.py

@@ -28,10 +28,8 @@ from helius.models import (
 
 
 class HeliusClient:
-    # BUG: check which endpoints return meaningful data in context
-    # BUG: handle helius errors that do not show by HTTP response code
+    # TODO: handle helius errors that do not show by HTTP response code
     # TODO: check all http methods and all guides and implement pagination and other non-implemented features
-    # TODO: consider refactoring | None = None to Optional[] = None
     def __init__(
         self,
         *,
@@ -69,7 +67,7 @@ class HeliusClient:
         return response.json()
 
     def get_account_info(
-        self,
+        self, *,
         public_key: str,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         encoding: (
@@ -106,7 +104,7 @@ class HeliusClient:
         return context, account_info
 
     def get_balance(
-        self,
+        self, *,
         public_key: str,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         min_context_slot: int | None = None,
@@ -124,7 +122,7 @@ class HeliusClient:
         return context, value
 
     def get_block(
-        self,
+        self, *,
         slot: int,
         commitment: Literal["finalized", "confirmed"] | None = None,
         encoding: Literal["jsonParsed", "base58", "base64", "base64+std"] | None = None,
@@ -149,7 +147,7 @@ class HeliusClient:
         return block
 
     def get_block_commitment(
-        self,
+        self, *,
         slot: int,
     ) -> BlockCommitment:
         request = RpcRequest(method="getBlockCommitment").add(slot).build()
@@ -158,7 +156,7 @@ class HeliusClient:
         return block_commitment
 
     def get_block_height(
-        self,
+        self, *,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         min_context_slot: int | None = None,
     ) -> int:
@@ -172,7 +170,7 @@ class HeliusClient:
         return response["result"]
 
     def get_block_production(
-        self,
+        self, *,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         first_slot: int | None = None,
         last_slot: int | None = None,
@@ -207,7 +205,7 @@ class HeliusClient:
         return context, value
 
     def get_blocks(
-        self,
+        self, *,
         start_slot: int,
         end_slot: int | None,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
@@ -227,7 +225,7 @@ class HeliusClient:
         return response["result"]
 
     def get_blocks_with_limit(
-        self,
+        self, *,
         start_slot: int,
         limit: int,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
@@ -242,7 +240,7 @@ class HeliusClient:
         response = self._send(request)
         return response["result"]
 
-    def get_block_time(self, slot: int) -> int | None:
+    def get_block_time(self, *, slot: int) -> int | None:
         request = RpcRequest(method="getBlockTime").add(slot).build()
         response = self._send(request)
         return response["result"]
@@ -255,7 +253,7 @@ class HeliusClient:
         return cluster_nodes
 
     def get_epoch_info(
-        self,
+        self, *,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         min_context_slot: int | None = None,
     ) -> EpochInfo:
@@ -276,7 +274,7 @@ class HeliusClient:
         return epoch_schedule
 
     def get_fee_for_message(
-        self,
+        self, *,
         message: str,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         min_context_slot: int | None = None,
@@ -323,7 +321,7 @@ class HeliusClient:
         return identity
 
     def get_inflation_governor(
-        self,
+        self, *,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
     ) -> InflationGovernor:
         request = (
@@ -344,7 +342,7 @@ class HeliusClient:
     # TODO: getInflationReward
 
     def get_largest_accounts(
-        self,
+        self, *,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         filter: Literal["circulating", "nonCirculating"] | None = None,
     ) -> tuple[dict, list[LamportAccount]]:
@@ -362,7 +360,7 @@ class HeliusClient:
         return context, largest_accounts
 
     def get_latest_blockhash(
-        self,
+        self, *,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         min_context_slot: int | None = None,
     ) -> tuple[dict, str, int]:
@@ -380,7 +378,7 @@ class HeliusClient:
         return context, blockhash, last_valid_block_height
 
     def get_leader_schedule(
-        self,
+        self, *,
         slot: int | None = None,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         identity: str | None = None,
@@ -409,7 +407,7 @@ class HeliusClient:
         return result
 
     def get_minimum_balance_for_rent_exemption(
-        self,
+        self, *,
         data_length: int,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
     ) -> int:
@@ -424,7 +422,7 @@ class HeliusClient:
         return result
 
     def get_multiple_accounts(
-        self,
+        self, *,
         pubkeys: list[str],
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         encoding: (
@@ -468,7 +466,7 @@ class HeliusClient:
 
     @validate_call
     def get_program_accounts(
-        self,
+        self, *,
         program_id: str,
         commitment: Literal["confirmed", "finalized", "processed"] | None = None,
         min_context_slot: int | None = None,
@@ -509,7 +507,7 @@ class HeliusClient:
         return [(i["pubkey"], Account.model_validate(i["account"])) for i in result]
 
     def get_recent_performance_samples(
-        self,
+        self, *,
         limit: int | None = None,
     ) -> list[PerformanceSample]:
         request = RpcRequest(method="getRecentPerformanceSamples").add(limit).build()
@@ -518,7 +516,7 @@ class HeliusClient:
         return ta.validate_python(response["result"])
 
     def get_recent_prioritization_fees(
-        self,
+        self, *,
         locked_writable_accounts: list[str] | None = None,
     ) -> list[tuple[int, int]]:
         request = (
@@ -531,7 +529,7 @@ class HeliusClient:
 
     @validate_call
     def get_signatures_for_address(
-        self,
+        self, *,
         address: str,
         limit: Annotated[int, Field(ge=1, le=1000)] = 1000,
         before: str | None = None,
@@ -555,7 +553,7 @@ class HeliusClient:
         return transaction_signatures
 
     def get_signature_statuses(
-        self,
+        self, *,
         signatures: list[str],
         search_transaction_history: bool | None = None,
     ) -> tuple[dict, list[SignatureStatus | None]]:
@@ -574,7 +572,7 @@ class HeliusClient:
         return context, signature_statuses
 
     def get_slot(
-        self,
+        self, *,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         min_context_slot: int | None = None,
     ) -> int:
@@ -588,7 +586,7 @@ class HeliusClient:
         return response["result"]
 
     def get_slot_leader(
-        self,
+        self, *,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         min_context_slot: int | None = None,
     ) -> str:
@@ -603,7 +601,7 @@ class HeliusClient:
 
     @validate_call
     def get_slot_leaders(
-        self,
+        self, *,
         start_slot: int,
         limit: Annotated[int, Field(ge=1, le=5000)],
     ) -> list[str]:
@@ -612,7 +610,7 @@ class HeliusClient:
         return response["result"]
 
     def get_stake_minimum_delegation(
-        self,
+        self, *,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
     ) -> tuple[dict, int]:
         request = (
@@ -626,7 +624,7 @@ class HeliusClient:
         return context, value
 
     def get_supply(
-        self,
+        self, *,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         exclude_non_circulating_accounts_list: bool | None = None,
     ) -> tuple[dict, Supply]:
@@ -647,7 +645,7 @@ class HeliusClient:
     # TODO: use getProgramAccountsV2 which supports pagination
 
     def get_token_account_balance(
-        self,
+        self, *,
         token_account: str,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
     ) -> tuple[dict, TokenAccountBalance]:
@@ -663,7 +661,7 @@ class HeliusClient:
         return context, balance
 
     def get_token_accounts_by_delegate(
-        self,
+        self, *,
         delegate_pub_key: str,
         mint: str | None = None,
         program_id: str | None = None,
@@ -712,7 +710,7 @@ class HeliusClient:
         return context, token_accounts
 
     def get_token_accounts_by_owner(
-        self,
+        self, *,
         owner_pub_key: str,
         mint: str | None = None,
         program_id: str | None = None,
@@ -763,7 +761,7 @@ class HeliusClient:
     # TODO: use getTokenAccountsByOwnerV2 and do pagination
 
     def get_token_largest_accounts(
-        self,
+        self, *,
         mint: str,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
     ) -> tuple[dict, list[TokenAccount]]:
@@ -780,7 +778,7 @@ class HeliusClient:
         return context, largest_accounts
 
     def get_token_supply(
-        self,
+        self, *,
         mint_address: str,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
     ) -> tuple[dict, TokenSupply]:
@@ -796,7 +794,7 @@ class HeliusClient:
         return context, token_supply
 
     def get_transaction(
-        self,
+        self, *,
         transaction_signature: str,
         commitment: Literal["finalized", "confirmed"] | None = None,
         encoding: Literal["json", "jsonParsed", "base58", "base64"] | None = None,
@@ -815,7 +813,7 @@ class HeliusClient:
         return transaction
 
     def get_transaction_count(
-        self,
+        self, *,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         min_context_slot: int | None = None,
     ) -> int:
@@ -835,7 +833,7 @@ class HeliusClient:
         return result["solana-core"], result["feature-set"]
 
     def get_vote_accounts(
-        self,
+        self, *,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         vote_pubkey: str | None = None,
         keep_unstaked_delinquents: bool | None = None,
@@ -856,7 +854,7 @@ class HeliusClient:
         return current, delinquent
 
     def is_blockhash_valid(
-        self,
+        self, *,
         blockhash: str,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,
         min_context_slot: int | None = None,
@@ -874,7 +872,7 @@ class HeliusClient:
         return context, value
 
     def request_airdrop(
-        self,
+        self, *,
         public_key: str,
         lamports: int,
         commitment: Literal["finalized", "confirmed", "processed"] | None = None,