helius-python 0.3.3__tar.gz → 0.4.0__tar.gz

{helius_python-0.3.3 → helius_python-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: helius-python
-Version: 0.3.3
+Version: 0.4.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
@@ -135,9 +135,10 @@ wraps it.
 - 🚧 **All Helius-specific RPC extensions** — enhanced transactions, DAS
   (Digital Asset Standard) methods, priority fee estimation, and the
   rest of the Helius-only RPC namespace. **(in progress)**
-- 🚧 **Every Helius REST endpoint** — Enhanced Transactions API,
-  Webhooks API, Mint API, token metadata, address lookups, and beyond.
-  **(in progress)**
+- ✅ **Webhooks API** — create, fetch, update, enable/disable, and delete
+  Helius webhooks. **(supported today)**
+- 🚧 **Remaining Helius REST endpoints** — Enhanced Transactions API,
+  Mint API, token metadata, address lookups, and beyond. **(in progress)**
 - 🚧 **Platform features** — streaming, websockets, and any new
   capability Helius adds to its API. The full WebSocket subscription
   surface (`accountSubscribe`, `transactionSubscribe`, `logsSubscribe`,
@@ -145,10 +146,10 @@ wraps it.
   platform features are **in progress**.
 
 **Current status:** the standard Solana JSON-RPC surface, the
-WebSocket subscription surface, and the Admin (account management)
-usage endpoint are implemented today. Support for Helius RPC
-extensions and the remaining REST endpoints is actively being worked
-on.
+WebSocket subscription surface, the Webhooks API, and the Admin
+(account management) usage endpoint are implemented today. Support for
+Helius RPC extensions and the remaining REST endpoints is actively
+being worked on.
 
 ## Goals
 
@@ -266,9 +267,9 @@ 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.py`](src/helius/solana_rpc.py) for the current list of
-implemented methods; missing endpoints are tracked as issues and added
-continuously.
+[`src/helius/solana_rpc/client.py`](src/helius/solana_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.
 
 | Solana JSON-RPC method              | Python method                                 | Helius docs                                                                                                                                                                          |
 | ----------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
@@ -372,6 +373,44 @@ them; both yield a `(context, notification, subscription)` tuple where
 | `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)                                                                                       |
 
+## Webhooks API
+
+`WebhooksApiClient` wraps the Helius Webhooks REST API. It can create,
+fetch, list, update, enable/disable, and delete webhook subscriptions,
+returning typed `Webhook` models where the endpoint returns a webhook.
+
+```python
+from helius.webhooks.webhooks import WebhooksApiClient
+
+with WebhooksApiClient(api_key="YOUR_HELIUS_API_KEY") as webhooks:
+    webhook = webhooks.create_webhook(
+        webhook_url="https://example.com/helius-webhook",
+        transaction_types=["TRANSFER"],
+        account_addresses=["So11111111111111111111111111111111111111112"],
+        webhook_type="enhanced",
+        auth_header="Bearer your-shared-secret",
+        encoding="jsonParsed",
+        txn_status="all",
+    )
+
+    webhooks.toggle_webhook(webhook.webhook_id, active=False)
+```
+
+Like the other clients, it supports the context-manager protocol and a
+manual `close()`. The constructor defaults to
+`https://mainnet.helius-rpc.com/v0/webhooks` and reads `HELIUS_API_KEY`
+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)                    |
+
 ## Admin API
 
 `AccountManagementClient` wraps the Helius admin API. Today it exposes

{helius_python-0.3.3 → helius_python-0.4.0}/README.md

@@ -113,9 +113,10 @@ wraps it.
 - 🚧 **All Helius-specific RPC extensions** — enhanced transactions, DAS
   (Digital Asset Standard) methods, priority fee estimation, and the
   rest of the Helius-only RPC namespace. **(in progress)**
