helius-python 0.4.1__tar.gz → 0.5.0__tar.gz

{helius_python-0.4.1 → helius_python-0.5.0}/.github/ISSUE_TEMPLATE/bug_report.yml

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

{helius_python-0.4.1 → helius_python-0.5.0}/AGENTS.md

@@ -76,7 +76,7 @@ Skeleton:
 import json
 import httpx
 import respx
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 @respx.mock
 def test_get_balance():

{helius_python-0.4.1 → helius_python-0.5.0}/CONTRIBUTING.md

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

{helius_python-0.4.1 → helius_python-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: helius-python
-Version: 0.4.1
+Version: 0.5.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
@@ -123,7 +123,7 @@ Description-Content-Type: text/markdown
 
 ## Coverage
 
-The goal of this library is **support every function, method, endpoint,
+The goal of this library is to **support every function, method, endpoint,
 and feature that Helius exposes.** If Helius ships it, this client
 wraps it.
 
@@ -161,6 +161,7 @@ being worked on.
    documented Helius API.
 
 ## Installation via PyPI
+
 ```bash
 pip install helius-python
 ```
@@ -170,7 +171,7 @@ pip install helius-python
 Pass your Helius API key explicitly:
 
 ```python
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 client = SolanaRpcClient(api_key="YOUR_HELIUS_API_KEY")
 ```
@@ -189,7 +190,7 @@ HELIUS_API_KEY=your_helius_api_key
 ```
 
 ```python
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 client = SolanaRpcClient()  # reads HELIUS_API_KEY from the environment or .env
 ```
@@ -199,7 +200,7 @@ client = SolanaRpcClient()  # reads HELIUS_API_KEY from the environment or .env
 ### As a context manager (recommended)
 
 ```python
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 with SolanaRpcClient(api_key="YOUR_HELIUS_API_KEY") as client:
     _ctx, balance = client.get_balance("So11111111111111111111111111111111111111112")
@@ -219,7 +220,7 @@ 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.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 client = SolanaRpcClient(api_key="YOUR_HELIUS_API_KEY")
 try:
@@ -267,7 +268,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/solana_rpc/client.py`](src/helius/solana_rpc/client.py) for the
+[`src/helius/rpc/client.py`](src/helius/rpc/client.py) for the
 current Solana JSON-RPC implementation; supported surfaces are listed below,
 and missing endpoints are tracked as issues and added continuously.
 
@@ -360,18 +361,18 @@ Each `*_subscribe` call returns the integer subscription id. Use
 them; both yield a `(context, notification, subscription)` tuple where
 `notification` is the model below.
 
-| Subscribe method                | Unsubscribe method                | Notification model            | Helius docs                                                                                                                                       |
-| ------------------------------- | --------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `account_subscribe(...)`        | `account_unsubscribe(...)`        | `AccountNotification`         | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/accountsubscribe)                                                             |
-| `block_subscribe(...)`          | `block_unsubscribe(...)`          | `BlockNotification`           | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/blocksubscribe)                                                               |
-| `logs_subscribe(...)`           | `logs_unsubscribe(...)`           | `LogsNotification`            | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/logssubscribe)                                                                |
-| `program_subscribe(...)`        | `program_unsubscribe(...)`        | `ProgramNotification`         | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/programsubscribe)                                                             |
-| `root_subscribe()`              | `root_unsubscribe(...)`           | `RootNotification`            | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/rootsubscribe)                                                                |
-| `signature_subscribe(...)`      | `signature_unsubscribe(...)`      | `SignatureNotification`       | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/signaturesubscribe)                                                           |
-| `slot_subscribe()`              | `slot_unsubscribe(...)`           | `SlotNotification`            | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/slotsubscribe)                                                                |
-| `slots_updates_subscribe()`     | `slots_updates_unsubscribe(...)`  | `SlotsUpdatesNotification`    | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/slotsupdatessubscribe)                                                        |
-| `vote_subscribe()`              | `vote_unsubscribe(...)`           | `VoteNotification`            | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/votesubscribe)                                                                |
-| `transaction_subscribe(...)`    | `transaction_unsubscribe(...)`    | `TransactionNotification`     | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/slotunsubscribe)                                                                                       |
+| Subscribe method             | Unsubscribe method               | Notification model         | Helius docs                                                                                |
+| ---------------------------- | -------------------------------- | -------------------------- | ------------------------------------------------------------------------------------------ |
+| `account_subscribe(...)`     | `account_unsubscribe(...)`       | `AccountNotification`      | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/accountsubscribe)      |
+| `block_subscribe(...)`       | `block_unsubscribe(...)`         | `BlockNotification`        | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/blocksubscribe)        |
+| `logs_subscribe(...)`        | `logs_unsubscribe(...)`          | `LogsNotification`         | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/logssubscribe)         |
+| `program_subscribe(...)`     | `program_unsubscribe(...)`       | `ProgramNotification`      | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/programsubscribe)      |
+| `root_subscribe()`           | `root_unsubscribe(...)`          | `RootNotification`         | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/rootsubscribe)         |
+| `signature_subscribe(...)`   | `signature_unsubscribe(...)`     | `SignatureNotification`    | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/signaturesubscribe)    |
+| `slot_subscribe()`           | `slot_unsubscribe(...)`          | `SlotNotification`         | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/slotsubscribe)         |
+| `slots_updates_subscribe()`  | `slots_updates_unsubscribe(...)` | `SlotsUpdatesNotification` | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/slotsupdatessubscribe) |
+| `vote_subscribe()`           | `vote_unsubscribe(...)`          | `VoteNotification`         | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/votesubscribe)         |
+| `transaction_subscribe(...)` | `transaction_unsubscribe(...)`   | `TransactionNotification`  | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/transactionsubscribe)  |
 
 ## Webhooks API
 
@@ -402,14 +403,14 @@ manual `close()`. The constructor defaults to
 from the environment or `.env` when `api_key` is omitted; optional
 `headers` and `proxy` arguments are also accepted.
 
-| REST operation | Python method              | Helius docs                                                                                       |
-| -------------- | -------------------------- | ------------------------------------------------------------------------------------------------- |
-| Create webhook | `create_webhook(...)`      | [reference](https://www.helius.dev/docs/api-reference/webhooks/create-webhook)                    |
-| Get webhook    | `get_webhook(...)`         | [reference](https://www.helius.dev/docs/api-reference/webhooks/get-webhook)                       |
-| List webhooks  | `get_all_webhooks()`       | [reference](https://www.helius.dev/docs/api-reference/webhooks/get-all-webhooks)                  |
-| Update webhook | `update_webhook(...)`      | [reference](https://www.helius.dev/docs/api-reference/webhooks/update-webhook)                    |
-| Toggle webhook | `toggle_webhook(...)`      | [reference](https://www.helius.dev/docs/api-reference/webhooks/toggle-webhook)                    |
-| Delete webhook | `delete_webhook(...)`      | [reference](https://www.helius.dev/docs/api-reference/webhooks/delete-webhook)                    |
+| REST operation | Python method         | Helius docs                                                                      |
+| -------------- | --------------------- | -------------------------------------------------------------------------------- |
+| Create webhook | `create_webhook(...)` | [reference](https://www.helius.dev/docs/api-reference/webhooks/create-webhook)   |
+| Get webhook    | `get_webhook(...)`    | [reference](https://www.helius.dev/docs/api-reference/webhooks/get-webhook)      |
+| List webhooks  | `get_all_webhooks()`  | [reference](https://www.helius.dev/docs/api-reference/webhooks/get-all-webhooks) |
+| Update webhook | `update_webhook(...)` | [reference](https://www.helius.dev/docs/api-reference/webhooks/update-webhook)   |
+| Toggle webhook | `toggle_webhook(...)` | [reference](https://www.helius.dev/docs/api-reference/webhooks/toggle-webhook)   |
+| Delete webhook | `delete_webhook(...)` | [reference](https://www.helius.dev/docs/api-reference/webhooks/delete-webhook)   |
 
 ## Admin API
 
@@ -432,14 +433,16 @@ supports the context-manager protocol, a manual `close()`, and reads
 `HELIUS_API_KEY` from the environment or `.env`.
 
 ## AI
-AI was used to assist in the development of this project, which was started beacause I needed a Helius client written in Python myself for another project. It has eliminated the need to perform repetitive tasks, such as writing functions that are similar to those written by hand before them. It has also been useful in drafting and updating the documentation (exclusively README.md at the time of writing), writing tests and examples.
-That said, AI-generated code is reviewed in full, line-by-line by human(s) against the Helius API specifications.
+
+AI was used to assist in the development of this project, which was started because I needed a Helius client written in Python myself for another project. It has eliminated the need to perform repetitive tasks, such as writing functions that are similar to those written by hand before them. It has also been useful in drafting and updating the documentation (exclusively README.md at the time of writing), writing tests and examples.
+That said, AI-generated code is reviewed in full, line-by-line by me against the Helius API specifications.
 
 To roughly describe my approach to using AI in this project, I generally write the code by hand, which makes it easy to structure the code well and maintain an intuitive understanding of how the code works. Then, when I got to the part where I had to implement 100+ similar Python functions, I turned to AI to write the massive part of the codebase, while I reviewed the result at the same time.
 
 To sum up:
-- I generally structure** and write a good part of what I'm programming by hand, including boilerplate.
-- I find it best to prompt agents to implement very limited functionality within narrow scope, performing something closer to pair-programming.
+
+- I generally structure and write a good part of what I'm programming by hand, including boilerplate.
+- I find it best to prompt agents to implement very limited functionality within narrow a scope, performing something closer to pair-programming.
 - Even though at least half the LoC in this project are hand-typed, I find that AI is incredibly capable, can be enjoyable to use, but most importantly, using AI allows me to focus my time and energy on what matters.
 
 By the way, this README section is completely brain-made and hand-typed.

{helius_python-0.4.1 → helius_python-0.5.0}/README.md

@@ -101,7 +101,7 @@
 
 ## Coverage
 
-The goal of this library is **support every function, method, endpoint,
+The goal of this library is to **support every function, method, endpoint,
 and feature that Helius exposes.** If Helius ships it, this client
 wraps it.
 
@@ -139,6 +139,7 @@ being worked on.
    documented Helius API.
 
 ## Installation via PyPI
+
 ```bash
 pip install helius-python
 ```
@@ -148,7 +149,7 @@ pip install helius-python
 Pass your Helius API key explicitly:
 
 ```python
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 client = SolanaRpcClient(api_key="YOUR_HELIUS_API_KEY")
 ```
@@ -167,7 +168,7 @@ HELIUS_API_KEY=your_helius_api_key
 ```
 
 ```python
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 client = SolanaRpcClient()  # reads HELIUS_API_KEY from the environment or .env
 ```
@@ -177,7 +178,7 @@ client = SolanaRpcClient()  # reads HELIUS_API_KEY from the environment or .env
 ### As a context manager (recommended)
 
 ```python
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 with SolanaRpcClient(api_key="YOUR_HELIUS_API_KEY") as client:
     _ctx, balance = client.get_balance("So11111111111111111111111111111111111111112")
@@ -197,7 +198,7 @@ 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.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 client = SolanaRpcClient(api_key="YOUR_HELIUS_API_KEY")
 try:
@@ -245,7 +246,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/solana_rpc/client.py`](src/helius/solana_rpc/client.py) for the
+[`src/helius/rpc/client.py`](src/helius/rpc/client.py) for the
 current Solana JSON-RPC implementation; supported surfaces are listed below,
 and missing endpoints are tracked as issues and added continuously.
 
