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

{helius_python-0.4.1 → helius_python-0.5.1}/.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.1}/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.1}/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.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: helius-python
-Version: 0.4.1
+Version: 0.5.1
 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.1}/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/examples/solana_rpc → helius_python-0.5.1/examples/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/examples/solana_rpc → helius_python-0.5.1/examples/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/examples/solana_rpc → helius_python-0.5.1/examples/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/examples/solana_rpc → helius_python-0.5.1/examples/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/examples/solana_rpc → helius_python-0.5.1/examples/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/examples/solana_rpc → helius_python-0.5.1/examples/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/examples/solana_rpc → helius_python-0.5.1/examples/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/examples/solana_rpc → helius_python-0.5.1/examples/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/examples/solana_rpc → helius_python-0.5.1/examples/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/examples/solana_rpc → helius_python-0.5.1/examples/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.1}/pyproject.toml

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

{helius_python-0.4.1/src/helius/solana_rpc → helius_python-0.5.1/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.1/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.1}/test_examples.py

@@ -9,37 +9,47 @@ Usage:
     .venv/bin/python test_examples.py
 
 The runner expects `HELIUS_API_KEY` to be available in the environment or in
-`.env`, matching the examples themselves. Some Helius endpoints are plan-gated
-or network-gated; those failures are reported as "external" instead of as
-example runtime bugs.
+`.env`, matching the examples themselves. Missing/unauthorized API key failures
+are reported as "auth" instead of as example runtime bugs. Some Helius endpoints
+are plan-gated or network-gated; other failures in that class are reported as
+"external".
 """
 
 from __future__ import annotations
 
+import argparse
 import os
 import subprocess
 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
 
 GREEN = "\033[32m"
 YELLOW = "\033[33m"
+ORANGE = "\033[38;5;208m"
 RED = "\033[31m"
 BOLD = "\033[1m"
 RESET = "\033[0m"
 
 SYSTEM_PROGRAM = "11111111111111111111111111111111"
 SMALL_MINT = "J5iyNuTa6zqqA62Xe4h1VBvcBW5CTSNNva3QPh8DU5RV"
-KNOWN_SIGNATURE = (
-    "eqRntqi1tjXv1zEGBM5btQGWoxWc73XXGDJXjxLE65Atj6T6qzNnJf5LyTbUoGXHS9TzeAnQniAre48SjcJft9f"
-)
+KNOWN_SIGNATURE = "eqRntqi1tjXv1zEGBM5btQGWoxWc73XXGDJXjxLE65Atj6T6qzNnJf5LyTbUoGXHS9TzeAnQniAre48SjcJft9f"
 DEVNET_ADDRESS = "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
 
+AUTH_FAILURE_MARKERS = (
+    "No API key provided.",
+    "HTTP 401",
+    "401 Unauthorized",
+    "HTTP 403",
+    "403 Forbidden",
+    "Unauthorized",
+    "Forbidden",
+)
+
 
 @dataclass(frozen=True)
 class ExampleTest:
@@ -51,9 +61,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 +71,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 +81,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 +98,40 @@ 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",
+        ),
     ),
     ExampleTest(
         name="webhooks/webhook_crud",
@@ -140,6 +152,41 @@ def color(text: str, ansi_color: str) -> str:
     return f"{ansi_color}{text}{RESET}"
 
 
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument(
+        "-v",
+        action="count",
+        default=0,
+        dest="verbose_count",
+        help="increase verbosity; use -v for level 1 or -vv for level 2",
+    )
+    parser.add_argument(
+        "--verbose",
+        type=int,
+        choices=(0, 1, 2),
+        default=None,
+        help=(
+            "0: only results and failure names; "
+            "1: include script output for non-passing tests; "
+            "2: include script output for all tests"
+        ),
+    )
+    args = parser.parse_args()
+    args.verbose = (
+        args.verbose if args.verbose is not None else min(args.verbose_count, 2)
+    )
+    return args
+
+
+def output_preview(output: str) -> str:
+    lines = output.strip().splitlines()
+    preview = "\n".join(lines[:30])
+    if len(lines) > 30:
+        preview += f"\n... ({len(lines) - 30} more lines)"
+    return preview
+
+
 def run_example(test: ExampleTest) -> tuple[str, str]:
     env = os.environ.copy()
     env["PYTHONPATH"] = (
@@ -166,47 +213,60 @@ def run_example(test: ExampleTest) -> tuple[str, str]:
     output = result.stdout + result.stderr
     if result.returncode == 0:
         return "passed", output
+    if any(marker in output for marker in AUTH_FAILURE_MARKERS):
+        return "auth", output
     if any(marker in output for marker in test.external_failure_markers):
         return "external", output
     return "failed", output
 
 
 def main() -> int:
+    args = parse_args()
     passed: list[str] = []
+    auth: list[str] = []
     external: list[str] = []
     failed: list[tuple[str, str]] = []
 
     for test in TESTS:
-        print(f"\n=== {test.name} ===", flush=True)
         status, output = run_example(test)
         if status == "passed":
             passed.append(test.name)
-            print(color("PASS", GREEN + BOLD))
+            result = color("PASS", GREEN + BOLD)
+        elif status == "auth":
+            auth.append(test.name)
+            result = (
+                color("AUTH", ORANGE + BOLD)
+                + " - missing API key or endpoint is not authorized for this key"
+            )
         elif status == "external":
             external.append(test.name)
-            print(
-                color(
-                    "EXTERNAL",
-                    YELLOW + BOLD,
-                )
-                + ": endpoint, plan, or network prevented a live success"
+            result = (
+                color("EXTERNAL", YELLOW + BOLD)
+                + " - endpoint, plan, or network prevented a live success"
             )
         else:
             failed.append((test.name, output))
-            print(color("FAIL", RED + BOLD))
+            result = color("FAIL", RED + BOLD)
+
+        print(f"{result}: {test.name}", flush=True)
 
-        if output.strip():
-            lines = output.strip().splitlines()
-            preview = "\n".join(lines[:30])
-            if len(lines) > 30:
-                preview += f"\n... ({len(lines) - 30} more lines)"
-            print(preview)
+        should_print_output = output.strip() and (
+            args.verbose == 2 or (args.verbose == 1 and status != "passed")
+        )
+        if should_print_output:
+            print(output_preview(output))
 
     print("\n=== Summary ===")
     print(f"{color('Passed', GREEN)}   : {len(passed)}")
+    print(f"{color('Auth', ORANGE)}     : {len(auth)}")
     print(f"{color('External', YELLOW)} : {len(external)}")
     print(f"{color('Failed', RED)}   : {len(failed)}")
 
+    if auth:
+        print("\nAuth failures:")
+        for name in auth:
+            print(f"  - {name}")
+
     if external:
         print("\nExternal failures:")
         for name in external:
@@ -215,8 +275,10 @@ def main() -> int:
     if failed:
         print("\nUnexpected failures:")
         for name, output in failed:
-            print(f"\n--- {name} ---")
-            print(output.strip())
+            print(f"  - {name}")
+            if args.verbose >= 1:
+                print(f"\n--- {name} ---")
+                print(output.strip())
         return 1
 
     return 0

{helius_python-0.4.1 → helius_python-0.5.1}/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.1}/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,

{helius_python-0.4.1 → helius_python-0.5.1}/src/helius/laserstream/websockets.py

@@ -163,6 +163,27 @@ class WebSocketClient:
         response = self._websocket.recv()
         return json.loads(response)
 
+    def receive(self) -> tuple[dict | None, Notification, int]:
+        response = json.loads(self._websocket.recv())
+        model = self.MODELS[response["method"]]
+        result = response["params"]["result"]
+        subscription = response["params"]["subscription"]
+        if isinstance(result, dict):
+            context = result.get("context")
+            value = result.get("value")
+        else:
+            context, value = None, None
+        if value is not None:
+            notification = model.model_validate(value)
+        else:
+            notification = model.model_validate(result)
+        return context, notification, subscription
+
+    def listen(self):
+        while True:
+            context, notification, subscription = self.receive()
+            yield context, notification, subscription
+
     def _unsubscribe(self, subscription_type, subscription) -> bool:
         request = (
             JsonRpcRequest(method=f"{subscription_type}Unsubscribe")
@@ -376,24 +397,3 @@ class WebSocketClient:
 
     def vote_unsubscribe(self, subscription) -> bool:
         return self._unsubscribe("vote", subscription)
-
-    def receive(self) -> tuple[dict | None, Notification, int]:
-        response = json.loads(self._websocket.recv())
-        model = self.MODELS[response["method"]]
-        result = response["params"]["result"]
-        subscription = response["params"]["subscription"]
-        if isinstance(result, dict):
-            context = result.get("context")
-            value = result.get("value")
-        else:
-            context, value = None, None
-        if value is not None:
-            notification = model.model_validate(value)
-        else:
-            notification = model.model_validate(result)
-        return context, notification, subscription
-
-    def listen(self):
-        while True:
-            context, notification, subscription = self.receive()
-            yield context, notification, subscription