-- 🚧 **Every Helius REST endpoint** — Enhanced Transactions API,
-  Webhooks API, Mint API, token metadata, address lookups, and beyond.
-  **(in progress)**
+- ✅ **Webhooks API** — create, fetch, update, enable/disable, and delete
+  Helius webhooks. **(supported today)**
+- 🚧 **Remaining Helius REST endpoints** — Enhanced Transactions API,
+  Mint API, token metadata, address lookups, and beyond. **(in progress)**
 - 🚧 **Platform features** — streaming, websockets, and any new
   capability Helius adds to its API. The full WebSocket subscription
   surface (`accountSubscribe`, `transactionSubscribe`, `logsSubscribe`,
@@ -123,10 +124,10 @@ wraps it.
   platform features are **in progress**.
 
 **Current status:** the standard Solana JSON-RPC surface, the
-WebSocket subscription surface, and the Admin (account management)
-usage endpoint are implemented today. Support for Helius RPC
-extensions and the remaining REST endpoints is actively being worked
-on.
+WebSocket subscription surface, the Webhooks API, and the Admin
+(account management) usage endpoint are implemented today. Support for
+Helius RPC extensions and the remaining REST endpoints is actively
+being worked on.
 
 ## Goals
 
@@ -244,9 +245,9 @@ 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.py`](src/helius/solana_rpc.py) for the current list of
-implemented methods; missing endpoints are tracked as issues and added
-continuously.
+[`src/helius/solana_rpc/client.py`](src/helius/solana_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.
 
 | Solana JSON-RPC method              | Python method                                 | Helius docs                                                                                                                                                                          |
 | ----------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
@@ -350,6 +351,44 @@ them; both yield a `(context, notification, subscription)` tuple where
 | `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)                                                                                       |
 
+## Webhooks API
+
+`WebhooksApiClient` wraps the Helius Webhooks REST API. It can create,
+fetch, list, update, enable/disable, and delete webhook subscriptions,
+returning typed `Webhook` models where the endpoint returns a webhook.
+
+```python
+from helius.webhooks.webhooks import WebhooksApiClient
+
+with WebhooksApiClient(api_key="YOUR_HELIUS_API_KEY") as webhooks:
+    webhook = webhooks.create_webhook(
+        webhook_url="https://example.com/helius-webhook",
+        transaction_types=["TRANSFER"],
+        account_addresses=["So11111111111111111111111111111111111111112"],
+        webhook_type="enhanced",
+        auth_header="Bearer your-shared-secret",
+        encoding="jsonParsed",
+        txn_status="all",
+    )
+
+    webhooks.toggle_webhook(webhook.webhook_id, active=False)
+```
+
+Like the other clients, it supports the context-manager protocol and a
+manual `close()`. The constructor defaults to
+`https://mainnet.helius-rpc.com/v0/webhooks` and reads `HELIUS_API_KEY`
+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)                    |
+
 ## Admin API
 
 `AccountManagementClient` wraps the Helius admin API. Today it exposes

{helius_python-0.3.3 → helius_python-0.4.0}/TODO.md

@@ -2,3 +2,5 @@
 - WebSocket subscription manager
 - Use typeddicts where useful
 - When Python 3.10 and 3.11 go out of support we should use TypedDict from typing instead of typing_extensions
+- Improve camelCase <-> snake_case in typing
+- Handle HTTP response codes and idiomatic error messages in responses

helius_python-0.4.0/examples/laserstream/websocket_logs.py

