helius-python 0.1.1__tar.gz → 0.2.0__tar.gz

{helius_python-0.1.1 → helius_python-0.2.0}/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -24,7 +24,7 @@ body:
         your API key.
       render: python
       placeholder: |
-        from helius.client import HeliusClient
+        from helius.solana_rpc import HeliusClient
 
         with HeliusClient(api_key="...") as c:
             c.get_balance(public_key="...")

{helius_python-0.1.1 → helius_python-0.2.0}/AGENTS.md

@@ -1,4 +1,4 @@
-When implementing a function for a RPC method in the HeliusClient class, read the docs for the specific RPC method. For example, for the get_supply function (getSupply RPC method) you should read https://www.helius.dev/docs/rpc/guides/getsupply and https://www.helius.dev/docs/api-reference/rpc/http/getsupply.
+When implementing a function for a RPC method in the SolanaRpcClient class, read the docs for the specific RPC method. For example, for the get_supply function (getSupply RPC method) you should read https://www.helius.dev/docs/rpc/guides/getsupply and https://www.helius.dev/docs/api-reference/rpc/http/getsupply.
 
 # API Reference
 
@@ -6,7 +6,7 @@ The API reference is generated from **Google-style docstrings** on every public
 
 ## Where docstrings live
 
-- **Client methods** (`HeliusClient.get_*`, `is_*`, `request_*`, etc.) — every public method gets a docstring. Private methods (`_send`, dunders) do not need one.
+- **Client methods** (`SolanaRpcClient.get_*`, `is_*`, `request_*`, etc.) — every public method gets a docstring. Private methods (`_send`, dunders) do not need one.
 - **Models** (`src/helius/models.py`) — every public model class gets a docstring describing what it represents. Individual fields don't need per-field docstrings if their names and types are self-explanatory; only document fields where the meaning, units, or nullability isn't obvious from the type alone.
 - **Builders / helpers** (`RpcRequest`) — class docstring describing purpose, plus one-line docstrings on each public method.
 
@@ -123,7 +123,7 @@ tests/
   unit/
     test_rpc_request.py  # RpcRequest builder
     test_models.py       # pydantic model validation against fixtures
-    test_client.py       # one test (or small group) per client method
+    test_solana_rpc.py       # one test (or small group) per client method
 ```
 
 ## Three Layers
@@ -154,7 +154,7 @@ One fixture per model is enough. The goal is to catch schema mismatches (missing
 
 ### 3. Client methods — `respx`-mocked tests
 
-For each method on `HeliusClient`, write at least one test that asserts **both** sides of the wire:
+For each method on `SolanaRpcClient`, write at least one test that asserts **both** sides of the wire:
 
 - **Outgoing request:** the JSON body sent to Helius matches the JSON-RPC payload you expect — correct `method`, correct positional `params`, correct config object with snake → camel mapping, and optional arguments omitted when `None`.
 - **Return value:** the method correctly parses a canned response into the documented return shape (model, tuple, primitive, etc.).
@@ -169,7 +169,7 @@ Skeleton:
 import json
 import httpx
 import respx
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
 @respx.mock
 def test_get_balance():
@@ -183,7 +183,7 @@ def test_get_balance():
             },
         )
     )
-    with HeliusClient(api_key="test") as c:
+    with SolanaRpcClient(api_key="test") as c:
         assert c.get_balance("So11...112", commitment="finalized") == 42
 
     sent = route.calls.last.request
@@ -197,9 +197,9 @@ For methods with branching logic (e.g. `get_block_production`, `get_token_accoun
 
 ## Conventions
 
