hiero-sdk-python 0.1.9__tar.gz → 0.2.0__tar.gz

{hiero_sdk_python-0.1.9 → hiero_sdk_python-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hiero-sdk-python
-Version: 0.1.9
+Version: 0.2.0
 Summary: A Hiero SDK in pure Python
 Author-Email: Nadine Loepfe <nadine.loepfe@hashgraph.com>, Richard Bair <rbair23@users.noreply.github.com>
 Maintainer-Email: Nadine Loepfe <nadine.loepfe@hashgraph.com>, Sophie Bulloch <exploreriii57@gmail.com>
@@ -212,20 +212,21 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: <3.14,>=3.10
-Requires-Dist: grpcio-tools==1.76.0
-Requires-Dist: protobuf==6.33.1
-Requires-Dist: grpcio==1.76.0
-Requires-Dist: cryptography==44.0.0
-Requires-Dist: python-dotenv==1.2.1
-Requires-Dist: requests==2.32.3
-Requires-Dist: pycryptodome==3.23.0
-Requires-Dist: eth-abi==5.2.0
-Requires-Dist: rlp>=4.0.0
-Requires-Dist: eth-keys==0.7.0
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: <4,>=3.10
+Requires-Dist: protobuf<7,>=4.21.12
+Requires-Dist: grpcio<2,>=1.76.0
+Requires-Dist: cryptography<47,>=44.0.1
+Requires-Dist: requests<3,>=2.31.0
+Requires-Dist: pycryptodome<4,>=3.18.0
+Requires-Dist: eth-abi<6,>=5.1.0
+Requires-Dist: python-dotenv<3,>=1.2.1
+Provides-Extra: eth
+Requires-Dist: eth-keys<0.8,>=0.7.0; extra == "eth"
+Requires-Dist: rlp<5,>=4.0.1; extra == "eth"
 Description-Content-Type: text/markdown
 
 # Hiero SDK in Python
@@ -236,6 +237,8 @@ Description-Content-Type: text/markdown
 
 A Python SDK for interacting with the Hedera Hashgraph platform.
 
+>**Python compatibility:** 
+> The SDK supports Python ≥ 3.10 and is tested on Python 3.10–3.14. Newer Python versions may work but have not yet been validated.
 
 ## Quick Start
 
@@ -244,6 +247,7 @@ A Python SDK for interacting with the Hedera Hashgraph platform.
 ```bash
 pip install --upgrade pip
 pip install hiero-sdk-python
+pip install python-dotenv
 ```
 
 ### Environment Configuration
@@ -260,14 +264,22 @@ A sample file is provided: [.env.example](.env.example)
 ### Basic Usage
 
 ```python
-from hiero_sdk_python import Client, AccountBalanceQuery
+import os
+from dotenv import load_dotenv
+from hiero_sdk_python import Network, Client, CryptoGetAccountBalanceQuery, AccountId, PrivateKey
 
 # Connect to testnet
-client = Client.for_testnet()
-client.set_operator(account_id, private_key)
+load_dotenv()
+network = Network("testnet")
+client = Client(network)
+
+operator_id = AccountId.from_string(os.getenv("OPERATOR_ID",""))
+operator_key = PrivateKey.from_string(os.getenv("OPERATOR_KEY",""))
+
+client.set_operator(operator_id, operator_key)
 
 # Query account balance
-balance = AccountBalanceQuery(account_id=account_id).execute(client)
+balance = CryptoGetAccountBalanceQuery(account_id=operator_id).execute(client)
 print(f"Balance: {balance.hbars} HBAR")
 ```
 
@@ -284,6 +296,7 @@ print(f"Balance: {balance.hbars} HBAR")
 
 - **[Contributing Guide](CONTRIBUTING.md)** - Start here!
 - **[Setup Guide](docs/sdk_developers/setup.md)** - First-time environment setup
+- **[Windows Setup Guide](docs/sdk_developers/training/setup/setup_windows.md)** - Step-by-step guide for Windows users
 - **[Workflow Guide](docs/sdk_developers/workflow.md)** - Day-to-day development workflow
 - **[Signing Guide](docs/sdk_developers/signing.md)** - GPG and DCO commit signing (required)
 - **[Changelog Guide](docs/sdk_developers/changelog_entry.md)** - How to write changelog entries
@@ -364,4 +377,4 @@ This project is licensed under the [Apache License 2.0](LICENSE).
 
 ---
 
-**Latest release:** Check [PyPI](https://pypi.org/project/hiero-sdk-python/) or [GitHub Releases](https://github.com/hiero-ledger/hiero-sdk-python/releases)
+**Latest release:** Check [PyPI](https://pypi.org/project/hiero-sdk-python/) or [GitHub Releases](https://github.com/hiero-ledger/hiero-sdk-python/releases)

{hiero_sdk_python-0.1.9 → hiero_sdk_python-0.2.0}/README.md

@@ -6,6 +6,8 @@
 
 A Python SDK for interacting with the Hedera Hashgraph platform.
 
+>**Python compatibility:** 
+> The SDK supports Python ≥ 3.10 and is tested on Python 3.10–3.14. Newer Python versions may work but have not yet been validated.
 
 ## Quick Start
 
@@ -14,6 +16,7 @@ A Python SDK for interacting with the Hedera Hashgraph platform.
 ```bash
 pip install --upgrade pip
 pip install hiero-sdk-python
+pip install python-dotenv
 ```
 
 ### Environment Configuration
@@ -30,14 +33,22 @@ A sample file is provided: [.env.example](.env.example)
 ### Basic Usage
 
 ```python
-from hiero_sdk_python import Client, AccountBalanceQuery
+import os
+from dotenv import load_dotenv
+from hiero_sdk_python import Network, Client, CryptoGetAccountBalanceQuery, AccountId, PrivateKey
 
 # Connect to testnet
-client = Client.for_testnet()
-client.set_operator(account_id, private_key)
+load_dotenv()
+network = Network("testnet")
+client = Client(network)
+
+operator_id = AccountId.from_string(os.getenv("OPERATOR_ID",""))
+operator_key = PrivateKey.from_string(os.getenv("OPERATOR_KEY",""))
+
+client.set_operator(operator_id, operator_key)
 
 # Query account balance
-balance = AccountBalanceQuery(account_id=account_id).execute(client)
+balance = CryptoGetAccountBalanceQuery(account_id=operator_id).execute(client)
 print(f"Balance: {balance.hbars} HBAR")
 ```
 
@@ -54,6 +65,7 @@ print(f"Balance: {balance.hbars} HBAR")
 
 - **[Contributing Guide](CONTRIBUTING.md)** - Start here!
 - **[Setup Guide](docs/sdk_developers/setup.md)** - First-time environment setup
+- **[Windows Setup Guide](docs/sdk_developers/training/setup/setup_windows.md)** - Step-by-step guide for Windows users
 - **[Workflow Guide](docs/sdk_developers/workflow.md)** - Day-to-day development workflow
 - **[Signing Guide](docs/sdk_developers/signing.md)** - GPG and DCO commit signing (required)
 - **[Changelog Guide](docs/sdk_developers/changelog_entry.md)** - How to write changelog entries
@@ -134,4 +146,4 @@ This project is licensed under the [Apache License 2.0](LICENSE).
 
 ---
 
-**Latest release:** Check [PyPI](https://pypi.org/project/hiero-sdk-python/) or [GitHub Releases](https://github.com/hiero-ledger/hiero-sdk-python/releases)
+**Latest release:** Check [PyPI](https://pypi.org/project/hiero-sdk-python/) or [GitHub Releases](https://github.com/hiero-ledger/hiero-sdk-python/releases)

{hiero_sdk_python-0.1.9 → hiero_sdk_python-0.2.0}/pyproject.toml

@@ -11,18 +11,15 @@ authors = [
     { name = "Richard Bair", email = "rbair23@users.noreply.github.com" },
 ]
 readme = "README.md"
-requires-python = ">=3.10, <3.14"
+requires-python = ">=3.10, <4"
 dependencies = [
-    "grpcio-tools==1.76.0",
-    "protobuf==6.33.1",
-    "grpcio==1.76.0",
-    "cryptography==44.0.0",
-    "python-dotenv==1.2.1",
-    "requests==2.32.3",
-    "pycryptodome==3.23.0",
-    "eth-abi==5.2.0",
-    "rlp>=4.0.0",
-    "eth-keys==0.7.0",
+    "protobuf>=4.21.12,<7",
+    "grpcio>=1.76.0,<2",
+    "cryptography>=44.0.1,<47",
+    "requests>=2.31.0,<3",
+    "pycryptodome>=3.18.0,<4",
+    "eth-abi>=5.1.0,<6",
+    "python-dotenv>=1.2.1,<3",
 ]
 classifiers = [
     "Development Status :: 2 - Pre-Alpha",
@@ -31,23 +28,32 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Operating System :: OS Independent",
     "Intended Audience :: Developers",
-    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Libraries",
 ]
-version = "0.1.9"
+version = "0.2.0"
 
 [project.license]
 file = "LICENSE"
 
+[project.optional-dependencies]
+eth = [
+    "eth-keys>=0.7.0,<0.8",
+    "rlp>=4.0.1,<5",
+]
+
 [dependency-groups]
 dev = [
-    "pytest>=8.3.4",
+    "grpcio-tools>=1.76.0,<2",
+    "pytest>=8.3.4,<9",
+    "pytest-cov>=7.0.0,<8",
 ]
 lint = [
-    "ruff>=0.8.3",
-    "typing-extensions>=4.15.0",
-    "mypy>=1.18.2",
+    "ruff>=0.14.9,<1",
+    "mypy>=1.18.2,<2",
+    "typing-extensions>=4.15.0,<5",
 ]
 
 [tool.uv]
@@ -80,21 +86,40 @@ testpaths = [
 
 [tool.ruff]
 line-length = 120
+target-version = "py314"
 
 [tool.ruff.lint]
 select = [
+    "D",
     "E",
-    "W",
     "F",
-    "C",
     "I",
-    "D",
+    "B",
+    "UP",
+    "SIM",
+    "PERF",
+    "ARG",
+    "RET",
+    "RSE",
 ]
+ignore = [
+    "D212",
+    "E501",
+    "B008",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
 
 [build-system]
 requires = [
     "pdm-backend",
     "setuptools",
     "setuptools_scm",
+    "grpcio-tools",
 ]
 build-backend = "pdm.backend"

{hiero_sdk_python-0.1.9 → hiero_sdk_python-0.2.0}/src/hiero_sdk_python/__init__.py

@@ -51,6 +51,7 @@ from .tokens.hbar_transfer import HbarTransfer
 from .tokens.token_unpause_transaction import TokenUnpauseTransaction
 from .tokens.token_pause_transaction import TokenPauseTransaction
 from .tokens.token_airdrop_claim import TokenClaimAirdropTransaction
+from .tokens.assessed_custom_fee import AssessedCustomFee
 
 # Transaction
 from .transaction.transaction import Transaction
@@ -70,6 +71,7 @@ from .hbar_unit import HbarUnit
 
 # Timestamp
 from .timestamp import Timestamp
+from .staking_info import StakingInfo
 
 # Duration
 from .Duration import Duration
@@ -201,6 +203,7 @@ __all__ = [
     "HbarTransfer",
     "TokenPauseTransaction",
     "TokenUnpauseTransaction",
+    "AssessedCustomFee",
 
     # Transaction
     "Transaction",
@@ -245,6 +248,7 @@ __all__ = [
     "ResponseCode",
     "Timestamp",
     "Duration",
+    "StakingInfo",
 
     # File
     "FileCreateTransaction",

{hiero_sdk_python-0.1.9 → hiero_sdk_python-0.2.0}/src/hiero_sdk_python/account/account_balance.py

@@ -52,3 +52,31 @@ class AccountBalance:
                 token_balances[token_id] = balance
 
         return cls(hbars=hbars, token_balances=token_balances)
+
+    def __str__(self) -> str:
+        """
+        Returns a human-friendly string representation of the account balance.
+        
+        Returns:
+            str: A string showing HBAR balance and token balances.
+        """
+        lines = [f"HBAR Balance: {self.hbars} hbars"]
+        if self.token_balances:
+            lines.append("Token Balances:")
+            for token_id, balance in self.token_balances.items():
+                lines.append(f" - Token ID {token_id}: {balance} units")
+        return "\n".join(lines)
+
+    def __repr__(self) -> str:
+        """
+        Returns a developer-friendly string representation of the account balance.
+        
+        Returns:
+            str: A string representation that shows the key attributes.
+        """
+        token_balances_repr = (
+            f"{{{', '.join(f'{token_id!r}: {balance}' for token_id, balance in self.token_balances.items())}}}"
+            if self.token_balances
+            else "{}"
+        )
+        return f"AccountBalance(hbars={self.hbars!r}, token_balances={token_balances_repr})"

{hiero_sdk_python-0.1.9 → hiero_sdk_python-0.2.0}/src/hiero_sdk_python/account/account_create_transaction.py

@@ -9,14 +9,16 @@ from hiero_sdk_python.account.account_id import AccountId
 from hiero_sdk_python.channels import _Channel
 from hiero_sdk_python.crypto.evm_address import EvmAddress
 from hiero_sdk_python.crypto.public_key import PublicKey
+from hiero_sdk_python.crypto.private_key import PrivateKey
 from hiero_sdk_python.Duration import Duration
 from hiero_sdk_python.executable import _Method
-from hiero_sdk_python.hapi.services import crypto_create_pb2, duration_pb2, transaction_pb2
+from hiero_sdk_python.hapi.services import crypto_create_pb2, duration_pb2, transaction_pb2, basic_types_pb2
 from hiero_sdk_python.hapi.services.schedulable_transaction_body_pb2 import (
     SchedulableTransactionBody,
 )
 from hiero_sdk_python.hbar import Hbar
 from hiero_sdk_python.transaction.transaction import Transaction
+from hiero_sdk_python.utils.key_utils import Key, key_to_proto
 
 AUTO_RENEW_PERIOD = Duration(7890000)  # around 90 days in seconds
 DEFAULT_TRANSACTION_FEE = Hbar(3).to_tinybars()  # 3 Hbars
@@ -29,7 +31,7 @@ class AccountCreateTransaction(Transaction):
 
     def __init__(
         self,
-        key: Optional[PublicKey] = None,
+        key: Optional[Key] = None,
         initial_balance: Union[Hbar, int] = 0,
         receiver_signature_required: Optional[bool] = None,
         auto_renew_period: Optional[Duration] = AUTO_RENEW_PERIOD,
@@ -59,7 +61,7 @@ class AccountCreateTransaction(Transaction):
                 staking reward (default is False).
         """
         super().__init__()
-        self.key: Optional[PublicKey] = key
+        self.key: Optional[Key] = key
         self.initial_balance: Union[Hbar, int] = initial_balance
         self.receiver_signature_required: Optional[bool] = receiver_signature_required
         self.auto_renew_period: Optional[Duration] = auto_renew_period
@@ -71,12 +73,12 @@ class AccountCreateTransaction(Transaction):
         self.staked_node_id: Optional[int] = staked_node_id
         self.decline_staking_reward = decline_staking_reward
 
-    def set_key(self, key: PublicKey) -> "AccountCreateTransaction":
+    def set_key(self, key: Key) -> "AccountCreateTransaction":
         """
-        Sets the public key for the new account.
+        Sets the key for the new account (accepts both PrivateKey or PublicKey).
 
         Args:
-            key (PublicKey): The public key to assign to the account.
+            key (Key): The key to assign to the account.
 
         Returns:
             AccountCreateTransaction: The current transaction instance for method chaining.
@@ -89,33 +91,34 @@ class AccountCreateTransaction(Transaction):
         self.key = key
         return self
 
-    def set_key_without_alias(self, key: PublicKey) -> "AccountCreateTransaction":
+    def set_key_without_alias(self, key: Key) -> "AccountCreateTransaction":
         """
-        Sets the public key for the new account without alias.
+        Sets the key for the new account without alias (accepts both PrivateKey or PublicKey).
 
         Args:
-            key (PublicKey): The public key to assign to the account.
+            key (Key): The key to assign to the account.
 
         Returns:
             AccountCreateTransaction: The current transaction instance for method chaining.
         """
         self._require_not_frozen()
         self.key = key
+        self.alias = None
         return self
 
     def set_key_with_alias(
         self,
-        key: PublicKey,
-        ecdsa_key: Optional[PublicKey]=None
+        key: Key,
+        ecdsa_key: Optional[Key]=None
     ) -> "AccountCreateTransaction":
         """
-        Sets the public key for the new account and assigns an alias derived from an ECDSA key.
+        Sets the key for the new account and assigns an alias derived from an ECDSA key.
         
         If `ecdsa_key` is provided, its corresponding EVM address will be used as the account alias.
         Otherwise, the alias will be derived from the provided `key`.
 
         Args:
-            key (PublicKey): The public key to assign to the account.
+            key (Key): The key to assign to the account (PrivateKey or PublicKey).
             ecdsa_key (Optional[PublicKey]): An optional ECDSA public key used 
                 to derive the account alias.
 
@@ -124,7 +127,11 @@ class AccountCreateTransaction(Transaction):
         """
         self._require_not_frozen()
         self.key = key
-        self.alias = ecdsa_key.to_evm_address() if ecdsa_key is not None else key.to_evm_address()
+        evm_source_key: Key = ecdsa_key if ecdsa_key is not None else key
+        if isinstance(evm_source_key, PrivateKey):
+            evm_source_key = evm_source_key.public_key()
+
+        self.alias = evm_source_key.to_evm_address()
         return self
 
     def set_initial_balance(self, balance: Union[Hbar, int]) -> "AccountCreateTransaction":
@@ -318,8 +325,10 @@ class AccountCreateTransaction(Transaction):
         else:
             raise TypeError("initial_balance must be Hbar or int (tinybars).")
 
+        proto_key = key_to_proto(self.key)
+
         proto_body = crypto_create_pb2.CryptoCreateTransactionBody(
-            key=self.key._to_proto(),
+            key=proto_key,
             initialBalance=initial_balance_tinybars,
             receiverSigRequired=self.receiver_signature_required,
             autoRenewPeriod=duration_pb2.Duration(seconds=self.auto_renew_period.seconds),