@@ -0,0 +1,76 @@
+"""Listen for Solana log notifications over Helius WebSockets.
+
+Subscribes with `logsSubscribe`, prints a small number of notifications,
+then unsubscribes cleanly. Use `--mentions <ADDRESS>` to filter logs to a
+single account or program; otherwise the example listens to all logs.
+
+Usage:
+
+    export HELIUS_API_KEY=your_helius_api_key
+    python examples/laserstream/websocket_logs.py --mentions <ADDRESS>
+    python examples/laserstream/websocket_logs.py --count 3
+
+Docs:
+    https://www.helius.dev/docs/api-reference/rpc/websocket/logssubscribe
+"""
+
+from __future__ import annotations
+
+import argparse
+from contextlib import suppress
+import sys
+
+from helius.laserstream.websockets import WebSocketClient
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__.splitlines()[0])
+    parser.add_argument(
+        "--mentions",
+        help="Only receive logs mentioning this account or program address",
+    )
+    parser.add_argument(
+        "--count",
+        type=int,
+        default=5,
+        help="Number of notifications to print before exiting (default 5)",
+    )
+    args = parser.parse_args()
+
+    log_filter = {"mentions": [args.mentions]} if args.mentions else "all"
+
+    with WebSocketClient() as client:
+        subscription = client.logs_subscribe(
+            filter=log_filter,
+            commitment="confirmed",
+        )
+        print(f"Subscribed to logs with id {subscription}. Waiting...\n")
+
+        try:
+            for index, (context, notification, _subscription) in enumerate(
+                client.listen(), start=1
+            ):
+                slot = context.get("slot") if context else "unknown"
+                status = "ERR" if notification.err else "OK "
+                print(f"[{index}/{args.count}] slot={slot} {status} {notification.signature}")
+                for line in notification.logs[:5]:
+                    print(f"    {line}")
+                if len(notification.logs) > 5:
+                    print(f"    ... {len(notification.logs) - 5} more log lines")
+                print()
+                if index >= args.count:
+                    break
+        finally:
+            # A busy `logsSubscribe` stream can deliver another notification
+            # between our unsubscribe request and the unsubscribe response. The
+            # client helper currently expects the very next frame to be the RPC
+            # response, so ignore that race here and let the context manager
+            # close the socket cleanly.
+            with suppress(KeyError):
+                client.logs_unsubscribe(subscription)
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

helius_python-0.4.0/examples/solana_rpc/address_transactions.py

@@ -0,0 +1,125 @@
+"""List Helius enhanced transactions for an address.
+
+Uses Helius's `getTransactionsForAddress` RPC method, which can return
+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
+
+Docs:
+    https://www.helius.dev/docs/getting-data/get-transactions-for-address
+
+Note:
+    Helius documents this exclusive RPC method as requiring a Developer plan
+    or higher.
+"""
+
+from __future__ import annotations
+
+import argparse
+import datetime as dt
+import sys
+
+import httpx
+
+from helius.solana_rpc import SolanaRpcClient
+
+
+def format_time(block_time: int | None) -> str:
+    if block_time is None:
+        return "(no time)"
+    return dt.datetime.fromtimestamp(block_time, tz=dt.timezone.utc).strftime(
+        "%Y-%m-%d %H:%M:%SZ"
+    )
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__.splitlines()[0])
+    parser.add_argument("address", help="Wallet, account, or program address")
+    parser.add_argument(
+        "--limit",
+        type=int,
+        default=10,
+        help="Number of rows to fetch (1-1000, default 10)",
+    )
+    parser.add_argument(
+        "--pagination-token",
+        help="Token returned by a previous page of results",
+    )
+    parser.add_argument(
+        "--full",
+        action="store_true",
+        help="Fetch full transaction details instead of signature rows",
+    )
+    parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Validate arguments and print the planned request without sending it",
+    )
+    args = parser.parse_args()
+
+    details = "full" if args.full else "signatures"
+    if args.dry_run:
+        print("Would call get_transactions_for_address with:")
+        print(f"  address={args.address}")
+        print(f"  transaction_details={details}")
+        print(f"  limit={args.limit}")
+        print(f"  pagination_token={args.pagination_token}")
+        print(f"  encoding={'jsonParsed' if args.full else None}")
+        return 0
+
+    try:
+        with SolanaRpcClient() as client:
+            transactions, next_token = client.get_transactions_for_address(
+                address=args.address,
+                transaction_details=details,
+                sort_order="desc",
+                commitment="finalized",
+                limit=args.limit,
+                pagination_token=args.pagination_token,
+                encoding="jsonParsed" if args.full else None,
+                max_supported_transaction_version=0 if args.full else None,
+            )
+    except httpx.HTTPStatusError as exc:
+        print(
+            f"HTTP {exc.response.status_code}: getTransactionsForAddress was rejected. "
+            "This Helius-exclusive method may require a Developer plan or higher.",
+            file=sys.stderr,
+        )
+        return 2
+
+    print(f"\n=== Transactions for {args.address} ===\n")
+    if not transactions:
+        print("No transactions returned.")
+        return 0
+
+    for tx in transactions:
+        if details == "signatures":
+            status = "ERR" if tx.err else "OK "
+            print(
+                f"{format_time(tx.block_time)}  slot={tx.slot:<12} "
+                f"idx={tx.transaction_index:<4} {status}  {tx.signature}"
+            )
+        else:
+            signature = "(signature unavailable)"
+            signatures = tx.transaction.get("signatures")
+            if isinstance(signatures, list) and signatures:
+                signature = signatures[0]
+            err = tx.meta.get("err") if isinstance(tx.meta, dict) else None
+            status = "ERR" if err else "OK "
+            print(
+                f"{format_time(tx.block_time)}  slot={tx.slot:<12} "
+                f"idx={tx.transaction_index:<4} {status}  {signature}"
+            )
+
+    if next_token:
+        print(f"\nNext page token: {next_token}")
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