-- Construct `HeliusClient` in tests with an explicit `api_key="test"` (or similar). Never rely on a real `.env` file.
-- Use the context-manager form (`with HeliusClient(...) as c:`) in tests so the `httpx.Client` is closed cleanly.
-- Group tests in `tests/unit/test_client.py` by method, but a single file is fine until it grows unwieldy.
+- Construct `SolanaRpcClient` in tests with an explicit `api_key="test"` (or similar). Never rely on a real `.env` file.
+- Use the context-manager form (`with SolanaRpcClient(...) as c:`) in tests so the `httpx.Client` is closed cleanly.
+- Group tests in `tests/unit/test_solana_rpc.py` by method, but a single file is fine until it grows unwieldy.
 - Test names should describe the behavior, not the implementation: `test_get_balance_includes_commitment_in_config`, not `test_get_balance_calls_set`.
 - When adding a new client method, the PR must include: (a) a `respx` test asserting the request payload, and (b) a fixture-based model test if the method introduces or uses a model. This is enforced in `CONTRIBUTING.md`.
 

{helius_python-0.1.1 → helius_python-0.2.0}/CONTRIBUTING.md

@@ -66,7 +66,7 @@ prior discussion; just send them.
 ## Codebase Conventions
 
 Please match the existing style of the codebase. Skim
-[`src/helius/client.py`](src/helius/client.py) and
+[`src/helius/solana_rpc.py`](src/helius/solana_rpc.py) and
 [`src/helius/models.py`](src/helius/models.py) before writing new code. In
 particular:
 