@@ -338,18 +339,18 @@ Each `*_subscribe` call returns the integer subscription id. Use
 them; both yield a `(context, notification, subscription)` tuple where
 `notification` is the model below.
 
-| Subscribe method                | Unsubscribe method                | Notification model            | Helius docs                                                                                                                                       |
-| ------------------------------- | --------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `account_subscribe(...)`        | `account_unsubscribe(...)`        | `AccountNotification`         | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/accountsubscribe)                                                             |
-| `block_subscribe(...)`          | `block_unsubscribe(...)`          | `BlockNotification`           | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/blocksubscribe)                                                               |
-| `logs_subscribe(...)`           | `logs_unsubscribe(...)`           | `LogsNotification`            | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/logssubscribe)                                                                |
-| `program_subscribe(...)`        | `program_unsubscribe(...)`        | `ProgramNotification`         | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/programsubscribe)                                                             |
-| `root_subscribe()`              | `root_unsubscribe(...)`           | `RootNotification`            | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/rootsubscribe)                                                                |
-| `signature_subscribe(...)`      | `signature_unsubscribe(...)`      | `SignatureNotification`       | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/signaturesubscribe)                                                           |
-| `slot_subscribe()`              | `slot_unsubscribe(...)`           | `SlotNotification`            | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/slotsubscribe)                                                                |
-| `slots_updates_subscribe()`     | `slots_updates_unsubscribe(...)`  | `SlotsUpdatesNotification`    | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/slotsupdatessubscribe)                                                        |
-| `vote_subscribe()`              | `vote_unsubscribe(...)`           | `VoteNotification`            | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/votesubscribe)                                                                |
-| `transaction_subscribe(...)`    | `transaction_unsubscribe(...)`    | `TransactionNotification`     | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/slotunsubscribe)                                                                                       |
+| Subscribe method             | Unsubscribe method               | Notification model         | Helius docs                                                                                |
+| ---------------------------- | -------------------------------- | -------------------------- | ------------------------------------------------------------------------------------------ |
+| `account_subscribe(...)`     | `account_unsubscribe(...)`       | `AccountNotification`      | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/accountsubscribe)      |
+| `block_subscribe(...)`       | `block_unsubscribe(...)`         | `BlockNotification`        | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/blocksubscribe)        |
+| `logs_subscribe(...)`        | `logs_unsubscribe(...)`          | `LogsNotification`         | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/logssubscribe)         |
+| `program_subscribe(...)`     | `program_unsubscribe(...)`       | `ProgramNotification`      | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/programsubscribe)      |
+| `root_subscribe()`           | `root_unsubscribe(...)`          | `RootNotification`         | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/rootsubscribe)         |
+| `signature_subscribe(...)`   | `signature_unsubscribe(...)`     | `SignatureNotification`    | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/signaturesubscribe)    |
+| `slot_subscribe()`           | `slot_unsubscribe(...)`          | `SlotNotification`         | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/slotsubscribe)         |
+| `slots_updates_subscribe()`  | `slots_updates_unsubscribe(...)` | `SlotsUpdatesNotification` | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/slotsupdatessubscribe) |
+| `vote_subscribe()`           | `vote_unsubscribe(...)`          | `VoteNotification`         | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/votesubscribe)         |
+| `transaction_subscribe(...)` | `transaction_unsubscribe(...)`   | `TransactionNotification`  | [reference](https://www.helius.dev/docs/api-reference/rpc/websocket/transactionsubscribe)  |
 
 ## Webhooks API
 
@@ -380,14 +381,14 @@ manual `close()`. The constructor defaults to
 from the environment or `.env` when `api_key` is omitted; optional
 `headers` and `proxy` arguments are also accepted.
 
-| REST operation | Python method              | Helius docs                                                                                       |
-| -------------- | -------------------------- | ------------------------------------------------------------------------------------------------- |
-| Create webhook | `create_webhook(...)`      | [reference](https://www.helius.dev/docs/api-reference/webhooks/create-webhook)                    |
-| Get webhook    | `get_webhook(...)`         | [reference](https://www.helius.dev/docs/api-reference/webhooks/get-webhook)                       |
-| List webhooks  | `get_all_webhooks()`       | [reference](https://www.helius.dev/docs/api-reference/webhooks/get-all-webhooks)                  |
-| Update webhook | `update_webhook(...)`      | [reference](https://www.helius.dev/docs/api-reference/webhooks/update-webhook)                    |
-| Toggle webhook | `toggle_webhook(...)`      | [reference](https://www.helius.dev/docs/api-reference/webhooks/toggle-webhook)                    |
-| Delete webhook | `delete_webhook(...)`      | [reference](https://www.helius.dev/docs/api-reference/webhooks/delete-webhook)                    |
+| REST operation | Python method         | Helius docs                                                                      |
+| -------------- | --------------------- | -------------------------------------------------------------------------------- |
+| Create webhook | `create_webhook(...)` | [reference](https://www.helius.dev/docs/api-reference/webhooks/create-webhook)   |
+| Get webhook    | `get_webhook(...)`    | [reference](https://www.helius.dev/docs/api-reference/webhooks/get-webhook)      |
+| List webhooks  | `get_all_webhooks()`  | [reference](https://www.helius.dev/docs/api-reference/webhooks/get-all-webhooks) |
+| Update webhook | `update_webhook(...)` | [reference](https://www.helius.dev/docs/api-reference/webhooks/update-webhook)   |
+| Toggle webhook | `toggle_webhook(...)` | [reference](https://www.helius.dev/docs/api-reference/webhooks/toggle-webhook)   |
+| Delete webhook | `delete_webhook(...)` | [reference](https://www.helius.dev/docs/api-reference/webhooks/delete-webhook)   |
 
 ## Admin API
 
@@ -410,14 +411,16 @@ supports the context-manager protocol, a manual `close()`, and reads
 `HELIUS_API_KEY` from the environment or `.env`.
 
 ## AI
-AI was used to assist in the development of this project, which was started beacause I needed a Helius client written in Python myself for another project. It has eliminated the need to perform repetitive tasks, such as writing functions that are similar to those written by hand before them. It has also been useful in drafting and updating the documentation (exclusively README.md at the time of writing), writing tests and examples.
-That said, AI-generated code is reviewed in full, line-by-line by human(s) against the Helius API specifications.
+
+AI was used to assist in the development of this project, which was started because I needed a Helius client written in Python myself for another project. It has eliminated the need to perform repetitive tasks, such as writing functions that are similar to those written by hand before them. It has also been useful in drafting and updating the documentation (exclusively README.md at the time of writing), writing tests and examples.
+That said, AI-generated code is reviewed in full, line-by-line by me against the Helius API specifications.
 
 To roughly describe my approach to using AI in this project, I generally write the code by hand, which makes it easy to structure the code well and maintain an intuitive understanding of how the code works. Then, when I got to the part where I had to implement 100+ similar Python functions, I turned to AI to write the massive part of the codebase, while I reviewed the result at the same time.
 
 To sum up:
-- I generally structure** and write a good part of what I'm programming by hand, including boilerplate.
-- I find it best to prompt agents to implement very limited functionality within narrow scope, performing something closer to pair-programming.
+
+- I generally structure and write a good part of what I'm programming by hand, including boilerplate.
+- I find it best to prompt agents to implement very limited functionality within narrow a scope, performing something closer to pair-programming.
 - Even though at least half the LoC in this project are hand-typed, I find that AI is incredibly capable, can be enjoyable to use, but most importantly, using AI allows me to focus my time and energy on what matters.
 
 By the way, this README section is completely brain-made and hand-typed.

{helius_python-0.4.1 → helius_python-0.5.0}/examples/solana_rpc/address_transactions.py

@@ -6,8 +6,8 @@ either compact signature rows or full transaction payloads with pagination.
 Usage:
 
     export HELIUS_API_KEY=your_helius_api_key
-    python examples/solana_rpc/address_transactions.py <ADDRESS> [--limit 10]
-    python examples/solana_rpc/address_transactions.py <ADDRESS> --full --limit 5
+    python examples/rpc/address_transactions.py <ADDRESS> [--limit 10]
+    python examples/rpc/address_transactions.py <ADDRESS> --full --limit 5
 
 Docs:
     https://www.helius.dev/docs/getting-data/get-transactions-for-address
@@ -25,7 +25,7 @@ import sys
 
 import httpx
 
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 
 def format_time(block_time: int | None) -> str:

{helius_python-0.4.1 → helius_python-0.5.0}/examples/solana_rpc/address_transfers.py

@@ -6,8 +6,8 @@ Uses Helius's `getTransfersByAddress` RPC method exposed by this client as
 Usage:
 
     export HELIUS_API_KEY=your_helius_api_key
-    python examples/solana_rpc/address_transfers.py <ADDRESS> [--limit 20]
-    python examples/solana_rpc/address_transfers.py <ADDRESS> --direction in --mint <MINT>
+    python examples/rpc/address_transfers.py <ADDRESS> [--limit 20]
+    python examples/rpc/address_transfers.py <ADDRESS> --direction in --mint <MINT>
 
 Docs:
     https://www.helius.dev/docs/getting-data/get-transfers-by-address
@@ -25,7 +25,7 @@ import sys
 
 import httpx
 
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 
 def format_time(block_time: int) -> str:

{helius_python-0.4.1 → helius_python-0.5.0}/examples/solana_rpc/block_explorer.py

@@ -8,8 +8,8 @@ breakdown of successful vs. failed transactions plus total fees paid.
 Usage:
 
     export HELIUS_API_KEY=your_helius_api_key
-    python examples/solana_rpc/block_explorer.py
-    python examples/solana_rpc/block_explorer.py --slot 250000000
+    python examples/rpc/block_explorer.py
+    python examples/rpc/block_explorer.py --slot 250000000
 
 Uses (with `with`):
     get_slot, get_block.
@@ -21,7 +21,7 @@ import argparse
 import datetime as dt
 import sys
 
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 LAMPORTS_PER_SOL = 1_000_000_000
 
@@ -73,9 +73,7 @@ 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 ({fees:,} lamports)")
 
     if block.rewards:
         print(f"\nRewards ({len(block.rewards)}):")

{helius_python-0.4.1 → helius_python-0.5.0}/examples/solana_rpc/devnet_airdrop.py

@@ -7,7 +7,7 @@ polls `getSignatureStatuses` until the airdrop transaction reaches a
 Usage:
 
     export HELIUS_API_KEY=your_helius_api_key
-    python examples/solana_rpc/devnet_airdrop.py <WALLET_ADDRESS> [--sol 1.0]
+    python examples/rpc/devnet_airdrop.py <WALLET_ADDRESS> [--sol 1.0]
 
 Note:
     `requestAirdrop` is only available on Devnet and Testnet — never on
@@ -26,7 +26,7 @@ import time
 
 import httpx
 
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 LAMPORTS_PER_SOL = 1_000_000_000
 DEVNET_URL = "https://devnet.helius-rpc.com"
@@ -67,7 +67,9 @@ def main() -> int:
     try:
         print(f"Requesting {args.sol} SOL airdrop to {args.address} on devnet...")
         try:
-            signature = client.request_airdrop(public_key=args.address, lamports=lamports)
+            signature = client.request_airdrop(
+                public_key=args.address, lamports=lamports
+            )
         except httpx.HTTPStatusError as exc:
             print(
                 f"HTTP {exc.response.status_code}: devnet airdrop request was rejected.",

{helius_python-0.4.1 → helius_python-0.5.0}/examples/solana_rpc/network_status.py

@@ -7,7 +7,7 @@ recent-performance summary (avg TPS over the last samples).
 Usage:
 
     export HELIUS_API_KEY=your_helius_api_key
-    python examples/solana_rpc/network_status.py
+    python examples/rpc/network_status.py
 
 Uses (with `with`):
     get_health, get_version, get_slot, get_block_height, get_epoch_info,
@@ -18,7 +18,7 @@ from __future__ import annotations
 
 import sys
 
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 
 def main() -> int:

{helius_python-0.4.1 → helius_python-0.5.0}/examples/solana_rpc/priority_fees.py

@@ -12,8 +12,8 @@ sample only counts transactions that locked those accounts as writable
 Usage:
 
     export HELIUS_API_KEY=your_helius_api_key
-    python examples/solana_rpc/priority_fees.py
-    python examples/solana_rpc/priority_fees.py --account <PUBKEY> --account <PUBKEY>
+    python examples/rpc/priority_fees.py
+    python examples/rpc/priority_fees.py --account <PUBKEY> --account <PUBKEY>
 
 Uses (with `with`):
     get_recent_prioritization_fees.
@@ -25,7 +25,7 @@ import argparse
 import statistics
 import sys
 
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 
 def percentile(sorted_values: list[int], pct: float) -> int:

{helius_python-0.4.1 → helius_python-0.5.0}/examples/solana_rpc/stake_overview.py

@@ -7,7 +7,7 @@ validator set (top 10 by stake).
 Usage:
 
     export HELIUS_API_KEY=your_helius_api_key
-    python examples/solana_rpc/stake_overview.py
+    python examples/rpc/stake_overview.py
 
 Uses (with `try/finally`):
     get_inflation_rate, get_inflation_governor, get_supply,
@@ -20,7 +20,7 @@ import sys
 
 import httpx
 
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 LAMPORTS_PER_SOL = 1_000_000_000
 

{helius_python-0.4.1 → helius_python-0.5.0}/examples/solana_rpc/token_inspector.py

@@ -7,11 +7,11 @@ Given a mint address, prints:
 Usage:
 
     export HELIUS_API_KEY=your_helius_api_key
-    python examples/solana_rpc/token_inspector.py <MINT_ADDRESS>
+    python examples/rpc/token_inspector.py <MINT_ADDRESS>
 
 Example with a small-holder-count mint:
 
-    python examples/solana_rpc/token_inspector.py J5iyNuTa6zqqA62Xe4h1VBvcBW5CTSNNva3QPh8DU5RV
+    python examples/rpc/token_inspector.py J5iyNuTa6zqqA62Xe4h1VBvcBW5CTSNNva3QPh8DU5RV
 
 Note:
     Very large mints may be rejected by `getTokenLargestAccounts` if the
@@ -28,7 +28,7 @@ import sys
 
 import httpx
 
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 
 def main() -> int:

{helius_python-0.4.1 → helius_python-0.5.0}/examples/solana_rpc/transaction_inspector.py

@@ -7,7 +7,7 @@ involved, and any log messages emitted by the on-chain programs.
 Usage:
 
     export HELIUS_API_KEY=your_helius_api_key
-    python examples/solana_rpc/transaction_inspector.py <SIGNATURE>
+    python examples/rpc/transaction_inspector.py <SIGNATURE>
 
 Uses (with `with`):
     get_transaction.
@@ -19,7 +19,7 @@ import argparse
 import datetime as dt
 import sys
 
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 LAMPORTS_PER_SOL = 1_000_000_000
 

{helius_python-0.4.1 → helius_python-0.5.0}/examples/solana_rpc/wallet_tracker.py

@@ -3,11 +3,11 @@
 Usage:
 
     export HELIUS_API_KEY=your_helius_api_key
-    python examples/solana_rpc/wallet_tracker.py <WALLET_ADDRESS> [--limit 20]
+    python examples/rpc/wallet_tracker.py <WALLET_ADDRESS> [--limit 20]
 
 Example (Helius's own treasury-ish address, replace with any):
 
-    python examples/solana_rpc/wallet_tracker.py 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
+    python examples/rpc/wallet_tracker.py 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
 
 It prints:
     - SOL balance (in SOL, not lamports)
@@ -23,7 +23,7 @@ import argparse
 import datetime as dt
 import sys
 
-from helius.solana_rpc import SolanaRpcClient
+from helius.rpc import SolanaRpcClient
 
 # SPL Token program ID — used to list every token account owned by a wallet.
 TOKEN_PROGRAM_ID = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"

{helius_python-0.4.1 → helius_python-0.5.0}/pyproject.toml

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

{helius_python-0.4.1/src/helius/solana_rpc → helius_python-0.5.0/src/helius/rpc}/__init__.py

@@ -1,5 +1,5 @@
-from helius.solana_rpc.client import SolanaRpcClient
-from helius.solana_rpc.models import (
+from helius.rpc.client import SolanaRpcClient
+from helius.rpc.models import (
     Account,
     Block,
     BlockCommitment,

{helius_python-0.4.1/src/helius/solana_rpc → helius_python-0.5.0/src/helius/rpc}/client.py

@@ -5,7 +5,7 @@ import httpx
 from dotenv import dotenv_values
 from pydantic import Field, TypeAdapter, validate_call
 
-from helius.solana_rpc.models import (
+from helius.rpc.models import (
     Account,
     Block,
     BlockCommitment,

{helius_python-0.4.1 → helius_python-0.5.0}/test_examples.py

@@ -22,7 +22,6 @@ import sys
 from dataclasses import dataclass, field
 from pathlib import Path
 
-
 ROOT = Path(__file__).resolve().parent
 PYTHONPATH = str(ROOT / "src")
 USE_COLOR = "NO_COLOR" not in os.environ
@@ -35,9 +34,7 @@ RESET = "\033[0m"
 
 SYSTEM_PROGRAM = "11111111111111111111111111111111"
 SMALL_MINT = "J5iyNuTa6zqqA62Xe4h1VBvcBW5CTSNNva3QPh8DU5RV"
-KNOWN_SIGNATURE = (
-    "eqRntqi1tjXv1zEGBM5btQGWoxWc73XXGDJXjxLE65Atj6T6qzNnJf5LyTbUoGXHS9TzeAnQniAre48SjcJft9f"
-)
+KNOWN_SIGNATURE = "eqRntqi1tjXv1zEGBM5btQGWoxWc73XXGDJXjxLE65Atj6T6qzNnJf5LyTbUoGXHS9TzeAnQniAre48SjcJft9f"
 DEVNET_ADDRESS = "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
 
 
@@ -51,9 +48,9 @@ class ExampleTest:
 
 TESTS = [
     ExampleTest(
-        name="solana_rpc/address_transactions",
+        name="rpc/address_transactions",
         args=[
-            "examples/solana_rpc/address_transactions.py",
+            "examples/rpc/address_transactions.py",
             SYSTEM_PROGRAM,
             "--limit",
             "1",
@@ -61,9 +58,9 @@ TESTS = [
         ],
     ),
     ExampleTest(
-        name="solana_rpc/address_transfers",
+        name="rpc/address_transfers",
         args=[
-            "examples/solana_rpc/address_transfers.py",
+            "examples/rpc/address_transfers.py",
             SYSTEM_PROGRAM,
             "--limit",
             "1",
@@ -71,14 +68,14 @@ TESTS = [
         ],
     ),
     ExampleTest(
-        name="solana_rpc/block_explorer",
-        args=["examples/solana_rpc/block_explorer.py", "--slot", "423563000"],
+        name="rpc/block_explorer",
+        args=["examples/rpc/block_explorer.py", "--slot", "423563000"],
         timeout=90,
     ),
     ExampleTest(
-        name="solana_rpc/devnet_airdrop",
+        name="rpc/devnet_airdrop",
         args=[
-            "examples/solana_rpc/devnet_airdrop.py",
+            "examples/rpc/devnet_airdrop.py",
             DEVNET_ADDRESS,
             "--sol",
             "0.000000001",
@@ -88,38 +85,42 @@ TESTS = [
         ],
     ),
     ExampleTest(
-        name="solana_rpc/network_status",
-        args=["examples/solana_rpc/network_status.py"],
+        name="rpc/network_status",
+        args=["examples/rpc/network_status.py"],
     ),
     ExampleTest(
-        name="solana_rpc/priority_fees",
-        args=["examples/solana_rpc/priority_fees.py"],
+        name="rpc/priority_fees",
+        args=["examples/rpc/priority_fees.py"],
     ),
     ExampleTest(
-        name="solana_rpc/stake_overview",
-        args=["examples/solana_rpc/stake_overview.py"],
+        name="rpc/stake_overview",
+        args=["examples/rpc/stake_overview.py"],
         timeout=120,
     ),
     ExampleTest(
-        name="solana_rpc/token_inspector",
-        args=["examples/solana_rpc/token_inspector.py", SMALL_MINT],
+        name="rpc/token_inspector",
+        args=["examples/rpc/token_inspector.py", SMALL_MINT],
         timeout=90,
     ),
     ExampleTest(
-        name="solana_rpc/transaction_inspector",
-        args=["examples/solana_rpc/transaction_inspector.py", KNOWN_SIGNATURE],
+        name="rpc/transaction_inspector",
+        args=["examples/rpc/transaction_inspector.py", KNOWN_SIGNATURE],
         timeout=90,
     ),
     ExampleTest(
-        name="solana_rpc/wallet_tracker",
-        args=["examples/solana_rpc/wallet_tracker.py", SYSTEM_PROGRAM, "--limit", "1"],
+        name="rpc/wallet_tracker",
+        args=["examples/rpc/wallet_tracker.py", SYSTEM_PROGRAM, "--limit", "1"],
         timeout=120,
     ),
     ExampleTest(
         name="laserstream/websocket_logs",
         args=["examples/laserstream/websocket_logs.py", "--count", "1"],
         timeout=45,
-        external_failure_markers=("TimeoutError: timed out", "403 Forbidden", "HTTP 403"),
+        external_failure_markers=(
+            "TimeoutError: timed out",
+            "403 Forbidden",
+            "HTTP 403",
+        ),
     ),
     ExampleTest(
         name="webhooks/webhook_crud",

{helius_python-0.4.1 → helius_python-0.5.0}/tests/unit/solana_rpc/test_client.py

@@ -4,8 +4,8 @@ import httpx
 import pytest
 import respx
 
-from helius.solana_rpc import SolanaRpcClient
-from helius.solana_rpc.models import Account
+from helius.rpc import SolanaRpcClient
+from helius.rpc.models import Account
 
 ACCOUNT_VALUE = {
     "lamports": 5_000_000_000,
@@ -797,7 +797,7 @@ def test_get_minimum_balance_for_rent_exemption():
 @respx.mock
 def test_get_multiple_accounts():
     # Asserts correct upstream API shape {"dataSlice": {...}}.
-    # Will FAIL until solana_rpc.py:449-450 is fixed to send dataSlice as a nested object.
+    # Will FAIL until rpc.py:449-450 is fixed to send dataSlice as a nested object.
     route = mock_rpc({"context": {"slot": 341197247}, "value": [ACCOUNT_VALUE]})
     with SolanaRpcClient(api_key="test") as client:
         context, accounts = client.get_multiple_accounts(

{helius_python-0.4.1 → helius_python-0.5.0}/tests/unit/solana_rpc/test_models.py

@@ -1,4 +1,4 @@
-from helius.solana_rpc.models import (
+from helius.rpc.models import (
     Account,
     Block,
     BlockCommitment,