helius_python-0.4.0/examples/solana_rpc/address_transfers.py

@@ -0,0 +1,118 @@
+"""List token and SOL transfers for an address.
+
+Uses Helius's `getTransfersByAddress` RPC method exposed by this client as
+`get_transfers_by_address`.
+
+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>
+
+Docs:
+    https://www.helius.dev/docs/getting-data/get-transfers-by-address
+
+Note:
+    Helius documents this exclusive RPC method as requiring a Developer plan
+    or higher.
+"""
+
+from __future__ import annotations
+
+import argparse
+import datetime as dt
+import sys
+
+import httpx
+
+from helius.solana_rpc import SolanaRpcClient
+
+
+def format_time(block_time: int) -> str:
+    return dt.datetime.fromtimestamp(block_time, tz=dt.timezone.utc).strftime(
+        "%Y-%m-%d %H:%M:%SZ"
+    )
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__.splitlines()[0])
+    parser.add_argument("address", help="Wallet, token account, or owner address")
+    parser.add_argument(
+        "--limit",
+        type=int,
+        default=20,
+        help="Number of transfers to fetch (1-100, default 20)",
+    )
+    parser.add_argument(
+        "--direction",
+        choices=("in", "out", "any"),
+        default="any",
+        help="Transfer direction relative to address (default any)",
+    )
+    parser.add_argument("--with-address", help="Counterparty address filter")
+    parser.add_argument("--mint", help="Mint address filter")
+    parser.add_argument(
+        "--pagination-token",
+        help="Token returned by a previous page of results",
+    )
+    parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Validate arguments and print the planned request without sending it",
+    )
+    args = parser.parse_args()
+
+    if args.dry_run:
+        print("Would call get_transfers_by_address with:")
+        print(f"  address={args.address}")
+        print(f"  with_address={args.with_address}")
+        print(f"  direction={args.direction}")
+        print(f"  mint={args.mint}")
+        print(f"  limit={args.limit}")
+        print(f"  pagination_token={args.pagination_token}")
+        return 0
+
+    try:
+        with SolanaRpcClient() as client:
+            transfers, next_token = client.get_transfers_by_address(
+                address=args.address,
+                with_address=args.with_address,
+                direction=args.direction,
+                mint=args.mint,
+                limit=args.limit,
+                pagination_token=args.pagination_token,
+                commitment="finalized",
+                sort_order="desc",
+            )
+    except httpx.HTTPStatusError as exc:
+        print(
+            f"HTTP {exc.response.status_code}: getTransfersByAddress was rejected. "
+            "This Helius-exclusive method may require a Developer plan or higher.",
+            file=sys.stderr,
+        )
+        return 2
+
+    print(f"\n=== Transfers for {args.address} ===\n")
+    if not transfers:
+        print("No transfers returned.")
+        return 0
+
+    for transfer in transfers:
+        from_acct = transfer.from_user_account or transfer.from_token_account or "-"
+        to_acct = transfer.to_user_account or transfer.to_token_account or "-"
+        print(
+            f"{format_time(transfer.block_time)}  slot={transfer.slot:<12} "
+            f"{transfer.type:<11} {transfer.ui_amount:>18}  mint={transfer.mint}"
+        )
+        print(f"    from={from_acct}")
+        print(f"    to  ={to_acct}")
+        print(f"    sig ={transfer.signature}")
+
+    if next_token:
+        print(f"\nNext page token: {next_token}")
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