{helius_python-0.1.1 → helius_python-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: helius-python
-Version: 0.1.1
+Version: 0.2.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
@@ -118,55 +118,6 @@ Description-Content-Type: text/markdown
   </p>
   
 **A complete, typed Python client for [Helius](https://helius.dev) — the Solana developer platform.**
-<br />
-
-## TL;DR
-
-```bash
-pip install helius-python
-```
-
-```python
-# export HELIUS_API_KEY=your_key   (or put it in .env)
-
-from helius.client import HeliusClient
-
-with HeliusClient() as helius:
-    _ctx, lamports = helius.get_balance("7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU")
-    print(f"{lamports / 1_000_000_000:.4f} SOL")
-
-    for sig in helius.get_signatures_for_address(
-        "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", limit=5
-    ):
-        print(sig.slot, "ERR" if sig.err else "OK ", sig.signature)
-```
-
-`HELIUS_API_KEY` is read from the environment (or `.env`), the
-client is a context manager, and every return value is fully typed.
-
-## Why this over `solana-py` / `solders`?
-
-`solders` is for building and signing transactions. `solana-py` is a generic Solana RPC client. Use them for that.
-
-This library is for talking to **Helius** specifically — typed `pydantic` responses, snake_case, and (eventually) the Helius-only endpoints (DAS, Enhanced Transactions, Webhooks, priority fees) the others don't cover. Plays nicely alongside `solders`: sign with `solders`, read with `helius-python`.
-
-## Example: wallet tracker
-
-See [`examples/wallet_tracker.py`](examples/wallet_tracker.py) for a
-runnable script that takes a wallet address and prints:
-
-- SOL balance
-- All non-empty SPL token accounts (mint, balance, account)
-- The last N transactions (timestamp, slot, success/error, signature)
-
-```bash
-export HELIUS_API_KEY=your_helius_api_key
-python examples/wallet_tracker.py 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU --limit 20
-```
-
-It uses `get_balance`, `get_token_accounts_by_owner` (with
-`encoding="jsonParsed"`), and `get_signatures_for_address` — pure
-stdlib plus this library, no `solana-py` or `solders` needed.
 
 ## Coverage
 
@@ -206,9 +157,9 @@ wraps it.
 Pass your Helius API key explicitly:
 
 ```python
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
-client = HeliusClient(api_key="YOUR_HELIUS_API_KEY")
+client = SolanaRpcClient(api_key="YOUR_HELIUS_API_KEY")
 ```
 
 or set `HELIUS_API_KEY` as an environment variable:
@@ -225,9 +176,9 @@ HELIUS_API_KEY=your_helius_api_key
 ```
 
 ```python
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
-client = HeliusClient()  # reads HELIUS_API_KEY from the environment or .env
+client = SolanaRpcClient()  # reads HELIUS_API_KEY from the environment or .env
 ```
 
 ## Usage
@@ -235,9 +186,9 @@ client = HeliusClient()  # reads HELIUS_API_KEY from the environment or .env
 ### As a context manager (recommended)
 
 ```python
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
-with HeliusClient(api_key="YOUR_HELIUS_API_KEY") as client:
+with SolanaRpcClient(api_key="YOUR_HELIUS_API_KEY") as client:
     _ctx, balance = client.get_balance("So11111111111111111111111111111111111111112")
     _ctx, supply  = client.get_supply()
     nodes         = client.get_cluster_nodes()
@@ -245,7 +196,7 @@ with HeliusClient(api_key="YOUR_HELIUS_API_KEY") as client:
     tx            = client.get_transaction("5j7s...signature...")
 ```
 
-`HeliusClient` implements the context-manager protocol via `__enter__` /
+`SolanaRpcClient` implements the context-manager protocol via `__enter__` /
 `__exit__`, so the underlying `httpx.Client` is closed cleanly when the
 `with` block exits.
 
@@ -255,9 +206,9 @@ If a `with` block doesn't fit your code structure (e.g. the client lives
 on a long-lived object), call `close()` yourself when you're done:
 
 ```python
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
-client = HeliusClient(api_key="YOUR_HELIUS_API_KEY")
+client = SolanaRpcClient(api_key="YOUR_HELIUS_API_KEY")
 try:
     _ctx, balance = client.get_balance("So11111111111111111111111111111111111111112")
     _ctx, supply  = client.get_supply()
@@ -303,7 +254,7 @@ The method names map 1:1 to the Solana JSON-RPC spec, just converted to
 ## Status
 
 Actively expanding toward full coverage of the Helius API. See
-[`src/helius/client.py`](src/helius/client.py) for the current list of
+[`src/helius/solana_rpc.py`](src/helius/solana_rpc.py) for the current list of
 implemented methods; missing endpoints are tracked as issues and added
 continuously.
 
@@ -359,6 +310,7 @@ continuously.
 | `isBlockhashValid`                  | `is_blockhash_valid(...)`                     | [guide](https://www.helius.dev/docs/rpc/guides/isblockhashvalid), [reference](https://www.helius.dev/docs/api-reference/rpc/http/isblockhashvalid)                                   |
 | `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)                                     |
 
 ## License
 

{helius_python-0.1.1 → helius_python-0.2.0}/README.md

@@ -98,55 +98,6 @@
   </p>
   
 **A complete, typed Python client for [Helius](https://helius.dev) — the Solana developer platform.**
-<br />
-
-## TL;DR
-
-```bash
-pip install helius-python
-```
-
-```python
-# export HELIUS_API_KEY=your_key   (or put it in .env)
-
-from helius.client import HeliusClient
-
-with HeliusClient() as helius:
-    _ctx, lamports = helius.get_balance("7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU")
-    print(f"{lamports / 1_000_000_000:.4f} SOL")
-
-    for sig in helius.get_signatures_for_address(
-        "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", limit=5
-    ):
-        print(sig.slot, "ERR" if sig.err else "OK ", sig.signature)
-```
-
-`HELIUS_API_KEY` is read from the environment (or `.env`), the
-client is a context manager, and every return value is fully typed.
-
-## Why this over `solana-py` / `solders`?
-
-`solders` is for building and signing transactions. `solana-py` is a generic Solana RPC client. Use them for that.
-
-This library is for talking to **Helius** specifically — typed `pydantic` responses, snake_case, and (eventually) the Helius-only endpoints (DAS, Enhanced Transactions, Webhooks, priority fees) the others don't cover. Plays nicely alongside `solders`: sign with `solders`, read with `helius-python`.
-
-## Example: wallet tracker
-
-See [`examples/wallet_tracker.py`](examples/wallet_tracker.py) for a
-runnable script that takes a wallet address and prints:
-
-- SOL balance
-- All non-empty SPL token accounts (mint, balance, account)
-- The last N transactions (timestamp, slot, success/error, signature)
-
-```bash
-export HELIUS_API_KEY=your_helius_api_key
-python examples/wallet_tracker.py 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU --limit 20
-```
-
-It uses `get_balance`, `get_token_accounts_by_owner` (with
-`encoding="jsonParsed"`), and `get_signatures_for_address` — pure
-stdlib plus this library, no `solana-py` or `solders` needed.
 
 ## Coverage
 
@@ -186,9 +137,9 @@ wraps it.
 Pass your Helius API key explicitly:
 
 ```python
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
-client = HeliusClient(api_key="YOUR_HELIUS_API_KEY")
+client = SolanaRpcClient(api_key="YOUR_HELIUS_API_KEY")
 ```
 
 or set `HELIUS_API_KEY` as an environment variable:
@@ -205,9 +156,9 @@ HELIUS_API_KEY=your_helius_api_key
 ```
 
 ```python
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
-client = HeliusClient()  # reads HELIUS_API_KEY from the environment or .env
+client = SolanaRpcClient()  # reads HELIUS_API_KEY from the environment or .env
 ```
 
 ## Usage
@@ -215,9 +166,9 @@ client = HeliusClient()  # reads HELIUS_API_KEY from the environment or .env
 ### As a context manager (recommended)
 
 ```python
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
-with HeliusClient(api_key="YOUR_HELIUS_API_KEY") as client:
+with SolanaRpcClient(api_key="YOUR_HELIUS_API_KEY") as client:
     _ctx, balance = client.get_balance("So11111111111111111111111111111111111111112")
     _ctx, supply  = client.get_supply()
     nodes         = client.get_cluster_nodes()
@@ -225,7 +176,7 @@ with HeliusClient(api_key="YOUR_HELIUS_API_KEY") as client:
     tx            = client.get_transaction("5j7s...signature...")
 ```
 
-`HeliusClient` implements the context-manager protocol via `__enter__` /
+`SolanaRpcClient` implements the context-manager protocol via `__enter__` /
 `__exit__`, so the underlying `httpx.Client` is closed cleanly when the
 `with` block exits.
 
@@ -235,9 +186,9 @@ If a `with` block doesn't fit your code structure (e.g. the client lives
 on a long-lived object), call `close()` yourself when you're done:
 
 ```python
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
-client = HeliusClient(api_key="YOUR_HELIUS_API_KEY")
+client = SolanaRpcClient(api_key="YOUR_HELIUS_API_KEY")
 try:
     _ctx, balance = client.get_balance("So11111111111111111111111111111111111111112")
     _ctx, supply  = client.get_supply()
@@ -283,7 +234,7 @@ The method names map 1:1 to the Solana JSON-RPC spec, just converted to
 ## Status
 
 Actively expanding toward full coverage of the Helius API. See
-[`src/helius/client.py`](src/helius/client.py) for the current list of
+[`src/helius/solana_rpc.py`](src/helius/solana_rpc.py) for the current list of
 implemented methods; missing endpoints are tracked as issues and added
 continuously.
 
@@ -339,6 +290,7 @@ continuously.
 | `isBlockhashValid`                  | `is_blockhash_valid(...)`                     | [guide](https://www.helius.dev/docs/rpc/guides/isblockhashvalid), [reference](https://www.helius.dev/docs/api-reference/rpc/http/isblockhashvalid)                                   |
 | `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)                                     |
 
 ## License
 

{helius_python-0.1.1 → helius_python-0.2.0}/examples/block_explorer.py

@@ -21,7 +21,7 @@ import argparse
 import datetime as dt
 import sys
 
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
 LAMPORTS_PER_SOL = 1_000_000_000
 
@@ -36,9 +36,11 @@ def main() -> int:
     )
     args = parser.parse_args()
 
-    with HeliusClient() as helius:
-        slot = args.slot if args.slot is not None else helius.get_slot(
-            commitment="finalized"
+    with SolanaRpcClient() as helius:
+        slot = (
+            args.slot
+            if args.slot is not None
+            else helius.get_slot(commitment="finalized")
         )
         block = helius.get_block(
             slot,
@@ -70,8 +72,9 @@ def main() -> int:
     print(f"\nTransactions     : {total:,} total")
     print(f"  succeeded      : {succeeded:,}")
     print(f"  failed         : {failed:,}")
-    print(f"Total fees       : {fees / LAMPORTS_PER_SOL:.9f} SOL "
-          f"({fees:,} lamports)")
+    print(
+        f"Total fees       : {fees / LAMPORTS_PER_SOL:.9f} SOL " f"({fees:,} lamports)"
+    )
 
     if block.rewards:
         print(f"\nRewards ({len(block.rewards)}):")

{helius_python-0.1.1 → helius_python-0.2.0}/examples/devnet_airdrop.py

@@ -24,7 +24,7 @@ import argparse
 import sys
 import time
 
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
 LAMPORTS_PER_SOL = 1_000_000_000
 DEVNET_URL = "https://devnet.helius-rpc.com"
@@ -48,7 +48,7 @@ def main() -> int:
     args = parser.parse_args()
     lamports = int(args.sol * LAMPORTS_PER_SOL)
 
-    client = HeliusClient(base_url=DEVNET_URL)
+    client = SolanaRpcClient(base_url=DEVNET_URL)
     try:
         print(f"Requesting {args.sol} SOL airdrop to {args.address} on devnet...")
         signature = client.request_airdrop(args.address, lamports)

{helius_python-0.1.1 → helius_python-0.2.0}/examples/network_status.py

@@ -18,11 +18,11 @@ from __future__ import annotations
 
 import sys
 
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
 
 def main() -> int:
-    with HeliusClient() as helius:
+    with SolanaRpcClient() as helius:
         healthy = helius.get_health()
         solana_core, feature_set = helius.get_version()
         identity = helius.get_identity()

{helius_python-0.1.1 → helius_python-0.2.0}/examples/priority_fees.py

@@ -25,7 +25,7 @@ import argparse
 import statistics
 import sys
 
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
 
 def percentile(sorted_values: list[int], pct: float) -> int:
@@ -46,7 +46,7 @@ def main() -> int:
     args = parser.parse_args()
     accounts = args.account or None
 
-    with HeliusClient() as helius:
+    with SolanaRpcClient() as helius:
         samples = helius.get_recent_prioritization_fees(
             locked_writable_accounts=accounts
         )

{helius_python-0.1.1 → helius_python-0.2.0}/examples/stake_overview.py

@@ -18,13 +18,13 @@ from __future__ import annotations
 
 import sys
 
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
 LAMPORTS_PER_SOL = 1_000_000_000
 
 
 def main() -> int:
-    client = HeliusClient()
+    client = SolanaRpcClient()
     try:
         rate = client.get_inflation_rate()
         gov = client.get_inflation_governor()
@@ -44,35 +44,43 @@ def main() -> int:
     print(f"  initial          : {gov.initial * 100:.2f}%")
     print(f"  terminal         : {gov.terminal * 100:.2f}%")
     print(f"  taper            : {gov.taper * 100:.2f}% per year")
-    print(f"  foundation       : {gov.foundation * 100:.2f}% for "
-          f"{gov.foundation_term:.1f} years")
+    print(
+        f"  foundation       : {gov.foundation * 100:.2f}% for "
+        f"{gov.foundation_term:.1f} years"
+    )
 
     print("\n=== Supply ===\n")
     print(f"Total              : {supply.total / LAMPORTS_PER_SOL:>16,.4f} SOL")
     print(f"Circulating        : {supply.circulating / LAMPORTS_PER_SOL:>16,.4f} SOL")
-    print(f"Non-circulating    : "
-          f"{supply.non_circulating / LAMPORTS_PER_SOL:>16,.4f} SOL")
+    print(
+        f"Non-circulating    : {supply.non_circulating / LAMPORTS_PER_SOL:>16,.4f} SOL"
+    )
 
     print("\n=== Stake ===\n")
     print(f"Minimum delegation : {min_stake / LAMPORTS_PER_SOL:.9f} SOL")
     active_stake = sum(v.activated_stake for v in current)
     delinquent_stake = sum(v.activated_stake for v in delinquent)
     total_stake = active_stake + delinquent_stake
-    print(f"Active validators  : {len(current):>5}  "
-          f"{active_stake / LAMPORTS_PER_SOL:>16,.0f} SOL")
-    print(f"Delinquent         : {len(delinquent):>5}  "
-          f"{delinquent_stake / LAMPORTS_PER_SOL:>16,.0f} SOL")
+    print(
+        f"Active validators  : {len(current):>5}  "
+        f"{active_stake / LAMPORTS_PER_SOL:>16,.0f} SOL"
+    )
+    print(
+        f"Delinquent         : {len(delinquent):>5}  "
+        f"{delinquent_stake / LAMPORTS_PER_SOL:>16,.0f} SOL"
+    )
     if total_stake:
-        print(f"Delinquent share   : "
-              f"{100 * delinquent_stake / total_stake:.3f}%")
+        print(f"Delinquent share   : {100 * delinquent_stake / total_stake:.3f}%")
 
     top = sorted(current, key=lambda v: v.activated_stake, reverse=True)[:10]
     print(f"\nTop {len(top)} validators by active stake:")
     for rank, v in enumerate(top, start=1):
         sol = v.activated_stake / LAMPORTS_PER_SOL
         share = 100 * v.activated_stake / active_stake if active_stake else 0.0
-        print(f"  {rank:>2}. {v.vote_pubkey}  "
-              f"{sol:>14,.0f} SOL  ({share:5.2f}%)  comm={v.commission}%")
+        print(
+            f"  {rank:>2}. {v.vote_pubkey}  "
+            f"{sol:>14,.0f} SOL  ({share:5.2f}%)  comm={v.commission}%"
+        )
 
     return 0
 

{helius_python-0.1.1 → helius_python-0.2.0}/examples/token_inspector.py

@@ -22,7 +22,7 @@ from __future__ import annotations
 import argparse
 import sys
 
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
 
 def main() -> int:
@@ -30,7 +30,7 @@ def main() -> int:
     parser.add_argument("mint", help="SPL token mint address (base58)")
     args = parser.parse_args()
 
-    client = HeliusClient()
+    client = SolanaRpcClient()
     try:
         _ctx, supply = client.get_token_supply(args.mint)
         _ctx, holders = client.get_token_largest_accounts(args.mint)

{helius_python-0.1.1 → helius_python-0.2.0}/examples/transaction_inspector.py

@@ -19,7 +19,7 @@ import argparse
 import datetime as dt
 import sys
 
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
 LAMPORTS_PER_SOL = 1_000_000_000
 
@@ -29,7 +29,7 @@ def main() -> int:
     parser.add_argument("signature", help="Transaction signature (base58)")
     args = parser.parse_args()
 
-    with HeliusClient() as helius:
+    with SolanaRpcClient() as helius:
         tx = helius.get_transaction(
             args.signature,
             encoding="jsonParsed",
@@ -49,8 +49,9 @@ def main() -> int:
         print("\n(no metadata returned)")
         return 0
 
-    print(f"Fee           : {meta.fee} lamports "
-          f"({meta.fee / LAMPORTS_PER_SOL:.9f} SOL)")
+    print(
+        f"Fee           : {meta.fee} lamports ({meta.fee / LAMPORTS_PER_SOL:.9f} SOL)"
+    )
     print(f"Result        : {'ERROR ' + str(meta.err) if meta.err else 'success'}")
 
     # Account balance changes ------------------------------------------------

{helius_python-0.1.1 → helius_python-0.2.0}/examples/wallet_tracker.py

@@ -23,7 +23,7 @@ import argparse
 import datetime as dt
 import sys
 
-from helius.client import HeliusClient
+from helius.solana_rpc import SolanaRpcClient
 
 # SPL Token program ID — used to list every token account owned by a wallet.
 TOKEN_PROGRAM_ID = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
@@ -41,12 +41,14 @@ def main() -> int:
     )
     args = parser.parse_args()
 
-    with HeliusClient() as client:  # reads HELIUS_API_KEY from env / .env
+    with SolanaRpcClient() as client:  # reads HELIUS_API_KEY from env / .env
         # --- SOL balance ---------------------------------------------------
         _ctx, lamports = client.get_balance(args.address)
         print(f"\n=== {args.address} ===\n")
-        print(f"SOL balance: {lamports / LAMPORTS_PER_SOL:.9f} SOL "
-              f"({lamports} lamports)\n")
+        print(
+            f"SOL balance: {lamports / LAMPORTS_PER_SOL:.9f} SOL "
+            f"({lamports} lamports)\n"
+        )
 
         # --- SPL token holdings -------------------------------------------
         _ctx, token_accounts = client.get_token_accounts_by_owner(
@@ -77,8 +79,9 @@ def main() -> int:
         print(f"Last {len(sigs)} signatures:")
         for sig in sigs:
             ts = (
-                dt.datetime.fromtimestamp(sig.block_time, tz=dt.timezone.utc)
-                .strftime("%Y-%m-%d %H:%M:%SZ")
+                dt.datetime.fromtimestamp(sig.block_time, tz=dt.timezone.utc).strftime(
+                    "%Y-%m-%d %H:%M:%SZ"
+                )
                 if sig.block_time is not None
                 else "         (no time)         "
             )

{helius_python-0.1.1 → helius_python-0.2.0}/pyproject.toml

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

helius_python-0.1.1/src/helius/client.py → helius_python-0.2.0/src/helius/solana_rpc.py

@@ -28,7 +28,7 @@ from helius.models import (
 )
 
 
-class HeliusClient:
+class SolanaRpcClient:
     def __init__(
         self,
         *,
@@ -924,6 +924,11 @@ class HeliusClient:
         value = response["result"]["value"]
         return context, value
 
+    def minimum_ledger_slot(self) -> int:
+        request = RpcRequest(method="minimumLedgerSlot").build()
+        response = self._send(request)
+        return response["result"]
+
     def request_airdrop(
         self,
         *,
@@ -944,8 +949,28 @@ class HeliusClient:
         response = self._send(request)
         return response["result"]
 
-    def minimum_ledger_slot(self) -> int:
-        request = RpcRequest(method="minimumLedgerSlot").build()
+    def send_transaction(
+        self,
+        *,
+        transaction: str,
+        encoding: Literal["base58", "base64"] | None = None,
+        skip_preflight: bool | None = None,
+        preflight_commitment: (
+            Literal["finalized", "confirmed", "processed"] | None
+        ) = None,
+        max_retries: int | None = None,
+        min_context_slot: int | None = None,
+    ) -> str:
+        request = (
+            RpcRequest(method="sendTransaction")
+            .add(transaction)
+            .set("encoding", encoding)
+            .set("skipPreflight", skip_preflight)
+            .set("preflightCommitment", preflight_commitment)
+            .set("maxRetries", max_retries)
+            .set("minContextSlot", min_context_slot)
+            .build()
+        )
         response = self._send(request)
         return response["result"]