{helius_python-0.3.3/examples → helius_python-0.4.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/block_explorer.py
-    python examples/block_explorer.py --slot 250000000
+    python examples/solana_rpc/block_explorer.py
+    python examples/solana_rpc/block_explorer.py --slot 250000000
 
 Uses (with `with`):
     get_slot, get_block.
@@ -43,9 +43,10 @@ def main() -> int:
             else helius.get_slot(commitment="finalized")
         )
         block = helius.get_block(
-            slot,
+            slot=slot,
             commitment="finalized",
             encoding="jsonParsed",
+            rewards=False,
             max_supported_transcation_version=0,
         )
 

{helius_python-0.3.3/examples → helius_python-0.4.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/devnet_airdrop.py <WALLET_ADDRESS> [--sol 1.0]
+    python examples/solana_rpc/devnet_airdrop.py <WALLET_ADDRESS> [--sol 1.0]
 
 Note:
     `requestAirdrop` is only available on Devnet and Testnet — never on
@@ -24,6 +24,8 @@ import argparse
 import sys
 import time
 
+import httpx
+
 from helius.solana_rpc import SolanaRpcClient
 
 LAMPORTS_PER_SOL = 1_000_000_000
@@ -45,20 +47,40 @@ def main() -> int:
         default=30.0,
         help="Seconds to wait for confirmation (default: 30)",
     )
+    parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Validate arguments and print the planned airdrop without sending it",
+    )
     args = parser.parse_args()
     lamports = int(args.sol * LAMPORTS_PER_SOL)
 
+    if args.dry_run:
+        print("Would request devnet airdrop with:")
+        print(f"  address={args.address}")
+        print(f"  sol={args.sol}")
+        print(f"  lamports={lamports}")
+        print(f"  timeout={args.timeout}")
+        return 0
+
     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)
+        try:
+            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.",
+                file=sys.stderr,
+            )
+            return 2
         print(f"  signature: {signature}")
 
         deadline = time.monotonic() + args.timeout
         status = None
         while time.monotonic() < deadline:
             _ctx, statuses = client.get_signature_statuses(
-                [signature], search_transaction_history=True
+                signatures=[signature], search_transaction_history=True
             )
             status = statuses[0]
             if status is not None and status.confirmation_status in (
@@ -79,7 +101,7 @@ def main() -> int:
             return 1
         print(f"  status: {status.confirmation_status} at slot {status.slot}")
 
-        _ctx, balance = client.get_balance(args.address)
+        _ctx, balance = client.get_balance(public_key=args.address)
         print(f"Post-airdrop balance: {balance / LAMPORTS_PER_SOL:.9f} SOL")
     finally:
         client.close()

{helius_python-0.3.3/examples → helius_python-0.4.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/network_status.py
+    python examples/solana_rpc/network_status.py
 
 Uses (with `with`):
     get_health, get_version, get_slot, get_block_height, get_epoch_info,

{helius_python-0.3.3/examples → helius_python-0.4.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/priority_fees.py
-    python examples/priority_fees.py --account <PUBKEY> --account <PUBKEY>
+    python examples/solana_rpc/priority_fees.py
+    python examples/solana_rpc/priority_fees.py --account <PUBKEY> --account <PUBKEY>
 
 Uses (with `with`):
     get_recent_prioritization_fees.

{helius_python-0.3.3/examples → helius_python-0.4.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/stake_overview.py
+    python examples/solana_rpc/stake_overview.py
 
 Uses (with `try/finally`):
     get_inflation_rate, get_inflation_governor, get_supply,
@@ -18,6 +18,8 @@ from __future__ import annotations
 
 import sys
 
+import httpx
+
 from helius.solana_rpc import SolanaRpcClient
 
 LAMPORTS_PER_SOL = 1_000_000_000
@@ -25,10 +27,11 @@ LAMPORTS_PER_SOL = 1_000_000_000
 
 def main() -> int:
     client = SolanaRpcClient()
+    client._client.timeout = httpx.Timeout(30.0)
     try:
         rate = client.get_inflation_rate()
         gov = client.get_inflation_governor()
-        _ctx, supply = client.get_supply(exclude_non_circulating_accounts_list=True)
+        _ctx, supply = client.get_supply(exclude_non_circulating_accounts_list=False)
         _ctx, min_stake = client.get_stake_minimum_delegation()
         current, delinquent = client.get_vote_accounts()
     finally: